基于VScode的ESP32开发学习（三）：官方例程Station,连接到wifi

已于 2022-04-20 10:06:13 修改
阅读量4.1k 收藏 24
点赞数 4
分类专栏： ESP32学习之路 文章标签： esp32 vscode wifi
于 2022-04-18 11:04:07 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Aspiration_H/article/details/124242187
版权

代码

#include <string.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "freertos/event_groups.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"

/* 
用idf.py menuconfig进入菜单配置
或者修改下述宏定义进而配置wifi ssid、密码
*/
#define EXAMPLE_ESP_WIFI_SSID      "胡警文粉丝团"
#define EXAMPLE_ESP_WIFI_PASS      "hjlhjw@123!"
#define EXAMPLE_ESP_MAXIMUM_RETRY  CONFIG_ESP_MAXIMUM_RETRY             //最大重试数

/*连接成功时，FreeRTOS事件组来传递信号*/
static EventGroupHandle_t s_wifi_event_group;

/* The event group allows multiple bits for each event, but we only care about two events:
 * - we are connected to the AP with an IP
 * - we failed to connect after the maximum amount of retries */
/*
事件组设有多个比特位来标志每个事件，但我们仅关心其中两个
1.连接到了AP且分配到了个ip
2.重连次数超过最大重试数，判定为连接失败
*/
#define WIFI_CONNECTED_BIT BIT0
#define WIFI_FAIL_BIT      BIT1

static const char *TAG = "wifi station";

static int s_retry_num = 0;                     //记录重连次数

static void event_handler(void* arg, esp_event_base_t event_base,               //事件处理函数
                                int32_t event_id, void* event_data)
{
    if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_START) {         //如果是wifi事件相关&&事件id==wifi STA模式开始，开始连接WiFi
        esp_wifi_connect();
    } 
    else if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_DISCONNECTED) {   //如果是wifi事件相关&&事件id==wifi STA模式连接失败
        if (s_retry_num < EXAMPLE_ESP_MAXIMUM_RETRY) {                  //如果重连次数<预设的最大重连次数
            esp_wifi_connect();
            s_retry_num++;
            ESP_LOGI(TAG, "retry to connect to the AP");
        } else {                                                        
            xEventGroupSetBits(s_wifi_event_group, WIFI_FAIL_BIT);      //置位wifi事件组的失败标志位,表示连接失败
        }
        ESP_LOGI(TAG,"connect to the AP fail");
    } 
    else if (event_base == IP_EVENT && event_id == IP_EVENT_STA_GOT_IP) {       //如果是ip事件相关&&事件id==已取得ip
        ip_event_got_ip_t* event = (ip_event_got_ip_t*) event_data;
        ESP_LOGI(TAG, "got ip:" IPSTR, IP2STR(&event->ip_info.ip));             //串口打印ip
        s_retry_num = 0;
        xEventGroupSetBits(s_wifi_event_group, WIFI_CONNECTED_BIT);
    }
}

