RTI Connector for Connext DDS is a lightweight technology that enables DDS data to be accessed with Javascript (Node.js), Python, and Lua.
Clone or download
Latest commit e4c2c96 Jan 12, 2019

README.md

rticonnextdds-connector

RTI Connector for Connext DDS - Getting Started

RTI Connector for Connext DDS is a quick and easy way to access the power and functionality of RTI Connext DDS. It is based on XML Application Creation and Dynamic Data.

Connector was created by the RTI Research Group to quickly and easily develop demos and proofs of concept. We think that it can be useful for anybody who needs a quick way to script tests and interact with DDS using different scripting languages.

It can be used to quickly create tests for your distributed system and, thanks to the binding with scripting languages and the use of XML, to easily integrate with tons of other available technologies.

The Connector library is provided in binary form for selected architectures. Scripting language bindings and examples are provided in source format.

Language Support

Platform support

We are building our library for a few architectures only. Check them out here. If you need another architecture, please contact your RTI account manager or sales@rti.com.

Windows Note: We tested the Node.js/JavaScript Connector on Win10 64 bit. We notice that npm works best with VS Express 2013. Feel free to ask questions on the RTI Community forum for more details on Windows and Connector.

If you want to check the version of the libraries, run the following command:

strings librtiddsconnector.dylib | grep BUILD

Threading model

The Connector Native API does not yet implement any mechanism for thread safety. Originally the Connector native code was built to work with Prototyper and Lua. That was a single threaded loop. We then introduced support for JavaScript and Python. For now, the responsibility of protecting calls to the Connector is left to you. (In future we may add thread safety in the native layer.) In Node.js/JavaScript, threading should not be a problem due to the 'callback' style of the language itself. In Python, you will have to protect the calls to the Connector if you are using different threads. For an example, see Protecting calls to the Connector library in the Python README.

Support

This is an experimental RTI product. As such, we offer support through the RTI Community forum.

License

With the sole exception of the contents of the "examples" subdirectory, all use of this product is subject to the RTI Software License Agreement included at the top level of this repository. Files within the "examples" subdirectory are licensed as marked within the file.

This software is an experimental ("pre-production") product. The Software is provided "as is," with no warranty of any type, including any warranty for fitness for any purpose. RTI is under no obligation to maintain or support the software. RTI shall not be liable for any incidental or consequential damages arising out of the use or inability to use the software.