Restore 22 pages + 23 images deleted by mistake in 3b9277a (2026-07-30)
Commit 3b9277a ("Binary ops: one format, no version framing") was pushed from
an incomplete working copy of the wiki: alongside its intended 11-line edit to
Canvas-Ops-Reference.md it recorded deletions of every page not in that copy --
22 pages (Home, Quick-Start, Provisioning, Calibration, FAQ, Hardware, ...) and
23 screenshots. _Sidebar.md still linked all of them, so 22 of 28 nav links 404'd.
Restored verbatim from 3b9277a's parent. Additions only; the 8 pages that
evolved since 2026-07-30 are left at their current content.
Binary ops: one format, no version framing
Matrix gateway: v2.0.0 — Waveshare ESP32-S3-RGB-Matrix board (was Adafruit MatrixPortal S3)
mDNS names carry the board id: splitflap-gw-xxxxxx.local
Firmware 3.11 gives the SplitFlap Gateway the suffixed hostname the
Matrix Gateway always had (plain splitflap-gw collides the moment a
second gateway joins the LAN). Every page that named the old address
now shows the suffixed form and says where to find yours: the boot log
and the router's device list.
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.
Wiki: flaps & character sets page, WiFi/mDNS setup, HA install steps, real screenshots
- New page "Flaps & Character Sets": the N command, the 64-flap budget, and
validated 64-flap starter sets for 12 locales (each exactly 64 unique CP1252
glyphs) — framed as a suggestion, not a prescription. Linked from the sidebar,
the Home TOC, the feature grid, Module Firmware and the Companion's
localization section.
- Gateway: full first-boot WiFi flow via the fallback AP, and a "Finding it on
your network" section — mDNS is best-effort, so document finding the IP from
the router/serial and using that everywhere (incl. GATEWAY_URL). Same for the
Matrix Portal, whose AP is named after its hostname.
- Home Assistant: step-by-step install for both the App (repository URL, the two
channels, gateway_url, sidebar) and the HACS integration (custom repository of
type Integration, restart, config flow against the *companion's* URL), plus a
full options table. Mirrored as a condensed step 6 in the Quick Start.
- Correct the calibration-compatibility claim: the gateway's Calibration tab
issues only original-protocol commands (c o s t g w h d) against
original-layout EEPROM fields, so it works fully on the original firmware. The
only version gate in the gateway UI is the flap-set editor (v31+).
- Swap the mocked-up screenshots for real ones rendered from the actual UIs with
fake data; drop ha-device.png; de-boastify a few lines; fix four dead anchors.
Add 'Choosing a Configuration': every viable firmware × driver mix, with a feature grid
The stack is swappable at two joints — module firmware (Adam's original vs Universal) and
the driver (splitflap-os on a Pi, the Gateway alone, or Gateway + Companion). The new page
describes each viable combination (including splitflap-os through the Gateway over MQTT,
and the Matrix Portal substitution), a ~20-row feature grid across the five main configs,
footnotes for the depends-on-firmware cases, and how to migrate between configs without
redoing work. Universal → Gateway → Companion is called out as the most featureful path.
splitflap-os facts (playlists, calibration tools, both-firmware compatibility, MQTT
gateway mode, no scheduler/triggers per its README) checked against csader/splitflap-os.
Wired into the sidebar, Home TOC, Quick Start and the splitflap-os page; the splitflap-os
page's 'targets its own environment' line corrected to the fuller picture.
Hardware: modules mount on a DIN rail with pogo-pin contacts, not point-to-point wiring
The bus description said the modules were daisy-chained with a two-wire pair. In Adam's
design there is no wiring between modules at all: each clips onto a DIN rail, and four pogo
pins on its underside contact a conductor rail carrying 12 V, GND and the two RS-485
signals — mounting a module is connecting it. Fixed in Hardware (prose, diagram, module
parts list, what-you-need table), Quick Start, and the FAQ glossary.
Comprehensive combined wiki for the whole SplitFlap ecosystem
Ties together all the projects — hardware (Adam G Makes), Universal Firmware, Gateway,
Matrix Portal Gateway, Companion (+ HA add-on and HACS integration), and splitflap-os — into
one guided flow from parts to a message on the wall, with optional steps clearly marked.
Pages: Home (ecosystem + TOC), Quick Start (end-to-end, two paths), Hardware, Module
Firmware, Gateway, Matrix Portal Gateway, Companion, Home Assistant (five surfaces), Using
splitflap-os, FAQ & Glossary, plus a sidebar. Includes made-up-data UI mockups (ecosystem
diagram, companion Apps tab, gateway Modules tab, HA device).