CleanAir Commands

ap dot11 24ghz cleanair

To enable CleanAir for detecting 2.4-GHz devices, use the apdot1124ghzcleanair command in global configuration mode. To disable CleanAir for detecting 2.4-GHz devices, use the noform of this command.

apdot1124ghzcleanair

Syntax Description

This command has no arguments or keywords.

Command Default

Disabled.

Command Modes

Global configuration (config).

Command History

Release

Modification

Cisco IOS XE 3.2SE

This command was introduced.

Usage Guidelines

You must enable this CleanAir command before you configure other CleanAir commands.

This example shows how to enable CleanAir for 2.4-GHz devices:

Switch(config)# ap dot11 24ghz cleanair

ap dot11 24ghz cleanair alarm air-quality

To configure the alarm for the threshold value of Air Quality (AQ) for all 2.4-GHz devices, use the apdot1124ghzcleanairalarmair-quality command in global configuration mode. To disable the alarm for the threshold value of AQ for all 2.4-GHz devices, use the no form of this command.

apdot1124ghzcleanairalarmair-qualitythresholdthreshold_value

Syntax Description

thresholdthreshold_value

Configures the threshold value for AQ. The range is from 1 to 100.

Command Default

The default threshold value for AQ is 10.

Command Modes

Global configuration (config)

Command History

Release

Modification

Cisco IOS XE 3.2SE

This command was introduced.

Usage Guidelines

You must enable CleanAir using the ap dot11 24ghz cleanair command before you configure this command.

ap dot11 24ghz cleanair alarm device

To configure the alarm for the 2.4-GHz interference devices, use the apdot1124ghzcleanairalarmdevice command in global configuration mode. To disable the alarm for the 2.4-GHz interference devices, use the no form of this command.

Configures the alarm for devices using spectrally inverted Wi-Fi signals.

jammer

Configures the alarm for jammer interference devices.

mw-oven

Configures the alarm for microwave ovens.

nonstd

Configures the alarm for devices using nonstandard Wi-Fi channels.

superag

Configures the alarm for 802.11 SuperAG interference devices.

tdd-tx

Configures the alarm for Time Division Duplex (TDD) transmitters.

video

Configures the alarm for video cameras.

wimax-fixed

Configures the alarm for WiMax fixed interference devices.

wimax-mobile

Configures the alarm for WiMax mobile interference devices.

xbox

Configures the alarm for Xbox interference devices.

zigbee

Configures the alarm for 802.15.4 interference devices.

Command Default

The alarm for Wi-Fi inverted devices is enabled. The alarm for all other devices is disabled.

Command Modes

Global configuration (config).

Command History

Release

Modification

Cisco IOS XE 3.2SE

This command was introduced.

Usage Guidelines

You must enable CleanAir using the ap dot11 24ghz cleanaircommand before you configure this command.

This example shows how to enable CleanAir to report when a video camera interferes:

Switch(config)# defaultap dot11 24ghz cleanair device video

ap dot11 24ghz rrm channel cleanair-event

To enable Event-Driven RRM (EDRRM) and the sensitivity for 2.4-GHz devices, use the apdot1124ghzrrmchannelcleanair-event command in global configuration mode. To disable EDRRM, use the no form of this command.

ap dot11 24ghz rrm channel device

To configure persistent non-Wi-Fi device avoidance in the 802.11b channel, use the apdot1124ghzrrmchanneldevice command in global configuration mode. To disable persistent device avoidance, use the no form of this command.

apdot1124ghzrrmchanneldevice

noapdot1124ghzrrmchanneldevice

Syntax Description

This command has no arguments or keywords.

Command Default

Persistent device avoidance is disabled.

Command Modes

Global configuration (config).

Command History

Release

Modification

Cisco IOS XE 3.2SE

This command was introduced.

Usage Guidelines

CleanAir-capable monitor mode access points collect information about persistent devices on all configured channels and stores the information in the switch. Local and bridge mode access points detect interference devices on the serving channels only.

This example shows how to enable persistent device avoidance:

Switch(config)# ap dot11 24ghz rrm channel device

ap dot11 5ghz cleanair

To enable CleanAir for detecting 5-GHz devices, use the apdot115ghzcleanair command in global configuration mode.

apdot115ghzcleanair

