Migrating a 2.2.x port to 2.3.x

In RTI Connext DDS Micro 2.3.x changes where made to how the system API is implemented. Because of these changes existing ports must be updated, and this section describes how to make a RTI Connext DDS Micro 2.2.x port compatible with RTI Connext DDS Micro 2.3.x.

If you have ported RTI Connext DDS Micro 2.2.x the following steps will make it compatible with version 2.3.x:

• Rename the following functions and make them private to your source code. For example, rename OSAPI_System_get_time to OSAPI_MyPortSystem_get_time etc.
  • OSAPI_System_get_time
  • OSAPI_System_get_timer_resolution
  • OSAPI_System_start_timer
  • OSAPI_System_stop_timer
  • OSAPI_System_generate_uuid
• Implement the following new methods.
  • OSAPI_SystemI::get_hostname
  • OSAPI_SystemI::initialize
  • OSAPI_SystemI::finalize
• Create a system structure for your port using the following template:

               struct OSAPI_MyPortSystem
              {
                  struct OSAPI_System _parent;
  
                  Your system variable
              };
  
              static struct OSAPI_MyPortSystem OSAPI_System_g;
  
              /* OSAPI_System_gv_system is a global system variable used by the
                 generic system API. Thus, the name must be exactly as
                 shown here.
               */
              struct OSAPI_System * OSAPI_System_gv_system = &OSAPI_System_g._parent;

• Implement OSAPI_System_get_native_interface method and fill the OSAPI_SystemI structure with all the system methods.