Updates
Signed updates for the firmware, the Wi-Fi chip and the web page, with slots and rollback.
The connector takes signed .dbfw files. Each file holds one part, and the connector sees which part it is.
| Part | After the update |
|---|---|
| Firmware | Goes into the next slot, the connector restarts into it |
| Wi-Fi chip | Both chips restart |
| Web page | Served at once |
| Bootloader, partition table | Written in place, no restart |
Install
- In the web UI under Firmware (demo), pick a file or give an
http://orhttps://URL. - From your own server, send
{"t": "ota", "target": "p4", "url": "http://..."}. - Over the API,
POST /api/otawith the file, orPOST /api/ota/url.
Checks and rollback
The connector checks the signature, the security level and the SHA-256, then writes the new firmware into the slot after the running one and restarts into it. The new firmware must reach the network within 2 minutes and then stay up for 20 seconds. If it does not, or it crashes, the old slot starts again.
- 1Signature
- 2Security level
- 3SHA-256
- 4Restart into the new slot
- 5Network within 2 min, then 20 s up
- Kept
Any step fails, or the new firmware crashes? The old slot starts again.
Four slots
A connector takes only files signed with the key its firmware was built with. It refuses a file below its own security level, so an old firmware with a known hole cannot come back. Under Firmware slots you can start an older slot. It must confirm itself like a new update.
Releases
On the GitHub releases page.
| File | Use |
|---|---|
deckconnector-factory.bin, ota_data_initial.bin, deckconnector.bin, manifest.json | The flasher and esptool |
deckconnector-vX.Y.Z.dbfw, deckconnector-web-vX.Y.Z.dbfw | Signed firmware and web page. A release without signing has none |
SHA256SUMS | Checksums of all files |
Check a download with sha256sum -c SHA256SUMS --ignore-missing.
Web page
The web page can change without a firmware update and stays over restarts. When it does not fit the firmware, the connector serves the page built into its firmware. Remove uploaded page goes back to that page.
Recovery over USB
When the connector no longer starts, flash it over USB-C. An Update in the flasher keeps the settings. The chip cannot be bricked, because its USB loader cannot be overwritten.