This command is applicable only to 802.11n, 802.11ac, 802.11gac, 802.11ax, and 802.11gax 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 1/0/1

[Sysname-WLAN-Radio1/0/1] type dot11an

[Sysname-WLAN-Radio1/0/1] 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, 802.11ac, 802.11gac, 802.11ax, and 802.11gax 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 1/0/1

[Sysname-WLAN-Radio1/0/1] type dot11an

[Sysname-WLAN-Radio1/0/1] 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

# Enable ANI.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/2

[Sysname-WLAN-Radio1/0/2] 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 | custom gain custom-gain }

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.

custom gain custom-gain: Specifies the gain of the third-party antenna, in the range of 0 to 20 dBi.

Usage guidelines

Perform this task to set the antenna type and antenna gain for an AP after you change the AP antenna.

You can perform this task to specify the antenna type of an H3C antenna or a third-party antenna.

· When an H3C antenna is used, make sure the antenna type is consistent with the actual type of the antenna used on the AP.

· When a third-party antenna is used, make sure the antenna gain is the actual gain of the third-party antenna.

If you set the gain of a third-party antenna in an AP group's radio view, make sure all APs of the same model in the AP group are configured with the same antenna gain.

Examples

# Set the antenna type to internal.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] type dot11an

[Sysname-WLAN-Radio1/0/1] 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 1/0/2

[Sysname-WLAN-Radio1/0/2] beacon-interval 1000

bss-color

Use bss-color enable to enable BSS coloring.

Use bss-color disable to disable BSS coloring.

Use undo bss-color to restore the default.

Syntax

bss-color { disable | enable }

undo bss-color

Default

BSS coloring is disabled.

Views

Radio interface view

Predefined user roles

network-admin

Usage guidelines

This command takes effect only on 802.11ax and 802.11gax radios. Changing the radio mode to 802.11a/b/g/n/ac/gac removes the configuration.

BSS coloring enables the system to assign a color to each BSS and include the color ID in data packets for clients to identify if a packet comes from the associated AP. To avoid conflicts, clients that detect an 802.11ax data packet with the same color as its associated BSS will postpone transmission.

Enabling BSS coloring in a high density environment can improve system performance and channel usage.

Examples

# Enable BSS coloring.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/2

[Sysname-WLAN-Radio1/0/2] bss-color enable

Related commands

type dot11ax

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 channel for a radio.

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 region 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 1/0/2

[Sysname-WLAN-Radio1/0/2] 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.11ax radios, 20 MHz for 802.11gax radios, 80 MHz for 802.11ac radios, 20 MHz 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.

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 MHz bandwidth if adjacent channels can be bound to form a 40/80 channel. If adjacent channels cannot form a 40/80 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.

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 1/0/1

[Sysname-WLAN-Radio1/0/1] channel band-width 40

Related commands

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 1/0/2

[Sysname-WLAN-Radio1/0/2] 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, 802.11gn, or 802.11gax 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 1/0/2

[Sysname-wlan-radio-1/0/2] 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 1/0/1

[Sysname-WLAN-Radio1/0/1] 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 1/0/2

[Sysname-WLAN-Radio1/0/2] 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 1/0/2

[Sysname-WLAN-Radio1/0/2] continuous-mode rate 6

Related commands

display wlan ap continuous-mode

display wlan radio

Use display wlan radio to display radio information.

Syntax

display wlan radio radio-id

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

radio-id: Specifies a radio by its ID.

Examples

# Display information about radio 1.

<Sysname> display wlan radio 1

Radio 1:

BSSID : 74ea-cbdf-0640

State : Up

Type : 802.11ac

Antenna type : external

Client dot11ac-only : Disabled

Client dot11n-only : Disabled

Channel band-width : 20/40/80MHz

Operating band-width : 20/40/80MHz

Secondary channel mode : SCA

Short GI for 20MHz : Supported

