Katapult Firmware

Katapult Firmware Description

Tip

Katapult was originally named CanBoot and later renamed to katapult.

• The Katapult firmware is a type of bootloader that can be used together with Klipper. After flashing via DFU or other methods, firmware can be updated with a single command.
• Advantages: Quickly double-click the reset button or power cycle twice to enter the Katapult firmware, at which point 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 ways to connect to the host computer, and the firmware for each method is independent.
  • CAN connection
    • Advantages: After compiling the Klipper firmware, it can be updated directly using commands, with strong anti-interference capability.
    • Disadvantages: The firmware compilation speed needs to be known in advance.
  • RS232 connection
    • Advantages: After compiling the Klipper firmware, it can be updated using commands, with very strong anti-interference capability.
    • Disadvantages: Firmware cannot be updated with a single command; 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, which may cause disconnection.

Tip

• TOOL-LITE supports CAN
• Only CAN firmware at 1M rate is provided here

Entering Flash Mode

Tip

The circled button is the BOOT button

• To enter flash mode, completely power off the mainboard, hold down the BOOT button, then connect a data cable with data transmission capability between the mainboard and the host computer
  Loading...

Flashing Firmware

• Windows Flashing Tutorial
• Host Flashing Tutorial

• TOOL-LITE-CAN Katapult Firmware
• 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

• The firmware is located at

FLY-Firmware/ToolBoard/TOOL-LITE

• Prepare a data cable with data transmission functionality
• Download the firmware to the computer
• Connect the BOOT jumper, or press and hold the BOOT button while connecting to the computer, then the RPI-RP2 disk will 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 file extension can be used!!! (Do not modify the file extension; it is ineffective)
• Reference
  Loading...
• After copying the firmware, the RPI-RP2 disk will disappear automatically, indicating that 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. Flashing Firmware

Tip

Only one firmware needs to be flashed

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

  sudo ~/klipper/lib/rp2040_flash/rp2040_flash ~/FLY-Firmware/ToolBoard/TOOL-LITE/FLY_TOOL-LITE_CANBOOT_CAN_1M.uf2

5. The following prompt indicates successful flashing

   Loading...

Tip

After flashing, completely power off the mainboard once.

Confirming Firmware Startup

• If the firmware starts normally, the LED will begin blinking
  Loading...