Katapult Firmware

Katapult Firmware Overview

tip

Katapult was originally named CanBoot, and later renamed to katapult.

• Katapult firmware is a type of bootloader that can be used in conjunction with Klipper. After burning the firmware using methods like DFU, you can use commands to update the firmware with one click.
• Advantage: Quickly double-clicking the reset button or quickly cutting power twice will enter the Katapult firmware, at which point there will be an LED flashing on the mainboard.
• Katapult firmware can only be used to burn firmware and cannot connect to Klipper!!!
• Katapult firmware supports three connection methods for connecting to the host computer, and the firmwares for these three methods are independent of each other.
  • CAN connection
    • Advantage: After compiling the KLIPPER firmware, you can directly update the firmware using a command, and it has strong interference resistance.
    • Disadvantage: You need to know the firmware compilation rate in advance.
  • RS232 connection
    • Advantage: After compiling the KLIPPER firmware, you can update the firmware using a command, and it has very strong interference resistance.
    • Disadvantage: You cannot use a command to update the firmware with one click; you need to manually enter the Katapult firmware.
  • USB connection
    • Advantage: After compiling the KLIPPER firmware, you can directly update the firmware using a command.
    • Disadvantage: A long data cable is prone to interference, which may lead to disconnection.

tip

• ERCF supports CAN and USB
• The CAN firmware provided here comes in two versions: 500K and 1M baud rates

Entering Flash Mode

tip

The BOOT button is highlighted in the image

• To enter flash mode, completely power off the motherboard, hold down the BOOT button, and connect a Type-C cable with data transmission capability between the motherboard and the host computer
  

Flashing the Firmware

Windows Flashing Guide

• Katapult firmware for ERCF
  • Click on the download link below
  • Loading...

• Prepare a data cable with data transfer capabilities.
• Download the firmware to the computer.
• Connect the BOOT jumper or hold it and connect it to the computer, at this point the RPI-RP2 disk will appear.
• Remove the BOOT jumper or release the button!!!
• Copy the firmware that needs to be burned into it, please note that only UF2 suffix firmware can be used!!! (Do not modify the suffix name, it is useless.)
• Refer to
• After copying the firmware into the RPI-RP2 disk, it will automatically disappear, indicating that the firmware burning is complete!

Host Computer Flashing Guide

1. Install the flashing tool

   • Enter the following command in SSH
   • Only need to execute it for the first flash, no need to execute again later

   cd ~/klipper/lib/rp2040_flash/ && make

2. Execute the following command to check if the connection is successful.

   • Enter lsusb

   • If there is no 2e8a:0003 device, try re-entering flash mode

   • Due to system version issues, it may display other names. If 2e8a:0003 is present, it means the flash mode has been entered

     
   Notes

   Proceed to the next step only when 2e8a:0003 is present

3. Pull the pre-compiled firmware

   • All are pre-compiled firmware here
   • Please note that the host computer needs to be online to install
   • The host computer needs to execute the following command to download the firmware package

   cd && git clone https://github.com/FengHua741/FLY_Katapult.git

   • It is recommended to update the firmware package if you have already downloaded it before proceeding with the remaining operations

   cd ~/FLY_Katapult && git pull

4. Flashing the firmware

tip

Only one of the firmware files needs to be flashed

• Below is the flashing command for the 500K CAN baud rate firmware

  sudo ~/klipper/lib/rp2040_flash/rp2040_flash ~/FLY_Katapult/BL/ERCF/FLY_ERCF_CANBOOT_CAN_500K.uf2

• Below is the flashing command for the 1M CAN baud rate firmware

  sudo ~/klipper/lib/rp2040_flash/rp2040_flash ~/FLY_Katapult/BL/ERCF/FLY_ERCF_CANBOOT_CAN_1M.uf2

• Below is the flashing command for the USB firmware

  sudo ~/klipper/lib/rp2040_flash/rp2040_flash ~/FLY_Katapult/BL/ERCF/FLY_ERCF_CANBOOT_USB.uf2

5. If flashing is successful, you will see a prompt similar to the one below

   

tip

After flashing, you need to completely power off the motherboard once.

Confirming the Firmware Is Running

• If the firmware starts successfully, the LED will begin to blink