02-WLAN

HomeSupportResource CenterH3C Access Controllers Command References(E5208P03 E5215P01 R5215P01)-6W10202-WLAN
10-WLAN radio resource measurement commands
Title Size Download
10-WLAN radio resource measurement commands 74.11 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 ap ap-name radio radio-id [ client mac-address mac-address ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

ap ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

radio radio-id: Specifies a radio by its number. The value range varies by device model.

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 radio 2 of the AP ap1.

<Sysname> display wlan measure-report ap ap1 radio 2

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

Link margin

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

Percentage of busy time for a channel to the total measurement period.

RPI0 to RPI7 density

Percentage of time for different RPI ranges to the total 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

In radio view, the AP uses the configuration in AP group view.

In AP group radio view, measurement is disabled.

Views

Radio view

AP group radio 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.

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.

spectrum: Specifies spectrum measurement, which includes basic measurement, Clear Channel Assessment (CCA) measurement, and Receive Power Indication (RPI) measurement.

tpc: Specifies TPC measurement. TPC measurement measures link redundancy and transmission power for clients.

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 WLAN Configuration Guide.

The spectrum and tpc keywords are available only on 5 GHz radios.

Examples

# Enable spectrum measurement for the AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] radio 1

[Sysname-wlan-ap-ap1-radio-1] measure spectrum enable

# Enable spectrum measurement for the AP group apgroup1.

<Sysname> system-view

[Sysname] wlan ap-group apgroup1

[Sysname-wlan-ap-group-apgroup1] ap-model WA4320i-ACN

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN] radio 1

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN-radio-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

In radio view, the AP uses the configuration in AP group view.

In AP group radio view, the measurement duration is 500 TUs.

Views

Radio view

AP group radio 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, measurement requests from the AP to clients carry the measurement duration.

Examples

# Set the measurement duration to 512 TUs for the AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] radio 1

[Sysname-wlan-ap-ap1-radio-1] measure-duration 512

# Set the measurement duration to 512 TUs for the AP group apgroup1.

<Sysname> system-view

[Sysname] wlan ap-group apgroup1

[Sysname-wlan-ap-group-apgroup1] ap-model WA4320i-ACN

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN] radio 1

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN-radio-1] 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 value

undo measure-interval

Default

In radio view, the AP uses the configuration in AP group view.

In AP group radio view, the measurement interval is 30 seconds.

Views

Radio view

AP group radio view

Predefined user roles

network-admin

Parameters

value: Specifies the measurement interval in the range of 10 to 60 seconds.

Examples

# Set the measurement interval to 35 seconds for the AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] radio 1

[Sysname-wlan-ap-ap1-radio-1] measure-interval 35

# Set the measurement interval to 35 seconds for the AP group apgroup1.

<Sysname> system-view

[Sysname] wlan ap-group apgroup1

[Sysname-wlan-ap-group-apgroup1] ap-model WA4320i-ACN

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN] radio 1

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN-radio-1] 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

In radio view, the AP uses the configuration in AP group view.

In AP group radio view, radio resource measurement is disabled.

Views

Radio view

AP group 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 for the AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] radio 2

[Sysname-wlan-ap-ap1-radio-2] resource-measure enable

# Enable radio resource measurement for the AP group apgroup1.

<Sysname> system-view

[Sysname] wlan ap-group apgroup1

[Sysname-wlan-ap-group-apgroup1] ap-model WA4320i-ACN

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN] radio 1

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN-radio-1] 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

In radio view, the AP uses the configuration in AP group view.

In AP group radio view, the match mode is none for client radio resource measurement capabilities.

Views

Radio view

AP group 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 for the AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] radio 2

[Sysname-wlan-ap-ap1-radio-2] resource-measure enable

[Sysname-wlan-ap-ap1-radio-2] rm-capability mode partial

# Set the match mode to partial for client radio resource measurement capabilities for the AP group apgroup1.

<Sysname> system-view

[Sysname] wlan ap-group apgroup1

[Sysname-wlan-ap-group-apgroup1] ap-model WA4320i-ACN

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN] radio 1

[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320i-ACN-radio-1] rm-capability mode partial

Related commands

resource-measure