- 类别
- 框架与工具 · 厂商 SDK
- 开放程度
- 开源
- 发布时间
- 2023 年 9 月
- 开源协议
- BSD-3-Clause
- 发布方所在地
- 中国
项目简介
宇树科技第二代机器人开发接口,基于 CycloneDDS 通信,提供高层运动服务(站立、速度、姿态控制等)和底层关节电机、IMU、遥控器状态的读取与控制。C++ 版 unitree_sdk2 与 Python 版 unitree_sdk2_python 接口一致,覆盖 Go2、B2、A2、H1、H2、G1、R1 等机型,也是 unitree_ros2、unitree_mujoco 等宇树开源项目的通信基础。面向 Go1 / A1 的上一代 unitree_legged_sdk 已停更,并入本条。
Unitree SDK2 安装要点
来源:README.md依据官方资料的 main 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
安装依赖
README 针对 Ubuntu 20.04
apt-get update apt-get install -y cmake g++ build-essential libyaml-cpp-dev libeigen3-dev libboost-all-dev libfmt-dev编译示例
只跑仓库自带示例到这一步即可
mkdir build cd build cmake .. make安装到系统
自己的工程要用 SDK 时执行
mkdir build cd build cmake .. sudo make install安装到指定目录
和上一步二选一;其他目录要加进 CMAKE_PREFIX_PATH
mkdir build cd build cmake .. -DCMAKE_INSTALL_PREFIX=/opt/unitree_robotics sudo make install
环境要求
来源:README.md- 操作系统
- Ubuntu 20.04 LTS
- CPU
- aarch64、x86_64
- 编译器
- GCC 9.4.0
- CMake
- 3.10 或更高
- C++ 标准来源:CMakeLists.txt
- C++17
- 系统依赖
- yaml-cpp、Eigen3、Boost、fmt
适配矩阵
来源:example仓库 example 目录里有示例的机型,不代表完整的接口支持范围
| 名称 | 示例目录 |
|---|---|
| Go2 | example/go2 |
| Go2W | example/go2w |
| B2 | example/b2 |
| B2W | example/b2w |
| G1 | example/g1 |
| H1 | example/h1 |
| H2 | example/h2 |
| A2 | example/a2 |
| AS2 | example/as2 |
| R1 | example/r1 |
适配机器人
- Unitree Go2
- Unitree B2
- Unitree A2
- Unitree H1
- Unitree H1-2
- Unitree H2
- Unitree G1
- Unitree R1
