tamagotchi

Firmware for an ESP32-C3 SuperMini, written in C++ with the Arduino core and built/flashed entirely from the terminal.

Toolchain

• arduino-cli — build, upload, monitor
• ESP32 Arduino core 3.3.8 (esp32:esp32)
• Editor: Zed — .ino files are treated as C++; clangd reads firmware/build/compile_commands.json for code intelligence

The arduino-cli config is committed to the repo (firmware/arduino-cli.yaml), so make and the editor both use it via --config-file — no global setup needed. To reproduce on another machine, install the tool and the ESP32 core:

brew install arduino-cli
arduino-cli --config-file firmware/arduino-cli.yaml core update-index
arduino-cli --config-file firmware/arduino-cli.yaml core install esp32:esp32

Daily workflow

Command	What it does
make build	Compile the sketch
make flash	Compile + upload to the board
make monitor	Open the serial monitor (115200, Ctrl-C exits)
make flash-monitor	Flash, then open the monitor
make db	Regenerate compile_commands.json for Zed
make format	Auto-format all sources (clang-format)
make format-check	Check formatting without editing (CI-friendly)
make ports	List connected boards
make clean	Delete build artifacts

Linting & formatting

• Formatting — clang-format, configured in .clang-format (Google style, 2-space, 100 cols). Zed formats on save via clangd; make format does the whole tree from the terminal.
• Linting — clang-tidy, configured in .clang-tidy (bug-finding checks). It runs inside the editor: clangd has clang-tidy built in, enabled by the --clang-tidy flag in .zed/settings.json. No separate binary needed. For a terminal lint pass, brew install llvm provides a standalone clang-tidy.

The board's USB port is auto-detected. If it's wrong, pass it explicitly:

make flash PORT=/dev/cu.usbmodemXXXX

Board notes

• USB CDC On Boot is enabled in the FQBN (CDCOnBoot=cdc) so Serial works over the SuperMini's native USB — no separate UART adapter needed.
• Onboard blue LED is on GPIO8 and is active-LOW (LOW = on).
• If an upload fails to start, force download mode: hold BOOT, tap RESET, release BOOT, then re-run make flash.