..
    (c) Copyright, Real-Time Innovations, 2023. All rights reserved.
    No duplications, whole or partial, manual or electronic, may be made
    without express written permission. Any such copies, or revisions 
    thereof, must display this notice unaltered.
    This code contains trade secrets of Real-Time Innovations, Inc.

.. include:: vars.rst

Introduction
============

What is the AUTOSAR Runtime Adaptive Code Generator?
----------------------------------------------------

The |RTI_CONNEXT_TM| AUTOSAR Runtime Adaptive Code Generator is an experimental, complementary 
component of |RTI_CONNEXT| and |CONNEXT_ME|. This Code Generator is not 
necessarily intended for usage by end users, but in combination with existing AUTOSAR
configuration/generation tools targeting the Adaptive Platform.

This document is aimed at AUTOSAR Electronic Control Unit (ECU) designers, implementers, and 
integrators already familiar with the vocabulary and concepts of the AUTOSAR Adaptive Platform, 
as well as basic DDS middleware concepts. Basic DDS concepts are covered in the 
`RTI Connext Getting Started Guide <https://community.rti.com/static/documentation/connext-dds/current/doc/manuals/connext_dds_professional/getting_started_guide/index.html>`_.

The AUTOSAR Adaptive Platform and |RTI_CONNEXT_H|
.................................................

The AUTOSAR Adaptive Platform provides processes, metamodels, and tooling for the development
of ECU software in the automotive industry. A key element of ECU modeling in AUTOSAR Adaptive is 
the Adaptive Application, whose intra- and inter-ECU interfaces (with other software 
components) are modeled in great detail before the actual functional behavior is implemented. 
See the `AUTOSAR Adaptive Platform <https://www.autosar.org/standards/adaptive-platform/>`_
webpage for more details.

|RTI_CONNEXT| and |RTI_CONNEXT_ME| are RTI’s DDS middleware implementations 
that target constrained, real-time, and safety platforms. These include POSIX-based
platforms with UDP/IP and IPC support. More information on `Connext Pro <https://www.rti.com/products/connext-dds-professional>`_,
`Connext Micro <https://www.rti.com/products/connext-dds-micro>`_ and `Connext Cert <https://www.rti.com/products/connext-dds-cert>`_
can be found on the RTI website.

The AUTOSAR Runtime Adaptive Code Generator
...........................................

This AUTOSAR Runtime Adaptive Code Generator is meant to support the AUTOSAR Adaptive design 
methodology, which, in terms of intra- and inter-ECU communication relies on the
Communication Management Functional Cluster, also commonly regarded as simply *ara:com*
("ara" is a common shorthand for "AUTOSAR Runtime for Adaptive Applications").

ara:com features the concept of *Network Binding*. Any given ara:com stack provides
one or more Network Bindings, each realising the Application-facing APIs provided by 
ara:com for Service Oriented communication over different communication protocol/middleware
technologies.

As of Release 21-11 of AUTOSAR, the following Network Bindings are formally specified:

* Scalable service-Oriented MiddlewarE over IP (SOME/IP)
* Data Distribution Service (DDS)
* Signal-based communication (for Classic Platform interoperability)

This AUTOSAR Runtime Adaptive Code Generator provides code generation from ARXML model exports of the
necessary artifacts related to the *DDS Network Binding*, as of AUTOSAR Release 21-11.

As mentioned above, this generation process, and the integration that follows it is 
expected to be carried out by AUTOSAR Adaptive tools supporting the DDS Network Binding
and integrating the |RTI_CONNEXT_TM| AUTOSAR Runtime Adaptive Code Generator, in a maner as transparent
to the end user as technically possible.

.. _section-installing_integration_toolkit:

Installing the AUTOSAR Runtime Adaptive Code Generator
------------------------------------------------------

The |RTI_CONNEXT| AUTOSAR Runtime Adaptive Code Generator is installed as part of 
|CONNEXT_D|. For more information, see https://www.rti.com/drive.