yahboom
HomeTutorialsProduct
Solution
Blog
Online Store
About Us
EN/中文
Store
Jetson Orin NANO Developer Kit📖
01.Get started
  • 01. Learning route
  • 02. Get started quickly
  • 03. System Update Notes
  • 04. Disabling automatic updates and troubleshooting issues
  • 05. Jetson Orin Nano official kit screwdriver instructions
02.Jetson basic course
  • 01.Jetson board introduction
  • 02.Write Jetson original system
  • 03.Installing Jetson environment
  • 04.Backup SSD system
  • 05.Restore initial image system
  • 06.Upgrade to SUPER version (Optional)
  • 07.Write SUPER boot (Must read)
  • 08.SSD expansion
  • 09.Jetpack old system upgraded to Yahboom SUPER factory system
  • 10.Write the system onto your own SSD
03.Basic setting course
  • 01.Basic knowledge
  • 02.Network configuration
  • 03.SSH remote login
  • 04.VNC remote control
  • 05.RDP remote control
  • 06.Remote file transfer
  • 07.Jtop tool
  • 08.Exchange space expansion
  • 09.Use VSCode
  • 10.Use VMware
  • 11.Modify screen resolution
04.GPIO control course
  • 01.GPIO description
  • 02.GPIO library installation
  • 03.GPIO reading
  • 04.GPIO output
  • 05.Serial communication
  • 06.I2C communication
05.Vision basic course
  • 01.CSI camera preview
  • 02.USB camera preview
  • 03.Use Jupyter Lab
  • 04.Use JetCam
06.OpenCV basic course
  • 01.Image reading
  • 02.Image saving
  • 03.Image modification
  • 04.Image scaling
  • 05.Image cropping
  • 06.Image translation
  • 07.Image mirroring
  • 08.Image grayscale conversion
  • 09.Image binarization
  • 10.Image edge detection
  • 11.Add line segments
  • 12.Add rectangles
  • 13.Add circular shape
  • 14.Add ellipses
  • 15.Add polygons
  • 16.Add Text
  • 17.Preview USB camera image
  • 18.Preview CSI camera image
07.Vision advanced course
01.Environment construction
  • 01.TensorFlow
  • 02.PyTorch
  • 03.Torchvision
02.DeepStream development
  • 01.DeepStream environment
  • 02.License plate detection and recognition
  • 03.Parallel multi-model inference
  • 04.Object embedding vector generation
  • 05.Pose recognition
  • 06.NV optical flow anomaly detection
  • 07.Single-view 3D tracking
  • 08.Multi-view 3D tracking
03.NVIDIA TAO toolkit application
  • 01.Traffic scene object detection
  • 02.Person object detection
  • 03.Vehicle brand classification
  • 04.Vehicle model classification
  • 05.License plate detection and recognition
  • 06.Person semantic segmentation
  • 07.Retail product detection and recognition
  • 08.Person feature extraction and matching (ReID)
  • 09.Person action and pose classification
  • 10.Transformer-based person detection
  • 11.3D human skeleton detection
  • 12.LiDAR 3D point cloud detection
04.YOLO11 development
  • 01.YOLO environment construction
  • 02.CLI use
  • 03.Object detection
  • 04.Instance segmentation
  • 05.Pose estimation
  • 06.Image classification
  • 07.Oriented object detection
  • 08.Model conversion
  • 09.Dataset annotation
  • 10.Model training conversion
  • 11.Model prediction
05.Mediapipe development
  • 01.Mediapipe environment
  • 02.Hand detection
  • 03.Face detection
  • 04.Face effects
  • 05.3D object recognition
  • 06.Virtual brush
  • 07.Gesture recognition
  • 08.Finger control
  • 09.Posture estimation
  • 10.Face mask
  • 11.Overall detection
  • 12.Green scene removal(Human)
06.YOLO26 development
  • 01.YOLO environment construction
  • 02.CLI use
  • 03.Object detection
  • 04.Instance segmentation
  • 05.Pose estimation
  • 06.Image classification
  • 07.Oriented object detection
  • 08.Model conversion
  • 09.Dataset annotation
  • 10.Model training conversion
  • 11.Model prediction
07.QR code recognition
  • QR code recognition
08.Docker basic course
  • 01.Docker introduction
  • 02.Docker installation
  • 03.Docker command
  • 04.Docker usage
  • 05.Docker interaction
