32-ESP32-S3-WIFI篇-03 Event Loop (事件循环)

ESP32-S3-WIFI 事件循环

介绍

在ESP32-S3的WiFi驱动程序中,事件循环是一个非常重要的概念。事件循环是一个无限循环,用于处理和分发系统中发生的各种事件。在WiFi驱动程序中,我们使用事件循环来处理和分发WiFi相关的事件。

创建事件循环

在初始化WiFi驱动程序时,我们会创建一个事件循环。这个事件循环将被用来处理和分发WiFi的事件。

  • esp_event_loop_args_t:这个结构体,用于指定事件循环的属性,
  • esp_event_loop_create():这个函数用于创建一个事件循环。它接受一个esp_event_loop_args_t类型的参数,用于指定事件循环的属性,然后返回一个esp_event_loop_handle_t类型的句柄,这个句柄可以用来引用事件循环
// 定义事件循环句柄
esp_event_loop_handle_t event_loop;

void app_main(void)
{
    // 定义事件循环参数
    esp_event_loop_args_t event_loop_args = {
        .queue_size = 5,  // 事件队列的大小
        .task_name = "wifi_event_loop",  // 事件循环任务的名称
        .task_priority = ESP_TASK_MAIN_PRIO,  // 事件循环任务的优先级
        .task_stack_size = 2048,  // 事件循环任务的堆栈大小
        .task_core_id = tskNO_AFFINITY  // 事件循环任务运行的CPU核心ID
    };

    // 创建事件循环
    esp_event_loop_create(&event_loop_args, &event_loop);
    ...
}

注册事件处理函数

在事件循环中,我们可以注册事件处理函数。当特定的事件发生时,相应的事件处理函数就会被调用。

// 定义事件处理函数
void event_handler(void* arg, esp_event_base_t event_base, 
                               int32_t event_id, void* event_data)
{
    // 根据事件的类型和ID进行相应的处理
    ...
}

void app_main(void)
{
    ...
    // 将事件处理函数注册到事件循环中
    esp_event_handler_register_with(event_loop,WIFI_EVENT, ESP_EVENT_ANY_ID, &event_handler, NULL);
}

运行事件循环

事件循环在一个单独的任务中运行。当事件发生时,事件循环会调用相应的事件处理函数。

esp_event_loop_run():这个函数用于运行事件循环。它会在一个无限循环中等待事件的发生,然后调用相应的事件处理函数。

void app_main(void)
{
    ...
    // 运行事件循环
    while (true) {
        esp_event_loop_run(event_loop, portMAX_DELAY);
    }
}

WiFi事件循环示例

这个程序中,我们创建一个WiFi STA(Station模式)并连接到一个AP(Access Point)。

#include "esp_event.h"
#include "esp_wifi.h"

// 定义WiFi STA的SSID和密码
#define WIFI_SSID "your_ssid"
#define WIFI_PASSWORD "your_password"

// 定义事件处理函数
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 STA已经启动,开始连接到AP
        esp_wifi_connect();
    } else if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_DISCONNECTED) {
        // WiFi STA已经断开连接,重新连接到AP
        esp_wifi_connect();
    } else if (event_base == IP_EVENT && event_id == IP_EVENT_STA_GOT_IP) {
        // WiFi STA已经获取到IP地址
        ip_event_got_ip_t* event = (ip_event_got_ip_t*) event_data;
        printf("Got IP: %s\n", ip4addr_ntoa(&event->ip_info.ip));
    }
}

void app_main(void)
{
    // 初始化ESP-IDF的事件库
    esp_event_loop_args_t event_loop_args = {
        .queue_size = 5,
        .task_name = "wifi_event_loop",
        .task_priority = ESP_TASK_MAIN_PRIO,
        .task_stack_size = 2048,
        .task_core_id = tskNO_AFFINITY
    };
    esp_event_loop_handle_t event_loop;
    esp_event_loop_create(&event_loop_args, &event_loop);

    // 初始化WiFi驱动程序
    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
    esp_wifi_init(&cfg);

    // 设置WiFi为STA模式
    esp_wifi_set_mode(WIFI_MODE_STA);

    // 设置WiFi STA的SSID和密码
    wifi_config_t wifi_config = {
        .sta = {
            .ssid = WIFI_SSID,
            .password = WIFI_PASSWORD,
        },
    };
    esp_wifi_set_config(ESP_IF_WIFI_STA, &wifi_config);

    // 将事件处理函数注册到自定义的事件循环中
    esp_event_handler_register_with(event_loop, WIFI_EVENT, ESP_EVENT_ANY_ID, &event_handler, NULL);
    esp_event_handler_register_with(event_loop, IP_EVENT, IP_EVENT_STA_GOT_IP, &event_handler, NULL);

    // 启动WiFi
    esp_wifi_start();

    // 运行事件循环
    while (true) {
        esp_event_loop_run(event_loop, portMAX_DELAY);
    }
}

