Toolboard ID Reading and Viewing

CANBus UUID Retrieval

• Before searching for the ID, connect the toolboard to the UTOC or a motherboard flashed with bridging firmware using an XT30 data cable. Below is a reference wiring diagram.

• Please ensure the DIP switch is toggled to the correct position.

  

• Please ensure that the resistance between CAN H and CAN L measures approximately 60Ω when powered off. If it measures approximately 120Ω, you need to enable the 120Ω DIP switch; if around 40Ω, you need to disable the DIP switch.

  

  Complete Guide to CAN Toolboard Setup

  Preparation

  Important Prerequisites

  • Toolboard Status: Ensure the toolboard has the Klipper-can firmware flashed or is in Katapult-can mode
  • Scope of Application: This tutorial is only for toolboard ID search, not applicable for motherboard ID search
  • Connection Requirements: The toolboard must be connected to one of the following devices:
    • UTOC module
    • A motherboard flashed with USB bridge CAN firmware
  • Final Connection: The above devices must be connected to the host computer

  Hardware Connection and Termination Resistor Configuration

  Safety First

  • Complete Power Off: All wiring operations must be performed with the equipment completely powered off
  • Prevent Short Circuits: Disconnect the power supply to all devices before operating

  Connection Specification Table

  Device Type	Termination Resistor Requirement	Configuration Method
  CAN Toolboard	Requires 120Ω termination resistor	Enable via jumper cap or DIP switch
  Motherboard CAN Interface	Requires 120Ω termination resistor	Enable via jumper cap or DIP switch
  UTOC Module	Already built-in 120Ω resistor	No additional connection required

  Configuration and Measurement Steps

  1. Hardware Configuration

     • Check if the 120Ω jumper cap or DIP switch next to the motherboard's CAN interface is connected or enabled
     • Check if the 120Ω jumper cap or DIP switch on the toolboard is connected or enabled

  2. Resistance Measurement (Power-off state)

     • Measurement Point: Between CAN-H and CAN-L
     • Tool: Multimeter

  Resistance Value Troubleshooting Table

  Notes

  • Measurements must be taken with the power off
  • If the measured value reaches around 140Ω, it may indicate that CAN-H and CAN-L are reversed

  Measured Value	Status	Possible Cause	Solution
  Around 60Ω	✅ Normal	Resistors correctly connected at both ends	Configuration complete
  Around 120Ω	❌ Abnormal	Line disconnected or not connected	Check all wiring
  Around 40Ω	❌ Abnormal	Three points connected with resistors	Remove the middle resistor
  Around 90Ω	❌ Abnormal	Only one end connected with a resistor	Check the jumper cap at the other end

  Important Notes

  • UTOC Module: Already has a built-in resistor; no additional termination resistor is required on the motherboard when connected
  • Connection Scenarios:
    • Toolboard ↔ Motherboard (both ends require termination resistors)
    • Toolboard ↔ UTOC ↔ Host (only the toolboard requires a termination resistor)
  • Troubleshooting Flow:

    Measure resistance → 60Ω → Normal operation
           ↓
       Abnormal value → Refer to the table above → Adjust and re-measure

  Hardware Inspection Checklist

  • All devices completely powered off
  • Termination resistor connected at the motherboard's CAN interface (except for UTOC)
  • Termination resistor connected on the toolboard
  • Multimeter measures resistance ≈60Ω
  • CAN-H and CAN-L wiring correct and secure
  Professional Advice

  Correct termination resistor configuration is critical for CAN bus communication quality. Deviations in resistance values may cause communication instability or data loss.

  CAN Network Configuration Requirements

  • Default Configuration: This tutorial assumes the host computer has already configured the CAN network
  • Fly System Users: If using a Fly host running the Fly-FAST or Fly-Armbian system, CAN is already configured by default (speed 1Mbps)
  • First-Time Use: Please read the following tutorial first: CAN Configuration Tutorial

  Summary Process

  1. Hardware Preparation: Wire in a power-off state, configure termination resistors, measure and confirm 60Ω
  2. Network Confirmation: Ensure the host computer's CAN network is correctly configured
  3. Connect to Host: Connect to the host via UTOC or USB bridged motherboard
  4. Firmware Status: Confirm the toolboard is in Klipper-can or Katapult-can mode
  5. Next Steps: Follow the subsequent tutorial for ID search and configuration

  At this point, your CAN toolboard hardware connection and network environment are ready for ID search and configuration operations.

  Connect via SSH

  • Log in to SSH via the network (do not use serial port login)
  • Ensure the host computer is properly connected to the CAN network devices

  Search for Devices

  • Now that you have successfully logged into the host computer, you can enter lsusb to search for devices. You may encounter one of the following situations:
    • If entering lsusb prompts that the ls command is not found, you can install the required utility by entering the following command:

      sudo apt-get install usbutils

    • If there is no response after entering lsusb, this is a system issue and cannot be resolved here. You will need to change the system or use a known working system.
    • If information like that shown in the image below appears, please note that this is only a reference. You only need to confirm that 1d50:606f appears:
      
  • 1d50:606f is the device you will use in this instance.
  • If multiple 1d50:606f devices appear, one must be excluded, as multiple entries may affect subsequent flashing and firmware connection. For example, with FLY MINI PAD, it is recommended to use the onboard UTOC and avoid using other CAN bridges.
  • If the device does not appear, please check whether the data cable is properly connected and whether the correct firmware has been flashed.
  Note

  You can proceed to search for the CAN ID only when 1d50:606f appears.

  Search for CAN ID

  Fly-Armbian / General Systems

  Execute the following command to search for CAN device IDs:

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

  Fly-FAST System

  Execute the following command to search for CAN device IDs:

  python ~/klipper/scripts/canbus_query.py can0

  Search Results Explanation

  After executing the search command, several situations may occur:

  Result Display	Status Description	Next Steps
  Application: Klipper	Device has Klipper firmware flashed	Can directly use this ID
  Application: CANBOOT or Katapult	Device is in Bootloader mode	Needs to flash Klipper firmware before use
  Total 0 uuids found	No devices found	Please check the following issues: 1. Is the CAN network configuration correct? 2. Is the CAN speed consistent (default 1Mbps)? 3. Has this ID already been used in the configuration (need to disable first, then save and restart after power off)?

  
  About Duplicate IDs

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

  1. Comment out the 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. Get Configuration File

  Find the printer.cfg configuration file based on the web interface used:

  Fluidd Click the {...} icon on the left navigation bar to find printer.cfg

  Mainsail Click Machine on the top navigation bar to find printer.cfg

  2. Add Device Configuration

  Add the toolboard configuration in printer.cfg:

  [mcu toolboard]
  canbus_uuid: <Insert the ID obtained from the query here>

  Configuration Notes

  • toolboard is the name of the toolboard; modify it according to actual conditions
  • If it's a motherboard ID, the configuration section should be [mcu]
  • In normal configuration, the motherboard uses [mcu], and the toolboard uses [mcu toolboard]

  3. Save and Restart

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

  All IDs appearing in this document are examples. Each motherboard's ID is unique. Please modify and fill in according to the actual ID obtained.

