前言在 ROS 2 开发体系中嵌入式 Linux 工程师的核心工作可以概括为四个字承上启下。向上承接算法工程师的决策指令如速度、轨迹、目标点向下驱动硬件执行具体动作如电机转动、舵机偏转、传感器数据采集。而将这个能力串联起来的最基本单元就是ROS 2 节点。本文用5000 字的篇幅完整拆解嵌入式 Linux 工程师最日常、最核心的工作流程创建功能包 → 写 C 节点 → 编译 → 测试话题通信。本文是个人对 ROS 2 开发范式的一点理解。第一章前置准备——你的工具箱在开始写任何代码之前需要确认以下工具已经就位。如果还没装花 5 分钟搞定它们。1.1 ROS 2 环境bashsource /opt/ros/humble/setup.bash # 每次开终端都要加载建议将这一行写入~/.bashrc实现自动加载bashecho source /opt/ros/humble/setup.bash ~/.bashrc source ~/.bashrc验证是否生效bashros2 --help # 应该显示所有子命令1.2 colcon 编译工具colcon是 ROS 2 的官方编译工具类似于 ROS 1 中的catkin。它的核心功能是递归查找工作空间中的所有功能包按依赖顺序编译自动处理头文件路径和库链接生成可执行文件和配置文件安装命令bashsudo apt update sudo apt install python3-colcon-common-extensions验证安装bashcolcon --help1.3 编辑器推荐使用 VSCode Remote-WSL 插件这样可以在 Windows 上编辑 WSL 中的代码体验接近原生。也可以用nano、vim或gedit。1.4 核心概念速览在动手之前先理解三个最核心的概念概念说明类比工作空间Workspace存放所有功能包的顶层目录一个项目文件夹功能包Package一个独立的 ROS 2 模块包含代码、配置文件、依赖声明一个子模块节点Node一个可执行程序通过话题/服务与其他节点通信一个独立进程第二章创建工作空间——你的“工地”2.1 什么是工作空间工作空间Workspace是 ROS 2 开发的顶层目录通常命名为ros2_ws、dev_ws或robot_ws。它的标准结构如下textros2_ws/ ├── src/ # 源代码目录所有功能包放在这里 ├── build/ # 编译中间文件colcon 自动生成 ├── install/ # 编译产物可执行文件、库、配置文件 └── log/ # 编译日志colcon 自动生成其中build/、install/、log/三个目录由colcon build自动生成不需要手动创建。你只需要创建src/目录。2.2 创建工作空间的命令bash# 在家目录下创建 ros2_ws 和 src 子目录 mkdir -p ~/ros2_ws/src # 进入工作空间根目录 cd ~/ros2_ws # 编译空工作空间生成 build/ install/ log/ colcon build2.3 编译空工作空间的输出解读第一次执行colcon build时即使src/目录为空colcon也会正常执行并生成以下内容textStarting (no packages to build) Finished (0.0s)这说明编译工具本身工作正常。如果报错通常是以下原因报错信息原因解决方案colcon: command not foundcolcon 未安装执行sudo apt install python3-colcon-common-extensionsPermission denied目录权限不足确保~/ros2_ws属于当前用户No module named catkin_pkg缺少 Python 依赖执行pip install catkin_pkg2.4 加载工作空间环境编译完成后需要source工作空间的setup.bash让系统知道这个工作空间的存在bashsource ~/ros2_ws/install/setup.bash建议将这一行也加到~/.bashrc中这样每次开终端都会自动加载bashecho source ~/ros2_ws/install/setup.bash ~/.bashrc source ~/.bashrc⚠️注意source顺序很重要。系统级环境/opt/ros/humble/setup.bash应该先加载工作空间级环境~/ros2_ws/install/setup.bash后加载。后加载的会覆盖先加载的同名资源。2.5 查看当前加载了哪些工作空间bashecho $AMENT_PREFIX_PATH输出会显示所有已加载的工作空间路径排在前面的优先级更高。第三章创建功能包——你的“模块”3.1 什么是功能包功能包Package是 ROS 2 中最小的编译单元。每个功能包包含源代码C/Python编译配置CMakeLists.txt 或 setup.py包描述package.xml可选配置文件、启动文件、消息/服务定义嵌入式工程师的视角一个功能包通常对应一个硬件模块。例如motor_driver_pkg→ 电机驱动imu_driver_pkg→ IMU 传感器lidar_driver_pkg→ 激光雷达3.2 创建功能包的命令bash# 进入 src 目录所有功能包必须放在这里 cd ~/ros2_ws/src # 创建功能包 ros2 pkg create motor_controller_pkg \ --build-type ament_cmake \ --dependencies rclcpp std_msgs3.3 参数详解参数说明motor_controller_pkg功能包名称建议全小写下划线分隔--build-type ament_cmake指定使用 CMake 编译C 项目--dependencies rclcpp std_msgs声明依赖的 ROS 2 库关于依赖的说明rclcppROS 2 的 C 客户端库提供 Node、Publisher、Subscriber 等核心类std_msgs标准消息类型如Float64、String、Int32等如果要使用 Python 开发将--build-type改为ament_python但嵌入式 Linux 工程师首选 C。3.4 生成的文件结构执行上述命令后会在src/下生成以下目录结构textmotor_controller_pkg/ ├── CMakeLists.txt # CMake 编译脚本核心配置 ├── package.xml # 包描述文件名称、版本、依赖 ├── include/ │ └── motor_controller_pkg/ # 公共头文件目录 ├── src/ # 源代码目录目前为空 └── ...3.5 package.xml 详解package.xml是功能包的“身份证”包含以下关键字段xmlpackage format3 namemotor_controller_pkg/name version0.0.0/version descriptionTODO: Package description/description maintainer emailguopujuntodo.todoguopujun/maintainer licenseTODO: License declaration/license buildtool_dependament_cmake/buildtool_depend dependrclcpp/depend dependstd_msgs/depend export build_typeament_cmake/build_type /export /package嵌入式工程师需要关注depend标签列出所有依赖包编译时会自动检查如果添加了新的依赖如sensor_msgs需要在这里声明3.6 CMakeLists.txt 核心结构CMakeLists.txt是编译脚本核心结构如下cmakecmake_minimum_required(VERSION 3.8) project(motor_controller_pkg) # 查找依赖包 find_package(ament_cmake REQUIRED) find_package(rclcpp REQUIRED) find_package(std_msgs REQUIRED) # 添加可执行文件稍后填写 # add_executable(...) # 安装规则稍后填写 # install(...) ament_package()在后续章节中我们会逐步填充这个文件。第四章写 C 节点——你的“灵魂”4.1 节点是什么节点Node是 ROS 2 中的独立可执行程序它通过 ROS 2 中间件与其他节点通信。一个机器人系统通常由数十个节点组成/motor_controller控制电机速度/imu_driver读取 IMU 数据/lidar_driver读取激光雷达数据/localization定位/navigation规划路径嵌入式 Linux 工程师最常写的节点类型驱动程序节点读取传感器数据发布到话题执行器节点订阅控制指令驱动硬件状态发布节点定期发布机器人状态4.2 完整代码一个“电机速度发布器”在src/motor_controller_pkg/src/下创建motor_publisher.cppcpp#include chrono #include functional #include memory #include cstdlib // for rand() #include rclcpp/rclcpp.hpp #include std_msgs/msg/float64.hpp using namespace std::chrono_literals; class MotorPublisher : public rclcpp::Node { public: // 构造函数初始化节点名称、创建发布者、创建定时器 MotorPublisher() : Node(motor_publisher) { // 1. 创建发布者话题名称 /motor_speed队列深度 10 publisher_ this-create_publisherstd_msgs::msg::Float64( /motor_speed, 10); // 2. 创建定时器每 500ms 调用一次 publish_speed() timer_ this-create_wall_timer( 500ms, std::bind(MotorPublisher::publish_speed, this)); // 3. 打印启动日志 RCLCPP_INFO(this-get_logger(), Motor Publisher started! Publishing to /motor_speed); } private: // 定时器回调函数生成模拟速度并发布 void publish_speed() { // 创建消息对象 auto msg std_msgs::msg::Float64(); // 模拟速度值10~30 之间的随机数 // 在真实项目中这里会读取编码器或下发 PWM 占空比 msg.data 10.0 (rand() % 20); // 发布消息 publisher_-publish(msg); // 打印日志 RCLCPP_INFO(this-get_logger(), Publishing: %.2f, msg.data); } // 成员变量 rclcpp::Publisherstd_msgs::msg::Float64::SharedPtr publisher_; rclcpp::TimerBase::SharedPtr timer_; }; // 主函数入口 int main(int argc, char * argv[]) { // 1. 初始化 ROS 2 rclcpp::init(argc, argv); // 2. 创建节点对象并进入事件循环 rclcpp::spin(std::make_sharedMotorPublisher()); // 3. 退出前清理 rclcpp::shutdown(); return 0; }4.3 代码逐行解读嵌入式工程师视角代码段解释#include rclcpp/rclcpp.hppROS 2 C 核心库提供 Node、Publisher、Timer 等#include std_msgs/msg/float64.hpp标准消息类型 Float64用于传输一个浮点数class MotorPublisher : public rclcpp::Node自定义节点类继承自 rclcpp::Nodethis-create_publisherT(/topic, 10)创建发布者参数话题名、队列深度this-create_wall_timer(500ms, callback)创建定时器每 500ms 触发一次回调publisher_-publish(msg)发布消息到话题RCLCPP_INFO(logger, format, args)打印 INFO 级别日志rclcpp::spin(node)进入事件循环等待定时器/回调触发rclcpp::shutdown()退出时清理资源嵌入式工程师的关键思考如果这个节点要控制真实的电机publish_speed()中应该调用硬件驱动 API如set_pwm()而不是生成随机数队列深度10在资源受限的嵌入式平台上需要根据实际负载调整4.4 编译配置修改 CMakeLists.txt在src/motor_controller_pkg/CMakeLists.txt末尾ament_package()之前添加cmake# 添加可执行文件 add_executable(motor_publisher src/motor_publisher.cpp) # 链接依赖库 ament_target_dependencies(motor_publisher rclcpp std_msgs ) # 安装规则将可执行文件安装到 install/bin/ 目录 install(TARGETS motor_publisher DESTINATION lib/${PROJECT_NAME} )解释add_executable指定可执行文件名称和源文件ament_target_dependencies声明需要链接的 ROS 2 库install(TARGETS ... DESTINATION ...)指定安装位置这样ros2 run才能找到第五章编译——你的“构建”5.1 编译命令bash# 进入工作空间根目录 cd ~/ros2_ws # 只编译 motor_controller_pkg推荐节省时间 colcon build --packages-select motor_controller_pkg # 或者编译整个工作空间如果改动较多 colcon build5.2 编译过程的底层逻辑colcon build执行以下步骤解析依赖读取package.xml和CMakeLists.txt确定编译顺序配置 CMake在build/目录下生成 Makefile编译执行make生成目标文件.o和可执行文件安装将可执行文件、头文件、配置文件复制到install/目录5.3 常见编译错误及解决方案错误信息原因解决方案No such file or directory: rclcpp/rclcpp.hppfind_package(rclcpp)失败检查CMakeLists.txt中的find_packageundefined reference to rclcpp::...未链接依赖库检查ament_target_dependencies是否完整error: Float64 is not a member of std_msgs::msg头文件路径错误确认#include std_msgs/msg/float64.hppCMake Error: The source directory ... does not exist路径拼写错误检查add_executable中的源文件路径5.4 编译后的目录结构编译完成后~/ros2_ws/下会生成textros2_ws/ ├── src/ ├── build/ │ └── motor_controller_pkg/ │ ├── CMakeCache.txt │ └── ... ├── install/ │ └── motor_controller_pkg/ │ ├── lib/ │ │ └── motor_controller_pkg/ │ │ └── motor_publisher # 可执行文件 │ ├── share/ │ │ └── motor_controller_pkg/ │ │ ├── package.xml │ │ └── ... │ └── setup.bash # 环境加载脚本 └── log/ └── ...关键点可执行文件位于install/motor_controller_pkg/lib/motor_controller_pkg/motor_publisherros2 run会自动查找这个路径。第六章测试话题通信——你的“验收”6.1 加载工作空间环境每次编译后需要source工作空间的环境bashsource ~/ros2_ws/install/setup.bash如果已经将这一行写入~/.bashrc重新打开终端即可。6.2 运行节点bashros2 run motor_controller_pkg motor_publisher预期输出text[INFO] [timestamp] [motor_publisher]: Motor Publisher started! Publishing to /motor_speed [INFO] [timestamp] [motor_publisher]: Publishing: 23.00 [INFO] [timestamp] [motor_publisher]: Publishing: 15.00 [INFO] [timestamp] [motor_publisher]: Publishing: 28.00 [INFO] [timestamp] [motor_publisher]: Publishing: 12.00 ...6.3 查看话题列表bashros2 topic list应该能看到/motor_speed。6.4 查看话题数据bashros2 topic echo /motor_speed预期输出textdata: 23.0 --- data: 15.0 --- data: 28.0 ---6.5 查看话题信息bashros2 topic info /motor_speed预期输出textType: std_msgs/msg/Float64 Publisher count: 1 Subscription count: 06.6 查看话题发布频率bashros2 topic hz /motor_speed预期显示约 2.0 Hz因为定时器周期是 500ms。6.7 可视化调试rqt_graphbashrqt_graph会打开一个图形化窗口显示节点和话题的关系图可以直观地看到motor_publisher节点正在向/motor_speed话题发布消息。第七章进阶——写一个订阅者节点7.1 为什么需要订阅者嵌入式 Linux 工程师不仅要发布数据还要接收控制指令。例如订阅/cmd_vel速度指令→ 控制电机订阅/led_command灯光指令→ 控制 LED订阅/config配置参数→ 更新运行参数7.2 完整代码一个“电机速度订阅者”在src/motor_controller_pkg/src/下创建motor_subscriber.cppcpp#include memory #include rclcpp/rclcpp.hpp #include std_msgs/msg/float64.hpp class MotorSubscriber : public rclcpp::Node { public: MotorSubscriber() : Node(motor_subscriber) { // 创建订阅者订阅 /motor_speed 话题队列深度 10 subscription_ this-create_subscriptionstd_msgs::msg::Float64( /motor_speed, 10, std::bind(MotorSubscriber::speed_callback, this, std::placeholders::_1)); RCLCPP_INFO(this-get_logger(), Motor Subscriber started! Listening to /motor_speed); } private: void speed_callback(const std_msgs::msg::Float64::SharedPtr msg) { double speed msg-data; // 模拟将速度值转换为 PWM 占空比0~1 double pwm speed / 30.0; // 假设最大速度 30 if (pwm 1.0) pwm 1.0; // 在真实项目中这里会调用硬件 API 驱动电机 RCLCPP_INFO(this-get_logger(), Received speed: %.2f - PWM: %.3f, speed, pwm); } rclcpp::Subscriptionstd_msgs::msg::Float64::SharedPtr subscription_; }; int main(int argc, char * argv[]) { rclcpp::init(argc, argv); rclcpp::spin(std::make_sharedMotorSubscriber()); rclcpp::shutdown(); return 0; }7.3 修改 CMakeLists.txt 添加订阅者在CMakeLists.txt中添加cmakeadd_executable(motor_subscriber src/motor_subscriber.cpp) ament_target_dependencies(motor_subscriber rclcpp std_msgs) install(TARGETS motor_publisher motor_subscriber # 新增 DESTINATION lib/${PROJECT_NAME} )7.4 测试发布者 订阅者联动终端 1运行发布者bashros2 run motor_controller_pkg motor_publisher终端 2运行订阅者bashros2 run motor_controller_pkg motor_subscriber终端 3可选查看话题数据bashros2 topic echo /motor_speed预期结果发布者终端输出速度值订阅者终端输出Received speed: X.XX - PWM: X.XXX两者的速度值对应7.5 完整的工作流程示意图text┌─────────────────┐ ┌─────────────────┐ │ motor_publisher │ ──发布──▶ │ /motor_speed │ ──订阅──▶ │ motor_subscriber │ │ (速度生成器) │ │ (话题) │ │ (PWM 转换器) │ └─────────────────┘ └─────────────────┘ └─────────────────┘ │ ▼ ┌─────────────────┐ │ 真实硬件驱动 │ │ (PWM/电机) │ └─────────────────┘第八章嵌入式工程师的深度思考8.1 从“模拟”到“真实”的跨越在真实嵌入式项目中节点不会生成随机数而是与硬件交互cppvoid publish_speed() { // 真实代码示例读取编码器 int32_t encoder_value read_encoder_from_i2c(); double speed encoder_to_speed(encoder_value); std_msgs::msg::Float64 msg; msg.data speed; publisher_-publish(msg); }8.2 话题通信的实时性考量场景推荐通信方式说明周期性传感器数据IMU、激光雷达话题Topic发布-订阅模式适合单向数据流一次性请求获取配置参数服务Service请求-响应模式适合双向交互长时间任务自主导航、建图动作Action异步反馈机制带进度/结果反馈8.3 嵌入式环境下的优化策略降低发布频率IMU 数据不需要 1000Hz200Hz 就够使用更小的数据类型用float而不是double如果精度允许减少日志输出RCLCPP_DEBUG在 Release 模式下可以关闭合理设置 QoS传感器数据可用BestEffort而不是Reliable8.4 从 PC 到 ARM 的迁移路径在 PCWSL上编写和测试节点逻辑使用模拟数据交叉编译使用arm-linux-gnueabihf-gcc编译 ARM 版本部署到开发板将可执行文件通过scp或rsync传输到开发板真机测试运行节点连接真实的传感器和执行器8.5 调试技巧工具用途rqt_console查看所有节点的日志输出rqt_graph可视化节点和话题关系ros2 node list列出所有活跃节点ros2 topic echo查看话题数据ros2 topic hz检查发布频率ros2 doctor检查系统健康状态第九章本流程的完整命令速查表bash# 1. 创建工作空间 mkdir -p ~/ros2_ws/src cd ~/ros2_ws colcon build source install/setup.bash # 2. 创建功能包 cd ~/ros2_ws/src ros2 pkg create motor_controller_pkg \ --build-type ament_cmake \ --dependencies rclcpp std_msgs # 3. 写代码在 src/motor_controller_pkg/src/motor_publisher.cpp # 参考第四章的完整代码 # 4. 修改 CMakeLists.txt # 参考第四章的配置 # 5. 编译 cd ~/ros2_ws colcon build --packages-select motor_controller_pkg source install/setup.bash # 6. 运行和测试 ros2 run motor_controller_pkg motor_publisher ros2 topic echo /motor_speed 总结嵌入式 Linux 工程师的 ROS 2 开发日常本质上是一个从“写代码”到“验证通信”的闭环text写代码 → 配置编译 → 编译 → 运行 → 验证话题 → 发现问题→ 修改代码 → 重新编译 → 再次验证掌握这个流程后就有了构建任何 ROS 2 机器人软件模块的能力。无论是电机驱动、传感器读取还是更复杂的视觉处理都是在这个基础流程上不断扩展。
嵌入式 Linux 工程师的日常核心流程：从零到话题通信
发布时间：2026/7/14 4:30:18
前言在 ROS 2 开发体系中嵌入式 Linux 工程师的核心工作可以概括为四个字承上启下。向上承接算法工程师的决策指令如速度、轨迹、目标点向下驱动硬件执行具体动作如电机转动、舵机偏转、传感器数据采集。而将这个能力串联起来的最基本单元就是ROS 2 节点。本文用5000 字的篇幅完整拆解嵌入式 Linux 工程师最日常、最核心的工作流程创建功能包 → 写 C 节点 → 编译 → 测试话题通信。本文是个人对 ROS 2 开发范式的一点理解。第一章前置准备——你的工具箱在开始写任何代码之前需要确认以下工具已经就位。如果还没装花 5 分钟搞定它们。1.1 ROS 2 环境bashsource /opt/ros/humble/setup.bash # 每次开终端都要加载建议将这一行写入~/.bashrc实现自动加载bashecho source /opt/ros/humble/setup.bash ~/.bashrc source ~/.bashrc验证是否生效bashros2 --help # 应该显示所有子命令1.2 colcon 编译工具colcon是 ROS 2 的官方编译工具类似于 ROS 1 中的catkin。它的核心功能是递归查找工作空间中的所有功能包按依赖顺序编译自动处理头文件路径和库链接生成可执行文件和配置文件安装命令bashsudo apt update sudo apt install python3-colcon-common-extensions验证安装bashcolcon --help1.3 编辑器推荐使用 VSCode Remote-WSL 插件这样可以在 Windows 上编辑 WSL 中的代码体验接近原生。也可以用nano、vim或gedit。1.4 核心概念速览在动手之前先理解三个最核心的概念概念说明类比工作空间Workspace存放所有功能包的顶层目录一个项目文件夹功能包Package一个独立的 ROS 2 模块包含代码、配置文件、依赖声明一个子模块节点Node一个可执行程序通过话题/服务与其他节点通信一个独立进程第二章创建工作空间——你的“工地”2.1 什么是工作空间工作空间Workspace是 ROS 2 开发的顶层目录通常命名为ros2_ws、dev_ws或robot_ws。它的标准结构如下textros2_ws/ ├── src/ # 源代码目录所有功能包放在这里 ├── build/ # 编译中间文件colcon 自动生成 ├── install/ # 编译产物可执行文件、库、配置文件 └── log/ # 编译日志colcon 自动生成其中build/、install/、log/三个目录由colcon build自动生成不需要手动创建。你只需要创建src/目录。2.2 创建工作空间的命令bash# 在家目录下创建 ros2_ws 和 src 子目录 mkdir -p ~/ros2_ws/src # 进入工作空间根目录 cd ~/ros2_ws # 编译空工作空间生成 build/ install/ log/ colcon build2.3 编译空工作空间的输出解读第一次执行colcon build时即使src/目录为空colcon也会正常执行并生成以下内容textStarting (no packages to build) Finished (0.0s)这说明编译工具本身工作正常。如果报错通常是以下原因报错信息原因解决方案colcon: command not foundcolcon 未安装执行sudo apt install python3-colcon-common-extensionsPermission denied目录权限不足确保~/ros2_ws属于当前用户No module named catkin_pkg缺少 Python 依赖执行pip install catkin_pkg2.4 加载工作空间环境编译完成后需要source工作空间的setup.bash让系统知道这个工作空间的存在bashsource ~/ros2_ws/install/setup.bash建议将这一行也加到~/.bashrc中这样每次开终端都会自动加载bashecho source ~/ros2_ws/install/setup.bash ~/.bashrc source ~/.bashrc⚠️注意source顺序很重要。系统级环境/opt/ros/humble/setup.bash应该先加载工作空间级环境~/ros2_ws/install/setup.bash后加载。后加载的会覆盖先加载的同名资源。2.5 查看当前加载了哪些工作空间bashecho $AMENT_PREFIX_PATH输出会显示所有已加载的工作空间路径排在前面的优先级更高。第三章创建功能包——你的“模块”3.1 什么是功能包功能包Package是 ROS 2 中最小的编译单元。每个功能包包含源代码C/Python编译配置CMakeLists.txt 或 setup.py包描述package.xml可选配置文件、启动文件、消息/服务定义嵌入式工程师的视角一个功能包通常对应一个硬件模块。例如motor_driver_pkg→ 电机驱动imu_driver_pkg→ IMU 传感器lidar_driver_pkg→ 激光雷达3.2 创建功能包的命令bash# 进入 src 目录所有功能包必须放在这里 cd ~/ros2_ws/src # 创建功能包 ros2 pkg create motor_controller_pkg \ --build-type ament_cmake \ --dependencies rclcpp std_msgs3.3 参数详解参数说明motor_controller_pkg功能包名称建议全小写下划线分隔--build-type ament_cmake指定使用 CMake 编译C 项目--dependencies rclcpp std_msgs声明依赖的 ROS 2 库关于依赖的说明rclcppROS 2 的 C 客户端库提供 Node、Publisher、Subscriber 等核心类std_msgs标准消息类型如Float64、String、Int32等如果要使用 Python 开发将--build-type改为ament_python但嵌入式 Linux 工程师首选 C。3.4 生成的文件结构执行上述命令后会在src/下生成以下目录结构textmotor_controller_pkg/ ├── CMakeLists.txt # CMake 编译脚本核心配置 ├── package.xml # 包描述文件名称、版本、依赖 ├── include/ │ └── motor_controller_pkg/ # 公共头文件目录 ├── src/ # 源代码目录目前为空 └── ...3.5 package.xml 详解package.xml是功能包的“身份证”包含以下关键字段xmlpackage format3 namemotor_controller_pkg/name version0.0.0/version descriptionTODO: Package description/description maintainer emailguopujuntodo.todoguopujun/maintainer licenseTODO: License declaration/license buildtool_dependament_cmake/buildtool_depend dependrclcpp/depend dependstd_msgs/depend export build_typeament_cmake/build_type /export /package嵌入式工程师需要关注depend标签列出所有依赖包编译时会自动检查如果添加了新的依赖如sensor_msgs需要在这里声明3.6 CMakeLists.txt 核心结构CMakeLists.txt是编译脚本核心结构如下cmakecmake_minimum_required(VERSION 3.8) project(motor_controller_pkg) # 查找依赖包 find_package(ament_cmake REQUIRED) find_package(rclcpp REQUIRED) find_package(std_msgs REQUIRED) # 添加可执行文件稍后填写 # add_executable(...) # 安装规则稍后填写 # install(...) ament_package()在后续章节中我们会逐步填充这个文件。第四章写 C 节点——你的“灵魂”4.1 节点是什么节点Node是 ROS 2 中的独立可执行程序它通过 ROS 2 中间件与其他节点通信。一个机器人系统通常由数十个节点组成/motor_controller控制电机速度/imu_driver读取 IMU 数据/lidar_driver读取激光雷达数据/localization定位/navigation规划路径嵌入式 Linux 工程师最常写的节点类型驱动程序节点读取传感器数据发布到话题执行器节点订阅控制指令驱动硬件状态发布节点定期发布机器人状态4.2 完整代码一个“电机速度发布器”在src/motor_controller_pkg/src/下创建motor_publisher.cppcpp#include chrono #include functional #include memory #include cstdlib // for rand() #include rclcpp/rclcpp.hpp #include std_msgs/msg/float64.hpp using namespace std::chrono_literals; class MotorPublisher : public rclcpp::Node { public: // 构造函数初始化节点名称、创建发布者、创建定时器 MotorPublisher() : Node(motor_publisher) { // 1. 创建发布者话题名称 /motor_speed队列深度 10 publisher_ this-create_publisherstd_msgs::msg::Float64( /motor_speed, 10); // 2. 创建定时器每 500ms 调用一次 publish_speed() timer_ this-create_wall_timer( 500ms, std::bind(MotorPublisher::publish_speed, this)); // 3. 打印启动日志 RCLCPP_INFO(this-get_logger(), Motor Publisher started! Publishing to /motor_speed); } private: // 定时器回调函数生成模拟速度并发布 void publish_speed() { // 创建消息对象 auto msg std_msgs::msg::Float64(); // 模拟速度值10~30 之间的随机数 // 在真实项目中这里会读取编码器或下发 PWM 占空比 msg.data 10.0 (rand() % 20); // 发布消息 publisher_-publish(msg); // 打印日志 RCLCPP_INFO(this-get_logger(), Publishing: %.2f, msg.data); } // 成员变量 rclcpp::Publisherstd_msgs::msg::Float64::SharedPtr publisher_; rclcpp::TimerBase::SharedPtr timer_; }; // 主函数入口 int main(int argc, char * argv[]) { // 1. 初始化 ROS 2 rclcpp::init(argc, argv); // 2. 创建节点对象并进入事件循环 rclcpp::spin(std::make_sharedMotorPublisher()); // 3. 退出前清理 rclcpp::shutdown(); return 0; }4.3 代码逐行解读嵌入式工程师视角代码段解释#include rclcpp/rclcpp.hppROS 2 C 核心库提供 Node、Publisher、Timer 等#include std_msgs/msg/float64.hpp标准消息类型 Float64用于传输一个浮点数class MotorPublisher : public rclcpp::Node自定义节点类继承自 rclcpp::Nodethis-create_publisherT(/topic, 10)创建发布者参数话题名、队列深度this-create_wall_timer(500ms, callback)创建定时器每 500ms 触发一次回调publisher_-publish(msg)发布消息到话题RCLCPP_INFO(logger, format, args)打印 INFO 级别日志rclcpp::spin(node)进入事件循环等待定时器/回调触发rclcpp::shutdown()退出时清理资源嵌入式工程师的关键思考如果这个节点要控制真实的电机publish_speed()中应该调用硬件驱动 API如set_pwm()而不是生成随机数队列深度10在资源受限的嵌入式平台上需要根据实际负载调整4.4 编译配置修改 CMakeLists.txt在src/motor_controller_pkg/CMakeLists.txt末尾ament_package()之前添加cmake# 添加可执行文件 add_executable(motor_publisher src/motor_publisher.cpp) # 链接依赖库 ament_target_dependencies(motor_publisher rclcpp std_msgs ) # 安装规则将可执行文件安装到 install/bin/ 目录 install(TARGETS motor_publisher DESTINATION lib/${PROJECT_NAME} )解释add_executable指定可执行文件名称和源文件ament_target_dependencies声明需要链接的 ROS 2 库install(TARGETS ... DESTINATION ...)指定安装位置这样ros2 run才能找到第五章编译——你的“构建”5.1 编译命令bash# 进入工作空间根目录 cd ~/ros2_ws # 只编译 motor_controller_pkg推荐节省时间 colcon build --packages-select motor_controller_pkg # 或者编译整个工作空间如果改动较多 colcon build5.2 编译过程的底层逻辑colcon build执行以下步骤解析依赖读取package.xml和CMakeLists.txt确定编译顺序配置 CMake在build/目录下生成 Makefile编译执行make生成目标文件.o和可执行文件安装将可执行文件、头文件、配置文件复制到install/目录5.3 常见编译错误及解决方案错误信息原因解决方案No such file or directory: rclcpp/rclcpp.hppfind_package(rclcpp)失败检查CMakeLists.txt中的find_packageundefined reference to rclcpp::...未链接依赖库检查ament_target_dependencies是否完整error: Float64 is not a member of std_msgs::msg头文件路径错误确认#include std_msgs/msg/float64.hppCMake Error: The source directory ... does not exist路径拼写错误检查add_executable中的源文件路径5.4 编译后的目录结构编译完成后~/ros2_ws/下会生成textros2_ws/ ├── src/ ├── build/ │ └── motor_controller_pkg/ │ ├── CMakeCache.txt │ └── ... ├── install/ │ └── motor_controller_pkg/ │ ├── lib/ │ │ └── motor_controller_pkg/ │ │ └── motor_publisher # 可执行文件 │ ├── share/ │ │ └── motor_controller_pkg/ │ │ ├── package.xml │ │ └── ... │ └── setup.bash # 环境加载脚本 └── log/ └── ...关键点可执行文件位于install/motor_controller_pkg/lib/motor_controller_pkg/motor_publisherros2 run会自动查找这个路径。第六章测试话题通信——你的“验收”6.1 加载工作空间环境每次编译后需要source工作空间的环境bashsource ~/ros2_ws/install/setup.bash如果已经将这一行写入~/.bashrc重新打开终端即可。6.2 运行节点bashros2 run motor_controller_pkg motor_publisher预期输出text[INFO] [timestamp] [motor_publisher]: Motor Publisher started! Publishing to /motor_speed [INFO] [timestamp] [motor_publisher]: Publishing: 23.00 [INFO] [timestamp] [motor_publisher]: Publishing: 15.00 [INFO] [timestamp] [motor_publisher]: Publishing: 28.00 [INFO] [timestamp] [motor_publisher]: Publishing: 12.00 ...6.3 查看话题列表bashros2 topic list应该能看到/motor_speed。6.4 查看话题数据bashros2 topic echo /motor_speed预期输出textdata: 23.0 --- data: 15.0 --- data: 28.0 ---6.5 查看话题信息bashros2 topic info /motor_speed预期输出textType: std_msgs/msg/Float64 Publisher count: 1 Subscription count: 06.6 查看话题发布频率bashros2 topic hz /motor_speed预期显示约 2.0 Hz因为定时器周期是 500ms。6.7 可视化调试rqt_graphbashrqt_graph会打开一个图形化窗口显示节点和话题的关系图可以直观地看到motor_publisher节点正在向/motor_speed话题发布消息。第七章进阶——写一个订阅者节点7.1 为什么需要订阅者嵌入式 Linux 工程师不仅要发布数据还要接收控制指令。例如订阅/cmd_vel速度指令→ 控制电机订阅/led_command灯光指令→ 控制 LED订阅/config配置参数→ 更新运行参数7.2 完整代码一个“电机速度订阅者”在src/motor_controller_pkg/src/下创建motor_subscriber.cppcpp#include memory #include rclcpp/rclcpp.hpp #include std_msgs/msg/float64.hpp class MotorSubscriber : public rclcpp::Node { public: MotorSubscriber() : Node(motor_subscriber) { // 创建订阅者订阅 /motor_speed 话题队列深度 10 subscription_ this-create_subscriptionstd_msgs::msg::Float64( /motor_speed, 10, std::bind(MotorSubscriber::speed_callback, this, std::placeholders::_1)); RCLCPP_INFO(this-get_logger(), Motor Subscriber started! Listening to /motor_speed); } private: void speed_callback(const std_msgs::msg::Float64::SharedPtr msg) { double speed msg-data; // 模拟将速度值转换为 PWM 占空比0~1 double pwm speed / 30.0; // 假设最大速度 30 if (pwm 1.0) pwm 1.0; // 在真实项目中这里会调用硬件 API 驱动电机 RCLCPP_INFO(this-get_logger(), Received speed: %.2f - PWM: %.3f, speed, pwm); } rclcpp::Subscriptionstd_msgs::msg::Float64::SharedPtr subscription_; }; int main(int argc, char * argv[]) { rclcpp::init(argc, argv); rclcpp::spin(std::make_sharedMotorSubscriber()); rclcpp::shutdown(); return 0; }7.3 修改 CMakeLists.txt 添加订阅者在CMakeLists.txt中添加cmakeadd_executable(motor_subscriber src/motor_subscriber.cpp) ament_target_dependencies(motor_subscriber rclcpp std_msgs) install(TARGETS motor_publisher motor_subscriber # 新增 DESTINATION lib/${PROJECT_NAME} )7.4 测试发布者 订阅者联动终端 1运行发布者bashros2 run motor_controller_pkg motor_publisher终端 2运行订阅者bashros2 run motor_controller_pkg motor_subscriber终端 3可选查看话题数据bashros2 topic echo /motor_speed预期结果发布者终端输出速度值订阅者终端输出Received speed: X.XX - PWM: X.XXX两者的速度值对应7.5 完整的工作流程示意图text┌─────────────────┐ ┌─────────────────┐ │ motor_publisher │ ──发布──▶ │ /motor_speed │ ──订阅──▶ │ motor_subscriber │ │ (速度生成器) │ │ (话题) │ │ (PWM 转换器) │ └─────────────────┘ └─────────────────┘ └─────────────────┘ │ ▼ ┌─────────────────┐ │ 真实硬件驱动 │ │ (PWM/电机) │ └─────────────────┘第八章嵌入式工程师的深度思考8.1 从“模拟”到“真实”的跨越在真实嵌入式项目中节点不会生成随机数而是与硬件交互cppvoid publish_speed() { // 真实代码示例读取编码器 int32_t encoder_value read_encoder_from_i2c(); double speed encoder_to_speed(encoder_value); std_msgs::msg::Float64 msg; msg.data speed; publisher_-publish(msg); }8.2 话题通信的实时性考量场景推荐通信方式说明周期性传感器数据IMU、激光雷达话题Topic发布-订阅模式适合单向数据流一次性请求获取配置参数服务Service请求-响应模式适合双向交互长时间任务自主导航、建图动作Action异步反馈机制带进度/结果反馈8.3 嵌入式环境下的优化策略降低发布频率IMU 数据不需要 1000Hz200Hz 就够使用更小的数据类型用float而不是double如果精度允许减少日志输出RCLCPP_DEBUG在 Release 模式下可以关闭合理设置 QoS传感器数据可用BestEffort而不是Reliable8.4 从 PC 到 ARM 的迁移路径在 PCWSL上编写和测试节点逻辑使用模拟数据交叉编译使用arm-linux-gnueabihf-gcc编译 ARM 版本部署到开发板将可执行文件通过scp或rsync传输到开发板真机测试运行节点连接真实的传感器和执行器8.5 调试技巧工具用途rqt_console查看所有节点的日志输出rqt_graph可视化节点和话题关系ros2 node list列出所有活跃节点ros2 topic echo查看话题数据ros2 topic hz检查发布频率ros2 doctor检查系统健康状态第九章本流程的完整命令速查表bash# 1. 创建工作空间 mkdir -p ~/ros2_ws/src cd ~/ros2_ws colcon build source install/setup.bash # 2. 创建功能包 cd ~/ros2_ws/src ros2 pkg create motor_controller_pkg \ --build-type ament_cmake \ --dependencies rclcpp std_msgs # 3. 写代码在 src/motor_controller_pkg/src/motor_publisher.cpp # 参考第四章的完整代码 # 4. 修改 CMakeLists.txt # 参考第四章的配置 # 5. 编译 cd ~/ros2_ws colcon build --packages-select motor_controller_pkg source install/setup.bash # 6. 运行和测试 ros2 run motor_controller_pkg motor_publisher ros2 topic echo /motor_speed 总结嵌入式 Linux 工程师的 ROS 2 开发日常本质上是一个从“写代码”到“验证通信”的闭环text写代码 → 配置编译 → 编译 → 运行 → 验证话题 → 发现问题→ 修改代码 → 重新编译 → 再次验证掌握这个流程后就有了构建任何 ROS 2 机器人软件模块的能力。无论是电机驱动、传感器读取还是更复杂的视觉处理都是在这个基础流程上不断扩展。
相关文章
深入linux c/c++调试工具之ltrace(库函数无处遁形)
目录 一、前言——ltrace 工具简介 1.1 什么是 ltrace 1.2 与 strace / gdb 的对比 1.3 能跟踪什么、不能跟踪什么 二、使用场景——何时使用 ltrace 1、程序行为「像调了某个 API」但源码里找不到 2、排查内存分配异常 3、对比 strace：库函数层 vs 系统调用层 4、定位…
C++多线程死锁与资源竞争实战：从设计到调试的完整解决方案
1. 项目概述：从一次线上服务崩溃说起那天凌晨，我被一阵急促的电话铃声惊醒，监控系统显示我们核心的C数据处理服务CPU占用率100%，但吞吐量却降为零。登录服务器一看，日志里满是“等待锁超时”的警告。这场景太熟悉了——…
C++运算符重载与友元机制：从原理到实践打造直观自定义类型
1. 项目概述：为什么我们需要运算符重载与友元？在C的世界里，我们经常需要定义自己的数据类型，比如一个表示复数的类Complex，一个表示二维向量的类Vec2，或者一个管理资源的智能指针类。当你写下Complex a(1, …
AD74412R与PIC18F87K22构建高精度工业测量系统
1. 项目背景与核心器件选型在工业控制和精密测量领域，如何实现高精度模拟信号采集与输出一直是工程师面临的挑战。AD74412R作为Analog Devices推出的混合信号接口芯片，配合Microchip的PIC18F87K22微控制器，能够构建高性能的嵌入式测量控制系统…
《超简单：用 Python 让 Excel 飞起来》读书笔记：第8章 扩展 图表美化：从画出来到看得懂
🔥个人主页：杨利杰YJlio❄️个人专栏：《Sysinternals实战教程》《Windows PowerShell 实战》《WINDOWS教程》《IOS教程》《微信助手》《锤子助手》 《Python》 《Kali Linux》 《那些年未解决的Windows疑难杂症》🌟 让复杂的事情更…
最小可运行示例：墨迹天气 API 从实况到历史数据的全量调用
适用场景 墨迹天气 API 为开发者提供了接入全国 3 万 城市天气数据的统一入口，一次请求即可同时获得实况天气、空气质量、未来 7 天预报、24 小时趋势、9 项生活指数、气象预警及农历信息。典型的应用场景包括： 在智能家居面板上显示当地实时温湿度与穿…
多模态AI工业质检系统：技术架构与落地实践
1. 赛事背景与行业趋势解析全国人工智能应用场景创新挑战赛已成功举办三届，成为国内AI领域最具影响力的实战型赛事之一。本届赛事聚焦"场景驱动"核心理念，吸引了来自全国高校、科研院所和科技企业的超过1200支团队参赛。与往届相比，…
AI Agent人格设计：硬编码规则与动态Persona的对比与实践
1. AI Agent人格设计的核心矛盾在AI Agent系统设计中，人格(Persona)定义一直存在两种主流实现路径：硬编码规则与动态Persona描述。前者将行为准则直接写入系统底层代码，后者则通过自然语言文档(如SOUL.md)定义Agent的性格特征。这两种方式在O…
元初混沌 6G 全域通感一体化体系架构 第一卷三阶第二十七篇 场象：小区全域电磁笼罩梯度分布规律
第二十七篇 场象：小区全域电磁笼罩梯度分布规律承启前置说明前文第二十六篇完成四象传播体系之首——波象理论构建，建立多径谐振三态演化模型与非线性多普勒振荡扰动模型，从微观时域、频域、相位域解决了6G立体组网电磁波动态传播的乱象机理与…
元初混沌物理 108 篇 第八十八篇星气落地物化定则
89. 星气落地物化定则一、核心总纲七星依托引力气运沿六合时空轨道向下传导，穿透天地时空结界，沉降至人域、地域地层，转化为地表五行气源，驱动山川、草木、流体、矿质持续演化，完整界定星气落地物化定则，打…
北京华恒智信破解国企竞聘能上不能下成功案例
【客户行业】文旅行业【问题类型】人才培养【客户背景】随着国家住建部对产业分类标准的不断完善，特色小镇作为其中一类标准受到越来越多的关注。在文旅行业蓬勃发展的大背景下，国家提倡特色小镇向“强调文化IP”方向发展，倡导跨界融合&#…
STM32与ICM-42605实现6DOF姿态解算实战
1. 项目背景与核心需求在智能硬件和物联网设备快速发展的今天，精确追踪物体在三维空间中的运动和方向成为了许多应用场景的基础需求。无论是无人机飞控、VR/AR设备姿态感知，还是工业自动化中的运动检测，都需要高精度的6自由度（6DO…
MQ-2 烟雾传感器 ESP32-S3 驱动实战：ADC 读取与阈值校准 3 步完成
MQ-2 烟雾传感器 ESP32-S3 驱动实战：ADC 读取与阈值校准 3 步完成在智能家居和工业安全监测领域，烟雾检测是一个至关重要的环节。MQ-2 作为一款高性价比的半导体烟雾传感器，因其对多种可燃气体（如液化气、丙烷、氢气等）…
SPEC CPU 2006 v1.0.1 基准测试实战：ARM/X86/MIPS 三平台配置与 3 轮测试结果解读
SPEC CPU 2006 跨平台基准测试深度实战：ARM/X86/MIPS 架构配置优化与结果分析方法论在当今多元化的计算架构时代，如何客观评估不同处理器平台的真实性能成为系统工程师和性能优化专家的核心挑战。SPEC CPU 2006 作为业界公认的计算密集型基准测试套件&am…
每天60s读懂世界：2026年7月11日重点要闻解读
🔥 个人主页：杨利杰YJlio❄️ 个人专栏：《Windows 疑难杂症与工单复盘案例库》 《Sysinternals实战教程》《WINDOWS教程》 《Windows PowerShell 实战》 《人工智能实战合集》《超简单：用Python让Excel飞起来》🌟…
FAE放射组学分析工具：医学影像特征探索的完整解决方案
FAE放射组学分析工具：医学影像特征探索的完整解决方案 【免费下载链接】FAE FeAture Explorer 项目地址: https://gitcode.com/gh_mirrors/fae/FAE 你是否曾经面对海量医学影像数据感到无从下手？想要从CT、MRI等影像中提取有价值的定量特征&#…
0.69B参数实现中文多模态AI：揭秘Qwen3-SmVL模型融合技术的完整实战指南
0.69B参数实现中文多模态AI：揭秘Qwen3-SmVL模型融合技术的完整实战指南 【免费下载链接】happy-llm 📚 从零开始构建大模型 项目地址: https://gitcode.com/GitHub_Trending/ha/happy-llm 还在为大型多模态模型动辄数十亿参数、显存占用高而烦恼&…
解锁AMD Ryzen处理器性能潜力的SMU调试神器：从新手到专家的完整指南
解锁AMD Ryzen处理器性能潜力的SMU调试神器：从新手到专家的完整指南 【免费下载链接】SMUDebugTool A dedicated tool to help write/read various parameters of Ryzen-based systems, such as manual overclock, SMU, PCI, CPUID, MSR and Power Table. 项目地址…