...

#1> xg [arguments]

Code Block

language	powershell
theme	Emacs

#1> xg
usage:

   xg config
   xg config -peer-exported
   xg config -defaults
   
   xg [-grids-carrier-ix=<carrier-ix>] [-grids-band=<channel-width>] -grids {<freq_start>[-<freq_end>[/<step>]]}[,...]
   xg [-grids-carrier-ix=<carrier-ix>] [-grids-band=<channel-width>] -grids=
  
 General settings
   xg -type {master, slave}
   xg -tdd-sync-src {freerun, gnss}
   xg -autosync-link-settings {no, no-co-sa-no-reboot, no-reboot, reboot-remote-if-needed}	

 Link shared settings (Radio Front End)
   xg -cell-id {0..15/1}
   xg -channel-width {10, 20, 40}
   (channel-width 10): xg -freq-dl {6005..6415/50}
   (channel-width 20): xg -freq-dl {6010..6410/20}
   (channel-width 40): xg -freq-dl {6020..6400/50}
   (channel-width 10): xg -freq-ul {6005..6415/50}
   (channel-width 20): xg -freq-ul {6010..6410/20}
   (channel-width 40): xg -freq-ul {6020..6400/50}
   xg -short-cp {0, 1} 
   xg -freg-auto {0, 1}

 Link shared settings (Frame Config)
   xg -max-distance {1..100/1}
   xg -sframelen {2, 4, 5, 10}
   xg -tdd-profile {0..7/1}
   xg -tdd-profile-auto-switching {0, 1}

 RF per-station settings
   xg -txpwr {0..27/1}
   xg -ctrl-block-boost {0, 1}
   xg -atpc-master-enable {0, 1}
   xg -atpc-target-rssi {-70..-40/1}
   xg -atpc-rssi-threshold {0..5/1}

 Modulation related
   xg -amc-strategy {normal, conservative, aggressive}
   xg -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>

Commands and options description is given in the table below:

Center

Scroll Title

title	Table - "xg" commands and options description

Command

Description

xg config

Local unit configuration

xg config -peer-exported

Unit configuration except the "Node Type" parameter

The outputs have the following view:

Code Block

language	powershell
theme	Emacs

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

xg config -defaults

The default unit configuration

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

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

xg [-grids-carrier-ix=<carrier-ix>] [-grids-band=<channel-width>] -grids=

Sequence of frequencies separated by commas

xg -type {master | slave}

Set the node type to "master" or "slave". Point-to-point link can be set between "master" and "slave" unit

Example,

Code Block

language	powershell
theme	Emacs

xg -type master

xg -tdd-sync-src {freerun | gnss}

Configure TDD synchronization parameter:
- "freerun" - the "slave" unit synchronization is performed with the built-in GPS/GLONASS receiver of the "master" unit
- "gnss" - synchronization from built-in GPS/GLONASS receiver

Warning

title	CAUTION

GNSS option is effective for "master" unit only.

Warning

title	CAUTION

Before enabling "gnss" option make sure that built-in GNSS-receiver is configured properly. Use "gps" command to configure or check the status (use values of "HDOP" up to 1.5).

xg -autosync-link-settings {no, no-co-sa-no-reboot, no-reboot, reboot-remote-if-needed}

Automatic link synchronization:

"no" - disabled
"no-co-sa-no-reboot" - sync settings are not saved, the remote unit is not rebooted
"no-reboot" - sync settings are saved, the remote unit is not rebooted
"reboot-remote-if-needed" - save and reboot the remote unit if needed.

The automatic link synchronization option will always be executed if it is enabled in CLI and not checked in the web interface

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

Set the link ID value
Use this parameter to avoid connecting a unit to a wrong peer if there are several co-located units using the same center frequency
Specify different ID values for different link. Both ends of the same link must have the same ID. The value range is 0…15 in increments of 1

Example,

Code Block

language	powershell
theme	Emacs

xg -cell-id 15

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

Set the channel width (in MHz). The possible values are: 10, 20 or 40 MHz

(channel-width 10): xg -freq-dl {6005..6415/50}

(channel-width 20): xg -freq-dl {6010..6410/20}

(channel-width 10): xg -freq-dl {6020..6400/50}

