Troubleshoot Gantry Calibration Exception for xTool P3
Updated Mar 27,2026
Updated Mar 27,2026

Issue description

Typically, the gantry may collide with the device, producing abnormal noises. And a pop-up window indicates "Gantry calibration exception" in the software, with the error code "BOUBLE_Y_LIMIT_LEVELING.TIMEOUT".

image.png

Important notes

One motor is positioned on each side of the Y-axis, with two motors corresponding to two limit switches. After a successful reset of each axis, the device starts the Y-axis calibration process (leveling). Calibration succeeds when both limit switches correctly detect the gantry's reset normally, at which point their indicators light up. If any of the limit switches do not detect the gantry reset, it will cause the problem of gantry calibration failure, and the corresponding indicator light will not light up.

You can determine which side the reset abnormality is located on based on the status of the indicator, and follow this article to troubleshoot.

Possible causes

  1. There are some foreign objects in the gantry area.
  2. The position of the limit switch deviates.
  3. The limit switch is faulty.
  4. The Y-axis motor is faulty.

Troubleshooting procedures

1. Check the rear of the gantry

Check whether foreign objects are blocking the reset of the gantry on the back and the device's inside. If present, remove them.

2. Check the limit switch

You can use your phone's camera and flash to observe the limit switch on the right, which is more helpful for observation.

Check if the black probe of the limit switch is distorted or damaged. If yes, remove it to fix or replace a new one.

3. Check the limit switch area

You can use your phone's camera and flash to observe the limit switch on the right, which is more helpful for observation.

(1) Power off the device.

(2) Check whether there are any foreign objects in the limit switch areas on both sides of the gantry. If there are some, please clean them.

4. Check the motors on the left or right sides

  • Normally, when the device is powered on, moving either side of the gantry forward or backward causes the Y-axis motors on both sides to lock up. At this time, the gantry cannot move.

  • If the gantry cannot move, it means the motor works normally. Please check for other issues.
  • If one side of the gantry shows noticeable shaking, it means an issue with the motor on that side. Check the motor as follows:
    1. Power off the device and disconnect it from a power supply. Follow the tutorial to remove the corresponding side's plate.
    2. Check whether the connection cables on the Y-axis limit switch are loose, and unplug and plug the corresponding cable and connector (as shown). Then, restart xTool P3.
Connector 1 is the connector between the motor and the main control board.
Connector 2 is the connector of the left motor.
Connector 3 is the connector of the right motor.

c. If the gantry remains malfunction, replace the corresponding Y-axis motor.

5. Test the limit switch

(1) Move the gantry to the origin position and make it parallel.

(2) Slide the gantry back and forth on both the left and right sides (you may hear a clicking sound from the motor if you force it, and this operation will not damage the machine for a short time, you don't need to worry).

(3) Observe whether the corresponding limit switch indicator changes according to the operation.

  • If the indicator will not change, replace the limit switch.
  • If the indicator changes due to the operation, check for other issues.

Still experiencing issues?

Should the issue persist after completing the preceding steps, submit a ticket via the "Submit a Ticket" button in the "Help Ticket" section below. The standard response time for xTool Customer Service is one business day.

For a prompt resolution, please include the following details:

  • Issue description: A detailed explanation of the observed problem.
  • Video evidence: Attach a video demonstrating the issue, where applicable.
  • Device information: Follow the steps to find the SN and export the work log.

img_v3_02vm_8650b910-9a25-4cea-a878-f061d916c4bg.png

img_v3_02vm_97743981-3662-45ff-a31f-70f7a7eb760g.png

  • Troubleshooting performed: Any troubleshooting steps you have already attempted, along with their results.


This information is crucial for xTool technical support engineers to provide timely assistance.




Documentation feedback
Help improve this content by providing feedback. If this content did not meet your requirements, select "No" in the "Was this page helpful?" section below. Include specific details about what was unclear or missing in the pop-up suggestion box. Feedback submissions are reviewed by xTool technical writers to enhance future documentation.

Preview
Was this page helpful?
4 out of 4 found this helpful
Help Ticket
Use this help ticket to submit your issue. We will respond within 1 business day
Submit a Ticket
Help Ticket
Use this help ticket to submit your issue. We will respond within 1 business day
Submit a Ticket
xTool Logo

Contact Us

🇺🇸+1 (833) 588-4887
Service Live Chat

Copyright © 2025 xTool All Rights Reserved.