Katapult Firmware

Katapult Firmware Description

tip

Katapult was originally named CanBoot and was later renamed.

• Katapult firmware is a type of bootloader that can be used in conjunction with Klipper. After being flashed using methods like DFU, you can use commands to update the firmware in one click.
• Advantages: Double resetting or quickly cutting power twice will enter the Katapult firmware, and the pre-configured LED will flash; if not configured, it won't flash.
• The Katapult firmware can only be used for flashing firmware and cannot connect to Klipper!!!
• There are three ways to connect the Katapult firmware to the host machine:
  • CAN connection
    • Advantages: After compiling the KLIPPER firmware, you can directly update the firmware using commands.
    • Disadvantages: You need to know the firmware compilation rate in advance.
  • RS232 connection
    • Advantages: After compiling the KLIPPER firmware, you can update the firmware using commands.
    • Disadvantages: You cannot update the firmware in one click using commands; you need to manually enter the Katapult firmware.
  • USB connection
    • Advantages: After compiling the KLIPPER firmware, you can directly update the firmware using commands.

tip

• ERCF V2 supports CANR, S232, USB
• Only CAN firmware is provided here, with speeds of 500K and 1M

Enter Programming Mode

tip

The circled part is the BOOT button

• To enter programming mode, you need to fully power off the mainboard, press the BOOT button, and then connect the data transfer cable to the mainboard and the host machine.
  

Flash Firmware

Windows Flash Tutorial

• Katapult firmware for ERCF V2 Click to automatically download firmware

• Prepare a data cable with data transmission capability
• Download the firmware to your computer
• Connect the BOOT jumper or hold it down after connecting to the computer, at this point the RPI-RP2 disk will appear
  
• Remove the BOOT jumper or release the button!!!
• Copy the firmware you need to burn into the disk, please note that only UF2 suffix firmware can be used!!! (Do not modify the suffix name, it is useless)
• Reference
  
• After copying the firmware into the RPI-RP2 disk, it will automatically disappear, at this point the firmware burning is completed!

Host Machine Flash Tutorial

1. Install the flashing tool

   • Enter the following command in SSH
   • Only execute this for the first flashing, no need to run it again after that

   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, please try to re-enter flashing mode

   • Due to system version issues, it may display other names. If there is a 2e8a:0003, it indicates that the flashing mode has been entered.

     
   Note

   Only proceed if there is a 2e8a:0003.

3. Pull the pre-compiled firmware

   • These are all pre-compiled firmwares
   • Please note that the host machine needs to be able to access the internet to install
   • The host machine needs to execute the following command to download the firmware package

   cd && git clone https://github.com/FengHua741/FLY_Katapult.git
   • If you have already downloaded the firmware package, it is recommended to update the firmware package before proceeding with the remaining steps

   cd ~/FLY_Katapult && git pull

4. Flash Firmware

tip

Only one firmware needs to be flashed.

• Below is the flash command for the 500K CAN speed firmware

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

• Below is the flash command for the 1M CAN speed firmware

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

• Below is the flash command for the USB firmware

  sudo ~/klipper/lib/rp2040_flash/rp2040_flash ~/FLY_Katapult/BL/FLY_ERCFV2_CANBOOT_USB.uf2

5. If the following prompt appears, the flashing is successful.

   

tip

After flashing, the mainboard needs to be completely powered off once.

Confirm Firmware Boot

• If the firmware starts up normally, the LED will blink.