Define AUTOSAR Compositions by Creating or Linking Models

After you add Software Composition blocks in your AUTOSAR architecture model, you can:

Create a model based on the composition block interface.
Link to a composition saved as an independent implementation model.
Create a model from an AUTOSAR XML (ARXML) composition description using the importFromARXML function.

To initiate these actions, select a Software Composition block.

Place your cursor over the displayed ellipsis, and select a composition model cue — Save Composition as Architecture Model..., Link to Model..., or Import Composition from ARXML.

Composition block with action bar Link to Model option highlighted after selecting ellipsis.

The selections open dialog boxes that help you create or link a model that is defined by the Software Composition block.

The creation and linking actions can be initiated in other ways, for example, from an architecture block context menu or from the toolstrip Modeling tab under Elaborate.

Modeling tab showing Elaborate section with linking actions.

If you have Embedded Coder^® software, you can use composition block cues to generate code and export ARXML files. The ARXML export uses the XML options of the parent architecture model.

Create Simulink Implementation Model from AUTOSAR Software Composition

To create an implementation model from a composition block use the cue Save Composition as Architecture Model... on the Software Composition block. The pictured composition can be found in the 'autosar_tpc_composition' example model. Access this model by running the following at the MATLAB^® command line:

openExample('autosar_tpc_composition');

Sensors composition block with Save Composition as Architecture Model cue selected.

Clicking the cue creates a model based on the interface of the authored composition. Ports that you created on the software composition block are present in the implementation model.

Link AUTOSAR Software Composition to a Composition Implementation Model

To reference an existing Simulink^® implementation model from an AUTOSAR Software Composition block, use the block cue Link to Model. Clicking the cue initiates linking of the composition block to an implementation model that you specify. By linking to existing models, you can deploy verified implementation models in your AUTOSAR design without re-qualification.

Composition block with action bar Link to Model option highlighted after selecting ellipsis.

The implementation model must meet model linking requirements. The model must:

Use the same AUTOSAR target as the architecture model.
Have a complete mapping of Simulink model elements to AUTOSAR component elements.
Implement root-level ports with In Bus Element and Out Bus Element blocks instead of Inport and Outport blocks.
Use a fixed-step solver.

If the specified implementation model meets the linking requirements, the software links the composition block to the model and updates the block and model interfaces to match.

If the implementation model does not meet one or more of the linking requirements, the software opens the AUTOSAR Model Linker app, which offers fixes for the unmet requirements. For example, if an implementation model uses root Inport and Outport blocks, the app offers to fix the issue by converting the signal ports to bus ports. When you click Fix All, the software fixes the unmet requirements and finishes linking the composition block to the model.

This example describes how to link an AUTOSAR classic composition to an existing implementation model. The workflow for linking an adaptive component to an implementation model is the same.

Create or open an architecture model. To create a model, open the Simulink Start Page. Under AUTOSAR Blockset, open the Software Architecture template.
From the Modeling tab, in the Platform section, confirm that the AUTOSAR platform is correct. For this example, select Classic Platform.
From the Modeling tab or the palette, add a Software Composition block to the model. The Property Inspector displays the component Kind property as Composition, which is correct for this composition.
Link the Composition block to an implementation model that is already configured for architecture model use. This example uses the autosar_tpc_composition model.
```
openExample('autosar_tpc_composition')
```
Select the Composition block, place your cursor over the displayed ellipsis, and select the block cue Link to Model.
In the Link to Model dialog box, browse to the implementation model swc.
To reference the implementation model from the AUTOSAR Composition block, click OK.
If the specified implementation model does not meet one or more of the linking requirements, the software opens the AUTOSAR Model Linker app, which offers fixes for the unmet requirements.
If the Linking Requirements pane displays a Fix All button, you are ready to fix the unmet linking requirements and link the composition block to the implementation model. Click Fix All.
For more information, see Author AUTOSAR Compositions and Components in Architecture Model.
Simulink links the Composition block to model autosar_tpc_composition and updates the block interface to match the model implementation.
To view the model content, open the Composition block.

Create Model from ARXML Composition Description

This example imports a software composition description ThrottlePositionControlComposition from the AUTOSAR example file ThrottlePositionControlComposition.arxml into an existing architecture model. The workflow is the same for creating an adaptive model from ARXML.

The ARXML file is located at matlabroot/examples/autosarblockset/data, which is on the default MATLAB path.

To create an AUTOSAR implementation model from an ARXML composition description and map it to an AUTOSAR Software Composition block, use the Software Composition block cue Import Composition from ARXML.

Composition block with Import Composition from ARXML cue selected.

Clicking the cue creates a model based on a specified ARXML description, links the composition block to the model, and updates the block and model interfaces to match.

Create or open an architecture model. To create a model, open the Simulink Start Page. Under AUTOSAR Blockset, open the Software Architecture template.
From the Modeling tab, in the Platform section, confirm that the AUTOSAR platform is correct. For this example, select Classic Platform.
From the Modeling tab or from the palette, add a Software Composition block to the model and name it Composition.
Select the Composition block, place your cursor over the displayed ellipsis, and select the cue Import Composition from ARXML. The AUTOSAR Importer App opens.
Work through the import and model creation procedure.
In the Select ARXML pane, browse to one or more AUTOSAR XML files that provide one or more software composition descriptions. This example uses a file copied in an earlier step, ThrottlePositionControlComposition.arxml. To import the description, click Next.
In the Create Composition pane, select the software component from which to create a model. From the list of components imported in the previous step, this example selects Controller.
To view optional settings for model creation, select Configure Modeling Options.
You can:
- Model periodic runnables as atomic subsystems or function-call subsystems, or accept a default modeling style selection (Auto).
- Select an existing AUTOSAR runnable as the initialization runnable for the component.
- Specify a Simulink data dictionary into which to import data objects corresponding to AUTOSAR data types in the XML file. If the specified dictionary does not already exist, the importer creates it. The model is then associated with the data dictionary.
- Select an AUTOSAR PredefinedVariant defined in the AUTOSAR XML file to initialize SwSystemconst data that serves as input to control variation points. For more information, see Control AUTOSAR Variants with Predefined Value Combinations. In this example, no PredefinedVariant is available for selection.
For more information about model creation options, see createCompositionAsModel.
To create the model and map it to the AUTOSAR Software Composition, click Finish. Simulink creates model ThrottlePositionControlComposition.slx in the working folder and updates the block interface to match the model implementation.
To view the model content, open the Composition block.