Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Hide_comments

Scroll Ignore

Table of Contents

Description

The command is used to configure a radio module.

Syntax:

rf interface parameters...

Interface rf5.0 parameters:

  • "band   XXX" - bandwidth (MHz) - {double (40)|full (20)|half (10)|quarter (5)}
  • "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
  • "cap" - RF capabilities
  • "dist   XXX" - distance in kilometers or auto
  • "txrt   XXX" - max transmit retries [15]
  • "txvrt  XXX" - max transmit retries in voice mode [5]
  • "[-]burst" - burst mode
  • "[-]shortgi" - short guard interval mode
  • "noise  XXX" - Noise floor threshold, dB [20]
  • "[-]pwrctl" - automatic TPC mode
  • "[-]wocd"
  • "[modulation OFDM | CCK]"
  • "[chntime XXX]"
  • "[statistics]"
  • "[-]bcsid".
Warning
titleCAUTION

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

Sets parameters of a radio module specified by the if-name (name of the radio interface) parameter, or displays them if executed without any optional parameter. Optional parameters are as follows:

  • "band XXX" - this option allows choosing the bandwidth for transmission (in MHz). Double means 40MHz, Full - 20MHz, half – 10MHz, quarter – 5MHz. Units in one PtP or PtMP connection must have the same bandwidth.

Example,

Code Block
languagejava
themeDJango
rf rf5.0 band half
  • "grid B G" - this option allows creating a customized frequency grid within the license restrictions. The frequency grid for every band is formed in the form of a list of sub ranges with the defined frequency step (start frequency–end frequency/step), or a list of comma delimited standalone frequencies.

Syntax:

IFNAME grid BAND FREQUENCY_RANGE_LIST

Example,

...

languagejava
themeDJango

...

interface. This section describes the command in WANFleX software version with Polling technology support.

Warning
titleCAUTION

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:

Code Block
languagetext
themeEmacs
usage: rf interface parameters...
Interface rf5.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
 dist XXX: distance in kilometers or auto
 txrt XXX: max transmit retries [15]
 txvrt XXX: max transmit retries in voice mode [6]
 [-]burst : burst mode (Super Packeting)
 [-]shortgi: short guard interval mode
 noise XXX: Noise floor threshold, dB [26]
 [-]pwrctl : automatic TPC mode
 mimo|miso
 [-]misoctl
 [-]greenfield
Note
titleNOTE

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

Parameters

Center
ParameterDescription
capDisplays the radio module capabilities including the information on power levels, frequencies etc.
band XXX

Allows choosing the bandwidth for transmission, can be specified as numeric or text values:

  • "double" – 40 MHz.
  • "full" – 20 MHz.
  • "half" – 10 MHz.
  • "quarter" – 5 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

...

To remove a frequency grid:

Code Block
languagejava
themeDJango
rf IFNAME grid BAND clear

...

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 XXXThe bit transfer rate

...

in Kbit/s

...

