Include Page | ||||
---|---|---|---|---|
|
Hide_comments |
---|
Scroll Ignore | |
---|---|
|
Command description
IFC RADIO command
ifc radio
Use this command to enable or disable radio the system radio interface of the system.
Syntax:
#1> ifc radio {up | down}
...
xg
Use this command to review and update set the air link parameters.
Syntax:
#1> xg [arguments]
Code Block | ||||
---|---|---|---|---|
| ||||
#1> xg usage: xg -typeconfig {master | slave} Radio frame params relatedxg config -peer-exported xg -tdd-sync-src {freerun | gnss}config -defaults xg -dlquota {1..99/1} xg -sframelen {1 | 2 | 5 | 10}[-grids-carrier-ix=<carrier-ix>] [-grids-band=<channel-width>] -grids {<freq_start>[-<freq_end>[/<step>]]}[,...] xg [-max-distance {0..120000/1} grids-carrier-ix=<carrier-ix>] [-grids-band=<channel-width>] -grids= General settings xg -cell-idtype {0..15/1} Radio front end relatedmaster, slave} xg -tdd-sync-src {freerun, gnss} xg -freqautosync-link-dlsettings {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}no, no-co-sa-no-reboot, no-reboot, reboot-remote-if-needed} Link shared settings (Radio Front End) xg -txpwrcell-id {0..2715/1} xg -channel-width {10, | 20, | 40} Modulation related (channel-width 10): xg -amcfreq-strategydl {normal | conservative | aggressive} 6005..6415/50} (channel-width 20): xg -maxfreq-mcsdl {16010..106410/120} DFS/RSSI scan/Radar detection Ethernet datapath related (channel-width 40): xg -qosfreq-strategydl {normal | conservative | aggressive | off} Supplementary alias: 6020..6400/50} (channel-width 10): xg -freq <val> => xg -freq-dl <val>-ul {6005..6415/50} (channel-width 20): xg -freq-ul <val> {6010..6410/20} (channel-width 40): xg -appendconf-v2-startfreq-ul {6020..6400/50} xg -appendconfshort-v2cp <encoded web config>{0, 1} xg -appendconf-v2-endfreg-auto {0, 1} Link shared settings (Frame Config) xg [-grids-carrier-ix=<grids-carrier-ix>] [-grids-band=<grids-band>] -grids {<freq_start>[-<freq_end>[/<step>]],...max-distance {1..100/1} xg -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} xg stat [-phy] [-1]RF per-station settings xg stat -clear txpwr {0..27/1} xg capabilities xg config-ctrl-block-boost {0, 1} xg config -self -atpc-master-enable {0, 1} xg config -peer-exported-atpc-target-rssi {-70..-40/1} 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:
Code Block | ||||
---|---|---|---|---|
| ||||
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.
Warning | ||
---|---|---|
| ||
GNSS option is effective for Master unit only. |
Warning | ||
---|---|---|
| ||
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) |
Possibility of the frequency re-use depends on the antenna types, placement, direction, link distances, etc.
Warning | ||
---|---|---|
| ||
Please note that the following settings must be equal for the co-located units:
|
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:
Code Block | ||||
---|---|---|---|---|
| ||||
xg -dlquota 70 |
In order to set air frame period in milliseconds, use the command:
- xg -sframelen {1, 2, 5, 10}
Example:
Code Block | ||||
---|---|---|---|---|
| ||||
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:
Code Block | ||||
---|---|---|---|---|
| ||||
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:
Code Block | ||||
---|---|---|---|---|
| ||||
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:
Code Block | ||||
---|---|---|---|---|
| ||||
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:
Code Block | ||||
---|---|---|---|---|
| ||||
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:
Code Block | ||||
---|---|---|---|---|
| ||||
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=
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 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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
Code Block | ||||
---|---|---|---|---|
| ||||
#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
Code Block | ||||
---|---|---|---|---|
| ||||
#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:
Code Block | ||||
---|---|---|---|---|
| ||||
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.
- 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.
Warning | ||
---|---|---|
| ||
Please note that the following settings must be equal on the both sides of the link:
Otherwise, the units will not link up. |
Note | ||
---|---|---|
| ||
In order to synchronize the settings of the units, copy from one unit and paste to another one the Peer exported config lines shown in the "xg" command outputs. See the configuration example below. |
Configuration example
Code Block | ||||
---|---|---|---|---|
| ||||
#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.
Note | ||
---|---|---|
| ||
If Absolute RSSI value goes above -40 dBm, decrease Tx power of the remote unit in order to keep it within -40..-50 dBm for performance maximization. |
- Step 4
Optimize link performance
- Adjust Maximal link distance parameter based on the measured distance.
Note | ||
---|---|---|
| ||
Check measured link distance, using xg stat outputs and adjust xg –max-distance settings by adding 200-300 m to the measured value. |
- 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.
Note | ||
---|---|---|
| ||
Acceptable error rate Acc TBER depends on the application. See examples in Table 1 below. |
Center | |||||||||
---|---|---|---|---|---|---|---|---|---|
|
- Select the most appropriate air frame period.
Note | ||
---|---|---|
| ||
The system supports frame period values ranging from 1 to 10 ms. |
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.
|
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 | ||||
---|---|---|---|---|
| ||||
#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 | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
xgutils
Syntax:
#1> xgutils [arguments]
Code Block | ||||
---|---|---|---|---|
| ||||
#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 | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
xgdfs
Syntax:
#1> xgdfs [arguments]
Code Block | ||||
---|---|---|---|---|
| ||||
#1> xgdfs
usage:
xgdfs -list [-clear]
xgdfs -stat [-clear] |
"xgdfs" commands and options description is given in the table below
Center | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|