void wifi_init_sta(void)
{
    s_wifi_event_group = xEventGroupCreate();                   //初始化wifi事件组

    ESP_ERROR_CHECK(esp_netif_init());                          //检查

    ESP_ERROR_CHECK(esp_event_loop_create_default());
    esp_netif_create_default_wifi_sta();

    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();        //配置wifi
    ESP_ERROR_CHECK(esp_wifi_init(&cfg));

    esp_event_handler_instance_t instance_any_id;           //存id
    esp_event_handler_instance_t instance_got_ip;           //存ip
    ESP_ERROR_CHECK(esp_event_handler_instance_register(WIFI_EVENT,         //注册wifi事件
                                                        ESP_EVENT_ANY_ID,
                                                        &event_handler,
                                                        NULL,
                                                        &instance_any_id));
    ESP_ERROR_CHECK(esp_event_handler_instance_register(IP_EVENT,           //注册ip事件
                                                        IP_EVENT_STA_GOT_IP,
                                                        &event_handler,
                                                        NULL,
                                                        &instance_got_ip));

    wifi_config_t wifi_config = {               //wifi配置初始化
        .sta = {
            .ssid = EXAMPLE_ESP_WIFI_SSID,
            .password = EXAMPLE_ESP_WIFI_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
            },
        },
    };
    ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_STA) );
    ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_STA, &wifi_config) );
    ESP_ERROR_CHECK(esp_wifi_start() );

    ESP_LOGI(TAG, "wifi_init_sta finished.");


    //等待，直到到连接建立，或者连接失败，事件标志bits被event_handler()置位
    EventBits_t bits = xEventGroupWaitBits(s_wifi_event_group,
            WIFI_CONNECTED_BIT | WIFI_FAIL_BIT,
            pdFALSE,
            pdFALSE,
            portMAX_DELAY);

    /* xEventGroupWaitBits()在回调发生之前就会返回Bits，所以我们可以用来测试事件是否真的发生了*/
    if (bits & WIFI_CONNECTED_BIT) {
        ESP_LOGI(TAG, "connected to ap SSID:%s password:%s",
                 EXAMPLE_ESP_WIFI_SSID, EXAMPLE_ESP_WIFI_PASS);
    } else if (bits & WIFI_FAIL_BIT) {
        ESP_LOGI(TAG, "Failed to connect to SSID:%s, password:%s",
                 EXAMPLE_ESP_WIFI_SSID, EXAMPLE_ESP_WIFI_PASS);
    } else {
        ESP_LOGE(TAG, "UNEXPECTED EVENT");
    }

    //事件注销后不会再被处理
    ESP_ERROR_CHECK(esp_event_handler_instance_unregister(IP_EVENT, IP_EVENT_STA_GOT_IP, instance_got_ip));
    ESP_ERROR_CHECK(esp_event_handler_instance_unregister(WIFI_EVENT, ESP_EVENT_ANY_ID, instance_any_id));
    vEventGroupDelete(s_wifi_event_group);
}

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_STA");
    wifi_init_sta();
}

解析

1.事件组定义

/*连接成功时，FreeRTOS事件组来传递信号*/
static EventGroupHandle_t s_wifi_event_group;

/* The event group allows multiple bits for each event, but we only care about two events:
 * - we are connected to the AP with an IP
 * - we failed to connect after the maximum amount of retries */
/*
事件组设有多个比特位来标志每个事件，但我们仅关心其中两个
1.连接到了AP且分配到了个ip
2.重连次数超过最大重试数，判定为连接失败
*/
#define WIFI_CONNECTED_BIT BIT0
#define WIFI_FAIL_BIT      BIT1

在这里插入图片描述
查看定义到这就可以明白，上述一个事件由多位bit表示是什么意思了，每一个事件标志实际上是一个32/16位的unsigned int型变量。
我们再看看BIT0,BIT1
在这里插入图片描述
确实是32位

2.事件处理函数

static void event_handler(void* arg, esp_event_base_t event_base,               //事件处理函数
                                int32_t event_id, void* event_data)
{
    if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_START) {         //如果是wifi事件相关&&事件id==wifi STA模式开始，开始连接WiFi
        esp_wifi_connect();
    } 
    else if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_DISCONNECTED) {   //如果是wifi事件相关&&事件id==wifi STA模式连接失败
        if (s_retry_num < EXAMPLE_ESP_MAXIMUM_RETRY) {                  //如果重连次数<预设的最大重连次数
            esp_wifi_connect();
            s_retry_num++;
            ESP_LOGI(TAG, "retry to connect to the AP");
        } else {                                                        
            xEventGroupSetBits(s_wifi_event_group, WIFI_FAIL_BIT);      //置位wifi事件组的失败标志位,表示连接失败
        }
        ESP_LOGI(TAG,"connect to the AP fail");
    } 
    else if (event_base == IP_EVENT && event_id == IP_EVENT_STA_GOT_IP) {       //如果是ip事件相关&&事件id==已取得ip
        ip_event_got_ip_t* event = (ip_event_got_ip_t*) event_data;
        ESP_LOGI(TAG, "got ip:" IPSTR, IP2STR(&event->ip_info.ip));             //串口打印ip
        s_retry_num = 0;
        xEventGroupSetBits(s_wifi_event_group, WIFI_CONNECTED_BIT);
    }
}

这个函数的功能简单，根据事件id、类型的不同，执行不同操作。详细请看注释

3.初始化函数

（1） esp_netif_create_default_wifi_sta();
这是官方提供给用户，用于初始化默认STA模式的API
在这里插入图片描述

（2）wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT(); //配置wifi
在这里插入图片描述
（3）
esp_event_handler_instance_t instance_any_id; esp_event_handler_instance_t instance_got_ip;

