⁣⁣rfconfig command

Description

CAUTION

Not all radio interfaces have the same set of parameters and options because it depends on the radio module type and standard. A complete list of parameters available for the specific interface can be displayed by "rf interface ?" command. Radio module type and its features list can be displayed by "rf interface cap" command.

Syntax:

usage: rf interface parameters...
Interface rf6.0 parameters:
   band   XXX:  bandwidth (MHz)
   grid   B G:  frequency grid - <bw> freq1[-freq2[/step]],... | clear
   freq   XXX:  central frequency (MHz)
   bitr   XXX:  bitrate (Kbps)
   txpwr  XXX:  tx power (dBm)
   sid    XXX:  system identifier - up to 8 hex digits [10101010]
   cap [full]:  RF capabilities
   txrt   XXX:  max transmit retries [10]
   txvrt  XXX:  max transmit retries in voice mode [5]
   [-]dpd       : dpd mode (digital pre-distortion)
   [-]burst  :  burst mode (Super Packeting)
   [-]shortgi:  short guard interval mode
   [-]pwrctl :  automatic TPC mode
   [-]transient : transient mode
   mimo|miso
   [-]misoctl
   stat[1] [qos] [mcs] [OPT]

NOTE

If frequency roaming is enabled, make changes to the roaming profile using "mint profile" command before making changes on the unit.

Parameters

Parameter
Description

cap

Displays the radio module capabilities including the information on power levels, frequencies etc.

band XXX

Allows choosing the bandwidth for transmission, can be specified as numerics:

  • 80 MHz.

  • 40 MHz.

  • 20 MHz.

  • 10 MHz.

The ability to switch between different bandwidth values is determined by the license. Within the same wireless network, devices must have the same values for this parameter.

grid B G

Allows to create a customized frequency grid within the license restrictions, i.e. to form the list of operating frequencies.

  • "B" the bandwidth for which the frequency grid is formed.

  • "G" – list of sub ranges with the defined frequency step (start frequency–end frequency/step), or a list of comma delimited standalone frequencies.

The resulting frequency grid can be viewed in radio interface properties and used in all cases when the frequency is determined automatically ("roaming", "dfs" and so on).

  • "clear" – restores the default frequency grid supplied in the unit’s license.

freq XXX

Sets central operating frequency in MHz. Must be equal at the both sides of the link.

bitr XXX

The bit transfer rate in Kbit/s of the radio link. Allowed values are:

  • bandwidth 10 MHz: 6500, 13000, 19500, 26000, 39000, 52000, 58500, 65000 Kbit/s.

  • bandwidth 20 MHz: 13000, 26000, 39000, 52000, 78000, 104000, 117000, 130000 Kbit/s.

  • bandwidth 40 MHz: 30000, 60000, 90000, 120000, 180000, 240000, 270000, 300000 Kbit/s.

  • bandwidth 80 MHz: 65000, 130000, 195000, 260000, 390000, 520000, 585000, 650000, 780000, 866700

txpwr XXX

Sets the transmitter emitting power in dBm. The acceptable transmit power values can vary depending on the radio module type.

sid XXX

Network identifier, a arbitrary hexadecimal number in the range of 1H to FFFFFFH. All routers that are supposed to see each other on the same radio link must have the same identifier.

txrt XXX

Sets the maximum number of repeat requests to be done when sending unicast packets. By default is 10.

txvrt XXX

Sets the maximum number of repeat requests for data packets (excluding voice packets) in voice mode. By default is 5. The maximum allowed value is 64. Voice mode is turned on automatically when VoIP traffic appears.

[-]dpd

Enables/disables digital pre-distortion mode. Allows to improve the signal quality by compensating of distortions that occur in the transmission path.

[-]burst

Enables/disables the BURST protocol support.

