前 言
本文档主要演示基于单板机/工控机的ROS系统（版本：ROS2 Humble）使用说明，包括ROS系统镜像编译、镜像替换，以及ROS系统测试的方法。
备注：本文适用于SBC-TL3588单板机及EPC-TL3588工控机系列（由SBC-TL3588单板机搭配扩展板与外壳组成），文中所有演示均基于4GByte LPDDR4X + 32GByte eMMC硬件配置的单板机开展。
开发环境
Windows开发环境：Windows10 64bit、Windows7 64bit
Linux开发环境：VMware16.2.5、Ubuntu22.04.4 64bit
系统版本：Tronlong-Desktop 22.04（类Ubuntu）、Linux-6.1.141、U-Boot 2017.09
sysroot：rk3588-Tronlong-Desktop-22.04-sysroot-版本号.tar.gz
应用开发交叉编译工具链：aarch64-linux-gnu-gcc（版本为11.4.0，通过网络下载）
ROS：ROS2 Humble
术语表
为便于阅读，下表对文档出现的关键术语进行解释；对于广泛认同释义的术语，在此不做注释。
注意事项
1、我司ROS系统源码基于ROS官方获取，并参考瑞芯微官方文档进行编译。更多信息请查看"6-开发参考资料\Rockchip官方参考文档\Linux\ApplicationNote\"目录下的《Rockchip_Instruction_Linux_ROS2_CN》文档。
2、无特殊说明，默认从eMMC启动系统，使用DEBUG作为调试串口，使用HDMI显示屏作为显示输出。
一、ROS系统测试
执行如下命令，配置单板机测试环境。
Target# export COLCON_CURRENT_PREFIX=/opt/ros/humble //设置COLCON_CURRENT_PREFIX环境变量，并将其值指向ROS2 Humble的安装目录
Target# source /opt/ros/humble/local_setup.sh //执行ROS2 Humble的环境设置脚本，从而将ROS2的命令、库路径、功能包信息等加载到当前的Shell会话中
图 1
1.1 基于Python的通信功能测试
执行如下命令，创建Log目录，用于保存ROS程序运行的Log。
Target# mkdir -p /root/.ros/log
图 2
执行如下命令，启动ROS节点订阅消息。
Target# ros2 run demo_nodes_py listener &
图 3
执行如下命令，启动ROS节点发布消息，实现订阅消息节点与发布消息节点之间的通信。此时单板机串口调试终端将会打印两节点间通信的信息，如下图所示。按"Ctrl + C"可退出测试程序，即让发布消息的节点退出。
Target# ros2 run demo_nodes_py talker
图 4
执行如下命令，根据系统进程号关闭所有ROS节点。进程号请以实际情况为准。
Target# ps -a
Target# kill 2244
Target# kill 2246
图 5
1.2 基于C++的通信功能测试
执行如下命令，创建Log目录，用于保存ROS程序运行的Log。
备注：若已创建Log目录，可跳过此步骤。
Target# mkdir -p /root/.ros/log
图 6
执行如下命令，启动ROS节点订阅消息。
Target# ros2 run demo_nodes_cpp listener &
图 7
执行如下命令，启动ROS节点发布消息，实现订阅消息节点与发布消息节点之间的通信。此时单板机串口调试终端将会打印两节点间通信的信息，如下图所示。按"Ctrl + C"可退出测试程序，即让发布消息的节点退出。
Target# ros2 run demo_nodes_cpp talker
图 8
执行如下命令，根据系统进程号关闭所有ROS节点。进程号请以实际情况为准。
Target# ps -a
Target# kill 2273
Target# kill 2274
图 9
1.3 turtlesim（小海龟）测试
执行如下命令，配置单板机测试环境。
备注：若已配置单板机测试环境，可跳过此步骤。
Target# export COLCON_CURRENT_PREFIX=/opt/ros/humble //设置COLCON_CURRENT_PREFIX环境变量，并将其值指向ROS2 Humble的安装目录
Target# source /opt/ros/humble/local_setup.sh //执行ROS2 Humble的环境设置脚本，从而将ROS2的命令、库路径、功能包信息等加载到当前的Shell会话中
图 10
执行如下命令，创建Log目录，用于保存ROS程序运行的Log。
备注：若已创建Log目录，可跳过此步骤。
Target# mkdir -p /root/.ros/log
图 11
执行如下命令，后台运行小海龟程序。
Target# ros2 run turtlesim turtlesim_node &
图 12
图 13
执行如下命令，发布话题消息，使小海龟转圈。
Target# ros2 topic pub --rate 1 /turtle1/cmd_vel geometry_msgs/msg/Twist "{linear: {x: 2.0, y: 0.0, z: 0.0}, angular: {x: 0.0, y: 0.0, z: 1.8}}"
图 14
参数解析：
ros2 topic pub：发布消息到主题；
--rate 1：发布消息速率，设置为1次每秒；
/turtle1/cmd_vel：主题名称；
geometry_msgs/msg/Twist：发布消息类型；
{linear: {x: 2.0, y: 0.0, z: 0.0}, angular: {x: 0.0, y: 0.0, z: 1.8}}：发布消息的内容，线速度(linear)为x方向上的2.0、角速度(angular)为z轴方向上的1.8。
图 15
二、ROS开发
请先参考《开发环境搭建》文档进行VMware虚拟机与Ubuntu安装，并参考《应用开发手册》文档正确安装sysroot。本小节主要演示基于上位机Ubuntu的ROS系统编译与镜像制作方法。
2.1 开发环境搭建
打开Ubuntu终端，执行如下命令，安装编译所需的colcon工具。
**Host#**sudo apt install curl
**Host#**sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg
图 16
因网络问题，下载GPP密钥可能会失败，若无法下载，可将产品资料"4-软件资料/Demo/other"目录下的ros-archive-keyring.gpg文件拷贝到Ubuntu系统"/usr/share/keyrings/"目录。执行如下命令，安装ros工具。
**Host#**sudo cp ros-archive-keyring.gpg /usr/share/keyrings/
**Host#**sudo echo "deb arch=amd64 signed-by=/usr/share/keyrings/ros-archive-keyring.gpg https://mirrors.tuna.tsinghua.edu.cn/ros2/ubuntu jammy main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null
**Host#**sudo apt update
**Host#**sudo apt install ros-humble-ros-base -y
图 17
图 18
图19
执行如下命令，安装编译所需的colcon工具。
Host# curl -s https://packagecloud.io/install/repositories/dirk-thomas/vcstool/script.deb.sh | sudo bash //下载并运行vcstool的安装脚本
**Host#**sudo apt update //更新软件包列表
**Host#**sudo apt-get install -y python3-pip python3-rosdep2 python3-rosinstall-generator python3-vcstool build-essential //安装ROS2开发所需的工具和依赖
**Host#**pip3 install -U colcon-common-extensions //安装colcon-common-extensions工具
**Host#**pip3 uninstall empy //卸载旧版empy包
**Host#**pip3 install empy==3.3.4 //安装指定版本3.3.4的empy包
图 20
图 21
图 22
图23
执行如下命令，配置环境变量。
**Host#**export PATH=${PATH}:/home/tronlong/.local/bin //将用户本地bin目录添加到PATH环境变量
图 24
2.2 编译ROS软件包
请根据交叉编译工具链实际解压路径，执行如下命令，配置交叉编译工具链。
**Host#**source /home/tronlong/RK3588/environment //配置交叉编译工具链环境变量
**Host#**source /opt/ros/humble/local_setup.bash //执行ROS2的本地安装脚本，配置ROS2的运行环境
图 25
执行如下命令，创建ROS软件包的工作目录，并进入该目录，目录可命名为任意名称。
**Host#**mkdir ros2_project_test
**Host#**cd ros2_project_test
图 26
执行如下命令，创建ROS软件包源码目录，并进入该目录。
**Host#**mkdir src
**Host#**cd src
图 27
执行如下命令，在源码目录下生成my_package包。本案例以构建CPP功能包为例，如需构建Python功能包可将参数ament_cmake改为ament_python。
**Host#**ros2 pkg create --build-type ament_cmake --node-name my_node my_package //建一个名为my_package的ROS软件包
图 28
参数解析：
--build-type ament_cmake ：指定软件包的构建类型为ament_cmake。
--node-name my_node：为软件包指定了一个my_node节点。
--my_package：软件包的名称为my_package。
完成构建后，ROS软件包源码目录结构如下所示。可根据实际需要对"my_package/src/my_node.cpp"进行修改。
图 29
返回ROS软件包工作目录，编译软件包。
**Host#**cd ..
**Host#**colcon build
图 30
编译完成后在当前目录下生成如下目录，目录内容如下表所示。
图 31
2.3 ROS软件测试
请将完成编译的ROS软件包中install目录拷贝至单板机系统"/opt/ros/humble"目录下，执行如下命令配置ROS的运行环境与命令行工具。
Target# export COLCON_CURRENT_PREFIX=/opt/ros/humble //设置当前ROS工作空间前缀为Humble安装路径
Target# source /opt/ros/humble/local_setup.sh //执行ROS2的本地安装脚本，配置ROS2的运行环境
图 32
执行如下命令，加载ROS软件包环境。
Target# export COLCON_CURRENT_PREFIX=/opt/ros/humble/install //设置当前ROS工作空间前缀为ROS软件包安装路径
Target# source /opt/ros/humble/install/local_setup.sh //执行ROS2的本地安装脚本，配置ROS2的运行环境
图 33
执行如下命令，运行ROS软件包，可以看到当前ROS软件包程序运行打印结果。
Target# ros2 run my_package my_node //运行自定义节点my_node
图 34