在这里插入图片描述
所以这两变量的实际类型是void*
参考：C 语言中 void* 详解及应用

（4）

void wifi_init_sta(void)
{
    s_wifi_event_group = xEventGroupCreate();                   //初始化wifi事件组

    ESP_ERROR_CHECK(esp_netif_init());                          //检查

    ESP_ERROR_CHECK(esp_event_loop_create_default());
    esp_netif_create_default_wifi_sta();

    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();        //配置wifi
    ESP_ERROR_CHECK(esp_wifi_init(&cfg));

    esp_event_handler_instance_t instance_any_id;           //存id
    esp_event_handler_instance_t instance_got_ip;           //存ip
    ESP_ERROR_CHECK(esp_event_handler_instance_register(WIFI_EVENT,         //注册wifi事件
                                                        ESP_EVENT_ANY_ID,
                                                        &event_handler,
                                                        NULL,
                                                        &instance_any_id));
    ESP_ERROR_CHECK(esp_event_handler_instance_register(IP_EVENT,           //注册ip事件
                                                        IP_EVENT_STA_GOT_IP,
                                                        &event_handler,
                                                        NULL,
                                                        &instance_got_ip));

    wifi_config_t wifi_config = {               //wifi配置初始化
        .sta = {
            .ssid = EXAMPLE_ESP_WIFI_SSID,
            .password = EXAMPLE_ESP_WIFI_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
            },
        },
    };
    ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_STA) );
    ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_STA, &wifi_config) );
    ESP_ERROR_CHECK(esp_wifi_start() );

    ESP_LOGI(TAG, "wifi_init_sta finished.");


    //等待，直到到连接建立，或者连接失败，事件标志bits被event_handler()置位
    EventBits_t bits = xEventGroupWaitBits(s_wifi_event_group,
            WIFI_CONNECTED_BIT | WIFI_FAIL_BIT,
            pdFALSE,
            pdFALSE,
            portMAX_DELAY);

    /* xEventGroupWaitBits()在回调发生之前就会返回Bits，所以我们可以用来测试事件是否真的发生了*/
    if (bits & WIFI_CONNECTED_BIT) {
        ESP_LOGI(TAG, "connected to ap SSID:%s password:%s",
                 EXAMPLE_ESP_WIFI_SSID, EXAMPLE_ESP_WIFI_PASS);
    } else if (bits & WIFI_FAIL_BIT) {
        ESP_LOGI(TAG, "Failed to connect to SSID:%s, password:%s",
                 EXAMPLE_ESP_WIFI_SSID, EXAMPLE_ESP_WIFI_PASS);
    } else {
        ESP_LOGE(TAG, "UNEXPECTED EVENT");
    }

    //事件注销后不会再被处理
    ESP_ERROR_CHECK(esp_event_handler_instance_unregister(IP_EVENT, IP_EVENT_STA_GOT_IP, instance_got_ip));
    ESP_ERROR_CHECK(esp_event_handler_instance_unregister(WIFI_EVENT, ESP_EVENT_ANY_ID, instance_any_id));
    vEventGroupDelete(s_wifi_event_group);
}

注册事件

    ESP_ERROR_CHECK(esp_event_handler_instance_register(WIFI_EVENT,         //注册wifi事件
                                                        ESP_EVENT_ANY_ID,
                                                        &event_handler,
                                                        NULL,
                                                        &instance_any_id));
    ESP_ERROR_CHECK(esp_event_handler_instance_register(IP_EVENT,           //注册ip事件
                                                        IP_EVENT_STA_GOT_IP,
                                                        &event_handler,
                                                        NULL,
                                                        &instance_got_ip));

在这里插入图片描述
注册一个事件处理实例到默认死循环中
@param[in] ：不能为NULL，被注册的 Event_loop 的句柄

  • @param[in] :handle函数要处理的事件的基础id
  • @param[in] :handle函数要处理的事件的id
  • @param[in] :事件触发时，handle函数入口
  • @param[in] :事件触发时，传递给handle函数的参数
  • @param[out] instance :可以为NULL，后面自行看吧

//可以看我的基于VScode的ESP32开发学习（四），对这里做了详细分析

参考：ESP32-IDF Event_Loop库 实战分析

后言

看wifi之前先去看事件注册相关例程，会轻松很多。