Set the downlink center frequency (applicable to the models supporting split-frequency/H-FDD operation)
The range of available values for each of the channel widths is specified in braces.

Example,

Code Block

language	powershell
theme	Emacs

xg -freq-dl 6410

Note

title	NOTE

For the units with two radio modules the downlink center frequency must be set for both.

Example,

Code Block

language	powershell
theme	Emacs

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

(channel-width 10): xg -freq-ul {6005..6415/50}

(channel-width 20): xg -freq-ul {6010..6410/20}

(channel-width 10): xg -freq-ul {6020..6400/50}

Set the uplink center frequency (applicable to the models supporting split-frequency/H-FDD operation)
The range of available values for each of the channel widths is specified in braces.

Example,

Code Block

language	powershell
theme	Emacs

xg -freq-ul 6400

Note

title	NOTE

For the units with two radio modules the uplink center frequency must be set for both.

Example,

Code Block

language	powershell
theme	Emacs

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

xg -short-cp {0, 1}

Enable/disable the "Short Cyclic Prefix" option
Cyclic prefix is used to mitigate inter-symbol interference due to multipath propagation environment
Cyclic prefix size is always 1/8 for 10 MHz channel width

xg -freg-auto {0, 1}

Enable/disable the automatic frequency selection, in case of DFS option in license

Example,xg -freq 6415

Notecode

title

language	powershell
theme	Emacs

NOTE

The automatic frequency selection option is NOT available for the InfiLINK XG 1000 family devices.

xg -max-distance {1..100/1}

Specify the maximum link distance (in kilometers). The possible values: from 1 to 100 in increments of 1 km
The specified value must not be lower than the actual link distance, but it is recommended keep it as close as possible to the actual distance to avoid unnecessary overheads
The recommended strategy is to set this parameter well above the actual distance after the units have been deployed based on the measured distance value taken from “xginfo stat” output

Example,

Code Block

language	powershell
theme	Emacs

xg -max-distance 50

xg -sframelen {2, 4, 5, 10}

Set the air frame period duration (in ms). The value range is 2, 4, 5 or 10 ms
A shorter frame period gives lower latency, but also has higher overheads
Using longer frame periods cuts down overheads, but increases the latency

Example,

Code Block

language	powershell
theme	Emacs

xg -sframelen 10

xg -tdd-profile {0..7/1}

Set the TDD profile
Current and available profile value, DL/UL ratio depending on the frame period can be checked in the output of "xginfo capabilities -verbose" command

Example,

Code Block

language	powershell
theme	Emacs

xg -tdd-profile 5

DL/UL values for the profile 5:

Center

xg -tdd-profile-auto-switching {0, 1}

Enable/disable the automatic downlink/uplink ratio selection

xg -txpwr {0..27/1}

Set a transmit power level (in dBm). The value range is 0…27 dBm in increments of 1 dBm

Note

title	NOTE

For the units with two radio modules the transmit power must be set for both. The value range is 0…22 dBm in increments of 1 dBm.

Example,

Code Block

language	powershell
theme	Emacs

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

xg -ctrl-block-boost {0, 1}

Enable/disable control block boost option
Control Block Boost improves link availability in the most difficult propagation and interference conditions due to the radio frame with control information transfer at duplicate transmit power

xg -atpc-master-enable {0, 1}

Enable/disable "ATPC Master"
- The master unit manages the transmit power of the remote unit in order to achieve the target RSSI value of its own receiver

xg -atpc-target-rssi {-70..-40/1}

The RSSI target value:
- The RSSI value of the master tries to engage the target range, the center value of which is the "Target RSSI"
- Practical range: from -20 to -70 dBm (the actual: from -40 to -70 dBm)

xg -atpc-rssi-threshold {0..5/1}

The RSSI value threshold on the master side

xg -amc-strategy {normal, conservative, aggressive}

Set the AMC algorithm strategy:
- “conservative” assumes using higher CINR thresholds in order to minimize the error rate
- “aggressive” lowers the thresholds in order to use higher modulation levels and thus increase the throughput
- “normal” represents a balance between the error rate and throughput values

xg -max-mcs {1..10/1}

Set the maximum MCS that can be used: from 1 to 10 (from QPSK to 1024)

xg -idfs-enable {0, 1}