Short GI for 40MHz : Supported

Short GI for 80MHz : Supported

Short GI for 160MHz : Not supported

MIMO : Not Config

Green-Energy-Management : Disabled

A-MSDU : Enabled

A-MPDU : Enabled

LDPC : Not Supported

STBC : Supported

Operational VHT-MCS set:

Mandatory : Not configured

Supported : NSS1 0,1,2,3,4,5,6,7,8,9

NSS2 0,1,2,3,4,5,6,7,8,9

NSS3 0,1,2,3,4,5,7,8,9

NSS4 0,1,2,3,4,5,6,7,8,9

Multicast : Not configured

Operational HT MCS set:

Mandatory : Not configured

Supported : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9,

10, 11, 12, 13, 14, 15, 16, 17,

18, 19, 20, 21, 22, 23, 24, 25,

26, 27, 28, 29, 30, 31

Multicast : Not configured

Channel : 36

Channel usage(%) : 0

Max power : 24 dBm

Preamble type : Short

Operational rate:

Mandatory : 6, 12, 24 Mbps

Multicast : Auto

Supported : 9, 18, 36, 48, 54 Mbps

Disabled : Not configured

Distance : 1 km

ANI : Enabled

Fragmentation threshold : 2346 bytes

Beacon interval : 100 TU

Protection threshold : 2346 bytes

Long retry threshold : 4

Short retry threshold : 7

Frame aging time in cache : 2000 ms

Noise floor : -113 dBm

Protection mode : cts-to-self

MU-TxBF : Enabled

SU-TxBF : Enabled

Continuous mode : N/A

HT protection mode : No protection

Table 1 Command output

