vscode的ws环境，esp32s3连接wifi

注意大小写，wsl（也就是linux环境）严格区分大小写。有帮助记得订阅专栏+点赞，当前不定期持续更新。

一、文件夹格式

oled1/                  # 项目根目录
├─ main/                # 主程序文件夹
│  ├─ main.c            # 主函数文件（包含 app_main）
│  └─ CMakeLists.txt    # main 组件的编译配置
├─ components/          # 自定义组件目录（与 main 同级）
│  └─ WIFI/             # WIFI 组件
│     ├─ WIFI.c         # WIFI 功能实现
│     ├─ WIFI.h         # WIFI 头文件（声明函数、宏等）
│     └─ CMakeLists.txt # WIFI 组件的编译配置
├─ CMakeLists.txt       # 项目根目录编译配置（指定项目名称、依赖等）
├─ sdkconfig            # ESP-IDF 配置文件（由 menuconfig 生成）
└─ partitions.csv       # 分区表配置文件（可选，默认使用 ESP-IDF 自带）

二、WIFI.c

#include "WIFI.h"

void my_esp_event(void* event_handler_arg, esp_event_base_t event_base,int32_t event_id, void* event_data)
{
    if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_DISCONNECTED) {
        esp_wifi_connect();  //连接WiFi
        printf("WiFi连接断开，正在重新连接...\n");
    }
    else if(event_base == IP_EVENT && event_id == IP_EVENT_STA_GOT_IP) {
        // WiFi station got IP address
        printf("获取IP地址成功！\n");
        ip_event_got_ip_t* event = (ip_event_got_ip_t*) event_data;         
        char ip_str[16];
        sprintf(ip_str, IPSTR, IP2STR(&event->ip_info.ip));     //获取ip地址
        printf("IP的地址是: %s\n", ip_str);
    }
}

void init_Wifi()
{
    //一、初始化
    nvs_flash_init();
    esp_netif_init();       //初始化nvs和网络接口
    esp_event_loop_create_default();    //创建事件循环（接收wifi信号变化，获取ip啥的，都需要在事件循环里处理）
    esp_netif_create_default_wifi_sta();    //创建按wifi station（工作站）模式的网络接口
    printf("WIFI初始化结束!\n");
    //二、注册wifi和ip的事件回调
        //wifi事件回调
    esp_event_handler_instance_t wifi_event_handler;
    esp_event_handler_instance_register(WIFI_EVENT,             //wifi事件 
                                        ESP_EVENT_ANY_ID,       //任何wifi事件都触发下面的回调函数
                                        &my_esp_event,          //回调函数
                                        NULL,                   //用户数据
                                        &wifi_event_handler);   //事件回调句柄
        //ip事件回调
    esp_event_handler_instance_t ip_event_handler;
    esp_event_handler_instance_register(IP_EVENT,               //ip事件
                                        IP_EVENT_STA_GOT_IP,    //只关注获取ip的事件
                                        &my_esp_event,          //回调函数
                                        NULL,                   //数据
                                        &ip_event_handler);     //事件回调句柄
    printf("WIFI和IP事件注册回调完成!\n");
    //wifi配置与启动
        //配置
    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT(); //默认配置 cfg-configuration
    esp_wifi_init(&cfg);
    esp_wifi_set_mode(WIFI_MODE_STA);
    wifi_interface_t interface = WIFI_IF_STA; //设置wifi接口为工作站模式
    wifi_config_t wifi_sta_config = {
        .sta = {
            .ssid = User_Wifi_SSID,          //替换为你的WiFi SSID
            .password = User_Wifi_PassWord,  //替换为你的WiFi密码
            .threshold.authmode = WIFI_AUTH_WPA2_PSK, //认证方式
        },
    };
    //wifi配置，wifi_sta_config是工作站模式的配置，sta_config是配置wifi账号、密码，和wifi的认证方式
    esp_wifi_set_config(interface, &wifi_sta_config);   
    esp_wifi_start();   //启动wifi
    printf("WIFI启动完成!\n");
}

三、WIFI.h

#pragma once

#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "esp_wifi.h"
#include "esp_event.h"
#include "nvs_flash.h"
#include "esp_netif.h"    

#define User_Wifi_SSID      "QL.ql"       //你的wifi名字（建议英文），建议使用2.4G频段，不然可能连接不上
#define User_Wifi_PassWord  "Ql.qlGood"  //你的wifi密码

void init_Wifi();

四、CMakeList.txt

# components/WIFI/CMakeLists.txt
idf_component_register(
    SRCS "WIFI.c"
    INCLUDE_DIRS "."
    REQUIRES 
        esp_wifi 
        esp_event 
        esp_netif
        nvs_flash
        esp_system
)

五、连接wifi

#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "WIFI.h"

void app_main(void) {

    init_Wifi();
    esp_wifi_connect();  //连接WiFi

    while (1) {
        vTaskDelay(1000 / portTICK_PERIOD_MS);
    }
}

六、说明

①

在 C/C++ 中
#pragma once 
和
#ifndef ... #define ... #endif
作用一样。后者兼容性高且通用，前者方便

②需要更改成自己wifi账号密码的去修改WIFI.h的宏定义，有备注

③WIFI用到的官方组件比较多，注意CMakeList.txt的组件依赖声明和WIFI.h的引用头文件。如果直接引用库但是没有包含依赖，会报错。

六、参考

esp32-s3 IDF 连接wifi_哔哩哔哩_bilibili