What Is This?

This demo provides an example of further Quality-Of-Service (QoS) configurability as well as Publication Modes in a ROS 2 node via the use of rmw_fastrtps_cpp Application Programming Interface (API).

The example utilitises eprosima::fastdds::statistics::dds::DomainParticipant as well as eprosima::fastdds::dds::DataWriter.

A DomainParticipant defines a singular working unit which groups a set of Publishers and Subscribers together. See References - DomainParticipant for more details.

A DataWriter is created by a Publisher and writes data to a topic with configurable behaviors. See References - DataWriter for more details.

Build

colcon build --packages-up-to demo_nodes_cpp_native

Run

ros2 run demo_nodes_cpp_native talker

Verify

When executed correctly, the following strings should be printed to the terminal similar to what is shown below:

[INFO] [1674525877.083735645] [talker_native]: eprosima::fastdds::dds::DomainParticipant * 94193367466752
[INFO] [1674525877.084105822] [talker_native]: eprosima::fastdds::dds::DataWriter * 94193370040688
[INFO] [1674525877.584006930] [talker_native]: Publishing: 'Hello World: 1'
[INFO] [1674525878.083967966] [talker_native]: Publishing: 'Hello World: 2'
[INFO] [1674525878.583917242] [talker_native]: Publishing: 'Hello World: 3'
[INFO] [1674525879.083963276] [talker_native]: Publishing: 'Hello World: 4'
[INFO] [1674525879.583918839] [talker_native]: Publishing: 'Hello World: 5'
#...

FAQ

Q: Why use rmw_fastrtps_cpp API directly?

A: ROS 2 only allows for the configuration of certain middleware QoS (see ROS 2 QoS policies). In addition to ROS 2 QoS policies, rmw_fastrtps sets two more Fast DDS configurable parameters:

History memory policy: PREALLOCATED_WITH_REALLOC_MEMORY_MODE

Publication mode: ASYNCHRONOUS_PUBLISH_MODE

In addition, rmw_fastrtps offers the possibility to further configure Fast DDS:

Change publication mode

Full QoS configuration

Q: Is it still called Fast RTPS?

A: No. Fast RTPS has been renamed to Fast DDS since ROS 2 Foxy.

References

1. Fast DDS
2. What Is RTPS?
3. Fast RTPS Becomes Fast DDS in Foxy
4. Advanced Usage
5. DomainParticipant
6. DataWriter

Changelog for package demo_nodes_cpp_native

0.35.0 (2024-10-03)

0.34.2 (2024-07-29)

0.34.1 (2024-06-17)

0.34.0 (2024-04-26)

0.33.2 (2024-03-28)

• Update maintainer list in package.xml files (#665)
• Contributors: Michael Jeronimo

0.33.1 (2024-02-07)

0.33.0 (2024-01-24)

0.32.1 (2023-12-26)

0.32.0 (2023-11-06)

0.31.1 (2023-09-07)

0.31.0 (2023-08-21)

0.30.1 (2023-07-11)

0.30.0 (2023-06-12)

0.29.0 (2023-06-07)

0.28.1 (2023-05-11)

0.28.0 (2023-04-27)

0.27.0 (2023-04-13)

• Change all ROS2 -> ROS 2. (#610)
• Contributors: Chris Lalancette

0.26.0 (2023-04-11)

• Added README.md for demo_cpp_nodes_native (#597)
• Contributors: Gary Bey

0.25.0 (2023-03-01)

0.24.1 (2023-02-24)

0.24.0 (2023-02-14)

• Update the demos to C++17. (#594)
• [rolling] Update maintainers - 2022-11-07 (#589)
• Make demo_nodes_cpp_native install stuff only when it builds (#590)
• Contributors: Audrow Nash, Chris Lalancette, Shane Loretz

0.23.0 (2022-11-02)

0.22.0 (2022-09-13)

0.21.0 (2022-04-29)

0.20.1 (2022-04-08)

0.20.0 (2022-03-01)

0.19.0 (2022-01-14)

0.18.0 (2021-12-17)

• Update maintainers to Audrow Nash and Michael Jeronimo (#543)
• Fix typo in demo_nodes_cpp_native package description (#536)
• Contributors: Audrow Nash, Víctor Mayoral Vilches

0.17.0 (2021-10-18)

0.16.0 (2021-08-11)

0.15.0 (2021-05-14)

0.14.2 (2021-04-26)

0.14.1 (2021-04-19)

0.14.0 (2021-04-06)

• Update demo_nodes_cpp_native to new Fast DDS API (#493)
• Contributors: Miguel Company

0.13.0 (2021-03-25)

0.12.1 (2021-03-18)

0.12.0 (2021-01-25)

0.11.0 (2020-12-10)

• Update the package.xml files with the latest Open Robotics maintainers (#466)
• Contributors: Michael Jeronimo

0.10.1 (2020-09-21)

0.10.0 (2020-06-17)

0.9.3 (2020-06-01)

• Shared publisher handle (#448)
• Contributors: Chris Lalancette

0.9.2 (2020-05-26)

0.9.1 (2020-05-12)

0.9.0 (2020-04-30)

0.8.4 (2019-11-19)

0.8.3 (2019-11-11)

0.8.2 (2019-11-08)

0.8.1 (2019-10-23)

• Replace ready_fn with ReadyToTest action (#404)
• Contributors: Peter Baughman

0.8.0 (2019-09-26)

• Adding visibility macros to demos (#381)
• Check if FastRTPS available in demo_nodes_cpp_native before creating library/executable (#383)
• Demos using composition (#375)
• Contributors: Siddharth Kucheria

0.7.6 (2019-05-30)

0.7.5 (2019-05-29)

0.7.4 (2019-05-20)

0.7.3 (2019-05-10)

0.7.2 (2019-05-08)

• changes to avoid deprecated API's (#332)
• Corrected publish calls with shared_ptr signature (#327)
• Migrate launch tests to new launch_testing features & API (#318)
• Contributors: Michel Hidalgo, William Woodall, ivanpauno

0.7.1 (2019-04-26)

0.7.0 (2019-04-14)

• Added launch along with launch_testing as test dependencies. (#313)
• Contributors: Michel Hidalgo

0.6.2 (2019-01-15)

0.6.1 (2018-12-13)

0.6.0 (2018-12-07)

• Added semicolons to all RCLCPP and RCUTILS macros. (#278)
• Contributors: Chris Lalancette

0.5.1 (2018-06-28)

0.5.0 (2018-06-27)

• Updated launch files to account for the "old launch" getting renamespaced as launch -> launch.legacy. (#239)
• Contributors: Dirk Thomas, William Woodall