Common Error Overview
This page is used to quickly locate common Klipper errors. Please first find the complete error keywords in klippy.log, then go 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 centrally explain the ID filling rules for mainboards, toolboards, CAN devices, and host MCUs in Klipper. When troubleshooting connection-related issues, please 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.
Configuration Errors
This page focuses on configuration section conflicts, parameter spelling, include files, and SAVE_CONFIG related issues. After modifying configuration, please first check the first configuration error in klippy.log, then address each issue one by one.
TMC Error Troubleshooting
Technical Background
Motion, Homing, and Leveling Errors
This page compiles errors related to movement range, homing, endstops, probes, bed meshing, and multi-Z leveling. When involving wiring, connectors, or manual mechanical adjustments, please power off the device before proceeding.
Temperature and Extrusion Errors
This page organizes errors related to temperature sensors, heaters, heat beds, extrusion, and filament runout detection. For temperature protection errors, first confirm the hardware and temperature curve; do not bypass the issue by disabling protection.
Accelerometer Testing and Calibration
Dependency Package Installation
System and Timeout Errors
This page organizes issues related to communication timeouts, MCU timing errors, host performance, firmware flashing, and Klipper service startup problems.
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 common CAN network errors, communication anomaly troubleshooting, and procedures for when a CAN ID cannot be 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
Resonance Compensation and Pressure Advance
This page compiles configuration errors and tuning anomalies related to Input Shaper (resonance compensation) and Pressure Advance. For accelerometer hardware connection and communication errors, please refer to Accelerometer Testing and Calibration.
EDDY FAQ
Error during homing Eddy current sensor error
EDDY TAP Mode
This page covers the debugging process, inspection sequence, and common troubleshooting for EDDY in TAP mode. TAP mode determines the trigger threshold by lightly touching the nozzle to the bed. During debugging, pay attention to the nozzle, heated bed, and Z-axis motion status.
External Driver Troubleshooting
This page is used for troubleshooting issues after configuring an external driver, such as motor not rotating, rotating in only one direction, vibration, skipped steps, model tilting, and 5V boost module anomalies.
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.
Load Cell Probe Troubleshooting
This article is used to record Klipper loadcell / loadcell_probe related keywords and basic troubleshooting directions. Load Cell probes are still a relatively new solution; ordinary users should not modify their printers with pressure sensors based on scattered community configurations. Please prioritize using product documentation, official Klipper documentation, or complete configurations provided by the manufacturer.
BLTouch Configuration & Troubleshooting
bltouch-guide}
EDDY I2C Pins and Configuration
This document explains the I2C pin definitions for the FLY-EDDY series (EDDY-M / EDDY-F) sensors, the pin mapping and wiring steps for the two connection methods, as well as the I2C related configuration items required for probeeddycurrent.
RP2040 firmware not starting fix
Applicable to FLY tool boards using the RP2040 main controller (FLY-SHT36, FLY-SB2040, FLY-MMU, etc.) for fixing issues where the board does not start or starts unstably after self-compiling Katapult / Klipper firmware. The factory firmware is provided by the manufacturer; this page is only needed when you encounter problems with self-compiled firmware.