A modular Adafruit Matrix Portal M4 display: swap between "apps" on one RGB LED matrix — weather, an F1 race-flag indicator, a clock, and whatever comes next.
This repo ships a signed HTTP API on the Matrix Portal M4, with button-gated
pairing and HMAC-SHA256 request signing, plus a swappable-app framework
(App/AppScheduler) driving the RGB matrix. The clock app is the first
renderer; weather and F1 are not built yet — see Roadmap below.
pio run -e adafruit_matrix_portal_m4 -t upload
pio device monitor
Copy include/secrets.h.example to include/secrets.h and fill in your WiFi
credentials first (see Development for the full
build/test/versioning workflow). Press UP on the board to open a 60s
pairing window, then pair with tools/m4client.py — see Client.
The signed API above is the control plane; the display side is next.
- Matrix rendering framework — swappable "apps" driving the RGB panel
- Clock app
- Weather app
- F1 race-flag app
-
/api/appsand/api/appendpoints to list, query, and switch the active app
- Security model — why there's no HTTPS, the pairing flow, HMAC request signing and replay defense
- API reference — endpoint table
- Client — using
tools/m4client.py - Where credentials and settings live — the flash storage design and why the addresses are pinned
- Metrics — CPU/RAM instrumentation,
/api/metrics - Development — build, flash, test, versioning, releases