⬆️

Firmware Update

You publish, the box upgrades itself

Page 30 of 31 MCP / API open OTA updates

The update page lists every firmware build available on the server β€” version, notes, size and MD5. Pick one and the device upgrades itself: download to SD in 16 KB chunks with resume, verify the full MD5, write the image into the inactive app partition, then switch the boot partition and reboot. A failed attempt can be retried and the previous firmware is still intact, so the device cannot be bricked.

The partition table provides two 3 MB app slots (app3M_fat9M_16MB). The page shows percentage, bytes downloaded, speed and ETA throughout, warns against cutting power, and the watchdog is relaxed to 45 s during the flash phase.

Screen

On-screen interface

A recreation of this page on the 2.41-inch AMOLED display (600 Γ— 450). Actual interaction and layout follow the latest firmware.

Firmware Running v29
v292.10 MB Β· MD5 verifiedActive
v302.12 MB Β· MD5 verifiedUpdate
v282.08 MB Β· MD5 verifiedUpdate
v272.05 MB Β· MD5 verifiedUpdate
Server versions4 Β· auto refresh MD5
Download speedabout 11 KB/s
Partitionapp3M_fat9M_16MB Β· A/B dual slot
Downloading 62% Β· 1.31 / 2.12 MB Β· leftabout 1m12s
Writes the standby partition after verification Β· rollback safe
Screen Β· Page 30
Recreated from the real firmware layout; the display type can be changed in the admin panel
Highlights

Key capabilities

πŸ“‹

Version list

Version, notes, size and MD5 in one list.

πŸ”

Resumable download

16 KB chunks; reconnects continue where they left off.

βœ…

Full MD5 check

Nothing is written to flash until the hash matches.

πŸ›‘

A/B rollback

Dual slots β€” a failed update still boots the old firmware.

Specifications

Technical specs

PartitionsTwo 3 MB app slots (app3M_fat9M_16MB)
Download16 KB chunks / resume / 6 s per-chunk timeout, 6 retries
VerificationFull MD5 comparison
Flashing128 KB slices, internal RAM buffer, watchdog relaxed to 45 s
Use Cases

Typical scenarios

Remote releases

Publish a build to the server and let field devices pull it.

Fleet maintenance

No USB teardown per unit β€” two taps to switch versions.

Commands

Related commands

page 30  Jump to Firmware Update
fw list  Fetch the server firmware list
fw up <index|version>  Start upgrading to a given build
fw sd  Upgrade from a file on the SD card
fw abort  Abort the current upgrade
fw ver  Show the running version

Read the full API & command reference β†’

⚠ Boundaries & notes
  • Power and network must stay up during the update; cutting power invalidates the download (the old firmware is unaffected).
  • Only one upgrade task may run at a time.
  • Download speed depends on the link β€” about 11 KB/s measured, so a 2 MB image takes roughly 3 minutes.

Other feature pages