Command Default

Disabled.

Command Modes

Global configuration.

Command History

Release

Modification

Cisco IOS XE 3.2SE

This command was introduced.

Usage Guidelines

You must enable this CleanAir command before you configure other CleanAir commands.

This example shows how to enable CleanAir for 5-GHz devices:

Switch(config)# ap dot11 5ghz cleanair

ap dot11 5ghz cleanair alarm air-quality

To configure the alarm when the Air Quality (AQ) reaches the threshold value for the 5-GHz devices, use the apdot115ghzcleanairalarmair-quality command.

apdot115ghzcleanairalarmair-qualitythreshold threshold _value

Syntax Description

air-quality

Configures the alarm for the AQ of 5-GHz devices.

thresholdthreshold _value

Configures the threshold value for air quality. The range is from 1 to 100.

Command Default

The default threshold value for AQ is 10.

Command Modes

Global configuration.

Command History

Release

Modification

Cisco IOS XE 3.2SE

This command was introduced.

Usage Guidelines

You must enable CleanAir before you configure this command.

This example shows how to set the threshold value for the AQ:

Switch(config)# ap dot11 5ghz cleanair alarm air-quality threshold 30

ap dot11 5ghz cleanair alarm device

To configure the alarm for the 5-GHz interference devices, use the apdot115ghzcleanairalarmdevice command.

Configures the alarm for devices using spectrally inverted Wi-Fi signals.

jammer

Configures the alarm for jammer interference devices.

nonstd

Configures the alarm for devices using nonstandard Wi-Fi channels.

radar

Configures the alarm for radars.

report

Enables interference device reports.

superag

Configures the alarm for 802.11 SuperAG interference devices.

tdd-tx

Configures the alarm for Time Division Duplex (TDD) transmitters.

video

Configures the alarm for video cameras.

wimax-fixed

Configures the alarm for WiMax fixed interference devices.

wimax-mobile

Configures the alarm for WiMax mobile interference devices.

Command Default

The default alarm values of the following 5-GHz interference devices are:

Canopy devices—Disabled

Continuous Transmitter devices—Disabled

DECT-like Phone—Disabled

802.11 FH devices—Disabled

WiFi Inverted devices—Enabled

Jammer devices—Disabled

Devices using nonstandard Wi-Fi channels—Disabled

SuperAG devices—Disabled

TDD Transmitter devices—Disabled

Video Cameras—Disabled

WiMax Fixed devices—Disabled

WiMax Mobile devices—Disabled

Command Modes

Global configuration.

Command History

Release

Modification

Cisco IOS XE 3.2SE

This command was introduced.

Usage Guidelines

You must enable CleanAir before you configure this command.

This example shows how to enable CleanAir to report when a video camera interferes:

Switch(config)# defaultap dot11 5ghz cleanair device video

ap dot11 5ghz rrm channel cleanair-event

To enable Event-Driven RRM (EDRRM) and configure the sensitivity for 5-GHz devices, use the apdot115ghzrrmchannelcleanair-event command in global configuration mode. To disable EDRRM, use the no form of the command.

ap dot11 5ghz rrm channel device

To configure persistent non-Wi-Fi device avoidance in the 802.11a channel, use the apdot115ghzrrmchanneldevice command in global configuration mode. To disable persistent device avoidance, use the no form of this command.

apdot115ghzrrmchanneldevice

noapdot115ghzrrmchanneldevice

Syntax Description

This command has no arguments or keywords.

Command Default

The CleanAir persistent device state is disabled.

Command Modes

Global configuration (config)

Command History

Release

Modification

Cisco IOS XE 3.2SE

This command was introduced.

Usage Guidelines

CleanAir-capable monitor mode access points collect information about persistent devices on all configured channels and stores the information in the switch. Local and bridge mode access points detect interference devices on the serving channels only.

This example shows how to enable persistent device avoidance on 802.11a devices:

Switch(config)# ap dot11 5ghz rrm channel device

ap name mode se-connect

To configure the access point for SE-Connect mode, use the ap name ap_name mode se-connect command.

ap name ap_name mode se-connect

Syntax Description

ap_name

Name of the access point.

Command Default

No access point is configured for SE-Connect mode.

Command Modes

