Unitree GO2 ROS2 SDK安装与使用指南

项目概述

Unitree GO2 ROS2 SDK是一个非官方的ROS2支持包，专为Unitree GO2系列机器人（AIR/PRO/EDU版本）设计。该项目通过WebRTC（Wi-Fi）和CycloneDDS（以太网）协议为GO2机器人提供完整的ROS2功能集成。

核心特性

• 实时关节状态同步：实现机器人的实时运动状态监控
• IMU数据同步：实时获取机器人的惯性测量单元数据
• 游戏手柄控制：支持通过游戏手柄进行实时遥控操作
• LIDAR点云数据：将激光雷达数据转换为PointCloud2格式
• 摄像头流媒体：支持前向彩色摄像头数据流
• SLAM建图：集成slam_toolbox进行实时地图构建
• 自主导航：使用Nav2实现路径规划和自主导航
• 多机器人支持：支持同时连接和控制多个GO2机器人
• 物体检测：集成COCO检测器进行实时图像识别

系统要求

系统	ROS2版本	构建状态
Ubuntu 22.04	Iron	支持
Ubuntu 22.04	Humble	支持
Ubuntu 22.04	Rolling	支持

安装步骤

1. 克隆仓库

mkdir -p ros2_ws
cd ros2_ws
git clone --recurse-submodules https://gitcode.com/gh_mirrors/go/go2_ros2_sdk.git src

2. 安装依赖

sudo apt install ros-$ROS_DISTRO-image-tools
sudo apt install ros-$ROS_DISTRO-vision-msgs
sudo apt install python3-pip clang portaudio19-dev

3. 安装Python依赖

cd src
pip install -r requirements.txt
cd ..

4. 构建项目

source /opt/ros/$ROS_DISTRO/setup.bash
rosdep install --from-paths src --ignore-src -r -y
colcon build

Docker部署

项目支持通过Docker容器化部署：

cd docker
ROBOT_IP=<机器人IP> CONN_TYPE=<webrtc/cyclonedds> docker-compose up --build

使用指南

基本启动

1. 设置环境变量：

export ROBOT_IP="机器人IP"  # 多机器人时用逗号分隔
export CONN_TYPE="webrtc"   # 或 "cyclonedds"

2. 启动ROS2节点：

source install/setup.bash
ros2 launch go2_robot_sdk robot.launch.py

启动文件功能

robot.launch.py启动文件会同时启动以下服务和节点：

• robot_state_publisher：发布机器人状态
• ros2_go2_video：前向彩色摄像头数据流
• pointcloud_to_laserscan_node：点云转激光扫描
• go2_driver_node：GO2驱动节点
• lidar_to_pointcloud：激光雷达数据处理
• rviz2：可视化工具
• joy：游戏手柄驱动
• teleop_twist_joy：手柄到速度命令转换
• twist_mux：命令多路复用器
• foxglove_bridge：Foxglove数据桥接
• slam_toolbox：实时建图
• nav2：自主导航

SLAM建图教程

1. 使用画线胶带标记一个"停靠"矩形区域
2. 在rviz的SlamToolboxPlugin中选择"Start At Dock"
3. 使用手柄手动探索环境，观察地图数据积累
4. 完成建图后，在"Save Map"字段输入文件名并保存
5. 同时保存序列化地图文件

自主导航

1. 通过SlamToolboxPlugin加载已建地图
2. 使用rviz中的"Nav2 Goal"设置导航目标
3. 监控机器人自主导航到指定位置

物体检测功能

启动COCO检测器进行实时物体识别：

source install/setup.bash
ros2 run coco_detector coco_detector_node

查看检测结果：

ros2 topic echo /detected_objects

查看带标注的图像流：

ros2 run image_tools showimage --ros-args -r /image:=/annotated_image

多机器人协作

支持同时连接多个机器人进行协同工作：

export ROBOT_IP="机器人IP1,机器人IP2,机器人IPN"

连接协议切换

在WebRTC（Wi-Fi）和CycloneDDS（以太网）之间切换：

export CONN_TYPE="webrtc"  # 或 "cyclonedds"

3D点云数据保存

保存原始LIDAR数据用于调试：

export MAP_SAVE=True
export MAP_NAME="3d_map"

技术架构

项目采用Clean Architecture设计原则，包含以下主要模块：

• 应用层：服务和工具实现
• 领域层：实体、常量和数学计算
• 基础设施层：ROS2集成、传感器处理和WebRTC连接
• 表现层：驱动节点和用户界面

故障排除

常见问题

1. 关节状态更新延迟：新固件版本(v1.1.7)可能导致关节状态更新频率降至1Hz
2. 建图失真：长走廊环境可能导致地图变形，需手动校正
3. 导航异常：地图不准确或初始位置错误会导致导航失败

WSL2配置

在WSL2环境中使用需要额外配置游戏手柄支持，具体步骤参考项目文档。

致谢

特别感谢所有开源贡献者和TheRoboVerse社区的支持，特别是@tfoldi的WebRTC连接方法创新。

许可证

本项目采用BSD 2-clause许可证，详情请查看LICENSE文件。