12. wifi 目录

12.1 station 例程

字段	描述
例程名称	station
所在文件夹路径	examples\wifi\getting_started\station
核心功能说明	演示ESP32作为Wi-Fi客户端（STA模式）连接到外部接入点（AP）的基本功能。包括Wi-Fi初始化、连接建立、IP获取和连接状态管理。
主要调用的内部/外部函数或模块	- app_main()：程序入口函数 - wifi_init_sta()：初始化STA模式Wi-Fi - event_handler()：处理Wi-Fi和IP事件 - esp_netif_init()：初始化网络接口 - esp_event_loop_create_default()：创建默认事件循环 - esp_wifi_init()：初始化Wi-Fi驱动 - esp_wifi_set_mode()：设置Wi-Fi模式 - esp_wifi_set_config()：配置Wi-Fi参数 - esp_wifi_start()：启动Wi-Fi驱动
输入输出参数说明	输入： - 配置的SSID和密码（通过menuconfig设置） 输出： - Wi-Fi连接状态 - 获取到的IP地址 - 连接成功或失败的日志信息
适用场景及典型应用案例	适用于： - 学习Wi-Fi STA模式的基本配置和使用 - 开发需要连接到现有Wi-Fi网络的设备 - 作为物联网设备连接云平台的基础 - 测试Wi-Fi连接稳定性 - 作为Wi-Fi客户端应用的参考模板

12.2 softAP 例程

字段	描述
例程名称	softAP
所在文件夹路径	examples\wifi\getting_started\softAP
核心功能说明	演示ESP32作为Wi-Fi接入点（AP模式）的基本功能。包括AP创建、客户端连接管理和DHCP服务器配置。
主要调用的内部/外部函数或模块	- app_main()：程序入口函数 - wifi_init_softap()：初始化SoftAP模式Wi-Fi - 事件处理函数：处理客户端连接和断开事件 - esp_netif_init()：初始化网络接口 - esp_event_loop_create_default()：创建默认事件循环 - esp_wifi_init()：初始化Wi-Fi驱动 - esp_wifi_set_mode()：设置Wi-Fi模式 - esp_wifi_set_config()：配置AP参数 - esp_wifi_start()：启动Wi-Fi驱动
输入输出参数说明	输入： - 配置的SSID、密码和通道（通过menuconfig设置） 输出： - AP创建状态 - 客户端连接和断开事件 - 分配给客户端的IP地址
适用场景及典型应用案例	适用于： - 学习Wi-Fi AP模式的基本配置和使用 - 开发需要创建Wi-Fi网络的设备 - 作为物联网设备的本地配置热点 - 测试AP模式下的客户端连接管理 - 作为Wi-Fi AP应用的参考模板

12.3 espnow 例程

字段	描述
例程名称	espnow
所在文件夹路径	examples\wifi\espnow
核心功能说明	演示ESP-NOW协议的使用，实现设备间的无连接Wi-Fi通信。包括ESP-NOW初始化、对等设备管理、数据发送和接收。
主要调用的内部/外部函数或模块	- app_main()：程序入口函数 - espnow_init()：初始化ESP-NOW - espnow_send_cb()：处理发送回调 - espnow_recv_cb()：处理接收回调 - esp_now_add_peer()：添加对等设备 - esp_now_send()：发送ESP-NOW数据 - Wi-Fi初始化相关函数
输入输出参数说明	输入： - 对等设备的MAC地址 - 要发送的数据 输出： - 数据发送状态 - 接收到的数据和发送方MAC地址
适用场景及典型应用案例	适用于： - 学习ESP-NOW协议的实现和使用 - 开发设备间低延迟通信的应用 - 物联网设备的本地数据交换 - 无线传感器网络 - 智能家居设备间的直接通信 - 作为ESP-NOW应用的参考模板

12.4 iperf 例程

字段	描述
例程名称	iperf
所在文件夹路径	examples\wifi\iperf
核心功能说明	用于测试Wi-Fi网络吞吐量，支持TCP和UDP协议。可以在STA模式或AP模式下运行，与另一台运行iperf客户端或服务器的设备配合使用。
主要调用的内部/外部函数或模块	- app_main()：程序入口函数 - Wi-Fi初始化相关函数 - iperf客户端/服务器实现 - 网络套接字相关函数
输入输出参数说明	输入： - iperf测试配置（协议类型、端口、测试时长等） 输出： - 吞吐量测试结果 - 网络延迟和丢包率（UDP模式）
适用场景及典型应用案例	适用于： - 测试Wi-Fi网络性能 - 验证不同配置下的网络吞吐量 - 优化Wi-Fi应用的网络性能 - 比较不同设备或固件版本的网络性能 - 作为网络性能测试的参考模板

12.5 smart_config 例程

字段	描述
例程名称	smart_config
所在文件夹路径	examples\wifi\smart_config
核心功能说明	演示如何使用ESP-TOUCH协议，通过手机应用将Wi-Fi配置信息传递给ESP32设备，实现设备的快速联网。
主要调用的内部/外部函数或模块	- app_main()：程序入口函数 - smartconfig_example_task()：智能配网任务 - 事件处理函数：处理智能配网事件 - Wi-Fi初始化相关函数
输入输出参数说明	输入： - 通过手机App发送的Wi-Fi SSID和密码 输出： - 配网状态 - Wi-Fi连接结果
适用场景及典型应用案例	适用于： - 学习智能配网技术的实现 - 开发需要快速联网的物联网设备 - 简化设备的初次配置流程 - 作为智能配网应用的参考模板