09.ROS2-Jazzy
01.ROS2 basic course
  • 1.Introduction to ROS2
  • 2.ROS2 install Jazzy
  • 3.ROS2 development environment
  • 4.ROS2 workspace
  • 5.ROS2 function package
  • 6.ROS2 node
  • 7.ROS2 topic communication
  • 8.ROS2 service communication
  • 9.ROS2 action communication
  • 10.ROS2 custom interface message
  • 11.ROS2 parameter service case
  • 12.ROS2 meta-function package
  • 13.ROS2 distributed communication
  • 14.ROS2 DDS
  • 15.ROS2 time related API
  • 16.ROS2 common command tools
  • 17.ROS2 rviz2 use
  • 18.ROS2 rqt toolbox
  • 19.ROS2 Launch startup file configuration
  • 20.ROS2 recording and playback tool
  • 21.ROS2 URDF model
  • 22.ROS2 Gazebo simulation platform
  • 23.ROS2 TF2 coordinate transformation
02.ROS2 vision course
  • 01.Camera preview (USB)
  • 02.Camera preview (CSI)
  • 03.Camera calibration (USB)
  • 04.Camera calibration (CSI)
  • 05.AR vision (USB)
  • 06.AR vision (CSI)
10.Large model basic course
01.Offline large model
  • 01.AI large model environment deployment
  • 02.Install large model dialogue platform
  • 03.Meta AI - Llama model
  • 04.Alibaba Cloud - Qwen model
  • 05.Microsoft - Phi-4-mini model
  • 06.DeepSeek - DeepSeek model
  • 07.Alibaba Cloud - Qwen-VL visual multimodal large model
  • 08.Google - Gemma visual multimodal large model
  • 9.Llava visual multimodal large model
  • 10.MiniCPM-V visual multimodal large model
  • 11.High-quality vision-language grounding (LocateAnything)
02.Online large model
  • 01.Tongyi Qianwen large model
  • 02.OpenRouter large model API aggregation platform
11.Large model application practice
01.Voice interaction application
  • 1.Voice interaction hardware connection (Must read)
  • 2.Offline speech to text (ASR)
  • 3.Offline text to speech (TTS)
  • 4.AI large model voice interaction
  • 5.AI large model offline voice assistant
02.Multimodal large model application (Online_Offline large model + Text_Voice interaction)
  • 01.Multimodal visual understand application
  • 02.Multimodal text image application
  • 03.Multimodal video analysis application
  • 04.Multi module visual position application
  • 05.Multimodal table scanning application
  • 06.Multimodal autonomous agent application
12.NVIDIA Isaac ROS course
  • 01.Build Isaac ROS environment
  • 02.Deep segmentation
  • 03.DNN stereoscopic depth
  • 04.Free space segmentation
  • 05.Image distortion processing
  • 06.Image segmentation
  • 07.3D scene reconstruction and mapping
  • 08.Object detection
  • 09.3D attitude estimation
  • 10.Visual SLAM
13.OpenClaw deployment and basic usage
01.OpenClaw deployment and introduction
  • 01.Quick start with the pre-configured environment (Recommended)
  • 02.OpenClaw Deployment
  • 03.OpenClaw WhatsApp Plugin Application
  • 04.OpenClaw WebChat Interaction
  • 05.OpenClaw TUI Interaction
  • 06.OpenClaw Tools Introduction
  • 07.OpenClawGate Gateway User Manual
  • 08.OpenClaw Features Overview
  • 09.OpenClawHub Introduction (Skill Installation)
02.OpenClaw basic application
  • 01.OpenClaw Application - File Management
  • 02.OpenClaw Application - Camera
  • 03.OpenClaw Application - Browser Control
  • 04.OpenClaw Application - Script Execution
  • 05.OpenClaw Application - AI Programming (Peripheral & GPIO Control)
  • 06.OpenClaw Application - Dedicated AI Assistant
  • 07.OpenClaw Web Search Capability Configuration
03.NVIDIA official Agent Skills application
  • 01.AI-assisted development with VS Code or Cursor
  • 02.Jetson device skills
  • 03.Jetson BSP custom agent skills
