Skip to main content

USB Firmware Compilation

Connect to the Host Computer​

Core Connection Limitation

The Fly-D8 motherboard can only communicate with the host computer for Klipper via the Type-C USB interface.

Loading...

Below is an introduction on how to compile the firmware:

  • After connecting via SSH, enter the following command and press the Enter key:

    cd ~/klipper && rm -rf ~/klipper/.config && rm -rf ~/klipper/out && make menuconfig

  • Here, rm -rf ~/klipper/.config && rm -rf ~/klipper/out deletes previous compilation data and firmware, and make menuconfig compiles the firmware. After execution, the following interface should appear:

    Loading...

  • Select Enable extra low-level configuration options and press the Enter key:

    Loading...

  • Navigate to the Micro-controller Architecture menu, then select STMicroelectronics STM32 and press the Enter key:

    Loading...

  • Enter the Processor model menu, select STM32H723, and press Enter:

    Loading...

  • Select Bootloader offset and choose: 128KiB bootloader:

    Loading...

  • Select Clock Reference (8 MHz crystal) and choose: 25 MHz crystal:

    Loading...

  • For Communication interface, select: USB (on PA11/PA12):

    Loading...
  • Press the Q key, and when Save configuration appears, press the Y key:
    Loading...
  • The configuration should now be saved, and you will exit back to the command line interface.
  • Enter the following command to start compilation. This may take some time: 
    make -j4
    Loading...
  • If the following content is output at the end, the compilation is successful.
  • Due to Klipper version differences, as long as out/klipper.bin appears, it indicates success: 
    Linking out/klipper.elf
    Creating bin file out/klipper.bin

Enter Flashing Mode​

  • After connecting the motherboard to the host computer using a Type-C data cable, double-click the RST button. At this point, the LED on the motherboard will blink.
Loading...

Flash the Firmware​

Start Flashing​

  • Non-FLY official host computers need to install Katapult
  • Install Katapult

Get the Board ID​

Execute the following command to search for the device ID. Normally, an ID similar to the one shown in the image below should be displayed (Note: Each board has a different ID):

ls /dev/serial/by-id/*

If the searched ID contains usb-katapult_stm32xxxxxxxx, it means you can proceed to the next step.

Loading...

Flash the Firmware​

⚠️ Preparations
  • Ensure the firmware file has been compiled.
  • Replace <Your Board ID> in the commands below with the actual ID obtained in the previous step.
  • For regular host computers, use the code below: 
    ~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d <Your Board ID>
  • For FLY host computers, use the code below: 
    python3 ~/katapult/scripts/flashtool.py -d <Your Board ID>

Flashing Process Reference:

Loading...

Successful Flashing Reference:

Loading...

Firmware Update​

USB Firmware Update Steps​

  1. Query the Board ID
ls /dev/serial/by-id/*
Key Points for Identification

In the image below, /dev/serial/by-id/usb-katapult_rp2040_E662549553642032-if00 is the board ID.

Loading...
  1. Update the Firmware
cd ~/klipper/ && make flash FLASH_DEVICE=<Your Board ID>
Note
  • Replace <Your Board ID> with the actual ID obtained from the query.
Loading...

Solutions for Flashing the Wrong Firmware​

Method 1: Quickly Enter Flashing Mode​

  1. Power off the board.
  2. After powering on again, quickly double-click the RESET button.
  3. Re-enter flashing mode.

Method 2: Re-flash the Katapult Firmware​

Click to View Katapult Firmware Flashing Guide
Loading...