Contents

Channel scanning commands· 1

scan channel blacklist 1

scan channel whitelist 1

scan idle-time· 2

scan max-service-time· 3

scan scan-time· 3

scan work-channel-only· 4

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/2

[Sysname-WLAN-Radio1/0/2] 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.

Examples

# Set the maximum service period to 3000 milliseconds.‌

<Sysname> system-view

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

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

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/2

[Sysname-WLAN-Radio1/0/2] 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/2

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