一、概述

Wi-Fi 庫支持配置及監(jiān)控 ESP32 Wi-Fi 連網(wǎng)功能。

支持配置：

• 基站模式（即 STA 模式或 Wi-Fi 客戶端模式），此時(shí) ESP32 連接到接入點(diǎn) (AP)。

  
  

  

• AP 模式（即 Soft-AP 模式或接入點(diǎn)模式），此時(shí)基站連接到 ESP32。

  
  

  

• AP-STA 共存模式（ESP32 既是接入點(diǎn)，同時(shí)又作為基站連接到另外一個(gè)接入點(diǎn)）。

• 上述模式的各種安全模式（WPA、WPA2 及 WEP 等）。

• 掃描接入點(diǎn)（包括主動(dòng)掃描及被動(dòng)掃描）。

• 使用混雜模式監(jiān)控 IEEE802.11 Wi-Fi 數(shù)據(jù)包。

ESP-IDF 編程指南——Wi-Fi

二、API說明

以下 WIFI 接口位于 esp_wifi/include/esp_wifi.h。

2.1 esp_wifi_init

2.2 esp_wifi_set_mode

2.3 esp_wifi_get_mode

2.4 esp_wifi_start

2.5 esp_wifi_connect

2.6 esp_wifi_disconnect

2.7 esp_wifi_scan_start

2.8 esp_wifi_get_mac

2.9 esp_wifi_set_config

2.10 esp_wifi_get_config

三、AP模式

3.1 一般場(chǎng)景

3.2 Wi-Fi/LwIP初始階段

如上圖中 1.11.21.31.4 所示，分別

初始化LwIP

創(chuàng)建LwIP核心任務(wù)并初始化與LwIP相關(guān)的工作。

ESP_ERROR_CHECK(esp_netif_init());

初始化Wi-Fi事件處理

Wi-Fi事件處理基于esp_event庫。Wi-Fi驅(qū)動(dòng)程序會(huì)將事件發(fā)送到默認(rèn)事件循環(huán)。應(yīng)用程序可以在使用進(jìn)行注冊(cè)的回調(diào)中處理這些事件esp_event_handler_register()。esp_netif組件還處理Wi-Fi事件，以提供一組默認(rèn)行為。例如，當(dāng)Wi-Fi站連接到AP時(shí)，esp_netif將自動(dòng)啟動(dòng)DHCP客戶端（默認(rèn)情況下）。

// 創(chuàng)建系統(tǒng)事件任務(wù)并初始化應(yīng)用程序事件的回調(diào)函數(shù)。ESP_ERROR_CHECK(esp_event_loop_create_default());// 創(chuàng)建具有TCP / IP堆棧的默認(rèn)網(wǎng)絡(luò)接口實(shí)例綁定AP。esp_netif_create_default_wifi_ap();ESP_ERROR_CHECK(esp_event_handler_instance_register(WIFI_EVENT,

                                                    ESP_EVENT_ANY_ID,

                                                    &wifi_event_handler,

                                                    NULL,

                                                    NULL));

初始化Wi-Fi

wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();ESP_ERROR_CHECK(esp_wifi_init(&cfg));

3.3 Wi-Fi配置階段

wifi_config_t wifi_config = {

        .ap = {

            .ssid = EXAMPLE_ESP_WIFI_SSID,

            .ssid_len = strlen(EXAMPLE_ESP_WIFI_SSID),

            .channel = EXAMPLE_ESP_WIFI_CHANNEL,

            .password = EXAMPLE_ESP_WIFI_PASS,

            .max_connection = EXAMPLE_MAX_STA_CONN,

            .authmode = WIFI_AUTH_WPA_WPA2_PSK        },

    };

    if (strlen(EXAMPLE_ESP_WIFI_PASS) == 0) {

        wifi_config.ap.authmode = WIFI_AUTH_OPEN;

    }

    ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_AP));

    ESP_ERROR_CHECK(esp_wifi_set_config(ESP_IF_WIFI_AP, &wifi_config));

3.4 Wi-Fi啟動(dòng)階段

ESP_ERROR_CHECK(esp_wifi_start());

3.5 Wi-Fi連接階段

當(dāng)有終端接入或斷開連接時(shí)，產(chǎn)生 WIFI_EVENT_AP_STACONNECTED 或 WIFI_EVENT_AP_STADISCONNECTED 事件。

static void wifi_event_handler(void* arg, esp_event_base_t event_base,

                                    int32_t event_id, void* event_data){

    if (event_id == WIFI_EVENT_AP_STACONNECTED) {

        wifi_event_ap_staconnected_t* event = (wifi_event_ap_staconnected_t*) event_data;

        ESP_LOGI(TAG, 'station 'MACSTR' join, AID=%d',

                 MAC2STR(event->mac), event->aid);

    } else if (event_id == WIFI_EVENT_AP_STADISCONNECTED) {

        wifi_event_ap_stadisconnected_t* event = (wifi_event_ap_stadisconnected_t*) event_data;

        ESP_LOGI(TAG, 'station 'MACSTR' leave, AID=%d',

                 MAC2STR(event->mac), event->aid);

    }}

3.6 完整代碼

