更新 ESP32 Agent 固件：正式版与 TestFlight 版，通过 Wi-Fi 或 USB
板子设置好之后，在 iPhone App 里通过 Wi-Fi 更新即可。只有第一次安装、板子固件太旧无法通过 Wi-Fi 更新，或想彻底重来时，才需要用网页安装器通过 USB 安装。
板子固件分两个渠道发布，分别对应不同的 App 版本。
| 渠道 | App | 安装页 |
|---|---|---|
| 正式版 | App Store 版读取 handsy.tech/firmware/firmware.json。 |
handsy.tech/install |
| TestFlight 版 | TestFlight 版读取 handsy.tech/firmware/testflight/firmware.json。 |
handsy.tech/install?build=testflight |
每个 App 只提供自己渠道的更新。请安装和你的 App 对应渠道的固件。当前版本见更新记录。
每个版本都有签名。App 会先校验签名和固件，再发给板子。
在 App 里更新
Section titled “在 App 里更新”打开设置 → 开发板。固件一栏显示板子上的版本，并提供检查更新和立即更新。有可用更新时，助手页也会显示提示。
满足这些条件才能开始更新：
- 板子已连接到 App。
- iPhone 连着板子的 Wi-Fi。固件通过这个 Wi-Fi 传送，上网继续走蜂窝数据。
- 没有正在运行的任务或录制。等它结束再更新。
- 板子固件足够新，支持 Wi-Fi 更新。很旧的板子需要先用网页安装器通过 USB 安装一次。
保持 App 打开、板子插着。大约需要一分钟。最后板子会重启，之后重新开启屏幕镜像。你的意图和设置不受影响。
如果当前 App 需要更新的板子固件，板子一连上就会显示需要更新板子固件。
- 连接中断会自动重试，最多三次。
- 新固件完整写入并校验通过之前，板子一直保留当前固件。发送失败不会改动板子。
- 新固件不能正常启动时，板子会自动回到之前的固件。
用网页安装器重新安装
Section titled “用网页安装器重新安装”通过 USB 在 handsy.tech/install 重新安装会清空板子：蓝牙配对、热点密码，以及 station 模式等设置。适合想彻底重来，或板子无法通过 Wi-Fi 更新时使用。
- 安装和你的 App 对应渠道的固件。找不到板子时，按住 BOOT 键再插上，见连不上板子。
- 在 iPhone 上打开设置 → 蓝牙，点旧的 ESP32 Agent 旁边的 (i)，选择忽略此设备。
- 把板子插回 iPhone，在 App 里重新配对，并用新的密码加入板子热点。
安装器出错时，点下载日志，把文件发到 [email protected]。