Firmware v5.27.28 · one file · ~37,090 lines

The whole source,
built to be handed to an AI.

Atlas is one big C++ file. Some assistants can swallow all ~262,000 tokens of it in one upload; some can't. So here it is both ways — the complete file to download, and the same code sliced into 38 labelled chunks, each with a token estimate, so you can feed a smaller-context model exactly the part it needs.

The intended workflow —
  1. Give your assistant the AI dev primer first. Always.
  2. If it can take the whole file: download atlas_v5_27_28.ino below and upload it.
  3. If it can't: browse the chunks, find the section you're changing (e.g. Trivia Bingo, Virtual Pet, Stack), and copy just that chunk in.
  4. Describe the mode, animation, or tweak you want. The model already knows the hardware — it'll build instead of guess.

01

Download the source

The complete firmware, the primer, and the build guide. Right-click → Save, or just click — raw text, no archive.

// FIRMWARE

atlas_v5_27_28.ino

~1.5 MB · 37,090 lines

The entire Atlas firmware in one file. Everything — all 33 modes, the face, the games, the text generator — lives here.

↓ Download .ino
// PRIMER

ATLAS_AI_DEV_PRIMER.md

~20 KB · give this to the AI first

Hardware spec, pin map, firmware layout, and the non-negotiable rules an assistant must follow to write code that compiles.

↓ Download .md
// BUILD GUIDE

ATLAS_BUILD_GUIDE.md

~12 KB · wiring + Arduino IDE setup

Bill of materials, the full pin-wiring table, Arduino IDE board settings, smoke test, and troubleshooting.

↓ Download .md

02

Browse it in LLM-sized chunks

The file split along its own section banners. Pick a chunk, copy it, paste it into your assistant alongside the primer. Each chunk shows its line range and a rough token count so you know what'll fit.

Loading chunks…
Reading atlas_chunks.json…
Select a section from the list
Pick a section on the left to view its source.

“Copy + preamble” prepends a short instruction line telling the model this is one slice of the Atlas firmware and to follow the primer's rules — handy when you're pasting into a fresh chat.


03

Read it here

The primer and build guide, rendered for reading. The primer is the one you hand to an AI assistant; the build guide is for your hands and a soldering iron.

ATLAS_AI_DEV_PRIMER.md Print and Play Creative Manufacturing · v5.27.28
Loading document…

04

Command-line flashers

If you'd rather not flash from the browser — or you're flashing a whole batch of boards — these wrap esptool with sane defaults and good error messages. They flash a pre-compiled binary, so you Export Compiled Binary once in the Arduino IDE, then reuse it.

// CROSS-PLATFORM

flash_atlas.py

Windows / macOS / Linux · Python 3.7+

Auto-detects serial ports. Has a --batch mode that loops: plug a board in, it flashes, you swap the next one. Needs esptool and pyserial.

↓ flash_atlas.py
// WINDOWS

flash_atlas.bat

Windows · double-click to run

No Python needed — calls the esptool.exe bundled with the Arduino ESP32 core. Lists COM ports, asks which one, flashes.

↓ flash_atlas.bat
// FIRMWARE BINARY

The .bin files

you generate these once, in Arduino IDE

Both scripts — and the browser flasher — need the three compiled .bin parts. In Arduino IDE: Sketch → Export Compiled Binary.

↓ See build guide