Syntax:

#1> ifc radio {up | down} 

Syntax:

#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

Command arguments

Point-to-point link can be set between a Master and a Slave unit only. In order to choose InfiLINK XG device type, use the command:

• xg -type {master | slave}

Example:

xg -type master 

In order to setup TDD synchronization parameters, use the command:

• xg -tdd-sync-src {freerun | gnss}
  • "freerun" - unsynchronized frame start.
  • "gnss" - synchronization from built-in GPS/GLONASS receiver.

Possibility of the frequency re-use depends on the antenna types, placement, direction, link distances, etc.

If you need to set a downlink/uplink ratio, use the following command, specifying as a value the size of downlink subframe relative to the whole frame (e.g. “xg -dlquota 70” should be specified for downlink/uplink ratio of 70/30):

• xg -dlquota {1..99}

Actual downlink/uplink ratio might be different due to internal system limitations. The system chooses closest available ratio automatically. The current value of this ratio can be checked in the output of "xg capabilities" command.

Example:

xg -dlquota 70

In order to set air frame period in milliseconds, use the command:

• xg -sframelen {1, 2, 5, 10}

Example:

xg –sframelen 10

The shorter air frame period, the lower latency, but also the higher overheads. Using longer frame periods cuts down overheads, but increases latency.

In order to specify maximum link distance in meters, use the command:

• xg -max-distance {0..55800/1}

Example: 

xg -max-distance 5000

The specified value must be no lower actual link distance, and it is recommended keep it as close as possible to the actual distance to avoid unnecessary overheads. The recommended sequence of configuration is to set this parameter well above the actual distance and after the units have been deployed fine-tune it based on the measured distance value, taken from "xg stat" output.

In order to avoid connection of the unit to a wrong node (if several co-located units are using the same center frequency), it is recommended to specify different ID values for different link. Both ends of the same link must have the same ID.

In order to specify ID value, use the command:

• xg -cell-id {0..15/1}

Example:

xg -cell-id 15

If you need to configure downlink center frequency (applicable to the models supporting split-frequency/H-FDD operation), use the command:

• xg -freq-dl  {channel-width==10:4905..5995/10 | channel-width==20:4910..5990/10 | channel-width==40:4920..5980/20}

The range of available values and increment size for each of the channel widths is specified in braces.

Example: 

xg -freq-dl 5200

In order to configure uplink center frequency (applicable to the models supporting split-frequency/H-FDD operation), use the command:

• xg -freq-ul {channel-width==10:4905..5995/10 | channel-width==20:4910..5990/10 | channel-width==40:4920..5980/20}

The range of available values and increment size for each of the channel widths is specified in braces.

Example:

xg -freq-ul 5400 

If you need to configure downlink/uplink center frequency (sets the same frequency channel to both uplink and downlink), use the command:

• xg -freq

Example:

xg -freq 5200

If you need to set the limits on the available operation frequencies (for example, if there are some legal or other restrictions for usage of some part of hardware supported frequencies), you can configure a custom frequency grid.

In order to set a custom frequency grid (within physical/license limits of a specific model), define the grid individually for each band of each carrier as a list of sub-bands, using the command:

• xg [-grids-carrier-ix=<grids-carrier-ix>] [-grids-band=<grids-band>] -grids {<freq_start>[-<freq_end>[/<step>]],...}

or as a sequence of frequencies:

• xg [-grids-carrier-ix=<grids-carrier-ix>] [-grids-band=<grids-band>] -grids=

In order to set a channel width in MHz, use the command:

• xg -channel-width {10, 20, 40}

In order to set a transmit power level in dBm, use the command:

• xg -txpwr {0..27/1}

There are three possible variants of AMC strategy:

• conservative assumes using higher CINR thresholds in order to minimize error rates;
• aggressive strategy of using lower CINR thresholds in order to use higher modulation levels for increasing the throughput;
• normal represents the balance between the two above-mentioned.

In order to select AMC strategy, use the command:

• xg -amc-strategy {normal | conservative | aggressive}

In order to set the highest modulation level for AMC algorithm, use the command:

• xg -max-mcs {1..10} – one of the ten supported MCSs (from QPSK to QAM1024)

There are four possible variants of traffic prioritization strategy:

• "aggressive" - maximal throughput with a minor priority packet loss allowed;
• "conservative" - no priority packet loss with small decline in the peak throughput;
• "normal" - the balance between the two above-mentioned;
• "off" - no prioritization.

In order to select traffic prioritization strategy, use the command:

• xg -qos-strategy {normal | conservative | aggressive | off}

If you want to view link statistics, use the command:

• xg stat [-phy] [-1]
  • "-phy" - the system displays in-depth physical layer link statistics;
  • "-1" - the system displays a single snapshot of statistics data.

Sample command output

#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%)  |# Acc TBER - accumulated transmission block error rate

In order to clear statistics, use the command:

• xg stat -clear

If you need to get information about radio subsystem capabilities, use the command:

• xg capabilities

Command outputs example

#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

In order to view the configuration of the local unit, use the command:

• xg config –self

In order to view the configuration of the remote unit, use the command:

• xg config -peer-exported

The outputs of the command can be used for synchronization of the settings on the unit (see Modem configuration for details).

The outputs have the following view:

xg -appendconf-v2-start
xg -appendconf-v2 <encoded web config>
xg -appendconf-v2-end

In order to view the default configuration, use the command:

• xg config –defaults.

Initial configuration, installation and monitoring guidelines 

• Step 1

Perform site survey:

• • Determine line of sight conditions and obstacles along the path
  • Perform spectrum analysis in order to estimate its occupation and interference situation and to determine available channels
  • Use available link planning tools to estimate link performance and required configurations for antennas, to choose channel width, Tx power, etc.
• Step 2
  • Pre-configure the units in the lab:
  • Configure one unit as a Master node and another as a Slave node
  • Set channel width, center frequencies and downlink/uplink ratio of frequency channels, air frame period, maximum distance (well above estimated link distance), Tx power, etc.

Configuration example

#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

• • Save the configuration, reboot both units, and check if they link up after reboot.
• Step 3

Perform initial alignment

• • Install both units on the masts and direct them roughly at each other
  • Switch them on and check that the wireless link is established, using RF link led indicators
  • Perform rough alignment, using built-in led indicators of signal strength
  • Perform fine alignment, using xg stat outputs. Try to maximize CINR and Absolute RSSI values. 

• Step 4

Optimize link performance

• • Check the air block error rate Acc TBER in xg stat outputs and adjust AMC strategy if necessary. It is recommended to use Normal strategy initially and then adjust it based on target and actual Acc TBER values.

• • Select the most appropriate air frame period.

Frame with period of 1 ms gives the lowest latency (from 500 us one-way).

Frame with period of 10 ms has lowest overheads. As a result, it has approximately 12% better maximal throughput for the same MCS than one with period of 1 ms. Also, 10 ms frame provides more stable performance - it has significantly lower distance penalty compared to 1 ms: at 100 km the maximal throughput decreases by 7% at 10 ms and by 75% at 1 ms.