acs (meshpoint-device-config)

Enables Automatic Channel Selection (ACS) on this meshpoint device (access point). When enabled, this feature automatically selects the best channel for a meshpoint-device radio based on the device configuration, channel conditions, and network layout.

In a wireless network deployment, it is advantageous for network devices to have the ability to operate in multiple channels and not be limited to only a single channel. Multiple channels increase the bandwidth and throughput of the wireless network. In such a scenario, each network device must have a mechanism to dynamically select a suitable channel of operation. ACS provides the required mechanism for a MCX enabled device.

Use this command to configure the ACS settings and override the default meshpoint configurations.

Supported on the following platforms:

Syntax

acs [channel-hold-time|channel-switch-delta|channel-width|ocs-duration|ocs-frequency|
path-min|path-threshold|preferred-interface-tolerance-period|preferred-radio-interface|
priority-meshpoint|sample-count|snr-delta|signal-threshold|tolerance-period]
acs channel-hold-time [2.4GHz|5GHz] <0-86400>
acs channel-switch-delta [2.4GHz|5GHz] <5-35>
acs channel-width [2.4GHz|5GHz] [20MHz|40MHz|80MHz|auto]
acs ocs-duration [2.4GHz|5GHz] <20-250>
acs ocs-frequency [2.4GHz|5GHz] <1-60>
acs path-min [2.4GHz|5GHz] <100-20000>
acs path-threshold [2.4GHz|5GHz] <800-65535>
acs preferred-interface-tolerance-period [2.4GHz|5GHz] <10-600>
acs preferred-radio-interface [2.4GHz|5GHz] <0-2>
acs priority-meshpoint [2.4GHz|5GHz] <MESHPOINT-NAME>
acs priority-meshpoint [2.4GHz|5GHz] <MESHPOINT-NAME>
acs sample-count [2.4GHz|5GHz] <1-10>
acs snr-delta [2.4GHz|5GHz] <1-100>
acs signal-threshold [2.4GHz|5GHz] <-100-0>
acs tolerance-period [2.4GHz|5GHz] <10-600>

Parameters

acs channel-hold-time [2.4GHz|5GHz] <0-86400>
acs Configures ACS settings and overrides on the selected meshpoint-device
channel-hold-time [2.4GHz|5GHz] <0-86400> Configures the minimum time, in seconds, before a periodic scan, to assess channel conditions for a meshpoint root, is triggered.
  • 2.4 GHz – Configures the channel hold interval for the 2.4 GHz radio band
  • 5.0GHz – Configures the channel hold interval for the 5.0 GHz radio band
The following keyword is common to the ‘2.4 GHz‘ and ‘5.0 GHz‘ bands:
  • <0-86400> – Specify a value from 0 - 86400 seconds. The default is 1800 seconds.
Note: A value of ‘0‘ disables periodic channel assessment.
 
acs channel-switch-delta [2.4GHz|5GHz] <5-35>
acs Configures ACS settings and overrides on the selected meshpoint-device
channel-switch-delta [2.4GHz|5GHz] <5-35> Configures the difference in interference between the current and best channel needed to trigger a channel change. Once the difference in the current channel and the best channel interference equals the configured value, a channel change is triggered.
  • 2.4 GHz – Configures the channel switch delta for the 2.4GHz radio band
  • 5.0GHz – Configures the channel switch delta for the 5.0 GHz radio band
The following keyword is common to the ‘2.4 GHz‘ and ‘5.0 GHz‘ bands:
  • <5-35> – Specify a value from 5 - 35 dBm. The default is 10 dBm.
 
acs channel-width [2.4GHz|5GHz] [20MHz|40MHz|80MHz|auto]
acs Configures ACS settings and overrides on the selected meshpoint-device
channel-width [2.4GHz|5GHz] [20MHz|40MHz|80MHz| auto] Configures the channel width that meshpoint auto channel selection assigns to the radio
  • 2.4 GHz – Configures the operating channel width for the 2.4 GHz radio band
  • 5.0 GHz – Configures the operating channel width for the 5.0 GHz radio band
The following keywords are common to the ‘2.4 GHz‘ and ‘5.0 GHz‘ bands:
  • 20 MHz – Assigns the 20 MHz channel width to the radio
  • 40 MHz – Assigns the 40 MHz channel width to the radio
  • auto – Selects and assigns the best possible channel from the 20/40 MHz width. This is the default setting.
 
