Wi-Fi advanced scan configuration options.

Indicates the configuration parameters for an advanced Wi-Fi scan operation.

Note

  • active_channel_time and passive_channel_time are applicable for foreground scan (station before connection).

  • If active_channel_time and passive_channel_time are not set or set to 0, default values are used. Default value of 100 milliseconds is used for active_channel_time when SL_WIFI_DEFAULT_ACTIVE_CHANNEL_SCAN_TIME is passed. Default value of 400 milliseconds is used for passive_channel_time when SL_WIFI_DEFAULT_PASSIVE_CHANNEL_SCAN_TIME is passed.

  • trigger_level and trigger_level_change are used for automatic roaming functionality. When connected to an AP:

    • If RSSI drops below trigger_level, a background scan is automatically initiated to find better APs for roaming

    • If RSSI drops by trigger_level_change delta from the previous measurement, a background scan is triggered

    • The background scan operates independently and helps facilitate seamless roaming to better APs when available

Public Attributes#

int32_t

RSSI threshold level to trigger background scan for roaming. When connected to an AP, if the RSSI drops below this level, a background scan is automatically triggered to find better APs for potential roaming.

uint32_t

RSSI delta change threshold to trigger background scan for roaming. If the current RSSI value drops by this delta amount from the previous measurement, a background scan is triggered to find better APs for potential roaming.

uint16_t

Time spent on each channel during active scan (milliseconds)

uint16_t

Time spent on each channel during passive scan (milliseconds)

uint8_t

Flag to start advanced scan immediately.

uint8_t

Flag to send multiple probes to AP. If the value is set to 1, a probe request would be sent to all access points in addition to the connected SSID.

Public Attribute Documentation#

trigger_level#

int32_t sl_wifi_advanced_scan_configuration_t::trigger_level

RSSI threshold level to trigger background scan for roaming. When connected to an AP, if the RSSI drops below this level, a background scan is automatically triggered to find better APs for potential roaming.


trigger_level_change#

uint32_t sl_wifi_advanced_scan_configuration_t::trigger_level_change

RSSI delta change threshold to trigger background scan for roaming. If the current RSSI value drops by this delta amount from the previous measurement, a background scan is triggered to find better APs for potential roaming.


active_channel_time#

uint16_t sl_wifi_advanced_scan_configuration_t::active_channel_time

Time spent on each channel during active scan (milliseconds)


passive_channel_time#

uint16_t sl_wifi_advanced_scan_configuration_t::passive_channel_time

Time spent on each channel during passive scan (milliseconds)


enable_instant_scan#

uint8_t sl_wifi_advanced_scan_configuration_t::enable_instant_scan

Flag to start advanced scan immediately.


enable_multi_probe#

uint8_t sl_wifi_advanced_scan_configuration_t::enable_multi_probe

Flag to send multiple probes to AP. If the value is set to 1, a probe request would be sent to all access points in addition to the connected SSID.