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

• SHT36 V2 can only use CAN connection
• CAN firmware provided here has 500K and 1M baud rates

Notes

• APMF072 can only use a computer for firmware flashing
• STM32F103 can only use the host software to update firmware

Enter Flash Mode

tip

The circled area shows the BOOT switch

• STM32F103 does NOT require this step!!!!!!
• With the motherboard completely powered off, press the BOOT button and connect the motherboard to your device using a TYPE-C cable that supports data transfer
  

Flash Firmware

STM32F072 Windows Flash Tutorial

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

Notice

• USB3.0 may fail to flash, please try to use the computer's USB2.0 for flashing
• If flashing still fails, please try using a host computer for flashing
• If the error below occurs, please use a USB hub
  

1. Flashing tool Download link
2. Please download SetupSTM32CubeProgrammer and STM32 DFU driver
3. Copy the previously compiled firmware klipper.bin, Katapult, or Marlin to any directory on your computer
4. Connect the motherboard to the computer using a Type-C cable, ensuring it has entered dfu flashing mode
5. In STM32CubeProgrammer, select USB mode, then refresh and connect
   
6. If no error pop-up appears, the connection is successful.
   Warning

   If the content shown in the figure below appears, it indicates a computer or software issue. Please use a host computer for flashing: Host Computer Flashing Tutorial

   
7. Click the download icon on the left and check the options below
   
8. Click the Browse button as indicated by the arrow, then select the firmware you need to flash
   
9. Enter 0x08000000 in the Start address field
   • Please note that if the firmware is in HEX format, skip this step!!
   
10. Click Start automatic mode below to begin flashing the firmware
    
11. If the prompt shown below appears, the firmware flashing is complete
    

STM32F072 Host Software Flash 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. Flash Firmware

tip

Only one firmware needs to be flashed

• Below are the commands for flashing firmware with 500K CAN baud rate

sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/FLY_Katapult/developer/SHT36/FLY_SHT36V2_072_500K.BIN

• Below are the commands for flashing firmware with 1M CAN baud rate

sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/FLY_Katapult/developer/SHT36/FLY_SHT36V2_072_1M.BIN

5. If the flashing is successful, you will see the text File downloaded successfully as shown in the figure below:

   

tip

After flashing, you need to completely power off the motherboard once.

APM32F072 Windows Flash Tutorial

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

1. Burning tool Download link
2. Need to download DFUProgrammer
3. Copy the previously compiled firmware (klipper.bin) or pre-compiled Katapult firmware to any directory on your computer
4. Connect the motherboard to your computer using a Type-C data cable, ensuring it has already entered DFU programming mode
5. Open DFUProgrammer and make the selections as shown below
   
   
6. Click Start to update the firmware and wait a moment. Once programming is complete, you can unplug the Type-C cable and the jumper cap

STM32F103 Klipper Firmware Update Tutorial

Search for Devices

• Please ensure that the host computer can access the Internet normally and ensure that the data cable connecting the lower computer to the host computer has data transmission function.
• After SSH connecting to the host computer, input lsusb and press Enter. If the information circled in the picture below is displayed, you can proceed to the next step.
  • If there is no feedback information, this is a system problem of the host computer, and we are powerless. You need to replace a confirmed normal system or replace the host computer.
  • If there is no lsusb command prompt, you can execute the following command to install it:

    sudo apt-get install usbutils

    
• 1d50:606f belongs to the device you will use this time.
• Some host computers may not fully display or fail to display due to system problems.
• If the lsusb command can display the device but there is no 1d50:606f, please try to replace the data cable and connect the motherboard to another USB port on the host computer.

Notice

You can proceed to the next step only when there is 1d50:606f.

• Pull pre-compiled firmware
• All firmware here is pre-compiled
• Please note the host must have internet access to install
• The following command needs to be executed on the host to download the firmware package

cd && git clone https://github.com/FengHua741/FLY_Katapult.git

• If you have already downloaded the firmware package, we recommend updating the package before proceeding with the remaining steps

cd ~/FLY_Katapult && git pull

• This method directly updates the existing Katapult firmware on the toolboard through CAN
• You need to replace <Toolboard ID> with the CAN ID of the STM32F103 controller on the toolboard
• Below is the firmware update command for the 103 version with 1M CAN baud rate

~/klippy-env/bin/python ~/klipper/lib/canboot/flash_can.py -f ~/FLY_Katapult/developer/SHT36/FLY_SHT36V2_103_1M.BIN  -u <Toolboard ID>

• Below is the firmware update command for the 072 version with 500K CAN baud rate

~/klippy-env/bin/python ~/klipper/lib/canboot/flash_can.py -f ~/FLY_Katapult/developer/SHT36/FLY_SHT36V2_103_500K.BIN  -u <Toolboard ID>

Confirm Firmware is Running

• If the firmware starts successfully, the LED will begin to blink