set_radio_min_rssi
set_radio_min_rssi
Section titled “set_radio_min_rssi”Enable, tune, or disable minimum RSSI on one radio of an AP.
Side effects:
- With min-RSSI enabled, the AP kicks clients whose signal drops below the threshold, forcing them to roam to a closer AP. A threshold set too aggressive (e.g. -60) causes disconnect loops for legitimately distant clients.
- Only the targeted radio changes; everything else on the device is read first and written back unchanged.
- Mutates controller state. Use dry_run=True to preview the change (including the current value) without applying.
Read first: call get_device_radios to see the current state.
Typical sticky-client thresholds are -75 to -70 dBm.
Example
Section titled “Example”set_radio_min_rssi(device_mac="aa:bb:cc:00:00:02", band="5g", enabled=True, rssi_dbm=-75)Parameters
Section titled “Parameters”| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
device_mac | string | yes | — | AP MAC address (from list_devices). |
band | string | yes | — | "2g", "5g", or "6g" (raw UniFi ids ng, na, 6e also accepted). |
enabled | boolean | yes | — | True enforces the threshold; False turns min-RSSI off for this radio. |
rssi_dbm | integer | no | 0 | Threshold in dBm (negative, e.g. -75). Required when enabled=True. |
controller | string | no | ”default” | Name of the UniFi controller to target. Defaults to "default". |
dry_run | boolean | no | false | Preview the change without applying it. Returns the predicted change set. |