Dusty Manual
Troubleshooting
Quick answers when the machine does not answer, is locked, refuses a job, stops on an error, cuts at the wrong depth or size, and how to report a problem.
The machine does not appear or does not answer.
- Run the connection assistant (Machine panel, Connection section): it tries the ports and speeds, and tells what is missing (see Connection assistant).
- Use a USB data cable (some only charge) and plug it straight into the computer.
- Check the connection speed in the machine settings: 115,200 baud for GRBL, grblHAL and FluidNC.
- On Windows, install the driver of the board’s USB chip (CH340, CP210x) if the port does not appear; on Linux, add your account to the
dialoutgroup, then log in again. - “The controller no longer responds”: machine power, cable, port. Reconnect reopens the connection.
- Try the virtual CNC: if everything works there, the problem is the connection.
The machine is locked (alarm). Read the incident card: home the machine, or Unlock once the cause is dealt with. After a STOP during a move (alarm 3), the position may be lost: home again, or set the work zero again on a machine without limit switches.
The job is refused at the start. The pre-send check says why:
- work zero not set: set X, Y and Z zero;
- rapid move through the material: safe height too low, or Z zero below the surface;
- outside the travel: the work zero is too close to an edge of the machine, or the drawing goes beyond it; move one or the other;
- laser mode (
$32=1): write$32=0(button in Settings to Check).
Errors during the job (error:n). Open Understand and Fix… on the card. If error 8 repeats, switch job streaming to synchronous in the machine settings. Keep the computer from going to sleep during a job.
The spindle does not start, or turns too slowly. Check the maximum S value (setting $30: 1000 on 3018 boards) and the “spindle started by hand” setting in the machine settings.
An operation produces nothing. Read the operation’s Problems section: no tool, unsuitable tool, no shape, open shape for a pocket (close it, see Drawing tools), final depth not beyond the start depth, or an operation type not available yet.
The part is cut too deep or not deep enough. Check the stock thickness, the Z zero (top or spoilboard) and the final depth. The My Machining Is… assistant › “The depth is wrong” guides the search.
The dimensions are wrong, the contours do not close. Tool diameter, mechanical backlash, belts, steps per millimeter: see My Machining Is… and its mechanical checks.
The estimated time is far from reality. The machine settings are read at connection; adjust the Simulation section of the machine settings. The log learns the real deviation, job after job.
A text does not have the right font. The font does not exist on this device: Dusty uses another one and says so in the Shapes panel.
Dusty Studio cannot reach the USB port. Use Chrome or Edge on a computer, with the page over HTTPS; or the desktop app.
Duet board: password refused, or page refused by the board. Check the password in the machine settings (Connection). In Dusty Studio, open the page over http:// and send M586 C"*" to the board once (or add it to config.g); the desktop app does not need it. See Duet board.
Marlin: “noisy serial link”, repeated resends. Cable too long or unshielded, speed too high for the board: try 115,200 baud (and the same setting in the board). Smoothieware answers !!: the board is halted (HALT), Unlock. See Other controllers.
Reporting a problem. Help › Send Feedback…: describe what you were doing, what you expected and what happened; the email already contains the version and the controller. For a problem that happens again, attach the support data, with the debug log open while you repeat what goes wrong.
In this section
-
Debug log
Record the exchanges with the machine and the error messages, from startup if needed, to understand a problem that happens again; nothing is sent.
-
Support data
A .zip archive of versions, settings, machine profiles and logs, with personal data masked and every file shown before saving, which you attach yourself.
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.