FlinT OS

Open firmware for FlinT devices · pluggable faces · ESP32‑C3 / ESP‑IDF
by DeeTech Labs

Quick start · Docs · Add a face · Discussions

---

What it is

FlinT OS is the firmware platform for FlinT devices (base board: FlinT Spark), by DeeTech Labs.

Core services stay stable — time, Wi‑Fi, settings, shell, assets. Faces are plugins: ship a new look without rewriting networking or the clock.

Built-in Digital face · day modes · glances Soft-clock + SNTP + timezone DB Wi‑Fi STA · settings on cfg LittleFS Face picker · event bus · boot splash

Stack ESP‑IDF · LovyanGFX (slim) -Os · no C++ exceptions / RTTI Dual OTA · assets on storage Input: USB serial (buttons later)

---

Quick start

Board: FlinT Spark (ESP32‑C3, USB Serial/JTAG) · ESP‑IDF v5.x / v6.x

cp components/flint/config/secrets.example.h components/flint/config/secrets.h
# edit SSID / password (secrets.h is gitignored)

idf.py set-target esp32c3
idf.py build
idf.py -p /dev/ttyACM0 flash monitor

Optional: idf.py -DFLINT_BOARD=flint_spark build · board guide: components/flint/board/README.md

Serial controls

Type in the IDF monitor (no Enter except where noted):

Key	Action
Enter	Face picker / apply face / open Face row
s	Settings
p / n	Navigate
+ / -	Adjust selected setting
q / Esc	Back to face
h	Help in log

Prefs and soft clock live on cfg LittleFS (survive asset reflash). Icons load from storage — assets/README.md.

Hardware — FlinT Spark pinout

Default board id: flint_spark. Display: GMT028-class ST7789 240×280 SPI (UI landscape 280×240).

Signal	GPIO
SCK	6
MOSI (SDA)	7
CS	10
DC	9
RST	8
VCC / LED	3.3V
GND	GND

Change pins/panel via JSON under components/flint/board/, then rebuild with -DFLINT_BOARD=….

Project layout

flint_os/
├── main/                 # app_main only
├── config/               # sdkconfig.defaults + partitions.csv
├── components/
│   ├── flint/            # ★ product firmware
│   └── LovyanGFX/        # slim graphics component
├── tools/                # codegen (or ./flint_tools)
├── assets/               # PNG → LittleFS pack
├── community/            # face templates
└── brand/                # marketing logo

---

Docs

Doc	Contents
docs/ARCHITECTURE.md	Dependencies, Face contract, dirty events
docs/MODULES.md	What each directory owns
docs/FACES.md	Add / register a face
docs/ESP-IDF.md	Build / flash / monitor cheatsheet
assets/README.md	LittleFS icon pack
components/flint/board/README.md	Board profiles
tools/README.md	Codegen tools
CHANGELOG.md	Release history (Keep a Changelog)

Face SDK: components/flint/sdk/flint_face_sdk.h

---

Contributing

CONTRIBUTING.md · SUPPORT.md · SECURITY.md · CODE_OF_CONDUCT.md · Discussions

---

License

Copyright 2026 DeeTech Labs · Apache License 2.0 · keep attribution in NOTICE

---

Contributors

Thanks to everyone who has contributed to FlinT OS:

_{FlinT OS · DeeTech Labs · Apache 2.0 · ESP‑IDF}