Codex Local
bf1233d5df
ci / verify (push) Canceled after 0s
Add customer and operator login, BLE provisioning, device fleet controls, call memory, memoir generation, and refreshed family and maintenance portals. Include API contracts, migrations, firmware sources, tests, assets, and deployment documentation.
48 lines
3.1 KiB
Markdown
48 lines
3.1 KiB
Markdown
# EchoEar 烧录助手（Windows）
|
||
|
||
这是设备初始化与烧录工具的 Windows 图形界面，复用 `device_prepare.py` 和 `device_flash.py` 的校验、完整备份和分区写入流程。
|
||
|
||
## 交付与使用
|
||
|
||
本机交付位置：`E:\Codex\story\deliverables\echoear-flasher-20261004\EchoEarFlasher.exe`。
|
||
|
||
双击程序，选择维护后台下载的 `burn-in` JSON，确认 COM6 和 `B4:3A:45:16:34:A8`，保持默认的重新初始化模式，检查预览后开始。身份恢复模式保留设备应用固件，清理旧 Wi-Fi、语音凭据和运行状态，再写新工厂身份。
|
||
|
||
界面会显示出厂编号、平台地址、串口、预期 MAC 和写入区域。任何配置改变都会使已生成的预览失效。预览不打开串口；真实写入需要在界面确认目标与清理范围。进度按实际阶段显示；备份或校验失败会停止后续操作，不显示为成功。
|
||
|
||
完整固件模式使用配套构建目录，重写 Bootloader、分区表、应用、初始 OTA 选择、模型和显示资源，并清理旧运行配置。当前分发的是已有 `.28` 构建，尚未完成真机验收，清库后的身份恢复无需升级固件。
|
||
|
||
烧录成功后手动复位/断电重启，通过家庭端或小程序重新蓝牙配网并绑定老人。具体云端创建与配网流程见 [设备恢复说明](device-reinitialize-and-flash-20261004.md)。
|
||
|
||
## 环境
|
||
|
||
本机已有 ESP-IDF Python，程序会自动寻找；也可在高级设置选择解释器。依赖是 Python 3.10+、esptool 4.x/5.x、esp-idf-nvs-partition-gen 与 pyserial。本机验证版本为 Python 3.12、esptool 4.12.0、NVS 生成器 0.1.9、pyserial 3.5。
|
||
|
||
这是使用本机 Python 环境的原生 Windows 应用，分发目录应一起保留；它没有将 Python 运行时打包进 EXE。后台子进程隐藏运行，GUI 不显示设备密钥，不自动上传工厂材料或 Flash 备份。
|
||
|
||
## 源码与构建
|
||
|
||
- `firmware/echoear-platform-agent/tools/flash-app/EchoEarFlasher.cs`：C# WinForms 界面。
|
||
- `firmware/echoear-platform-agent/tools/flash_app_bridge.py`：JSONL 进程桥接、预览会话、冻结输入检查。
|
||
- `firmware/echoear-platform-agent/tools/flash-app/build-app.ps1`：使用系统 .NET Framework 编译器构建与按白名单打包，不安装 NuGet。
|
||
|
||
```powershell
|
||
Set-Location 'E:\Codex\story\platform\firmware\echoear-platform-agent'
|
||
.\tools\flash-app\build-app.ps1 -OutputDirectory 'E:\Codex\story\deliverables\echoear-flasher-20261004'
|
||
```
|
||
|
||
生成文件及完整 Flash 备份包含设备秘密，默认保存到程序指定的私有备份目录。源码/交付包不包含真实设备密钥。
|
||
|
||
## 验证
|
||
|
||
62 项 Python 测试通过（烧录引擎 40、初始化 6、界面桥接 16），19 项原生界面检查通过。真实 NVS 生成器及当前固件构建通过离线预览联调。界面已渲染检查，串口下拉、写入区域表、确认开关和后台入口正常显示。
|
||
|
||
离线 UI 自检不会启动桥接或访问硬件：
|
||
|
||
```powershell
|
||
.\EchoEarFlasher.exe --ui-smoke-test .\ui-test.json
|
||
.\EchoEarFlasher.exe --render-preview .\preview.png
|
||
```
|
||
|
||
本次没有创建线上设备、执行真实烧录或完成配网/通话验收。
|