Login
- Table of Contents
- Related Documents
-
| 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
