v3.14-v3.15: timer/alarms, log tail, gestures (claps/taps), SSE gesture events, dim schedule + gesture settings
Documentation review: current-firmware-only, Matrix Gateway naming, full feature coverage
- every old-firmware version tag/caveat removed across all pages (headings
de-tagged with inbound anchors fixed in lockstep); Matrix-Gateway's intro
changelog replaced with current-state prose
- naming: Matrix Portal -> Matrix Gateway (wire strings/repo URLs kept)
- accuracy: capabilities sample matches fw 3.13 (opsBin boolean, compositing,
33 ops, 12 effects, conditional feature tokens, no api/effectParams/ha);
opsb endpoint + stream record 0x06 documented; scope/spectro/maze added;
Weather Sky references replaced (merged into Weather); BTC min-wall,
Photo Frame badge, Livestream badge, broken images -> gallery raw URLs
- new-feature coverage: icon_svg + interactive manifest rows, takeover /
quiet-in-attract / taps+presses in the games section, paginate +
get_ha_states helpers, dependency list (httpx2, Pillow, babel, dateutil),
can_* flag inventory, OpenAPI discovery (gateways + companion)
Strip legacy-client language: one honest version, effectParams removed, opsBin level framing (fw 3.12)
Wiki: microSD (browse/mkdir/recursive delete), oscilloscope, depth-4 PSRAM framebuffer (fw 3.10-3.11)
v3.7.0: onboard SHTC3 temp/humidity sensor (/api/environment, environment token)
v3.6.0: /api/sound (tones/chimes), gradient radial/angle/dither
Canvas API page: comprehensive refresh — discovery JSON to the real v3.5 shape (rects/stream/atlas/effectDefs/openapi field, 22 ops, 10 effects), atlas state shape fixed, MQTT reference dropped, ?fmt claim corrected, panel example realistic, 507 list complete, section order fixed; fw 3.4 tags -> 3.5 everywhere (3.4 was never released separately)
Matrix gateway v3.4.0: audio-reactive effects (spectrum, soundwall, audio param); drop stale TCP_NODELAY mention
Merge Date Card→Date and Weather Panel→Weather Sky in docs
Merge Overview→Dashboard and HA Dashboard→Home Assistant in docs; refresh screenshots
Every functional app is dual-surface: matrix views for all 43 apps + screenshots; toggle now matrix-only at top of settings
Dual-view apps: document canvas_view + the matrix_view toggle (Writing-Apps §7); fold World Time/Countdown Bars into World Clock/Countdown as dual-view + add Public Holidays desk-calendar panel view (Built-in-Apps, Matrix-Gateway)
v3.3.0: PSRAM network buffers, trough class ended
Matrix gateway v3.2.0: canvas stream channel, SSE status, glyph blitter, gzipped dashboard
Docs update for companion 2.9.x: quiz app type, channels/quizzes on the Matrix panel (canvas_art + Show on Matrix toggle), new apps (Stock Graph, Movie Quotes, Weather Panel, Scoreboard, HA Dashboard, Aquarium), firmware 3.1 delta frames + named atlases, smart-refresh cadence; new panel screenshots
Matrix Gateway 3.0/3.0.1: SSE events, display-state mode+flaps, MQTT/HA removal, QOI transitions, UTF-8 text, ops throughput; document the v2.2 files/brightness/reboot surface
Matrix Gateway v3.0: native esp_http_server, SSE live preview, raw-body uploads, MQTT/HA removed
Matrix gateway: v2.0.0 — Waveshare ESP32-S3-RGB-Matrix board (was Adafruit MatrixPortal S3)
Wiki: rewrite backward-looking phrasing in present tense
Drop 'as it always did / was', 'no longer', 'it did not always work that way'
and similar comparisons to prior behaviour — they only make sense to readers who
saw earlier versions. State the current behaviour as simply how it works.
Matrix Gateway + canvas: bring the wiki up to firmware 1.24 / companion 2.8
- New Canvas API page (full /api/canvas/* reference) + sidebar entry.
- Gateway-API: Matrix send paths are /api/frames/* (not /api/rs485/*); module
rows are {id, flapIndex, flapChar}; MQTT frames/tx + frames/send, rx removed;
maintenance is SplitFlap-only; panel.depth in status; canvas/effects/effectParams
in capabilities; features list corrected.
- Matrix-Gateway: frames are one-way (no v/A queries, no replies, no serials);
no module registry; canvas section rewritten to point at the Canvas page;
bit-depth auto-clamp note for large panels.
- Built-in-Apps / Writing-Apps: six effects with hue/density, new Animation and
Ticker apps, QOI, and the canvas helper's ticker/anim/paste methods.
RS-485 SplitFlap Gateway content left unchanged (correct as-is).
Big-panel apps: Overview (new), Weather Sky / Date Card big-panel layouts, denser flap Dashboard
Remove News Ticker (deleted: HTTP frame-push can't scroll smoothly)
Canvas apps: Lumina Clock (rename), Weather Sky v2, + News Ticker / Date Card / World Time / Countdown Bars; document the rich-render helpers
Canvas clock: replace Analog Clock with Aurora Clock (time as flowing colour)
Canvas capability: drawing apps, on-device effects, and image push
Writing-Apps §7 (canvas apps: surface:canvas, the canvas helper, lifecycle),
Built-in-Apps (Effects / Analog Clock / Image), Matrix-Gateway (the panel as
a raw canvas). Cross-checked against the firmware openapi + web.cpp.
Matrix Gateway: the E jumper ships in the right position; BGR is a setting
The page implied a 64-row panel needs soldering; the board wires E to
connector pin 8 out of the box (the common layout), so 128x64 normally
just works — only pin-16 panels need the jumper moved. And the other
wiring variation, BGR vs RGB panels, is called out with its telltale
wrong-colour pattern and the Settings -> LED Panel -> BGR toggle.
Two gateways, two names — plus Provisioning and Calibration get their own pages
SplitFlap Gateway drives real modules; Matrix Gateway draws a simulated
wall on an LED matrix. The Gateway and Matrix-Portal-Gateway pages are
renamed (redirect stubs left at the old names), 21 pages re-worded, and
both diagrams regenerated with the new labels — the configurations
diagram also aligns all seven Modules boxes on one row.
New: Module provisioning (the full process — the SplitFlap Gateway's
Provision tab and bare-metal provision.py in detail, splitflap-os's
built-in equivalent acknowledged without detail) and Module calibration
(the CALIBRATION_GUIDE ported: the three quantities, the golden order,
nudge vs exact offset, per-flap tuning, the wizard and whole-board pass,
the control reference). Linked from the sidebar's Build-it section,
Home, Module-Firmware and the SplitFlap Gateway tab tour.