Important Notice

Notes

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

Toolboard ID Readout and View

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

Precautions

Important Prerequisites

Before starting to search for the toolboard ID, ensure all of the following conditions are met:

• Firmware Preparation: The toolboard has been flashed with the USB firmware or is currently in USB bootloader mode.
• Clear Objective: This tutorial is only for searching the toolboard ID, not applicable to the mainboard ID.
• Hardware Connection: The toolboard is correctly connected to the host computer's USB-A port via USB.
• Login Method: Please log in to the host computer via SSH over the network to perform operations, do not use serial port login.

Searching for USB ID

ls /dev/serial/by-id/*

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

• If no ID appears after entering the command, but lsusb shows the device, please try a different host computer or a different host computer operating system.

Note

If multiple IDs appear, please select the ID corresponding to 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...

Danger

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

Filling in the Toolboard USB ID

• The configuration below is for reference.

  Note

  • toolboard in the configuration below refers to the toolboard name. If it has a different name, please replace it with the corresponding name.
  Danger

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

  • Adding the toolboard ID must be [mcu toolboard] followed by serial: and then the toolboard ID you searched for.
  • The configuration below is for reference.
  • Please note this tutorial is for toolboard ID search and configuration. Under normal circumstances, it should already be correctly connected to the mainboard.
  • The mainboard must be [mcu], and the toolboard is [mcu toolboard].

  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.

• CAN Reference Wiring
• Termination Resistor Configuration Check:

  Device	Configuration Method	Target State
  Mainboard	Locate the jumper block or DIP switch labeled 120Ω	Place the jumper cap or switch to ON
  Toolboard	Locate the jumper block or DIP switch labeled 120Ω	Place the jumper cap or switch to ON

Purpose: This resistor is crucial for ensuring stable CAN bus signals and preventing communication errors.

Loading...

Complete Guide to CAN Toolboard Setup

Preparations

Important Prerequisites

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

CAN Network Configuration Requirements

• Default Configuration: This tutorial assumes the host computer's CAN network is already configured.
• Fly Users: If using a Fly host computer 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 computer is properly connected to the CAN network device.

Search for CAN ID

• Search command for standard host computers:

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

• Search command for FLY host computers:

  python3 ~/klipper/scripts/canbus_query.py can0

Search Result Explanation

CANID

• Important Note: The mainboard ID has already been configured in Klipper in previous documentation. Under normal circumstances, the mainboard's CANID cannot be found via search.
• Quick Verification Method: If confirmation is needed, first disconnect the CAN cable between the mainboard and the toolboard, then re-run 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. Is this ID already 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. Locate 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, then find printer.cfg. Loading...

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

2. Add Device Configuration

Add the toolboard configuration to printer.cfg:

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

Configuration Notes

• toolboard is the toolboard name; please modify it according to your actual situation.
• For a mainboard ID, the configuration section should be [mcu].
• In a normal configuration, the mainboard uses [mcu], and toolboards use [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 mainboard is different. Please modify and fill in the ID based on what you actually obtain.

• RS232 Reference Wiring

Loading...

Interface Configuration Instructions

Precautions

Important Preparations

1. Firmware Requirement:
   The tool board must be flashed with RS232 firmware, otherwise communication will not be possible.
2. Mandatory Common Ground:
   ⚠️ Before connecting the tool board, ensure it shares the same power source as the C8P or connect the GND of the tool board to the main board's GND (using the same 24V/12V power supply will achieve this).
3. Interface Characteristics:
   • The dual RS232 interfaces support independent or simultaneous use of both.
   • The Klipper serial: parameter is hardware-fixed and cannot be modified.

Wiring Specifications

Wiring method for the left interface (SERIAL3) Loading...

Wiring method for the right interface (SERIAL4) Loading...

• Left Interface (SERIAL3)
• Right Interface (UART4)

Configuration Steps

1. Edit printer.cfg

   [mcu Laser]
   serial: /dev/serial3  # Fixed device node for the left interface
   baud: 250000
   restart_method: command

2. Key Settings Explanation
   • Laser in [mcu Laser] can be customized.
   • /dev/serial3 is the dedicated node for the left interface and cannot be changed.

Configuration Steps

1. Edit printer.cfg

   [mcu ToolBoard]
   serial: /dev/serial4  # Fixed device node for the right interface
   baud: 250000
   restart_method: command

2. Key Settings Explanation
   • ToolBoard in [mcu ToolBoard] can be customized.
   • /dev/serial4 is the dedicated node for the right interface and cannot be changed.

Configuration ID

1. Open a browser, enter the IP address of the host computer in the address bar. For example, if the host IP is 192.168.101.179, enter it and press Enter.

Loading...

2. Open the host's WEB interface. In the left sidebar configuration options, find:

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

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

3. Fill in the corresponding ID.

Loading...

Loading...

2. Apply Configuration

   • After pasting the configuration code into the corresponding area,
   • Click the SAVE & RESTART button in the top right corner.

3. If Klipper reports ADC out of range, this is normal. Connect the heated bed and thermistor to the main board, configure the thermistor pins for the hotend and heated bed, then save and restart.