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
  Loading...

Flash Firmware

STM32F072 Windows Flash Tutorial

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

Important Notice

To ensure successful STM32 programming, please pay attention to the following:

• Some computer USB ports may experience unstable programming due to driver or signal compatibility issues. It is recommended to try connecting to a different USB port.
• If changing ports does not help, an effective solution is to connect via an external USB hub, which often improves compatibility.
• When the programming software reports the error message shown below, also try using a hub first. If the issue persists, please check or use the host computer for programming.
  Loading...

1. Programming Tool Download Link
2. Download SetupSTM32CubeProgrammer and the STM32 DFU Driver.
3. Download the firmware to any directory on your computer.
4. Connect the mainboard to the computer using a Type-C cable. Ensure it has entered DFU programming mode.
5. In STM32CubeProgrammer, select USB mode, refresh, and connect.
   Loading...
6. If no error pop-up appears, the connection is successful.
   Loading...
7. Click the download icon on the left and select the options shown below.
   Loading...
8. Click Browse as indicated by the arrow, then select the firmware you need to program.
   Loading...
9. For Start address, enter 0x08000000.
   • Note: If the firmware is in HEX format, please skip this step!!
   Loading...
10. Click Start automatic mode below to begin programming the firmware.
    Loading...
11. The prompt below indicates that the firmware programming is complete.
    Loading...

STM32F072 Host Software Flash Tutorial

1. Install the flashing tool

• This step is not required for FLY host software.
• If installation is needed, ensure the host computer is connected to the internet.
• If the flashing tool has already been installed, you may skip this step.

sudo apt update
sudo apt install dfu-util -y

2. Check device connection status

• Run the following command to confirm whether the device is successfully connected:

lsusb

• If the DFU device is not recognized, try re-entering flashing mode.
• In some system versions, the device name might differ; as long as 0483:df11 appears, it indicates the device has successfully entered flashing mode.

Loading...

3. Obtain the pre-compiled firmware

• Below are pre-compiled firmware files. Please choose the corresponding command based on your system type to download (ensure the host computer can access the internet). If download fails due to network issues, please contact the after-sales group administrator for assistance.

---

FlyOS-Armbian or Standard System

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

FlyOS-FAST System

git clone https://github.com/FengHua741/FLY_Katapult.git /data/FLY_Katapult 
ln -s /data/FLY_Katapult /root/FLY_Katapult

---

• If you have previously downloaded the firmware package, it is recommended to update to the latest version before proceeding:

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:

   Loading...

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
   Loading...
   Loading...
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

• Now that you have successfully logged into the host computer, you can enter lsusb to search for devices. You may encounter one of the following situations:
  • If entering lsusb prompts that the ls command is not found, you can install the required utility by entering the following command:

    sudo apt-get install usbutils

  • If there is no response after entering lsusb, this is a system issue and cannot be resolved here. You will need to change the system or use a known working system.
  • If information like that shown in the image below appears, please note that this is only a reference. You only need to confirm that 1d50:606f appears:
    Loading...
• 1d50:606f is the device you will use in this instance.
• If multiple 1d50:606f devices appear, one must be excluded, as multiple entries may affect subsequent flashing and firmware connection. For example, with FLY MINI PAD, it is recommended to use the onboard UTOC and avoid using other CAN bridges.
• If the device does not appear, please check whether the data cable is properly connected and whether the correct firmware has been flashed.

Note

You can proceed to search for the CAN ID only when 1d50:606f appears.

• 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
  Loading...