Simulation

Overview

You can launch Gazebo and RViz individually, or launch RViz together with the physical hardware.

1. Prepare the Open Manipulator Docker Container

Refer to the Setup Guide to configure the ROBOTIS Hand Docker Container environment.

2. Enable GUI Access

Open a new terminal and run the following command:

xhost +

3. Access the Running Container

./docker/container.sh enter

4. Launch Gazebo

• Launch Gazebo simulation:

  ros2 launch robotis_hand_bringup hx5_d20_right_gazebo.launch.py

• View model in RViz only: Use this command when you want to visualize the robot model in RViz without running a full simulation or the physical hardware.

  ros2 launch robotis_hand_description hx5_d20_right.launch.py

• Launch RViz with physical hardware: Use this command when you want to operate the physical ROBOTIS Hand hardware and monitor its status in RViz. This command will launch RViz alongside the hardware interface.

  ros2 launch robotis_hand_bringup hx5_d20_right.launch.py start_rviz:=true

  • Note: This command is the same as the visualization launch command in the Operation Guide.

Simulation Views

Left Hand

Right Hand

Launch Moveit

• Launch Moveit: You can use the following command to launch Moveit for ROBOTIS Hand:

  ros2 launch robotis_hand_moveit_config hx5_d20_right_moveit.launch.py

  If you are using Gazebo, you should add the argument use_sim:=true:

  ros2 launch robotis_hand_moveit_config hx5_d20_right_moveit.launch.py use_sim:=true