Skip to main content

Motherboard ID Reading and Viewing

Important Notes
  • This tutorial is for reading and viewing the ID of the motherboard. For tool boards, please refer to the corresponding product's ID search tutorial.

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 CharacteristicsReason ExplanationExample
usb-1a86_USB_Serial-if00-port0This 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 katapultIndicates 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.
Loading...