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 a flashing tool for FLY host machines.
    • If installation is needed, note: The host machine must have internet access for a successful installation.
    • Skip this step if it has already been installed.
    sudo apt update
    sudo apt install dfu-util -y

  2. Execute the command below to check if the connection is successful.

    lsusb

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

    • Due to system version differences, it may display a different name. If 0483:df11 appears, it indicates entry into flashing mode.

      Loading...

  3. Flash the Firmware

    • Execute the code below to start flashing.
    sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/klipper/out/klipper.bin

  4. The flashing is successful when the following message appears: File downloaded successfully

    Loading...
    Tip

    After flashing, power off the motherboard completely 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...