The BURST protocol is grouping several short packets with the same destination address on a radio link into larger packets, thus significantly decreases the response time for applications when intensive streams of short packets appears. BURST has influence to a whole radio interface on selected device, but the BURST protocol can only work for destinations where it is also enabled at the other end, and only if MINT protocol is used at both sides. BURST does not affect the operation of other devices in the network.

BURST protocol operation statistic can be viewed by using the "muffer stat" command. Enabled by default.

[-]shortgi

Enables/disables the short guard interval mode. Using of this mode allows the device to increase its throughput by reducing the time interval between symbols being transmitted. However, this may significantly increase the intersymbol interference and, thus, cause a higher errors rate. Enabled by default.

extnoise X

Raises / lowers the noise level, allows to reduce the interference influence (in case of level increasement) or to increase the received signa the modulation (in case of level decreasement). Available values are from -16 to 32 dB. By default - 0.

[-]pwrctl

Enables/disables Automatic Transmit Power Control (ATPC). When it is enabled the system automatically adjusts device’s output power to the optimal value that is necessary and sufficient to maintain the maximum productivity of the link in the given conditions. Enabled by default.

[-]transient

Enables/disables the compatibility mode with previous generation devices.

To ensure operation in compatibility mode, configuration changes must be made in accordance to configuration of previous generation device.

mimo|miso

Allows to select a signal coding method: MIMO or MISO.

[-]misoctl

In this mode the device use MISO for transmission of service packets while working on a low modulation. It allows keep the link operation when a transmitter in one the polarizations fails or in case of signal levels imbalance in different streams. To disable this mode use the "-misoctl" parameter.

stat[1] [qos] [mcs]

Displays the radio module's statistic. For more information about table values see "Examples" subsection.

  • "1" – shows statistic in current moment, if not specified, the statistic is displayed in real time.

  • "qos" – shows priorities statistic.

  • "mcs" – shows modulation statistic.

  • "OPT" – shows statistic of all parameters.

Examples

Displays the radio module's parameters.

Evo_Slave1#console>rf cap
Radio capabilities:
        Model name:                     ASTRAWIRELESS H22-57-03
        Adapter name:                   Atheros QCA9898 802.11ac Wireless Adapter
        Power levels (dBm):             min -5 max 25 step 0.5
        MAC address:                    A02252153574
        Bandwidth modes:                10, 20, 40, 80
        Frequency bounds:               5470-5725

        Bitrate list (20 MHz):          14400, 28900, 43300, 57800, 86700,
                                        115600, 130000, 144400, 173300
        Frequency grid (user defined):  4800-6060/10
        Frequency list (26 channels):   5470, 5480, 5490, 5500, 5510, 5520,
                                        5530, 5540, 5550, 5560, 5570, 5580,
                                        5590, 5600, 5610, 5620, 5630, 5640,
                                        5650, 5660, 5670, 5680, 5690, 5700,
                                        5710, 5720

Possible ways of how to set frequency grid are shown in the following example:

rf rf6.0 grid 40 4920-5940/5
rf rf6.0 grid 20 5310-5390/10,5450,5500-5580/20
rf rf6.0 grid 10 5480, 5500, 5520, 5540, 5560, 5580

Set the bandwidth value 20 on the node which use frequency roaming.

mint rf6.0 profile 1 -band 20
rf band 20

Display the current radio module's statistic.

