klipper 自动配置 mcu 的串口id

在 Klipper 中自动配置 MCU 的串口 ID（如 `/dev/serial/by-id/...`）可以避免因 USB 端口变动导致通信失败。以下是详细方法：

---

**1. 查找 MCU 的串口 ID**
运行以下命令列出所有 USB 串口设备及其唯一 ID：
```bash
ls /dev/serial/by-id/*
```
输出示例：
```
/dev/serial/by-id/usb-Klipper_stm32f103xe_123456789-if00
```
这个 ID 是固定的，即使 USB 端口插拔或重启也不会改变（除非 MCU 固件重新烧录）。

---

**2. 修改 Klipper 配置文件**
在 `printer.cfg` 的 `[mcu]` 部分，使用 `serial:` 指定串口 ID（而不是 `/dev/ttyACM0` 或 `/dev/ttyUSB0`）：
```ini
[mcu]
serial: /dev/serial/by-id/usb-Klipper_stm32f103xe_123456789-if00
```
优点：
• 避免因 USB 端口顺序变化（如 `ttyACM0` → `ttyACM1`）导致通信失败。

• 多 MCU 时能稳定区分设备。

---

**3. 自动检测 MCU 串口（可选脚本）**
如果希望 Klipper 启动时自动检测 MCU，可以使用脚本辅助（适用于多设备或频繁插拔的情况）：

==**方法 1：使用 udev 规则（推荐）**==
创建 udev 规则，为 MCU 分配固定别名（如 `/dev/klipper_mcu`）：
```bash
sudo vim /etc/udev/rules.d/99-klipper.rules
```
添加以下内容（替换 `your_mcu_id` 为实际的 ID）：
```udev
SUBSYSTEM=="tty", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="5740", SYMLINK+="klipper_mcu"
```
• `idVendor` 和 `idProduct` 可通过 `lsusb` 查看。
```
~$ lsusb
Bus 008 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 004 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 007 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 003 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 006 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 002 Device 005: ID 1d50:614e OpenMoko, Inc. stm32h723xx
Bus 002 Device 004: ID 26ae:8506 WKS.cn USB2IIC_CTP_CONTROL
Bus 002 Device 003: ID 2993:0858 icSpring icspring camera
Bus 002 Device 002: ID 1a40:0101 Terminus Technology Inc. Hub
Bus 002 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 005 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
```

```
~$ cat /etc/udev/rules.d/99-klipper.rules
SUBSYSTEM=="tty", ATTRS{idVendor}=="1d50", ATTRS{idProduct}=="614e", SYMLINK+="klipper_mcu"
```

• 重新加载 udev 规则：

```bash
  sudo udevadm control --reload
  sudo udevadm trigger
  ```

查看设备信息
```
:~$ ls -l  /dev/klipper_mcu
lrwxrwxrwx 1 root root 7 May 12 13:55 /dev/klipper_mcu -> ttyACM0
```

• 然后在 `printer.cfg` 中使用别名：

```ini
  [mcu]
  serial: /dev/klipper_mcu
  ```

**方法 2：使用脚本自动查找**
创建一个脚本（如 `find_mcu.sh`）：
```bash
#!/bin/bash
MCU_ID=$(ls /dev/serial/by-id/* 2>/dev/null | grep "Klipper" | head -n 1)
if [ -n "$MCU_ID" ]; then
    echo "Found MCU: $MCU_ID"
    echo "serial: $MCU_ID" > /tmp/mcu_serial
else
    echo "MCU not found!"
    exit 1
fi
```
• 在 `printer.cfg` 中动态引用：

```ini
  [mcu]
  serial: {mcu_serial}  # 需配合脚本或宏动态更新
  ```

---

**4. 多 MCU 配置**
如果有多个 MCU（如主板 + 工具板），为每个设备分配独立 ID：
```ini
[mcu]
serial: /dev/serial/by-id/usb-Klipper_mainboard_123-if00

[mcu toolhead]
serial: /dev/serial/by-id/usb-Klipper_toolboard_456-if00
```

---

**5. 验证配置**
1. 重启 Klipper：
   ```bash
   sudo service klipper restart
   ```
2. 检查日志是否成功连接：
   ```bash
   journalctl -u klipper -f
   ```
3. 确认 MCU 通信正常：
   ```bash
   ls /tmp/printer  # 查看是否生成通信文件
   ```

---

**常见问题**
**Q1: 找不到 `/dev/serial/by-id/...`**
• 检查 MCU 是否通电并正确连接。

• 确认已安装 USB 驱动（如 CH340、CP210x 等）：

```bash
  lsusb
  dmesg | grep tty
  ```

**Q2: 烧录固件后 ID 变化**
• 重新烧录 Klipper 固件会重置 USB ID，需重新执行 `ls /dev/serial/by-id/` 并更新 `printer.cfg`。

**Q3: 权限问题**
• 确保用户（如 `pi`）有串口访问权限：

```bash
  sudo usermod -a -G dialout pi
  ```

---

**总结**
1. 优先使用 `/dev/serial/by-id/...` 替代 `/dev/ttyXXX`。
2. 多 MCU 时明确分配 ID，避免冲突。
3. 动态检测可用脚本或 udev 规则（适用于复杂场景）。

这样可以确保 Klipper 稳定识别 MCU，避免因 USB 端口变动导致的通信失败。