开始前适用开发板：ESP32-P4 + ESP32-C5 · 开发框架：ESP-IDF
适用开发板：P4C5 · 工程
02.beginner.wifi_softap· targetesp32p4
学习时长：约 15 分钟 · 难度：★★☆☆☆
学习目标
完成本节后，你将能够：
- 理解通过 C5 协处理器开启 SoftAP 的流程
- 掌握 AP 模式的配置和事件处理
1. 这个例子在干嘛
功能与 Korvo wifi_softap 相同——把设备变成 Wi-Fi 热点。MIPI 屏显示热点名、IP 和已连接设备数。
C5 注意：等 10~20 秒 C5 就绪后热点才会广播出去。
2. 编译烧录
cd P4_C5_4.3_Firmware\02.beginner.wifi_softap
idf.py set-target esp32p4
idf.py menuconfig # 热点名/密码/信道
idf.py build flash monitor
menuconfig 选项（与 Korvo 版相同）
| 选项 | 默认 | 说明 |
|---|---|---|
ESP_WIFI_SSID | myssid | 热点名 |
ESP_WIFI_PASSWORD | mypassword | 密码（≥8 位） |
ESP_WIFI_CHANNEL | 1 | 信道 |
ESP_MAX_STA_CONN | 4 | 最大客户端数 |
3. 使用步骤
- 等 C5 就绪（串口
Transport active） - 手机搜索热点名连接
- 设备 IP 默认
192.168.4.1 - MIPI 屏显示连接数实时变化
4. 与 Korvo 版的区别
| 对比 | Korvo | P4C5 |
|---|---|---|
| Wi-Fi | S3 内置 | C5 外置 |
| 启动 | 即时 | 等 C5 10~20s |
| API | 相同 | 相同 |
| 屏幕 | SPI 小屏 | MIPI 大屏 |
5. 常见问题与排查
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 搜不到热点 | C5 未就绪 | 等 20 秒 |
| 密码不对 | 密码 < 8 位 | 补足或设空（Open） |
| 连上无法上网 | AP 模式不提供互联网 | 正常 |
详细原理和 AP/STA 对比参见 Korvo wifi_softap。
6. 下一步
| 方向 | 推荐例程 | 说明 |
|---|---|---|
| Wi-Fi 连接 | Wi-Fi Station | STA 模式 |
| HTTP 服务 | HTTP Server | AP + HTTP |
| 详细原理 | Korvo SoftAP | 完整讲解 |
酷世DIY · Kevincoooool