具身开发者社区

外观

踩坑GitHub unitreerobotics/unitree_mujoco4 个月前

Unitree SDK H2踝关节顺序与MuJoCo仿真不一致 ​

H2机器人SDK中踝关节pitch/roll顺序错误导致与仿真不符，官方已修复SDK使其与文档及MuJoCo模型对齐。

AI 整理
  • 本体 SDK 与控制
  • 仿真与训练

本文由 AI 根据公开内容整理，可能有误，请以原文为准：H2 ankle joint order doesn't match Unitree SDK（GitHub unitreerobotics/unitree_mujoco #123）

状态：已解决

问题 ​

在unitree_mujoco仿真器中，H2左右踝关节的jointvel、jointpos及jointactuatorfrc数据顺序为ankle roll后接ankle pitch；而Unitree SDK示例代码及旧版实现中顺序相反（先pitch后roll），导致仿真与真机控制接口数据映射错位。

环境 ​

机型：Unitree H2；软件：unitree_mujoco (h2_mujoco.xml)、unitree_sdk2 (h2_ankle_swing_example.cpp)

解决办法 ​

  1. 确认H2踝关节正确顺序应为先ankle roll后ankle pitch，以MuJoCo模型定义和官方文档为准。
  2. 更新unitree_sdk2至最新版本，该版本已修正此前SDK中踝关节顺序反转的错误实现。
  3. 在算法开发与控制部署时，统一使用roll-pitch顺序进行状态读取与指令下发，避免依赖旧版SDK逻辑。

讨论原作者：@cosmith-nvidia 等，版权归原作者所有。

来源

本页事实对应的公开页面，以原文为准。

  1. GitHub unitreerobotics/unitree_mujoco #123：H2 ankle joint order doesn't match Unitree SDK访问 2026-10-23