acs ocs-duration [2.4GHz|5GHz] <20-250>
acs Configures ACS settings and overrides on the selected meshpoint-device
ocs-duration [2.4GHz|5GHz] <20-250> Configures the duration, in milliseconds, of off -channel scans (OCS)
  • 2.4 GHz – Configures the ocs-duration for the 2.4 GHz radio band
  • 5.0 GHz – Configures the ocs-duration for the 5.0 GHz radio band
The following keyword is common to the ‘2.4 GHz‘ and ‘5.0 GHz‘ bands:
  • <20-250> – Specify a value from 20 - 250 milliseconds. The default value is 50 milliseconds.
 
acs ocs-frequency [2.4GHz|5GHz] <1-60>
acs Configures ACS settings and overrides on the selected meshpoint-device
ocs-frequency [2.4GHz|5GHz] <1-60> Configures the interval, in seconds, at which off-channel scan is performed. An ocs-frequency of 10 seconds means that an off-channel scan will be performed once every 10 seconds.
  • 2.4 GHz – Configures the ocs-frequency for the 2.4 GHz radio band
  • 5.0 GHz – Configures the ocs-frequency for the 5.0 GHz radio band
The following keyword is common to the ‘2.4 GHz‘ and ‘5.0 GHz‘ bands:
  • <1-60> – Specify a value form 1 - 60 seconds. The default is 6 seconds.
 
acs path-min [2.4GHz|5GHz] <100-20000>
acs Configures ACS settings and overrides on the selected meshpoint-device
path-min [2.4GHz|5GHz] <100-20000> Configures the minimum root path metric needed for auto channel selection. This is the acceptance root path metric value to consider a root as a possible candidate mesh node.
  • 2.4 GHz – Configures the minimum root path metric for the 2.4 GHz radio band
  • 5.0 GHz – Configures the minimum root path metric for the 5.0 GHz radio band
The following keyword is common to the ‘2.4 GHz‘ and ‘5.0 GHz‘ bands:
  • <100-20000> – Specify a value from 100 - 20000. The default is 1000.
 
acs path-threshold [2.4GHz|5GHz] <800-65535>
acs Configures ACS settings and overrides on the selected meshpoint-device
path-threshold [2.4GHz|5GHz] <800-65535> Configures the root path metric threshold for auto channel selection. This is the acceptance root path metric threshold beyond which the root bound to is considered as bad.
  • 2.4 GHz – Configures the root path metric threshold for the 2.4 GHz radio band
  • 5.0 GHz – Configures the root path metric threshold for the 5.0 GHz radio band
The following keyword is common to the ‘2.4 GHz‘ and ‘5.0 GHz‘ bands:
  • <800-65535> – Specify a value from 800 -65535. The default is 1500.
 
acs preferred-interface-tolerance-period [2.4GHz|5GHz] <10-600>
acs Configures ACS settings and overrides on the selected meshpoint-device
preferred-interface-tolerance-period [2.4GHz|5GHz] <10-600> Configures the maximum tolerance period, in seconds, for low root metrics on the preferred interface. This is the duration to wait before triggering an automatic channel selection for the next mesh-hop on the preferred interface.
  • 2.4 GHz – Configures the maximum tolerance period for the 2.4 GHz radio band
  • 5.0 GHz – Configures the maximum tolerance period for the 5.0 GHz radio band
The following keyword is common to the ‘2.4 GHz‘ and ‘5.0 GHz‘ bands:
  • <800-65535> – Specify a value from 10 - 600 seconds.
 
acs preferred-radio-interface [2.4GHz|5GHz] <0-2>
acs Configures ACS settings and overrides on the selected meshpoint-device
preferred-radio-interface [2.4GHz|5GHz] <0-2> Configures the preferred radio interface on dual band APs
  • 2.4 GHz – Configures the preferred radio interface for the 2.4 GHz radio band
  • 5.0 GHz – Configures the preferred radio interface for the 5.0 GHz radio band
The following keyword is common to the ‘2.4 GHz‘ and ‘5.0 GHz‘ bands:
  • <0-2> – Specify a value form 0 - 2. A value of 0 (zero) indicates no preferred radio.
 
