KJX ENGINEERING GUIDE · 03

ESP32 联网、配置与 OTA 验收清单

覆盖首次配网、凭据存储、掉线恢复、升级失败回滚和版本审计。

本站流程 · 需生产配置复测 中级 参考学习时长 2–4 小时 核查 2026-08-09
返回所选配置与 BOM 商城搜索 ESP32
ESP32-S3-EYE 视觉开发板参考原作者实物参考 原作者实物参考 · ESP32-S3-EYE 视觉开发板参考
适用说明：本手册用于 使用 ESP-IDF 的联网终端和网关。实施时请以目标板卡、固件和外设的实际版本为准；正式交付的功能、资料与验收标准以订单或技术协议为准。
返回配置：ESP32-S3-EYE 视觉开发板参考 · 同版参考基线。手册是适用范围内的工程参考，不代表所选配置已经完成实测。

准备与目标

适用范围使用 ESP-IDF 的联网终端和网关
实施方式本站流程 · 需生产配置复测；按目标硬件执行并记录结果

开始前准备

  • 工程基线通过
  • 测试 AP
  • HTTPS 固件地址
  • 双分区或明确回滚策略

完成后应得到

  • 联网失败可诊断
  • 升级过程可回滚
  • 生产凭据不进入代码仓库

01 · 首次配置

配置入口要有超时、退出和恢复出厂逻辑。

3 个步骤
  1. 定义配网触发方式和状态指示。
  2. 凭据写入受控存储，不打印完整密码。
  3. 错误时返回可理解的失败原因。
✓ 配网可取消✓ 敏感信息不进日志✓ 恢复出厂可用

02 · 稳定性

把认证、DHCP、DNS 和业务服务分层记录。

3 个步骤
  1. 测试断电、AP 重启和弱信号。
  2. 使用退避重连，限制高频扫描。
  3. 记录在线率、重连次数和最长恢复时间。
✓ 断线不死机✓ 重连有上限与退避✓ 业务状态可观测

03 · 升级与回滚

升级包要校验，首次启动要确认，失败必须可恢复。

3 个步骤
  1. 记录当前/目标版本和硬件兼容范围。
  2. 验证下载中断、校验失败和首次启动失败。
  3. 成功后保存升级结果和设备版本。
✓ 错误包不能启动✓ 回滚路径已演练✓ 版本可从后台查询

故障定位

现象常见原因建议动作
升级后循环重启硬件版本、分区、配置迁移或看门狗问题触发回滚并保留首个异常启动日志。

验收与归档

  • 首次配网与恢复出厂通过
  • 断网恢复连续三次通过
  • 升级中断可恢复
  • 生产密钥未写入仓库

建议随订单保存：板卡/PCB 版本、固件与依赖版本、BOM 修订号、操作人、测试日期、原始日志、异常样本和最终结论，方便后续复现、维护与售后。