Infinet Wireless: Technical Documentation
Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

"ifc radio" command

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

Syntax:

#1> ifc radio {up | down} 

"xg" command

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 config -make-release-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}

 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}

 Link shared settings (Frame Config)
   xg -max-distance {1..100/1}
   xg -sframelen {2, 4, 5, 10}
   xg -dlquota {1..99/1}

 RF per-station settings
   xg -txpwr {0..27/1}
   xg -ctrl-block-boost {0, 1}

 Modulation related
   xg -amc-strategy {normal, conservative, aggressive}
   xg -max-mcs {1..10/1}

 DFS/RSSI scan/Radar detection
   xg -freq-auto {0, 1}

 Ethernet datapath related
   xg -traffic-prioritization {off, on}

 Supplementary

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

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

CommandDescription
xg config 
  • View the configuration of the local unit
xg config -peer-exported

The outputs have the following view:

xg -v3-start
xg -v3 <encoded web config>
xg -v3-end
 xg config -defaults
  •  View the default configuration of the unit
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 source:
    • "freerun" - unsynchronized frame start
    • "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 -cell-id {0..15/1}
  • Specify 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}
  • Configure 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}

  • Configure 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


(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}

  • Configure 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-ul 6400
xg -freq
  • Сonfigure downlink/uplink center frequency (sets the same frequency channel to both uplink and downlink)

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 -dlquota {1..99/1}
  • Set the actual downlink/uplink ratio values through specifying the downlink subframe period relative to the whole frame
  • 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 "xginfo capabilities" command
xg -dlquota 80
xg -txpwr {0..27/1}
  • Set a transmit power level (in dBm). The value range is 0…27 dBm in increments of 1 dBm
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 -amc-strategy {normal, conservative, aggressive}
  •  Select 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}
  •  Configure the maximum MCS that can be used: from 1 to 10 (from QPSK to 1024)
xg -freg-auto {0, 1}
  •  Enable/disable DFS option
xg -traffic-prioritization {off, on}
  •  Enable/disable prioritization strategy
Table - "xg" arguments description

NOTE

Initial configuration procedure of the PtP link setup between InfiLINK XG units is described in the section "Commisioning of InfiLINK XG"  - "InfiLINK XG - Technical User Manual"

"xginfo" command

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" command arguments description is given in the table below

CommandDescription
xginfo stat [-verbose] [-clear] [-1]
  • Displays the link statistics:
    • "-verbose" - the system displays in-depth physical layer link statistics
    • "-clear" - reset statistics data
    • "-1" -  the system displays a single snapshot of statistics data
xginfo capabilities [-verbose]
  • Displays the radio system capabilities
xginfo version
  • Displays the current firmware version
Table - "xginfo" arguments description

Figure - "xginfo stat" command output example

Figure - "xginfo capabilities" command output example

Figure - "xginfo version" command output example

"xgutils" command

Syntax:

#1> xgutils [arguments]

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

   xgutils dfs -list

"xgutils" command arguments 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
  • Displays a list of available frequencies and information on them (noise level, radar availability, selected frequency)
Table - "xgutils" arguments description

Figure - "xgutils ber-amc-show" command output example

Figure - "xgutils dfs -list" command output example
  • No labels