WSA commands -- display wlan spectrum-analysis channel-quality

Use display wlan spectrum-analysis channel-quality to display channel quality information.

Syntax

display wlan spectrum-analysis channel-quality [ ap ap-name | ap-group ap-group-name ]

Views

Any view

Predefined user roles

network-admin

mdc-admin

Parameters

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

ap-group ap-group-name: Specifies an AP group by its name, a case-insensitive string of 1 to 31 characters.

Usage guidelines

If you do not specify the ap ap-name or ap-group ap-group-name option, the command displays channel quality information detected by all APs.

Examples

# Display channel quality information detected by AP ap1.

<Sysname> display wlan spectrum-analysis channel-quality ap ap1

AP name RID Channel Avg-AQ Min-AQ Interference

ap1 2 1 95 84 1

Table 1 Command output

Field | Description
RID | Radio ID.
Channel | Channel number.
Avg-AQ | Average channel quality.
Min-AQ | Worst channel quality.
Interference | Number of detected interference devices.

WSA commands -- display wlan spectrum-analysis device

Use display wlan spectrum-analysis device to display interference device information.

Syntax

display wlan spectrum-analysis device [ ap ap-name | ap-group ap-group-name ]

Views

Any view

Predefined user roles

network-admin

mdc-admin

Parameters

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

ap-group ap-group-name: Specifies an AP group by its name, a case-insensitive string of 1 to 31 characters.

Usage guidelines

If you do not specify the ap ap-name or ap-group ap-group-name option, the command displays information about interference devices detected by all APs.

Examples

# Display information about interference devices detected by AP ap1.

<Sysname> display wlan spectrum-analysis device ap ap1

Interference detected by ap1 Radio1

Device ID : 0x0005

Type : Video device using fixed frequency

SI : 50

RSSI : -35

Duty cycle (%) : 20

Affected channels : 3,4,5,6,7

Detected time : Jan 6 10:42:56 2014

Device ID : 0x0007

Type : Bluetooth

SI : 80

RSSI : -49

Duty cycle (%) : 35

Affected channels : 1,3,5,6,10

Detected time : Jan 6 10:42:56 2014

Device ID : 0x000a

Type : Microwave oven

SI : 32

RSSI : -25

Duty cycle (%) : 50

Affected channels : 1,2,7,13,14

Detected time : Jan 6 10:42:56 2014

Table 2 Command output

Field | Description
Interference detected by | Name of the AP and ID of the radio that detects the interference device.
Device ID | Interference device ID.
Type | Interference device type.
SI | Severity index. A greater value represents greater interference.
RSSI | RSSI of the interference device.
Duty cycle (%) | Percentage of time in a ten second period where an interference device is active.
Affected channels | Channels affected by the interference device.
Detected time | Time when the interference device was most recently detected.

WSA commands -- snmp-agent trap enable wsa

Use snmp-agent trap enable wsa to enable SNMP notifications for WSA.

Use undo snmp-agent trap enable wsa to disable SNMP notifications for WSA.

Syntax

snmp-agent trap enable wsa

undo snmp-agent trap enable wsa

Default

SNMP notifications for WSA are disabled.

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

To report critical WSA events to an NMS, enable SNMP notifications for WSA. For WSA notifications to be sent correctly, you must also configure SNMP on the device. For more information about SNMP configuration, see Network Management and Monitoring Configuration Guide.

Examples

# Enable SNMP notifications for WSA.

<sysname> system view

[sysname] snmp-agent trap enable wsa

WSA commands -- spectrum-analysis

Use spectrum-analysis enable to enable WSA.

Use spectrum-analysis disable to disable WSA.

Use undo spectrum-analysis to restore the default.

Syntax

spectrum-analysis { disable | enable }

undo spectrum-analysis

Default

In radio view, the configuration in AP group view is used.

In AP group radio view, WSA is disabled.

Views

Radio view

AP group radio view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

With WSA enabled, APs collect interference device and channel quality information and periodically send the information to the AC for further analysis.

Examples

# Enable WSA for AP ap1.

<sysname> system view

[sysname] wlan ap ap1 WA4320i-ACN

[sysname-wlan-ap-ap1] radio 1

[sysname-wlan-ap-ap1-radio-1] spectrum-analysis enable

# Enable WSA for APs with model WA4320i-ACN in 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] spectrum-analysis enable

