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
• The CAN firmware is provided in two rates: 500K and 1M

Enter programming mode

tip

The circled area is the BOOT button

• To enter programming mode, the motherboard must be completely powered off. Press the BOOT button and connect one end of a data cable to the motherboard and the other end to the host computer
  

Program the firmware

Windows programming tutorial

• ERCF Katapult firmware
  • Click 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 programming tutorial

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. Program the firmware

tip

Only one of the firmwares needs to be programmed

• The following are the commands for programming the 500K CAN rate firmware

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

• The following are the commands for programming the 1M CAN rate firmware

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

• The following are the commands for programming the USB firmware

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

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

   

tip

After programming, the motherboard must be completely powered off once.

Confirm if the firmware starts up

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