Updating Toolhead Klipper

Step 1

To update Klipper, you first need to compile a new klipper.bin with the correct settings.

Move into the klipper directory on the Pi by running:

cd ~/klipper

Then go into the klipper configuration menu by running:

make menuconfig

You can find screenshots of settings for common toolheads in the Common Toolhead Hardware section.

You want the Processor and Clock Reference to be set as per whatever board you are running. Set Communication interface to ‘CAN bus’ with the pins that are specific to your toolhead board. Also set the CAN bus speed to the same as the speed in your can0 file. In this guide it is set to 1000000.

Once you have the firmware configured, hit Q to save and quit from the makemenu screen, then run a make clean to make sure there are no old files hanging around, then make to compile the firmware. It will save the firmware to ~/klipper/out/klipper.bin

Step 2

First, stop the Klipper service on the Pi by running:

sudo service klipper stop

If you already have a functioning CAN setup, and your [mcu toolhead] canbus_uuid is in your printer.cfg, then you can force Katapult to reboot into Katapult mode by running:

python3 ~/katapult/scripts/flashtool.py -i can0 -u yourtoolheaduuid -r

If will probably say “Flash success” THIS IS NOT ACTUALLY FLASHING ANYTHING, YOU NEED TO CONTINUE WITH THE STEPS BELOW

Step 3

If you don’t have the UUID (or something has gone wrong with the klipper firmware and your toolboard is hung) then you can also double-press the RESET button on your toolhead to force Katapult to reboot into Katapult mode.

You can verify it is in the proper mode by running python3 ~/katapult/scripts/flashtool.py -q. If you see a “Detected UUID: xxxxxxxxx, Application: Katapult” device then it is good to go.

Step4

Then you can run the same command you used to initially flash Klipper:

python3 ~/katapult/scripts/flashtool.py -i can0 -u yourtooolheaduuid -f ~/klipper/out/klipper.bin

Once the flash has been completed you can run the python3 ~/katapult/scripts/flashtool.py -i can0 -q command again. This time you should see the same UUID but with “Application: Klipper” instead of “Application: Katapult”

If you can’t connect to your tooolhead after these steps (assuming all the ouputs look similar in success to the screenshots) then there is a good chance your klipper.bin settings were incorrect. Go back to Step 1 and check all the settings in the make menuconfig screen then recompile with make clean and make, and then double-click the reset button on your toolhead to kick it back to katapult mode then go from Step 3.

However, if the CAN query does return your UUID with “Application: Klipper” then start the Klipper service on the Pi again with sudo service klipper start and then do a firmware_restart and confirm that Klipper starts without errors.