ROSMASTER-M1RDK X5 M1 麦轮底盘一体式「一机两用」完整方案文档一、方案背景传统 ROS2 机器人开发主流两套模式存在明显痛点分布式分离方案PC 开发机 机器人目标机 PC (X86) 负责代码编译开发ARM 机器人仅运行程序。必须掌握ROS2 DDS 跨主机通信极易出现 DomainID、防火墙、组播问题频繁发生 “节点互相看不见”X86 编译产物在 ARM 平台容易出现库版本、ABI 兼容性异常手柄、雷达、相机挂载机器人上位机难以直接抓取底层设备原始数据小车测试依赖网络断开 WiFi / 网线无法独立运行。交叉编译量产方案PC 搭建 ARM 交叉编译链编译后将程序上传机器人运行。工具链部署复杂学习门槛极高缺少真机即时调试链路不适合教学、科研快速原型验证。用户群体诉求亚博产品定位人群ROS 初学者、高校科研团队、单人小型研发团队需求一套硬件完成代码编写→编译→真机调试→场地独立实测尽量减少环境配置、网络通信等无关障碍。硬件条件成熟RDK X5 具备 8 核 A55、充足内存、SSD 高速存储ARM64 Ubuntu22.04 完整系统算力可以支撑本地编译 ROS2 功能包不再像低性能开发板只能纯跑程序。基于以上痛点亚博原厂镜像采用一体式一机两用架构。二、方案定位单台机器人本体RDK X5同时承担【开发机】【目标运行机】双重角色RDK X5代码编辑、本地编译、业务程序运行、硬件驱动访问Windows/X86 PC仅作为远程终端显示器VSCode Remote-SSH / MobaXtermPC 可以不安装 ROS2、不运行任何机器人业务节点适用阶段ROS 学习、算法原型开发、真机功能调试、样机场地验证边界说明属于研发 / 样机环境不可直接作为大规模商用量产固件项目定型后需要剥离开发工具制作最小化纯运行镜像。三、选择一体式「一机两用」方案的核心原因优势开发环境 运行环境消除架构兼容风险代码在 ARM 本机编译、本机运行不存在 x86→ARM 跨架构编译带来的依赖库、ABI 不兼容问题调试通过的程序直接等同于样机运行版本。大幅降低 ROS2 入门门槛所有 ROS 节点本地运行通信闭环在板卡内部。开发者专注学习节点、话题、发布订阅核心模型不必花费大量精力调试 DDS 跨机网络故障。硬件外设调试直观便捷USB 手柄、激光雷达、MIPI 相机直接接入 RDK程序直接读写/dev/input、串口设备无需网络转发硬件原始数据流延迟低、稳定性高。机器人支持完全脱离 PC 独立运行调试完成后断开电脑、断开无线网络依靠本地 USB 手柄自主工作支持室内、户外大范围移动实测。单人可实现完整研发闭环不需要两台主机、无需搭建复杂局域网分布式环境单台小车即可完成编码、编译、实车验证全流程。软件运行架构与小批量样机形态完全一致研发阶段不需要修改通信架构后期向样机交付平滑过渡。客观短板方案边界ARM 平台本地编译速度弱于 X86 台式计算机镜像预装编译器、源码、全套调试工具占用存储空间后台进程更多同时运行 SLAM、多目 AI 推理等高负载任务时容易触发算力瓶颈应对高负载算法调试阶段可临时切换分布式架构。四、技术基础软硬件底层支撑硬件基础主控RDK X5 ARM64 8 核 A55支持本地编译外设接口USB3.0手柄、UART/CAN通信 STM32 底盘、MIPI 相机、雷达接口底盘M1 麦轮底盘 STM32 运动控制板负责底层电机闭环驱动。软件基础OSUbuntu 22.04 Jammy ARM64Desktop 完整版ROS2Humble Hawksbill兼容 TogetheROS.Bot同时完整安装开发包 运行时包完整 ARM 原生工具链gcc/g、python、git、cmake、colcon调试工具栈rqt 套件、ros2 cli 命令、jstest、串口调试工具硬件驱动适配预先适配手柄、雷达、IMU、麦轮底盘通信协议统一工作空间规范~/yahboomcar_ros2_ws分离源码目录与编译产物五、如何实现一机两用工程实现机制1. 镜像预构建双环境亚博预制镜像内置两套环境共存✅【开发组件】赋予开发机能力编译器、git、colcon、rqt、源代码✅【运行组件】赋予目标机能力ROS2 运行库、底盘驱动、launch 启动脚本2. 统一工作空间架构核心设计plaintext~/yahboomcar_ros2_ws ├── src # 源代码目录开发阶段修改代码 ├── build # 编译中间文件 ├── install # 编译产出ROS运行时加载程序 └── log工作流修改 src 源码 →colcon build本地编译 → install 目录生成可执行文件 → ROS 加载运行。 同一目录同时支撑代码开发和程序运行。3. 三种运行模式无缝切换同一硬件、同一套源码模式① 开发学习模式启用完整开发能力PC 远程 SSH 连接 RDK在线编辑源码 →局部编译→ 前台启动 launch 全开调试日志使用ros2 topic、rqt 监控整条通信链路 标准遥控数据流 USB 手柄 → /dev/input → joy_node → /joy → yahboom_joy_M1 → /cmd_vel → Mcnamu_driver_M1 → STM32 底盘电机模式② 集成测试模式开发工具保留专注整机验证代码冻结极少重新编译按需降低日志等级保留调试工具异常时快速抓取话题数据、日志用于长时间稳定性、场地实车测试。模式③ 独立样机验证模式偏向纯目标机形态配置 systemd 系统服务上电自动启动整套 ROS 遥控程序断开电脑、WiFi机器人独立运行。注意依旧保留开发工具属于测试样机不等同量产产品。4. 配套标准化工程规范规避常见问题环境变量自动化~/.bashrc自动加载 ROS 与工作空间环境新开终端无需重复 source硬件路径固化launch 文件使用/dev/input/by-id/固定手柄符号链接防止插拔后 js 编号漂移编译优化强制使用局部编译缓解 ARM 编译慢问题colcon build --packages-select yahboomcar_ctrl环境分级控制通过环境变量ROBOT_MODEdev/test控制日志、调试开关开发模式开启打印测试模式精简输出。六、整体系统分层架构【硬件层】RDK X5 主控 ├─ 输入外设USB 游戏手柄、激光雷达、MIPI 摄像头、IMU └─ 输出链路UART/CAN 总线 → STM32 底盘控制器 → 四个麦轮电机【操作系统层】Ubuntu22.04 ARM64 Linux ├─ Linux 内核设备驱动HID 手柄驱动、串口驱动、USB 驱动 ├─ 系统工具链开发能力gcc、cmake、git、python、colcon └─ 系统服务网络、权限管理、systemd 自启动管理【中间件层】ROS2 HumbleDDS 通信提供节点通信、话题、参数、日志框架所有节点本地进程通信不走外部网络 DDS 组播【业务应用层一体式双能力】开发能力模块源码目录管理、在线修改、本地编译、调试工具rqt、ros2 cli机器人运行业务节点/joy_node读取手柄发布 /joy/yahboom_joy_M1摇杆解析发布 /cmd_vel/Mcnamu_driver_M1麦轮运动学逆解下发指令到底盘可选雷达驱动、IMU 驱动、视觉 AI 节点、SLAM 导航节点【远程交互层】PCWindows/Ubuntu仅 SSH 远程登录作为终端显示器不参与运算。七、研发全生命周期流转建议前期预研PC Ubuntu Gazebo 仿真验证运动学、控制逻辑中期学习、真机迭代、功能验证一体式一机两用方案当前方案后期样机验收开启开机自启动模拟产品独立运行大规模商用量产环境分离 基于验证稳定源码构建最小化纯运行镜像删除源码、编译器、调试工具仅保留业务程序、运行依赖关闭多余账户与调试功能。