10个常见问题解决方案：Cheetah-Software四足机器人控制软件完全指南

Cheetah-Software是麻省理工学院开发的开源四足机器人控制软件，专为Mini Cheetah和Cheetah 3机器人设计。这套先进的四足机器人控制软件包含了完整的运动规划、状态估计和实时控制功能，让开发者能够快速上手四足机器人开发。

🔧 安装与编译问题解决

1. 依赖安装失败问题

在Ubuntu系统中安装依赖时，常见的问题是包版本不匹配或网络连接问题。解决方案：

• 更新包列表：sudo apt update
• 安装完整依赖包组
• 对于Qt安装，可以尝试使用系统包管理器而非官方安装器

2. CMake配置警告处理

项目编译时经常出现CMake警告，这些通常是良性的：

• 忽略关于Java版本的警告
• IPOPT和CASADI相关警告不影响核心功能
• OSQP求解器的非确定性行为是正常现象

🎮 控制器连接与配置

3. 游戏手柄无法识别

使用Logitech F310控制器时，确保：

• 背部开关处于"X"位置
• 连接控制器后不要更改开关位置
• 前面板模式按钮旁的LED应处于关闭状态

4. 仿真器启动问题

从build文件夹运行仿真器时常见问题：

• 确保已插入游戏手柄
• 选择"Mini Cheetah"和"Simulator"
• 点击"Start"开始仿真

🤖 机器人硬件连接

5. Mini Cheetah启动流程

正确启动Mini Cheetah的步骤：

1. 先开启计算机电源（等待约2分钟启动）
2. SSH连接：ssh user@10.0.0.34
3. 配置网络适配器用于LCM通信

6. 代码部署到机器人

构建并传输代码到机器人：

mkdir mc-build && cd mc-build
cmake -DMINI_CHEETAH_BUILD=TRUE ..
make -j
../scripts/send_to_mini_cheetah.sh user/yourController/your_controller

📊 状态估计与传感器

7. 状态估计器工作异常

当前软件支持：

• 仅姿态估计（通过_stateEstimate访问）
• 腿部控制（扭矩前馈、力前馈、笛卡尔PD控制、关节PD控制）
• 游戏手柄数据
• 控制参数

8. 缺失的功能识别

目前不支持的功能包括：

• 完整状态估计器（位置、速度）
• 完整可视化数据
• 在机器人上运行时作弊模式

💻 自定义控制器开发

9. 创建新的机器人控制器

在Cheetah-Software/user目录下添加新文件夹：

• 参考JPos_Controller作为简单控制器示例
• 在user目录的CMakeLists.txt中添加新文件夹
• 控制器应继承RobotController基类

10. 控制器调试技巧

有效调试方法：

• 使用LCM spy工具监控数据流
• 通过_visualizationData添加调试可视化
• 利用游戏手柄和用户参数进行实时调整

🚀 性能优化建议

仿真速度提升

• 按住t键使仿真以最快速度运行
• 使用空格键开启自由相机模式
• 调整simulation_speed参数

控制频率调整

• 通过controller_dt设置更改控制代码运行频率
• 注意：更改此参数后需要重新测试

通过掌握这些常见问题的解决方案，您将能够更顺利地使用Cheetah-Software进行四足机器人开发。这套机器人控制软件提供了强大的基础架构，让您能够专注于高级控制算法的开发。

记住，遇到问题时首先检查文档和现有示例，大多数问题都有成熟的解决方案。Happy coding! 🤖