The firmware image is the flashable ESP32 application asset selected and verified by the desktop app.
firmware image
Firmware
Official firmware service
Official updates are delivered through the desktop app after account sign-in, activation code redemption, and device binding.
固件
官方固件更新服务
官方更新通过桌面 app 交付，需要账号登录、激活码兑换和设备绑定。
Firmware assets固件资产
Firmware assets固件资产
The merged bin packages the expected flash layout for agent-status-light-v1 and is checked before flashing.
agent-status-light-esp32-wroom32-v<version>-merged.bin
The manifest carries version, chip, format, flash offset, size, and SHA-256 metadata for verification.
agent-status-light-esp32-wroom32-v<version>-manifest.json
固件文件是由桌面 app 选择和校验的 ESP32 可刷写应用资产，也可称为 firmware image。
firmware image
merged bin 打包 agent-status-light-v1 预期 flash layout，并在刷写前校验。
agent-status-light-esp32-wroom32-v<version>-merged.bin
manifest 携带版本、芯片、格式、刷写偏移、大小和 SHA-256 metadata。
agent-status-light-esp32-wroom32-v<version>-manifest.json
Official update path官方更新路径
Official update path官方更新路径
-
1
Sign in through the desktop app
Sign in through the desktop app with email password login, GitHub OAuth, or a backup email link.
signin -
2
Activate the connected device
Redeem an activation code and bind the connected ESP32-WROOM-32 device.
activate -
3
Use a short-lived token for official firmware assets
The desktop app requests entitlement-checked metadata and a short-lived token for official firmware assets.
metadata -
4
Flash firmware
Before flashing, the app verifies manifest metadata, size, SHA-256, chip, format, and flash offset.
verify -
1
通过桌面 app 登录
在桌面 app 中通过邮箱密码、GitHub OAuth 或备用邮箱链接登录。
signin -
2
激活当前连接的设备
兑换激活码，并绑定当前连接的 ESP32-WROOM-32 设备。
activate -
3
使用短期 token 获取官方固件资产
桌面 app 请求权益校验后的 metadata 和官方固件资产短期 token。
metadata -
4
刷写固件
刷写前，app 会校验 manifest metadata、大小、SHA-256、芯片、格式和刷写偏移。
verify
Compatibility
Compatibility
The ordinary service path targets ESP32-WROOM-32 hardware running agent-status-light-v1. RC and prerelease assets do not enter the stable user update path.
Final users do not need Arduino IDE, arduino-cli, PlatformIO, ESP-IDF, or esptool.
Source can still be built locally; official service rights control the official update service and short-lived token, not closed-source DRM.
ESP32-WROOM-32 · agent-status-light-v1 · SHA-256
兼容范围
兼容范围
普通服务路径面向运行 agent-status-light-v1 的 ESP32-WROOM-32 硬件。RC/prerelease 资产不进入普通用户稳定更新路径。
最终用户不需要 Arduino IDE、arduino-cli、PlatformIO、ESP-IDF 或 esptool。
源码仍可自行构建；官方服务权益控制的是官方更新服务和短期 token，不是闭源 DRM。
ESP32-WROOM-32 · agent-status-light-v1 · SHA-256