The Machine Won't Frame

Article author
xTool Support Team
  • Updated

This article applies to:

D1 and D1 Pro with all laser modules.


Issue Description

Framing is a function where the laser module moves around to you a preview of the processing area on the material. You can start a framing process on the preview page on XCS. If your machine won't frame, this article can help you troubleshoot the issue. Please follow the instructions below.

#1 Check XCS Version

  1. Click on the Settings button on the top left corner of the XCS window
  2. Go to General -> Software update. See if it's the latest version.
  3. Please update the software to the latest version.
  4. If the issue persists, move on to the next step.

#2 Check Firmware Version

  1. Connect the machine, and click on the wheel sign on the top right corner of the device section.
  2. Go to Basic Info -> Check for updates. See if it's the latest version (a prompt will show).
  3. Please update the firmware to the latest version. You can refer to:
    Upgrade the Firmware for D1 and D1 Pro
  4. If the issue persists, move on to the next step.



#3 Check Indicator Status

  1. Check the indicator near the Start button on the machine's front plate.
  2. See if it flashes after you click on the Frame button on XCS.
  3. If yes, short press the Start button (no longer than 2 seconds).
  4. If the indicator doesn't flash or pressing the button doesn't work, move on to the next step.


#4 Check Connection Method

  1. If you are using Wi-Fi, then change to USB, and vice versa.
  2. Check if the indicator flashes after you click on the Frame button in XCS.
  3. If not, try another computer. If the issue persists, refer to the link below and contact tech support.
    Help Tech Support Troubleshoot Faster
  4. If the indicator flashes, but the laser module still won't start framing, move on to the next step.

#5 Check Module Movement

  1. Skip the framing process and jump to the processing. See if the laser module moves freely.
  2. If not, please refer to the link below to troubleshoot the X and Y-axis movement issues.
    The Laser Module Won't Move
  3. If the above doesn't solve the issue, and your machine model is D1 Pro, please move on.

#6 Check Position Limit

  1. See if the position limit alarm goes off when the laser module starts to frame.
  2. If yes, it could be an issue with the limit switch or the trigger piece.
  3. Please refer to the link below to troubleshoot the position limit issue.
    The Position Limit Won't Work


If None of the Above Works

If you have followed the instructions above and the issue is still not resolved, please read the article in the link below, collect the troubleshooting steps you have taken, and contact xTool tech support for further advice.


Was this article helpful?

0 out of 3 found this helpful

Have more questions?



Article is closed for comments.