Skip to content

gazebo.md

Latest commit

 

History

History
179 lines (123 loc) · 5.2 KB

gazebo.md

File metadata and controls

179 lines (123 loc) · 5.2 KB
title Gazebo Simulator
description Quadruped Simulation and Control
icon robot

System Requirements

Component Minimum Good/Recommended Ideal
CPU Intel i7 (10th gen) or AMD Ryzen 7-8 cores minimum Intel i9 (12th gen+) or AMD Ryzen 9-12 cores AMD Ryzen 9 7950X or Intel i9-13900K 16+ cores (24+ threads)
RAM 16 GB 32 GB 64 GB
GPU NVIDIA GTX 1660 Ti 6 GB VRAM NVIDIA RTX 3070 or RTX 4060 Ti 8-12 GB VRAM NVIDIA RTX 4080/4090 16+ GB VRAM with CUDA 11.8+
OS Ubuntu 22.04 Ubuntu 22.04 Ubuntu 22.04

It's ideal to have at least 128 GB SSD storage for the setup to run smoothly.

Checkout the video walkthrough here. More video tutorials coming soon.

Simulation Instructions

To get started with Gazebo and Unitree SDK, please install cyclonedds and ROS2 Humble first. You can find the installation steps here.

To install compilers and other tools to build ROS packages, run

sudo apt install ros-dev-tools

Install the following additional dependencies

sudo apt install ros-humble-rmw-cyclonedds-cpp
sudo apt install ros-humble-rosidl-generator-dds-idl

Set up your environment by sourcing the following file.

source /opt/ros/humble/setup.bash

If you don't have uv installed, use the following command to install it on your system.

curl -LsSf https://astral.sh/uv/install.sh | sh

Check if you have rosdep installed by running rosdep or rosdep --version. If it is not installed, run the following:

sudo apt-get update
sudo apt-get install python3-rosdep

Once you've successfully completed above steps, follow the following steps to start the gazebo simulation, generate SLAM map of the surrounding and start navigation.

Step 1: Clone the OM1-ros2-sdk repository:

git clone https://github.com/OpenMind/OM1-ros2-sdk.git

Step 2: Initialize rosdep by setting up the source list (this is only needed once per machine)

Note: Run 'sudo rosdep init' only if rosdep has not been initialized on this machine before. If it has, skip this line and start from 'rosdep update'.

cd OM1-ros2-sdk
sudo rosdep init
rosdep update
rosdep install --from-paths . --ignore-src -r -y

It automatically installs all system dependencies needed by the ROS packages in your current directory.

Step 3: Build all the packages:

colcon build

Once the build is successful, create a virtual environment and install the dependencies

uv venv --python 3.10
source .venv/bin/activate
uv pip install .

Now you should be able to launch the Gazebo Simulator.

Step 4: Open a terminal and run the following commands. You'll now be able to see the Gazebo and RViZ windows launch on your system.

source install/setup.bash
ros2 launch go2_gazebo_sim go2_launch.py

Note: You can skio Step 5 to Step 7 if you don't have Enterprise Plan Subscription. SLAM and Navigation are only supported as Premium features.

Step 5: Open a new terminal and run:

source install/setup.bash
ros2 launch go2_sdk sensor_launch.py use_sim:=true

This will bring up the om/path topic, enabling OM1 to understand the surrounding environment.

Step 6: Open a new terminal and run:

export PYTHONPATH=$PYTHONPATH:$(pwd)/.venv/lib/python3.10/site-packages
source install/setup.bash
ros2 launch orchestrator orchestrator_launch.py use_sim:=true

This will bring up the orchestrator, to consume data collected by om1_sensor for SLAM and Navigation.

Step 7: Run Zenoh Ros2 Bridge

To run the Zenoh bridge for the Unitree Go2, you need to have the Zenoh ROS 2 bridge installed. You can find the installation instructions in the Zenoh ROS 2 Bridge documentation

After installing the Zenoh ROS 2 bridge, you can run it with the following command:

zenoh-bridge-ros2dds -c ./zenoh/zenoh_bridge_config.json5

Step 8: Start OM1

Refer to the Installation Guide for detailed instructions.

Then add the optional Python CycloneDDS module to OM1, run

uv pip install -r pyproject.toml --extra dds

Setup your API key in .bashrc file and run your simulation agent:

Get your API key from the portal, and add it to bashrc

vi ~/.bashrc
export OM_API_KEY="<your_api_key>"

Now, run the simulation agent

uv run src/run.py simulation

Step 9: Teleoperate the robot in simulation

You can also use teleoperation to control the robot through your keyboard.

Switch back to OM1-ros2-sdk in a new terminal and run the following commands

source install/setup.bash
ros2 run teleop_twist_keyboard teleop_twist_keyboard

Use the keyboard controls displayed in the terminal to move the robot:

i - Move forward
, - Move backward
j - Turn left
l - Turn right
k - Stop
U/O/M/> - Move diagonally

Note: We don't have auto charging feature supported with Gazebo but it will be launched soon. Stay tuned!