Repository navigation
Releases
Releases · designfrontier/WebControl
WebControl 0.5.0
New
- Loading overlay: opening, uploading or editing G-code covers the whole page until the load finishes, so nothing can be clicked mid-load. Stop machine stays available, and every failure (server error, network drop, timeout, leaving the screen) clears the overlay and shows the error.
- Loads survive the browser: a G-code load finishes even if the page is reloaded or closed partway, so Play no longer stays stuck on "still loading". Loads queue and land in the order they were started, and uploads only appear in the library once complete.
Security
- Other websites can no longer drive the machine. Any request that changes something is refused if it comes from another site, and browsers can only reach the Pi by a local name (
maslow.local,maslow.lan,MASLOW, the IP). Reaching it through a public or Tailscale name needs the IP instead.curlandwebcontrol-updateare unaffected.
Safety and cutting
- Stop during a jog no longer leaves the controller in relative mode (G91).
- After a controller restart is missed, calibration Accept and optical scans no longer move the sled.
- A controller reset or lost USB link while a job is paused, held or finishing now rewinds to the unfinished line, so nothing is skipped, and the user is told when a paused job's controller restarts.
- A "set Z by hand" wait is cleared by a controller reset, so Resume restores units, absolute mode and safe height.
- A byte-order mark at the start of a file no longer hides its units from "start from line".
- Arcs in the XZ/YZ planes (G18/G19) and arcs with no centre are refused, since the firmware cuts every arc in XY.
- Starting from a line inside a run of arcs keeps the arc instead of cutting a straight line.
- Negative diagonal jogs go the right way.
Calibration and settings
- Optical Fit is refused if any machine setting changed since the scan, so a second Fit + Accept can't double the correction.
- Holey calibration refuses implausible results and asks you to measure again.
- A PID weight the controller reports as NaN is repaired.
- A settings save can no longer lose the latest change if it is interrupted.
- A tiny camera frame rate no longer crashes the server, and image processing no longer stalls it.
Updates
webcontrol-updateinstalls without restarting while the old Python WebControl (v0.94) is running, so it can't stop a job there.- Health checks read JSON values correctly when they contain escaped quotes.
WebControl 0.4.0
Update from the browser
- System ▸ Updates shows the installed version, the latest published release and the backup you can roll back to.
- One click installs the latest release or rolls back to the previous one, with progress and a log on the page. Both are refused while a job or optical scan is running. (Needs 0.4.0 installed once by
webcontrol-updateorinstall-pi.sh, which adds the service and sudoers rule.) webcontrol-updatenever downgrades on its own; use--versionto install an older release on purpose.
Safer cutting
- A safe height at or below 0 is refused.
- G38.3–G38.5 probe commands are never sent, since the firmware ignores them.
- G91.1 is removed before sending, and arc centres given with G90.1 are converted to offsets the firmware understands.
- If an arc's start point is only known from a status report and isn't precise, the job pauses with clear Resume advice instead of cutting a wrong arc.
Firmware
- A pinned, checksummed 51.27 build is available for rolling back.
Interface
- The browser's toolbar follows the light or dark theme.
- One consistent "no file loaded" message.
- Live updates are no longer overwritten by an older page refresh.
- Optical scans report how they ended, and a stopped Pi camera always says why.
- "Clear log files" says exactly what it removes.
Docs
- The feature checklists are rewritten for the Rust-only setup.
webcontrol-rs 0.3.0
WebControl 0.3.0
Display theme is now a machine setting
- Moved to Settings ▸ Display. The Light / Dark / System toggle is gone from the header.
The choice is stored on the Pi with the other WebControl settings (uiTheme), so every
device shows the same theme. - Applies immediately. Picking a theme switches it at once, with no Save, on every open
page, without a reload. It can be changed during a job; it doesn't touch the machine or the
controller's settings. - System is the default. It follows each device's own light or dark mode.
- No flash on load. Each browser remembers the last theme it got from the Pi, so a page
opens in the right theme straight away. - A later choice wins. If you change the theme twice quickly and the first save is refused,
you keep the later choice. - The old per-browser choice from earlier versions is replaced by the Pi's setting the
first time the page loads.
Header
- More room for status. With the theme toggle gone, the status chips keep their longer
labels at more widths. Landscape iPads still fit the header on one row, and the build commit
is always shown.
Under the hood
- Adds
PUT /api/display/themeand athemefield inGET /api/state(contract stays at
version 4; additive only). - CI gives the end-to-end test server longer to build when the Rust dependency cache is cold.
Install / update
On the Pi: webcontrol-update once this release is published, or install the tarball with its
install-pi.sh. Verify downloads against SHA256SUMS.
v0.2.0: WebControl 0.2.0
WebControl 0.2.0
The first release after the move to the Rust backend and React UI. The main changes are
fixes for the controller settings and serial link, found while cutting on a real
Maslow (holey 51.27, PCB v1.1).
Safety and reliability
- Settings no longer corrupt the controller's PID values. 0.1.0 rewrote every
$
setting on connect. The firmware's number parser read$24=1.000000as 1.00000011, and
51.27 ignores PID weights above 1, leaving the motors with zero gain. Every$value is
now written in a form the firmware stores exactly. Out-of-range PID values already on a
controller are repaired when WebControl connects. - Only settings that differ are written on connect. WebControl reads
$$first and
writes only what has changed, plus$13. A change to$38(chain over sprocket)
restarts the controller cleanly. - Nothing that moves the machine is sent after an alarm until you press Stop. Before,
Home's final plunge could still be sent after a "sled not keeping up" alarm. - Lost lines are recovered automatically. If the controller never receives a line, it
is sent again in under a second. If it is lost twice, the job pauses at that line and
Resume sends it again. Before, the job could hang. - Line pacing matches v0.94 by default.
New
- Adjustable line pacing. A preset menu in the run panel (v0.94 50 ms, Min 50/25/0 ms,
or Custom), plus Settings → WebControl Settings → "Line pacing" and "Line pacing gap
(ms)". It can be changed mid-job. - Live send stats. The run panel shows lines/min and lost lines. Tap for the current
stretch, the whole job, and the last 10 settings tried.PACING …key=value lines go to
the logs so settings can be compared after a cut. - The loaded file's name shows above Play/Pause/Stop and in the viewer footer, and
every open screen updates live. - Version and build commit in the status bar, so you can check you're on the latest
build. - Optical calibration (experimental, off by default). Uses a USB webcam or the Pi
camera module to measure a printed calibration target. It fits motor spacing, motor
offset and both chain tolerances, and writes them only after you press Accept. Turn it on
in Settings → WebControl Settings → "Optical calibration (experimental)". It hasn't been
tested with real camera hardware yet; feedback is welcome.
iPad and layout
- Landscape: the header fits on one row, and the viewer fills its box with controller
messages below it. - Portrait: no scrolling. Job status and Stop are always visible.
- Touch: buttons are 44 px on touch screens.
G-code handling (fixes for issues reported on the original WebControl)
- Lower-case G-code is read the same way the firmware reads it (WebControlCNC#177, WebControlCNC#102). Typed
g20,m0,m6andm3now take effect correctly. G2/G3arcs withRare converted toI/J(WebControlCNC#120). Firmware 51.27 doesn't read
R, and 51.292 cuts a negativeRthe short way round. Arcs in relative-mode (G91)
files are now sent with absolute end points, which is how the firmware reads them.
Impossible arcs pause the job with an alert.- Resuming mid-file is refused when X/Y were never set absolutely before that line.
Settings and UI fixes
- GroundControl
.iniimport:zaxis = 1.0now imports as on (WebControlCNC#90), and decimal
commas are converted, or refused when ambiguous. - Comma decimals: "2,5" is accepted in every number field (WebControlCNC#114). "1,500" is refused
as ambiguous. - Gcode editor line numbers: the editor shows line numbers (WebControlCNC#51).
- Home and Return to Center errors name the bad safe-height setting (WebControlCNC#135).
- Settings sync messages: changes WebControl makes to the controller's settings on
connect are shown in the console (WebControlCNC#23). - Setting descriptions are refreshed from the defaults (WebControlCNC#70).
- "Controller: unknown" no longer appears after a page reload.
- Large-file alert: it now says the preview stops at 300,000 lines and the whole file
still runs (WebControlCNC#185).
Install / update
On the Pi: webcontrol-update, or install the tarball with its install-pi.sh. Verify
downloads against SHA256SUMS.