Dusty Manual
The machine
Connect and drive a GRBL, grblHAL or FluidNC machine: catalog and settings, connection assistant, jog and homing, zeros and probing, jobs, tool changes and safety.
In this section
-
Machines and catalog
The list of your machines, the active machine that receives the G-code, and profiles exported as .json to keep, share or import elsewhere.
-
Adding a machine
Add your CNC with Find My Machine, the catalog of 67 commercial models or a GRBL profile to set up, then check its travel, origin corner and spindle.
-
Machine settings
Every section of a machine profile: travel and machine zero, connection, controller and streaming, spindle S value, post-processor, kinematics, accessories, probe.
-
Connection
Connect to the machine or to the virtual CNC, let Dusty read the controller settings, fix those that differ — GRBL laser mode included — and reconnect after a loss.
-
Connection assistant
When the machine does not answer: ports, USB adapter driver, every speed, controller greeting and link stability are tried in turn, nothing moves, and what is missing is explained.
-
Other controllers: Duet, Smoothieware, Marlin, FluidNC over WebSocket
Duet, Smoothieware, Marlin and FluidNC over WebSocket, driven through a bridge that keeps Dusty's checks; written from public documentation and still to be validated on a real board.
-
Duet board (RepRapFirmware)
Connect a Duet board over HTTP: state read four times a second, jobs uploaded and run by the board itself, pause and resume macros, message boxes and STOP.
-
Smoothieware
Smoothieware over USB or Telnet: what the bridge translates — plain-text answers, HALT and unlock, SD card, M503 settings — and why jogging goes by steps.
-
Marlin
Marlin over USB or TCP: numbered lines with checksums and resends, a state worked out with M400 and M114, pause with retract, M410 stop and M112 emergency stop.
-
FluidNC over WebSocket
Connect a FluidNC board through the WebSocket of its web interface, usually on port 81, with the same control as over USB or Telnet.
-
Virtual CNC
A GRBL machine simulated inside Dusty — axes, spindle, probe, limit switches, door — to try jogging, zeros, probing, jobs and STOP without any hardware.
-
The Machine panel
What the Machine panel shows once connected, from top to bottom: state and STOP, incidents, job, SD card, positions, go to, jog, sensor, spindle, macros, console.
-
Control mode
A production layout of the Machine panel that keeps only what you use while machining, and an option that requires it before any send.
-
Jogging and homing
Move the tool with the jog arrows or the keyboard, by step or continuously, home all axes or a single one, and unlock a machine in alarm once the cause is fixed.
-
Work zero
Carry the project origin and Z zero over to the machine: work and machine positions, zero on XYZ or one axis, go to XY zero, and the paper method.
-
Go to
Send the tool to exact work or machine coordinates along a safe path checked against the travel, or to the reference point of the selection.
-
Probing
Set the zero with a Z plate or an XYZ block wired to the controller: position, values, a fast then slow touch, and what alarms 4 and 5 mean.
-
Center finder
Find the center and diameter of a round part from three points touched with the tool, then go there safely or draw a guide circle in the project.
-
Tool length sensor
A fixed probe on the table measures each new tool against a reference, so the Z zero is corrected after a tool change, by hand or during the job.
-
Surface leveling
Probe the surface on a grid, build a height map and adapt the G-code so that the engraving depth stays the same on a warped board or a circuit board.
-
Position check
Detect lost steps by probing a block fixed to the table before and after the job, compare against a threshold, and get advice on accelerations and belts.
-
Dimension calibration
Cut a test piece, measure it with a caliper, and get the scale of each axis, the effective tool diameter, the squareness and new steps per mm to write.
-
Running a job
Frame the job by rectangle or outline, do a dry run above the stock, read the pre-send check and the checklist, then agree to start: the spindle will turn.
-
Pause, stop and STOP
The difference between pause, pause with retract, stop job and STOP, their shortcuts, and what to do after an alarm 3 when the position is lost.
-
Tool change
At each tool change, Dusty raises Z, stops the spindle and guides you: mount the tool, set Z zero again or measure it with the sensor, then resume.
-
Tool table and automatic tool changer
With a grblHAL tool table and an automatic tool changer, the controller runs the M6 changes and G43 H applies each tool's offset; not yet tested on a real board.
-
Resuming an interrupted job
An interrupted job is kept on disk: resume at the start of the pass or at the exact line, with heights and a resume program checked like a new job.
-
Spindle, accessories and overrides
Start the spindle at a set speed, turn coolant and vacuum on or off, and adjust the feed, spindle and rapid overrides while the job runs.
-
Controller settings
Read and write the GRBL $$ settings with before and after shown, automatic backups and the original settings kept, restore, and resets under confirmation.
-
No-go zones
Mark clamps and the vise as zones with a height: Dusty checks the whole toolpath, jogs and macros against them, and blocks what it cannot check.
-
Positions and macros
Save useful positions in machine coordinates and go back by a safe route, and create macro buttons with keyboard shortcuts, checked like any command.
-
SD card
List the files of a grblHAL or FluidNC SD card and run one under job confirmation: the controller machines it by itself while Dusty shows the progress.
-
Console
Send commands to the controller and read its answers, with the full console, a cheat sheet of GRBL commands and a confirmation before any spindle start.
-
Incident cards
At each GRBL alarm or error, a card explains the cause in context, lists the checks and offers one-click actions such as unlock, home or probe again.
-
Machining log
Every job recorded per machine: outcome, estimated and real duration, the learned correction of the estimate, tool wear, and a CSV export or job log.
-
Hour counter and maintenance
Machine and spindle hours per machine, maintenance reminders to adjust for lubrication, belts and bearings, and wear thresholds per tool.
This manual is also built into Dusty: press F1, or open the Help menu, to read the topic for what you are doing. A mistake, a missing answer? Tell us
Try it in Dusty, for free.
Free CNC milling software: design, toolpaths and machine control. Mac, iPad, iPhone, Windows and Linux.