WSA commands -- spectrum-analysis calibrate-channel sensitivity

Use spectrum-analysis calibrate-channel sensitivity to specify a channel quality sensitivity level.

Use undo calibrate-channel sensitivity to restore the default.

Syntax

spectrum-analysis calibrate-channel sensitivity { high | low | medium }

undo spectrum-analysis calibrate-channel sensitivity

Default

In radio view, the configuration in AP group view is used.

In AP group radio view, the channel quality sensitivity level is medium.

Views

Radio view

AP group radio view

Predefined user roles

network-admin

mdc-admin

Parameters

high: Specifies the high sensitivity level. The corresponding channel quality value is 60.

low: Specifies the low sensitivity level. The corresponding channel quality value is 35.

medium: Specifies the medium sensitivity level. The corresponding channel quality value is 50.

Usage guidelines

WSA notifies RRM to perform DFS when the channel quality is lower than the channel quality value corresponding to the specified sensitivity level. Make sure WSA collaboration is enabled before you execute this command. For more information about WSA collaboration, see WLAN Configuration Guide.

A smaller channel quality value represents worse channel quality.

Examples

# Set the channel quality sensitivity level to high for AP ap1.

<sysname> system view

[sysname] wlan ap ap1 WA4320i-ACN

[sysname-wlan-ap-ap1] radio 1

[sysname-wlan-ap-ap1-radio-1] spectrum-analysis calibrate-channel sensitivity high

# Set the channel quality sensitivity level to high for APs with model WA4320i-ACN in 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] spectrum-analysis calibrate-channel sensitivity high

Related commands

calibrate-channel track spectrum-analysis

WSA commands -- spectrum-analysis device

Use spectrum-analysis device to configure interference detection.

Use undo spectrum-analysis device to remove the configuration.

Syntax

spectrum-analysis device { all | device-type } { disable | enable }

undo spectrum-analysis device { all | device-type }

Default

In radio view, the configuration in AP group view is used.

In AP group radio view, APs detect all types of interference devices.

Views

Radio view

AP group radio view

Predefined user roles

network-admin

mdc-admin

Parameters

device-type: Specifies an interference device type.

all: Specifies all interference device types.

disable: Disables detecting the specified type of interference devices.

enable: Enables detecting the specified type of interference devices.

Usage guidelines

APs can detect only the types of interference devices in the feature database. The default feature database stores features about microwave ovens, Bluetooth devices, video devices using fixed frequency, frequency-hopping cordless networks, and Microsoft Xboxes.

Types of interference devices that can be detected vary by radio mode.

Examples

# Enable detecting Bluetooth devices for AP ap1.

<sysname> system view

[sysname] wlan ap ap1 WA4320i-ACN

[sysname-wlan-ap-ap1] radio 1

[sysname-wlan-ap-ap1-radio-1] spectrum-analysis device bluetooth enable

# Enable detecting Bluetooth devices for APs with model WA4320i-ACN in 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] spectrum-analysis device bluetooth enable

WSA commands -- spectrum-analysis trap channel-quality

Use spectrum-analysis trap channel-quality enable to enable channel quality notifications.

Use spectrum-analysis trap channel-quality disable to disable channel quality notifications.

Use undo spectrum-analysis trap channel-quality to restore the default.

Syntax

spectrum-analysis trap channel-quality { disable | enable }

undo spectrum-analysis trap channel-quality

Default

In radio view, the configuration in AP group view is used.

In AP group radio view, channel quality notifications are enabled.

Views

Radio view

AP group radio view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

Channel quality notifications take effect only when you also enable SNMP notifications for WSA.

Examples

# Disable channel quality notifications for AP ap1.

<sysname> system view

[sysname] wlan ap ap1 WA4320i-ACN

[sysname-wlan-ap-ap1] radio 1

[sysname-wlan-ap-ap1-radio-1] spectrum-analysis trap channel-quality disable

# Disable channel quality notifications for APs with model WA4320i-ACN in 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] spectrum-analysis trap channel-quality disable

Related commands

snmp-agent trap enable wsa

spectrum-analysis trap channel-quality threshold

WSA commands -- spectrum-analysis trap channel-quality threshold

Use spectrum-analysis trap channel-quality threshold to set the channel quality threshold that triggers notifications.

