11. ROS2 parameter service case

1. Introduction to parameters

Similar to global variables in C++ programming, they facilitate sharing data across multiple programs. Parameters are global dictionaries in the ROS robot system, allowing data to be shared across multiple nodes.

In the ROS system, parameters exist in the form of a global dictionary. What is a dictionary? Just like a real dictionary, they consist of a name and a value, also known as a key and a value. Alternatively, we can think of them as being like parameters in programming: there's a parameter name, followed by an equals sign, and then the parameter value. To use it, you simply access the parameter name.

Parameters have a rich set of features. For example, if a node shares a parameter, other nodes can access it. If a node modifies a parameter, other nodes can immediately be notified and obtain the latest value.

2. Parameters in the Little Turtle Example

In the Little Turtle example, the emulator provides a number of parameters. Let's use this example to familiarize ourselves with the meaning of parameters and command line usage.

Since a GUI is displayed here, the following examples are demonstrated in the virtual machine that comes with the tutorial for ease of operation.

1. Launch two terminals in the virtual machine, running the turtle simulator and the keyboard control node respectively:

xxxxxxxxxx
ros2 run turtlesim turtlesim_node
ros2 run turtlesim turtle_teleop_key

2. Launch a terminal in the virtual machine and use the following command to view the parameter list:

xxxxxxxxxx
ros2 param list

3. Querying and Modifying Parameters

To query or modify the value of a parameter, follow the param command with a get or set subcommand:

xxxxxxxxxx
ros2 param describe turtlesim background_b # View the description of a parameter
ros2 param get turtlesim background_b # Query the value of a parameter
ros2 param set turtlesim background_b 10 # Modify the value of a parameter

4. Saving and Loading Parameter Files

Querying/modifying parameters one by one is too cumbersome. Why not try using a parameter file? Parameter files in ROS use the YAML format. You can follow the param command with the dump subcommand to save all the parameters for a node to a file, or use the load command to load all the contents of a parameter file at once:

xxxxxxxxxx
ros2 param dump turtlesim >> turtlesim.yaml # Save the parameters of a node to a parameter file
ros2 param load turtlesim turtlesim.yaml # Load all parameters from a file at once

3. Parameter Examples

3.1. Creating a New Function Package

• Create a new function package in the src directory of the workspace

xxxxxxxxxx
ros2 pkg create pkg_param --build-type ament_python --dependencies rclpy --node-name param_demo

After executing the above command, the pkg_param package will be created, a param_demo node will be created, and the relevant configuration files will be configured.

3.2 Code Implementation

Next, edit [param_demo.py] to implement the publisher functionality and add the following code:

 ROS2 custom interface message
ROS2 meta-function package