![]() |
Morse Micro IoT SDK
2.13.1
|
Scan configuration data structure.
Use MMWLAN_SCAN_CONFIG_INIT for initialization. For example:
#include <mmwlan.h>
Data Fields | |
| uint32_t | dwell_time_ms |
| Set the per-channel dwell time to use for scans that are requested internally within the mmwlan driver (e.g., when connecting or background scanning). More... | |
| bool | ndp_probe_enabled |
| Boolean value indicating whether NDP probe support should be enabled. More... | |
| uint32_t | home_channel_dwell_time_ms |
| Set the home channel dwell time to use for scans that are requested internally within the mmwlan driver (e.g., when connecting or background scanning). More... | |
| uint8_t * | selected_channels |
| Optional list of S1G channel numbers to use for selective scans during the (re)connection sequence. More... | |
| uint8_t | selected_channels_len |
Length of selected_channels. More... | |
| uint8_t | selective_scan_attempts |
| Number of scans at the start of an association sequence that should be restricted to the channels configured via selected_channels. More... | |
| uint32_t mmwlan_scan_config::dwell_time_ms |
Set the per-channel dwell time to use for scans that are requested internally within the mmwlan driver (e.g., when connecting or background scanning).
| uint32_t mmwlan_scan_config::home_channel_dwell_time_ms |
Set the home channel dwell time to use for scans that are requested internally within the mmwlan driver (e.g., when connecting or background scanning).
| bool mmwlan_scan_config::ndp_probe_enabled |
Boolean value indicating whether NDP probe support should be enabled.
NDP probe requests are smaller than regular probe requests and will save energy when scanning.
| uint8_t* mmwlan_scan_config::selected_channels |
Optional list of S1G channel numbers to use for selective scans during the (re)connection sequence.
When set, the first selective_scan_attempts scans of an association attempt will be restricted to these channels, after which it falls back to scanning the full configured channel list.
If a channel is not present in the currently configured channel list, or that corresponds to a channel with bandwidth greater than 2 MHz, mmwlan_set_scan_config() will return an error.
A copy of the array is made internally; the caller may free it after the call returns. Set to NULL with selected_channels_len of zero to disable.
| uint8_t mmwlan_scan_config::selected_channels_len |
| uint8_t mmwlan_scan_config::selective_scan_attempts |
Number of scans at the start of an association sequence that should be restricted to the channels configured via selected_channels.
After this many attempts, scan falls back to scanning the full configured channel list. The counter resets when the STA leaves the connected state, so each reconnect attempt begins with another batch of selective scans.
Special values:
0 disables the feature (scans always use the full channel list).UINT8_MAX always uses the selected channel list, including for background and roam scans while connected.Has no effect unless selected_channels has also been set with a non-empty list.