acs priority-meshpoint [2.4GHz|5GHz] <MESHPOINT-NAME>
acs Configures ACS settings and overrides on the selected meshpoint-device
priority-meshpoint [2.4GHz|5GHz] <MESHPOINT-NAME> Configures the priority meshpoint. Configuring a priority meshpoint overrides automatic meshpoint configuration.
  • 2.4 GHz – Configures the priority meshpoint for the 2.4 GHz radio band
  • 5.0 GHz – Configures the priority meshpoint for the 5.0 GHz radio band

The following keyword is common to the ‘2.4 GHz‘ and ‘5.0 GHz‘ bands:

  • <MESHPOINT-NAME> – Specify the meshpoint name for the selected radio band.
 
acs sample-count [2.4GHz|5GHz] <1-10>
acs Configures ACS settings and overrides on the selected meshpoint-device
sample-count [2.4GHz|5GHz] <1-10> Configures the minimum number of scan cycle samples to consider for auto channel selection
  • 2.4 GHz – Configures the sample count for the 2.4 GHz radio band
  • 5.0 GHz – Configures the sample count for the 5.0 GHz radio band

The following keyword is common to the ‘2.4 GHz‘ and ‘5.0 GHz‘ bands:

  • <1-10> – Specify a value from 1 -10. The default is 5 samples.
 
acs snr-delta [2.4GHz|5GHz] <1-100>
acs Configures ACS settings and overrides on the selected meshpoint-device
snr-delta [2.4GHz|5GHz] <1-100> Configures the channel SNR delta. A meshpoint on a candidate channel must have a SNR of a greater delta than the next hop on the current channel.
  • 2.4 GHz – Configures the snr-delta for the 2.4 GHz radio band
  • 5.0 GHz – Configures the snr-delta for the 5.0 GHz radio band

The following keyword is common to the ‘2.4 GHz‘ and ‘5.0 GHz‘ bands:

  • <1-100> – Specify a value from 1 - 100 dB. The default is 5 dB.
 
acs snr-threshold [2.4GHz|5GHz] <-100-0>
acs Configures ACS settings and overrides on the selected meshpoint-device
snr-threshold [2.4GHz|5GHz] <-100-0> Configures the signal strength threshold. If the signal strength of the next hop drops below the configured snr-threshold, a scan is triggered.
  • 2.4 GHz – Configures the snr-threshold for the 2.4 GHz radio band
  • 5.0 GHz – Configures the snr-threshold for the 5.0 GHz radio band

The following keyword is common to the ‘2.4 GHz‘ and ‘5.0 GHz‘ bands:

  • <-100-0> – Specify a value from -100 - 0 dB. The default is -65 dB.
 
acs tolerance-period [2.4GHz|5GHz] <10-600>
acs Configures ACS settings and overrides on the selected meshpoint-device
tolerance-period [2.4GHz|5GHz] <10-600> Configures the maximum tolerance period in seconds. This is the interval to wait for the root bound to recovery from a bad link.
  • 2.4 GHz – Configures the tolerance-period for the 2.4 GHz radio band
  • 5.0 GHz – Configures the tolerance-period for the 5.0 GHz radio band

The following keyword is common to the ‘2.4 GHz‘ and ‘5.0 GHz‘ bands:

  • <10-600> – Specify a value from 10 - 600 seconds. the default is 60 seconds.

Examples

nx9500-6C8809(config-profile-testAP8533-meshpoint-test)#acs channel-hold-time 2.4GHz 2500

nx9500-6C8809(config-profile-testAP8533-meshpoint-test)#acs ocs-duration 2.4GHz 30

nx9500-6C8809(config-profile-testAP8533-meshpoint-test)#acs ocs-frequency 2.4GHz 1

nx9500-6C8809(config-profile-testAP8533-meshpoint-test)#show context
 meshpoint-device test
  acs ocs-frequency 2.4GHz 1
  acs osc-duration 2.4GHz 30
  acs channel-hold-time 2.4GHz 2500
nx9500-6C8809(config-profile-testAP8533-meshpoint-test)#

Related Commands

no (meshpoint-device-config) Reverts the configured ACS settings to default
9036514-01 Rev AA