前面的8节基础课算是把 ESP32-C3 的外设和一些基本功能都测试过， 接下来就要进行无线协议 WIFI 和 蓝牙的功能测试。这节课我们就从 WIFI 开始，了解 ESP32-C3 的WIFI 功能。
复制代码
前言
学习 ESP32-C3 的 WIFI 库 使用，不要用到其他外设。
测试使用的开发板：
自己画一块 ESP32-C3 的开发板（第一次使用立创 EDA）（PCB 到手）
https://xie.infoq.cn/article/30387388381a0d915b2494f91
测试使用的开发环境：
ESP32-C3 VScode 开发环境搭建（基于乐鑫官方 ESP-IDF——Windows 和 Ubuntu 双环境）
https://xie.infoq.cn/article/5b639e112cabba00cc1b8941a
1、ESP32-C3 WiFi 基本介绍
1.1 基本介绍
对于 ESP32-C3 WiFi 库的介绍，乐鑫的官网的说明链接如下：
乐鑫官方ESP32-C3 WiFi库 API 说明
官方这里介绍的篇幅很少，依然使用官方的图简单介绍：
详细的的 API 的解释，意义，自行在官网查看。
除了基本的 WiFI 库，还有一个需要了解的 Wi-Fi 驱动程序：
官方 Wi-Fi 驱动程序说明
1.2 ESP-NETIF
<font color=#0033FF> 什么是 ESP-NETIF？为什么介绍 WiFi 要介绍 ESP-NETIF ?</font>
乐鑫的官网的说明链接如下：ESP-NETIF官方说明文档
ESP-NETIF 是官方提供的操作 TCP/IP 协议栈的 API，是在 LwIP (轻量级 TCP/IP 网络协议栈)之上封装的一层供应用程序访问协议栈的便携的接口。
ESP32-C3 WiFi 是一个独立的硬件，在使用 WiFi 前需要进行初始化。初始化的时候需要用到 WiFi 驱动库esp_wifi.h（初始化 WiFi 硬件），网络接口esp_netif.h （初始化 LwIP TCP/IP 协议栈）。ESP-NETIF 组件能够处理 Wi-Fi 事件，以提供一组默认行为。例如，当 Wi-Fi 站连接到 AP 时，ESP-NETIF 将自动启动 DHCP 客户端。
如下图，USER CODE 调用 ESP-NETIF 中的 API 接口初始化 TCP/IP 协议栈，之后调用 esp_wifi 中的 API 接口初始化 wifi 硬件，然后就能进入数据的收发过程。
我们这里只是简单的了解了一下 ESP-NETIF 是什么，为了我们能够理解下面介绍的 WiFi 的使用步骤，具体的内部实现暂时不做深究。
1.3 WiFi 事件的注册、响应、信息获取
WiFi 的使用中有各种事件，连接成功、连接失败、得到 IP 等等，这些事件处理都是基于esp_event库。WiFi 驱动程序会将事件发送到默认事件循环。应用程序可以在使用进行注册的回调中处理这些事件event_handler()。
Wi-Fi 的事件描述请参考上面说到 的官方 Wi-Fi 驱动程序介绍部分：
首先调用esp_event_loop_create_default() 创建默认事件循环。
之后使用esp_event_handler_register /esp_event_handler_instance_register将事件处理程序注册到系统事件循环:
ESP_ERROR_CHECK(esp_event_loop_create_default());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, IP_EVENT_STA_GOT_IP, &event_handler, NULL, &instance_got_ip));
复制代码
额外提一下，esp_event_handler_register /esp_event_handler_instance_register 都是使用的esp_event_handler_register_with_internal
下面用源码注释说明一下esp_event_handler_instance_register各个参数的意义：
/*event_base类型为：esp_event_base_t；表示 事件基，代表事件的大类（如WiFi事件，IP事件等）event_id类型为：int32_t；表示事件ID，即事件基下的一个具体事件（如WiFi连接丢失，IP成功获取）event_handler：回调函数*event_handler_arg类型为：void；表示需要传递给handler函数的参数*instance类型为：esp_event_handler_instance_t指针；**[输出]**表示此函数注册的事件实例对象，用于生命周期管理（如删除unrigister这个事件handler）*/esp_err_t esp_event_handler_instance_register(esp_event_base_t event_base, int32_t event_id, esp_event_handler_t event_handler, void *event_handler_arg, esp_event_handler_instance_t *context)
/*举例：IP事件事件为 IP_EVENT_STA_GOT_IP回调函数为 event_handler没有参数esp_event_handler_instance_t指针，为了后面unregister instance_got_ip*/ESP_ERROR_CHECK(esp_event_handler_instance_register(IP_EVENT, IP_EVENT_STA_GOT_IP, &event_handler, NULL, &instance_got_ip)); /*删除注册*/ESP_ERROR_CHECK(esp_event_handler_instance_unregister(IP_EVENT, IP_EVENT_STA_GOT_IP, instance_got_ip));
复制代码
事件回调函数：
在上面事件注册后，会有一个回调函数，我们需要去实现这个回调函数，其有 4 个参数，示意如下代码注释：
/*参数一：arg。表示传递给event_handler函数的参数参数二，eventBase，表示事件基参数三：event_id，表示事件ID参数四，表示传递给这个事件的数据*/static void event_handler(void* arg, esp_event_base_t event_base, int32_t event_id, void* event_data)
复制代码
回调函数举个例子：
static void event_handler(void* arg, esp_event_base_t event_base, int32_t event_id, void* event_data){ ESP_LOGI(TAG,"event_base:%s， event_id：%d\r\n",event_base, event_id); wifi_event_ap_staconnected_t *wifi_event_data; if (event_base == WIFI_EVENT){ switch (event_id) { case WIFI_EVENT_STA_START: //STA模式启动 /* code */ break; case WIFI_EVENT_STA_STOP: //STA模式关闭 /* code */ break; case WIFI_EVENT_STA_DISCONNECTED: //STA模式断开连接 /* code */ break; case WIFI_EVENT_AP_START: //AP模式启动 /* code */ break; case WIFI_EVENT_AP_STOP: //AP模式关闭 /* code */ break; case WIFI_EVENT_AP_STACONNECTED: //一台设备连接到esp32 wifi_event_ap_staconnected_t *AP_STACONNECTED_EVENT_DATA = (wifi_event_ap_staconnected_t *)event_data; //获取事件信息 ESP_LOGI(TAG, "station:" MACSTR " join, AID=%d", MAC2STR(AP_STACONNECTED_EVENT_DATA->mac), AP_STACONNECTED_EVENT_DATA->aid); break; case WIFI_EVENT_AP_STADISCONNECTED: //一台设备断开与esp32的连接 wifi_event_ap_stadisconnected_t *AP_STADISCONNECTED_EVENT_DATA = (wifi_event_ap_stadisconnected_t *)event_data; //获取事件信息 ESP_LOGI(TAG, "station:" MACSTR "leave, AID=%d", MAC2STR(AP_STADISCONNECTED_EVENT_DATA->mac), AP_STADISCONNECTED_EVENT_DATA->aid); break; default: break; } }else if(event_base == IP_EVENT){ switch (event_id) { case IP_EVENT_STA_GOT_IP: //esp32从路由器获取到ip /* code */ break; case IP_EVENT_STA_LOST_IP: //esp32失去ip /* code */ break; case IP_EVENT_AP_STAIPASSIGNED: //esp32给设备分配了ip /* code */ break; default: break; } }
复制代码
1.4 WiFi 初始化启动步骤
WiFi 配置初始化的步骤，用官方的两张图表示：
STA 模式：
AP 模式：
下面通过示例再一次说明一下上面图示的使用步骤：
1、初始化 NVS，使用函数nvs_flash_init：
在示例中（以 STA 模式示例举例）：
2、初始化 ESP-NETIF，使用esp_netif_init()：
在示例中：
3、调用esp_event_loop_create_default() 创建默认事件循环。之后使用esp_event_handler_register() 将事件处理程序注册到系统事件循环，详情见上一小节 1.3 WiFi 事件的注册、响应、信息获取 部分。
在示例中：
4、初始化 WiFi 和 配置 WiFi
使用esp_wifi_init进行 WiFi 初始化。
在示例中，先是使用了默认配置进行 WiFi 初始化，如下：
初始化后，用户可以根据自己的需要使用esp_wifi_set_config(WIFI_IF_STA, &wifi_config) 进行必要的配置，在联合体 wifi_config_t wifi_config中定义对应的参数：
在示例中的配置如下：
5、 启动 WiFi
使用esp_wifi_start启动 WiFi。
Wi-Fi 驱动程序将 WIFI_EVENT_STA_START 发布到事件任务；然后，事件任务将执行一些常规操作，并将调用应用程序事件回调函数。
应用程序事件回调函数将WIFI_EVENT_STA_START中继到应用程序任务。此时调用esp_wifi_connect()。
在示例中：
6、实现事件回调函数
回调函数，在上面 1.3 小节有说明，在示例中：
<font color=#0033FF> 在一般情况下，上述步骤完成 WiFi 便可以正常连接工作，在一些环境恶劣场合出现一些连接不稳定等复杂问题，需要根据不同情况不同处理，比如连接超时，意外断开，在设计的时候都需要考虑到，一般的说明在官方都有文档说明</font>
比如：
<font color=#0033FF> 总而言之，遇到问题还是先把官方相关的文档看完再寻找问题！</font>
2、示例测试
在官方例程中，我们测试的示例的程序如下图：
2.1 WiFi STA 模式
STA 模式，ESP32-C3 连接到其他设备的热点。
WiFISTA 模式一般流程请参阅上面 1.4 WiFi 初始化启动步骤，示例需要修改的地方只有一个，就是把 SSID 和 PASS 改成自己环境中可以连接的 WiFi 信息：
测试结果如下图：
2.2 WiFi AP 模式
AP 模式，ESP32-C3 产生热点供其他设备连接。
WiFI AP 模式一般流程请参阅上面 1.4 WiFi 初始化启动步骤， AP 模式于 STA 模式的步骤大体上是一致的，只是在配置 联合体 wifi_config_t中使用的是 wifi_ap_config_t 结构体：
然后把宏定义的 SSID 和 PASS 改成自己想要设置的 wifi 名称和密码：
<font color=#FF0033> 注意一个问题，就是密码的长度必须大于 8，否则会出现下图的报错：</font>
按照上面的说明设置好以后，可以用手机尝试连接 ESP32-C3 的热点，测试效果如下图：
2.3 WiFi AP-STA 共存模式
WiFi AP-STA 共存模式，官方好像没有直接的示例代码，我这里是在 AP 模式的基础之上，自己参考一些资料进行修改，这里直接上源码（路由器 SSID 和 密码 在下面源码中我用的 ****** 表示，如果需要拷贝进行测试，记得修改）：
/* 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 <string.h>#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 "JCSZ_ESP32_WIFI"#define EXAMPLE_ESP_WIFI_PASS "123454321"
#define EXAMPLE_ESP_WIFI_CHANNEL CONFIG_ESP_WIFI_CHANNEL#define EXAMPLE_MAX_STA_CONN CONFIG_ESP_MAX_STA_CONN
#define ESP_WIFI_STA_SSID "******"#define ESP_WIFI_STA_PASS "******"
static const char *TAG = "wifi AP_STA";
/*重新连接热点*/void WIFI_EVENT_STA_DISCONNECTED_FUN(void){ esp_wifi_connect();//连接热点 ESP_LOGI(TAG,"connect to the AP fail");}
/*有设备连接上ESP32的热点*/void WIFI_EVENT_AP_STACONNECTED_FUN( void* event_data ){ wifi_event_ap_staconnected_t* event = (wifi_event_ap_staconnected_t*) event_data; /*打印连接设备的MAC地址*/ ESP_LOGI(TAG, "station "MACSTR" join, AID=%d", MAC2STR(event->mac), event->aid);}
/*有设备断开和ESP32的热点*/void WIFI_EVENT_AP_STADISCONNECTED_FUN( void* event_data ){ wifi_event_ap_stadisconnected_t* event = (wifi_event_ap_stadisconnected_t*) event_data; /*打印断开设备的MAC地址*/ ESP_LOGI(TAG, "station "MACSTR" leave, AID=%d",MAC2STR(event->mac), event->aid);}
/*连接上路由器(获取到了分配的IP地址)*/void IP_EVENT_STA_GOT_IP_FUN( void* event_data ){ ip_event_got_ip_t* event = (ip_event_got_ip_t*) event_data; ESP_LOGI(TAG, "got ip:" IPSTR, IP2STR(&event->ip_info.ip)); ESP_LOGI(TAG, "connected to ap SSID:%s password:%s",ESP_WIFI_STA_SSID, ESP_WIFI_STA_PASS);}
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); // } if( event_base == WIFI_EVENT ) { switch ( event_id ) { case WIFI_EVENT_STA_START: esp_wifi_connect(); break; // STA START case WIFI_EVENT_STA_STOP: // ESP_LOGI(TAG,"WIFI_EVENT_STA_STOP"); break; // STA STOP case WIFI_EVENT_STA_DISCONNECTED: WIFI_EVENT_STA_DISCONNECTED_FUN(); break; //和路由器断开 case WIFI_EVENT_AP_START: // ESP_LOGI(TAG,"WIFI_EVENT_AP_START"); break; // AP START case WIFI_EVENT_AP_STOP: // ESP_LOGI(TAG,"WIFI_EVENT_AP_STOP"); break; // AP STOP case WIFI_EVENT_AP_STACONNECTED: //有设备连接上ESP32的热点 WIFI_EVENT_AP_STACONNECTED_FUN( event_data ); break; case WIFI_EVENT_AP_STADISCONNECTED: //有设备断开和ESP32的热点 WIFI_EVENT_AP_STADISCONNECTED_FUN(event_data ); break; default: break; } } else if( event_base == IP_EVENT ) // 路由事件ID 组 { switch ( event_id ) { case IP_EVENT_STA_GOT_IP: IP_EVENT_STA_GOT_IP_FUN(event_data); break; //获取到指定IP case IP_EVENT_STA_LOST_IP: // ESP_LOGI(TAG,"IP_EVENT_STA_LOST_IP"); break; case IP_EVENT_AP_STAIPASSIGNED: // ESP_LOGI(TAG,"IP_EVENT_AP_STAIPASSIGNED"); break; default: break; } }}
void wifi_init_softap_sta(void){ ESP_ERROR_CHECK(esp_netif_init()); ESP_ERROR_CHECK(esp_event_loop_create_default());
esp_netif_create_default_wifi_ap(); esp_netif_create_default_wifi_sta();//创建有 TCP/IP 堆栈的默认网络接口实例绑定STA。;
wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT(); ESP_ERROR_CHECK(esp_wifi_init(&cfg));
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, &wifi_event_handler, NULL, &instance_any_id)); ESP_ERROR_CHECK(esp_event_handler_instance_register(IP_EVENT, IP_EVENT_STA_GOT_IP, &wifi_event_handler, NULL, &instance_got_ip));
// ESP_ERROR_CHECK(esp_event_handler_instance_register(WIFI_EVENT, // ESP_EVENT_ANY_ID, // &wifi_event_handler, // NULL, // NULL));
wifi_config_t wifi_config_sta = { .sta = { .ssid = ESP_WIFI_STA_SSID, .password = ESP_WIFI_STA_PASS, /* Setting a password implies station will connect to all security modes including WEP/WPA. * However these modes are deprecated and not advisable to be used. Incase your Access point * doesn't support WPA2, these mode can be enabled by commenting below line */ .threshold.authmode = WIFI_AUTH_WPA2_PSK,
.pmf_cfg = { .capable = true, .required = false }, }, }; // strcpy( (char *) wifi_config_sta.sta.ssid , ESP_WIFI_STA_SSID ); if(strlen(ESP_WIFI_STA_PASS)==0)//没有密码 { wifi_config_sta.sta.threshold.authmode = WIFI_AUTH_OPEN;//加密方式 } else{ strcpy( (char *) wifi_config_sta.sta.password , ESP_WIFI_STA_PASS); }
wifi_config_t wifi_config_ap = { .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.ap.authmode = WIFI_AUTH_OPEN; }
ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_APSTA));
ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_AP, &wifi_config_ap));
ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_STA, &wifi_config_sta));
ESP_ERROR_CHECK(esp_wifi_start());
ESP_LOGI(TAG, "wifi_init_softap_sta 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_STA"); wifi_init_softap_sta();}
复制代码
测试结果如下：
<font color=#FF0033> 最后的问题，测试示例中的代码虽然是 STA 和 AP 共存模式，虽然作为 STA 连接的路由器能够连接互联网，但是 ESP32-C3 作为 AP 热点并不能连接互联网，还需要进行对应的设计， 使用 IP_NAPT 模式，后面用到再来补充说明。</font>
评论