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 be connected via CAN
• CAN firmware is provided at both 500K and 1M rates

Note

• APMF072 can only be flashed using a computer
• STM32F103 can only be updated using a host computer

Entering Boot Mode

tip

The circled part is the BOOT switch

• STM32F103 does not need to perform this step！！！！
• With the motherboard completely powered off, press and hold the BOOT button while connecting a data cable with data transfer from one end of the motherboard to your device
  

Flashing Firmware

STM32F072 Windows Flashing Tutorial

• Katapult firmware for SHT36_V2 Click to download firmware automatically

Notice

• System compatibility issues, please use the computer's USB2.0 for burning
• If it still cannot be burned, please use the host machine for burning

1. Burning tool Download link
2. Need to download SetupSTM32CubeProgrammer and STM32 DFU driver
3. Copy the firmware (klipper.bin) compiled in front or the precompiled Katapult firmware to any directory on the computer
4. Use a Type-C data cable to connect the motherboard to the computer, make sure it is already:Enter DFU burning mode
5. In STM32CubeProgrammer, select USB mode, refresh, and connect
   
6. If no error pop-up appears, then the connection is successful.
   Warning

   If the content shown below appears, it indicates a problem with the computer or software, please use the host machine for burning:Host machine burning tutorial

   
7. Click the download icon on the left and select several options below
   
8. Click the Browse button indicated by the arrow, then select the firmware you need to burn
   
9. Select Start address and enter 0x08000000
   
10. Click Start automatic mode below to start burning the firmware
    
11. The prompt below indicates that the firmware burning is complete
    

STM32F072 Host Computer Flashing 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. Flashing Firmware

tip

Only one of the firmwares needs to be flashed

• Below are the firmware flashing commands for 500K CAN 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 firmware flashing commands for 1M CAN 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 message File downloaded successfully appears as shown by the arrow in the image below, the flashing is successful

   

tip

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

APM32F072 Windows Flashing Tutorial

• Katapult firmware for SHT36_V2 Click to download firmware automatically

1. Flashing Tool Download Link
2. Download DFUProgrammer
3. Copy the firmware (klipper.bin) compiled in advance or the pre-compiled Katapult firmware to any directory on your computer
4. Connect the main board to the computer using a Type-C cable, and make sure it has entered DFU flashing mode
5. Open DFUProgrammer and follow the instructions below
   
   
6. Click to start updating the firmware and wait for it to complete, then you can remove the Type-C cable and jumpers.

STM32F103 Klipper Firmware Update Tutorial

• Please ensure that the host machine can connect to the internet normally, and ensure that the data cable connecting the sub-machine to the host machine has data transmission capabilities.
• After SSH connecting to the host machine, enter lsusb and press Enter. If the information circled in the following image appears, you can proceed to the next step.
  • If there is no feedback information, this is a system issue with the host machine, and we are unable to help. You need to replace it with a normal system or replace the host machine.
  • If there is a提示 of no lsusb command, you can execute the following command to install it:

    sudo apt-get install usbutils
    
• 1d50:606f belongs to the device you will be using this time. The suffix OpenMoko, Inc. Geschwister Schneider CAN adapter has some reference value but is not used as a basis for judgment.
  • Some host machines may display incompletely or not at all due to system issues.
  • If entering the lsusb command displays the device, but does not show 1d50:606f, please try replacing the data cable and attempt to connect the motherboard to another USB port on the host machine.
• If you have executed the above steps previously and successfully burned the Klipper firmware, and the motherboard is operating normally, but you only need to update the Klipper firmware, please directly refer to the Firmware Update section in the right-hand menu bar of this page.

Note

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

• Pull precompiled firmware
• All are precompiled firmwares here
• Please note that the host computer needs to be able to access the internet to install
• The host computer 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

• This method is to directly update the original Katapult firmware of the toolboard through the CAN update tool
• The <Toolboard ID> needs to be replaced with the CANID of the toolboard of the STM32F103 main control
• Below is the firmware update command for version 103 at 1M CAN 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 version 072 at 500K CAN rate

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

Confirming Firmware Startup

• If the firmware starts normally, the LED will start flashing