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

Tip

All three MMU types are supported.
Only CAN firmware and USB firmware are provided here.

Entering Flash Mode

Tip

The top button is the RESET button, and the bottom button is the BOOT button.

There are two methods to enter flash mode:
First method: With the tool board completely powered off, hold the BOOT button, then connect a data-capable Type-C cable from the mainboard to your device.
Second method: After connecting a data-capable Type-C cable from the mainboard to your device, hold the BOOT button, press the RST button, then release the RST button, and finally release the BOOT button.
Loading...

Flashing the Firmware

Windows Flashing Tutorial
Host PC Flashing Tutorial

Katapult firmware for the MMU.
You can obtain the firmware via the following links:

Download Firmware Package - Directly download the latest firmware archive.
Repository Address - Visit the firmware repository.

The firmware is located at:

FLY-Firmware/ToolBoard/MMU

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 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 SetupSTM32CubeProgrammer and the STM32 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 DFU programming 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 Browse as indicated by the arrow, then select the firmware you need to program.
Loading...
For Start address, enter 0x08000000.
- Note: If the firmware is in HEX format, please skip this step!!
Loading...
Click Start automatic mode below 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:df11 appears, 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 the firmware

Tip

Only one firmware needs to be flashed.

Below is the command to flash the 500K CAN baud rate firmware:

sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/FLY-Firmware/ToolBoard/MMU/FLY_MMU_CANBOOT_CAN_500K.bin

Below is the command to flash the 1M CAN baud rate firmware:

sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/FLY-Firmware/ToolBoard/MMU/FLY_MMU_CANBOOT_CAN_1M.bin

Below is the command to flash the USB firmware:

sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/FLY-Firmware/ToolBoard/MMU/FLY_MMU_CANBOOT_USB.bin

If the content shown by the arrow in the image below, File downloaded successfully, appears, the flashing was successful.

Loading...

Tip

After flashing is complete, you need to completely power off the mainboard once.

Verifying Firmware Startup

If the firmware starts normally, the LED will begin to blink.
Loading...