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 supports CAN and USB
• Here we provide CAN firmware at 500K and 1M baud rates

Enter Programming Mode

tip

The circled part is the BOOT button

• To enter programming mode, the mainboard must be completely powered off, press the BOOT button, and then connect the data transfer cable to the mainboard and the host computer.
  

Flash Firmware

Windows flashing tutorial

• The Katapult firmware for ERCF click to automatically download the 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 flashing 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 command to flash 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 command to flash 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 command to flash the USB firmware

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

5. If the flashing is successful, you will see the following prompt

   

tip

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

Confirm Firmware Startup

• If the firmware starts up normally, the LED will start blinking.