171 lines
4.6 KiB
Markdown
171 lines
4.6 KiB
Markdown
|
# WiFi配置云端同步功能部署说明
|
|||
|
|
|
|||
|
|
## 🎯 功能概述
|
|||
|
|
|
|||
|
|
本功能实现了ESP32设备WiFi配置信息的云端同步，解决了以下问题：
|
|||
|
|
|
|||
|
|
1. **移除硬编码WiFi信息** - 不再有固定的"315"WiFi配置
|
|||
|
|
2. **用户自主配置** - 用户通过SoftAP模式配置WiFi后，信息会自动同步到云端
|
|||
|
|
3. **数据持久化** - WiFi配置信息既保存在本地NVS，也备份到云端服务器
|
|||
|
|
4. **设备管理** - 甲方可以通过云端API查看和管理所有设备的WiFi配置
|
|||
|
|
|
|||
|
|
## 🔧 修改内容
|
|||
|
|
|
|||
|
|
### ESP32代码修改
|
|||
|
|
|
|||
|
|
1. **移除硬编码WiFi信息**
|
|||
|
|
- `NetworkManager.cpp` - 移除"315"WiFi回退逻辑
|
|||
|
|
- `SystemInitializer.cpp` - 移除硬编码WiFi配置
|
|||
|
|
- `SimpleWiFiConfig.cpp` - 移除WiFi扫描结果中的硬编码信息
|
|||
|
|
|
|||
|
|
2. **新增云端同步模块**
|
|||
|
|
- `WiFiCredentialSync.h/cpp` - WiFi凭据云端同步功能
|
|||
|
|
- 集成到`SimpleWiFiConfig.cpp`中，保存WiFi配置时自动同步到云端
|
|||
|
|
|
|||
|
|
3. **修复配置逻辑**
|
|||
|
|
- 修复WiFi配置模式被错误判断为初始化失败的问题
|
|||
|
|
- 移除重复的WiFi配置实例创建
|
|||
|
|
|
|||
|
|
### 云端服务器
|
|||
|
|
|
|||
|
|
1. **WiFi凭据存储API**
|
|||
|
|
- `wifi_credential_server.py` - Flask服务器，提供WiFi凭据的CRUD操作
|
|||
|
|
- 支持密码加密存储（Base64编码）
|
|||
|
|
- 提供设备管理接口
|
|||
|
|
|
|||
|
|
## 🚀 部署步骤
|
|||
|
|
|
|||
|
|
### 1. 部署云端服务器
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 1. 安装依赖
|
|||
|
|
pip install flask requests
|
|||
|
|
|
|||
|
|
# 2. 启动服务器
|
|||
|
|
cd python_test
|
|||
|
|
python wifi_credential_server.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
服务器将在 `http://47.239.124.130:8080` 启动，提供以下API：
|
|||
|
|
|
|||
|
|
- `POST /api/wifi-credentials` - 上传WiFi凭据
|
|||
|
|
- `GET /api/wifi-credentials/<device_id>` - 下载WiFi凭据
|
|||
|
|
- `GET /api/wifi-credentials` - 列出所有设备
|
|||
|
|
- `DELETE /api/wifi-credentials/<device_id>` - 删除WiFi凭据
|
|||
|
|
- `GET /health` - 健康检查
|
|||
|
|
|
|||
|
|
### 2. 编译ESP32代码
|
|||
|
|
|
|||
|
|
确保在CMakeLists.txt中添加新的源文件：
|
|||
|
|
|
|||
|
|
```cmake
|
|||
|
|
set(SOURCES
|
|||
|
|
# ... 其他文件 ...
|
|||
|
|
"Module/WiFiCredentialSync.cpp"
|
|||
|
|
)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 测试功能
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 测试云端同步功能
|
|||
|
|
python test_wifi_credential_sync.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 📱 用户使用流程
|
|||
|
|
|
|||
|
|
### 首次配置
|
|||
|
|
|
|||
|
|
1. **长按按键** - ESP32进入SoftAP配置模式
|
|||
|
|
2. **连接AP** - 手机连接"FireFly_Config" WiFi（密码：12345678）
|
|||
|
|
3. **打开配置页面** - 浏览器访问 `http://192.168.4.1:9090`
|
|||
|
|
4. **填写WiFi信息** - 输入用户的WiFi账号和密码
|
|||
|
|
5. **自动同步** - 设备保存配置并自动同步到云端
|
|||
|
|
6. **重启连接** - 设备重启后连接用户配置的WiFi
|
|||
|
|
|
|||
|
|
### 后续使用
|
|||
|
|
|
|||
|
|
- 设备重启后自动连接上次配置的WiFi
|
|||
|
|
- 如果WiFi连接失败，自动进入配置模式
|
|||
|
|
- 所有配置信息都有云端备份
|
|||
|
|
|
|||
|
|
## 🔐 安全特性
|
|||
|
|
|
|||
|
|
1. **密码加密** - WiFi密码使用Base64编码存储
|
|||
|
|
2. **设备标识** - 使用MAC地址作为设备唯一标识
|
|||
|
|
3. **本地优先** - 优先使用本地NVS存储的配置
|
|||
|
|
4. **云端备份** - 云端同步失败不影响本地功能
|
|||
|
|
|
|||
|
|
## 📊 管理接口
|
|||
|
|
|
|||
|
|
甲方可以通过以下方式管理设备：
|
|||
|
|
|
|||
|
|
### 查看所有设备
|
|||
|
|
```bash
|
|||
|
|
curl http://47.239.124.130:8080/api/wifi-credentials
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 查看特定设备
|
|||
|
|
```bash
|
|||
|
|
curl http://47.239.124.130:8080/api/wifi-credentials/aabbccddeeff
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 删除设备配置
|
|||
|
|
```bash
|
|||
|
|
curl -X DELETE http://47.239.124.130:8080/api/wifi-credentials/aabbccddeeff
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 🐛 故障排除
|
|||
|
|
|
|||
|
|
### 常见问题
|
|||
|
|
|
|||
|
|
1. **设备一直处于配置模式**
|
|||
|
|
- 检查WiFi账号密码是否正确
|
|||
|
|
- 检查WiFi信号强度
|
|||
|
|
- 查看串口日志确认错误信息
|
|||
|
|
|
|||
|
|
2. **云端同步失败**
|
|||
|
|
- 检查网络连接
|
|||
|
|
- 确认服务器地址正确
|
|||
|
|
- 云端同步失败不影响本地功能
|
|||
|
|
|
|||
|
|
3. **配置页面无法访问**
|
|||
|
|
- 确认已连接到"FireFly_Config" WiFi
|
|||
|
|
- 尝试访问 `http://192.168.4.1:9090`
|
|||
|
|
- 检查防火墙设置
|
|||
|
|
|
|||
|
|
### 日志分析
|
|||
|
|
|
|||
|
|
关键日志标识：
|
|||
|
|
- `SimpleWiFiConfig` - WiFi配置相关
|
|||
|
|
- `WiFiCredentialSync` - 云端同步相关
|
|||
|
|
- `SystemInitializer` - 系统初始化相关
|
|||
|
|
|
|||
|
|
## 📈 后续扩展
|
|||
|
|
|
|||
|
|
1. **数据库存储** - 可以将JSON文件存储改为数据库
|
|||
|
|
2. **用户认证** - 添加用户登录和权限管理
|
|||
|
|
3. **设备分组** - 支持设备分组管理
|
|||
|
|
4. **配置模板** - 支持WiFi配置模板
|
|||
|
|
5. **监控告警** - 设备离线告警功能
|
|||
|
|
|
|||
|
|
## ✅ 验证清单
|
|||
|
|
|
|||
|
|
部署完成后，请验证以下功能：
|
|||
|
|
|
|||
|
|
- [ ] ESP32启动后不再尝试连接"315"WiFi
|
|||
|
|
- [ ] 长按按键可以进入配置模式
|
|||
|
|
- [ ] 配置页面可以正常访问和使用
|
|||
|
|
- [ ] WiFi配置保存后设备可以正常连接
|
|||
|
|
- [ ] 云端API可以正常访问
|
|||
|
|
- [ ] 设备重启后自动连接上次配置的WiFi
|
|||
|
|
- [ ] 配置信息已同步到云端服务器
|
|||
|
|
|
|||
|
|
## 📞 技术支持
|
|||
|
|
|
|||
|
|
如有问题，请检查：
|
|||
|
|
1. ESP32串口日志
|
|||
|
|
2. 云端服务器日志
|
|||
|
|
3. 网络连接状态
|
|||
|
|
4. API接口响应
|