Page tree
Skip to end of metadata
Go to start of metadata

ifc radio

Use this command to enable or disable the system radio interface.

Syntax:

#1> ifc radio {up | down} 

xg

Use this command to set the air link parameters.

Syntax:

#1> xg [arguments]

#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 {off, on}

 Supplementary
   xg -config-restore-timeout {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:

CommandDescription
xg config 
  • Local unit configuration
xg config -peer-exported
  • Unit configuration except the "Node Type" parameter

The outputs have the following view:

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,

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

CAUTION

GNSS option is effective for "master" unit only.

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,

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,

xg -freq-dl 6410

NOTE

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

Example,

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,

xg -freq-ul 6400

NOTE

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

Example,

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
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,

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,

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,

xg -tdd-profile 5

DL/UL values for the profile 5:

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

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,

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
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 -config-restore-timeout {1..60/1}
  • Time of link establishment checking, by default 10 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.
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,

xg -freq 6415
Table - "xg" commands and options description

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]

#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

CommandDescription
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
Table - "xginfo" commands and options description

xgutils

Syntax:

#1> xgutils [arguments]

#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

CommandDescription
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
Table - "xgutils" commands and options description

xgdfs

Syntax:

#1> xgdfs [arguments]

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

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

CommandDescription
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
Table - "xgdfs" commands and options description