这个例子中,我们首先初始化了ESP-IDF的事件库和WiFi驱动程序,然后设置WiFi为STA模式,并设置了WiFi STA的SSID和密码。然后,我们注册了一个事件处理函数,用于处理WiFi的事件。最后,我们启动了WiFi,并运行了事件循环。

在事件处理函数中,我们处理了三种事件:WiFi STA启动,WiFi STA断开连接,和WiFi STA获取到IP地址。当WiFi STA启动时,我们开始连接到AP。当WiFi STA断开连接时,我们重新连接到AP。当WiFi STA获取到IP地址时,我们打印出获取到的IP地址。

总结

事件循环是ESP32-S3 WiFi驱动程序中的一个重要概念,它使我们能够在任务之间同步和传递WiFi状态信息。

🚨需要注意在ESP-IDF中,esp_event_loop_create()esp_event_loop_run()函数是用于创建和运行用户定义的事件循环。然而,ESP-IDF也提供了一个默认的事件循环,这个默认的事件循环在系统启动时就已经被创建,并且在系统运行期间一直在后台运行。

因此,如果你的应用程序只需要处理一些常见的系统事件(例如WiFi事件),那么你可以直接使用默认的事件循环,而不需要自己创建和运行事件循环。你只需要使用esp_event_handler_register()函数将你的事件处理函数注册到默认的事件循环中,然后当相应的事件发生时,你的事件处理函数就会被调用。

但是,如果你的应用程序需要处理一些特殊的事件,或者你需要更细粒度的控制事件的处理,那么你可以创建和运行你自己的事件循环。你可以使用esp_event_loop_create()函数创建你自己的事件循环,然后使用esp_event_loop_run()函数在一个单独的任务中运行你的事件循环,但此时要使用esp_event_handler_register_with()将你的事件处理函数注册到默认的事件循环中。

📚参考资料
乐鑫编程指南-事件循环库

### ESP32-S3 Wi-Fi 配置指南 #### 一、ESP32-S3 Wi-Fi 功能概述 ESP32-S3 是一款集成双核处理器和支持Wi-Fi/Bluetooth功能的SoC芯片。其强大的处理能力和丰富的外设资源使其成为物联网(IoT)项目的理想选择[^1]。 #### 二、使用前准备事项 为了顺利进行Wi-Fi配置,在开始之前需确认已安装好必要的工具链和库文件,推荐通过VS Code配合PlatformIO插件来设置开发环境[^2]。 #### 三、基本Wi-Fi客户端模式连接流程 要让ESP32-S3作为STA(Station,即客户端)角色接入路由器或其他无线热点,可以按照下面的方法编写程序: ```c #include "esp_wifi.h" #include "nvs_flash.h" static void wifi_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){ esp_wifi_connect(); }else if(event_base == IP_EVENT && event_id == IP_EVENT_STA_GOT_IP){ ip_event_got_ip_t *event = (ip_event_got_ip_t *)event_data; printf("Got IP: %s\n", inet_ntoa(event->ip_info.ip)); } } void setup_wifi(){ nvs_flash_init(); // 初始化NVS分区 tcpip_adapter_init(); esp_event_loop_create_default(); wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT(); esp_wifi_init(&cfg); esp_wifi_set_storage(WIFI_STORAGE_RAM); esp_wifi_start(); esp_wifi_set_mode(WIFI_MODE_STA); wifi_config_t sta_config={ .sta ={ .ssid ="your_SSID", .password="your_PASSWORD" }, }; esp_wifi_set_config(WIFI_IF_STA,&sta_config); esp_event_handler_register(WIFI_EVENT, ESP_EVENT_ANY_ID, &wifi_event_handler, NULL); esp_event_handler_register(IP_EVENT, IP_EVENT_STA_GOT_IP, &wifi_event_handler, NULL); } ``` 上述代码实现了启动时自动尝试连接指定SSID/PASSWORD组合下的Wi-Fi网络,并打印分配到的IP地址信息[^4]。 #### 四、常见错误排查技巧 当遇到无法成功建立Wi-Fi连接的情况时,可以从以下几个方面入手解决问题: - **验证输入参数**:确保提供的SSID名称以及密码无误; - **检查硬件状态**:观察模块上的指示灯变化情况判断是否处于正常工作范围之内; - **日志分析**:利用`idf.py menuconfig`命令开启更详细的调试输出选项以便于定位具体原因所在; 对于某些特殊场景下可能还会涉及到天线匹配度调整等问题,则建议参照官方文档进一步深入研究。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

宁子希

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值