Privileged EXEC (#)

Command History

Release

Modification

Cisco IOS XE 3.2SE

This command was introduced.

Usage Guidelines

The access point will reboot after you change the mode.

SE-connect mode enables a user to connect a Spectrum Expert application running on an external Microsoft Windows XP or Vista PC to a Cisco CleanAir-enabled access point in order to display and analyze detailed spectrum data. The Spectrum Expert application connects directly to the access point, by passing the controller. An access point in SE-Connect mode does not provide any Wi-Fi, RF, or spectrum data to the controller. All CleanAir system functionality is suspended while the AP is in this mode, and no clients are served. This mode is intended for remote troubleshooting only.

This example shows how to change the mode of the access point to SE-Connect:

Switch# ap name AS-5508-5-AP3 mode se-connect
Changing the AP's mode will cause the AP to reboot.
Are you sure you want to continue? (y/n)[y]: y
% switch-1:wcm:Cisco AP does not support the seconnect mode

default ap dot11 24ghz cleanair alarm device

To configure the default value of the alarm for 2.4-GHz interference devices, use the default apdot1124ghz cleanairalarm device command in global configuration mode.

Configures the alarm for devices using spectrally inverted Wi-Fi signals.

jammer

Configures the alarm for jammer interference devices.

mw-oven

Configures the alarm for microwave ovens.

nonstd

Configures the alarm for devices using nonstandard Wi-Fi channels.

superag

Configures the alarm for 802.11 SuperAG interference devices.

tdd-tx

Configures the alarm for Time Division Duplex (TDD) transmitters.

video

Configures the alarm for video cameras.

wimax-fixed

Configures the alarm for WiMax fixed interference devices.

wimax-mobile

Configures the alarm for WiMax mobile interference devices.

xbox

Configures the alarm for Xbox interference devices.

zigbee

Configures the alarm for 802.15.4 interference devices.

Command Default

The alarm for Wi-Fi inverted devices is enabled. The alarm for all other devices is disabled.

Command Modes

Global configuration (config).

Command History

Release

Modification

Cisco IOS XE 3.2SE

This command was introduced.

Usage Guidelines

You must enable CleanAir using the ap dot11 24ghz cleanaircommand before you configure this command.

This example shows how to enable CleanAir to report when a video camera interferes:

Switch(config)# defaultap dot11 24ghz cleanair device video

default ap dot11 24ghz rrm channel cleanair-event

To configure the default Event-Driven radio resource management (EDRRM) state and sensitivity for 2.4-GHz devices, use the default apdot1124ghzrrmchannelcleanair-event command in global configuration mode.

Configures the alarm for devices using spectrally inverted Wi-Fi signals.

jammer

Configures the alarm for jammer interference devices.

nonstd

Configures the alarm for devices using nonstandard Wi-Fi channels.

radar

Configures the alarm for radars.

report

Enables interference device reports.

superag

Configures the alarm for 802.11 SuperAG interference devices.

tdd-tx

Configures the alarm for Time Division Duplex (TDD) transmitters.

video

Configures the alarm for video cameras.

wimax-fixed

Configures the alarm for WiMax fixed interference devices.

wimax-mobile

Configures the alarm for WiMax mobile interference devices.

Command Default

The default alarm values of the following 5-GHz interference devices are:

Canopy devices—Disabled

Continuous Transmitter devices—Disabled

DECT-like Phone—Disabled

802.11 FH devices—Disabled

WiFi Inverted devices—Enabled

Jammer devices—Disabled

Devices using nonstandard Wi-Fi channels—Disabled

SuperAG devices—Disabled

TDD Transmitter devices—Disabled

Video Cameras—Disabled

WiMax Fixed devices—Disabled

WiMax Mobile devices—Disabled

Command Modes

Global configuration.

Command History

Release

Modification

Cisco IOS XE 3.2SE

This command was introduced.

Usage Guidelines

You must enable CleanAir before you configure this command.

This example shows how to enable CleanAir to report when a video camera interferes:

Switch(config)# defaultap dot11 5ghz cleanair device video

default ap dot11 5ghz rrm channel cleanair-event

To configure the default state of Event-Driven radio resource management (EDRRM) and the EDRRM sensitivity for 5-GHz devices, use the default apdot115ghzrrmchannelcleanair-event command in global configuration mode.