Evo_Slave1#console>rf stat
RF status:      rf6.0 UP (band 20, freq 5470)
DFS status:     DFSONLY (mode STA)
TDMA status:    SLAVE (5 ms DL/UL:50%) (DL2500/UL2500)
+--------------------------------------+--------------------------------------+
|         Receive statistics           |         Transmit statistics          |
+--------------------------------------+--------------------------------------+
| Broadcast rate           14400       | Voice mode               OFF         |
| Bytes received           1698253756  | Bytes transmitted        1391938982  |
| Frames received OK       19574151    | Frames transmitted OK    18886225    |
| Multicast frames         791568      | Multicast frames         188757      |
+--------------------------------------+--------------------------------------+
| Load (Kbps)              3           | Load (Kbps)              2           |
| Load (pps)               4           | Load (pps)               2           |
| Frame size (bytes)       93          | Frame size (bytes)       125         |
+--------------------------------------+--------------------------------------+
| RX medium load           2.1%        | TX medium load           1.9%        |
| Total medium busy        4.0%        | Frame time used          3.8%        |
+--------------------------------------+--------------------------------------+
| Frames dropped           526         | Frames dropped           0           |
| Duplicates received      19          | Too short/long frames    0/0         |
| Lost frames              788         | Subframe retries         121         |
| Rx collision             0           | Aggr full retries        0           |
| CRC errors               2533        | Excessive retries        0           |
| Noise floor (dBm)        -101 (-1)   | Max aggr frames          3           |
| RX subslots/nodes        1/1         | Max aggr bytes           398         |
| RX cap (Mbps)            13          | TX cap (Mbps)            6           |
+--------------------------------------+--------------------------------------+
  • "RF rf6.0 status UP (band 20, freq 5470) – interface status, bandwidth, frequency.

  • TDMA status SLAVE (5 ms DL/UL:50%) (DL2500/UL2500) – TDMA status, frame size, DL/UL ratio.

  • "DFS status OFF" – DFS status.

  • "Broadcast Rate" – current bitrate value for Broadcast and Multicast packets on the BS (depends upon the speed of the slowest CPE).

  • "Voice Mode" – presence/absence of voice traffic. If some appears, mode of it's prioritized processing is turned on.

  • "Bytes Received" – number of received bytes including headers.

  • "Bytes Transmitted" – number of transmitted bytes including headers.

  • "Frames Received OK" – number of correctly received frames.

  • "Frames Transmitted OK" – number of correctly transmitted frames.

  • "Multicast Frames" – number of received multicast frames.

  • "Load (kbps)" – wireless link load (Kbit/s).

  • "Load (pps)" – wireless link load (packets/s).

  • "Frame size (bytes)" – frame size (bytes).

  • "Medium Load" – time spent to receive frames (%).

  • "Frame Time Used" – average transmitted frame fill rate (%).

  • "Medium Busy" – time during which the medium was occupied (reception or transmission) (%).

  • "Duplicate Received" – number of duplicate packets received.

  • "Aggr Subframe Retries" – number of packet drops in an aggregate due to protocol excesses (for transmission).

  • "Lost frames" – number of frames lost.

  • "Rx Collision" – number of cases when the frame transmission interrupted the receiving.

  • "Aggr Full Retries" – number of duplicate aggregates transmitted.

  • "FIFO Overrun" – number of FIFO queues overruns in the radio when receiving.

  • "FIFO Underrun" – number of FIFO queues underruns in the radio while transmitting.

  • "CRC Errors" – number of received packets with CRC errors.

  • "Excessive Retries" – number of packets which were not transmitted with maximal number of retries.

  • "Noise Floor" – input noise level. Measurement cycle –10 seconds.

  • "Max aggr frames" – maximal detected number of packets in an aggregate.

  • "Max aggr bytes" – maximal detected bytes in an aggregate.

  • "Scrambled frames" – number of received/transmitted scrambled frames.

  • "Scramble errors" – number of scramble errors.

  • "Tx queue overflow" – data queue overflow for transmittion.

  • "Rx Subslots" – subslots number for UL frame part.

  • "Rx Time Limit" – quota of useful data in microseconds for UL.

  • "Tx Time Limit" – quota of useful data in microseconds for DL.

  • "Rx Cap (Mbps)" – capacity limit for UL (Mbit/s).

  • "Tx Cap (Mbps)" – capacity limit for DL (Mbit/s).

Last updated

Astra Wireless Technology © 2024. All rights reserved. For more information about available models, sales and technical support, please proceed to https://astrawireless.net/