| Dashboard layout |
Toolhead renamed Spindle Location. Normal CNC controls consolidated in its compact Android-friendly panel. |
Separate Homing & Zero Axis panel and Work Lights section removed from view. |
| Position and travel |
Current X/Y/Z positions with work travel range immediately underneath each coordinate. |
Ranges account for work-zero offsets; unhomed axes show a home-first message. |
| XY jogging |
X horizontal and Y vertical around the XY center. Every jog button has a small lowered axis letter. |
Unavailable travel and controls are grayed out. |
| Z jogging |
Horizontal Z jog row directly below XY grid; includes ±10 mm choices and coarse travel limits. |
Endstop indicators below Run speed, beneath the jog rows. |
| Coarse / Fine |
Single toggle shows the action: Fine switches to fine steps; Coarse switches back. |
Current mode appears in the tooltip. Step sets retained. |
| Jog percentage |
Direct percentage entry, ±10-point buttons, Min / 50% / Max. Default 50%; selection 10–100%. |
Percentage box shows active value first, selected value in parentheses when capped: 30% (50%). Tap to edit the selected value. |
| Jog base rates |
100% dashboard jog base: XY 200 mm/s; Z 25 mm/s. Default 50% gives XY 100 mm/s; Z 12.5 mm/s. |
Jogging allowed when idle or fully paused; blocked during active file execution and while motion/pause lift is settling. Travel limits retained. |
| Below-Z5 speed cap |
Compact editable cap below the endstops. Default 30%; uses the lower of selected jog percentage and cap. |
Applies below work Z5 and to moves entering that region. Selection retained. Cap stored in this browser. |
| Effective jog rate |
Dashboard jog feed compensates for the current Run speed multiplier. |
Run speed cannot silently multiply a dashboard jog above its selected/capped rate. |
| Z5 permission |
Below Z5: Locked / Allowed toggle in lower-left quadrant; permission automatically relocks above work Z5. |
Also resets when homing status or work-zero offsets change. Upward escape does not require confirmation. |
| Guarded jog confirmation |
A below-Z5 jog while locked opens Move / Cancel with target work coordinate and speed cap. |
Explicit Allowed mode permits repeated button jogging below Z5; direct position entry still requires confirmation. |
| Direct position entry |
Coordinate boxes allow manual moves when idle or fully paused, with work-offset-aware targets and travel checks. |
Direct below-Z5 entry always opens Move / Cancel. Limits, clearance confirmations and speed caps still apply. |
| Home dialog |
One Home… button opens Home All / X / Y / Z / Cancel choices. |
Already-homed axes disabled. Homing blocked during motion, running jobs and paused jobs. |
| Homing confirmations |
Individual axis homing retains confirmation explaining work-zero loss; dialogs close immediately on Yes or No. |
Home All skips extra confirmation as requested, but keeps fresh-state checks. Live homing macro lights at 70% before Z-first homing. |
| Disable Steppers |
Red direct button remains visible beside Home access. Flashes during the automatic idle warning. |
Unavailable while moving, running or paused; disables only when permitted. Rehome and re-establish work zeros afterward. |
| Zero dialog |
Prominent Set Tool Z Zero, then Zero All / XY / X / Y / Cancel. |
While paused, only tool Z zero is enabled. Saved XY return point and original cutting depth are preserved. XY origin changes remain blocked. |
| Zero terminology |
Set Tool Z Zero establishes the current tool-tip position as work Z0. |
Work zero, not a separate persistent tool-length table. Recheck zeros after homing or disabling motors. |
| Run speed |
Renamed from Speed factor. Compact centered row with editable percentage and ±10-point buttons. |
Sets Klipper M220 job feed multiplier; separate from selected dashboard jog percentage. |
| Endstops |
One compact row: X, Y, Y1, Z, Z1. Green=open, red=triggered, gray=unavailable; hover gives full state. |
Refresh after motion / homing and on demand. No continuous active endstop queries, avoiding Busy/Standby flashing. |
| Console Commands |
Refresh Endstops, Shake X / Y / Y1 / Z / Z1, Get Position, Driver Status. |
Shake tests retain confirmation and job/motion restrictions. Refresh label explains what it reads. |
| Pause / Resume |
Pause captures original machine XY, cutting work Z and queued file byte cursor. Jogging away does not overwrite that capture. |
Resume lifts Z, returns to saved machine XY, then lowers to saved work Z using the updated tool Z zero. Homing and Disable Steppers remain blocked while paused. |
| Light hardware |
Work light moved from fan_generic to Klipper LED on P2.7, with 0.010 s PWM cycle. |
Default On 70%; PWM brightness remains adjustable. |
| Light button |
When off: green Light on turns on at 70% immediately. When on: black Light settings… opens brightness / breathing / off controls. |
Separate Miscellaneous Work Lights panel hidden; functionality consolidated in grid dialog. |
| Light dialog |
Editable brightness percentage (1–100), Apply brightness, Breathe / Stop breathe, Turn off, Cancel. |
Turn off requires Confirm / Cancel. Steady brightness restored when optional manual breathing stops. |
| Automatic idle warning |
After 15 minutes idle with any stepper energized: three rapid flashes then one second steady, repeating. |
Replaces the 20-second test setting. Light-off still suppresses the lamp warning. Running jobs do not trigger it. |
| Warning reset |
Machine motion or relevant dashboard / console input clears the automatic warning and restarts its idle timer. |
Disabling all steppers clears it. Automatic warning is distinct from manually selected Breathe. |
| Warning snooze |
During the warning, the light button becomes Snooze idle warning. First press restores steady light and snoozes for 15 minutes. |
Button then returns to Light settings…. Countdown below cap; no extra snooze button. Snooze resets the shutdown countdown. |
| On-screen motor reminder |
Disable Steppers flashes while the automatic lamp warning is active. |
Button retains job restrictions; a warning does not override lockouts. |
| Controller implementation |
Live Mainsail overlay: /home/dunga/mainsail/lowrider-light-controls.js. Lighting/timers in leds.cfg; pause capture/resume in cnc_macros.cfg. |
machine.cfg no longer uses the competing default three-hour M84. Timeout settings persist in lowrider_ui_variables.cfg via save_variables. Backups saved before deployment. |
| Scope of Z5 UI protection |
Guards apply to customized dashboard jog and direct-position controls. |
They do not rewrite uploaded CNC programs or arbitrary console G-code. Machine travel limits remain enforced by Klipper. |
| Validation / commissioning |
Simulated tests cover paused jog/Z-zero permissions, job/motion exclusions, Z5 guards, preserved XY/depth after tool zero changes, UTF-8/CRLF file cursor lines, and timer persistence. |
Live timeout dialog tested Disabled, then restored to 15 minutes. No machine movement or job started for verification. Home again after the configuration restart. |
| Next tuning step |
Use the uploaded air-circle test to evaluate paused jogging, tool access and ordered Resume when ready. |
Warning and snooze are now 15 minutes. Default shutdown is another 15 minutes after warning starts (about 30 minutes total inactivity). |
| Automatic stepper disable |
Stepper timeout dialog near the Z5 cap: editable 1–1440 minutes after warning, default 15, or Disable automatic shutdown. |
Saved across restarts. Warning/snooze remain available when disabled. Never auto-disables while running or paused; activity resets the timer. Rehome after disabling. |
| Paused file position |
Paused panel shows the captured file byte cursor and nearby line number, plus the original saved return coordinates. |
This is the queued file cursor, not an exact physical cutter-stop line because motion is buffered. Klipper retains its own file position for Resume. |