/*  WiFi softAP Example

   This example code is in the Public Domain (or CC0 licensed, at your option.)

   Unless required by applicable law or agreed to in writing, this

   software is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES OR

   CONDITIONS OF ANY KIND, either express or implied.

*/#include #include 'freertos/FreeRTOS.h'#include 'freertos/task.h'#include 'esp_system.h'#include 'esp_wifi.h'#include 'esp_event.h'#include 'esp_log.h'#include 'nvs_flash.h'#include 'lwip/err.h'#include 'lwip/sys.h'/* The examples use WiFi configuration that you can set via project configuration menu.

   If you'd rather not, just change the below entries to strings with

   the config you want - ie #define EXAMPLE_WIFI_SSID 'mywifissid'

*/#define EXAMPLE_ESP_WIFI_SSID      CONFIG_ESP_WIFI_SSID#define EXAMPLE_ESP_WIFI_PASS      CONFIG_ESP_WIFI_PASSWORD#define EXAMPLE_ESP_WIFI_CHANNEL   CONFIG_ESP_WIFI_CHANNEL#define EXAMPLE_MAX_STA_CONN       CONFIG_ESP_MAX_STA_CONNstatic const char *TAG = 'wifi softAP';static void wifi_event_handler(void* arg, esp_event_base_t event_base,

                                    int32_t event_id, void* event_data){

    if (event_id == WIFI_EVENT_AP_STACONNECTED) {

        wifi_event_ap_staconnected_t* event = (wifi_event_ap_staconnected_t*) event_data;

        ESP_LOGI(TAG, 'station 'MACSTR' join, AID=%d',

                 MAC2STR(event->mac), event->aid);

    } else if (event_id == WIFI_EVENT_AP_STADISCONNECTED) {

        wifi_event_ap_stadisconnected_t* event = (wifi_event_ap_stadisconnected_t*) event_data;

        ESP_LOGI(TAG, 'station 'MACSTR' leave, AID=%d',

                 MAC2STR(event->mac), event->aid);

    }}void wifi_init_softap(void){

    ESP_ERROR_CHECK(esp_netif_init());

    ESP_ERROR_CHECK(esp_event_loop_create_default());

    esp_netif_create_default_wifi_ap();

    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();

    ESP_ERROR_CHECK(esp_wifi_init(&cfg));

    ESP_ERROR_CHECK(esp_event_handler_instance_register(WIFI_EVENT,

                                                        ESP_EVENT_ANY_ID,

                                                        &wifi_event_handler,

                                                        NULL,

                                                        NULL));

    wifi_config_t wifi_config = {

        .ap = {

            .ssid = EXAMPLE_ESP_WIFI_SSID,

            .ssid_len = strlen(EXAMPLE_ESP_WIFI_SSID),

            .channel = EXAMPLE_ESP_WIFI_CHANNEL,

            .password = EXAMPLE_ESP_WIFI_PASS,

            .max_connection = EXAMPLE_MAX_STA_CONN,

            .authmode = WIFI_AUTH_WPA_WPA2_PSK        },

    };

    if (strlen(EXAMPLE_ESP_WIFI_PASS) == 0) {

        wifi_config.ap.authmode = WIFI_AUTH_OPEN;

    }

    ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_AP));

    ESP_ERROR_CHECK(esp_wifi_set_config(ESP_IF_WIFI_AP, &wifi_config));

    ESP_ERROR_CHECK(esp_wifi_start());

    ESP_LOGI(TAG, 'wifi_init_softap finished. SSID:%s password:%s channel:%d',

             EXAMPLE_ESP_WIFI_SSID, EXAMPLE_ESP_WIFI_PASS, EXAMPLE_ESP_WIFI_CHANNEL);}void app_main(void){

    //Initialize NVS

    esp_err_t ret = nvs_flash_init();

    if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) {

      ESP_ERROR_CHECK(nvs_flash_erase());

      ret = nvs_flash_init();

    }

    ESP_ERROR_CHECK(ret);

    ESP_LOGI(TAG, 'ESP_WIFI_MODE_AP');

    wifi_init_softap();}

四、STA模式

4.1 一般場(chǎng)景

4.2 Wi-Fi/LwIP初始階段

如上圖中 1.11.21.31.4 所示，分別

初始化LwIP

創(chuàng)建LwIP核心任務(wù)并初始化與LwIP相關(guān)的工作。

ESP_ERROR_CHECK(esp_netif_init());

初始化Wi-Fi事件處理

Wi-Fi事件處理基于esp_event庫。Wi-Fi驅(qū)動(dòng)程序會(huì)將事件發(fā)送到默認(rèn)事件循環(huán)。應(yīng)用程序可以在使用進(jìn)行注冊(cè)的回調(diào)中處理這些事件esp_event_handler_register()。esp_netif組件還處理Wi-Fi事件，以提供一組默認(rèn)行為。例如，當(dāng)Wi-Fi站連接到AP時(shí)，esp_netif將自動(dòng)啟動(dòng)DHCP客戶端（默認(rèn)情況下）。

// 創(chuàng)建系統(tǒng)事件任務(wù)并初始化應(yīng)用程序事件的回調(diào)函數(shù)。ESP_ERROR_CHECK(esp_event_loop_create_default());// 創(chuàng)建具有TCP / IP堆棧的默認(rèn)網(wǎng)絡(luò)接口實(shí)例綁定基站。esp_netif_create_default_wifi_sta();esp_event_handler_instance_t instance_any_id;esp_event_handler_instance_t instance_got_ip;ESP_ERROR_CHECK(esp_event_handler_instance_register(WIFI_EVENT,

                                                    ESP_EVENT_ANY_ID,

                                                    &event_handler,

                                                    NULL,

                                                    &instance_any_id));ESP_ERROR_CHECK(esp_event_handler_instance_register(IP_EVENT,