Important Notes

Precautions

• This tutorial specifically covers the wiring and ID search for the Tool Board. The related steps are not applicable to the Main Board. Please distinguish between them.
• If you are not using a Tool Board, please ignore this tutorial.

Tool Board ID Reading and Viewing

• USB ID Acquisition
• CANBus UUID Acquisition
• RS232 Usage Method

• Please prepare a data cable with data transfer capability. If the cable is particularly long, it is recommended to use a data cable with a ferrite bead.
• Connect the Tool Board to the host computer via the USB data cable.

Precautions

Important Notes

• 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, ensure the mainboard has been flashed with the USB firmware.
• This tutorial is only applicable for Mainboard ID search, not for Toolboard ID search.
• Please confirm the mainboard is connected to the host computer's USB port via TYPEC.
• 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, 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 use.	/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 is for illustration only).
  Loading...
• Troubleshooting for Abnormal Issues

Handling Multiple IDs

If multiple IDs appear, please select the corresponding ID based on your mainboard'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 mainboard is different. Please modify and fill in according to the ID you actually obtained.

Fill in the USB ID

• Find [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 upper right corner. After clicking, it will automatically save and restart Klipper.

• Before searching for the ID, connect the Tool Board to a UTOC or a Main Board flashed with bridge firmware using an XT30 data cable. The reference wiring diagram is below.

• Please check if the DIP switch is set to the correct position.

  Loading...

• Please ensure that the resistance between CAN H and CAN L, measured with a multimeter while powered off, is around 60Ω. If it is 120Ω, a 120Ω jumper needs to be connected. If it is around 40Ω, the jumper needs to be removed.

  Loading...

  Complete Guide to CAN Tool Board Setup

  Preparations

  Important Prerequisites

  • Tool Board Status: Ensure the tool board is flashed with Klipper-can firmware or is in Katapult-can mode.
  • Important Note: This tutorial is only for searching Tool Board IDs, not for Main Board IDs.
  • Connection Requirements: The tool board must be connected to one of the following devices:
    • UTOC module
    • A main board flashed with USB Bridge CAN firmware.
  • Final Connection: The above device must be connected to the host machine.

  CAN Network Configuration Requirements

  • Default Configuration: This tutorial assumes the CAN network is already configured on the host machine.
  • Fly Users: If using a Fly host machine running the Fly-FAST system, CAN is configured by default (rate 1Mbps).
  • First-time Users: Please read the tutorial below first: CAN Configuration Tutorial

  Connect via SSH

  • Log in to SSH over the network (Do not use serial port login).
  • Ensure the host machine is properly connected to the CAN network device.

  Search for CAN ID

  • Search command for a standard host machine:

    ~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0

  • Search command for a FLY host machine:

    python3 ~/klipper/scripts/canbus_query.py can0

  Search Result Explanation

  CANID

  • Important Note: The main board ID has already been configured in Klipper in previous documentation. Under normal circumstances, the main board's CANID cannot be found via search.
  • Quick Verification Method: If confirmation is needed, first disconnect the CAN cable between the main board and the tool board, then re-execute the search.
  • After executing the search command, the following situations may occur:

  Result Display	Status Description	Next Steps
  Application: Klipper	Device is flashed with Klipper firmware	This ID can be used directly.
  Application: CANBOOT or Katapult	Device is in Bootloader mode	Needs to be flashed with Klipper firmware before use.
  Total 0 uuids found	No devices found	Please check the following: 1. Is the CAN network configured correctly? 2. Is the CAN rate consistent? (Default 1Mbps) 3. Has this ID already been used in the configuration? (Need to comment it out, save, power off, and restart.)

  Loading...
  About Duplicate IDs

  If a device ID is already configured in printer.cfg, it will not appear in the search results. To search for it again, please:

  1. Comment out that device ID in the configuration file.
  2. Save the configuration and restart Klipper.
  3. Power off and restart all devices.

  Configure CAN Device ID

  1. Obtain the Configuration File

  Find the printer.cfg configuration file based on the web interface you are using:

  Fluidd Click the {...} icon in the left navigation bar, find printer.cfg. Loading...

  Mainsail Click Machine in the top navigation bar, find printer.cfg. Loading...

  2. Add Device Configuration

  Add the tool board configuration in printer.cfg:

  [mcu toolboard]
  canbus_uuid: <Enter the queried ID here>

  Configuration Note

  • toolboard is the name of the tool board. Please modify it according to your actual situation.
  • For a main board ID, the configuration section should be [mcu].
  • In a normal configuration, the main board uses [mcu], and the tool board uses [mcu toolboard].

  3. Save and Restart

  1. Click the SAVE & RESTART button in the top right corner.
  2. The system will automatically save the configuration and restart Klipper.
  Loading...
  Note

  All IDs appearing in this document are examples. The actual ID for each main board is different. Please modify and fill in based on the ID you actually obtain.

• Before searching for the ID, connect the Tool Board to a UTOR or G2T using an XT30 data cable. The reference wiring diagram is below.
• Please check if the DIP switch is set to the correct position.

Loading...

Searching for the RS232 ID of the Toolboard

Important Notes

Important Preparations

1. Firmware Requirement:
   The toolboard must be flashed with the RS232 firmware, otherwise communication will not be possible.
2. Mandatory Common Ground:
   ⚠️ Before connecting the toolboard, you must ensure its GND is connected to the mainboard's GND (sharing the same 24V/12V power supply will achieve this).

RS232 Notes

• Besides the D8, D8PRO, and C8P, which support the RS232 interface, other mainboards do not support the RS232 interface.
• For unsupported mainboards, you need to use a G2T or UTOR for connection.

Searching for the RS232 ID

1. Open a browser, enter the host's IP address in the address bar (for example, if the host IP is 192.168.101.179, enter it directly and press Enter).

Loading...

2. Open the host's WEB interface, and find the following in the configuration options on the left sidebar:

For fluidd: {…}, click to enter, then find printer.cfg. Loading...

For mainsail: Machine, click to enter, then find printer.cfg. Loading...

3. Click into printer.cfg, then click DEVICES in the upper right corner.

Loading...

Loading...

4. Click SERIAL, then refresh.

Refreshing in fluidd. Loading...

Refreshing in mainsail. Loading...

5. Copy the ID. Click where the arrow points to copy.

In fluidd, check if ch341-uart exists, then click Path_by_hardware. This is the RS232_ID. Loading...

In mainsail, check if CH341-UART exists, then click Path_by_hardware. This is the RS232_ID. Loading...

Notes

• When using UTOR to connect the toolboard, two RS232_IDs often appear. Please try them one by one.

Filling in the Toolboard RS232 ID

• Below is a reference configuration.

  Notes

  • In the configuration below, toolboard refers to the toolboard name. If it has a different name, replace it accordingly.
  dangerous

  [mcu toolboard]
  serial: <Replace here with the ID you just queried>
  baud: 250000
  restart_method: command

  • Adding the toolboard ID must be [mcu toolboard] followed by serial: and then the toolboard ID you searched for.
  • Below is a reference configuration.
  • Please note this tutorial is for toolboard ID search and configuration. Normally, it is already properly connected to the mainboard.
  • The mainboard must be [mcu], and the toolboard is [mcu toolboard].
  • Click SAVE & RESTART in the upper right corner. Clicking will automatically save and restart Klipper.

dangerous

Note: All IDs appearing in the document are examples. The actual ID for each mainboard is different. Please fill in the ID you actually obtained.