Firmware

Flash a board, from your browser.

No Arduino IDE, no command line. A supported browser talks to the board over Web Serial and writes the firmware directly. Every ATLAS device that runs on an ESP32 flashes here. Locke, being a Raspberry Pi, updates a different way. Each panel shows the current version and what changed.

What browser flashing needs. Desktop Chrome, Edge, or Opera, a data-capable USB cable, and a page served over https or localhost. Web Serial is not available in Safari, Firefox, or on mobile. If a board will not flash, hold BOOT, tap RESET, release BOOT to force download mode, then try again.
01

The devices

Pick a board. Versions and notes update live from the firmware registry. One rule worth knowing: Atlas and the Library version together. The room protocol and the admin lock span both devices, so flash the pair in the same sitting; v7.12.0 and v1.10.0 belong to each other.

Atlas

v7.12.0
Flash the handheld from your browser over Web Serial.
  • Wireless peer-to-peer multiplayer between two Atlases.
▸ Flash Atlas

Pioneer

v1.4.1
Name it, then flash the rover from your browser. The flasher writes your chosen name into the board.
  • Tuning notes for the TT gear-motor swap on a 1S cell.
▸ Name and flash Pioneer

Relay

v1.2.46
Flash a Heltec V3 or V4 mesh node from your browser.
  • LoRa mesh on a private ATLAS channel, with a web console.
▸ Flash Relay

Library

v1.10.0
Flash the base station from your browser. The microSD card and everything on it is never touched.
  • Films, books and music for every Atlas in the room.
▸ Flash Library

Locke

v0.28.6
Locke is a Raspberry Pi, so it does not flash from the browser. It updates from an SD image or the on-console updater.
  • Stereo output, hall reverb, and a live music readout.
▸ Flash a Locke card
New to this? The Codex explains the pieces: Web Serial and ESP Web Tools.
02

Source, primers & binaries

Every device's firmware source, the primer to build it, and the compiled image, all downloadable. Open source, yours to modify.

Atlas

Source & chunk browser → atlas_v7.12.0.ino dev primer merged .bin

Library

atlas_library_v1.10.0.ino Library spec Reader spec merged .bin

Pioneer

pioneer_v1_4_1.ino build primer partitions.csv merged .bin

Relay

factory .bin (V4) Meshtastic source →
A Meshtastic (GPLv3) build with the Atlas additions.

Locke

locke.ino (console) cartridge primer SD image & steps →
SD image: coming soon.