一、快速運(yùn)行

• 示例項(xiàng)目中，選擇WiFi—>scan
• menuconfig配置ESP32C3-Specific—>Rec 0
• 芯片選擇ESP32-C3(Built-in USB JTAG)
• 快速運(yùn)行ESP-IDF Build, Flash and Monitor（左下角）

二、運(yùn)行效果

三、程序流程

• nvs_flash_init，初始化默認(rèn) NVS 分區(qū)。
• esp_netif_init，初始化底層TCP/IP堆棧
• esp_event_loop_create_default，創(chuàng)建默認(rèn)事件循環(huán)。
• esp_netif_create_default_wifi_sta，使用默認(rèn)WiFi Station配置創(chuàng)建esp_netif對(duì)象，將netif連接到WiFi并注冊(cè)默認(rèn)WiFi處理程序。
• esp_wifi_init，為 WiFi 驅(qū)動(dòng)初始化 WiFi 分配資源，如 WiFi 控制結(jié)構(gòu)、RX/TX 緩沖區(qū)、WiFi NVS 結(jié)構(gòu)等，這個(gè) WiFi 也啟動(dòng) WiFi 任務(wù)。必須先調(diào)用此API，然后才能調(diào)用所有其他WiFi API
• esp_wifi_set_mode，設(shè)置WiFi工作模式為station、soft-AP或station+soft-AP，默認(rèn)模式為soft-AP模式。本程序設(shè)置為station
• esp_wifi_start，根據(jù)配置，啟動(dòng)WiFi
• esp_wifi_scan_start，掃描所有有效的AP
• esp_wifi_scan_get_ap_records，獲取上次掃描中找到的AP列表
• esp_wifi_scan_get_ap_num，獲取上次掃描中找到的AP數(shù)

四、關(guān)鍵函數(shù)

4.1 掃描所有有效的AP

• config，掃描的配置
• block，是否堵塞程序運(yùn)行

/**  * @brief     Scan all available APs.  *  * @attention If this API is called, the found APs are stored in WiFi driver dynamic allocated memory and the  *            will be freed in esp_wifi_scan_get_ap_records, so generally, call esp_wifi_scan_get_ap_records to cause  *            the memory to be freed once the scan is done  * @attention The values of maximum active scan time and passive scan time per channel are limited to 1500 milliseconds.  *            Values above 1500ms may cause station to disconnect from AP and are not recommended.  *  * @param     config  configuration of scanning  * @param     block if block is true, this API will block the caller until the scan is done, otherwise  *                         it will return immediately  *  * @return  *    - ESP_OK: succeed  *    - ESP_ERR_WIFI_NOT_INIT: WiFi is not initialized by esp_wifi_init  *    - ESP_ERR_WIFI_NOT_STARTED: WiFi was not started by esp_wifi_start  *    - ESP_ERR_WIFI_TIMEOUT: blocking scan is timeout  *    - ESP_ERR_WIFI_STATE: wifi still connecting when invoke esp_wifi_scan_start  *    - others: refer to error code in esp_err.h  */esp_err_t esp_wifi_scan_start(const wifi_scan_config_t *config, bool block);

4.2 獲取上次掃描中找到的AP列表

• number，返回的最大ap個(gè)數(shù)
• ap_records，返回的app記錄數(shù)組

/**  * @brief     Get AP list found in last scan  *  * @param[inout]  number As input param, it stores max AP number ap_records can hold.  *                As output param, it receives the actual AP number this API returns.  * @param         ap_records  wifi_ap_record_t array to hold the found APs  *  * @return  *    - ESP_OK: succeed  *    - ESP_ERR_WIFI_NOT_INIT: WiFi is not initialized by esp_wifi_init  *    - ESP_ERR_WIFI_NOT_STARTED: WiFi is not started by esp_wifi_start  *    - ESP_ERR_INVALID_ARG: invalid argument  *    - ESP_ERR_NO_MEM: out of memory  */esp_err_t esp_wifi_scan_get_ap_records(uint16_t *number, wifi_ap_record_t *ap_records);

4.3 獲取上次掃描中找到的AP數(shù)

• number，存儲(chǔ)上次掃描中找到的API數(shù)

/**  * @brief     Get number of APs found in last scan  *  * @param[out] number  store number of APs found in last scan  *  * @attention This API can only be called when the scan is completed, otherwise it may get wrong value.  *  * @return  *    - ESP_OK: succeed  *    - ESP_ERR_WIFI_NOT_INIT: WiFi is not initialized by esp_wifi_init  *    - ESP_ERR_WIFI_NOT_STARTED: WiFi is not started by esp_wifi_start  *    - ESP_ERR_INVALID_ARG: invalid argument  */esp_err_t esp_wifi_scan_get_ap_num(uint16_t *number);

覺得好，就一鍵三連唄（點(diǎn)贊+收藏+關(guān)注）