Error Codes and Troubleshooting Guide for xTool P3
Updated Jan 15,2026
Updated Jan 15,2026

Introduction

If this article doesn't effectively assist you in resolving the issue or the error code you encounter is not included, contact xTool customer service and provide the information to them.

Information you need to prepare:

  • Work log (Device settings > Working info > Work log > Export)

  • A photo of SN

  • A video of a faulty device (including the screenshot of the error code)

1. Main control board is disconnected

The following numbers and characters correspond to the error codes displayed in the fault pop-up window. Select the appropriate solution based on the error code in the software:

  • motion_gd470: main control board
  • display_gd757: knob screen
  • z_axis_gd303: Z-axis adapter board
  • airpump_gd303: air pump board

Pop-up window

Error code

Possible causes

Troubleshooting procedures

BOARDS.ELEMENT_NOT_FOUND.motion_gd470

  • The software occurs exceptions.
  • The connection cable is loose.
  • PCBA is faulty.

Troubleshoot Main Control Board Disconnection (Error Code: motion_gd470)

BOARDS.ELEMENT_NOT_FOUND.airpump_gd303

  • The software occurs exceptions.
  • The connection cable is loose.
  • PCBA is faulty.

Troubleshoot Main Control Board Disconnection (Error Code: airpump_gd303)

BOARDS.ELEMENT_NOT_FOUND.z_axis_gd303

  • The software occurs exceptions.
  • The connection cable is loose.
  • PCBA is faulty.

Troubleshoot Main Control Board Disconnection (Error Code: z_axis_gd303)

BOARDS.ELEMENT_NOT_FOUND.display_gd757

  • The software occurs exceptions.
  • The connection cable is loose.
  • PCBA is faulty.

Troubleshoot Main Control Board Disconnection (Error Code: display_gd757)


2. Main controller temperature is too high

Pop-up window

Error code

Possible causes

Troubleshooting procedures

CONTROLLER.TMP_HIGH.MASTER

  • The processing time is too long.
  • The working environment temperature is too high.
  • The main control board is faulty.
  • Update xTool Studio software and the firmware to the latest version.
  • Power off the device and let it sit for a while to allow the main control board to cool down.
  • Check the ambient temperature. If the temperature exceeds 30℃, prepare a heat dissipation device.
  • Replace the main control board.

3. Gantry homing exception

Pop-up window

Error code

Possible causes

Troubleshooting procedures

Error Code GO_HOME.FAILED.X_AXIS

  • The thumb screws are not removed.
  • The gantry is stuck by foreign objects.
  • The X-axis motor is faulty.
  • The limit switch of the gantry is faulty.
  • The connection cable is loose.

Troubleshoot X-axis Homing Failure for xTool P3

Error Code GO_HOME.FAILED.Y_AXIS

  • The thumb screws are not removed.
  • The gantry is stuck by foreign objects.
  • The Y-axis motor is faulty.
  • The limit switch of the gantry is faulty.
  • The connection cable is loose.

Troubleshoot Y-axis Homing Failure for xTool P3

Error Code GO_HOME.FAILED.Z_AXIS

  • The lead motor is stuck by foreign objects.
  • The Z-axis motor is faulty.
  • The limit switch of the gantry is faulty.
  • The connection cable is loose.
  • The limit switch sheet is distorted.

Troubleshoot Z-axis Homing Failure for xTool P3

Error Code GO_HOME.FAILED.V_AXIS

  • The firmware occurs exception.
  • The limit switch is faulty.
  • The connection cable is loose.

Troubleshoot V-axis Homing Failure for xTool P3

4. Bed leveling exception

Pop-up window

Error code

Possible causes

Troubleshooting procedures

BOTTOM_BED_LIMIT_LEVELING.TIMEOUT

  • The lifting platform is stuck by the foreign objects.
  • The V-axis motor is faulty.
  • The limit switch of the V-axis is faulty.
  • The slat slot is dirty.
  • The distance measurement sensor is faulty.