Newbie_H
关注
  • 4
    点赞
  • 踩
  • 24
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
ESP32-IDF开发实例-网络编程-WIFI连接
视觉与物联智能
07-05 1537
WIFI连接 ESP32是一系列高度集成的、专为移动设备、可穿戴电子产品设计的物联网模块，其集成了天线开关、RF balun、功率放大器、低接收噪声放大器，滤波器、电源管理模块等，可以独立运行应用，也可以通过SPI/SDIO或I2C/UART接口为其他设备提供WiFi和蓝牙功能。 ESP32的WiFi模块三种工作模式：Station模式、AP(Access Point)模式，Station+AP模式（即热点模式）。我们在平时使用中一般是使用Station模式，连接WiFi网络。上述模式的各种安全模式（WP
ESP32S2基于VScode环境配置esp-idf插件添加自定义组件例程
02-14
在本教程中，我们将详细讲解如何在VSCode环境中配置ESP-IDF插件，以便为ESP32S2开发项目，并添加自定义组件。 首先，确保你已经安装了VSCode和ESP-IDF开发环境。你可以从官方网站下载最新版本的VSCode，并通过...
【ESP32学习之路5——station模式下连接到WiFi热点】
weixin_48213877的博客
05-21 1745
在这里插入图片描述 在sdkconfig中看到默认的SSID与PASSWORD，以及重连的次数为5次，在idf.py menuconfig 中更改
【ESP32学习笔记】esp32-c3官方例程freertos 新建和合并 ble gatt ，ledc_fade 三个例程工程合并，手机ble蓝牙调试传输变量控制led
djxasd123的博客
05-18 949
将/home/djx/esp/gatt_server_service_table 工程的demo.c 全部赋值到新组件.c文件内，改掉app_main函数名，到主app_main内调用。3、然后再追 BLE_42_FEATURE_SUPPORT，可以知道其依赖于 CONFIG_BT_BLE_42_FEATURES_SUPPORTED。1、esp_ble_gap_start_advertising 在文件 esp_gap_ble_api.c 内。修改app_mai名字位对应主函数调用的名字，
基于VScode的ESP32开发学习（二）：官方例程softap，提供wifi，详解
Newbie_H的学习之路
04-17 2486
完整代码放在文末 1.wifi事件处理函数 /*wifi事件处理函数*/ 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) {
使用vscode开发esp32
ching的专栏
09-29 9623
在vscode中开发esp32 设置好下载目录，等待下载完成，下载sdk时默认是从github上拉取，网络不好可能比较耗时。这里会列出来详细的命令 点击查看，命令面板或者使用快捷键ctrl + shift + p输入Show Examples Projects 这里会列出来当前sdk支持的全部demo 这里选择一个blink的demo 服务
VScode+ESP-IDF在ESP32上搭建web server，并实现Captive Portal - 连接WiFi自动弹出认证页面，此页面输入WIFI账号密码一键配网
ZIMOXIXUAN的博客
07-03 852
* 调整垂直内边距以保持文本居中，水平内边距已隐含为0 *//* ws_client连接成功事件 *//* 添加这行代码使按钮水平居中 *//* ws_client错误事件 *//* ws_client接收数据 *//* 发送数据到服务器 *//* 上移标题 *//* 下移按钮 */
手把手教你使用VScode+ESP-IDF在ESP32上搭建web server，并作为web socket server进行数据交互
weixin_45775305的博客
05-22 1846
手把手教你使用VScode+ESP-IDF在ESP32上搭建web server，并作为web socket server进行数据交互
VSCode + ESP-IDF 开发XIAO ESP32S3(Sense)以及摄像头camera ov2640（同样使用于乐鑫ESP32S3，以及其他系列的摄像头）
最新发布
qq_46210601的博客
07-12 893
VSCode + ESP-IDF 开发XIAO ESP32S3(Sense)以及摄像头camera ov2640（同样使用于乐鑫ESP32S3，以及其他系列的摄像头）
ESP32 学习笔记【2】：Ubuntu+linux+VScode+ESP-IDF+ESP32-WROOM+32+实现wifi的STA模式连接到固定AP
qq_44133335的博客
06-09 1095
拿到开发板后根据例程梳理了一下，有需要的可以参考。ESP32新人，真难啊，难啊，给例程都看不懂，哎！！!(blink灯的程序可以不用管，我自己调试用的) #include <string.h> #include "freertos/FreeRTOS.h" #include "freertos/task.h" #include "freertos/event_groups.h" #include "esp_system.h" #include "esp_wifi.h" #include "esp_
一篇文章足够你学习ESP32，提供史上最全的ESP32教程(驱动/蓝牙/Wi-Fi/LVGL/Arduino...)
热门推荐
朝气蓬勃
04-04 10万+
本文章目的： 1）针对单片机外设做详细的教程，丰富个人技能吃，彻底从原理+应用来写外设 2）给广大蓝牙爱好者提供蓝牙应用方面的教程(结合我们的蓝牙协议栈会事半功倍) 蓝牙协议栈教程点击我 3）给广大Wi-Fi爱好者提供Wi-Fi方面的教程(结合我们的Wi-Fi协议栈会事半功倍) Wi-Fi协议栈教程点击我 4）给广大GUI爱好者提供LVGL方面的教程 LVGL教程点击我 5）把各个技能池组合起来，举一反三，做炫酷的实例应用 教程内容: 我们的内容包括但不限于： 1）IDF基础介绍
esp8266开发学习例程.rar
01-11
2. **强大的处理器**：ESP8266采用32位LWIP微控制器，具有高速处理能力，适合运行轻量级操作系统如FreeRTOS，并处理复杂的网络协议。 3. **丰富的GPIO**：拥有多个通用输入输出引脚，可以连接各种外设，如传感器、...
物联网嵌入式ESP32开发Arduino例程03-WiFi-TCP客户端Client网络通讯.rar
04-21
1、嵌入式物联网ESP32项目实战开发。例程经过精心编写，简单好用。 2、代码使用Arduino开发。例程在ESP32-S3上运行。若在其他型号上运行，请自行调整。 3、如果接入其他传感器，请点击头像查看发布的其他资料。 4、...
物联网嵌入式ESP32开发Arduino例程01-WiFi-SCAN扫描周围WIFI信号.rar
04-21
1、嵌入式物联网ESP32项目实战开发。例程经过精心编写，简单好用。 2、代码使用Arduino开发。例程在ESP32-S3上运行。若在其他型号上运行，请自行调整。 3、如果接入其他传感器，请点击头像查看发布的其他资料。 4、...
物联网嵌入式ESP32开发MicroPython例程01-WiFi-UDP网络通讯.rar
04-21
1、嵌入式物联网ESP32项目实战开发。例程经过精心编写，简单好用。 2、代码使用MicroPythion开发。例程在ESP32-S3上运行。若在其他型号上运行，请自行调整。 3、如果接入其他传感器，请点击头像查看发布的其他资料。...
使用Arduino开发ESP32：关于esp32 wifi连接不上的解决办法
Newbie_H的学习之路
07-19 1万+
今天在学习MQTT订阅的过程中 发现esp32时钟连接不上wifi 主体代码如下： while(WiFi.status()!=WL_CONNECTED){ delay(200); Serial.println("正在连接至wifi..."); WiFi.begin(id,psw); } Serial.println("已连接."); 检查过wifi账号密码，语句逻辑无误之后 最后发现是 delay(200); 这个延时函数的问题，延时太短了 问题原因猜想： 我猜
使用Arduino开发ESP32（十五）：使用Bluetooth（蓝牙）进行串行通信，经典蓝牙，非BLE
Newbie_H的学习之路
07-30 1万+
Bluetooth Serial Library（蓝牙串口库） A simple Serial compatible library using ESP32 classical bluetooth (SPP) 一个用到了ESP32的蓝牙（）库的简单串口兼容库 如何使用它? Download one bluetooth terminal app in your smartphone 在你的手机上下载蓝牙终端app For Android For IOS Flash an example sket
使用Arduino开发ESP32（十三）：PWM（LEDC）
Newbie_H的学习之路
07-27 1万+
** 基础介绍 ** ESP32有一个LEDC，原本设计用来控制LED，可以作简单的PWM输出 LEDC总共有16个路通道（0 ~ 15），分为高低速两组，高速通道（0 ~ 7）由80MHz时钟驱动，低速通道（8 ~ 15）由1MHz时钟驱动。 方法函数： double ledcSetup(uint8_t channel, double freq, uint8_t resolution_bits) （通道号，频率，计数位数） channel为通道号，取值0 ~ 15； freq，设置频率； resolut
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值