08-Radio Resources Management

HomeSupportResource CenterH3C Access Points Cloud Mode Command References(E2442 R2442)-6W10008-Radio Resources Management
06-Channel scanning commands
Title Size Download
06-Channel scanning commands 56.09 KB

Channel scanning commands

scan channel blacklist

Use scan channel blacklist to configure the channel scanning blacklist.

Use undo scan channel blacklist to remove the specified channels from the channel scanning blacklist.

Syntax

scan channel blacklist channel-list

undo scan channel blacklist { channel-list | all }

Default

No channel scanning blacklist exists.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

channel-list: Specifies channels by their channel numbers. The value range for the channel-list argument depends on the country code and radio mode.

all: Specifies all channels in the channel scanning blacklist.

Usage guidelines

After you configure the channel scanning blacklist for an AP, the AP will not scan non-working channels in the blacklist. You cannot configure both the channel scanning blacklist and whitelist for the same AP. Before configuring the channel scanning blacklist, remove all channels in the channel scanning whitelist.

Examples

# Add channels 1 and 6 to the channel scanning blacklist.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/2

[Sysname-WLAN-Radio1/0/2] scan channel blacklist 1 6

scan channel whitelist

Use scan channel whitelist to configure the channel scanning whitelist.

Use undo scan channel whitelist to remove the specified channels from the channel scanning whitelist.

Syntax

scan channel whitelist channel-list

undo scan channel whitelist { channel-list | all }

Default

No channel scanning whitelist exists.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

channel-list: Specifies channels by their channel numbers. The value range for the channel-list argument depends on the country code and radio mode.

all: Specifies all channels in the channel scanning whitelist.

Usage guidelines

After you configure the channel scanning whitelist for an AP, the AP will scan only channels in the whitelist and the working channel. You cannot configure both the channel scanning blacklist and whitelist for the same AP. Before configuring the channel scanning whitelist, remove all channels in the channel scanning blacklist.

Examples

# Add channels 1 and 6 to the channel scanning whitelist.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/2

[Sysname-WLAN-Radio1/0/2] scan channel whitelist 1 6

scan idle-time

Use scan idle-time to set the service idle timeout timer.

Use undo scan idle-time to restore the default.

Syntax

scan idle-time idle-time

undo scan idle-time

Default

The service idle timeout timer is 100 milliseconds.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

idle-time: Specifies the service idle timeout timer in the range of 60 to 5000 milliseconds. The service idle timeout timer cannot be greater than the maximum service period.

Usage guidelines

During a service period, an AP does not begin a new scanning period until the current service period exceeds the scanning period even if the specified service idle timeout expires.

The service idle timeout timer must be a multiple of the beacon interval. The value of the beacon interval is used as the service idle timeout timer if the service idle timeout timer is smaller than the beacon interval.

Examples

# Set the service idle timeout timer to 500 milliseconds.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] scan idle-time 500

Related commands

beacon interval

scan max-service-time

Use scan max-service-time to set the maximum service period.

Use undo scan max-service-time to restore the default.

Syntax

scan max-service-time { max-service-time | no-limit }

undo scan max-service-time

Default

The maximum service period is not limited. An AP does not start a scanning period unless the service idle timeout timer expires.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

max-service-time: Specifies the maximum service period in the range of 100 to 5000 milliseconds.

no-limit: Configures the radio to not limit the service period. Specify this keyword to ensure wireless service quality. The AP does not start a scanning period unless the service idle timeout expires.

Usage guidelines

When the maximum service period for an AP is reached, the AP begins a scanning period regardless of whether it has traffic to forward. The maximum service period cannot be smaller than the scanning period.

Examples

# Set the maximum service period to 3000 milliseconds.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] scan max-service-time 3000

scan mode all

Use scan mode all enable to enable an AP to scan all channels.

Use scan mode all disable to disable an AP from scanning all channels.

Use undo scan mode to restore the default.

Syntax

scan mode all { disable | enable }

undo scan mode

Default

An AP does not scan all channels.

Views

Radio interface view

Predefined user roles

network-admin

Usage guidelines

This command is applicable only to dual-band radios.

After you configure this command for an AP, the AP alternatively scans 2.4 GHz channels and 5 GHz channels at the specified interval. As a best practice, do not enable all-channel scanning and wireless access services at the same time.

If you configure the settings of an AP such as the radio mode, channel, bandwidth, or transmit power after enabling the AP to scan all channels, the configuration might not take effect.

Examples

# Enable the AP to scan all channels.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/2

[Sysname-WLAN-Radio1/0/2] scan mode all enable

This operation will affect WLAN access and RRM. Are you sure you want to perform

 this operation?[Y/N]:Y

scan mode all interval

Use scan mode all interval to set the interval for an AP to scan all channels.

Use undo scan mode interval to restore the default.

Syntax

scan mode all interval interval-value

undo scan mode all interval

Default

The interval for an AP to alternatively scan 2.4 GHz channels and 5 GHz channels is 3000 milliseconds.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

interval interval-value: Specifies the interval for an AP to alternatively scan 2.4 GHz channels and 5 GHz channels, in the range of 2000 to 10000 milliseconds.

Examples

# Set the interval for the AP to alternatively scan 2.4 GHz channels and 5 GHz channels to 5000 milliseconds.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/2

[Sysname-WLAN-Radio1/0/2] scan mode all interval 5000

scan scan-time

Use scan scan-time to set the scanning period.

Use undo scan scan-time to restore the default.

Syntax

scan scan-time scan-time

undo scan scan-time

Default

The scanning period is 100 milliseconds.

Views

Radio interface view

Predefined user roles

network-admin

Parameters

scan-time: Specifies the scanning period in the range of 100 to 5000 milliseconds. The scanning period cannot be greater than the maximum service period.

Examples

# Set the scanning period to 500 milliseconds.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] scan scan-time 500

scan work-channel-only

Use scan work-channel-only enable to enable an AP to scan only the working channel.

Use scan work-channel-only disable to disable an AP from scanning only the working channel.

Use undo scan work-channel-only to restore the default.

Syntax

scan work-channel-only { disable | enable }

undo scan work-channel-only

Default

The AP scans all supported channels in turn.

Views

Radio interface view

Predefined user roles

network-admin

Examples

# Configure interface WLAN-radio 1/0/2 to scan only the working channel.

<Sysname> system-view

[Sysname] interface wlan-radio 1/0/1

[Sysname-WLAN-Radio1/0/1] scan work-channel-only enable