Skip to main content

Read and View Motherboard ID

Important Notice
  • This tutorial is for the method of reading and viewing the motherboard ID.

Precautions​

Important Notes
  • Must connect to the host computer via SSH. Please use network login to connect to the host computer (e.g., Raspberry Pi).
  • Before proceeding, ensure the mainboard has been flashed with the USB firmware.
  • This tutorial is only applicable for Mainboard ID lookup, not for Toolboard ID lookup.
  • Confirm the mainboard is connected to the host computer's USB port via Type-C.
  • To look up the Toolboard ID, please refer to the relevant tutorial in the corresponding product directory.

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 CharacteristicsReasonExample
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 must be flashed with Klipper firmware before use./dev/serial/by-id/usb-katapult_xxxxxxxxxxxx

Execution Result Explanation:​

Handling Multiple IDs

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

Enter 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 this document are examples. The actual ID for each mainboard is different. Please modify and enter based on the ID you actually obtained.

Enter the USB ID​

  • Locate [mcu], then replace it.
Note
  • Please replace in the configuration file:
  • 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 top right corner. After clicking, Klipper will automatically save and restart.
Loading...