Skip to content

The machine

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.

A circuit board, a bed or a spoilboard is never perfectly flat: on a 0.1 mm engraving, a tenth of a millimeter of height difference is enough to engrave nothing on one side and cut too deep on the other. Leveling probes the surface on a grid, builds a height map, then adapts the G-code: every move follows the measured surface, and the depth is the same everywhere.

Preparing (Surface Leveling section of the Machine panel):

  1. Connect the probe to the tool: clip on the bit and probe plate on the surface, or, for a circuit board, clip on the bit and a wire on the copper. Check with Probing that the contact is seen.
  2. Set the X Y zero of the job and the Z zero on the surface, at the origin (X0 Y0): the map corrects relative to the surface height at the origin. After a tool change without a tool length sensor, redo the Z zero at the same place.
  3. Set the grid: origin and size of the area (Stock Area takes the project’s stock), points in X and Y (2 to 30 per axis, 400 at most; a 10 to 25 mm step is usually enough), clearance (travel height between points, above the whole surface), search below zero (the probe goes down at most that far), probing feed (60 mm/min recommended, 300 at most).

Probe the Grid… asks for your consent: the machine will move on its own from point to point. Spindle off (Dusty refuses to probe with the spindle running and sends M5 first), it rises to the clearance, moves to the next point, goes down to the contact (G38.3), rises again, and so on in a serpentine. The map is drawn as it goes.

  • The probe touches nothing within the travel (probe unplugged, surface lower than expected): the tool rises to the clearance and probing stops cleanly, without an alarm; the message says which point.
  • A contact less than 1 mm below the clearance also stops probing: raise the clearance.
  • Stop Probing lets the current point finish, then raises the tool; STOP stops everything at once.

The map

Top view in false colors (blue lower, red higher than the origin), height difference, average slope in X and Y (mm per 100 mm). Dusty warns if the Z zero was not on the surface at the origin or if the surface varies by more than 3 mm (probe, stock badly seated). Save Map… and Open Map… keep it in a file (.json); it also stays from one launch to the next until Forget Map.

Adapt Jobs to the Map

When checked, every project job and every G-code program sent follows the map. Dusty splits moves into segments of 2 mm at most, turns arcs into segments (within 5 µm) and corrects Z at each point by interpolating between the probed points; outside the probed area, the correction is extended from the edge (reported). The pre-flight check covers the adapted G-code, and its warnings give the range of corrections. Left as is, and reported: moves in relative mode (G91), in machine coordinates (G53), G28/G30 returns and probing moves; a program with inverse time feed (G93) or arcs outside the XY plane is refused. Framing, dry runs and job resumes are not adapted (a resume replays the already adapted G-code).

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.