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

Search for Devices

• Please ensure that the host machine can connect to the network normally and ensure that the data cable connecting the lower machine to the host machine has data transmission function.
• After SSH connection to the host machine, enter lsusb and press Enter. If the information circled in the picture below appears, you can proceed to the next step.
  • If there is no feedback at all, this is a system issue of the host machine, and we are unable to help. You need to replace a confirmed normal system or replace the host machine.
  • If the instruction lsusb is not recognized, you can execute the following command to install it:

    sudo apt-get install usbutils

    
• The ID displayed in the red box can be used as a reference but is not a fixed ID and may vary. The suffix OpenMoko, Inc. Geschwister Schneider CAN adapter has a basis for judgment.
• Some host machines may display incomplete or no information due to system issues.

• 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