Troubleshoot Bed Leveling Exception for xTool P3

5. Gantry calibration exception

Pop-up window

Error code

Possible causes

Troubleshooting procedures

image.png

BOUBLE_Y_LIMIT_LEVELING.TIMEOUT.

  • There are foreign objects on the Y-axis.
  • The limit switch on the Y-axis is failing.
  • The motor of the Y-axis is faulty.

Troubleshoot Gantry Calibration Exception for xTool P3

6. Detected disconnection of the side camera

Pop-up window

Error code

Possible causes

Troubleshooting procedures

CAMERA.EVENT_TYPE_SIDE_CAMERA_UP_DISCONNECT.

  1. The flex cables of the camera occurs exception.
  2. The camera is faulty.

Troubleshoot Side Camera Disconnection for xTool P3

CAMERA.EVENT_TYPE_SIDE_CAMERA_DOWN_DISCONNECT.

  1. The flex cables of the camera occurs exception.
  2. The camera is faulty.

7. Sensor exception detected

The following numbers and characters correspond to the error codes displayed in the fault pop-up window. Select the appropriate solution based on the error code in the software:

  • WATER_TMEP_SENSOR_ERR: Water temperature sensor exception
  • ENV_TMEP_SENSOR_ERR: Ambient temperature sensor exception
  • NOT_FOUND: Communication exception
  • NOT_WORKED: Device cannot power on
  • HUMI_ERROR: Humidity sensor exception

Pop-up window

Error code

Possible causes

Troubleshooting procedures

Error Code COOL_WATER_MACHINE.ELEMENT_ABNORMAL.WATER_TMEP_SENSOR_ERR

  • The software occurs exceptions.
  • The water-cooling machine is faulty.
  • Update xTool Studio software and the firmware to the latest version.
  • Restart the device.
  • Replace the water cooling system.

Error Code COOL_WATER_MACHINE.ELEMENT_ABNORMAL.ENV_TMEP_SENSOR_ERR

  • The software occurs exceptions.
  • The water-cooling machine is faulty.
  • Update xTool Studio software and the firmware to the latest version.
  • Restart the device.
  • Replace the water cooling system.

Error Code

COOL_WATER_MACHINE.ELEMENT_ABNORMAL.NOT_FOUND

  • The software occurs exceptions.
  • The connection cable is loose.
  • The connection cable is damaged.
  • The water-cooling machine is faulty.

Troubleshoot Water-cooling Machine Exception - Sensor Exception Detected (Error Code: NOT_FOUND)

Error Code COOL_WATER_MACHINE.ELEMENT_ABNORMAL.NOT_WORKED

  • The software occurs exceptions.
  • The water-cooling machine is faulty.
  • Update xTool Studio software and the firmware to the latest version.
  • Restart the device.
  • Replace the water cooling system.

Error Code COOLWATER_MACHINE.ELEMENT_ABNORMAL.HUMI_ERROR

  • The software occurs exceptions.
  • The connection cable is loose.
  • The connection cable is damaged.
  • The humidity sensor is faulty.

Troubleshoot Water-cooling Machine Exception - Sensor Exception (Error Code: ABNORMAL.HUMI_ERROR)

8. Device water level too low

Pop-up window

Error code

Possible causes

Troubleshooting procedures

COOL_WATER_MACHINE.ELEMENT_ABNORMAL.WATER_LINE_LOW

  • Inadequate antifreeze.
  • The water cooling system is faulty.
  • The device is leaking.

Troubleshoot "Device Water Level Too Low" for xTool P3

9. Device water flow too low

Pop-up window

Error code

Possible causes

Troubleshooting procedures

COOL_WATER_MACHINE.ELEMENT_ABNORMAL.WATER_FLOW_LOW

  • The antifreeze is not mixed well.
  • The proportion of the antifreeze is a high concentration.
  • The water pipe is twisted and the water flow is not smooth.
  • The water pump of the water cooling system is faulty.

