7261022611
- 新增 wifi-connect 组件（AP 配网、DNS 劫持、Captive Portal） - 支持长按按键进入配网，网页配置路由器 SSID/密码 - 增加清除已保存 Wi-Fi 参数能力（API + 页面按钮） - 增加中文状态日志与中文注释，优化配网交互 - 补充组件文档：README、USER_GUIDE、QUICK_POSTER、BLOG
78 lines
1.7 KiB
Markdown
78 lines
1.7 KiB
Markdown
# BotanicalBuddy 配网操作手册（用户版）
|
||
|
||
> 适用对象：现场测试、家人用户、非开发人员
|
||
> 目标：让设备快速连上家里 Wi-Fi
|
||
|
||
---
|
||
|
||
## 1. 开始前准备
|
||
|
||
- 手机已打开 Wi-Fi
|
||
- 记住家里 Wi-Fi 名称和密码
|
||
- 设备已上电
|
||
|
||
---
|
||
|
||
## 2. 进入配网模式
|
||
|
||
1. 长按设备上的配网按键（约 2 秒）
|
||
2. 看到串口日志或提示为“配网已启动”
|
||
3. 手机 Wi-Fi 列表会出现：`ESP32-xxxxxx`
|
||
|
||
---
|
||
|
||
## 3. 手机连接设备热点
|
||
|
||
1. 在手机 Wi-Fi 中连接 `ESP32-xxxxxx`
|
||
2. 若系统自动弹出页面，直接进入下一步
|
||
3. 若没有自动弹出，手动打开浏览器输入：
|
||
|
||
`http://192.168.4.1`
|
||
|
||
> 注意：必须是 `http`，不要用 `https`
|
||
|
||
---
|
||
|
||
## 4. 选择路由器并提交
|
||
|
||
1. 点击“扫描网络”
|
||
2. 选择你家的 Wi-Fi
|
||
3. 输入 Wi-Fi 密码
|
||
4. 点击“连接”
|
||
|
||
成功后页面会提示连接成功，设备热点会在几秒后自动关闭（正常现象）。
|
||
|
||
---
|
||
|
||
## 5. 成功后的现象
|
||
|
||
- 设备不再广播 `ESP32-xxxxxx`
|
||
- 串口会显示“联网成功，获取 IP=... ”
|
||
- 设备进入正常工作状态
|
||
|
||
---
|
||
|
||
## 6. 常见问题
|
||
|
||
### Q1：手机连上热点但打不开页面
|
||
|
||
- 手动访问：`http://192.168.4.1`
|
||
- 关闭手机“私人 DNS / 智能网络切换 / VPN”后重试
|
||
- 确认没有强制跳 HTTPS
|
||
|
||
### Q2：提示连接失败
|
||
|
||
- 检查 Wi-Fi 密码是否正确
|
||
- 确认路由器 2.4G 可用（ESP32-C3 使用 2.4G）
|
||
- 路由器信号太弱时，靠近路由器后重试
|
||
|
||
### Q3：配网成功后热点消失了
|
||
|
||
- 这是正常设计：设备连上路由器后会自动关闭配网热点
|
||
|
||
---
|
||
|
||
## 7. 一句话速记
|
||
|
||
长按按键 → 连 `ESP32-xxxxxx` → 打开 `http://192.168.4.1` → 选 Wi-Fi + 输密码 → 等待成功提示。
|