NetWiFiMgr_AP_Scan()

The Wireless Manager’s AP_Scan() function start the scan process. Results are passed back to the caller in a table of NET_IF_WIFI_AP structure which contains fields for link network SSID, channel, network type, Security type and signal strength.

Files

Every Wireless Manager layer net_wifi_mgr.c

Prototype

          static void NetWiFiMgr_AP_Scan       (NET_IF           *p_if,
                                                NET_IF_WIFI_AP   *p_buf_scan,
                                                CPU_INT16U        scna_len_max,
                                          const NET_IF_WIFI_SSID *p_ssid,
                                                NET_IF_WIFI_CH    ch,
                                                NET_ERR          *perr);

Note that since every Wireless Manager’s AP_Scan() function is accessed only by function pointer via the Wireless Manager’s API structure, it doesn’t need to be globally available and should therefore be declared as ‘static’.

Arguments

p_if

Pointer to the interface to scan with.

p_buf_scan

Pointer to table that will receive the return network found.

scan_len_max

Length of the scan buffer (i.e., number of network that can be found).

p_ssid

Pointer to variable that contains the SSID to find.

ch

The wireless channel to scan:

NET_IF_WIFI_CH_ALL
NET_IF_WIFI_CH_1
NET_IF_WIFI_CH_2
NET_IF_WIFI_CH_3
NET_IF_WIFI_CH_4
NET_IF_WIFI_CH_5
NET_IF_WIFI_CH_6
NET_IF_WIFI_CH_7
NET_IF_WIFI_CH_8
NET_IF_WIFI_CH_9
NET_IF_WIFI_CH_10
NET_IF_WIFI_CH_11
NET_IF_WIFI_CH_12
NET_IF_WIFI_CH_13
NET_IF_WIFI_CH_14

perr

Pointer to variable that will receive the return error code from this function.

Returned Values

None.

Required Configuration

None.

Notes/Warnings

None.