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(); //连接WiFiprintf("WiFi连接断开，正在重新连接...\n");}else if(event_base == IP_EVENT && event_id == IP_EVENT_STA_GOT_IP) {// WiFi station got IP addressprintf("获取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-configurationesp_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(); //启动wifiprintf("WIFI启动完成!\n");
}三、WIFI.h
#pragma once#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "esp_log.h"
#include "esp_wifi.h"
#include "esp_event.h"
#include "nvs_flash.h"
#include "esp_netif.h" #include "OLED.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_netifnvs_flashesp_systemOLED
)
五、说明
①
在 C/C++ 中
#pragma once
和
#ifndef ... #define ... #endif
作用一样。后者兼容性高且通用，前者方便
②需要更改成自己wifi账号密码的去修改WIFI.h的宏定义，有备注
③WIFI用到的官方组件比较多，注意CMakeList.txt的组件依赖声明和WIFI.h的引用头文件。如果直接引用库但是没有包含依赖，会报错。
六、参考
esp32-s3 IDF 连接wifi_哔哩哔哩_bilibili