Wired Connection Klipper Configuration

Important Notes

• The STM32F072 must be flashed with firmware and connected to Klipper; otherwise, wired connection operations are not supported.

Start Compilation

Below is how to compile the firmware:

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

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

• Among these, rm -rf ~/klipper/.config && rm -rf ~/klipper/out deletes 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 select STMicroelectronics STM32, then 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, and Save configuration will appear. Then 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 some time:

  make -j4

  Loading...
• Finally, if the output shows the following content, 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

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

Flash the Firmware

1. Install the Flashing Tool

   • FLY host machine does not need to install the flashing tool.
   • If you need to install it, please note: the host machine must be able to connect to the internet for proper installation.
   • If already installed, no need to reinstall.

   sudo apt update
   sudo apt install dfu-util -y

2. Execute the following command 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 other names. If 0483:df11 appears, it indicates successful 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. If the content shown by the arrow in the image below, File downloaded successfully, appears, the flashing is successful.

   Loading...
   tip

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

Search for USB ID

• Connect the AirClick's programming port to the host computer's USB port. Do not press the BOOT button, otherwise the ID cannot be searched.
  Loading...

Precautions

Important Notes

• You must connect to the host computer via SSH. Please use network login to connect to the host computer (such as Raspberry Pi and other devices).
• Before operation, please ensure the motherboard has been flashed with the USB firmware.
• This tutorial is only applicable for searching Motherboard ID, not for Toolboard ID search.
• Please confirm the motherboard is connected to the host computer's USB port using a Type-C cable.
• If you need to view the Toolboard ID, please refer to the relevant tutorial in the corresponding product directory.

Operation Steps

Search for USB Device ID

• Execute the following command to list all USB serial device IDs:

  ls /dev/serial/by-id/*

⚠️ Important Note: Unusable IDs

After executing the command, please identify and avoid using the following two types of IDs:

ID Characteristics	Reason Explanation	Example
usb-1a86_USB_Serial-if00-port0	This is the default name for generic serial chips like CH340 and cannot be used for configuration.	/dev/serial/by-id/usb-1a86_USB_Serial-if00-port0
Contains katapult	Indicates the device is in bootloader mode. It needs to be flashed with Klipper firmware before it can be used.	/dev/serial/by-id/usb-katapult_xxxxxxxxxxxx

Execution Result Explanation:

• Normal Situation: The terminal will display an ID similar to the example below (the image below is for illustration only).
  Loading...
• Troubleshooting Abnormal Issues

Handling Multiple IDs

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

Fill the USB ID into the Configuration

For fluidd: {…}. Click into it to find printer.cfg. Loading...

For mainsail: Machine. Click into it to find printer.cfg. Loading...

Note: All IDs appearing in the documentation are examples. The actual ID for each motherboard is different. Please modify and fill in based on the ID you actually obtained.

Fill in the USB ID

• Find [mcu], then replace it.

Note

• Please replace in the configuration file:
• Please do not configure canbus_uuid:

[mcu]
serial: <Replace here with the ID you just queried>

• Reference

Reference for fluidd Loading...

Reference for mainsail Loading...

• Click the SAVE & RESTART button in the upper right corner. After clicking, it will automatically save and restart Klipper.