MIT Cheetah-Software 四足机器人控制入门指南
2026-02-04 05:07:20作者:瞿蔚英Wynne
项目概述
MIT Cheetah-Software 是一个用于控制四足机器人的开源软件系统,特别为MIT研发的Mini Cheetah和Cheetah 3机器人设计。该系统提供了完整的仿真环境和硬件控制接口,使研究人员能够快速开发和测试各种控制算法。
环境配置
系统依赖安装
在Ubuntu系统上,需要先安装以下基础依赖包:
sudo apt install mesa-common-dev freeglut3-dev coinor-libipopt-dev libblas-dev liblapack-dev gfortran liblapack-dev coinor-libipopt-dev cmake gcc build-essential libglib2.0-dev
对于较新版本的Ubuntu(18.10或19.04),Qt可以通过以下方式安装:
sudo apt install libqt5 libqt5gamepad5
第三方库要求
系统还需要以下三个关键库:
- LCM:轻量级通信库,版本1.3.1或更高
- Qt:图形界面框架,需要5.10.0或更高版本,且必须包含gamepad库
- Eigen:线性代数库
代码构建流程
- 获取代码仓库
- 进入项目目录
- 执行类型生成脚本
- 创建并进入build目录
- 使用CMake生成构建系统
- 使用make进行编译
cd scripts
./make_types.sh
cd ..
mkdir build
cd build
cmake ..
make -j
测试验证
编译完成后,可以通过运行common/test-common来执行基础测试。需要注意:
- OSQP测试可能因求解器非确定性而偶尔失败,重新运行即可
- CASADI测试可能因动态库加载问题失败,这不会影响基本功能
控制器硬件配置
系统推荐使用Logitech F310游戏手柄作为控制输入设备,使用时需注意:
- 手柄背面的开关应置于"X"位置
- 更改开关位置后需要重新连接设备
- 模式按钮附近的LED指示灯应保持熄灭状态
仿真环境使用指南
配置文件说明
仿真器有两个主要配置文件:
simulator-defaults.yaml:仿真器默认参数default-terrain.yaml:地形配置,可添加障碍物和调整地面摩擦系数
启动流程
- 连接游戏手柄
- 运行
sim/sim启动仿真器 - 选择"Mini Cheetah"和"Simulator"
- 点击"Start"按钮
控制模式切换
- 启动MIT控制器:
user/MIT_Controller/mit_ctrl m s - 在仿真器中将控制模式设为10(准备状态)
- 待机器人停止移动后,设为模式1
- 最后设为模式4,机器人将开始小跑步态
视图操作技巧
- 点击拖动:调整视角
- 滚轮:缩放视图
- 按住
t键:最大速度运行仿真 - 空格键:切换自由相机模式
- W/A/S/D/R/F键:移动相机位置
开发自定义控制器
项目结构
自定义控制器应放置在user目录下,并需要修改user/CMakeLists.txt添加编译配置。可以参考JPos_Controller示例项目。
控制器基类
自定义控制器需要继承RobotController基类,并实现以下关键方法:
runController:主控制循环,默认1kHz频率getUserControlParameters:返回用户参数指针(如不使用返回nullptr)
可用资源
在控制器中可访问以下重要资源:
_quadruped:机器人常量参数(连杆长度、齿轮比、惯量等)_model:机器人动力学模型_legController:腿部控制接口_stateEstimate:状态估计结果_driverCommand:游戏手柄输入_controlParameters:控制参数_visualizationData:调试可视化接口
腿部控制方式
_legController提供多种控制模式,所有控制器的输出将被叠加:
- 关节扭矩控制(
tauFeedForward) - 足端力控制(
forceFeedForward) - 关节位置PD控制(
qDes+qdDes) - 笛卡尔空间PD控制(
pDes+vDes)
硬件部署注意事项
在实际机器人上运行时,与仿真环境的主要区别包括:
- 只能看到状态估计结果,无法使用"cheater模式"
- 调试可视化功能不可用
- 需要特别注意安全检查和故障处理
开发建议
- 先在仿真环境中充分测试算法
- 逐步增加控制复杂度,从简单的位置控制开始
- 充分利用LCM工具进行调试和数据记录
- 注意控制频率和实时性要求
- 开发过程中定期检查机器人状态估计的准确性
通过本指南,开发者可以快速上手MIT Cheetah-Software系统,并基于此开发自己的四足机器人控制算法。系统提供了从仿真到硬件部署的完整工具链,大大降低了四足机器人控制算法的开发门槛。
登录后查看全文
热门项目推荐
相关项目推荐
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0222
cann-learning-hubCANN 学习中心仓,支持在线互动运行、边学边练,提供教程、示例与优化方案,一站式助力昇腾开发者快速上手。Jupyter Notebook0142
uni-appA cross-platform framework using Vue.jsJavaScript09
GLM-5.2智谱开源 GLM-5.2,这是针对长文本任务的最新旗舰模型。相较于前代产品 GLM-5.1,它在长文本任务处理能力上实现了显著飞跃,并且首次在稳定的 100 万 token 上下文中提供这一能力。Jinja00
SwanLab⚡️SwanLab - an open-source, modern-design AI training tracking and visualization tool. Supports Cloud / Self-hosted use. Integrated with PyTorch / Transformers / LLaMA Factory / veRL/ Swift / Ultralytics / MMEngine / Keras etc.Python00
tiny-universe《大模型白盒子构建指南》:一个全手搓的Tiny-UniverseJupyter Notebook03
项目优选
收起
openEuler内核是openEuler操作系统的核心,既是系统性能与稳定性的基石,也是连接处理器、设备与服务的桥梁。
C
470
467
deepin linux kernel
C
32
16
暂无描述
Dockerfile
781
5.09 K
Ascend Extension for PyTorch
Python
759
969
本项目是CANN提供的神经网络类计算算子库,实现网络在NPU上加速计算。
C++
703
1.41 K
Claude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed.
Get Started
Rust
2.12 K
222
本项目是CANN提供的transformer类大模型算子库,实现网络在NPU上加速计算。
C++
885
2.03 K
本仓库是 Flutter SDK 与 Flutter Engine 的 OpenHarmony 适配版本,由 CPF-Flutter 团队维护。开发者可使用熟悉的 Flutter 技术栈开发 OpenHarmony 应用,3.35.7 及以后的适配版本可基于本仓库源码构建支持 OpenHarmony 的 Flutter Engine。
Dart
1.04 K
272
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
C
462
5.48 K
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
1.1 K
1.15 K