ROS2 Humble串口驱动实战：从源码编译到常见问题解决-平芜编程栈

1. ROS2 Humble串口驱动概述

在机器人开发中，串口通信是最基础也最常用的硬件交互方式之一。ROS2 Humble作为当前LTS版本，虽然功能强大，但官方并未内置串口驱动支持，这给开发者带来了一些挑战。我刚开始接触ROS2串口开发时，也踩过不少坑，比如动态库加载失败、权限不足等问题。

串口驱动本质上是一个跨平台的C++库，它封装了底层操作系统对串口设备的操作接口。在Linux系统中，串口设备通常以/dev/ttyUSB*或/dev/ttyACM*形式存在。ROS2通过串口驱动可以与各类硬件设备通信，比如STM32控制器、传感器模块等。

与ROS1相比，ROS2的串口开发有几个显著变化：

取消了rosserial包，需要手动集成串口库
依赖管理更严格，需要正确处理ament_cmake构建系统
动态库路径处理方式不同，容易引发error while loading shared libraries错误

2. 环境准备与依赖安装

2.1 系统要求

推荐使用Ubuntu 22.04 LTS系统，这是ROS2 Humble的官方支持平台。我测试过在Ubuntu 20.04上也能运行，但需要额外处理一些兼容性问题。

关键依赖包包括：

sudo apt install build-essential cmake libasio-dev libtinyxml2-dev \ libssl-dev python3-colcon-common-extensions

2.2 串口工具安装

调试串口时，这些工具非常有用：

sudo apt install minicom screen # 查看串口设备 ls /dev/ttyUSB* # 查看串口详细信息 udevadm info --query=all --name=/dev/ttyUSB0

2.3 创建工作空间

建议为串口项目创建独立的工作空间：

mkdir -p ~/serial_ws/src cd ~/serial_ws colcon build

3. 串口驱动源码编译

3.1 获取源码

推荐使用经过ROS2 Humble测试的fork版本：

cd ~/serial_ws/src git clone https://github.com/ZhaoXiangBox/serial.git

原始仓库虽然功能完整，但在ROS2环境下需要额外配置：

git clone https://github.com/wjwwood/serial.git

3.2 编译配置

使用CMake进行编译时，这几个参数很关键：

cd serial mkdir build cd build cmake .. -DCMAKE_BUILD_TYPE=Release \ -DBUILD_SHARED_LIBS=ON \ -DBUILD_TESTING=OFF

3.3 安装到系统

建议安装到/usr/local目录：

sudo make install sudo ldconfig

如果只想在当前用户下使用：

make install DESTDIR=~/local_install export LD_LIBRARY_PATH=~/local_install/usr/local/lib:$LD_LIBRARY_PATH

4. 常见问题解决方案

4.1 权限问题处理

最常见的错误就是串口设备权限不足：

# 查看设备权限 ls -l /dev/ttyUSB0 # 临时解决方案（重启失效） sudo chmod 777 /dev/ttyUSB0

永久解决方案是创建udev规则：

echo 'KERNEL=="ttyUSB*", MODE="0666"' | sudo tee /etc/udev/rules.d/50-ros2-serial.rules sudo udevadm control --reload sudo udevadm trigger

4.2 动态库加载失败

编译成功后运行时可能出现：

error while loading shared libraries: libserial.so: cannot open shared object file

解决方案有两种：

临时方案（当前终端有效）：

export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH

永久方案：

sudo sh -c "echo '/usr/local/lib' >> /etc/ld.so.conf.d/serial.conf" sudo ldconfig

4.3 串口无法打开

即使编译通过，有时也会遇到串口无法打开的情况。首先检查：

# 查看串口是否存在 ls /dev/tty* # 检查是否被占用 lsof /dev/ttyUSB0

如果使用USB转串口设备，可能需要安装驱动。比如CH340/CH341芯片：

sudo apt install build-essential git clone https://github.com/juliagoda/CH341SER cd CH341SER make sudo make install sudo modprobe ch341

5. ROS2节点集成实践

5.1 创建功能包

cd ~/serial_ws/src ros2 pkg create --build-type ament_cmake serial_example \ --dependencies rclcpp serial

