- Table of Contents
-
- 08-Radio Resources Management Command Reference
- 00-Preface
- 01-Radio management commands
- 02-WLAN radio load balancing commands
- 03-WLAN load balancing commands
- 04-WLAN radio resource measurement commands
- 05-Band navigation commands
- 06-WLAN RRM commands
- 07-Channel scanning commands
- 08-Spectrum management commands
- Related Documents
-
Title | Size | Download |
---|---|---|
04-WLAN radio resource measurement commands | 97.76 KB |
WLAN radio resource measurement commands
display wlan measure-report
Use display wlan measure-report to display measurement reports for clients.
Syntax
display wlan measure-report interface interface-type interface-number [ client mac-address mac-address ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface interface-type interface-number: Specifies a radio interface by its type and number.
client mac-address mac-address: Specifies a client by its MAC address. If you do not specify a client, this command displays measurement reports for all clients.
Examples
# Display measurement reports for clients associated with the specified radio interface.
<Sysname> display wlan measure-report interface wlan-radio 1/0/1
Total number of clients: 1
Client MAC address : 0aef-e760-3587
Link measurement:
Link margin : 2 dBm
RCPI : -85 dBm
RSNI : 53 dBm
Noise histogram:
Antenna ID : 3
ANPI : -56 dBm
IPI0 to IPI10 density : 5 12 16 13 8 5 5 15 17 1 3
Spectrum measurement:
Transmit power : 20 dBm
BSS : Detected
OFDM preamble : Detected
Radar : Detected
Unidentified signal : Undetected
CCA busy fraction : 60
RPI0 to RPI7 density : 3 7 11 19 15 23 15 7
Frame report entry:
BSSID : a072-2351-e253
PHY type : fhss
Average RCPI : -10 dBm
Last RSNI : 2 dBm
Last RCPI : -20 dBm
Frames : 1
Dot11BSSAverageAccessDelay group:
Average access delay : 32 ms
BestEffort average access delay : 1 ms
Background average access delay : 1 ms
Video average access delay : 1 ms
Voice average access delay : 1 ms
Clients : 32
Channel utilization rate : 11
Transmit stream:
Traffic ID : 0
Sent MSDUs : 60
Discarded MSDUs : 5
Failed MSDUs : 3
MSDUs resent multiple times : 3
Lost QoS CF-Polls : 2
Average queue delay : 2 ms
Average transmit delay : 1 ms
Bin0 range : 0 to 10 ms
Bin0 to Bin5 : 5 10 10 5 10 10
Table 1 Command output
Field |
Description |
Gap between the received RSSI and the lowest available RSSI. |
|
RCPI |
Received Channel Power Indicator. |
RSNI |
Received Signal to Noise Indicator. |
ANPI |
Average Noise Power Indicator during the measurement. |
IPI0 to IPI10 density |
Percentage of time for different IPI ranges to the total measurement period. IPIn represents an IPI range. The value for n is in the range of 1 to 10: · 0: IPI <= –92 dBm. · 1: –92 dBm < IPI <= –89 dBm. · 2: –89 dBm < IPI <= –86 dBm. · 3: –86 dBm < IPI <= –83 dBm. · 4: –83 dBm < IPI <= –80 dBm. · 5: –80 dBm < IPI <= –75 dBm · 6: –75 dBm < IPI <= –70 dBm. · 7: –70 dBm < IPI <= –65 dBm. · 8: –65 dBm < IPI <= –60 dBm. · 9: –60 dBm < IPI <= –55 dBm. · 10: –55 dBm < IPI. |
Transmit power |
Transmission power of the client. |
BSS |
Whether the client has detected wireless packets from other BSSs. |
OFDM preamble |
Whether the client has detected OFDM preambles. |
Radar |
Whether the client has detected radar signals. |
Unidentified signal |
Whether the client has detected unknown signals. |
CCA busy fraction |
CCA utilization is expressed as a percentage of time that the channel is busy (during the measurement period). |
RPI0 to RPI7 density |
Percentage of time that each RPI was used during the measurement period. RPIn represents a RPI range. The value for n is in the range of 1 to 7: · 0: RPI <= –87 dBm. · 1: –87 dBm < RPI <= –82 dBm. · 2: –82 dBm < RPI <= –77 dBm. · 3: –77 dBm < RPI <= –72 dBm. · 4: –72 dBm < RPI <= –67 dBm. · 5: –67 dBm < RPI <= –62 dBm. · 6: –62 dBm < RPI <= –57 dBm. · 7: –57 dBm < RPI. |
PHY type |
Physical media type: · fhss. · dsss. · irbaseband. · ofdm. · hrdsss. · erp. |
Frames |
Number of frames from the same MAC address and BSSID during the measurement. |
Bin0 range |
Value range for Bin0. |
Bin0 to Bin5 |
Number of successfully sent MSDUs for each average delay range. Binx represents an average delay range. The value for x is in the range of 0 to 5: · Bin0: Delay< 10 ms. · Bin1: 10 ms <= Delay < 20 ms. · Bin2: 20 ms <= Delay < 40 ms. · Bin3: 40 ms <= Delay < 80 ms. · Bin4: 80 ms <= Delay < 160 ms. · Bin5: 160 ms <= Delay. |
measure
Use measure enable to enable the specified measurement feature or all measurement features.
Use measure disable to disable the specified measurement feature or all measurement features.
Use undo measure to restore the default.
Syntax
measure { all | link | neighbor | radio | spectrum | tpc } { disable | enable }
undo measure
Default
Measurement is disabled.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
all: Specifies all measurement features.
link: Specifies link measurement. Link measurement measures RCPI, RSNI, and link redundancy for the requested link.
The following compatibility matrix shows the support of hardware platforms for the link keyword:
Hardware series |
Model |
Description |
WA7200 series |
WA7220 WA7220-HI WA7220H WA7226-C WA7230 WA7230-LI |
No |
WA7300 series |
WA7320i WA7322H-HI WA7330X WA7338-HI |
Yes |
WA7500 series |
WA7538 WA7539 |
Yes |
WA7600 series |
WA7638 |
No |
neighbor: Specifies neighbor measurement. Neighbor measurement measures the channel and BSSID of neighbor APs.
radio: Specifies radio measurement. Radio measurement measures channel load, noise histogram, beacons, frames, station statistics, locations, and transmit streams.
The following compatibility matrix shows the support of hardware platforms for the radio keyword:
Hardware series |
Model |
Description |
WA7200 series |
WA7220 WA7220-HI WA7220H WA7226-C WA7230 WA7230-LI |
No |
WA7300 series |
WA7320i WA7322H-HI WA7330X WA7338-HI |
Yes |
WA7500 series |
WA7538 WA7539 |
Yes |
WA7600 series |
WA7638 |
No |
spectrum: Specifies spectrum measurement, which includes basic measurement, Clear Channel Assessment (CCA) measurement, and Receive Power Indication (RPI) measurement.
The following compatibility matrix shows the support of hardware platforms for the spectrum keyword:
Hardware series |
Model |
Description |
WA7200 series |
WA7220 WA7220-HI WA7220H WA7226-C WA7230 WA7230-LI |
No |
WA7300 series |
WA7320i WA7322H-HI WA7330X WA7338-HI |
Yes |
WA7500 series |
WA7538 WA7539 |
Yes |
WA7600 series |
WA7638 |
No |
tpc: Specifies TPC measurement. TPC measurement measures link redundancy and transmission power for clients.
The following compatibility matrix shows the support of hardware platforms for the tpc keyword:
Hardware series |
Model |
Description |
WA7200 series |
WA7220 WA7220-HI WA7220H WA7226-C WA7230 WA7230-LI |
No |
WA7300 series |
WA7320i WA7322H-HI WA7330X WA7338-HI |
Yes |
WA7500 series |
WA7538 WA7539 |
Yes |
WA7600 series |
WA7638 |
No |
Usage guidelines
You must enable radio resource measurement if you enable link, neighbor, or radio measurement.
You must enable spectrum management if you enable spectrum or TPC measurement. For more information about spectrum management, see Radio Resources Management Configuration Guide.
The spectrum and tpc keywords are available only for 5 GHz and 6 GHz radios.
Examples
# Enable spectrum measurement.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] measure spectrum enable
Related commands
measure-duration
measure-interval
resource-measure
spectrum-management
measure-duration
Use measure-duration to set the measurement duration.
Use undo measure-duration to restore the default.
Syntax
measure-duration time
undo measure-duration
Default
The measurement duration is 500 TUs.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
time: Specifies the measurement duration in the range of 1 to 10000 TUs. One TU is equal to 1024 microseconds.
Usage guidelines
When measurement is enabled on an AP, the AP adds the measurement duration in the measurement requests sent to clients.
Examples
# Set the measurement duration to 512 TUs.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/2
[Sysname-WLAN-Radio1/0/2] measure-duration 512
Related commands
measure
measure-interval
measure-interval
Use measure-interval to set the measurement interval for an AP to send measurement requests to clients.
Use undo measure-interval to restore the default.
Syntax
measure-interval interval
undo measure-interval
Default
The measurement interval is 30 seconds.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
interval: Specifies the measurement interval in the range of 10 to 60 seconds.
Examples
# Set the measurement interval to 35 seconds.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/2
[Sysname-WLAN-Radio1/0/2] measure-interval 35
Related commands
measure
measure-duration
resource-measure
Use resource-measure enable to enable radio resource measurement.
Use resource-measure disable to disable radio resource measurement.
Use undo resource-measure to restore the default.
Syntax
resource-measure { disable | enable }
undo resource-measure
Default
Radio resource measurement is disabled.
Views
Radio interface view
Predefined user roles
network-admin
Usage guidelines
When radio measurement is enabled on an AP, the AP sets the Radio Measurement field to 1 in beacons, probe responses, association responses, or reassociation responses. It notifies the clients that they can send measurement requests. These frames also carry measurement capabilities of the AP to inform clients of measurement types that the AP supports.
The AP periodically sends Measurement Pilot frames to help clients fast discover the AP. Measurement Pilot frames are sent more frequently than beacons and carry less information.
Examples
# Enable radio resource measurement.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/2
[Sysname-WLAN-Radio1/0/2] resource-measure enable
rm-capability mode
Use rm-capability mode to set the match mode for client radio resource measurement capabilities.
Use undo rm-capability mode to restore the default.
Syntax
rm-capability mode { all | none | partial }
undo rm-capability mode
Default
The match mode is none for client radio resource measurement capabilities.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
all: Specifies the all mode. A client is allowed to associate with an AP only when all its radio resource measurement capabilities match the AP's radio resource measurement capabilities.
none: Specifies the none mode. The AP does not check client radio resource measurement capabilities.
partial: Specifies the partial mode. A client is allowed to associate with an AP as long as one of its radio resource measurement capabilities matches any of the AP's radio resource measurement capabilities.
Usage guidelines
The configuration takes effect only when radio resource measurement is enabled.
Examples
# Set the match mode to partial for client radio resource measurement capabilities.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/2
[Sysname-WLAN-Radio1/0/2] rm-capability mode partial
Related commands
resource-measure