Описание команд
Команда IFC RADIO
Команда используется для включения/отключения радиоинтерфейса системы.
Синтаксис:
#1> ifc radio {up | down}
Команда XG
Команда используется для просмотра и изменения параметров радиоканала.
Синтаксис:
#1> xg [arguments]
#1> xg usage: xg -type {master | slave} Radio frame params related xg -tdd-sync-src {freerun | gnss} xg -dlquota {1..99/1} xg -sframelen {1 | 2 | 5 | 10} xg -max-distance {0..120000/1} xg -cell-id {0..15/1} Radio front end related xg -freq-dl {channel-width==10:4905..5995/10 | channel-width==20:4910..5990/10 | channel-width==40:4920..5980/20} xg -freq-ul {channel-width==10:4905..5995/10 | channel-width==20:4910..5990/10 | channel-width==40:4920..5980/20} xg -txpwr {0..27/1} xg -channel-width {10 | 20 | 40} Modulation related xg -amc-strategy {normal | conservative | aggressive} xg -max-mcs {1..10/1} DFS/RSSI scan/Radar detection Ethernet datapath related xg -qos-strategy {normal | conservative | aggressive | off} Supplementary alias: xg -freq <val> => xg -freq-dl <val> -freq-ul <val> xg -appendconf-v2-start xg -appendconf-v2 <encoded web config> xg -appendconf-v2-end xg [-grids-carrier-ix=<grids-carrier-ix>] [-grids-band=<grids-band>] -grids {<freq_start>[-<freq_end>[/<step>]],...} xg [-grids-carrier-ix=<grids-carrier-ix>] [-grids-band=<grids-band>] -grids= xg stat [-phy] [-1] xg stat -clear xg capabilities xg config xg config -self xg config -peer-exported xg config -defaults
Аргументы команды
Радиоканал с топологией «точка-точка» может быть установлен между ведущим узлом (тип Master) и ведомым узлом (тип Slave). Чтобы выбрать тип устройства InfiLINK XG, используйте команду:
- xg -type {master | slave}
Например,
xg -type master
выбирает тип устройства Master.
Чтобы настроить параметры TDD-синхронизации на ведущем узле, используйте команду:
- xg -tdd-sync-src {freerun | gnss}
- "freerun" – несинхронизированный запуск кадра
- "gnss" – синхронизация от встроенного GPS/ГЛОНАСС приемника.
ПРЕДОСТЕРЕЖЕНИЕ
Параметр GNSS может быть настроен только на ведущем узле (Master).
ПРЕДОСТЕРЕЖЕНИЕ
Прежде чем выбрать опцию GNSS, убедитесь, что встроенный приемник GPS/ГЛОНАСС настроен. для настройки и проверки его состояния используйте команду GPS (значение "HDOP" не должно превышать 1,5).
Возможность переиспользования частот зависит от типа антенны, места размещения, направления, дальности канала и т.д.
ПРЕДОСТЕРЕЖЕНИЕ
Обратите внимание, что следующие настройки должны быть одинаковыми для совмещенных устройств:
- тип Master (все совмещенные устройства должны быть ведущими узлами)
- соотношение нисходящего / восходящего каналов
- длительность кадра радиоканала
- максимальная дальность
- ширина канала.
Чтобы установить необходимое соотношение нисходящего и восходящего каналов, используйте следующую команду, указав в качестве значения размер подкадра нисходящего канала по отношению к целому кадру:
- xg -dlquota {1..99}
Реальное соотношение нисходящего и восходящего каналов может отличаться из-за внутренних ограничений системы (автоматически выбирается ближайшее доступное соотношение). Текущее значение соотношения приводится в выходных данных команды "xg capabilities"
Например,
xg -dlquota 70
задает соотношение нисходящего и восходящего каналов 70/30.
Чтобы установить длительность кадра радиоканала в миллисекундах, используйте команду:
- xg -sframelen {1, 2, 5, 10}
Например,
xg –sframelen 10
устанавливает длительность кадра радиоканала 10 миллисекунд.
Чем меньше длительность кадра радиоканала, тем меньше время задержки передачи пакета, но выше доля накладных расходов.
Чтобы установить максимальную дальность канала в метрах, используйте команду:
- xg -max-distance distance {0..55800/1}
Например,
xg -max-distance 5000
Следует указывать значение не менее реального расстояния между антеннами устройств и как можно ближе к реальной дальности для минимизации накладных расходов. Рекомендуемая последовательность настройки – установить значение существенно больше предполагаемой реальной дальности, а после установки устройств на месте скорректировать его на основании измеренного значения дальности, которое приводится в выводе команды "xg stat".
Чтобы предотвратить подключение устройства к «чужому» узлу в случае, если несколько совмещенных устройств используют одну и ту же центральную частоту, следует установить разные значения ID для разных каналов, а для устройств по обе стороны одного канала указать одинаковые значения ID. Чтобы установить значение ID, используйте команду:
- xg -cell-id {0..15/1}
Например,
xg -cell-id 15
Чтобы настроить центральную частоту нисходящего канала (применимо для моделей, поддерживающих работу на разнесенных частотах/H-FDD), используйте команду:
- xg -freq-dl {channel-width==10:4905..5995/10 | channel-width==20:4910..5990/10 | channel-width==40:4920..5980/20}
Диапазон допустимых значений и шаг центральной частоты нисходящего канала для каждого возможного значения ширины канала указаны в фигурных скобках.
Например,
xg -freq-dl 5200
Чтобы настроить центральную частоту восходящего канала (применимо для моделей, поддерживающих работу на разнесенных частотах/H-FDD), используйте команду:
- xg -freq-ul {channel-width==10:4905..5995/10 | channel-width==20:4910..5990/10 | channel-width==40:4920..5980/20}
Диапазон допустимых значений и шаг центральной частоты нисходящего канала для каждого возможного значения ширины канала указаны в фигурных скобках.
Например,
xg -freq-ul 5400
Чтобы настроить центральную частоту канала, которая будет использоваться как для восходящего, так и для нисходящего канала, используйте команду:
- xg -freq
Например,
xg -freq 5200
В случае необходимости выбор рабочей частоты устройства может быть ограничен пользовательской частотной сеткой (например, при наличии законодательных или каких-либо других ограничений на использование некоторых частот, поддерживаемых устройством аппаратно). Чтобы настроить пользовательскую частотную сетку (в пределах физических/лицензионных ограничений используемого устройства), задайте для каждой полосы band каждого радиомодуля "carrier-ix" список поддиапазонов (начальная_частота–конечная_частота/шаг), используя команду:
- xg [-grids-carrier-ix=<grids-carrier-ix>] [-grids-band=<grids-band>] -grids {<freq_start>[-<freq_end>[/<step>]],...}
либо перечислите конкретные частоты через запятую в следующем виде:
- xg [-grids-carrier-ix=<grids-carrier-ix>] [-grids-band=<grids-band>] -grids=
Чтобы установить ширину канала в МГц, используйте команду:
- xg -channel-width {10, 20, 40}
Чтобы установить уровень выходной мощности в дБм, используйте команду:
- xg -txpwr {0..27/1}
Автоматическое управление модуляцией может осуществляться в соответствии с одной из следующих стратегий:
- "conservative" - использование более высоких пороговых значений CINR (соотношения сигнал/шум с учетом интерференции) с целью минимизации коэффициента блоковых ошибок
- "aggressive" - использование более низких пороговых значений CINR для выбора модуляций более высокого уровня с целью повышения пропускной способности
- "normal" - компромисс между двумя предыдущими стратегиями.
Чтобы выбрать необходимую стратегию автоматического управления модуляцией, используйте команду:
- xg -amc-strategy {normal | conservative | aggressive}
Чтобы задать максимально допустимый уровень модуляции при автоматическом управлении модуляцией, используйте команду:
- xg -max-mcs {1..10} – выбор одной из 10 поддерживаемых схем модуляции (от QPSK до QAM1024)
Приоритизация трафика может осуществляться в соответствии с одной из следующих стратегий:
- "aggressive" - обеспечение максимальной пропускной способности с возможностью незначительных потерь приоритетного трафика
- "conservative" - предотвращение потерь приоритетных пакетов с некоторым снижением пиковой пропускной способности
- "normal" - компромисс между двумя предыдущими стратегиями
- "off" - отсутствие приоритизации.
Чтобы выбрать необходимую стратегию приоритизации трафика, используйте команду:
- xg -qos-strategy {normal | conservative | aggressive | off}
Чтобы получить статистические данные о работе беспроводного соединения, используйте команду:
- xg stat [-phy] [-1]
- "-phy" – выдача подробной информации о физических параметрах работы беспроводного соединения
- "-1" – отображение отдельного статического состояния набора данных.
Пример вывода команды (фрагмент),
#console>xg stat Wireless Interface Statistics Interface Status: UP +--------------------------------------+--------------------------------------+ | Receive Statistics | Transmit Statistics | +--------------------------------------+--------------------------------------+ |Air Frames Received 137926 |Air Frames Transmitted 70356 | |Packets Received 2 |Packets Transmitted 3 | +--------------------------------------+--------------------------------------+ Wireless Link Statistics +----------------------+--------------+ |Wireless Link status |Up | |Measured Distance |16 meters | |Channel Width |40 MHz | |DL/UL Ratio |50:50 | +----------------------+--------------+ +---+-----------+--------------+---------------+---------------+--------------+ | Device Type | Master (local) | Slave (remote) | +---+-----------+--------------+---------------+---------------+--------------+ |Tx Capacity | 156549 kbps | 143503 kbps | +---+-----------+--------------+---------------+---------------+--------------+ | | Carrier 0 (carrier status Up) |#состояние радиомодуля +---+-----------+--------------+---------------+---------------+--------------+ |Tx Frequency | 5600 MHz | 5600 MHz | |AMC Mode | Auto | Auto | +---+-----------+--------------+---------------+---------------+--------------+ | | Stream 0 | Stream 1 | Stream 0 | Stream 1 | +---+-----------+--------------+---------------+---------------+--------------+ |TX |Tx Power |9.87 dBm |9.89 dBm |10.18 dBm |10.16 dBm | +---+-----------+--------------+---------------+---------------+--------------+ |RX |Rx MCS |QAM256 6/8 (7)|QAM64 5/6 (6) |QAM256 6/8 (7) |QAM64 5/6 (6) | | |CINR |30 dB |28 dB |31 dB |30 dB | | |RSSI |-36 dBm |-36 dBm |-37 dBm |-37 dBm | | |Acc TBER |0.0e0 (0.0%) |0.0e0 (0.0%) |0.0e0 (0.0%) |0.0e0 (0.0%) |#кумулятивный коэффициент блоковых ошибок
Чтобы очистить (обнулить) статистические данные, используйте команду:
- xg stat -clear
Чтобы получить информацию о возможностях радиоподсистемы, используйте команду:
- xg capabilities
Пример вывода команды,
#console>xg capabilities Radio capabilities General properties Radio module name: RMU-55-05:41049 Antenna methods supported: MIMO Duplex types supported: TDD Frame periods supported: 1, 2, 5, 10 ms Channel widths available: 10, 20, 40 MHz Number of carriers: 1 Carrier 0 frequency range: 4900..6000 MHz Carrier 0 Tx power range: 0..27/1 dBm Carrier 0 configuration (Channel width 40 MHz,allocated DL/UL ratio 50:50 (28:28 air blocks), frame period 1 ms, ttg/rtg (3:3 air blocks), qos strategy: normal): +---------------+-------------------------------+-------------------------------+-------------------------------+ | MCS | Modulation | DL/UL capacity, kbps |Total rate, kbps | +---------------+-------------------------------+-------------------------------+-------------------------------+ | 1 | QPSK 1/2 | 26091/26091 |57344 | | 2 | QPSK 3/4 | 39137/39137 |86016 | | 3 | QAM16 1/2 | 52183/52183 |114688 | | 4 | QAM16 3/4 | 78274/78274 |172032 | | 5 | QAM64 4/6 | 104366/104366 |229376 | | 6 | QAM64 5/6 | 130457/130457 |286720 | | 7 | QAM256 6/8 | 156549/156549 |344064 | | 8 | QAM256 7/8 | 182640/182640 |401408 | | 9 | QAM256 30/32 | 195686/195686 |430080 | | 10 | QAM1024 8/10 | 208732/208732 |458752 | +---------------+-------------------------------+-------------------------------+-------------------------------+ Lower..upper central frequencies: 4910..5990 MHz Frequency grid (default): 4920-5980/20 MHz Frequency list (54 channels): 4920, 4940, 4960, 4980, 5000, 5020, 5040, 5060, 5080, 5100, 5120, 5140, 5160, 5180, 5200, 5220, 5240, 5260, 5280, 5300, 5320, 5340, 5360, 5380, 5400, 5420, 5440, 5460, 5480, 5500, 5520, 5540, 5560, 5580, 5600, 5620, 5640, 5660, 5680, 5700, 5720, 5740, 5760, 5780, 5800, 5820, 5840, 5860, 5880, 5900, 5920, 5940, 5960, 5980 MHz
Чтобы посмотреть конфигурацию локального устройства, используйте команду:
- xg config –self
Чтобы посмотреть конфигурацию удаленного устройства, используйте команду:
- xg config -peer-exported
Выходные данные команды могут быть использованы для синхронизации настроек устройств (см. Указания по первичной настройке, установке и контролю за состоянием).
Конфигурация отображается в виде:
xg -appendconf-v2-start xg -appendconf-v2 <encoded web config> xg -appendconf-v2-end
Чтобы посмотреть конфигурацию устройства по умолчанию, используйте команду:
- xg config –defaults
Указание по первичной настройке, установке и контролю за состоянием радиоканала
- Шаг 1
Произведите обследование участка:
- Оцените условия прямой видимости и препятствия на пути распространения сигнала
- Произведите анализ спектра, чтобы оценить его занятость и помеховую обстановку и определить доступные каналы
- Используйте специальные программные продукты для планирования каналов, чтобы оценить производительность канала и определить необходимые настройки антенн, выбрать ширину канала, выходную мощность и т.д.
- Шаг 2
Произведите первоначальные настройки оборудования в лабораторных условиях:
- Настройте одно устройство как ведущий узел (тип Master), а второе как ведомый (тип Slave)
- Установите ширину канала, центральные частоты и соотношение нисходящего и восходящего каналов, длительность кадра радиоканала, максимальную дальность канала (значительно больше предполагаемой реальной дальности), выходную мощность и т.д.
Обратите внимание, что следующие настройки должны быть одинаковыми по обе стороны канала:
- идентификатор соединения ID
- частоты нисходящего / восходящего каналов
- ширина канала
- соотношение нисходящего / восходящего каналов
- длительность кадра радиоканала.
Иначе соединение между устройствами не будет установлено!
ВНИМАНИЕ
Чтобы синхронизировать настройки устройств, скопируйте с одного устройства на другое строку "Peer exported config", показываемую в выходных данных команды "xg config -peer-exported". См. Пример конфигурации ниже.
Пример конфигурации
#Peer exported config: xg -appendconf-start xg -appendconf IC1kbHF1b3RhIDcwIC1zZnJhbWVsZW4gMTAgLW1heC1kaXN0YW5jZSAyNzU xg -appendconf wIC1ydGctbWFudWFsLWVuYWJsZSAwIC1jZWxsLWlkIDAgLWZyZXEtZGwgNj xg -appendconf M4MCAtZnJlcS11bCA2MzgwIC10eHB3ciAxNSAtdHhnYWluIC0zMiAtY2hhb xg -appendconf m5lbC13aWR0aCAxMCAtYW1jLW1vZGUgYXV0byAtYW1jLXN0cmF0ZWd5IGFn xg -appendconf Z3Jlc3NpdmUgLXRlc3QtYW1jLW9mZnNldCAtMyAtdGVzdC1hbWMtb2Zmc2V xg -appendconf 0LWVuYWJsZSAxIC1tYXgtbWNzIDkgLXFvcy1zdHJhdGVneSBub3JtYWwgLX xg -appendconf JsbS12ZXJib3NpdHktbGV2ZWwgMg==.36caaf5c9d9ebc2433482ac4565b xg -appendconf 241e xg -appendconf-end
Сохраните конфигурацию, перезагрузите оба устройства, а затем проверьте, установилось ли между ними радиосоединение.
- Шаг 3
Произведите первоначальную юстировку:
- Установите устройства на мачте, сориентировав их друг на друга
- Включите их и проверьте по встроенным светодиодным индикаторам RF, установилось ли между ними радиосоединение
- Произведите грубую юстировку по встроенным светодиодным индикаторам уровня мощности сигнала
- Произведите тонкую настройку, используя данные из вывода команды "xg stat". Постарайтесь максимизировать значения CINR и Absolute RSSI.
ВНИМАНИЕ
Если значение Absolute RSSI превышает -40 дБм, уменьшите выходную мощность удаленного устройства, чтобы снизить его до уровня -40…-50 дБм для максимизации производительности.
- Шаг 4
Оптимизируйте производительность канала связи:
- Настройте параметр максимальная дальность канала на основе измеренного значения дальности
ВНИМАНИЕ
Проверьте измеренную дальность канала, используя выходные данные "xg stat" и отрегулируйте настройки "xg –max-distance", добавив 200-300 м к измеренному значению.
- Проверьте кумулятивный коэффициент блоковых ошибок "Acc TBER" в выходных данных "xg stat" и при необходимости скорректируйте стратегию автоматического управления модуляцией. Рекомендуется сначала выбрать стратегию "normal", а затем скорректировать её с учетом целевых и действующих значений "Acc TBER".
ВНИМАНИЕ
Допустимый коэффициент блоковых ошибок зависит от приложения, в рамках которого используется радиоканал. Примеры допустимых коэффициентов см. в Таблице Коэффициент блоковых ошибок для различных приложений.
- Выберите оптимальную длительность кадра радиоканала.
ВНИМАНИЕ
Система поддерживает значения длительности кадра радиоканала от 1 до 10 мс.
Кадр длительностью 1 мс обеспечивает минимальную задержку (от 500 мкс в одном направлении).
Использование кадра длительностью 10 мс позволяет минимизировать накладные расходы, в результате чего при той же схеме модуляции максимальная пропускная способность примерно на 12% выше, чем при использовании кадра длительностью 1 мс. Кроме того, использование кадра 10 мс обеспечивает более стабильную производительность по сравнению с кадром 1 мс: снижение максимальной пропускной способности с увеличением расстояния на 100 км для кадра 10 мс составляет 7%, а для кадра 1 мс - 75%.