Contains documentation about the Generated configuration file [DATATYPE_TYPE]_TSSConfigInterface.hpp. More...

Contains documentation about the Generated configuration file [DATATYPE_TYPE]_TSSConfigInterface.hpp.

Overview

DDS is a strongly typed API that requires explicit definition of the data types to be used. The definition is provided in a platform and language neutral description such as IDL.

Once this definition is provided, the rtiddsgen tool is used to generate type support code for the given data type(s). The generated code (for a specific language) contains the definition of:

• the type itself,

• the DataWriter and DataReader code,

• serialization and deserialization code, and

• other utilities needed to use the data type in DDS systems.

In a DDS application, the generated type support is ‘registered’ with a DomainParticipant via an explicit call:

HelloWorldTypeSupport_register_type(participant, type_name);

Essentially, this function installs a type support plugin that registers the various type-specific utilities so that the DDS core can use the type.

The FACE TSS API is also strongly typed. The modified version of the rtiddsgen tool provided with Connext TSS will generate both the type support required by the underlying DDS and the type plugin required by Connext TSS.

The generated type plugin files (i.e., Foo, FooPlugin, and FooSupport) should not need any modification. The register_type function for an specific type is configured from the Configuration Interface capability described bellow.

Conceptual Model

While the FACE 3.0 TSS Type-Specific Base interface is defined and implemented by Connext TSS independently of any user data type, the TSS Type-Specific Typed interface must be defined for each type. Consequently, the rtiddsgen tool is used to generate the following headers and source files:

• [DATATYPE_TYPE]_TypedTS.hpp defines the Type-Specific Typed interface for the user data type.

• [DATATYPE_TYPE]_TypedTS_Impl.hpp defines a class implementating the interface defined in [DATATYPE_TYPE]_TypedTS.hpp.

• [DATATYPE_TYPE]_TypedTS_Impl.cpp is the implementation of [DATATYPE_TYPE]_TypedTS_Impl.hpp.

Connext TSS implements the FACE 3.x Configuration Interface. Users configure Connext TSS by customizing configuration data within a Configuration interface instance and then setting its reference with the Connext TSS Base.