Синтаксис: 

#1> ifc radio {up | down} 

Команда XG

"xg"

Используется для настройки параметров радиоканала.

#1> xg 
usage:

   xg config
   xg -type {master | slave}
Radio frame params relatedconfig -peer-exported
   xg config -defaults
   
   xg [-tdd-sync-src {freerun | gnss}
   xg -dlquota {1..99/1}grids-carrier-ix=<carrier-ix>] [-grids-band=<channel-width>] -grids {<freq_start>[-<freq_end>[/<step>]]}[,...]
   xg -sframelen {1 | 2 | 5 | 10}[-grids-carrier-ix=<carrier-ix>] [-grids-band=<channel-width>] -grids=
  
 General settings
   xg -max-distancetype {0..120000/1} master, slave}
   xg -celltdd-sync-idsrc {0..15/1}
Radio front end relatedfreerun, gnss}
   xg -autosync-freqlink-dlsettings {channel-width==10:4905..5995/10 | channel-width==20:4910..5990/10 | channel-width==40:4920..5980/20}no, no-co-sa-no-reboot, no-reboot, reboot-remote-if-needed}	

 Link shared settings (Radio Front End)
   xg -freqcell-ulid {channel-width==10:49050..5995/10 | channel-width==20:4910..5990/10 | channel-width==40:4920..5980/20}
   xg -txpwr {0..27/115/1}
   xg -channel-width {10, 20, 40}
   (channel-width 10): xg -freq-dl {6005..6415/50}
   xg -(channel-width {10 | 20 | 40}

Modulation related
  20): xg -freq-dl {6010..6410/20}
   (channel-width 40): xg -amcfreq-strategydl {normal | conservative | aggressive}
   6020..6400/50}
   (channel-width 10): xg -maxfreq-mcsul {16005..106415/150}

DFS/RSSI scan/Radar detection

Ethernet datapath related 
      (channel-width 20): xg -qosfreq-strategy {normal | conservative | aggressive | off}

Supplementary

alias:ul {6010..6410/20}
   xg (channel-freqwidth <val> => 40): xg -freq-dl <val> -freq-ul <val>

ul {6020..6400/50}
   xg -short-cp {0, 1} 
   xg -appendconf-v2-start
   xg -appendconf-v2 <encoded web config>freg-auto {0, 1}

 Link shared settings (Frame Config)
   xg -appendconf-v2-endmax-distance {1..100/1}
   xg [-grids-carrier-ix=<grids-carrier-ix>] [-grids-band=<grids-band>] -grids {<freq_start>[-<freq_end>[/<step>]],...-sframelen {2, 4, 5, 10}
   xg -tdd-profile {0..7/1}
   xg [-gridstdd-carrierprofile-ix=<grids-carrier-ix>] [-grids-band=<grids-band>] -grids=
auto-switching {0, 1}

 RF per-station settings
   xg stat [-phy] [-1]txpwr {0..27/1}
   xg stat -clear -ctrl-block-boost {0, 1}
   xg capabilities
 -atpc-master-enable {0, 1}
   xg config-atpc-target-rssi {-70..-40/1}
   xg config -self-atpc-rssi-threshold {0..5/1}

 Modulation related
   xg config -peer-exportedamc-strategy {normal, conservative, aggressive}
   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/ГЛОНАСС приемника.

Возможность переиспользования частот зависит от типа антенны, места размещения, направления, дальности канала и т.д.

Чтобы установить необходимое соотношение нисходящего и восходящего каналов, используйте следующую команду, указав в качестве значения размер подкадра нисходящего канала по отношению к целому кадру:

• 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)
  • Установите ширину канала, центральные частоты и соотношение нисходящего и восходящего каналов, длительность кадра радиоканала, максимальную дальность канала (значительно больше предполагаемой реальной дальности), выходную мощность и т.д.

Пример конфигурации

#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.

• Шаг 4

Оптимизируйте производительность канала связи:

• • Настройте параметр максимальная дальность канала на основе измеренного значения дальности

• • Проверьте кумулятивный коэффициент блоковых ошибок "Acc TBER" в выходных данных "xg stat" и при необходимости скорректируйте стратегию автоматического управления модуляцией. Рекомендуется сначала выбрать стратегию "normal", а затем скорректировать её с учетом целевых и действующих значений "Acc TBER".

• • Выберите оптимальную длительность кадра радиоканала.

Кадр длительностью 1 мс обеспечивает минимальную задержку (от 500 мкс в одном направлении).

-max-mcs {1..11/1}

 DFS/RSSI scan/Radar detection
   xg -idfs-enable {0, 1}
   xg -idfs-rssi-threshold {1..50/1}
   xg -idfs-ffs-time {0..600/1}
   xg -idfs-rdrdt-enable {0, 1}
   xg -idfs-fix-dl-ul {0, 1}
  
 Ethernet datapath related
   xg -traffic-prioritization {0..1/1}
   (idfs-enable 0): xg -1588-sync-tai {1, 0}

 Supplementary
   xg -config-restore-time {1..60/1}
   xg -config-restore-index {1..8/1}
   xg -passphrase=<pass>
 aliases:
   xg -freq <val> => xg -freq-dl <val> -freq-ul <val>

Описание команд и опций "xg" приведено ниже в таблице

xg -v3-start 
xg -v3 <encoded web config> 
xg -v3-end

xg -type master 

xg -cell-id 15

xg -freq-dl 6410

xg -freq-dl [0]6000,[1]6100

xg -freq-ul 6400

xg -freq-ul [0]6200,[1]6300

xg -max-distance 50

xg -sframelen 10

xg -tdd-profile 5

xg -txpwr [0]10,[1]15

xg -tdd-sync-src freerun
xg -1588-sync-tai 1
ptpd -b ge1 start

xg -tdd-sync-src 1588
xg -1588-sync-tai 1
ptpd -g -b ge1 start

xg -freq 6415

"xginfo"

Используется для вывода информационных данных.

#1> xginfo
usage:
   xginfo stat [-verbose] [-clear] [-1]
   xginfo capabilities [-verbose]
   xginfo version
   xginfo availability

"xgutils"

Команда утилит.

#1> xgutils
usage:
   xgutils ber-amc-show [-carrier <CARRIER_NUM>] [-1]
   xgutils ber-amc-reset [-mask <STREAM_MASK>]

#1> xgdfs
usage:
   xgdfs -list [-clear]
   xgdfs -stat [-clear]