Skip to main content

Wired Connection Klipper Configuration

Notes
  • You need to flash the firmware to STM32F072 before connecting to Klipper, otherwise wired connection operation is not supported.

Start Compilation​

The following describes how to compile the firmware:

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

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

  • Among them, rm -rf ~/klipper/.config && rm -rf ~/klipper/out is used to delete the previous compilation data and firmware.

  • make menuconfig is for compiling the firmware. After execution, the following interface should appear.

    Loading...

  • Select Enable extra low-level configuration options and press Enter.

    Loading...

  • Enter the menu Micro-controller Architecture and then select STMicroelectronics STM32 and press Enter.

    Loading...

  • Enter the menu Processor model, select STM32F072 and press Enter.

    Loading...

  • Select Bootloader offset, choose: (No bootloader)

    Loading...

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

    Loading...
  • Press the Q key. When Save configuration appears, press the Y key.
    Loading...
  • The configuration should now be saved and you will exit to the command line interface.
  • Enter the following command to start compilation. It may take a while.
make -j4
Loading...
  • Finally, if the following output appears, 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 Flash Mode​

  • With the AirClick powered off, press and hold the STM32's BOOT button, then connect the STM32's flash port to the host computer via Type-C.
    Loading...

Flash Firmware​

  1. Install the flashing tool

    • No need to install the flashing tool for the FLY host computer
    • If you need to install it, please note: The host computer must have internet access for proper installation
    • If already installed, there is no need to install again
    sudo apt update
    sudo apt install dfu-util -y

  2. Run the following command to check if the connection is successful.

    lsusb

    • If no DFU device is found, please try re-entering flashing mode

    • Due to system version differences, it may display a different name. If you see 0483:df11, it indicates that the flashing mode has been entered

      Loading...

  3. Flash the firmware

    • Run the command below to start flashing. Replace <full path of firmware file> with the actual firmware file path
    sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D <full path of firmware file>

  4. If the message File downloaded successfully appears as shown below, the flashing is successful

    Loading...
    Tip

    After flashing is complete, be sure to completely power off the motherboard once.

Search USB ID​

  • Connect the AirClick's flash port to the host computer's USB port. Do not press and hold the BOOT button, otherwise the ID cannot be found.
    Loading...

Notes​

Important Notes
  • You must connect to the host via SSH, use a network login method to connect to the host (such as a Raspberry Pi)
  • Ensure the motherboard has been flashed with USB firmware before proceeding
  • This tutorial is only applicable for motherboard ID search, not for toolboard ID search
  • Make sure the motherboard is connected to the host's USB port via TYPEC
  • To view the toolboard ID, please refer to the relevant tutorial under the corresponding product directory

Steps​

Search for USB Device ID​

  • Run the following command to list all USB serial device IDs: 
    ls /dev/serial/by-id/*

⚠️ Important: Unusable IDs​

After executing the command, please pay attention to identifying and avoid using the following two types of IDs:

ID FeatureReason ExplanationExample
usb-1a86_USB_Serial-if00-port0This is the default name for generic serial chips like CH340, cannot be used for configuration./dev/serial/by-id/usb-1a86_USB_Serial-if00-port0
Contains katapultIndicates the device is in flash mode, Klipper firmware must be flashed before use./dev/serial/by-id/usb-katapult_xxxxxxxxxxxx

Result Explanation:​

Handling Multiple IDs

If multiple IDs appear, select the corresponding ID based on your motherboard's MCU model

Fill the USB ID into the Configuration​

  • For fluidd: click {…} to find printer.cfg
Loading...
  • For mainsail: click Machine to find printer.cfg
Loading...

Note: All IDs shown in the document are examples. Each motherboard's ID is different. Modify based on the actual ID obtained.

Fill in the USB ID​

  • Find [mcu], then replace
Note
  • Please replace the content in the configuration file:
  • Do not configure canbus_uuid:
[mcu]
serial: <Replace this with the ID you just queried>
  • Reference
  • For fluidd
Loading...
  • For mainsail
Loading...
  • Click SAVE & RESTART in the top right corner. It will automatically save and restart Klipper.
Loading...