Field	Description
State	Radio state: · Up. · Down.
Type	Radio type: · 2.4GHz—802.11b, 802.11g, or 802.11n(2.4GHz). · 5GHz—802.11a, 802.11n(5GHz), or 802.11ac.
Antenna type	Antenna types supported by an AP vary by AP model.
Client dot11ac-only	· Disabled—Allows both 802.11ac and 802.11a/b/g/n clients to associate with the radio. · Enabled—Allows only 802.11ac clients to associate with the radio.
Client dot11n-only	· Disabled—Allows 802.11ac, 802.11n, and 802.11a/b/g clients to associate with the radio. · Enabled—Allows only 802.11n and 802.11ac clients to associate with the radio.
Channel band-width	Channel bandwidth: · 20MHz. · 20/40MHz. · 20/40/80MHz. · 20/40/80/160MHz. · 20/40/80/160/(80+80)MHz.
Operating band-width	Operating bandwidth of the radio.
Secondary channel mode	Secondary channel mode for 802.11n and 802.11ac radios: · SCA—Second Channel Above (SCA). The radio operates in 40 MHz bandwidth mode, and the secondary channel is above the primary channel. · SCB—Second Channel Below (SCB). The radio operates in 40 MHz bandwidth mode, and the secondary channel is below the primary channel. · SCN—The radio does not operate in 40 MHz bandwidth mode. This field is available only when the operating bandwidth is 20/40/80MHz.
Short GI for 20MHz	· Not supported. · Supported.
Short GI for 40MHz	· Not supported. · Supported.
Short GI for 80MHz	· Not supported. · Supported.
Short GI for 160MHz	· Not supported. · Supported.
MIMO	MIMO mode: · 1x1—The radio sends and receives signals through one spatial stream. · 2x2—The radio sends and receives signals through two spatial streams. · 3x3—The radio sends and receives signals through three spatial streams. · 4x4—The radio sends and receives signals through four spatial streams. · Not configured—The radio sends and receives signals through the maximum number of spatial streams supported by the radio. If this field also displays (PowerLow) after any value option to indicate low power level, the radio can send and receive signals only through one spatial stream.
Green-Energy-Management	· Disabled. · Enabled.
A-MSDU	· Disabled. · Enabled.
A-MPDU	· Disabled. · Enabled.
LDPC	· Supported. · Not Supported.
STBC	· Supported. · Not Supported.
Operational VHT-MCS set	· Supported—Supported VHT MCS set. · Mandatory—Mandatory VHT MCS set. · Multicast—Multicast VHT MCS set.
Operational HT MCS set	· Supported—Supported MCS set. · Mandatory—Mandatory MCS set. · Multicast—Multicast MCS set.
Channel	· Number<auto>—This field displays Number<auto> if the current channel is the optimal channel automatically selected by the AP. · Number—This field displays Number if the current channel is manually configured. · Number<avoid radar>—This field displays Number<avoid radar> if the current channel is automatically selected by the AP to avoid radar signals.
Max power	Maximum transmission power of the radio.
Preamble type	Preamble type: · Short. · Long.
Operational rate	· Mandatory. · Supported. · Multicast. · Disabled. · Not configured.
Distance	Maximum distance that the radio signal can reach.
ANI	· Enabled. · Disabled.
Protection threshold	Frame length threshold required for triggering the protection mechanism.
Long retry threshold	Maximum number of retransmission attempts for frames whose length exceeds the RTS threshold.
Short retry threshold	Maximum number of retransmission attempts for frames whose length is below the RTS threshold.
Protection mode	Conflict avoidance mode: · cts-to-self. · rts-cts.
MU-TxBF	· Enabled. · Disabled. Support for this field depends on the AP model.
SU-TxBF	· Enabled. · Disabled. Support for this field depends on the AP model.
Continuous mode	Continuous mode configuration: · Rate. · MCS index. · NSS index. · VHT-MCS index. · This field displays N/A if the continuous mode is not configured.
HT protection mode	802.11n protection mode: · No protection. ¡ AP-associated clients and nearby wireless devices are operating in 802.11n mode and AP-associated clients are 802.11n clients with a bandwidth of 40 MHz. ¡ AP-associated clients are 802.11n clients with a bandwidth of 20 MHz. · Non-member protection. In this mode, all AP-associated clients are 802.11n clients but some nearby wireless devices are non-802.11n clients. · 20 MHz protection. In this mode, the AP's radio has a bandwidth of 40 MHz. AP-associated clients and nearby wireless devices are operating in 802.11n mode and a minimum of one 802.11n client with a bandwidth of 20 MHz is associated with the AP's radio. · Non-HT mixed. This mode applies when none of the above mentioned modes apply.

‌

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 1/0/2

[Sysname-WLAN-Radio1/0/2] type dot11g

[Sysname-WLAN-Radio1/0/2] distance 5

dl-ofdma

Use dl-ofdma enable to enable downlink OFDMA.

Use dl-ofdma disable to disable downlink OFDMA.

Use undo dl-ofdma to restore the default.

Syntax

dl-ofdma { disable | enable }

undo dl-ofdma

Default

Downlink OFDMA is disabled.

Views

Radio interface view

Predefined user roles

network-admin

Usage guidelines

This command takes effect only on 802.11ax and 802.11gax radios. Changing the radio mode to 802.11a/b/g/n/ac/gac removes the configuration.

OFDMA can provide the following benefits if enabled in a high density environment where small data packets are transmitted:

· Concurrent transmission to multiple users.

· Improved radio usage.

· Shortened transmission latency.

· Reduced conflict backoff.

Examples

# Disable downlink OFDMA for WLAN-Radio 1/0/2.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/2

[Sysname-WLAN-Radio1/0/2] dl-ofdma enable

Related commands

type dot11ax

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), 802.11gac, and 802.11gax 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), 802.11gac, or 802.11gax radio.

Examples

# Enable 802.11g protection.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/2

[Sysname-WLAN-Radio1/0/2] 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, 802.11gac, 802.11ax, and 802.11gax 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 1/0/1