14.OpenClaw advanced development
01.Preparation Before Use
  • 01.Peripheral Hardware Configuration
  • 02.OpenClaw API-KEY Configuration
  • 03.OpenClaw Model Switching
  • 04.OpenClaw Prompts
  • 05.AI Voice Interaction Configuration
  • 06.Three Dialogue Configuration Tests
02.OpenClaw AI Programming Peripheral Control
  • 1. Servo Control
  • 2. RGB Strip
  • 3. OLED Display
  • 4. Temperature and Humidity Sensor
  • 5. Camera Application
  • 6. AI Script Peripheral Control
03.OpenClaw Peripheral Integration Applications
  • 1. Plant Care Assistant
  • 2. AI Calorie Estimation
  • 3. AI Rock Paper Scissors Game
  • 4. AI Pet
  • 5. AI Weather Station
  • 6. Temperature Humidity Dashboard
  • 7. Scheduled Tasks
Download
  • System_File
  • VMFile_BootFile
  • 3D Model File
  • DataSheet
  • Software_Tools
  • Code
  • Manual
Download ZIP

Welcome to Jetson Orin NANO Developer Kit repository

22.ROS2 Gazebo simulation platform

22. ROS 2 Gazebo Simulation Platform

1. Introduction to Gazebo

Gazebo is a commonly used 3D physics simulation platform in robot development. It can simulate robots, sensors, environments, and dynamics. This tutorial uses Gazebo Harmonic (Gazebo Sim 8), which is bundled with Ubuntu 24.04 and ROS 2 Jazzy, and is integrated with ROS 2 through ros_gz.

Gazebo Classic is no longer maintained. The gazebo_ros, spawn_entity.py, libgazebo_ros_init.so, and libgazebo_ros_factory.so used in the Humble tutorial belong to Gazebo Classic and cannot continue to be used in the Jazzy environment of this chapter.

2. Installation and Environment Check

First load the ROS 2 Jazzy environment:

source /opt/ros/jazzy/setup.bash

Install the ROS 2 and Gazebo integration package:

xxxxxxxxxx
sudo apt update
sudo apt install ros-${ROS_DISTRO}-ros-gz

Check the installation result:

xxxxxxxxxx
gz sim --versions
ros2 pkg prefix ros_gz_sim

The adapted version of this tutorial is Gazebo Sim 8 / Gazebo Harmonic. Start an empty world:

xxxxxxxxxx
gz sim -r empty.sdf

empty.sdf is an empty world resource already installed with Gazebo. Do not directly execute gz sim -s -r world.sdf unless world.sdf really exists in the current directory or in the Gazebo resource path; otherwise it reports Unable to find or download file.

The Gazebo GUI is recommended to run in the VNC graphical desktop. When the SSH or RDP terminal does not have a correct DISPLAY, you can check with the server-only mode:

xxxxxxxxxx
gz sim -s -r empty.sdf

Devices with small memory should not start multiple Gazebo instances at the same time; close other simulation worlds such as TurtleBot3 before testing this chapter.

3. Relationship Between Gazebo and ROS 2

Gazebo Harmonic internally uses Gazebo Transport for communication. When only gz sim is running, Gazebo nodes do not necessarily appear in ros2 node list, which is normal. When topics need to be passed between ROS 2 and Gazebo, ros_gz_bridge should be started according to the message type; this chapter uses ros_gz_sim create to load the model directly into Gazebo.

You can check the Gazebo entity creation service with the following command:

xxxxxxxxxx
gz service -l | grep create

4. Creating a Package

Enter the source directory of the ROS 2 workspace and create the myrobot package:

xxxxxxxxxx
source /opt/ros/jazzy/setup.bash
mkdir -p ~/workspace/src
cd ~/workspace/src
ros2 pkg create myrobot --build-type ament_cmake \
  --dependencies launch launch_ros ros_gz_sim
cd myrobot
mkdir -p launch urdf

Create demo01_base.urdf in the urdf directory. This example sets the red material directly in the visual of the URDF and no longer uses the Gazebo/Red material script of Gazebo Classic:

