Source Repository

The firmware lives in a public repository next to this documentation.

Repository layout

kitchenAnalyzer/
├── include/
│   ├── config.h        pin macros and device configuration
│   └── README          placeholder kept for the include folder
├── src/
│   └── main.cpp        the whole device firmware
├── lib/
│   └── README          placeholder for project-local libraries
├── test/
├── platformio.ini      board, framework and library dependencies
└── README.md

The firmware is small on purpose. Almost all behaviour lives in src/main.cpp, and every pin number lives in include/config.h, so a board change is a one-file edit. See the Software chapter.

Library dependencies

platformio.ini pulls three libraries:

Building and flashing

cd kitchenAnalyzer
python3 -m venv .venv && source .venv/bin/activate
pip install platformio
pio run                 # build only
pio run --target upload # build, flash and reset

PlatformIO installs the ESP32 toolchain on first run, so no separate IDE setup is needed.