Katapult Firmware

Katapult Firmware Description

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, USB
• Here provides CAN firmware at 500K and 1M rates

Enter Burning Mode

tip

The circled part is the BOOT button

• To enter burning mode, the motherboard must be completely powered off, press and hold the BOOT button, then connect one end of the data cable with data transmission to the motherboard and the other end to the host computer
  

Burn Firmware

Windows Burning Tutorial

• ERCF's Katapult firmware Click to download firmware automatically

• 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 Burning Tutorial

1. Install the burning tool

   • Enter the following command in SSH
   • Only execute this the first time you burn, no need to execute it afterwards

   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 burning mode

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

     
   Notice

   Proceed to the next step only 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 the firmware package has already been downloaded, it is recommended to update the firmware package before proceeding with the remaining operations

   cd ~/FLY_Katapult && git pull

4. Burn Firmware

tip

Only one of the firmwares needs to be burned

• Below is the firmware writing instruction for 500K CAN rate

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

• Below is the firmware writing instruction for 1M CAN rate

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

• Below is the firmware writing instruction for USB

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

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

   

tip

After burning, the motherboard needs to be completely powered off once.

Confirm Whether the Firmware Starts

• If the firmware starts normally, the LED will start flashing