nrfxlib API 0.1.0
Loading...
Searching...
No Matches

◆ nrf_wifi_fmac_scan()

enum nrf_wifi_status nrf_wifi_fmac_scan ( void *  fmac_dev_ctx,
unsigned char  if_idx,
struct nrf_wifi_umac_scan_info scan_info 
)

#include <nrf_wifi/fw_if/umac_if/inc/default/fmac_api.h>

Issue a scan request to the RPU firmware.

Parameters
fmac_dev_ctxPointer to the UMAC IF context for a RPU WLAN device.
if_idxIndex of the interface on which the scan is to be performed.
scan_infoThe parameters needed by the RPU for scan operation.

This function is used to send a command to: Instruct the RPU firmware to trigger a scan. The scan can be performed in two modes:

Auto Mode (AUTO_SCAN): In this mode, the host does not need to specify any scan specific parameters. The RPU firmware will perform the scan on all the channels permitted by and abiding by the regulations imposed by the WORLD (common denominator of all regulatory domains) regulatory domain. The scan will be performed using the wildcard SSID.

Channel Map Mode (CHANNEL_MAPPING_SCAN): In this mode the host can have fine grained control over the scan specific parameters to be used (for example, Passive/Active scan selection, Number of probe requests per active scan, Channel list to scan, Permanence on each channel, SSIDs to scan etc.). This mode expects the regulatory restrictions to be taken care by the invoker of the API.

Return values
NRF_WIFI_STATUS_SUCCESSOn success
NRF_WIFI_STATUS_FAILOn failure to execute command