25 · Help

Troubleshooting

What to do when a preview fails or a cut looks wrong.

The Log tab: every step with its timing, warnings and errors.
The Log tab: every step with its timing, warnings and errors.
  • pcb2gcode missing → only in builds made without it; the native engine takes over (Machine setup → Toolpath engine). Normal builds carry pcb2gcode inside the app — nothing to install.
  • Preview failed → the Log tab has the full output with per-step timings; the error is at the bottom.
  • Uncut gaps between close traces → tool too wide to fit; pcb2gcode warns in the Log. Reduce effective tool diameter or increase design clearance.
  • Mask opening not cleared → opening smaller than the mask tool, or a hand-entered Clear width < half the opening (turn "Clear width from the mask layers" back on).
  • Slow generation → mask Clear width too large, or very wide isolation width.
  • Carvera: "Home it first" → the Carvera only plays an uploaded file once every axis is homed. Home, then Send again; the file is uploaded already.
  • Carvera: Send and tool changes are locked → a tool change was interrupted. Home, open the collet, take the bit out and press Spindle is empty (see Makera Carvera → Running a job on the Carvera).
  • Carvera: "Unexpected tool presence detected" on an empty slot → the changer's laser sensor reads a reflection. Clean copper dust off the matte black guard beside the rack and check that it is not bent.
  • Still stuck? → Help → Contact Support… opens the support form with the app's details filled in.