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

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

Entering Flash Mode

tip

The circled one is BOOT

• With the motherboard completely powered off, short the BOOT pins, then connect a Type-C cable capable of data transfer between the motherboard and your device.
• Then remove the short from the BOOT pins.
  Loading...

Flashing the Firmware

• Windows Flashing Tutorial
• Host PC Flashing Tutorial

• Katapult firmware for SHT36_LIS3DH
  • 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 to flash the 500K CAN rate firmware:

  sudo ~/klipper/lib/rp2040_flash/rp2040_flash ~/FLY_Katapult/BL/SHT36/FLY_SHT36LIS3DH_CANBOOT_CAN_500K.uf2

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

  sudo ~/klipper/lib/rp2040_flash/rp2040_flash ~/FLY_Katapult/BL/SHT36/FLY_SHT36LIS3DH_CANBOOT_CAN_1M.uf2

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

   Loading...

tip

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

Verifying if the Firmware has Started

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

Loading...