of the radio link. Allowed values are:

    ...

    • bandwidth 5 MHz: 3250, 6500, 9750, 13000, 19500, 26000, 29250, 32500 Kbit/s

    ...

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

    ...

    The maximum bitrate is limited by the specific model.

    If the router is configured as a BS and autobitrate mode is turned on, this parameter will specify the maximum transmitting speed for the BS.

    ...

    txpwr XXXSets the transmitter emitting power in dBm, maximal if ATPC is on, and fixed if off. The acceptable transmit power values can vary depending on the radio module type

    ...

    .

    ...


    ...

    sid XXX

    ...

    Network system 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.

    ...


    dist XXX

    Distance value between two devices (in kilometers). This parameter changes time values for some delays and time-outs thus making possible to work on longer distances with smooth adjustment.

    ...

    There are several ways to manage this parameter:

    • To set an exact value (in kilometers)
    • Use automatic distance calculation (by default). In this case the unit will calculate and set the link distance automatically. In the configuration an automatically calculated value is displayed after the auto parameter: auto (XX).

    Auto mode is recommended!

    If the distance parameter is set to 0 radio module will use default settings.

    • "txrt XXX" - this parameter sets the maximum number of repeat requests (transmit retries) to be done when sending unicast packets. 15 by default
    • "txvrt XXX" - this parameter sets the maximum number of repeat requests for data packets (excluding voice packets) in voice mode. 5 by default. The maximum allowed value is 64. Voice mode is turned on automatically when VoIP traffic appears
    • "burst" - enables the BURST protocol. “-burst” disables the BURST protocol support. Enabled by default.

    The BURST protocol consists in grouping several short packets with the same destination address on a radio link into larger packets, thus cardinally decreasing the response time for applications generating streams of short packets. Burst enabling relates to a radio interface as a whole, and means only that you want to use this mode in this 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 enabling does not induce any changes in the work of other devices in the network. The BURST protocol reaches its maximal efficiency on high throughput point-to-point "backbone" links.

    Some statistics about BURST protocol operation can be viewed by using the "muf stat" command.

    • "shortgi" - enables the short guard interval mode. Using short guard interval 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.

    To disable type “-shortgi”. Enabled by default.

    • "noise XXX" - sets Noise Floor Threshold for radio interface. Measured in decibel. By default Noise Floor Threshold is 20 dB. Noise Floor Threshold is defined as a positive shift relative to the current level of noise which is measured by a device. The unit begins data transmission only when there are no signals in the air that have signal level higher than Noise Floor Threshold. See Noise Floor and Noise floor Threshold values with “rf IFNAME stat” command
    • "pwrctl" - enables Automatic Transmit Power Control (ATPC) on the per-packet basis. When it is enabled (“rf rf5.0 txpwr <power> pwrctl”) 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. Transmit power adjustment is estimated for each sending packet. The upper bound of output power values that can be set by ATPC is limited by the power value specified in “txpwr” parameter.
    • -pwrctl” disables ATPC. Enabled by default.
    • "wocd" - disables carrier sense on the radio interface when sending data packets. May only be used on a base station working in WMA (Wireless Marker Access) mode. Reduces the number of retransmitted packets, thus increasing effective throughput of a multipoint radio link. "-wocd" re-enables the standard mechanism of permanent carrier sense. Initial setting is "-wocd" (carrier sense enabled)
    • "modulation" - sets the modulation technique for the radio. For 5-6GHz radios OFDM mode is always turned on. For 2.4GHz radios both cck and ofdm modes are available:
      • cck
      • ofdm
    • "chntime" - Channel Burst Time. The time for the unit to occupy the radio channel. By default – 0 (dynamic, is not displayed in the configuration). Set in microseconds. Recommended value for PtP links – 5000 (20 MHz channel width)
    • "statistics" - displays the radio module's statistics with 1 second update interval.

    Below tables show "rfconfig stat" command output for 5GHz and 2.4GHz devices:

    Center
    Scroll Title
    titleTable - "rf stat" command output
    ParameterDescription
    "rf stat" output for 5GHz devices description
    Broadcast rate Current bitrate value for Broadcast and Multicast packets on the BS; depends upon the speed of the slowest CPE 
    Voice Mode ON/OFF value. If turned ON, the mode of their prioritized processing is turned on 
    Bytes ReceivedNumber of received bytes including headers 
    Bytes Transmitted Number of transmitted bytes including headers 
    Packets Received OK Number of correctly received packets 
    Packets Transmitted OK Number of correctly transmitted packets 
    Duplicate Received Number of duplicate packets received due to protocol excesses 
    Total Retries Total number of retries 
    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 
    Noise Floor Threshold Noise Floor Threshold for Carrier Detect
    Replay dropsNumber of packet drops in an aggregate due to the packet sequence errors
    Aggr Subframe RetriesNumber of packet drops in an aggregate due to protocol excesses (for transmission)
    Aggr Full RetriesNumber of duplicate aggregates transmitted
    Max aggr framesMaximal detected number of packets in an aggregate
    Max aggr bytesMaximal detected bytes in an aggregate
    "rf stat" command output for 2.4GHz devices
    Beacons Received Number of received service packets (not used) 
    Beacons Transmitted Number of transmitted service packets (not used) 
    Ack Packets Transmitted Number of transmitted acknowledgement packets 
    RTS Packets Transmitted Number of RTS packets transmitted 
    CTS Packets Transmitted Number of CTS packets transmitted 
    PLCP CRC Errors CRC errors counter 
    Single Collisions Single collisions counter 
    PLCP Format Errors PLCP format errors number 
    Polling cache aged Expired cache lifetime packets number 
    PLCP Length Errors PLCP length errors number 
    No Deferral Non-deferred packets number 
    MAC CRC Errors CRC check errors number 
    Deferred Protocol Protocol deferred packets number 
    Partial Received Number of partially received packets 
    Deferred Energy Detect Number of deferred packets due to media unavailability 
    SSID Mismatches Number of SSID mismatches (useless in our case) 
    Retry Long Number of retries for the packets which exceeded RTC threshold 
    AP Mismatches Access Point mismatches (useless in our case) 
    Retry Short Number of retries for the packets which were lower than RTC threshold 
    Data Rate Mismatches Data rate mismatches number 
    Authentication Rejects Authentication rejects number 
    Ack Received Number of received acknowledgements for packets transmitting 
    Authentication T/O Number of authentication timeouts 
    No Ack Received Number of not acknowledged packets when transmitting 
    Association Rejects Association rejects number 
    CTS Received Number of received CTS packets 
    Association T/O Number of association timeouts 
    No CTS Received Number of not received CTS packets 
    Packets Aged Number of expired lifetime packets after receiving 
    • "bcsid" -  enables SID broadcasting (in beacon service packets which are regularly sent by the radio module). This feature is a potential weak place in the security because it lets the device to reply to subscriber's cards requests having no SID value (ANY). Though MINT protocol exclude the possibility of unauthorized network connection, such device's behavior leads to its unstable work, failures and communication link delays
    • -bcsid” disables SID broadcasting. Disabled by default.

    Examples,

    Code Block
    languagejava
    themeDJango
    rfconfig rf5.0 sid 1 bitr 130000 freq 2427 burst rfconfig rf5.0 bitr 300000 freq 5280 sid 01020304 burst rfconfig rf5.0 txpwr 18 pwrctl

    The "dist" parameter is only applied when sending network packets, therefore, it must be set on each network device.

    • "auto" enables automatic distance calculation.

    The "0" value sets the default radio module settings.

    txrt XXXSets the maximum number of repeat requests to be done when sending unicast packets. By default is 15.
    txvrt XXXSets the maximum number of repeat requests for data packets (excluding voice packets) in voice mode. By default is 6. The maximum allowed value is 64. Voice mode is turned on automatically when VoIP traffic appears.
    [-]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.

    [-]shortgiEnables/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.
    noise XXXSets Noise Floor Threshold for radio interface. Measured in decibel, by default is 20. Threshold is defined as a positive shift relative to the current level of noise which is measured by a device. The unit begins data transmission only when there are no signals in the air that have signal level higher than Noise Floor Threshold. To display Noise Floor and Noise floor Threshold values use the "stat" parameter.
    [-]pwrctlEnables/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.
    mimo|misoAllows to select a signal coding method: MIMO or MISO.
    [-]misoctlIn 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.
    [-]greenfieldEnables/disables "Greenfield" mode. This mode reduces the transmitted frame size, removing the original (pre-802.11n) field from the header. Allows to increase the performance by 15%, as well as avoid the processing and decoding of noise preambles, which leads to an improvement of signal quality.
    statDisplays the radio module's statistic. For more information about table values see "Examples" subsection.

    Examples

    Displays the radio module's parameters.

    Code Block
    languagetext
    themeEmacs
    rfconfig cap
       Radio capabilities:
       Adapter name:                        Atheros AR9220 Wireless PCI Adapter. InfiNet Wireless RMM63 6.2 GHz Radio
       Subvendor: 0xfff1, Subid 0x6300
       Power levels (dBm):                  min 0 max 23 step 0.5
       (per packet power control supported)
       Greenfield mode supported
       MAC address:                         000435230A20
       Bandwidth modes:                     28, 7, 14, 30, 15, 5, 10, 20, 40

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

    Code Block
    languagetext
    themeEmacs
    rf rf5.0 grid 40 4920-5940/5
    rf rf5.0 grid 20 5310-5390/10,5450,5500-5580/20
    rf rf5.0 grid 10 5480, 5500, 5520, 5540, 5560, 5580

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

    Code Block
    languagetext
    themeEmacs
    mint rf5.0 profile 1 -band 20
    rf band 20

    Display the current radio module's statistic.

    Code Block
    languagetext
    themeEmacs
    rf stat
    RF rf5.0 status UP (band 20, freq 6200)  :ACTIVE
    DFS  status     DFSONLY (mode STA)
    
    +--------------------------------------+--------------------------------------+
    |          Receive statistics          |         Transmit  statistics         |
    +--------------------------------------+--------------------------------------+
    | Broadcast Rate           104000      | Voice Mode                OFF        |
    | Bytes Received           3338045     | Bytes Transmitted         2650312    |
    | Packets Received OK      57173       | Packets Transmitted OK    55005      |
    | Load (kbps)              1442        | Load (kbps)               172        |
    | Load (pps)               257         | Load (pps)                187        |
    | Frame size (bytes)       701         | Frame size (bytes)        114        |
    +--------------------------------------+--------------------------------------+
    | RX Medium Load           0.8%        | TX Medium Load            0.6%       |
    | Total Medium Busy        1.6%        |                                      |
    +--------------------------------------+--------------------------------------+
    | Duplicate Received       0           | Total Retries             705        |
    | Aggr duplicates          0           | Aggr Subframe Retries     0          |
    | Aggr drops               0           | Aggr Full Retries         210        |
    | FIFO Overrun             0           | FIFO Underrun             0          |
    | CRC Errors               6           | Excessive Retries         47         |
    | Noise Floor              -89         | Max aggr frames           3          |
    | Noise Floor Threshold    -63         | Max aggr bytes            740        |
    | Scrambled frames         0           | Scrambled frames          0          |
    | Scramble errors          0           | Tx queue overflow         0          |
    +--------------------------------------+--------------------------------------+
    
    • "RF rf5.0 status UP (band 20, freq 4900) :ACTIVE" – interface status, bandwidth, frequency, state.
    • "DFS status OFF" – DFS status.
    • "Broadcast Rate" – current bitrate value for Broadcast and Multicast packets on the BS sector (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.
    • "Packets Received OK" – number of correctly received frames.
    • "Packets Transmitted OK" – number of correctly transmitted 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 (%).
    • "Medium Busy" – time during which the medium was occupied (reception or transmission) (%).
    • "Duplicate Received" – number of duplicate packets received.
    • "Total Retries" – total number of retries.
    • "Aggr Subframe Retries" – number of packet drops in an aggregate due to protocol excesses (for transmission).
    • "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.
    • "Noise Floor Threshold" – noise threshold level for RF interface.
    • "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.