Skip to content

Commit 6b71b49

Browse files
Amronoscaguero
andauthored
Switch to Jazzy for Harmonic (gazebosim#518)
* Switch to Jazzy Signed-off-by: Aarav Gupta <[email protected]> * Update some files Signed-off-by: Aarav Gupta <[email protected]> * Make Requested Changes Signed-off-by: Aarav Gupta <[email protected]> --------- Signed-off-by: Aarav Gupta <[email protected]> Co-authored-by: Carlos Agüero <[email protected]>
1 parent a788b84 commit 6b71b49

File tree

8 files changed

+18
-27
lines changed

8 files changed

+18
-27
lines changed

harmonic/comparison.md

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -284,14 +284,10 @@ ROS integration through the
284284

285285
Supported versions:
286286

287-
* ROS 2 Iron (from source) / Rolling (from source)
288-
289-
Note: binaries for ROS2 might be available sometime after the Harmonic release.
287+
* ROS 2 Jazzy (from binary) / Rolling (from source)
290288

291289
For **ROS 2 Rolling**, the Rolling distribution moves with the next future release
292-
of ROS 2 defined in [REP-2000](https://www.ros.org/reps/rep-2000.html). For the Gz
293-
Harmonic release this means that it will be adopted when ROS 2 Jazzy goes into the
294-
[REP-2000](https://www.ros.org/reps/rep-2000.html).
290+
of ROS 2 defined in [REP-2000](https://www.ros.org/reps/rep-2000.html).
295291

296292
## Platforms
297293

harmonic/install.md

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,6 @@
11
# Gazebo Harmonic
22

3-
Up to Harmonic's release date, the collection should be considered unstable.
4-
5-
Gazebo Harmonic will be the 8th major release of Gazebo. It will be a
3+
Gazebo Harmonic is the 8th major release of Gazebo. It is a
64
long-term release.
75

86
## Binary installation instructions
@@ -49,9 +47,6 @@ This list of library versions may change up to the release date.
4947

5048
## Supported platforms
5149

52-
Harmonic is planned to be [supported](releases) on the platforms below.
53-
This list may change up to the release date.
54-
5550
These are the **officially** supported platforms:
5651

5752
* Ubuntu Jammy on amd64

harmonic/ros2_integration.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ simulatenously simulated by a Gazebo world.
77

88
## ros_gz_bridge
99

10-
[`ros_gz_bridge`](https://github.com/gazebosim/ros_gz) provides a network bridge which enables the exchange of messages between ROS 2 and [Gazebo Transport](https://github.com/gazebosim/gz-transport). Its support is limited to only certain message types. Please, check this [README](https://github.com/gazebosim/ros_gz/blob/ros2/ros_gz_bridge/README.md) to verify if your message type is supported by the bridge.
10+
[`ros_gz_bridge`](https://github.com/gazebosim/ros_gz) provides a network bridge which enables the exchange of messages between ROS 2 and [Gazebo Transport](https://github.com/gazebosim/gz-transport). Its support is limited to only certain message types. Please, check this [README](https://github.com/gazebosim/ros_gz/blob/jazzy/ros_gz_bridge/README.md) to verify if your message type is supported by the bridge.
1111

1212
Example uses of the bridge can be found in [`ros_gz_sim_demos`](https://github.com/gazebosim/ros_gz/tree/ros2/ros_gz_sim_demos), including demo launch files with bridging of all major actuation and sensor types.
1313

@@ -29,7 +29,7 @@ The ROS message type is followed by an `@`, `[`, or `]` symbol where:
2929
* `[` is a bridge from Gazebo to ROS.
3030
* `]` is a bridge from ROS to Gazebo.
3131

32-
Have a look at these [examples]( https://github.com/gazebosim/ros_gz/blob/ros2/ros_gz_bridge/README.md#example-1a-gazebo-transport-talker-and-ros-2-listener)
32+
Have a look at these [examples]( https://github.com/gazebosim/ros_gz/blob/jazzy/ros_gz_bridge/README.md#example-1a-gazebo-transport-talker-and-ros-2-listener)
3333
explaining how to make communication connections from ROS to Gazebo and vice versa.
3434

3535
It is also possible to use ROS Launch with the `ros_gz_bridge` and represent the topics in yaml format to be given to the bridge at launch time.
@@ -58,7 +58,7 @@ speedup performance.
5858
* `direction`: It's possible to specify `GZ_TO_ROS`, `ROS_TO_GZ` and
5959
`BIDIRECTIONAL`.
6060

61-
See [this example](https://github.com/gazebosim/ros_gz/blob/ros2/ros_gz_bridge/test/config/full.yaml)
61+
See [this example](https://github.com/gazebosim/ros_gz/blob/jazzy/ros_gz_bridge/test/config/full.yaml)
6262
for a valid configuration file.
6363

6464
## Launching the bridge using the launch files included in `ros_gz_bridge` package.
@@ -78,7 +78,7 @@ And now, the container will load your bridge with:
7878
ros2 launch ros_gz_bridge ros_gz_bridge.launch.py bridge_name:=ros_gz_bridge config_file:=<path_to_your_YAML_file>
7979
```
8080

81-
Check [this block](https://github.com/gazebosim/ros_gz/blob/ros2/ros_gz_bridge/launch/ros_gz_bridge.launch.py#L27-L33)
81+
Check [this block](https://github.com/gazebosim/ros_gz/blob/jazzy/ros_gz_bridge/launch/ros_gz_bridge.launch.py#L27-L33)
8282
from the source code to know all the different parameters accepted by this
8383
launch file.
8484

@@ -203,10 +203,10 @@ A video walk-through of this tutorial is available from our YouTube channel: [Ga
203203

204204
## Visualize in RViz
205205

206-
Take a step further and try out demos from [`ros_gz_sim_demos`](https://github.com/gazebosim/ros_gz/tree/ros2/ros_gz_sim_demos).
206+
Take a step further and try out demos from [`ros_gz_sim_demos`](https://github.com/gazebosim/ros_gz/tree/jazzy/ros_gz_sim_demos).
207207

208-
For the `sdf_parser` demo, install [`ros_gz`](https://github.com/gazebosim/ros_gz/tree/ros2) and the parser plugin `sdformat_urdf` from source in a colcon workspace.
209-
Read more about `sdformat_urdf` [here](https://github.com/ros/sdformat_urdf/blob/ros2/sdformat_urdf/README.md).
208+
For the `sdf_parser` demo, install [`ros_gz`](https://github.com/gazebosim/ros_gz/tree/jazzy) and the parser plugin `sdformat_urdf` from source in a colcon workspace.
209+
Read more about `sdformat_urdf` [here](https://github.com/ros/sdformat_urdf/blob/jazzy/sdformat_urdf/README.md).
210210

211211
Run the demo launch file with the rviz launch argument set:
212212

harmonic/ros2_interop.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ For publishing and controlling the robot pose, we need joint states of the robot
5454

5555
![jsp_gui](tutorials/ros2_integration/jsp_gui.png)
5656

57-
See [documentation](http://docs.ros.org/en/rolling/p/joint_state_publisher_gui/) for node API.
57+
See [documentation](http://docs.ros.org/en/jazzy/p/joint_state_publisher_gui/) for node API.
5858
This functionality is useful during initial development of the model.
5959
At this point we have achieved the first aim defined in [Setup](#setup).
6060

@@ -95,7 +95,7 @@ Learn more about the bridge from [ROS 2 Integration](ros2_integration).
9595
The main pain point of using existing simulation assets with ROS 2 tools was updating URDF files into a Gazebo-readable format. This is no longer required. If you are maintaining a URDF and an SDF file in a project, you can now drop the URDF and just use the SDF for both ROS and Gazebo.
9696

9797
This is made possible by `sdformat_urdf`, a parser plugin library that converts an SDF file to URDF C++ DOM structures, making it understandle by the ROS 2 ecosystem.
98-
Although, there are some limitations of the plugin, like not all SDFormat tags are compatible. For example, if you have any sensors attached to a joint, it won't be parsed. More details [here](https://github.com/ros/sdformat_urdf/tree/ros2/sdformat_urdf).
98+
Although, there are some limitations of the plugin, like not all SDFormat tags are compatible. For example, if you have any sensors attached to a joint, it won't be parsed. More details [here](https://github.com/ros/sdformat_urdf/tree/jazzy/sdformat_urdf).
9999

100100
To embed this functionality, we simply need to print the SDFormat file to the `/robot_description` ROS topic, and internally ROS will find a suitable parser, `sdformat_urdf` in this case, to read the file. This is already done while configuring the `robot_state_publisher` earlier.
101101

harmonic/ros2_launch_gazebo.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
Gazebo can be launched from a ROS 2 launch system in multiple ways:
44

55
## Using the launch files included in
6-
[ros_gz_sim](https://github.com/gazebosim/ros_gz/tree/ros2/ros_gz_sim).
6+
[ros_gz_sim](https://github.com/gazebosim/ros_gz/tree/jazzy/ros_gz_sim).
77

88
The package `ros_gz_sim` contains two launch files named `gz_server.launch.py`
99
and `gz_sim.launch.py`. You can use them to start Gazebo server or Gazebo (server and GUI)
@@ -20,8 +20,8 @@ ros2 launch ros_gz_sim gz_server.launch.py world_sdf_file:=empty.sdf
2020
```
2121

2222
Consult the argument block of each launch file
23-
[here](https://github.com/gazebosim/ros_gz/blob/ros2/ros_gz_sim/launch/gz_sim.launch.py.in#L75-L96)
24-
and [here](https://github.com/gazebosim/ros_gz/blob/ros2/ros_gz_sim/launch/gz_server.launch.py#L27-L38)
23+
[here](https://github.com/gazebosim/ros_gz/blob/jazzy/ros_gz_sim/launch/gz_sim.launch.py.in#L75-L96)
24+
and [here](https://github.com/gazebosim/ros_gz/blob/jazzy/ros_gz_sim/launch/gz_server.launch.py#L27-L38)
2525
to learn about the different parameters that are accepted by each launch file.
2626

2727
## Using a custom launch file.

harmonic/ros2_overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ different types of integrations that you can achieve between Gazebo and ROS.
55

66
* Use ROS to launch Gazebo: ROS prescribes a specific way to launch all
77
the pieces needed in your system. There's a dedicated
8-
[launch mechanism](https://docs.ros.org/en/rolling/Tutorials/Intermediate/Launch/Creating-Launch-Files.html)
8+
[launch mechanism](https://docs.ros.org/en/jazzy/Tutorials/Intermediate/Launch/Creating-Launch-Files.html)
99
to orchestrate the launch of all your components and many tooling around it.
1010
Gazebo can be launched in this way.
1111

harmonic/ros2_spawn_model.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ existing simulation. Here's an example:
1515
ros2 launch ros_gz_sim ros_gz_spawn_model.launch.py world:=empty file:=$(ros2 pkg prefix --share ros_gz_sim_demos)/models/vehicle/model.sdf entity_name:=my_vehicle x:=5.0 y:=5.0 z:=0.5
1616
```
1717

18-
Check [this block](https://github.com/gazebosim/ros_gz/blob/ros2/ros_gz_sim/launch/ros_gz_spawn_model.launch.py#L26-L45)
18+
Check [this block](https://github.com/gazebosim/ros_gz/blob/jazzy/ros_gz_sim/launch/ros_gz_spawn_model.launch.py#L26-L45)
1919
from the source code to know all the different parameters accepted by this
2020
launch file.
2121

harmonic/sensors.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ learn how to launch multiple tasks with just one file using `gz launch`.
1111
You can find the final world of this tutorial showing all these plugins in use [here](https://github.com/gazebosim/docs/blob/master/harmonic/tutorials/sensors/sensor_tutorial.sdf).
1212
You may also find an extensive set of world examples with many possible sensors and actuation capabilities in [`gz-sim/examples/worlds`](https://github.com/gazebosim/gz-sim/tree/gz-sim8/examples/worlds) for individual examples.
1313
The full set of sensors can be found in the [`gz-sensors` library](https://github.com/gazebosim/gz-sensors).
14-
If using ROS, you can see demo launches and bridging configuration for these examples [here](https://github.com/gazebosim/ros_gz/tree/ros2/ros_gz_sim_demos/launch).
14+
If using ROS, you can see demo launches and bridging configuration for these examples [here](https://github.com/gazebosim/ros_gz/tree/jazzy/ros_gz_sim_demos/launch).
1515

1616
## Preliminaries
1717

0 commit comments

Comments
 (0)