Troubleshoot "Device Water Flow Too Low" for xTool P3

10. Device water temperature is slightly below normal

Pop-up window

Error code

Possible causes

Troubleshooting procedures

COOL_WATER_MACHINE.TMP_WARNNING.WATER_TEMP_LOW

  • The temperature of the antifreeze is too low.
  • The ambient temperature is slightly below normal.
  • The water cooling system is faulty.
  • Power off the device and let the antifreeze cool down (41℉-82.4℉), and then restart the device.
  • Check the ambient temperature. If it is under 41℉, place the device under the ambient temperature of 0-82.4℉.
  • Replace the water cooling system.

11. Device water temperature too low

Pop-up window

Error code

Possible causes

Troubleshooting procedures

COOL_WATER_MACHINE.TMP_ERROR.WATER_TIEMP_ULTRA_LOW

  • The temperature of the antifreeze is too low.
  • The ambient temperature is too low.
  • The water cooling system is faulty.
  • Power off the device and let the antifreeze cool down (41℉-82.4℉), and then restart the device.
  • Check the ambient temperature. If it is under 0℉, place the device under the ambient temperature of 41-82.4℉.
  • Replace the water cooling system.

12. Device water temperature is slightly above normal

Pop-up window

Error code

Possible causes

Troubleshooting procedures

COOL_WATER_MACHINE.TMP_WARNNING.WATER_TEMP_HIHG

  • The temperature of the antifreeze is too high.
  • The ambient temperature is too high.
  • The water cooling system is faulty.

Error Codes and Troubleshooting Guides for High Water Temperature


13. Device water temperature too high

Pop-up window

Error code

Possible causes

Troubleshooting procedures

COOL_WATER_MACHINE.TMP_ERROR.WATER_TEMP_ULTRA_HIHG

  • The temperature of the antifreeze is too high.
  • The ambient temperature is too high.
  • The water cooling system is faulty.

Error Codes and Troubleshooting Guides for High Water Temperature


14. Device temperature too high

Pop-up window

Error code

Possible causes

Troubleshooting procedures

COOL_WATER_MACHINE.TMP_ERROR.WATER_TEMP_HIGH_LONG_TIME

  • The temperature of the antifreeze is too high.
  • The ambient temperature is too high.
  • The water cooling system is faulty.

Error Codes and Troubleshooting Guides for High Water Temperature


15. Air pump exception

The following numbers and characters correspond to the error codes displayed in the fault pop-up window. Select the appropriate solution based on the error code in the software:

  • STALLED: fault of stall
  • CUR_LOW: too low current
  • PUMP_TEMP_HIGH: too high air pump temperature
  • PUMP_TEMP_ERR: temperature sensor of air pump occurs exceptions

Pop-up window

Error code

Possible causes

Troubleshooting procedures

AIRPUMP.ELEMENT_ABNORMAL.STALLED


Troubleshoot Air Pump Exception (Error Code: ABNORMAL.STALLED)


AIRPUMP.ELEMENT_ABNORMAL.CUR_LOW

  • The software occurs exceptions.
  • The muffler of the air pump is dirty.
  • The air pump is faulty.
  • Update xTool Studio software and the firmware to the latest version.
  • Restart the device.
  • Replace the muffler of the air pump.
  • Replace the air pump.

AlRPUMP.ELEMENT_ABNORMAL.PUMP_TEMP_HIGH


Troubleshoot Air Pump Exception (Error Code: ABNORMAL.PUMP_TEMP_HIGH)

AlRPUMP.ELEMENT_ABNORMAL.PUMP_TEMP_ERR

  • The software occurs exceptions.
  • The muffler of the air pump is dirty.
  • The air pump is faulty.
  • Update xTool Studio software and the firmware to the latest version.
  • Restart the device.
  • Unplug and plug the connection cable of the air pump. Then restart the device.

  • Replace the air pump.
Preview
Was this page helpful?
7 out of 12 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.