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 DFU or similar methods, one-click firmware updates can be performed using commands.
• Advantages: Quickly double-press the reset button or power cycle twice to enter Katapult firmware, during which the LED on the motherboard 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 machine, with each method’s firmware being independent of the others:
  • CAN connection
    • Advantages: After compiling the Klipper firmware, it can be updated directly using commands; strong anti-interference capability.
    • Disadvantages: The firmware compilation speed must be known in advance.
  • RS232 connection
    • Advantages: After compiling the Klipper firmware, it can be updated using commands; very strong anti-interference capability.
    • Disadvantages: One-click firmware updates via commands are not possible; manual entry into Katapult firmware is required.
  • USB connection
    • Advantages: After compiling the Klipper firmware, it can be updated directly using commands.
    • Disadvantages: Long data cables are prone to interference, potentially causing disconnection.

Tip

• SB2040_PRO supports CAN
• Only CAN firmware is provided here, with 500K and 1M rates

Entering Flash Mode

Tip

The circled area is the BOOT button

• Method 1: With the toolboard completely powered off, hold down the BOOT button, then connect one end of a TYPE-C cable with data transmission capability to the mainboard and the other end to your device.
  Loading...

Flashing Firmware

• Windows Flashing Tutorial
• Host Flashing Tutorial

• Katapult firmware for SB2040 PRO
• You can obtain the firmware via the following link:

• Download Firmware Package – Direct download of the latest firmware zip archive

Please note

The zip archive must be extracted before use.

• Repository Address – Access the firmware repository

• Alternatively, download the complete repository via git (ensure the host machine has internet access):

• For general systems

  cd && git clone https://cnb.cool/3dmellow/FLY-Firmware.git

• For FLY host machine

  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. To delete it, execute:

  rm -rf ~/FLY_Katapult /root/FLY_Katapult

• Firmware location:

FLY-Firmware/ToolBoard/SB2040

• Prepare a data cable with data transfer functionality
• Download the firmware to the computer
• Connect the BOOT jumper, or press and hold the BOOT button before connecting to the computer. The RPI-RP2 disk will then appear
  Loading...
• Remove the BOOT jumper or release the button!!!
• Copy the firmware to be flashed into it. Please note that only firmware with the UF2 extension can be used!!! (Do not modify the file extension, as this is ineffective)
• Reference
  Loading...
• After the firmware is copied in, the RPI-RP2 disk will automatically disappear, indicating the firmware flashing is complete!

1. Install the flashing tool

   • Enter the following command in SSH
   • This only needs to be executed for the first flashing; no need to run it again afterwards

   cd ~/klipper/lib/rp2040_flash/ && make

2. Execute the following command to check if the connection is successful.

   • Enter lsusb

   • If there is no 2e8a:0003 device, try re-entering flashing mode

   • Due to system version issues, it may display a different name. If 2e8a:0003 appears, it means flashing mode has been entered

     Loading...
   Notes

   Proceed to the next step only when 2e8a:0003 is present

3. Pull the precompiled firmware

   • These are all precompiled firmware files
   • Please note that the host machine needs internet access to install
   • The host machine needs to execute the following command 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 operations

   cd ~/FLY-Firmware && git pull

4. Flash Firmware

Tip

Only one firmware needs to be flashed

• Below is the flash command for 500K CAN rate firmware

  sudo ~/klipper/lib/rp2040_flash/rp2040_flash ~/FLY-Firmware/ToolBoard/SB2040/FLY_SB2040PRO_CANBOOT_500K.uf2

• Below is the flash command for 1M CAN rate firmware

  sudo ~/klipper/lib/rp2040_flash/rp2040_flash ~/FLY-Firmware/ToolBoard/SB2040/FLY_SB2040PRO_CANBOOT_1M.uf2

5. The following prompt indicates successful flashing

   Loading...

Tip

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

Verify Firmware Startup

• If the firmware starts normally, the LED will blink
  Loading...