串口驱动安装

市面开发板使用不同的 USB 转串口芯片（常见：CH34 系列、CP2102、FT232 等）。若电脑无法识别开发板，请按下列步骤安装或排查串口驱动。

常见驱动下载

• CH34（WCH 沁恒）：https://www.wch.cn/ (opens new window)
• CP2102（Silicon Labs）：https://www.silabs.com/ (opens new window)
• FT232（FTDI Chip）：https://ftdichip.com (opens new window)

安装与验证（按操作系统）

macOS

1. 下载对应驱动并运行安装包（或按厂商说明安装）。
2. 如出现“系统扩展被阻止”，前往“系统偏好设置 > 安全性与隐私”，点击“允许”。
3. 安装后重启电脑（如厂商要求）。
4. 插入设备后，终端查看设备列表：
   • ls /dev/tty.*
   • ls /dev/cu.*

常见名称：

• /dev/cu.SLAB_USBtoUART（CP210x）
• /dev/cu.wchusbserial*（CH34）
• /dev/cu.usbserial-*（FTDI）

Windows

1. 下载对应驱动并以管理员身份运行安装程序。
2. 安装完成后在“设备管理器 > 端口 (COM & LPT)”查看是否出现相应 COM 端口（如 COM3）。
3. 若显示黄色感叹号，尝试更新驱动并重启。

Linux

1. 现代内核通常自带 FTDI/CP210x 驱动；CH34 部分发行版也支持。
2. 插入设备后查看：
   • dmesg | tail
   • ls /dev/ttyUSB* 或 ls /dev/ttyACM*
3. 若未识别，按发行版说明安装相应驱动或内核模块。

常见问题与排查

• 使用“仅充电”数据线会导致无法识别，换用支持数据的 USB 线。
• 尝试不同 USB 接口或 USB 集线器。
• 若仍未识别，检查是否需要厂商签名或内核扩展授权（macOS）或 udev 规则（Linux）。
• 驱动安装后仍异常，尝试重启电脑或重新插拔设备。
• 在 IDE（Arduino/PlatformIO/ESP-IDF）中选择正确的端口和波特率。

说明与注意

• 请仅从厂商或官方网站下载驱动，注意选择与操作系统版本匹配的安装包。
• 部分新系统已内置驱动，无需额外安装。
• 安装驱动可能需要管理员权限。
• 若问题持续，建议查阅厂商支持文档或社区论坛获取帮助。