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

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

Entering Flash Mode

Tip

The circled part is the BOOT button

• To enter flash mode, ensure the mainboard is completely powered off. Press and hold the BOOT button, then connect the data cable with data transmission capability to the mainboard on one end and the host computer on the other
  Loading...

Flashing Firmware

• Windows Flashing Tutorial
• Host Computer Flashing Tutorial

• TOOL-LITE-CAN Katapult Firmware
• You can obtain the firmware via the following links:

• Download Firmware Package - Directly download the latest firmware archive
• Repository Address - Access the firmware repository

• Firmware location is:

FLY-Firmware/ToolBoard/TOOL-LITE

• 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. Flashing the Firmware

Tip

Only one firmware needs to be flashed

• Below is the command for flashing firmware at 1M CAN baud rate

  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.

Verifying Firmware Startup

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