RS232 ID Retrieval

• Before searching for the ID, connect the toolboard to the UTOR or G2T using an XT30 data cable. Below is a reference wiring diagram.
• Please ensure the DIP switch is toggled to the correct position.
  

  RS232 ID of the Toolboard

  Notes

  Important Preparation

  1. Firmware Requirement:
     The toolboard must be flashed with RS232 firmware, otherwise communication is not possible.
  2. Common Ground Required:
     ⚠️ Before connecting the toolboard, ensure that the toolboard and mainboard share the same GND (this can be achieved by using the same 24V/12V power supply)

  RS232 Notes

  • In addition to D8, D8PRO, and C8P, which support the RS232 interface, all other mainboards do not support RS232
  • For unsupported mainboards, use G2T or UTOR to connect. This tutorial uses UTOR for connection

  Search for RS232 ID

  1. Open your browser and enter the IP address of the host computer in the address bar. For example, if the IP address of my host computer is 192.168.101.179, simply enter it and press Enter.
  
  2. Open the host computer's web interface and locate the following in the configuration options on the left sidebar:

  For fluidd: {…}, click into it to find printer.cfg

  For mainsail: Machine, click into it to find printer.cfg

  3. After entering printer.cfg, click DEVICES in the upper right corner

  4. Click SERIAL and then refresh

     Refresh for fluidd

     Refresh for mainsail

  5. Copy the ID. Click as indicated by the arrow to copy

     Check for ttyUSB in fluidd and ensure that Path_by_hardware exists; this is the RS232_ID

     Check for ttyUSB in mainsail and ensure that Path_by_hardware exists; this is the RS232_ID

     Note

     • When connecting the toolboard using UTOR, there are usually two RS232_IDs. Try them one by one.

  Enter the Toolboard RS232 ID

  • Below is a reference configuration

    Note

    • toolboard in the configuration below refers to the name of the toolboard. If the name is different, replace it accordingly
    dangerous

    [mcu toolboard]
    serial: <Replace this with the ID you just looked up>
    baud: 250000
    restart_method: command

    • To add the ID for the toolboard, it must be [mcu toolboard] followed by serial: and then the ID you searched for
    • Below is a reference configuration
    • Please note that this tutorial is for searching and configuring the toolboard ID. Under normal circumstances, it should already be connected to the mainboard
    • The mainboard must be [mcu], and the toolboard is [mcu toolboard]
    • Click SAVE & RESTART in the upper right corner to automatically save and restart klipper
  dangerous

  Note: All IDs appearing in the document are examples. Each mainboard's ID is different. Please enter the actual ID you obtained.

  dangerous

  The ID below is not usable !!!!!!

  serial: /dev/serial/by-id/usb-1a86_USB_Serial-if00-port0

  ---