KJX ENGINEERING GUIDE · 03
ESP32 联网、配置与 OTA 验收清单
覆盖首次配网、凭据存储、掉线恢复、升级失败回滚和版本审计。
本站流程 · 需生产配置复测
中级
预计 2–4 小时
核查 2026-08-09
原厂中控套件参考 · ESP32-S3 智能家居中控
使用边界：本页是可简芯原创工程检查流程，不是第三方教程改名，也不代表所有同名板卡已实测通过。当前适用于：使用 ESP-IDF 的联网终端和网关。正式交付前须把目标板卡、固件、外设批次和验收结果写入订单或技术协议。
准备与目标
适用范围使用 ESP-IDF 的联网终端和网关
当前状态本站流程 · 需生产配置复测；不得直接当作量产验证结论
开始前准备
- 工程基线通过
- 测试 AP
- HTTPS 固件地址
- 双分区或明确回滚策略
完成后应得到
- 联网失败可诊断
- 升级过程可回滚
- 生产凭据不进入代码仓库
01 · 首次配置
配置入口要有超时、退出和恢复出厂逻辑。
- 定义配网触发方式和状态指示。
- 凭据写入受控存储，不打印完整密码。
- 错误时返回可理解的失败原因。
✓ 配网可取消✓ 敏感信息不进日志✓ 恢复出厂可用
02 · 稳定性
把认证、DHCP、DNS 和业务服务分层记录。
- 测试断电、AP 重启和弱信号。
- 使用退避重连，限制高频扫描。
- 记录在线率、重连次数和最长恢复时间。
✓ 断线不死机✓ 重连有上限与退避✓ 业务状态可观测
03 · 升级与回滚
升级包要校验，首次启动要确认，失败必须可恢复。
- 记录当前/目标版本和硬件兼容范围。
- 验证下载中断、校验失败和首次启动失败。
- 成功后保存升级结果和设备版本。
✓ 错误包不能启动✓ 回滚路径已演练✓ 版本可从后台查询
故障定位
| 现象 | 常见原因 | 建议动作 |
|---|---|---|
| 升级后循环重启 | 硬件版本、分区、配置迁移或看门狗问题 | 触发回滚并保留首个异常启动日志。 |
验收与归档
- 首次配网与恢复出厂通过
- 断网恢复连续三次通过
- 升级中断可恢复
- 生产密钥未写入仓库
建议随订单保存：板卡/PCB 版本、固件与依赖版本、BOM 修订号、操作人、测试日期、原始日志、异常样本和最终结论。图片演示不能替代这些记录。
