band-steer balance gap-threshold

Function

The band-steer balance gap-threshold command sets the percentage threshold for access STAs on the 5 GHz radio.

The undo band-steer balance gap-threshold command restores the default percentage threshold for access STAs on the 5 GHz radio.

By default, the percentage threshold for access STAs on the 5 GHz radio is 90%.

Format

band-steer balance gap-threshold gap-threshold

undo band-steer balance gap-threshold

Parameters

Parameter	Description	Value
gap-threshold gap-threshold	Specifies the percentage threshold for access STAs on the 5 GHz radio.	The value is an integer that ranges from 1 to 100, in percentage.

Views

RRM profile view

Default Level

2: Configuration level

Usage Guidelines

On a multi-radio AP, if access STAs support multiple frequency bands, the band steering function configured using the undo band-steer disable command can preferentially steer STAs to the 5 GHz radio.

When a STA requests to connect to an AP radio, the AP enabled with band steering will collect statistics about access STAs on each radio.

If the number of access STAs on the AP does not exceed the start threshold, the STA can preferentially associate with the 5 GHz radio.
If the number of access STAs exceeds the value specified by the start threshold, the AP calculates the percentage of access STAs on the 5 GHz radio using the formula: (number of access STAs on the 5 GHz radio/total number of access STAs) x 100%. If the percentage exceeds the percentage threshold for access STAs on the 5 GHz radio configured using the band-steer balance gap-threshold command, the STA randomly selects a frequency band.

You are advised to retain the default values of the start and percentage thresholds for the number of STAs preferentially accessed on the 5 GHz radio. If the two thresholds are set low, the AP may allow STAs to freely select the access frequency band when only the number of STAs on the 5 GHz radio is small. As a result, the 5G-prior access mechanism does not take effect, and the 5 GHz band utilization cannot be maximized.

Example

# Set the load difference threshold to 85% in the RRM profile huawei.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] rrm-profile name huawei
[HUAWEI-wlan-rrm-prof-huawei] band-steer balance gap-threshold 85