Login
- Table of Contents
-
- 14-WLAN Command Reference (Fat AP)
- 00-Preface
- 01-Compatibility of hardware and AP functionality
- 02-Radio management commands
- 03-Band navigation commands
- 04-WLAN access commands
- 05-WLAN security commands
- 06-WLAN authentication commands
- 07-WLAN QoS commands
- 09-Cloud connection commands
- 09-WLAN multicast optimization commands
- 10-WLAN load balancing commands
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 02-Radio management commands | 141.95 KB |
Contents
Radio management commands
The term "AP" in this document refers to MSR routers that offer WLAN services as fat APs. For more information, see "Compatibility of hardware and AP functionality."
a-mpdu
Use a-mpdu enable to enable the A-MPDU aggregation method.
Use a-mpdu disable to disable the A-MPDU aggregation method.
Use undo a-mpdu to restore the default.
Syntax
a-mpdu { disable | enable }
undo a-mpdu
Default
The A-MPDU aggregation method is enabled.
Radio interface view
Predefined user roles
network-admin
Usage guidelines
This command is applicable only to 802.11n, 802.11ac, and 802.11gac radios. Changing the radio mode to 802.11a, 802.11b, or 802.11g invalidates the command.
Examples
# Disable the A-MPDU aggregation method.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] type dot11an
[Sysname-WLAN-Radio0/0] a-mpdu disable
a-msdu
Use a-msdu enable to enable the A-MSDU aggregation method.
Use a-msdu disable to disable the A-MSDU aggregation method.
Use undo a-msdu to restore the default.
Syntax
a-msdu { disable | enable }
undo a-msdu
Default
The A-MSDU aggregation method is enabled.
Views
Radio interface view
Predefined user roles
network-admin
Usage guidelines
This command is applicable only to 802.11n and 802.11ac radios. Changing the radio mode to 802.11a, 802.11b, or 802.11g invalidates the command.
The device can receive but cannot send A-MSDUs.
Examples
# Disable the A-MSDU aggregation method.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] type dot11an
[Sysname-WLAN-Radio0/0] a-msdu disable
ani
Use ani enable to enable Adaptive Noise Immunity (ANI).
Use ani disable to disable ANI.
Use undo ani to restore the default.
Syntax
ani { disable | enable }
undo ani
Default
ANI is enabled.
Views
Radio interface view
Predefined user roles
network-admin
Usage guidelines
ANI enables the device to adjust the anti-noise level based on the environment to reduce interference from the surrounding environment.
Examples
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] ani enable
antenna type
Use antenna type to set the antenna type for an AP.
Use undo antenna type to restore the default.
Syntax
antenna type antenna-type
undo antenna type
Default
The antenna type is internal.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
antenna-type: Specifies an antenna type, a string of 1 to 10 characters. Antenna types supported by an AP vary by AP model.
Usage guidelines
Perform this task to set the antenna type for an AP. The antenna type setting for an AP must be consistent with the type of the antenna used on the AP.
To ensure that the Effective Isotropic Radiated Power (EIRP) is within the correct range, the antenna gain automatically changes after you set the antenna type.
Examples
# Set the antenna type to internal.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] type dot11an
[Sysname-WLAN-Radio0/0] antenna type internal
beacon-interval
Use beacon-interval to set the beacon interval.
Use undo beacon-interval to restore the default.
Syntax
beacon-interval interval
undo beacon-interval
Default
The beacon interval is 100 TUs.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
interval: Specifies the beacon interval in the range of 32 to 8191 TUs.
Examples
# Set the beacon interval to 1000 TUs.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] beacon-interval 1000
channel
Use channel to specify a working channel for a radio interface.
Use undo channel to restore the default.
Syntax
channel { channel-number | auto }
undo channel
Default
The AP automatically selects a working channel for a radio interface.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
channel-number: Specifies a channel by its number. The value range for this argument varies by country code and radio mode.
auto: Configures the AP to automatically select a channel.
Usage guidelines
When radar signals are detected on the working channel of a radio, the AP changes its channel, and switches back to the specified channel after 30 minutes. Then the AP starts the quiet timer. If no radar signals are detected within the quiet time, the AP starts to use the channel. If radar signals are detected within the quiet time, the AP changes its channel.
Examples
# Specify channel 6 as the working channel.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] channel 6
channel band-width
Use channel band-width to set the bandwidth mode.
Use undo channel band-width to restore the default.
Syntax
channel band-width { 20 | 40 [ auto-switch ] | 80 | { 160 | dual-80 } [ secondary-channel channel-number ] }
undo channel band-width
Default
The bandwidth mode is 80 MHz for 802.11ac radios, 20MHz for 802.11gac radios, 40 MHz for 802.11an radios, and 20 MHz for 802.11gn radios.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
20: Sets the bandwidth mode to 20 MHz.
40: Sets the bandwidth mode to 40 MHz.
80: Sets the bandwidth mode to 80 MHz.
auto-switch: Allows a radio to switch its bandwidth mode between 20 MHz and 40 MHz. This keyword is applicable only to 802.11gn and 802.11gac radios.
160: Sets the bandwidth mode to 160 MHz. Support for this keyword depends on the AP model.
dual-80: Sets the bandwidth mode to 80+80 MHz. Support for this keyword depends on the AP model.
secondary-channel channel-number: Specifies the secondary channel for the 160 MHz or 80+80 MHz bandwidth mode. Support for this option depends on the AP model.
Usage guidelines
This command is applicable only to 802.11n, 802.11ac, and 802.11gac radios. When you change the mode of a radio, the default setting of this command for the new radio mode is restored.
The radio uses the specified 40/80/160 MHz bandwidth if adjacent channels can be bound to form a 40/80/160 channel. If adjacent channels cannot form a 40/80/160 channel, the radio uses the next available bandwidth less than the specified one.
For example, the bandwidth mode is set to 80 MHz. The radio uses the 80 MHz bandwidth if adjacent channels that can be bound together exist. If adjacent channels that can be bound to an 80 MHz channel do not exist, but two adjacent channels that can be bound to a 40 MHz channel exist, the 40 MHz bandwidth is used. If no adjacent channels that can be bound together exist, the radio uses the 20 MHz bandwidth.
When the bandwidth mode is set to 80+80 MHz, the radio uses the 160 MHz bandwidth if two adjacent 80 MHz channels that can be bound together exist. If a 160 MHz channel cannot be formed but two non-adjacent 80 MHz channels are available, the radio uses the two 80 MHz channels to achieve the 160 MHz bandwidth.
If the working channel is specified, you can specify the secondary 80 MHz channel for the 160 MHz or 80+80 MHz bandwidth mode. If no working channel is specified, the device automatically selects a secondary channel. The working channel forwards all packets and the secondary channel forwards only data packets.
Examples
# Set the bandwidth mode to 40 MHz.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] channel band-width 40
channel
channel-usage measure
Use channel-usage measure to perform on-demand channel usage measurement.
Syntax
channel-usage measure
Views
Radio interface view
Predefined user roles
network-admin
Usage guidelines
This feature enables an AP to scan supported channels and display the channel usage after measurement. The measurement of each channel takes about one second.
Examples
# Perform on-demand channel usage measurement on radio interface 2.
<Sysname> system-view
[Sysname] interface WLAN-Radio 0/0
[Sysname-WLAN-Radio0/0] channel-usage measure
Please wait..............Done.
Channel Usage
1 23%
2 34%
3 26%
4 36%
5 42%
6 39%
7 27%
8 45%
9 29%
10 38%
11 46%
12 30%
13 33%
client dot11b-forbidden
Use client dot11b-forbidden enable to disable access services for 802.11b clients.
Use client dot11b-forbidden disable to enable access services for 802.11b clients.
Use undo client dot11b-forbidden to restore the default.
Syntax
client dot11b-forbidden { disable | enable }
undo client dot11b-forbidden
Default
Access services for 802.11b clients are enabled.
Views
Radio interface view
Predefined user roles
network-admin
Usage guidelines
Enabling an 802.11g, 802.11gac, or 802.11gn radio to reject 802.11b clients reduces the impact of low-speed 802.11b clients and speeds up wireless data transmission.
Examples
# Configure WLAN-radio 1/0/2 to reject 802.11b clients.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] client dot11b-forbidden enable
client dot11n-only
Use client dot11n-only enable to enable the client dot11n-only feature.
Use client dot11n-only disable to disable the client dot11n-only feature.
Use undo client dot11n-only to restore the default.
Syntax
client dot11n-only { disable | enable }
undo client dot11n-only
Default
The client dot11n-only feature is disabled.
Views
Radio interface view
Predefined user roles
network-admin
Usage guidelines
This command is applicable only to 802.11n, 802.11ac, and 802.11gac radios. Changing the radio mode to 802.11a, 802.11b, or 802.11g invalidates the command.
After you configure this command on a radio, the radio accepts only the 802.11n and 802.11ac clients, and all 802.11a/b/g clients that are associated with the radio are logged off.
Examples
# Enable the client dot11n-only feature.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] client dot11n-only enable
client max-count
Use client max-count to set the maximum number of clients that can associate with an AP.
Use undo client max-count to restore the default.
Syntax
client max-count max-number
undo client max-count
Default
No limit is set for the number of clients that can associate with an AP.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
max-number: Specifies the maximum number of clients that can associate with an AP. The value range depends on the AP model.
Usage guidelines
When the maximum number of clients is reached on an AP, the AP stops accepting new clients.
Examples
# Set the maximum number of clients that can associate with an AP to 38.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] client max-count 38
continuous-mode
Use continuous-mode to enable the continuous mode for a radio.
Use undo continuous-mode to restore the default.
Syntax
continuous-mode { mcs mcs-index | nss nss-index vht-mcs vhtmcs-index | rate rate-value }
undo continuous-mode
Default
The continuous mode is disabled.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
mcs mcs-index: Specifies the MCS index in the range of 0 to 76.
nss nss-index vht-mcs vhtmcs-index: Specifies the VHT-MCS index. The value ranges for the nss-index and vhtmcs-index arguments are 1 to 8 and 0 to 9, respectively.
rate rate-value: Specifies the transmit rate in Mbps.
Usage guidelines
This feature is used for network testing only. Do not use it under any other circumstances.
It enables continuous data packet sending at the specified rate. When the feature is enabled, do not perform any other operations except changing the transmit rate.
For an 802.11a, 802.11b, or 802.11g radio, set the transmit rate. For an 802.11n radio, set the transmit rate or MCS index. For an 802.11ac or 802.11gac radio, set the transmit rate, MCS index, or VHT-MCS index.
Examples
# Enable the continuous mode and set the transmit rate to 6 Mbps.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] continuous-mode rate 6
Related commands
display wlan ap continuous-mode
custom-antenna gain
Use custom-antenna gain to set the antenna gain.
Use undo custom-antenna gain to restore the default.
Syntax
custom-antenna gain antenna-gain
undo custom-antenna gain
Default
The antenna gain is 0 dBi.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
antenna-gain: Specifies the antenna gain in the range of 0 to 20 dBi.
Usage guidelines
This command is applicable only when an AP uses a third-party antenna.
Effective Isotropic Radiated Power (EIRP) is the actual transmit power of an antenna, and it is the sum of the antenna gain and the maximum transmit power of the radio. If the configured antenna gain causes the EIRP to exceed the threshold, the antenna gain configuration fails.
Make sure the antenna gain setting is the same as the gain of the antenna used on the AP.
Changing the radio mode automatically changes the antenna gain.
Examples
# Set the antenna gain to 2 dBi.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] type dot11an
[Sysname-WLAN-Radio0/0] custom-antenna gain 2
distance
Use distance to set the maximum transmission distance.
Use undo distance to restore the default.
Syntax
distance distance
undo distance
Default
The maximum transmission distance is 1 km (0.62 miles).
Views
Radio interface view
Predefined user roles
network-admin
Parameters
distance: Specifies the maximum transmission distance in the range of 1 to 40 km (0.62 to 24.86 miles).
Examples
# Set the maximum transmission distance to 5 km (3.11 miles).
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] type dot11g
[Sysname-WLAN-Radio0/0] distance 5
dot11g protection
Use dot11g protection enable to enable 802.11g protection.
Use dot11g protection disable to disable 802.11g protection.
Use undo dot11g protection to restore the default.
Syntax
dot11g protection { disable | enable }
undo dot11g protection
Default
802.11g protection is disabled.
Views
Radio interface view
Predefined user roles
network-admin
Usage guidelines
This command is applicable only to 802.11g, 802.11n (2.4 GHz), and 802.11gac radios. If you change the mode of a radio to a mode other than the three modes, 802.11g protection configuration is removed.
802.11g, 802.11n, 802.11gac devices send RTS/CTS or CTS-to-self packets before sending data only when 802.11b signals are detected on the channel.
802.11g protection automatically takes effect when 802.11b clients associate with an 802.11g, 802.11n (2.4 GHz), or 802.11gac radio.
Examples
# Enable 802.11g protection.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] dot11g protection enable
Related commands
protection-mode
dot11n mandatory maximum-mcs
Use dot11n mandatory maximum-mcs to set the maximum mandatory MCS index.
Use undo dot11n mandatory maximum-mcs to restore the default.
Syntax
dot11n mandatory maximum-mcs index
undo dot11n mandatory maximum-mcs
Default
No maximum mandatory MCS index is set.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
index: Specifies the maximum mandatory MCS index in the range of 0 to 76.
Usage guidelines
This command is applicable only to 802.11n, 802.11ac, and 802.11gac radios. Changing the radio mode to 802.11a, 802.11b, or 802.11g invalidates the command.
Before configuring the dot11n multicast-mcs command, you must set the maximum mandatory MCS index.
After you modify the maximum mandatory MCS index, clients that are associated with the radio and that do not support the modified MCS index will go offline.
Examples
# Set the maximum mandatory MCS index to 14.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] dot11n mandatory maximum-mcs 14
dot11n multicast-mcs
Use dot11n multicast-mcs to set the multicast MCS index.
Use undo dot11n multicast-mcs to restore the default.
Syntax
dot11n multicast-mcs index
undo dot11n multicast-mcs
Default
No multicast MCS index is set.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
index: Specifies the multicast MCS index in the range of 0 to 76.
Usage guidelines
This command is applicable only to 802.11n, 802.11ac, and 802.11gac radios. Changing the radio mode to 802.11a, 802.11b, or 802.11g invalidates the command.
The multicast MCS index takes effect only when the radio associates only with 802.11n and 802.11ac clients.
If 802.11a/b/g clients exist, the AP and clients use the 802.11a/b/g multicast rate to multicast packets.
The multicast MCS index maps to a rate in 20 MHz bandwidth mode regardless of whether the bandwidth mode is 20 MHz or 40 MHz.
Examples
# Set the multicast MCS index to 14.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] dot11n mandatory maximum-mcs 15
[Sysname-WLAN-Radio0/0] dot11n multicast-mcs 14
dot11n protection
Use dot11n protection enable to enable 802.11n protection.
Use dot11n protection disable to disable 802.11n protection.
Use undo dot11n protection to restore the default.
Syntax
dot11n protection { disable | enable }
undo dot11n protection
Default
802.11n protection is disabled.
Views
Radio interface view
Predefined user roles
network-admin
Usage guidelines
This command is applicable only to 802.11n, 802.11ac, and 802.11gac radios. If you change the mode of a radio to a mode other than the three modes, the 802.11n protection configuration is removed.
802.11n, 802.11ac, and 802.11gac devices send RTS/CTS or CTS-to-self packets before sending data only when 802.11a/b/g signals are detected on the channel.
802.11n protection automatically takes effect when 802.11a/b/g clients associate with an 802.11n, 802.11ac, or 802.11gac radio.
Examples
# Enable 802.11n protection.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] dot11n protection enable
Related commands
protection-mode
dot11n support maximum-mcs
Use dot11n support maximum-mcs to set the maximum supported MCS index.
Use undo dot11n support maximum-mcs to restore the default.
Syntax
dot11n support maximum-mcs index
undo dot11n support maximum-mcs
Default
The maximum supported MCS index is 76.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
index: Specifies the maximum supported MCS index in the range of 0 to 76.
Usage guidelines
This command is applicable only to 802.11n, 802.11ac, and 802.11gac radios. Changing the radio mode to 802.11a, 802.11b, or 802.11g invalidates the command.
The maximum supported MCS index cannot be smaller than the maximum mandatory MCS index.
Examples
# Set the maximum supported MCS index to 14.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] dot11n support maximum-mcs 14
dtim
Use dtim to set the Delivery Traffic Indication Map (DTIM) interval.
Use undo dtim to restore the default.
Syntax
dtim counter
undo dtim
Default
The DTIM interval is 1. The AP sends buffered broadcast and multicast frames after every beacon frame.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
counter: Specifies the DTIM interval in the range of 1 to 31.
Usage guidelines
An AP periodically broadcasts a beacon compliant with the DTIM. After the AP broadcasts the beacon, it sends buffered broadcast and multicast frames based on the value of the DTIM interval. For example, if you set the DTIM interval to 5, the AP sends buffered broadcast and multicast frames every five beacon frames.
Examples
# Set the DTIM interval to 5.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] dtim 5
fragment-threshold
Use fragment-threshold to set the frame fragmentation threshold.
Use undo fragment-threshold to restore the default.
Syntax
fragment-threshold size
undo fragment-threshold
Default
The fragmentation threshold is 2346 bytes.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
size: Specifies the fragmentation threshold in the range of 256 to 2346 bytes. The value for this argument must be an even number.
Usage guidelines
Frames larger than the fragmentation threshold are fragmented before transmission. Frames smaller than the fragmentation threshold are transmitted without fragmentation.
In a WLAN with great interference, decrease the fragmentation threshold and set the MTU (ip mtu command) of packets sent over the radio to be lower than the fragmentation threshold. This improves the network throughput and efficiency.
Examples
# Set the fragmentation threshold to 2048 bytes.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] fragment-threshold 2048
green-energy-management
Use green-energy-management enable to enable the energy-saving feature.
Use green-energy-management disable to disable the energy-saving feature.
Use undo green-energy-management to restore the default.
Syntax
green-energy-management { disable | enable }
undo green-energy-management
Default
The energy saving feature is disabled.
Views
Radio interface view
Predefined user roles
network-admin
Usage guidelines
This command is applicable only to 802.11n, 802.11ac, and 802.11gac radios. Changing the radio mode to 802.11a, 802.11b, or 802.11g invalidates the command.
After you enable the energy-saving feature, the multiple-input and multiple-output (MIMO) mode of a radio automatically changes to 1x1 if no clients associate with the radio. This reduces power consumption.
Examples
# Enable the energy-saving feature.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] green-energy-management enable
ldpc
Use ldpc enable to enable LDPC.
Use ldpc disable to disable LDPC.
Use undo ldpc to restore the default.
Syntax
ldpc { disable | enable }
undo ldpc
Default
LDPC is disabled.
Views
Radio interface view
Predefined user roles
network-admin
Usage guidelines
This command is applicable only to 802.11n, 802.11ac, and 802.11gac radios. Changing the radio mode to 802.11a, 802.11b, or 802.11g invalidates the command.
The device can receive but cannot send LDPC packets.
Examples
# Disable LDPC.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] type dot11an
[Sysname-WLAN-Radio0/0] ldpc disable
long-retry threshold
Use long-retry threshold to set the hardware retransmission limit for large frames.
Use undo long-retry threshold to restore the default.
Syntax
long-retry threshold count
undo long-retry threshold
Default
The hardware retransmission limit is 4 for large frames.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
count: Specifies the hardware retransmission limit for large frames, in the range of 1 to 15.
Usage guidelines
Perform this task to set the hardware retransmission limit for frames larger than the RTS threshold.
Examples
# Set the hardware retransmission limit to 5 for large frames.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] long-retry threshold 5
Related commands
protection-threshold
short-retry threshold
max-power
Use max-power to set the maximum transmit power.
Use undo max-power to restore the default.
Syntax
max-power radio-power
undo max-power
Default
The AP uses the maximum supported transmit power.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
radio-power: Specifies the maximum transmit power.
Usage guidelines
The transmit power range supported by a radio varies by country code, channel, AP model, radio mode, antenna type, and bandwidth mode. If you change these attributes for a radio after you set the maximum transmit power, the configured maximum transmit power might be out of the supported transmit power range. If this happens, the system automatically adjusts the maximum transmit power to a valid value.
If you enable power lock, the locked power becomes the maximum transmit power.
Examples
# Set the maximum transmit power to 15 dBm.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] type dot11g
[Sysname-WLAN-Radio0/0] max-power 15
preamble
Use preamble to set the preamble type.
Use undo preamble to restore the default.
Syntax
preamble { long | short }
undo preamble
Default
The short preamble is used.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
long: Specifies a long preamble. A long preamble ensures compatibility with all wireless devices that use an earlier standard than 802.11n.
short: Specifies a short preamble. A short preamble can improve network performance.
Usage guidelines
This command is applicable only to 802.11b, 802.11g, and 802.11gn radios.
A preamble is a set of bits in a packet header to synchronize transmission signals between sender and receiver.
Examples
# Set the preamble type to long.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] type dot11g
[Sysname-WLAN-Radio0/0] preamble long
protection-mode
Use protection-mode to specify a collision avoidance mode.
Use undo protection-mode to restore the default.
Syntax
protection-mode { cts-to-self | rts-cts }
undo protection-mode
Default
The CTS-to-self mode is used.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
cts-to-self: Specifies the CTS-to-self mode.
rts-cts: Specifies the RTS/CTS mode.
Usage guidelines
You can specify either of the following collision avoidance modes for an AP:
· RTS/CTS—An AP sends an RTS packet to a client before sending data to the client. After receiving the RTS packet, the client sends a CTS packet to the AP. The AP begins to send data after receiving the CTS packet, and other devices that detect the RTS or CTS packet do not send data within a specific time period.
· CTS-to-self—An AP sends a CTS packet with its own MAC address as the destination MAC address before sending data to a client. After receiving the CTS-to-self packet, the AP begins to send data, and other devices that detect the CTS-to-self packet do not send data within a specific time period.
Examples
# Specify the RTS/CTS mode.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] protection-mode rts-cts
Related commands
dot11g protection
dot11n protection
protection-threshold
protection-threshold
Use protection-threshold to set the RTS threshold.
Use undo protection-threshold to restore the default.
Syntax
protection-threshold size
undo protection-threshold
Default
The RTS threshold is 2346 bytes.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
size: Specifies the RTS threshold in the range of 0 to 2346 bytes.
Usage guidelines
The system performs collision avoidance only for packets larger than the RTS threshold.
Examples
# Set the RTS threshold to 2048 bytes.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] protection-threshold 2048
Related commands
protection-mode
rate
Use rate to set the transmission rates for a radio.
Use undo rate to restore the default.
Syntax
rate { multicast { auto | rate-value } | { disabled | mandatory | supported } rate-value }
undo rate
Default
In radio interface view:
· 802.11a/802.11an/802.11ac:
¡ Prohibited rates—None.
¡ Mandatory rates—6, 12, and 24.
¡ Multicast rate—Selected from the mandatory rates.
¡ Supported rates—9, 18, 36, 48, and 54.
· 802.11b:
¡ Prohibited rates—None.
¡ Mandatory rates—1 and 2.
¡ Multicast rate—Selected from the mandatory rates.
¡ Supported rates—5.5 and 11.
· 802.11g/802.11gn/802.11gac:
¡ Prohibited rates—None.
¡ Mandatory rates—1, 2, 5.5, and 11.
¡ Multicast rate—Selected from the mandatory rates.
¡ Supported rates—6, 9, 12, 18, 24, 36, 48, and 54.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
disabled: Specifies rates that cannot be used by an AP.
mandatory: Specifies rates that the clients must support to associate with an AP.
multicast: Specifies the rate at which an AP multicasts packets. The multicast rate must be selected from the mandatory rates.
supported: Specifies rates that an AP supports. After a client associates with an AP, the client can select a higher or lower rate from the supported rates to communicate with the AP.
auto: Automatically selects a mandatory rate as the multicast rate.
rate-value: Specifies the rate value in Mbps. You can set multiple rates and separate them by spaces. The available values for this argument are as follows:
· 802.11a/802.11an/802.11ac—6, 9, 12, 18, 24, 36, 48, and 54.
· 802.11b—1, 2, 5.5, and 11.
· 802.11g/802.11gn/802.11gac—1, 2, 5.5, 6, 9, 11, 12, 18, 24, 36, 48, and 54.
Usage guidelines
The mandatory rates and multicast rate cannot be null. When there is only one mandatory rate, you cannot specify the mandatory rate as a supported rate or prohibited rate.
Examples
# Set the mandatory rates to 6 Mbps, 12 Mbps, and 24 Mbps.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] type dot11g
[Sysname-WLAN-Radio0/0] rate mandatory 6 12 24
short-gi
Use short-gi enable to enable short Guard Interval (GI).
Use short-gi disable to disable short GI.
Use undo short-gi to restore the default.
Syntax
short-gi { disable | enable }
undo short-gi
Default
Short GI is enabled.
Views
Radio interface view
Predefined user roles
network-admin
Usage guidelines
This command is applicable only to 802.11n, 802.11ac, and 802.11gac radios. Changing the radio mode to 802.11a, 802.11b, or 802.11g invalidates the command.
Examples
# Disable short GI.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] short-gi disable
short-retry threshold
Use short-retry threshold to set the hardware retransmission limit for small frames.
Use undo short-retry threshold to restore the default.
Syntax
short-retry threshold count
undo short-retry threshold
Default
The hardware retransmission limit is 7 for small frames.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
count: Specifies the hardware retransmission limit for small frames, in the range of 1 to 15.
Usage guidelines
Perform this task to set the hardware retransmission limit for frames smaller than or equal to the RTS threshold.
Examples
# Set the hardware retransmission limit to 10 for small frames.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] short-retry threshold 10
Related commands
long-retry threshold
protection-threshold
stbc
Use stbc enable to enable Space-Time Block Coding (STBC).
Use stbc disable to disable STBC.
Use undo stbc to restore the default.
Syntax
stbc { disable | enable }
undo stbc
Default
STBC is enabled.
Views
Radio interface view
Predefined user roles
network-admin
Usage guidelines
This command is applicable only to 802.11n, 802.11ac, 802.11gac radios. Changing the radio mode to 802.11a, 802.11b, or 802.11g invalidates the command.
Examples
# Enable STBC.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] stbc enable
type
Use type to specify a radio mode.
Use undo type to restore the default.
Syntax
type { dot11a | dot11ac | dot11an | dot11b | dot11g | dot11gac | dot11gn }
undo type
Default
The default setting varies by AP model.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
dot11a: Specifies the 802.11a radio mode.
dot11ac: Specifies the 802.11ac radio mode.
dot11an: Specifies the 802.11n (5 GHz) radio mode.
dot11b: Specifies the 802.11b radio mode.
dot11g: Specifies the 802.11g radio mode.
dot11gac: Specifies the 802.11gac radio mode.
dot11gn: Specifies the 802.11n (2.4 GHz) radio mode.
Usage guidelines
|
|
CAUTION: Modifying the mode of an enabled radio logs off all associated clients. |
Examples
# Set the radio mode to 802.11n (5 GHz).
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] type dot11an
wlan error-frame optimization
Use wlan error-frame optimization to set the index for optimizing the error packet ratio.
Use undo wlan error-frame optimization to restore the default.
Syntax
wlan error-frame optimization value
undo wlan error-frame optimization
Default
The index for optimizing the error packet ratio is not specified.
Views
System view
Predefined user roles
network-admin
Parameters
value: Specifies the index for optimizing the error packet ratio, in the range of 0 to 1000. The smaller the index is, the smaller the recalculated ratio will be.
Usage guidelines
The error packet ratio is the number of received error data packets divided by the total number of received data packets.
This command enables the device to recalculate the error packet ratio by using the specified index to get a smaller radio value.
Examples
# Set the index for optimizing the error packet ratio to 100.
<Sysname> system-view
[Sysname] wlan error-frame optimization 100
wlan retransmit-frame optimization
Use wlan retransmit-frame optimization to set the index for optimizing the retransmission ratio.
Use undo wlan retransmit-frame optimization to restore the default.
Syntax
wlan retransmit-frame optimization value
undo wlan retransmit-frame optimization
Default
The index for optimizing the retransmission ratio is not set.
Views
System view
Default user roles
network-admin
Parameters
value: Specifies the index for optimizing the retransmission ratio, in the range of 0 to 100. The smaller the index is, the smaller the recalculated ratio will be.
Usage guidelines
The retransmission ratio is the number of retransmitted data packets divided by the total number of transmitted data packets.
This command enables the device to recalculate the retransmission ratio by using the specified index to get a smaller ratio value.
Examples
# Set the index for optimizing the retransmission ratio to 100.
<Sysname> system-view
[Sysname] wlan retransmit-frame optimization 100
