The following tutorials and examples are updated for ROS 2 Dashing Diademata (Released in May 2019).
This repository also contains some Dockerfile for running different ROS2-based environments.
You can find them here.
Note: you can still use ROS2 Bouncy Bolson, but you will not be able to compile the simple_actions package or to reproduce the examples of simple_navigation, simple_bag, simple_gazebo and simple_rqt.
Source your ROS2 SDK, then create a workspace, add this repository to its sources and build the packages.
$ source <PATH_TO_ROS2_SDK_WS>/install/setup.sh
$ mkdir -p ws/src
$ cd ws/src
$ git clone https://github.com/alsora/ros2-code-examples
$ cd ..
$ colcon build
$ source install/local_setup.sh
For more detailed build instructions look here
For each of the following tests, run the each command in a separate terminal window (remember that the ROS2 SDK has to be sourced in every terminal window!)
$ ros2 run simple_publisher publisher_main
$ ros2 run simple_subscriber subscriber_main
One process publishes messages and the other subscribes to that topic.
$ ros2 run simple_service service_main
$ ros2 run simple_client client_main
One process provides a service and the other requests it.
Running simple_client/timer_main contains an alternative implementation for the ROS2 client node.
$ ros2 run simple_action service_main
$ ros2 run simple_action client_main
One process provides an action service and the other requests it. The server node can reject the goal according to the request parameters. The client node can cancel the action if it's taking too much time.
$ ros2 run simple_logger logger_main
Log some messages and change the verbosity level at runtime.
$ ros2 run simple_multithread multithread_main
Run multiple nodes in separate threads from the same process.
NOTE This example requires
$ ros2 run simple_time_sync publisher
$ ros2 run simple_time_sync time_sync_main
One process publishes messages on multiple topics. Sometimes it publishes only on one topic, sometimes on all with the same timestamp and sometimes on all but with slightly different timestamps. The other process create an approximate and an exact time subscribers.
$ ros2 run simple_parameter parameter_server_main
$ ros2 run simple_parameter parameter_client_main
One process sets its own parameters. The other reads them.
Autonomously move a mobile robot in the environment, using a real system or a simulation.
Record messages from topic to a file and playback them whenever you want.
GUI for inspection and interaction of a ROS2 graph.
ROS2 integration of the 3D simulation and visualization tool Gazebo.
Allow nodes compiled against different versions of a message interface to communicate.
Enable security options for your ROS2 system: nodes authentication, messages encryption and access control.
Note that these commands comes from a Python package. So if you have disabled Python support (i.e. when cross-compiling) they will not be available.
-
See a list of available commands
$ ros2 --help -
Print a list of <package_name> <executable_name>
$ ros2 pkg executabels -
Run a ROS2 node
$ ros2 run <package_name> <executable_name> -
List running ROS2 nodes
$ ros2 node list -
List visible topic names (a topic is visible if at least 1 node is publishing or subscribing to it)
$ ros2 topic list -
Echo what's published on a topic
$ ros2 topic echo <topic_name> -
Publish a message to a topic (message_content written as valid YAML)
$ ros2 topic pub <topic_name> <message_type> <message_content> -
Make a service request (request_content written as valid YAML)
$ ros2 service call <service_name> <request_message_type> <request_content>