3.2.7. RTI Connext DDS Micro

3.2.7.1. New Installation Procedure

Starting with release 3.0.0, Connext DDS Micro is now distributed as an RTI Connext platform package. Connext DDS Micro is installed as any other additional package from RTI. See Installing Connext DDS. Connext DDS Micro Security SDK is also now distributed as an RTI package. If you use it, you must install it on top of the Connext DDS Micro package.

The Connext DDS Micro User’s Manual is also available from the Help panel in RTI Launcher. You can find information about how to build Connext DDS Micro in the Connext DDS Micro User’s Manual.

In order to build and use Connext DDS Micro, you must export the source outside the installation directory, since this directory is typically not writeable. In the RTI Launcher Utilities Tab, the “Copy Micro SDK” button is used for this purpose. Click the icon to open a dialog box where you can specify a destination folder.

After you export the source, build the Connext DDS Micro libraries, then regenerate and recompile your code, as described in the installation section of the Connext DDS Micro User’s Manual.

3.2.7.2. Change In Documentation

Starting with release 3.0.0, the Connext DDS Micro User’s Manual is separate from the API Reference HTML documentation. The User’s Manual is now also available in PDF format. See also the Connext DDS Micro Release Notes.

3.2.7.3. Application Binary Interface

Connext DDS Micro does not provide Application Binary Interface (ABI) compatibility with previous versions of Connext DDS Micro. Therefore, an application compiled using a version of Connext DDS Micro prior to 3.0.0 must be recompiled when moving to a version of Connext DDS Micro at or after 3.0.0.

Connext DDS Micro is distributed in source form. In most cases, after compiling the Connext DDS Micro libraries from the source, upgrading an application requires you to recompile your source using the new header files and link with the new libraries built from the Connext DDS Micro source. In some cases, minor modifications to your application code might be required; any such changes are noted in this Migration Guide.

To upgrade to this release, first review the information in Section 3.1 and in Section 3.2 to see what modifications you may need to make to your application code. You may also want to see What’s New in 6.0.0, as well as the Connext DDS Micro Release Notes, to see what is new or changed in this release. Then recompile your source using the new header files and link the new libraries.

3.2.7.4. APIs

The following Application Program Interfaces (APIs) have been changed or deprecated in 3.0.0. For new APIs, see the Connext DDS Micro Release Notes.

3.2.7.4.1. Wchar and wstring language binding changes

See information about this change in Section 3.1.4.5.

3.2.7.4.2. RTI_CERT compilation flag not supported in this release

Connext DDS Micro 3.0.x has not been through a certification process, and the certifiable feature set has not been defined. For this reason, the RTI_CERT compilation flag is not supported in this release. Support for this flag will be introduced again when the certifiable feature set has been defined.

3.2.7.4.3. Generated code compatibility

For Connext DDS Micro applications defining types in IDL, XML, or XSD, moving from a previous Connext DDS Micro version to Connext DDS Micro 3.0.x requires code regeneration and recompilation.

You will need to regenerate the code for your application types using the Code Generator shipped with this release. The regeneration process is very simple; you only need to run the new version of Code Generator using the original input IDL file. (You should see a message that says you are running rtiddsgen version 3.0.1.) This process will regenerate the header and source files, which can then be compiled along with the rest of your application.

3.2.7.4.4. Default UDP socket buffer size on QNX changed to 64KB

In 3.0.0, the default socket buffer size on QNX has changed from 256KB to 64KB. You can change the default socket buffer sizes when you configure the UDP transport. Please refer to the Connext DDS Micro User’s Manual for more information.

3.2.7.5. Connext DDS Compatibility

Although Connext DDS Micro 3.0.x interoperates with Connext DDS 6.0.x, Connext DDS Micro 2.4.11 and below does not communicate with any Connext DDS 6.0.x product, due to a change in the RTPS version number introduced in 6.0.0. (See “Fixes Related to OMG Specification Compliance” in the RTI Connext DDS Core Libraries Release Notes.) If you need Connext DDS Micro 2.4.11 applications or below to communicate with Connext DDS 6.0.x applications, see the article Workaround for discovery failure between RTI Connext DDS Micro 2.4.11 and RTI Connext DDS 6.0.0 or contact RTI Support at support@rti.com.

This issue has been fixed in Connext DDS Micro 2.4.12, which does communicate with a Connext DDS 6.0.x product.