Touch-panel firmware for a FluidNC CNC router: a pendant you mount by the machine and run jobs from. It runs on an Elecrow CrowPanel Advance 7.0 (ESP32-S3, 800×480, GT911 touch) with LVGL 8.3, and talks to the controller over a 1 Mbaud UART. Built for one machine (a FoxAlien Masuter 3S 8040 on a Corgi board with an OpenATC tool rack), but every control is gated on what the controller's own config says it has.
- DRO and jog — work and machine position for every axis the controller reports; continuous hold-to-jog, step jog, tap an axis to type a target.
- Homing walk-through — when position can't be trusted (fresh link, controller restart, an alarm that loses position) a card walks you through a checklist, HOME ALL, and an optional tool-length measurement.
- Tool changes — a TOOLS page laid out like the machine: five buttons, one per
OpenATC cartridge, in a column with T1 at the front. Anything else in the spindle
is the custom tool, fitted and removed by hand. What a tool's card offers follows the
controller's config: with an M6 macro, tap a tool and LOAD or CANCEL, and the
macro does the rest; with
atc_manual, LOAD / CURRENT / UNLOAD and honest text about what each will do. Either way the card shows the plan first, every by-hand step gets its own card, and jobs that pause for a tool say which tool. - Overrides — feed, rapid and spindle open a full-width slider card.
- Safety — HOLD / RESET / UNLOCK on every page, never covered by a popup; STEPPERS OFF disarms hard limits so pushing the gantry by hand can't trip a reset that silently re-enables the motors.
- Probe, offsets, macros, run from the controller's SD card, calibration, diagnostics — see the screenshots below.
- Network update — the panel fetches its own firmware over Wi-Fi, resuming a stalled download.
All of these are the real UI, rendered by the desktop simulator below.
PlatformIO builds everything:
pio run -e crowadv # the firmware
pio test -e native # host unit tests (parsers, models)Flashing: the board's ROM bootloader over USB. tools/flash.sh and
tools/flash_cnc101.sh are the scripts used here (the latter flashes over SSH
from the PC the panel is plugged into). Once a panel is running, Setup →
UPDATE NET updates it over Wi-Fi from the URL in src/model/settings.cpp.
Before building your own: the Wi-Fi network and update URL defaults in
src/model/settings.cpp are this shop's; in the public copy the password and
access token read REDACTED…. Put your own in, or the network update has
nothing to connect to.
Two ways to run the real UI on a desktop without the hardware. Both compile
src/ui and src/model unmodified against SDL2 (needs libsdl2-dev).
The panel in a window, against a built-in fake controller:
pio run -e sim && .pio/build/sim/program
.pio/build/sim/program --page 10 --shot tools.bmp # one frame, headless (page index)
.pio/build/sim/program --toolchange 2 --shot card.bmp # a job pausing for T2Window keys: 1–5 force Idle / Run / Hold / Alarm / Jog, 6 plays the next
tool change of a sample job, space freezes the DRO, s saves a screenshot.
--tap "x,y;x,y>x2,y2" scripts touches, which is how the screenshots above were
made. The fake controller runs an M6 macro by default; --atc-manual makes it
behave like atc_manual instead. --link host:port or --link /dev/ttyX drives a real FluidNC instead.
A fake FluidNC that loads an actual config.yaml and derives everything from
it — which axes, which limit and probe pins, whether homing exists — with a web
page to flip inputs and watch the controller:
make -C sim
./sim/run.sh # the bring-up profile
./sim/run.sh equipped # limits, probe, coolant, door, all present
# then open http://127.0.0.1:8080See sim/README.md for what is real and what is faked.
src/ui/ pages, the shell (rail, DRO, safety bar), cards and popups
src/model/ the FluidNC model: state, capabilities, homing, tools, offsets
src/hw/ display, touch, IMU, status LEDs, network update
src/transport/ the UART link and XModem
src/sim/ desktop simulator stand-ins
sim/ FluidNC bench simulator
test/ host unit tests (pio test -e native)
tools/ flashing, config upload, G-code generators
cad/ the panel's mounts and enclosures (FreeCAD)
docs/ engineering notes and handoffs, screenshots
The controller side of tool changes — the FluidNC m6_macro that drives the
OpenATC rack — lives with the machine's config, not in this repo.
The FluidNC model and protocol handling started from Mitch Bradley's
FluidDial (GPLv3, kept in
FluidDial-main/), and the parser is his
GrblParser.
GNU General Public License v3.0. This project builds on FluidDial, which is GPLv3, so the whole is too: you may use, modify and share it, and anything you distribute that is built from it must be shared under the same terms, with its source.



