5.2 编写节点代码

创建src/serial_node.cpp：

#include <rclcpp/rclcpp.hpp> #include <serial/serial.h> class SerialNode : public rclcpp::Node { public: SerialNode() : Node("serial_node") { try { ser.setPort("/dev/ttyUSB0"); ser.setBaudrate(115200); serial::Timeout to = serial::Timeout::simpleTimeout(1000); ser.setTimeout(to); ser.open(); } catch (serial::IOException& e) { RCLCPP_ERROR(this->get_logger(), "无法打开串口: %s", e.what()); } timer_ = this->create_wall_timer( std::chrono::milliseconds(100), std::bind(&SerialNode::timer_callback, this)); } private: void timer_callback() { if(ser.isOpen()) { std::string data = "Hello from ROS2\n"; ser.write(data); if(ser.available()) { std::string result = ser.read(ser.available()); RCLCPP_INFO(this->get_logger(), "收到: %s", result.c_str()); } } } serial::Serial ser; rclcpp::TimerBase::SharedPtr timer_; }; int main(int argc, char** argv) { rclcpp::init(argc, argv); rclcpp::spin(std::make_shared<SerialNode>()); rclcpp::shutdown(); return 0; }

5.3 修改CMakeLists.txt

在CMakeLists.txt中添加：

add_executable(serial_node src/serial_node.cpp) target_include_directories(serial_node PRIVATE ${serial_INCLUDE_DIRS} ) target_link_libraries(serial_node ${rclcpp_LIBRARIES} serial ) install(TARGETS serial_node DESTINATION lib/${PROJECT_NAME} )

5.4 编译与运行

cd ~/serial_ws colcon build --packages-select serial_example source install/setup.bash ros2 run serial_example serial_node

6. 高级配置与优化

6.1 参数化配置

使用ROS2参数系统动态配置串口：

// 在构造函数中添加 this->declare_parameter<std::string>("port", "/dev/ttyUSB0"); this->declare_parameter<int>("baudrate", 115200); ser.setPort(this->get_parameter("port").as_string()); ser.setBaudrate(this->get_parameter("baudrate").as_int());

6.2 多线程处理

对于高速串口通信，建议使用独立线程：

#include <thread> void read_thread() { while(rclcpp::ok() && ser.isOpen()) { if(ser.available()) { std::string result = ser.read(ser.available()); RCLCPP_INFO(this->get_logger(), "收到: %s", result.c_str()); } std::this_thread::sleep_for(std::chrono::milliseconds(10)); } } // 在构造函数中启动线程 std::thread(&SerialNode::read_thread, this).detach();

6.3 性能优化技巧

调整缓冲区大小：

ser.setBytesize(serial::eightbits); ser.setParity(serial::parity_none); ser.setStopbits(serial::stopbits_one);

使用硬件流控制（如果需要）：

ser.setFlowcontrol(serial::flowcontrol_hardware);

启用RTS/CTS：

ser.setRTS(true); ser.setCTS(true);

7. 实际项目经验分享

在机器人项目中，我通常会封装一个更健壮的串口类。以下是几个关键点：

错误重试机制：当串口断开时自动尝试重连

void check_connection() { if(!ser.isOpen()) { try { ser.open(); RCLCPP_WARN(this->get_logger(), "串口重新连接成功"); } catch (...) { RCLCPP_ERROR(this->get_logger(), "串口重连失败"); } } }

数据协议处理：使用帧头+长度+校验位格式

bool validate_packet(const std::string& data) { if(data.length() < 4) return false; uint8_t checksum = 0; for(size_t i=0; i<data.length()-1; ++i) { checksum ^= data[i]; } return checksum == data.back(); }

超时处理：设置合理的读写超时

serial::Timeout to = serial::Timeout::simpleTimeout(500); ser.setTimeout(to);

日志记录：重要操作记录日志

RCLCPP_DEBUG(this->get_logger(), "发送数据: %s", to_hex_string(data).c_str());

遇到最棘手的问题是USB转串口设备在长时间运行后突然断开。解决方案是增加心跳检测机制，定期检查连接状态，并在异常时重置端口。

ROS2 Humble串口驱动实战：从源码编译到常见问题解决