xxxxxxxxxx
<?xml version="1.0"?>
<robot name="myrobot">
  <link name="base_link">
    <visual>
      <origin xyz="0 0 0" rpy="0 0 0"/>
      <geometry>
        <box size="0.2 0.2 0.2"/>
      </geometry>
      <material name="red">
        <color rgba="1 0 0 1"/>
      </material>
    </visual>
    <collision>
      <origin xyz="0 0 0" rpy="0 0 0"/>
      <geometry>
        <box size="0.2 0.2 0.2"/>
      </geometry>
    </collision>
    <inertial>
      <mass value="0.1"/>
      <inertia ixx="0.0006667" ixy="0" ixz="0"
               iyy="0.0006667" iyz="0" izz="0.0006667"/>
    </inertial>
  </link>
</robot>

5. Writing the Launch File

Create bringup_model.launch.py in the launch directory. This launch file first calls the Gazebo launch file provided by ros_gz_sim, and then uses the create program to load the URDF model:

​x
import os

from ament_index_python.packages import get_package_share_directory
from launch import LaunchDescription
from launch.actions import DeclareLaunchArgument, IncludeLaunchDescription
from launch.launch_description_sources import PythonLaunchDescriptionSource
from launch.substitutions import LaunchConfiguration
from launch_ros.actions import Node


def generate_launch_description():
    package_share = get_package_share_directory("myrobot")
    urdf_model_path = os.path.join(
        package_share, "urdf", "demo01_base.urdf"
    )

    gz_args = DeclareLaunchArgument(
        "gz_args",
        default_value="-r -v 3 empty.sdf",
        description="Launch arguments passed to Gazebo Sim",
    )

    start_gazebo = IncludeLaunchDescription(
        PythonLaunchDescriptionSource(
            os.path.join(
                get_package_share_directory("ros_gz_sim"),
                "launch",
                "gz_sim.launch.py",
            )
        ),
        launch_arguments={"gz_args": LaunchConfiguration("gz_args")}.items(),
    )

    spawn_model = Node(
        package="ros_gz_sim",
        executable="create",
        arguments=[
            "-name", "myrobot",
            "-file", urdf_model_path,
            "-x", "0",
            "-y", "0",
            "-z", "0.2",
        ],
        output="screen",
    )

    return LaunchDescription([
        gz_args,
        start_gazebo,
        spawn_model,
    ])

6. Configuring Install Rules

Add the following before ament_package() in CMakeLists.txt:

xxxxxxxxxx
install(
  DIRECTORY launch urdf
  DESTINATION share/${PROJECT_NAME}
)

Confirm that package.xml contains the following runtime dependencies; they are written automatically when the package is created with the previous ros2 pkg create --dependencies command:

xxxxxxxxxx
<exec_depend>launch</exec_depend>
<exec_depend>launch_ros</exec_depend>
<exec_depend>ros_gz_sim</exec_depend>

7. Build and Run Verification

Return to the workspace root directory and build:

xxxxxxxxxx
cd ~/workspace
source /opt/ros/jazzy/setup.bash
colcon build --symlink-install --packages-select myrobot
source install/setup.bash

First check whether the package and the launch arguments are installed:

xxxxxxxxxx
ros2 pkg prefix myrobot
ros2 launch myrobot bringup_model.launch.py --show-args

Start it in the VNC graphical desktop:

xxxxxxxxxx
ros2 launch myrobot bringup_model.launch.py

Under normal conditions the terminal outputs:

xxxxxxxxxx
[ros_gz_sim]: Entity creation successful.

A red cube is displayed in the Gazebo empty world. If the interface shows the TurtleBot3 world or green obstacles, it means other Gazebo processes are running. Close the other simulations first, and then start only the launch file of this chapter.

When there is no graphical desktop, you can perform a server-only verification:

xxxxxxxxxx
ros2 launch myrobot bringup_model.launch.py \
  gz_args:='-s -r -v 2 empty.sdf'

Seeing Entity creation successful. means the Gazebo server has started and the model has been loaded successfully. Use Ctrl+C to end the program.

ROS2 URDF model
ROS2 TF2 coordinate transformation

COMPANY

  • About us
  • Team Style
  • Blog

LEARNING & EXPLORATION

  • Tutorials
  • Edge AI hardware
  • Educational robots
  • Embedded intelligent hardware

WHERE TO BUY

  • Yahboom Online Store
  • Amazon
  • Alibaba
  • AliExpress
  • Mercado

TECHNOLOGY SUPPORT

  • Email: support@yahboom.com

BE A DISTRIBUTOR

  • Email: sales@yahboom.com
QR Code

Copyright © 2017-2026 Yahboom. All Rights Reserved.

EN/中文