eprosima Fast DDS (formerly Fast RTPS) is a C++ implementation of the DDS (Data Distribution Service) standard of the OMG (Object Management Group). eProsima Fast DDS implements the RTPS (Real Time Publish Subscribe) protocol, which provides publisher-subscriber communications over unreliable transports such as UDP, as defined and maintained by the Object Management Group (OMG) consortium. RTPS is also the wire interoperability protocol defined for the Data Distribution Service (DDS) standard. eProsima Fast DDS expose an API to access directly the RTPS protocol, giving the user full access to the protocol internals.
Some of the main features of this library are:
eProsima Fast DDS has been adopted by multiple organizations in many sectors including these important cases:
This project is part of FIWARE. For more information check the FIWARE Catalogue entry for Robotics.
Write to evaluation.support@eprosima.com or mention @EProsima on Twitter. We are curious to get to know your use case!
You can get either a binary distribution of eprosima Fast DDS or compile the library yourself from source.
The latest, up to date binary release of eprosima Fast DDS can be obtained from the company website.
On Linux, you can install these libraries using the package manager of your Linux distribution. For example, on Ubuntu you can install them by using its package manager with the next command.
sudo apt install libasio-dev libtinyxml2-dev
On Windows, you can install these libraries using Chocolatey. First, download the following chocolatey packages from this ROS2 Github repository.
Once these packages are downloaded, open an administrative shell and execute the following command:
choco install -y -s <PATH\TO\DOWNLOADS\> asio tinyxml2
Please replace <PATH\TO\DOWNLOADS>
with the folder you downloaded the packages to.
colcon is a command line tool to build sets of software packages. This section explains to use it to compile easily Fast-RTPS and its dependencies. First install ROS2 development tools (colcon and vcstool):
pip install -U colcon-common-extensions vcstool
Download the repos file that will be used to download Fast RTPS and its dependencies:
$ mkdir fastdds_ws
$ cd fastdds_ws
$ wget https://raw.githubusercontent.com/eProsima/Fast-DDS/master/fastrtps.repos
$ mkdir src
$ vcs import src < fastrtps.repos
Finally, use colcon to compile all software:
$ colcon build
Before compiling manually Fast DDS you need to clone the following dependencies and compile them using CMake.
$ git clone https://github.com/eProsima/Fast-CDR.git
$ mkdir Fast-CDR/build && cd Fast-CDR/build
$ cmake ..
$ cmake --build . --target install
$ git clone https://github.com/eProsima/foonathan_memory_vendor.git
$ cd foonathan_memory_vendor
$ mkdir build && cd build
$ cmake ..
$ cmake --build . --target install
Once all dependencies are installed, you will be able to compile and install Fast DDS.
$ git clone https://github.com/eProsima/Fast-DDS.git
$ mkdir Fast-DDS/build && cd Fast-DDS/build
$ cmake ..
$ cmake --build . --target install
You can access the documentation online, which is hosted on Read the Docs.
eprosima Fast DDS claims to be in the Quality Level 1 category based on the guidelines provided by ROS 2. See the Quality Declaration for more details.
For those who want to try a quick demonstration of Fast DDS libraries on Ubuntu, here is a way to launch an example application.
First, download and install docker application. Open a terminal and type the following command:
$ sudo apt-get install docker.io
Then, download the docker image files from the eProsima downloads website.
Load the docker images:
$ docker load -i ubuntu-fast-dds:<FastDDS-Version>.tar
$ docker load -i ubuntu-fast-dds-helloworld:<FastDDS-Version>.tar
$ docker load -i ubuntu-fast-dds-shapesdemo:<ShapesDemo-Version>.tar
Run the Docker container with the eProsima Shapes Demo application. Please refer to Shapes Demo documentation for further details on how to use this application.
$ xhost local:root
$ docker run -it --privileged -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix \
ubuntu-fast-dds-shapesdemo:<ShapesDemo-Version>
It is also possible to run the Fast DDS HelloWorld example by executing the following command:
$ docker run -it ubuntu-fast-dds-helloworld:<FastDDS-Version>
Run as many images as wanted and check the communication between them.
If you need support you can reach us by mail at support@eProsima.com
or by phone at +34 91 804 34 48
.
Supported by ROSIN - ROS-Industrial Quality-Assured Robot Software Components. More information: rosin-project.eu
This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement no. 732287.
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。