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 in quick succession to enter Katapult firmware, at which point an 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 computer, 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, with strong anti-interference capability.
    • Disadvantages: Requires prior knowledge of the firmware's compiled baud rate.
  • RS232 connection
    • Advantages: After compiling the Klipper firmware, it can be updated using commands, with very strong anti-interference capability.
    • Disadvantages: Cannot update the firmware with a single command; requires manually entering Katapult firmware.
  • 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 disconnections.

tip

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

Entering Flash Mode

tip

The circled part is the BOOT button

• To enter flash mode, the motherboard must be completely powered off. Press and hold the BOOT button, then connect one end of a data cable with data transmission capability to the motherboard and the other end to the host computer.
  Loading...

Flashing Firmware

• Windows Flashing Tutorial
• Host Computer Flashing Tutorial

• Katapult firmware for TOOL-LITE-CAN
  • Click the download link below
  • Loading...

• Prepare a data cable with data transfer capability
• Download the firmware to your computer
• Connect the BOOT jumper or hold down the button while connecting to the computer. At this point, the RPI-RP2 disk will appear
  Loading...
• Remove the BOOT jumper or release the button!!!
• Copy the firmware to be flashed into the disk. Please note that only firmware with the UF2 file extension can be used!!! (Do not modify the file extension—it will not work)
• Reference
  Loading...
• After copying the firmware, the RPI-RP2 disk will automatically disappear, 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 flash; no need to repeat later

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

2. Run the command below 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 differences, it may display other names. If 2e8a:0003 appears, it indicates entry into flashing mode.

     Loading...
   Note

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

3. Pull the Pre-compiled Firmware

   • These are all pre-compiled firmware files.
   • Please note that the host computer must have internet access to install.
   • The host computer needs to execute the following command to download the firmware package.

   cd && git clone https://github.com/FengHua741/FLY_Katapult.git

   • If the firmware package has already been downloaded, it is recommended to update it before proceeding with the remaining steps.

   cd ~/FLY_Katapult && git pull

4. Flash the firmware

tip

Only one firmware needs to be flashed

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

  sudo ~/klipper/lib/rp2040_flash/rp2040_flash ~/FLY_Katapult/BL/TOOL-LITE/FLY_TOOL-LITE_CANBOOT_CAN_1M.uf2

5. If the following prompt appears, the flashing is successful

   Loading...

tip

After flashing is complete, the motherboard needs to be completely powered off once.

Confirm Firmware Startup

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