保姆级教程：在Ubuntu22.04上为ROS2 Humble搞定CH340串口驱动与权限问题
从零攻克Ubuntu22.04下ROS2 Humble的CH340串口通信全流程
刚接触ROS2的开发者，十有八九会在串口通信这个环节卡壳——尤其是使用CH340这类廉价USB转串口模块时。你可能已经经历过：插上设备后系统毫无反应、代码明明正确却提示权限不足、或是突然冒出的brltty服务冲突。这些问题看似简单，却足以让新手浪费数小时在搜索引擎和论坛之间来回切换。本文将彻底解决Ubuntu22.04+ROS2 Humble环境下CH340模块的三大核心痛点：驱动安装、权限配置和服务冲突，让你一次性打通硬件连接的"任督二脉"。
1. CH340驱动安装：绕过新系统的签名陷阱
Ubuntu22.04对内核模块签名验证更加严格，直接安装老教程里的CH340驱动往往会遇到Key was rejected by service错误。我们先解决这个"拦路虎"：
1.1 驱动安装的正确姿势
首先确认系统是否已识别设备但缺少驱动：
lsusb | grep CH340若看到1a86:7523 QinHeng Electronics CH340 serial converter之类的信息，继续执行：
# 安装编译依赖 sudo apt update && sudo apt install -y dkms build-essential linux-headers-$(uname -r) # 获取官方驱动（注意分支选择） git clone https://github.com/juliagoda/CH341SER.git cd CH341SER make此时可能会遇到签名错误，需要临时关闭Secure Boot：
- 重启进入BIOS，找到Secure Boot选项禁用
- 或使用MOK工具手动签名（适合需要保持Secure Boot的场景）：
sudo mokutil --import /path/to/module_signature.der1.2 验证驱动加载
加载编译好的驱动模块：
sudo insmod ch34x.ko dmesg | grep ch34x成功时应看到ch34x ttyUSB0: ch34x converter now disconnected from ttyUSB0之类的日志。建议将驱动加入开机加载：
echo "ch34x" | sudo tee -a /etc/modules sudo depmod -a提示：部分国产CH340变种芯片可能需要特殊驱动，建议用
lsusb -v确认具体型号后联系供应商获取驱动。
2. 串口权限配置：一劳永逸的解决方案
解决了驱动问题，接下来就是经典的Permission denied错误。临时方案是用sudo chmod 777 /dev/ttyUSB0，但每次重启都要重复操作。下面介绍三种永久解决方案：
2.1 udev规则法（推荐）
创建规则文件：
sudo nano /etc/udev/rules.d/99-ch34x.rules加入以下内容（替换<username>为你的用户名）：
KERNEL=="ttyUSB*", ATTRS{idVendor}=="1a86", ATTRS{idProduct}=="7523", MODE="0666", GROUP="dialout", OWNER="<username>"生效规则：
sudo udevadm control --reload-rules sudo udevadm trigger2.2 用户组方案
将当前用户加入dialout组：
sudo usermod -aG dialout $USER需要重新登录生效，可通过groups命令验证。
2.3 访问控制列表(ACL)
对特定设备设置持久化权限：
sudo setfacl -m u:$USER:rw- /dev/ttyUSB0 sudo setfacl -m g:dialout:rw- /dev/ttyUSB0三种方案对比：
| 方案 | 持久性 | 需要重启 | 适用范围 | 安全等级 |
|---|---|---|---|---|
| udev规则 | ✔️ | ✖️ | 特定设备 | 高 |
| 用户组 | ✔️ | ✔️ | 所有串口设备 | 中 |
| ACL | ✔️ | ✖️ | 当前设备 | 低 |
3. 消灭brltty服务：隐藏的串口杀手
Ubuntu预装的盲文支持服务brltty会霸占串口设备，导致出现Device or resource busy错误。彻底解决需要以下步骤：
3.1 立即停止服务
sudo systemctl stop brltty-udev.service sudo systemctl disable brltty-udev.service sudo systemctl mask brltty-udev.service3.2 防止自动复活
删除相关配置文件：
sudo rm /lib/udev/rules.d/*brltty*.rules sudo udevadm control --reload3.3 验证效果
插拔USB设备后检查：
ls -l /dev/ttyUSB*应该不再有brltty相关的进程占用。
4. ROS2串口通信实战检验
环境配置完成后，用一个最小示例验证整套流程：
4.1 创建测试包
ros2 pkg create --build-type ament_cmake serial_test cd serial_test/src4.2 编写测试节点
创建serial_test.cpp文件：
#include "rclcpp/rclcpp.hpp" #include "serial/serial.h" class SerialTest : public rclcpp::Node { public: SerialTest() : Node("serial_test") { try { ser.setPort("/dev/ttyUSB0"); ser.setBaudrate(9600); serial::Timeout timeout = serial::Timeout::simpleTimeout(1000); ser.setTimeout(timeout); ser.open(); RCLCPP_INFO(this->get_logger(), "Serial port opened successfully"); timer_ = create_wall_timer( std::chrono::seconds(1), [this]() { ser.write("Hello CH340\n"); RCLCPP_INFO(this->get_logger(), "Data sent"); }); } catch (const std::exception& e) { RCLCPP_ERROR(this->get_logger(), "Failed to open serial port: %s", e.what()); } } private: serial::Serial ser; rclcpp::TimerBase::SharedPtr timer_; }; int main(int argc, char** argv) { rclcpp::init(argc, argv); rclcpp::spin(std::make_shared<SerialTest>()); rclcpp::shutdown(); return 0; }4.3 修改CMakeLists.txt
在CMakeLists.txt中添加：
find_package(serial REQUIRED) find_package(rclcpp REQUIRED) add_executable(serial_test src/serial_test.cpp) ament_target_dependencies(serial_test rclcpp serial) install(TARGETS serial_test DESTINATION lib/${PROJECT_NAME})4.4 编译运行
colcon build --packages-select serial_test source install/setup.bash ros2 run serial_test serial_test正常运行时应该每秒输出一次Data sent日志，同时可以用cutecom等工具接收串口数据验证。
5. 进阶排查与性能优化
当基础功能调通后，还需要注意以下进阶问题：
5.1 多设备稳定识别
当连接多个CH340设备时，建议使用by-id规则避免端口号漂移：
ls -l /dev/serial/by-id/在代码中使用/dev/serial/by-id/usb-1a86_USB_Serial-if00-port0这样的固定路径。
5.2 波特率自适应
部分CH340模块需要特殊波特率设置：
// 尝试不同波特率 const std::vector<int> baudrates = {9600, 115200, 57600, 38400}; for (int baud : baudrates) { try { ser.setBaudrate(baud); break; } catch (...) { continue; } }5.3 看门狗机制
添加串口断连自动重连：
void check_connection() { if (!ser.isOpen()) { RCLCPP_WARN(get_logger(), "Reconnecting serial port..."); try { ser.open(); } catch (...) { RCLCPP_ERROR(get_logger(), "Reconnect failed"); } } }