acs (meshpoint-device-config)

Enables ACS (Automatic Channel Selection) 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 in 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|6GHz] <0-86400>
acs channel-switch-delta [2.4GHz|5GHz|6GHz] <5-35>
acs channel-width [2.4GHz|5GHz|6GHz] [20MHz|40MHz|80MHz|160MHz|auto]
acs ocs-duration [2.4GHz|5GHz|6GHz] <20-250>
acs ocs-frequency [2.4GHz|5GHz|6GHz] <1-60>
acs path-min [2.4GHz|5GHz|6GHz] <100-20000>
acs path-threshold [2.4GHz|5GHz|6GHz] <800-65535>
acs preferred-interface-tolerance-period [2.4GHz|5GHz|6GHz] <10-600>
acs preferred-radio-interface [2.4GHz|5GHz|6GHz] <0-2>
acs priority-meshpoint [2.4GHz|5GHz|6GHz] <MESHPOINT-NAME>
acs priority-meshpoint [2.4GHz|5GHz|6GHz] <MESHPOINT-NAME>
acs sample-count [2.4GHz|5GHz|6GHz] <1-10>
acs snr-delta [2.4GHz|5GHz|6GHz] <1-100>
acs signal-threshold [2.4GHz|5GHz|6GHz] <-100-0>
acs tolerance-period [2.4GHz|5GHz|6GHz] <10-600>

Parameters

acs channel-hold-time [2.4GHz|5GHz|6GHz] <0-86400>

acs

Configures ACS settings and overrides on the selected meshpoint-device

channel-hold-time [2.4GHz|5GHz|6GHz] <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

    6.0GHz – Configures the channel hold interval for the 6.0 GHz radio band

The following keyword is common to the 2.4 GHz, 5.0 GHz, and 6.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|6GHz] <5-35>

acs

Configures ACS settings and overrides on the selected meshpoint-device

channel-switch-delta [2.4GHz|5GHz|6GHz] <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

  • 6.0GHz – Configures the channel switch delta for the 6.0 GHz radio band

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

  • <5-35> – Specify a value from 5 - 35 dBm. The default is 10 dBm.

 
acs channel-width [2.4GHz|5GHz|6GHz] [20MHz|40MHz|80MHz|160MHz|auto]

acs

Configures ACS settings and overrides on the selected meshpoint-device
channel-width [2.4GHz|5GHz|6GHz] [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

  • 6.0 GHz – Configures the operating channel width for the 6.0 GHz radio band

The following keywords are common to the 2.4 GHz, 5.0 GHz, 6.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|6GHz] <20-250>

acs

Configures ACS settings and overrides on the selected meshpoint-device

ocs-duration [2.4GHz|5GHz|6GHz] <20-250>
Configures the duration, in milliseconds, of OCSs (off -channel scans)

  • 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

  • 6.0 GHz – Configures the ocs-duration for the 6.0 GHz radio band

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

  • <20-250> – Specify a value from 20 - 250 milliseconds. The default value is 50 milliseconds.

 
acs ocs-frequency [2.4GHz|5GHz|6GHz] <1-60>

acs

Configures ACS settings and overrides on the selected meshpoint-device

ocs-frequency [2.4GHz|5GHz|6GHz] <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

  • 6.0 GHz – Configures the ocs-frequency for the 6.0 GHz radio band

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

  • <1-60> – Specify a value form 1 - 60 seconds. The default is 6 seconds.

 
acs path-min [2.4GHz|5GHz|6GHz] <100-20000>

acs

Configures ACS settings and overrides on the selected meshpoint-device

path-min [2.4GHz|5GHz|6GHz] <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

  • 6.0 GHz – Configures the minimum root path metric for the 6.0 GHz radio band

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

  • <100-20000> – Specify a value from 100 - 20000. The default is 1000.

 
acs path-threshold [2.4GHz|5GHz|6GHz] <800-65535>

acs

Configures ACS settings and overrides on the selected meshpoint-device

path-threshold [2.4GHz|5GHz|6GHz] <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

  • 6.0 GHz – Configures the root path metric threshold for the 6.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|6GHz] <10-600>
acs Configures ACS settings and overrides on the selected meshpoint-device
preferred-interface-tolerance-period [2.4GHz|5GHz|6GHz] <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
  • 6.0 GHz – Configures the maximum tolerance period for the 6.0 GHz radio band
The following keyword is common to the 2.4 GHz, 5.0 GHz, and 6.0 GHz bands:
  • <800-65535> – Specify a value from 10 - 600 seconds.
 
acs preferred-radio-interface [2.4GHz|5GHz|6GHz] <0-2>
acs Configures ACS settings and overrides on the selected meshpoint-device
preferred-radio-interface [2.4GHz|5GHz|6GHz] <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
  • 6.0 GHz – Configures the preferred radio interface for the 6.0 GHz radio band
The following keyword is common to the 2.4 GHz, 5.0 GHz, and 6.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|6GHz] <MESHPOINT-NAME>

acs

Configures ACS settings and overrides on the selected meshpoint-device

priority-meshpoint [2.4GHz|5GHz|6GHz] <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

  • 6.0 GHz – Configures the priority meshpoint for the 6.0 GHz radio band

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

  • <MESHPOINT-NAME> – Specify the meshpoint name for the selected radio band.

 
acs sample-count [2.4GHz|5GHz|6GHz] <1-10>

acs

Configures ACS settings and overrides on the selected meshpoint-device

sample-count [2.4GHz|5GHz|6GHz] <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

  • 6.0 GHz – Configures the sample count for the 6.0 GHz radio band

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

  • <1-10> – Specify a value from 1 -10. The default is 5 samples.

 
acs snr-delta [2.4GHz|5GHz|6GHz] <1-100>

acs

Configures ACS settings and overrides on the selected meshpoint-device

snr-delta [2.4GHz|5GHz|6GHz] <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

  • 6.0 GHz – Configures the snr-delta for the 6.0 GHz radio band

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

  • <1-100> – Specify a value from 1 - 100 dB. The default is 5 dB.

 
acs snr-threshold [2.4GHz|5GHz|6GHz] <-100-0>

acs

Configures ACS settings and overrides on the selected meshpoint-device

snr-threshold [2.4GHz|5GHz|6GHz] <-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

  • 6.0 GHz – Configures the snr-threshold for the 6.0 GHz radio band

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

  • <-100-0> – Specify a value from -100 - 0 dB. The default is -65 dB.

 
acs tolerance-period [2.4GHz|5GHz|6GHz] <10-600>

acs

Configures ACS settings and overrides on the selected meshpoint-device

tolerance-period [2.4GHz|5GHz|6GHz] <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

  • 6.0 GHz – Configures the tolerance-period for the 6.0 GHz radio band

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

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

Examples

rfs4000-229D58(config-profile-testAP71XX-meshpoint-test)#acs channel-hold-time 2.4GHz 2500
rfs4000-229D58(config-profile-testAP71XX-meshpoint-test)#acs ocs-duration 2.4GHz 30
rfs4000-229D58(config-profile-testAP71XX-meshpoint-test)#acs ocs-frequency 2.4GHz 1
rfs4000-229D58(config-profile-testAP71XX-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
rfs4000-229D58(config-profile-testAP71XX-meshpoint-test)#

Related Commands

no (meshpoint-device-config)

Reverts the configured ACS settings to default
9037762-02 Rev AA