Use undo spectrum-analysis trap channel-quality threshold to restore the default.

Syntax

spectrum-analysis trap channel-quality threshold threshold-value

undo spectrum-analysis trap channel-quality threshold

Default

In radio view, the configuration in AP group view is used.

In AP group radio view, the channel quality threshold that triggers notifications is 35.

Views

Radio view

AP group radio view

Predefined user roles

network-admin

mdc-admin

Parameters

threshold-value: Specifies the channel quality threshold that triggers notifications, in the range of 1 to 100. A smaller channel quality value represents worse channel quality.

Usage guidelines

Channel quality notifications take effect only when you also enable SNMP notifications for WSA.

Examples

# Set the channel quality threshold that triggers notifications to 45 for AP ap1.

<sysname> system view

[sysname] wlan ap ap1 WA4320i-ACN

[sysname-wlan-ap-ap1] radio 1

[sysname-wlan-ap-ap1-radio-1] spectrum-analysis trap channel-quality threshold 45

# Set the channel quality threshold that triggers notifications to 45 for APs with model WA4320i-ACN in 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] spectrum-analysis trap channel-quality threshold 45

Related commands

snmp-agent trap enable wsa

spectrum-analysis trap channel-quality enable

WSA commands -- spectrum-analysis trap device

Use spectrum-analysis trap device to configure notifications for the specified type of interference devices.

Use undo spectrum-analysis trap device to restore the default.

Syntax

spectrum-analysis trap device { all | device-type } { disable | enable }

undo spectrum-analysis trap device { all | device-type }

Default

In radio view, the configuration in AP group view is used.

In AP group radio view, notifications are enabled for all types of interference devices.

Views

Radio view

AP group radio view

Predefined user roles

network-admin

mdc-admin

Parameters

device-type: Specifies an interference device type.

all: Specifies all interference device types.

disable: Disables notifications for the specified type of interference devices.

enable: Enables notifications for the specified type of interference devices.

Usage guidelines

Notifications for an interference device type take effect only when you also enable SNMP notifications for WSA.

Examples

# Disable notifications when Bluetooth devices are detected on AP ap1.

<sysname> system view

[sysname] wlan ap ap1 WA4320i-ACN

[sysname-wlan-ap-ap1] radio 1

[sysname-wlan-ap-ap1-radio-1] undo spectrum-analysis trap device Bluetooth

# Disable notifications when Bluetooth devices are detected on APs with model WA4320i-ACN in 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] undo spectrum-analysis trap device Bluetooth

Related commands

snmp-agent trap enable wsa

spectrum-analysis device

spectrum-analysis trap device

WSA commands -- spectrum-analysis trap device enable

Use spectrum-analysis trap device enable to enable interference device notifications.

Use spectrum-analysis trap device disable to disable interference device notifications.

Use undo spectrum-analysis trap device to restore the default.

Syntax

spectrum-analysis trap device { disable | enable }

undo spectrum-analysis trap device

Default

In radio view, the configuration in AP group view is used.

In AP group radio view, interference device notifications are enabled.

Views

Radio view

AP group radio view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

Interference device notifications take effect only when you also enable SNMP notifications for WSA.

Examples

# Disable interference device notifications for AP ap1.

<sysname> system view

[sysname] wlan ap ap1

[sysname-wlan-ap-ap1] radio 1

[sysname-wlan-ap-ap1-radio-1] spectrum-analysis trap device disable

# Disable interference device notifications for APs with model WA4320i-ACN in 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] spectrum-analysis trap device disable

Related commands

snmp-agent trap enable wsa

spectrum-analysis device

spectrum-analysis trap device

WSA commands -- wlan spectrum-analysis feature-db file

Use wlan spectrum-analysis feature-db file to import a feature database file.

Use undo wlan spectrum-analysis feature-db file to restore the default.

Syntax

wlan spectrum-analysis feature-db file file-name

undo wlan spectrum-analysis feature-db file

Default

WSA uses the default feature database.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

file file-name: Specifies a feature database file by its name.

Usage guidelines

A feature database stores features such as the frequency hopping interval and the pulse interval for specific types of interference devices.

Before configuring this command, you must upload the feature database file to the AC's storage media.

Examples

# Import feature database file feature.sadb.

<sysname> system view

[sysname] wlan spectrum-analysis feature-db file feature.sadb