95 lines
2.6 KiB
Markdown
95 lines
2.6 KiB
Markdown
# OCS2 Quadruped Controller
|
|
|
|
This is a ros2-control controller based on [legged_control](https://github.com/qiayuanl/legged_control)
|
|
and [ocs2_ros2](https://github.com/legubiao/ocs2_ros2).
|
|
|
|
Tested environment:
|
|
|
|
* Ubuntu 24.04
|
|
* ROS2 Jazzy
|
|
* Ubuntu 22.04
|
|
* ROS2 Humble
|
|
|
|
* [x] **[2025-01-16]** Add support for ground truth estimator.
|
|
* [x] **[2025-03-15]** OCS2 Controller now can switch between passive and MPC mode.
|
|
|
|
|
|
[](https://www.bilibili.com/video/BV1UcxieuEmH/)
|
|
|
|
## 1. Interfaces
|
|
|
|
Required hardware interfaces:
|
|
|
|
* command:
|
|
* joint position
|
|
* joint velocity
|
|
* joint effort
|
|
* KP
|
|
* KD
|
|
* state:
|
|
* joint effort
|
|
* joint position
|
|
* joint velocity
|
|
* imu sensor
|
|
* linear acceleration
|
|
* angular velocity
|
|
* orientation
|
|
* feet force sensor
|
|
|
|
## 2. Build
|
|
|
|
### 2.1 Build Dependencies
|
|
Before install OCS2 ROS2, please follow the guide to install [Pinocchio](https://stack-of-tasks.github.io/pinocchio/download.html). **Don't use the pinocchio install by rosdep**!
|
|
|
|
**After installed Pinocchio**, follow below step to clone ocs2 ros2 library to src folder.
|
|
|
|
```bash
|
|
cd ~/ros2_ws/src
|
|
git clone https://github.com/legubiao/ocs2_ros2
|
|
|
|
cd ocs2_ros2
|
|
git submodule update --init --recursive
|
|
|
|
cd ..
|
|
rosdep install --from-paths src --ignore-src -r -y
|
|
```
|
|
|
|
### 2.2 Build OCS2 Quadruped Controller
|
|
|
|
```bash
|
|
cd ~/ros2_ws
|
|
colcon build --packages-up-to ocs2_quadruped_controller --symlink-install
|
|
```
|
|
|
|
## 3. Launch
|
|
|
|
supported robot description:
|
|
|
|
* Unitree
|
|
* go2_description
|
|
* go1_description
|
|
* a1_description
|
|
* aliengo_description
|
|
* b2_description
|
|
* Xiaomi
|
|
* cyberdog_description
|
|
* DeepRobotics
|
|
* lite3_description
|
|
* x30_description
|
|
* Anybotics
|
|
* anymal_c_description
|
|
|
|
### 3.1 Mujoco Simulation
|
|
> **Warm Reminder**: You need to launch [Unitree Mujoco C++ Simulation](https://github.com/legubiao/unitree_mujoco) before launch the controller.
|
|
```bash
|
|
source ~/ros2_ws/install/setup.bash
|
|
ros2 launch ocs2_quadruped_controller mujoco.launch.py pkg_description:=go2_description
|
|
```
|
|
|
|
### 3.2 Gazebo Launch
|
|
```bash
|
|
source ~/ros2_ws/install/setup.bash
|
|
ros2 launch ocs2_quadruped_controller gazebo.launch.py pkg_description:=go2_description
|
|
```
|
|
|
|
At the first launch, controller may compile the OCS2 model and generate the shared library. The compilation process may take a few minutes. After the compilation, restart the controller and the robot should stand up. Then you can use the keyboard or joystick to control the robot (Keyboard 2 or Joystick LB+A to Trot mode). |