Skip to main content

RS232 Firmware Connection Guide

Firmware Preparation​

  • Before entering RS232 mode, first use a Type-C cable to flash the toolboard with the pre-compiled RS232 firmware for the toolboard.

Wiring Steps​

Setting the DIP Switches​

  1. Safety Power Off: Ensure the toolboard is completely disconnected from the power supply before operation.
  2. Locate DIP Switches: Turn the toolboard over. Find the DIP switch group on the back.
  3. Switch Mode: Set all DIP switches to the RS232 mode specified position (see diagram below).
Loading...

Warning

  • If the DIP switch state is changed, the RS232 firmware must be re-flashed. Otherwise, communication will not be possible.
  • If the correct firmware has been previously flashed and the DIP switches have not been changed, re-flashing is unnecessary.

Connecting Cables​

  1. Keep Power Off: The device must not be powered on during the entire wiring process.
  2. Prepare Cable: Prepare a XT30(2+2)-F four-core cable. The pin definitions are as follows:
Wire ColorSignalConnection Target
RedVCC (Power Positive)12V–24V Power Supply Positive
BlackGND (Power Negative)Power Supply Negative
YellowIN (Signal Input)OUT pin of UTOR Module RS232 Expansion Port
White/GreenOUT (Signal Output)IN pin of UTOR Module RS232 Expansion Port
  1. Complete Connection:
    • Insert the male connector of the cable into the corresponding interface on the toolboard.
    • Insert the female connector of the cable into the corresponding interface on the UTOR module.
    • Connect the UTOR module to the host computer (e.g., FLY Pi, Raspberry Pi, or PC) using a USB cable.

Check Common Ground​

  • Use a multimeter in continuity/resistance mode to measure the following two points:
    • GND on the toolboard
    • GND on the host computer
  • Ensure continuity between the two grounds (resistance close to 0Ω). If there is no continuity, communication cannot be established. Check that the wiring is complete and secure.

Searching for and Configuring the Toolboard RS232 ID​

🔴 Important Preparation​

Warning
  1. Firmware Requirement: The toolboard must be flashed with RS232 firmware. Otherwise, communication is not possible.
  2. Enforce Common Ground: ⚠️ Ensure the GND of the toolboard is connected to the GND of the mainboard (using the same 24V/12V power supply is sufficient).

📌 Hardware Notes​

  • Only D8, D8PRO, C8P mainboards support the native RS232 interface.
  • Other mainboards need to be connected via UTOR or G2T modules (this tutorial uses UTOR as an example).

🔍 Steps to Search for RS232 ID​

Step 1: Access the Host Computer​

  1. Open a browser. Enter the host computer's IP address (e.g., 192.168.101.179)
    Loading...

Step 2: Open Configuration File​

  1. Go to the left menu. Find and click on printer.cfg:

    Fluidd
    Click the {…} icon

    Loading...

    Mainsail
    Click the "Machine" menu

    Loading...

Step 3: View Device List​

  1. Click the DEVICES button in the top right corner:
    Loading...
    Loading...

Step 4: Refresh Serial Devices​

  1. Click SERIAL and refresh the list:
    Fluidd
    Loading...
    		Mainsail
    Loading...

Step 5: Copy RS232 ID​

  1. Find the device containing ttyUSB. Copy its Path_by_hardware value:

    Fluidd
    Verify the presence of ttyUSB and Path_by_hardware

    Loading...

    Mainsail
    Verify the presence of ttyUSB and Path_by_hardware

    Loading...
Note for UTOR Users
  • When using a UTOR connection, two candidate IDs usually appear. Try each one to determine the correct ID.
  • Click the arrow icon next to the ID to copy it.

⚙️ Configuring RS232 ID into Firmware​

Configuration Notes
  • In the configuration below, toolboard refers to the toolboard name. Replace it according to your actual situation.
  • The toolboard configuration should be [mcu toolboard]. The mainboard configuration is [mcu]. Do not confuse them.

Reference Configuration:​

Configuration Template
[mcu toolboard]
serial: <Replace this with the actual ID you queried>
baud: 250000
restart_method: command

Configuration Steps:​

  1. Paste the copied ID after the serial: parameter.
  2. Click the SAVE & RESTART button in the top right corner to save and restart Klipper.
Important Warning
  • All IDs in the documentation are examples. Strictly do not copy and use them directly.
  • Ensure you fill in the hardware ID you actually obtained.
  • The following ID is an invalid example and must not be used: 
    serial: /dev/serial/by-id/usb-1a86_USB_Serial-if00-port0

Important Note: Regarding RS232 ID​

Core Point​

The RS232 ID you searched for is the ID of the UTOR module itself, not the ID of the toolboard.

Key Understanding​

  • This ID represents the connection interface between the UTOR module and the host computer.
  • The host computer uses this ID to tell the UTOR: "Please use this interface of yours to connect to the toolboard."
  • Regardless of whether the toolboard is connected, as long as the UTOR module is connected to the host computer, this ID will exist.

Simple Explanation​

Host Computer → [UTOR Module(ID)] → Toolboard

You are configuring the address of the box in the middle (UTOR), not the address of the toolboard.

Practical Tips​

  • Having UTOR allows you to find the ID, but only with the toolboard working properly can communication occur.
  • The ID usually changes because the UTOR has been plugged into a different USB port or the system has been restarted.
  • Ensure the toolboard is correctly connected and powered when configuring.
Loading...