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 area 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
• 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 location is:

FLY-Firmware/ToolBoard/TOOL-LITE

• 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
   • Only required for the first flash; no need to execute again later

   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 differences, it may display other names; if 2e8a:0003 is present, it indicates entry into flashing mode

     Loading...
   Important 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 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 steps

   cd ~/FLY-Firmware && git pull

4. Flash the firmware

tip

Only one firmware needs to be flashed

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

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

5. If the following prompt appears, the flashing was successful:

   Loading...

tip

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

Confirm Firmware Startup

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