Katapult Firmware
Katapult Firmware Description
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 flashing via methods like DFU, the firmware can be updated with a single command.
- Advantages: Quickly double-click the reset button or power off twice rapidly to enter Katapult firmware, at which point the motherboard's LED will blink.
- Katapult firmware can only be used to flash firmware and cannot connect to Klipper!!!
- Katapult firmware supports three methods for connecting to the host computer, with each method's firmware being independent of the others:
- CAN connection
- Advantages: After compiling the Klipper firmware, the firmware can be updated directly using commands, with strong anti-interference capabilities.
- Disadvantages: The firmware compilation rate must be known in advance.
- RS232 connection
- Advantages: After compiling the Klipper firmware, the firmware can be updated using commands, with very strong anti-interference capabilities.
- Disadvantages: Firmware cannot be updated with a single command; manual entry into Katapult firmware is required.
- USB connection
- Advantages: After compiling the Klipper firmware, the firmware can be updated directly using commands.
- Disadvantages: Long data cables are prone to interference, which may cause disconnections.
- CAN connection
- SHT36 V2 can only use CAN connection
- CAN firmware provided here is available in 500K and 1M rates.
- APMF072 can only be flashed using a computer.
- STM32F103 can only be updated using the host machine.
Enter Flash Mode
The circled area is the BOOT pin.
- STM32F103 does NOT require this step!!!!
- With the mainboard completely powered off, short the BOOT pins. Then connect a Type-C cable capable of data transfer between the mainboard and your device.
Loading...
Flash Firmware
- Windows Flashing Tutorial for STM32F072
- Host Machine Flashing Tutorial for STM32F072
- Windows Flashing Tutorial for APM32F072
- Klipper Firmware Update Tutorial for STM32F103
- Katapult firmware for SHT36_V2
- You can obtain the firmware via the following links:
- Download Firmware Package - Directly download the latest firmware package.
- Repository Address - Visit the firmware repository.
- Firmware location:
FLY-Firmware/ToolBoard/SHT36
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 resolve the issue, an effective solution is to connect via an external USB hub, which often improves compatibility.
- If the programming software reports the error shown below, also prioritize trying a USB hub. If the problem persists, please check or use the host computer for programming.
Loading...
- Programming Tool Download Link
- Download both
SetupSTM32CubeProgrammerand theSTM32 DFU Driver. - Download the firmware to any directory on your computer.
- Connect the mainboard to the computer using a Type-C data cable. Ensure the board is in
DFUprogramming mode. - In STM32CubeProgrammer, select USB mode, then refresh and connect.
Loading...
- If no error pop-up appears, the connection is successful.
Loading...
- Click the download icon on the left and select the options shown below.
Loading...
- Click
Browseas indicated by the arrow, then select the firmware you need to program.Loading... - For
Start address, enter0x08000000.- Note: If the firmware is in
HEXformat, please skip this step!!
Loading... - Note: If the firmware is in
- Click
Start automatic modebelow to begin programming the firmware.Loading... - The prompt below indicates that the firmware programming is complete.
Loading...
- Install the Flashing Tool
- FLY host machine does not need to perform this step.
- If installation is required, ensure the host machine is connected to the internet.
- If the flashing tool has already been installed, you can skip this step.
sudo apt update
sudo apt install dfu-util -y
- Check Device Connection Status
- Execute the following command to confirm whether the device is successfully connected:
lsusb
- If the DFU device is not recognized, try re-entering flashing mode.
- On some system versions, the device name may vary; as long as
0483:df11appears, it indicates successful entry into flashing mode.
- Obtain Precompiled Firmware
-
The following are precompiled firmware files. Please select the corresponding command to download based on your system type (ensure the host machine can access the internet).
-
For regular systems, use:
cd && git clone https://cnb.cool/3dmellow/FLY-Firmware.git -
For FLY host machines, use:
git clone https://cnb.cool/3dmellow/FLY-Firmware.git /data/FLY-Firmware
ln -s /data/FLY-Firmware /root/FLY-Firmware -
If the firmware package has already been downloaded, it is recommended to update to the latest version before proceeding:
cd ~/FLY-Firmware && git pull
- The previous repository is no longer maintained. If deletion is required, execute:
rm -rf ~/FLY_Katapult && /root/FLY_Katapult
- Flash Firmware
Only one firmware file needs to be flashed.
- Command to flash the 500K CAN rate firmware:
sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/FLY-Firmware/ToolBoard/SHT36/FLY_SHT36V2_072_CANBOOT_500K.bin
- Command to flash the 1M CAN rate firmware:
sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/FLY-Firmware/ToolBoard/SHT36/FLY_SHT36V2_072_CANBOOT_1M.bin
-
Flashing is successful when you see the text
File downloaded successfullyat the arrow position in the image below.Loading...
After flashing, the mainboard must be completely powered off once.
- Katapult firmware for SHT36_V2
- You can obtain the firmware via the following links:
- Download Firmware Package - Directly download the latest firmware package.
- Repository Address - Visit the firmware repository.
- Firmware location:
FLY-Firmware/ToolBoard/SHT36
- Download the flashing tool: Download Link
- Install the DFU driver: Download and extract
DFUProgrammer. The package includes the DFU driver for APM32. Please install this driver manually. - Prepare the firmware: Copy the previously compiled firmware file to any directory on your computer (e.g., the desktop) for easy selection later.
- Enter DFU mode: Connect the mainboard to the computer using a Type-C cable. Ensure the mainboard is in DFU flashing mode (usually set via a jumper cap; for specific methods, refer to the mainboard's DFU entry instructions).
- Run the flashing tool: Open DFUProgrammer and select and configure as shown in the images below:
Loading...Loading...
- Start flashing: Click the "Start Updating Firmware" button and wait for the progress bar to complete. Once the flashing is successful, you can disconnect the Type-C cable and remove the jumper cap.
- Pull Pre-compiled Firmware
- These are all pre-compiled firmware files.
- Note: The host machine must have internet access for installation.
- Execute the following command on the host machine to download the firmware package:
cd && git clone https://cnb.cool/3dmellow/FLY-Firmware.git
- If the firmware package has already been downloaded, it is recommended to update it before proceeding with the remaining steps.
cd ~/FLY-Firmware && git pull
- This method directly updates the existing Katapult firmware on the toolboard via CAN.
- Replace
<Toolboard ID>with the CAN ID of the STM32F103-based toolboard. - Command to update to the 103 version 1M CAN rate firmware:
~/klippy-env/bin/python ~/klipper/lib/canboot/flash_can.py -f ~/FLY-Firmware/developer/SHT36/FLY_SHT36V2_103_1M.BIN -u <Toolboard ID>
- Command to update to the 072 version 500K CAN rate firmware:
~/klippy-env/bin/python ~/klipper/lib/canboot/flash_can.py -f ~/FLY-Firmware/developer/SHT36/FLY_SHT36V2_103_500K.BIN -u <Toolboard ID>
Verify Firmware Startup
- If the firmware starts normally, the LED will begin to blink.
Loading...