Klipper Common Errors
Retrieve Log File (Octoprint)
The Klippy log file (/tmp/klippy.log) contains debugging information. Execute the M112
command in the OctoPrint terminal window immediately after the undesirable event.
There is also a logextract.py script that may be useful when analyzing a micro-controller shutdown or similar problem. To use it follow this procedure:
mkdir work_directory
cd work_directory
cp /tmp/klippy.log .
~/klipper/scripts/logextract.py ./klippy.log
The script will extract the printer config file and MCU shutdown information to work_directory.
Mainsail and Fluidd have built-in tools to extract and download the klippy.log.
TMC UART Error
This appears when the communication between the TMC drivers and the MCU is not working. Typically this means that you have not powered the SKR board with 12-24V (TMC drivers didn’t boot), you haven’t plugged in the TMC steppers to the correct spots, or you forgot to add or remove a jumper as detailed above.
ADC Error
ADC stands for “Analog to Digital Converter” and is what is used to convert thermistor readings to temperatures for your hotend and heated bed. As a safety precaution, if Klipper is expecting a thermistor to be plugged in but it is reading an invalid reading (no thermistor = open, or 0 ohms for a shorted wire as closed), it will go in to this shut down mode. Double check to make sure your thermistors are plugged in to the correct boards and plugs.
Unable to Connect
Once the underlying issue is corrected, use the FIRMWARE_RESTART
command to reset the firmware, reload the config, and restart the host software. Check MCU IDs match your printer.cfg. Make sure you get the paths right!