Katapult firmware

Katapult firmware notes

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

• The Katapult firmware for D7 uses the third connection method: USB connection
• D7 has already been pre-flashed with Katapult firmware since September 1, 2024

Enter DFU programming mode

tip

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

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

Programming the firmware

Windows programming tutorial

• Katapult firmware for D7
  • Click the download link below
  • Loading...

Notes

• USB3.0 may fail to program, please try to use the USB2.0 of the computer for programming
• If it still cannot be programmed, please use the host software for programming
• If the error below appears, please use a USB extension dock
  

1. Programming tool Download address
2. Need to download SetupSTM32CubeProgrammer and STM32 DFU driver
3. Copy the compiled firmware (klipper.bin) or the pre-compiled Katapult firmware to any directory on the computer
4. Use a Type-C data cable to connect the mainboard to the computer, please make sure that it has entered the dfu programming mode
5. In STM32CubeProgrammer, select USB mode, refresh, and connect
   
6. If no error pop-up appears, the connection is successful.
   Warning

   If the content shown in the figure appears, it is a computer or software issue, please use the host software for programming:Host software programming tutorial

   
7. Click the left download icon and select the following options
   
8. Click the Browse indicated by the arrow, then select the firmware you need to program
   
9. Select Start address and enter 0x08000000
   • Please note that if the firmware is in HEX format, please skip this step!!
   
10. Click Start automatic mode at the bottom to start programming the firmware
    
11. If the prompt below appears, it means the firmware programming is complete
    

Host computer programming tutorial

1. Install the burning tool

• No need to install the burning tool for the FLY upper computer
• If you need to install, please note: The upper computer needs to be connected to the internet to install normally
• If already installed, no need to install

sudo apt update
sudo apt install dfu-util -y

2. Execute the following command to check if the connection is successful.

lsusb

• If there is no DFU device, please try to re-enter burning mode
• Due to system version issues, other names may be displayed. If 0483:df11 is shown, it indicates that the burning mode has been entered

3. Pull the pre-compiled firmware

• These are all pre-compiled firmwares
• Please note: The upper computer needs to be connected to the internet to install
• The upper computer needs to execute the command below to download the firmware package (if unable to get the file due to network issues on the upper computer, please contact the administrator in the after-sales group)

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 flashing commands

  sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/FLY_Katapult/BL/D/FLY_D7.bin

5. If the content shown in the arrow of the following picture appears: File downloaded successfully, the programming is successful

   

tip

After programming is completed, the motherboard needs to be completely powered off once.