[Sysname-WLAN-Radio1/0/1] 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, 802.11gac, 802.11ax, and 802.11gax 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 1/0/1

[Sysname-WLAN-Radio1/0/1] dot11n mandatory maximum-mcs 15

[Sysname-WLAN-Radio1/0/1] 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, 802.11gac, 802.11ax, and 802.11gax 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 notify clients that 802.11n protection is started 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, 802.11gac, 802.11ax, or 802.11gax radio.

Examples

# Enable 802.11n protection.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] dot11n protection enable

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, 802.11gac, 802.11ax, and 802.11gax 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 1/0/1

[Sysname-WLAN-Radio1/0/1] 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 1/0/1

[Sysname-wlan-radio1/0/1] 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 1/0/1

[Sysname-wlan-radio1/0/1] 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, 802.11gac, 802.11ax, and 802.11gax 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 and the radio is not enabled with WIPS. This reduces power consumption.

Examples

# Enable the energy-saving feature.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] 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 enabled.

Views

Radio interface view

Predefined user roles

network-admin

Usage guidelines

This command is applicable only to 802.11n, 802.11ac, 802.11gac, 802.11ax, and 802.11gax 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.

For 802.11ax radios, LDPC is enabled by default and cannot be disabled. The ldpc disable configuration does not take effect on 802.11ax radios.

Examples

# Disable LDPC.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/1

[Sysname-wlan-radio-1/0/1] type dot11an

[Sysname-wlan-radio-1/0/1] 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 1/0/1

[Sysname-wlan-radio-1/0/1] 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 region 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 1/0/2

[Sysname-WLAN-Radio1/0/2] type dot11g

[Sysname-WLAN-Radio1/0/2] 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 1/0/2

[Sysname-WLAN-Radio1/0/2] type dot11g

[Sysname-WLAN-Radio1/0/2] 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 1/0/2

[Sysname-WLAN-Radio1/0/2] protection-mode rts-cts

Related commands

dot11g protection

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 1/0/2

[Sysname-WLAN-Radio1/0/2] protection-threshold 2048

Related commands

protection-mode

radar-detect disable

Use radar-detect disable to disable radar avoidance.

Use undo radar-detect to restore the default.

Syntax

radar-detect disable

undo radar-detect

Default

Radar avoidance is enabled.

Views

Radio interface view

Predefined user roles

network-admin

Usage guidelines

Radar avoidance enables a radio to change its working channel or keep silent when radar signals are detected on the working channel, avoiding interference on radars. After 30 minutes, the radio switches back to the previous working channel or restarts transmission. If radar signals can still be detected, the radio changes its working channel or keeps silent again.

With this feature disabled, radios continue to transmit or receive traffic on the working channels even if radar signals are detected on the channels.

Disable radar avoidance only when you perform device debugging.

Examples

# Disable radar avoidance.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/2

[Sysname-WLAN-Radio1/0/2] radar-detect disable

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/802.11ax—6, 9, 12, 18, 24, 36, 48, and 54.

· 802.11b—1, 2, 5.5, and 11.

· 802.11g/802.11gn/802.11gac/802.11gax—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 1/0/2

[Sysname-WLAN-Radio1/0/2] type dot11g

[Sysname-WLAN-Radio1/0/2] 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, 802.11gac, 802.11ax, and 802.11gax 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 1/0/1

[Sysname-WLAN-Radio1/0/1] 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 1/0/1

[Sysname-WLAN-Radio1/0/1] 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, 802.11ax, and 802.11gax 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 1/0/1

[Sysname-wlan-radio-1/0/1] stbc enable

twt negotiate

NOTE:

Support for this command varies by AP model.

Use twt negotiate enable to enable Target Wake Time (TWT) negotiation.

Use twt negotiate disable to disable TWT negotiation.

Use undo twt negotiate to restore the default.

Syntax

twt negotiate { disable | enable }

undo twt negotiate

Default