Enable/disable Instant DFS option

Note

title	NOTE

The "Instant DFS" option is only available for the InfiLINK XG family 5 GHz devices.

xg -idfs-rssi-threshold {1..50/1}

RSSI threshold for switching

xg -idfs-ffs-time {0..600/1}

Frequency forced holding time

xg -idfs-rdrdt-enable {0, 1}

Enable/disable frequency scanning

xg -idfs-fix-dl-ul {0, 1}

Prevents Instant DFS to select different values of the DL/UL ratio

xg -traffic-prioritization {0..1/1}

Enable/disable traffic prioritization strategy. Unit will recognize the 802.1p tags in Ethernet frame headers. Based on these tags priorities will be autlomatically assigned to the frames when they are sent over the radio interface. Priorities may be adjusted manually (Commands for switch configuration).

xg -1588-sync-tai {1, 0}

Enable/disable Master devices synchronization through the wired connection from an external synchronization source by IEEE 1588 protocol.

Note

title	NOTE

To ensure two Masters synchronization from the synchronization source, the PTP Daemon on must be configured in Master mode on one of them, on the other - in a Slave mode.

For the first Master device:

Code Block

language	text
theme	Emacs

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

For the second Master device:

Code Block

language	text
theme	Emacs

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

xg -config-restore-time {1..60/1}

Time of already established link checking, by default 5 minutes
In order to stay the link after a new configuration applying, the unit checks the link establishment during this time and automatically restores the previous configuration in case the link was not established.

Note

title	NOTE

Detailed description is given in the document "Safety apply settings in InfiLINK XG / InfiLINK XG 1000".

xg -config-restore-index {1..8/1}

Unit configuration backup index

xg -passphrase=<pass>

Set the passphrase

xg -freq<val> => xg -freq-dl <val> -freq-ul <val>

Set the center frequency value

Example,

Code Block

language	powershell
theme	Emacs

xg -freq 6415

Note

title	NOTE

Initial configuration procedure of the PtP link setup between the units is described in the section "Laboratory pre-configuration".

xginfo

Use this command to output the information data.

Syntax:

#1> xginfo [arguments]

Code Block

language	java
theme	DJango

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

"xginfo" command arguments description is given in the table below

Center

Scroll Title

title	Table - "xginfo" commands and options description

Command	Description
xginfo stat [-verbose] [-clear] [-1]	Displays the link statistics: "-verbose" - detailed information about physical link parameters "-clear" - reset the statistics data "-1" - single snapshot of the statistics data
xginfo capabilities [-verbose]	Displays the radio system capabilities
xginfo version	Displays the current firmware version
xginfo availability [-verbose] [-clear]	Displays the link availability statistics: "-verbose" - detailed information "-clear" - reset the statistics data

xgutils

Syntax:

#1> xgutils [arguments]

Code Block

language	powershell
theme	Emacs

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

"xgutils" commands and options description is given in the table below

Center

Scroll Title

title	Table - "xgutils" commands and options description

Command	Description
xgutils ber-amc-show [-carrier <CARRIER_NUM>] [-1]	Displays auto bitrate mechanism counters
xgutils ber-amc-reset [-mask <STREAM_MASK>]	Bitrate adjustment mechanism reset counters based on a bit error counters
xgutils dfs -list [-clear]	Displays a list of available frequencies and information on them (noise level, radar availability, selected frequency) "clear" - reset the radars list and frequency scanning data
xgutils dfs -stat [-clear]	Instant DFS switching statistics "clear" - reset the statistics

xgdfs

Syntax:

#1> xgdfs [arguments]

Code Block

language	powershell
theme	Emacs

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

"xgdfs" commands and options description is given in the table below

Center

Scroll Title

title	Table - "xgdfs" commands and options description

Command	Description
xgdfs -list [-clear]	Displays a list of available frequencies and information on them (noise level, radar availability, selected frequency) "clear" - reset the radars list and frequency scanning data
xgdfs -stat [-clear]	Instant DFS switching statistics "clear" - reset the statistics

Page tree

Versions Compared

Old Version 14

New Version Current

Key

xginfo

xgutils

xgdfs

Page tree

Page History

Versions Compared

Old Version 14

New Version Current

Key

xginfo

xgutils

xgdfs