- 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 |
---|---|---|
07-WLAN QoS commands | 87.76 KB |
WLAN QoS 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."
cac policy
Use cac policy to configure a Connect Admission Control (CAC) policy.
Use undo cac policy to restore the default.
Syntax
cac policy { channelutilization [ channelutilization-value ] | client [ client-number ] }
undo cac policy
Default
The client-based admission policy is used, and the maximum number of admitted clients is 20.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
channelutilization: Specifies the channel usage-based admission policy.
channelutilization-value: Specifies the maximum channel usage in percentage, in the range of 0 to 100. The maximum channel usage refers to the medium time of the accepted AC-VO and AC-VI traffic to the valid time within a certain time. The valid time refers to the time available for transmitting and receiving data. By default, the maximum channel usage is 65%.
client: Specifies the client-based admission policy.
client-number: Specifies the maximum number of clients allowed to be connected, in the range of 0 to 124. A client is counted as one client if it is using both the AC-VO and AC-VI queues.
Usage guidelines
The CAC policy takes effect only on the AC-VO and the AC-VI queues.
Examples
# Configure the channel usage-based admission policy for CAC, and set the maximum channel usage to 70%.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] cac policy channelutilization 70
display wlan wmm
Use display wlan wmm to display WMM statistics.
Syntax
display wlan wmm { client [ interface wlan-radio interface-number | mac-address mac-address ] | radio [ interface wlan-radio interface-number ] }
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
client: Displays WMM statistics for clients. If you use this keyword without the interface wlan-radio interface-number or mac-address mac-address option, this command displays WMM statistics for all clients.
radio: Displays WMM statistics for radios. If you use this keyword without the interface wlan-radio interface-number option, this command displays WMM statistics for all radios.
mac-address mac-address: Specifies a client by its MAC address in the H-H-H format.
interface wlan-radio interface-number: Specifies a radio interface by its number.
Examples
# Display WMM statistics for all radios.
<Sysname> display wlan wmm radio
Radio : 1
Client EDCA updates : 0
QoS mode : WMM
WMM status: Enabled
Radio max AIFSN : 15 Radio max ECWmin : 10
Radio max TXOPLimit : 32767 Radio max ECWmax : 10
CAC information
Clients accepted : 0
Voice : 0
Video : 0
Total request medium time(µs) : 0
Voice(µs) : 0
Video(µs) : 0
Calls rejected due to insufficient resources : 0
Calls rejected due to invalid parameters : 0
Calls rejected due to invalid medium time : 0
Calls rejected due to invalid delay bound : 0
Radio : 2
Client EDCA updates : 0
QoS mode : WMM
WMM status: Disabled
Radio max AIFSN : 15 Radio max ECWmin : 10
Radio max TXOPLimit : 32767 Radio max ECWmax : 10
CAC information
Client accepted : 0
Voice : 0
Video : 0
Total request medium time(µs) : 0
Voice(µs) : 0
Video(µs) : 0
Calls rejected due to insufficient resources : 0
Calls rejected due to invalid parameters : 0
Calls rejected due to invalid medium time : 0
Calls rejected due to invalid delay bound : 0
Table 1 Command output
Field |
Description |
Client EDCA updates |
Times that client EDCA parameters have been updated. |
QoS mode |
WMM. If this field displays N/A, the QoS mode is not available. |
WMM status |
· Enabled. · Disabled. |
Radio max AIFSN |
Maximum AIFSN that the radio supports. |
Radio max ECWmin |
Maximum ECWmin that the radio supports. |
Radio max TXOPLimit |
Maximum TXOPLimit that the radio supports. |
Radio max ECWmax |
Maximum ECWmax that the radio supports. |
Total request medium time |
Total request medium time for AC-VO and AC-VI queues, in microseconds. |
# Display WMM statistics for all clients.
<Sysname> display wlan wmm client
MAC address : 000f-e23c-0001 SSID : service
QoS mode : WMM
APSD information :
Max SP length : 7
L: Legacy T: Trigger D: Delivery
AC AC-BK AC-BE AC-VI AC-VO
Assoc State T|D L T|D T|D
Statistics information :
Uplink packets : 0 Downlink packets : 0
Uplink bytes : 0 Downlink bytes : 0
Downgrade packets : 0 Discarded packets : 0
Downgrade bytes : 0 Discarded bytes : 0
TS information:
AC : AC-VO User priority : 7
TID : 1 Direction : Bidirectional
PSB : 0 Surplus bandwidth allowance : 1.0000
Medium time (µs) : 39 MSDU size (bytes) : 1500
Mean data rate (Kbps) : 10.000 Minimum PHY rate (Mbps) : 11.000
TS creation time : 0h:0m:5s
TS updating time : 0h:0m:5s
Uplink TS packets : 0 Downlink TS packets : 0
Uplink TS bytes : 0 Downlink TS bytes : 0
Table 2 Command output
Field |
Description |
QoS mode |
WMM. If this field displays N/A, the QoS mode is not available. |
Max SP length |
Maximum service period (SP) length. |
AC |
· AC-VO. · AC-VI. · AC-BE. · AC-BK. |
Assoc state |
APSD attribute for an AC queue: · T—The AC queue is trigger-enabled. · D—The AC queue is delivery-enabled. · T | D—The AC queue is both trigger-enabled and delivery-enabled. · L—The AC queue is of legacy attributes. |
User priority |
User priority for packets from wired networks. |
TID |
Traffic identifier, in the range of 0 to 15. |
Direction |
Traffic direction: · Uplink. · Downlink. · Bidirectional. |
PSB |
Power save behavior: · 1—U-APSD power saving mode. · 0—Traditional power saving mode. |
Surplus bandwidth allowance |
Surplus bandwidth allowance in percentage. |
Medium time |
Permitted medium time in microseconds. |
MSDU size |
Average MSDU size in bytes. |
Mean data rate |
Average data transmission rate in Kbps. |
Minimum PHY rate |
Minimum physical transmission rate in Mbps. |
Related commands
reset wlan wmm
edca client (ac-be and ac-bk)
Use edca client to set EDCA parameters of AC-BE or AC-BK queues for clients.
Use undo edca client to restore the default.
Syntax
edca client { ac-be | ac-bk } { aifsn aifsn-value | ecw ecwmin ecwmin-value ecwmax ecwmax-value | txoplimit txoplimit-value } *
undo edca client { ac-be | ac-bk }
Default
The default EDCA parameter values of AC-BE or AC-BK queues for clients are shown in Table 3.
Table 3 Default EDCA parameter values of AC-BE or AC-BK queues for clients
AC |
AIFSN |
ECWmin |
ECWmax |
TXOP Limit |
AC-BK |
7 |
4 |
10 |
0 |
AC-BE |
3 |
4 |
10 |
0 |
Views
Radio interface view
Predefined user roles
network-admin
Parameters
ac-be: Specifies the AC-BE (best-effort traffic) queue.
ac-bk: Specifies the AC-BK (background traffic) queue.
aifsn aifsn-value: Specifies the arbitration inter-frame spacing number (AIFSN), in the range of 1 to 15.
ecwmin ecwmin-value: Specifies the exponent form of CWmin (ECWmin), in the range of 0 to 15.
ecwmax ecwmax-value: Specifies the exponent form of CWmax (ECWmax), in the range of 0 to 15. The value of ECWmax cannot be smaller than the value of ECWmin.
txoplimit txoplimit-value: Specifies the transmission opportunity limit (TXOP Limit) value, in the range of 0 to 65535 (in units of 32 microseconds). If the value is 0, a client can send only one packet each time it holds the channel.
Usage guidelines
As a best practice, set the TXOP Limit value to 0 for both the AC-BE and AC-BK queues if all the clients are 802.11b clients.
As a best practice, use the default TXOPLimit values for both the AC-BK and AC-BE queues if both 802.11b and 802.11g clients exist in the WLAN.
Examples
# Set the AIFSN to 5 for the AC-BE queue.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] edca client ac-be aifsn 5
edca client (ac-vi and ac-vo)
Use edca client to set EDCA parameters of AC-VI or AC-VO queues for clients.
Use undo edca client to restore the default.
Syntax
edca client { ac-vi | ac-vo } { aifsn aifsn-value | cac { disable | enable } | ecw ecwmin ecwmin-value ecwmax ecwmax-value | txoplimit txoplimit-value } *
undo edca client { ac-vi | ac-vo }
Default
The default EDCA parameter values of AC-VI or AC-VO queues for clients are shown in Table 4.
Table 4 Default EDCA parameter values of AC-VI or AC-VO queues for clients
AC |
AIFSN |
ECWmin |
ECWmax |
TXOP Limit |
AC-VI |
2 |
3 |
4 |
94 |
AC-VO |
2 |
2 |
3 |
47 |
Views
Radio interface view
Predefined user roles
network-admin
Parameters
ac-vi: Specifies the AC-VI (video traffic) queue.
ac-vo: Specifies the AC-VO (voice traffic) queue.
aifsn aifsn-value: Specifies the arbitration inter-frame spacing number (AIFSN), in the range of 1 to 15.
cac: Specifies CAC. The AC-VO and AC-VI queues support CAC. CAC is disabled by default.
disable: Disables CAC.
enable: Enables CAC.
ecwmin ecwmin-value: Specifies the exponent form of CWmin (ECWmin), in the range of 0 to 15.
ecwmax ecwmax-value: Specifies the exponent form of CWmax (ECWmax), in the range of 0 to 15. The value of ECWmax cannot be smaller than the value of ECWmin.
txoplimit txoplimit-value: Specifies the transmission opportunity limit (TXOP Limit) value, in the range of 0 to 65535 (in units of 32 microseconds). If the value is 0, a client can send only one packet each time it holds the channel.
Usage guidelines
As a best practice, set the TXOPLimit value to 188 and 102 for the AC-VI and AC-VO queues, respectively when all the clients are 802.11b clients.
As a best practice, use the default TXOPLimit values for both the AC-VI and AC-VO queues if both 802.11b and 802.11g clients exist in the WLAN.
Examples
# Set the AIFSN to 3 for the AC-VO queue.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] edca client ac-vo aifsn 3
edca radio
Use edca radio to set EDCA parameters.
Use undo edca radio to restore the default.
Syntax
edca radio { ac-be | ac-bk | ac-vi | ac-vo } { ack-policy { noack | normalack } | aifsn aifsn-value | ecw ecwmin ecwmin-value ecwmax ecwmax-value | noack | txoplimit txoplimit-value } *
undo edca radio { ac-be | ac-bk | ac-vi | ac-vo }
Default
The default EDCA parameter values are shown in Table 5.
Table 5 Default EDCA parameter values
AC |
AIFSN |
ECWmin |
ECWmax |
TXOP Limit |
AC-BK |
7 |
4 |
10 |
0 |
AC-BE |
3 |
4 |
6 |
0 |
AC-VI |
1 |
3 |
4 |
94 |
AC-VO |
1 |
2 |
3 |
47 |
Views
Radio interface view
Predefined user roles
network-admin
Parameters
ac-be: Specifies the AC-BE (best-effort traffic) queue.
ac-bk: Specifies the AC-BK (background traffic) queue.
ac-vi: Specifies the AC-VI (video traffic) queue.
ac-vo: Specifies the AC-VO (voice traffic) queue.
ack-policy: Specifies the ACK policy for the AC queue.
noack: Specifies the No ACK policy.
normalack: Specifies the Normal ACK policy (the default).
aifsn aifsn-value: Specifies the arbitration inter-frame spacing number (AIFSN), in the range of 1 to 15.
ecwmin ecwmin-value: Specifies the exponent form of CWmin (ECWmin) in the range of 0 to 10.
ecwmax ecwmax-value: Specifies the exponent form of CWmax (ECWmax) in the range of 0 to 10. The value of ECWmax cannot be smaller than the value of ECWmin.
txoplimit txoplimit-value: Specifies the transmission opportunity limit (TXOP Limit) value in units of 32 microseconds. The value range is 0 to 32767. If the value is 0, a client can send only one packet each time it holds the channel.
Examples
# Set the AIFSN of the AC-VO queue to 2 in radio view of radio 2.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] edca radio ac-vo aifsn 2
qos priority
Use qos priority to set the port priority.
Use undo qos priority to restore the default.
Syntax
qos priority priority
Default
The port priority is 0.
Views
Service template view
Predefined user roles
Parameters
priority: Specifies the port priority in the range of 0 to 7. A larger value represents a higher priority.
Usage guidelines
When the port trust mode is enabled, an AP assigns the port priority to all packets for the service template.
This command does not take effect when the packet trust mode is enabled.
Examples
# Set the port priority to 2 for service template 1.
[Sysname] wlan service-template 1
[Sysname-wlan-st-1] qos priority 2
Related commands
qos trust
Use qos trust to configure the trusted packet priority type.
Use undo qos trust to restore the default.
Syntax
qos trust { dot11e | dscp }
Default
The port priority is trusted.
Views
Service template view
Predefined user roles
Parameters
dot11e: Uses the 802.1e priority carried in packets for priority mapping.
dscp: Uses the DSCP priority carried in packets for priority mapping.
Usage guidelines
This feature takes effect only on uplink packets.
Examples
# Configure service template 1 to use the 802.1e priority carried in packets for priority mapping.
[Sysname] wlan service-template 1
[Sysname-wlan-st-1] qos trust dot11e
Related commands
reset wlan wmm
Use reset wlan wmm to clear WMM statistics.
Syntax
reset wlan wmm { client [ interface wlan-radio interface-number | mac-address mac-address ] | radio [ interface wlan-radio interface-number ] }
Views
User view
Predefined user roles
network-admin
Parameters
client: Clears WMM statistics for clients. If you use this keyword without the interface wlan-radio interface-number or mac-address mac-address option, this command clears WMM statistics for all clients.
radio: Clears WMM statistics for radios. If you use this keyword without the interface wlan-radio interface-number option, this command clears WMM statistics for all radios.
mac-address mac-address: Specifies a client by its MAC address in the H-H-H format.
interface wlan-radio interface-number: Specifies a radio interface by its number.
Examples
# Clear WMM statistics for all radios.
<Sysname> reset wlan wmm radio
Related commands
display wlan wmm
svp map-ac
Use svp map-ac to map SVP packets to the specified AC queue.
Use svp map-ac disable to disable SVP mapping.
Use undo svp map-ac to restore the default.
Syntax
svp map-ac { ac-vi | ac-vo }
svp map-ac disable
undo svp map-ac
Default
SVP mapping is disabled.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
ac-vi: Specifies the AC-VI (video traffic) queue.
ac-vo: Specifies the AC-VO (voice traffic) queue.
Usage guidelines
SVP mapping takes effect only on non-WMM clients.
Examples
# Map SVP packets to the AC-VO queue.
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] svp map-ac ac-vo
wmm
Use wmm enable to enable WMM.
Use wmm disable to disable WMM.
Use undo wmm to restore the default.
Syntax
wmm { disable | enable }
undo wmm
Default
WMM is enabled.
Views
Radio interface view
Predefined user roles
network-admin
Usage guidelines
All 802.11n and 802.11ac clients must support WLAN QoS. For 802.11n or 802.11ac clients to communicate with the associated AP, enable WMM when the radio operates in 802.11an, 802.11gn, or 802.11ac mode.
Examples
<Sysname> system-view
[Sysname] interface wlan-radio 0/0
[Sysname-WLAN-Radio0/0] wmm disable