Common Error Overview
This page is for quickly locating common Klipper errors. First, find the complete error keyword in klippy.log, then proceed to the corresponding category page for resolution.
Hardware Testing Methods
This document includes minimal testing methods for common hardware modules, used to isolate individual hardware components during troubleshooting, and to confirm whether the issue originates from configuration, wiring, the module itself, or the motherboard port.
MCU ID Configuration
This page is used to centralizedly explain the ID filling rules for mainboards, toolboards, CAN devices, and host MCUs in Klipper. When configuring connection-related issues, first confirm the communication method, then fill in the corresponding serial.
Peripheral and Driver Testing
This document is used to verify whether peripheral modules such as stepper drivers and CAN tool boards are functioning correctly. The testing approach is consistent with basic I/O testing, using a minimal Klipper configuration to isolate individual hardware.
Config Class Errors
This page collects issues related to config section conflicts, parameter spelling, include files, and SAVE_CONFIG. After modifying configurations, first check the first configuration error in klippy.log, then address them one by one.
TMC Error Troubleshooting
Technical Background
Motion and Leveling Errors
This page summarizes errors related to movement range, homing, endstops, probes, bed mesh, and multi-Z leveling. When dealing with wiring, connectors, or manual mechanical adjustments, please power off the device before operating.
Temperature and Extrusion Errors
This page compiles errors related to temperature sensors, heaters, heat beds, extrusion, and filament runout detection. For temperature protection errors, first verify the hardware and temperature curves; do not bypass the issue by disabling protection.
Accelerometer Testing and Calibration
Installing Dependencies
System and Timeout Errors
This page covers communication timeouts, MCU timing errors, host performance, firmware flashing, and Klipper service startup issues.
CAN Network and ID Search
This article covers CAN network configuration, CAN0 status confirmation, CAN UUID search, and common CAN error troubleshooting.
CAN Error Troubleshooting
This document covers troubleshooting common CAN network errors, communication anomalies, and steps to follow when a CAN ID is not found.
Arc Fitting Recommendations
This document explains the trade-offs between Klipper's [gcode_arcs], G2 / G3 arc commands, and slicer arc fitting. For daily 3D printing, it is not recommended to rely on Klipper-side arc fitting as the primary method for improving quality or performance.
Homing Timeout Issue
Problem Description
EDDY FAQ
Error Error during homing z: Eddy current sensor error During Homing
EDDY TAP Mode
This page describes the debugging process, inspection sequence, and common issue troubleshooting for EDDY in TAP mode. TAP mode determines the trigger threshold by lightly touching the nozzle to the bed surface. During debugging, pay attention to the nozzle, heated bed, and Z-axis movement status.
External Drive Usage
This page explains the common wiring, configuration, and debugging methods for external drives. The actual wiring and parameters should be based on the corresponding motherboard, drive, and machine structure.
Common Debug Command Entry
Common Klipper console debug commands have been consolidated into the reference configuration directory to avoid redundancy between FAQs and configuration references.