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

• SB2040_V3 supports CAN and RS232
• Only CAN firmware with 500K and 1M rates is provided here

Enter programming mode

tip

The left is the RESET button, the right is the BOOT button

• There are two ways to enter programming mode
• First method: With the mainboard completely powered off, press the BOOT button and then connect one end of a data transmission cable to the mainboard and the other end to your device
• Second method: After connecting one end of a data transmission cable to the mainboard and the other end to your device, press the BOOT key and then press the RST key, then release the RST key and finally release the BOOT key
  

Programming the firmware

Windows programming tutorial

• Katapult firmware for SB2040 V3 Click to automatically download the firmware

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

tip

Only one of the firmwares needs to be programmed

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

  sudo ~/klipper/lib/rp2040_flash/rp2040_flash ~/FLY_Katapult/BL/SB2040/FLY_SB2040V3_CANBOOT_CAN_500K.uf2

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

  sudo ~/klipper/lib/rp2040_flash/rp2040_flash ~/FLY_Katapult/BL/SB2040/FLY_SB2040V3_CANBOOT_CAN_1M.uf2

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

   

tip

After programming is complete, the mainboard must be completely powered off once.

Confirm if the firmware is running

• If the firmware starts normally, the LED will blink