.. include:: vars.rst

.. _section-release_notes:

*************
Release Notes
*************

Supported Platforms
-------------------
The |RTI_TSS| library is shipped as source and must be compiled before use by
any FACE applications.

Conformant Architectures
^^^^^^^^^^^^^^^^^^^^^^^^
|RTI_TSS| has been certified conformant on the platforms in
:numref:`TableCertConfPlatforms`.

.. list-table:: Conformant Architectures
    :name: TableCertConfPlatforms
    :widths: 10 40 10 15 25
    :header-rows: 1

    * - OS
      - Version
      - CPU
      - Compiler
      - RTI Architecture Abbreviation

    * - Linux®
      - CentOS™ 7.0
      - x64
      - gcc 4.8.2
      - x64Linux3gcc4.8.2

Demonstrated Architectures
^^^^^^^^^^^^^^^^^^^^^^^^^^

|RTI_TSS| has been demonstrated with |CONNEXT| *Professional* on the platforms in
:numref:`TableProDemoPlatforms` and with |CONNEXT_MICRO| on the platforms in
:numref:`TableMicroDemoPlatforms`.

.. list-table:: Connext DDS Professional - Demonstrated Architectures
    :name: TableProDemoPlatforms
    :widths: 10 40 10 15 25
    :header-rows: 1

    * - OS
      - Version
      - CPU
      - Compiler
      - RTI Architecture Abbreviation

    * - Linux
      - Red Hat® Enterprise Linux 6.0-6.5, 6.7, 6.8 and |br|
        CentOS 6.0, 6.2-6.4
      - x86
      - gcc 4.4.5
      - i86Linux2.6gcc4.4.5

    * -
      -
      - x64
      - gcc 4.4.5
      - x64Linux2.6gcc4.4.5

    * -
      - Red Hat Enterprise Linux 7.0 and |br|
        CentOS 7.0
      - x64
      - gcc 4.8.2
      - x64Linux3gcc4.8.2

    * -
      - Ubuntu® 12.04 LTS
      - x64
      - gcc 4.6.3
      - x64Linux3.xgcc4.6.3

    * - OS X®
      - OS X 10.12
      - x64
      - clang 8.0
      - x64Darwin16clang8.0

    * -
      - OS X 10.13
      - x64
      - clang 9.0
      - x64Darwin17clang9.0

.. list-table:: Connext DDS Micro - Demonstrated Architectures
    :name: TableMicroDemoPlatforms
    :widths: 10 40 10 15 25
    :header-rows: 1

    * - OS
      - Version
      - CPU
      - Compiler
      - RTI Architecture Abbreviation

    * - Linux
      - Red Hat Enterprise Linux 7.0 and |br|
        CentOS 7.0
      - x64
      - gcc 4.8.2
      - x64Linux3gcc4.8.2

Note that the |TSS| library has **not** been tested on any Windows® platform.


What's New in 2.1.1
-------------------

FACE Certified Conformance
^^^^^^^^^^^^^^^^^^^^^^^^^^

|TSS| has been certified conformant to the FACE technical standard, version
2.1.1, and the Safety Base Profile when using |CONNEXT_MICRO| `2.4.11.1
<https://community.rti.com/documentation/connext-micro/rti-connext-micro-2411>`_.


Known Issues in 2.1.1
----------------------

Data Type Format
^^^^^^^^^^^^^^^^^^^^^^
|TSS| accepts user data types in IDL file format. For assistance 
converting other data type or data model formats, check the 
`FACE Library Portal <https://www.facesoftware.org/>`_ for FACE certified 
products, or contact your local RTI account team or 
`RTI Support <https://www.rti.com/support>`_ .


Data Type Restrictions
^^^^^^^^^^^^^^^^^^^^^^
The following restrictions apply to FACE TSS message types when using |TSS|:

  - Variable-length fields are not currently supported. Only fixed-size data
    types may be used.
    

Dynamic Memory Allocation
^^^^^^^^^^^^^^^^^^^^^^^^^
|TSS| does *not* return dynamically allocated memory when built for FACE 
Safety Base or Safety Extended profiles. Dynamically alloated 
memory in the generated TSS plug-ins is also *not* returned.


QoS Mutability
^^^^^^^^^^^^^^^
DDS QoS are set upon creation and cannot be modified thereafter.


TS Interface Limitations
^^^^^^^^^^^^^^^^^^^^^^^^^^
The following limitations apply to the FACE TS Interface API when using |TSS|:

  - :ref:`API_create_conn`

    - FACE::PUB_SUB is the only supported messaging pattern type.

  - :ref:`API_get_conn_params`

    - Only the connection direction is populated with valid information.

Callbacks Interface Restrictions
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Due to implementation limitations with |CONNEXT_MICRO| (versions 2.4.x), the
FACE TSS callback interface is not supported when using |CONNEXT_MICRO| for
the FACE Safety Base profile.


XML Parser
^^^^^^^^^^
An external library, libroxml.so 2.2.1, is required to support XML configuration
files for |CONNEXT| *Professional* targets. This library is not
redistributed as part of |TSS| and can be obtained from
http://www.libroxml.net/. Please follow the instructions to download and build
the library in your environment.

Code Generation
^^^^^^^^^^^^^^^
Code generation for |TSS| is supported only by the *rtiddsgen* utility
(version 2.5.1.2) that is shipped with |TSS|.