Skip to content
DeckConnectorSet it up
Skip to Content

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.

PartAfter the update
FirmwareGoes into the next slot, the connector restarts into it
Wi-Fi chipBoth chips restart
Web pageServed at once
Bootloader, partition tableWritten in place, no restart

Install

  • In the web UI under Firmware (demo), pick a file or give an http:// or https:// URL.
  • From your own server, send {"t": "ota", "target": "p4", "url": "http://..."}.
  • Over the API, POST /api/ota with the file, or POST /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.

  1. 1Signature
  2. 2Security level
  3. 3SHA-256
  4. 4Restart into the new slot
  5. 5Network within 2 min, then 20 s up
  6. Kept

Any step fails, or the new firmware crashes? The old slot starts again.

Four slots

slot 0older firmware
slot 1running
slot 2update goes here
slot 3

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.

FileUse
deckconnector-factory.bin, ota_data_initial.bin, deckconnector.bin, manifest.jsonThe flasher and esptool
deckconnector-vX.Y.Z.dbfw, deckconnector-web-vX.Y.Z.dbfwSigned firmware and web page. A release without signing has none
SHA256SUMSChecksums 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.

On this page