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-Based Application Creation and Dynamic Data.
Connector was created by the RTI Research Group to quickly and easily develop demos and proofs of concept. It can be useful for anybody that needs a quick way to develop an application communicating over the Connext DDS Databus. Thanks to the binding with multiple programming languages, you can integrate with many other available technologies.
The Connector library is provided in binary form for select architectures. Language bindings and examples are provided in source format.
Go Connector leverages cgo to call its C library; this detail is hidden in a Go wrapper.
RTI Go Connector requires Git LFS to check out the Connector C library files properly.
$ curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash
$ sudo apt-get install git-lfs
$ git lfs install
Be sure you have golang installed (we tested with golang v1.10 above).
Install:
$ go get github.com/rticommunity/rticonnextdds-connector-go
Import:
import "github.com/rticommunity/rticonnextdds-connector-go"
Please see examples for usage details.
To build your application statically, it requires RTI Connext DDS static libs (libnddscorez.a
, libnddscz.a
). They are located in $NDDSHOME/lib/YOUR_ARCHITECTURE
.
$ cp $NDDSHOME/lib/YOUR_ARCHITECTURE/libnddscorez.a ./static_lib/YOUR_ARCHITECTURE/
$ cp $NDDSHOME/lib/YOUR_ARCHITECTURE/libnddscz.a ./static_lib/YOUR_ARCHITECTURE/
Then, you can run go build
with -tags static
to build.
$ go build -tags static ./examples/simple/writer/writer.go
Go Connector builds its library for few select architectures. If you need another architecture, please contact your RTI account manager or sales@rti.com.
If you want to check the version of the libraries you can run the following command:
strings librtiddsconnector.so | grep BUILD
The Connector Native API does not yet implement any mechanism for thread safety. Originally, the Connector native code was built to work with RTI Prototyper and Lua. That was a single-threaded loop. RTI then introduced support for JavaScript, Python, and Go. For now, you are responsible for protecting calls to Connector. Thread safety may be implemented in the future.
Connector is an experimental RTI product. If you have questions, please use the RTI Community Forum. If you would like to report a bug or have a feature request, please create an issue.
The best way to get started with Connector is to look at the examples; you will see that it is very easy to use.
Please see the API documentaiton for more information.
Contributions to the code, examples, documentation are really appreciated. Please follow the steps below for contributions.
- Sign the CLA.
- Create a fork and make your changes.
- Run tests (use run_test.sh).
- Push your branch.
- Open a new pull request.