Flash Katapult on BTT Eddy for more convenient Klipper firmware updates (no more pressing the boot button). This is a quick guide on how to flash Katapult on the BTT Eddy.

What: Katapult is a configurable bootloader for Klipper.
Why: When using Katapult you can flash Klipper much more easy onto your BTT Eddy, no longer do you need to power off and on the BTT Eddy while holding the little boot button.
How: With Katapult you can enter the flashing mode by a simple console/SSH command and flash Klipper without having to touch your device. Even remotely if you wish to do so..

Originally made to go together with the Sovol SV08 Mainline guide and the Automatic MCU script updater. But this will work just as well with other Klipper printers with a BTT Eddy.

All this is made with the BTT Eddy USB version in mind. Use SSH to your printer to run the commands.

First, obviously, we have to install Katapult if you haven't done so already.

cd ~ && git clone https://github.com/Arksine/katapult

Install pyserial (we need this later to flash the firmware)

pip3 install pyserial

Now we are going to need to put the BTT Eddy into boot/DFU mode (otherwise we cannot flash Katapult on it).

1. Power off your BTT Eddy (e.g. pulling the USB plug, turning off the printer etc.)
2. Press and hold the little boot button on top of the BTT Eddy and power up the BTT Eddy (e.g. plugging the USB cable back in or turning the printer back on etc.)
3. Once powered on wait a few seconds and you can release the button again, it should now be in boot/DFU mode.

Check if BTT Eddy is in boot mode with:

lsusb

It should look something like this:

Take note of that 2e8a:0003 address, we will need it later. So copy the address if it's different and use it in a later step (you know it when you see it).

Now we are going to configure, build and flash the Katapult firmware for the BTT Eddy.

Configure the Katapult firmware as shown in the screenshot. Press [Q] to quit and save changes.

cd ~/katapult && make menuconfig KCONFIG_CONFIG=eddy

We shall now build and flash the Katapult firmware to our BTT Eddy. Remember that address? We need it here.

make clean KCONFIG_CONFIG=eddy
make flash FLASH_DEVICE=2e8a:0003 KCONFIG_CONFIG=eddy

Check if Katapult has been flashed succesfully (it should show a usb-katapult_rp2040 device with serial) and please copy the serial (e.g. usb-katapult_rp2040_45474E621A862D4A-if00) and save this for the next step.

ls /dev/serial/by-id/*

We have flashed Katapult onto our BTT Eddy and it's ready to receive a Klipper firmware! You can now use the Automatic MCU script updater (made for the Sovol SV08, option 3/Eddy will work for other machines as well) to flash the Klipper firmware to the BTT Eddy (choose menu option 3). Or do it manually in the steps below.

Let's build us a Klipper firmware for the BTT Eddy and flash this with Katapult.

Configure and create the Klipper firmware (config) as shown in the screenshot. Press [Q] to quit and save changes.

cd ~/klipper
make clean KCONFIG_CONFIG=eddy.mcu
make menuconfig KCONFIG_CONFIG=eddy.mcu
make KCONFIG_CONFIG=eddy.mcu -j4

After the Klipper firmware has been created we can flash it with Katapult! First put the BTT Eddy in Katapult bootloader mode if it isn't already (replace the serial with your serial):
_{Is your Eddy already in Katapult bootloader mode, the serial starts with usb-katapult? Then you can skip to the next command and flash the klipper.bin with Katapult.}

cd ~/klipper/scripts/ && python3 -c 'import flash_usb as u; u.enter_bootloader("/dev/serial/by-id/usb-Klipper_rp2040_45474E621A862D4A-if00")'

And flash the just configured and made klipper.bin with Katapult (replace the serial with your serial):

cd ~/katapult/scripts && python3 flashtool.py -d /dev/serial/by-id/usb-katapult_rp2040_45474E621A862D4A-if00

If it was flashed succesfully you can check and see it's Klipper serial, it will look like:

ls /dev/serial/by-id/*

🥳 Yes! You have flashed Klipper onto your BTT Eddy using Katapult! In the future you only need to repeat these steps:

• Build the klipper firmware (with bootloader offset)
• Put the BTT Eddy into Katapult bootloader mode
• Flash the Klipper firmware with Katapult, done

Got something to share? Got tips? Something ain't right in the guide? Something else? Please share! Create an issue and explain in there or even better; make a pull request with the fix/addition etc!