Skip to content

Install firmware

Use the USB installer on a desktop browser with Web Serial support. Connect the board with a USB data cable and close serial monitors or other programs holding the port.

  1. Choose a release. Enable Include release candidates only if you want a test release.
  2. Choose the exact hardware and flash layout. Read the installation changes shown beneath it.
  3. Confirm those changes, connect, then choose the board's serial port.
  4. Keep USB connected until installation completes. Reconnect after reboot if needed.

If no release is listed, a matching tagged release has not been published yet. Developers can build from source.

Atom Matrix

The classic ESP32 package installs normal firmware directly. Its merged USB image can replace saved storage; read the installer's warning before continuing. Use an app-only update for ordinary upgrades when the existing layout already matches.

ESP32-S3

S3 installation includes the dedicated recovery app. Choose one of these plans:

  • Default recovery installation clears normal A/B images and OTA selection, then starts recovery. Upload the matching normal app afterwards.
  • Install selected release in slot A and boot it installs recovery and the paired normal app, then selects slot A. It replaces OTA selection history.
  • Keep installed firmware and settings updates recovery while retaining A/B and OTA selection. Use it only with the same installed partition layout.

The S3 sparse plans preserve NVS, PHY data and model storage. The reset plan's A/B clearing is still destructive to installed apps. App-install and preserve are mutually exclusive. A sparse recovery ZIP is a set of segments and manifests, not a merged binary to flash at offset zero.

If recovery starts, pair a phone and select the matching normal application .bin in the recovery updater. You can also configure recovery Wi-Fi from the phone. App download links are still placeholders, so native apps currently need a developer build.

If the port won't connect, use the board's BOOT/reset procedure, then retry. See troubleshooting and the detailed recovery contract for plan boundaries and boot selection.