The default setting varies by AP model.

Views

Radio interface view

Predefined user roles

network-admin

Usage guidelines

TWT negotiation enables clients and APs to exchange data packets only in service periods and schedules client hibernation to reduce client power consumption and wireless resource competition.

With TWT negotiation enabled, clients send negotiation requests that carry the service period, TWT interval, and first wake time (calculated by clients) to APs. Upon receiving such a request, an AP sends a response. Then, the clients wake up as scheduled and wait for trigger frames from that AP. Upon receiving a trigger frame, clients enter a service period and start to exchange data packets with that AP. When a service period expires, clients enter hibernation mode even if data packet exchange is not finished.

A radio can provide the TWT service to a maximum of eight clients. After responding to the TWT negotiation requests of eight clients, the radio rejects the requests from the other clients.

This feature takes effect only on 802.11ax and 802.11gax radios. Changing the radio mode to a non-802.11ax or non-802.11gax mode removes the configuration.

Examples

# Enable TWT negotiation.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] type dot11ax

[Sysname-WLAN-Radio1/0/1] twt negotiate enable

Related commands

type

Use type to specify a radio mode.

Use undo type to restore the default.

Syntax

type { dot11a | dot11ac | dot11an | dot11ax | dot11b | dot11g | dot11gac | dot11gax | 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.

dot11ax: Specifies the 802.11ax radio mode.

dot11b: Specifies the 802.11b radio mode.

dot11g: Specifies the 802.11g radio mode.

dot11gac: Specifies the 802.11gac radio mode.

dot11gax: Specifies the 802.11gax 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 1/0/2

[Sysname-WLAN-Radio1/0/2] type dot11an

ul-mu-mimo

Use ul-mu-mimo enable to enable uplink MU-MIMO.

Use ul-mu-mimo disable to disable uplink MU-MIMO.

Use undo ul-mu-mimo to restore the default.

Syntax

ul-mu-mimo { disable | enable }

undo ul-mu-mimo

Default

Uplink MU-MIMO is disabled.

Views

Radio interface view

Predefined user roles

network-admin

Usage guidelines

This command takes effect only on 802.11ax and 802.11gax radios. Changing the radio mode to 802.11a/b/g/n/ac/gac removes the configuration.

Uplink MU-MIMO enables an AP to receive data packets from multiple clients concurrently. With this feature enabled, an AP sends an HE_Trig message to all associated clients to inform the transmission time, frequency, sampling clock, and power requirements. Upon receiving the message, clients send data packets to the AP as required at the same time.

This feature is applicable to scenarios that have a large number of clients and high AP bandwidth usage and transmission latency requirements.

Examples

# Disable uplink MU-MIMO.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/2

[Sysname-WLAN-Radio1/0/2] ul-mu-mimo enable

Related commands

mu-txbf

ul-ofdma

Use ul-ofdma enable to enable uplink OFDMA.

Use ul-ofdma disable to disable uplink OFDMA.

Use undo ul-ofdma to restore the default.

Syntax

ul-ofdma { disable | enable }

undo ul-ofdma

Default

Uplink OFDMA is disabled.

Views

Radio interface view

Predefined user roles

network-admin

Usage guidelines

This command takes effect only on 802.11ax and 802.11gax radios. Changing the radio mode to 802.11a/b/g/n/ac/gac removes the configuration.

OFDMA can provide the following benefits if enabled in a high density environment where small data packets are transmitted:

· Concurrent transmission to multiple users.

· Improved radio usage.

· Shortened transmission latency.

· Reduced conflict backoff.

Examples

# Disable uplink OFDMA.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/2

[Sysname-WLAN-Radio1/0/2] ul-ofdma enable

Related commands

type dot11ax

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

27-WLAN Command References(FAT AP)

channel

display wlan radio

dot11n multicast-mcs

preamble

rate

short-gi

Cloud & AI

InterConnect

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Contact Us