RTI Connector for Connext DDS is a lightweight technology that enables DDS data to be accessed with Go.
Clone or download
Latest commit 6358ca0 Nov 30, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples Update README.md Nov 30, 2018
include updated license header Oct 19, 2018
rticonnextdds-connector @ 83b0bb6 added new submodule Oct 3, 2018
test/xml updated license header Oct 19, 2018
.gitignore Initial commit Sep 10, 2018
.gitmodules added new submodule Oct 3, 2018
.travis.yml Added 1.11 version Oct 29, 2018
README.md Update README.md Oct 29, 2018
rticonnextdds-connector.go
rticonnextdds_connector_test.go added flags for windows Oct 27, 2018
run_test.sh added test configs for darwin Oct 31, 2018

README.md

rticonnextdds-connector-go

GoDoc Build Status Coverage

RTI Connector for Connext DDS

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 App Creation and Dynamic Data.

RTI Connector was created by the RTI Research Group to quickly and easily develop demos and proof of concept. We think that it can be useful for anybody that needs a quick way to develop an application communicating over DDS databus. Thanks to the binding with multiple programming languages, you can integrate with tons of other available technologies.

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

For Go Connector, we leveraged cgo to call our C library, but we try to hide that from you using a nice Go wrapper. We tested with Go v1.11, v1.10 and v1.9.

Getting started

Be sure you have Go installed and set your go workspace ($GOPATH). Then run:

$ go get github.com/rticommunity/rticonnextdds-connector-go

Check out the Go Connector repository is cloned properly at the following location. $GOPATH/src/github.com/rticommunity/rticonnextdds-connector-go

Then, take a look at this document to build and run examples!

Platform support

We are building our library for few architectures only. Check them out here. 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

Threading model

The RTI Connext DDS Connector Native API do not yet implement any mechanism for thread safety. Originally the Connector native code was built to work with RTI DDS Prototyper and Lua. That was a single threaded loop. We then introduced support for javascript, python, and Go. For now the responsibility of protecting calls to the Connector are left to the user. This may change in the future.

Support

This is an experimental RTI product. As such we do offer support through the RTI Community Forum where fellow users and RTI engineers can help you. We'd love your feedback.

Documentation

We do not have much documentation yet. But we promise you: if you look at the examples you'll see that is very easy to use.

For an overview of the API, check this page.

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 (aka "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.