- 类别
- 框架与工具 · 厂商 SDK
- 开放程度
- 开源
- 发布时间
- 2023 年 10 月
- 开源协议
- BSD-3-Clause
- 发布方所在地
- 中国
项目简介
宇树科技新一代机器人的 ROS 2 支持包。unitree_sdk2 与 ROS 2 都基于 DDS 通信,Go2、B2、H1、G1 等机型可直接用 ROS 2 消息通信和控制,无需封装 SDK。仓库提供 unitree_go、unitree_hg、unitree_api 消息包,以及读取运动状态、底层电机和遥控器状态,发送高层运动请求、G1 底层控制和 rosbag 录制等示例,支持 ROS 2 Foxy 和 Humble。ROS 1 仿真包见 unitree_ros。
unitree_ros2 安装要点
来源:README.md依据官方资料的 master 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
克隆仓库
git clone https://github.com/unitreerobotics/unitree_ros2安装依赖
README 以 foxy 为例,其他发行版替换名字
sudo apt install ros-foxy-rmw-cyclonedds-cpp sudo apt install ros-foxy-rosidl-generator-dds-idl sudo apt install libyaml-cpp-dev编译 cyclonedds
Humble 可跳过;编译前不要 source ROS2 环境
cd ~/unitree_ros2/cyclonedds_ws/src git clone https://github.com/ros2/rmw_cyclonedds -b foxy git clone https://github.com/eclipse-cyclonedds/cyclonedds -b releases/0.10.x cd .. colcon build --packages-select cyclonedds编译 unitree_go 和 unitree_api
source /opt/ros/foxy/setup.bash colcon build配置网卡
把 setup.sh 里的 enp3s0 改成实际网卡
sudo gedit ~/unitree_ros2/setup.sh source ~/unitree_ros2/setup.sh连接并测试
官方建议测试前先重启电脑
source ~/unitree_ros2/setup.sh ros2 topic list
环境要求
来源:README.md- Ubuntu 22.04
- ROS2 humble(官方推荐)
- Ubuntu 20.04
- ROS2 foxy
- CycloneDDS
- 0.10.2,Humble 可跳过编译
- RMW
- rmw_cyclonedds_cpp
- 网络
- 网口 IPv4 手动设 192.168.123.99,掩码 255.255.255.0
适配矩阵
来源:README.md各机型有哪些官方示例,空格表示 README 示例列表没有提到
| 名称 | 底层控制 | 读底层状态 | 读运动状态 | 读遥控器 | 高层控制 |
|---|---|---|---|---|---|
| Go2 | ✓ | ✓ | ✓ | ✓ | ✓ |
| B2 | ✓ | ✓ | ✓ | ✓ | — |
| G1 | ✓ | ✓ | — | ✓ | — |
| H1 | — | ✓ | — | — | — |
| H1-2 | ✓ | ✓ | — | — | — |
✓ 官方资料写明支持,— 资料没写。没写不等于不支持。
适配机器人
- Unitree Go2
- Unitree B2
- Unitree H1
- Unitree H1-2
- Unitree G1
