updateModel

Update AUTOSAR model or architecture with ARXML changes

Syntax

updateModel(ar,modelName)

updateModel(ar,archModelName)

updateModel(___,"OpenReport"=OpenReportValue)

Description

updateModel(ar,modelName) updates the specified open model with changes found in the XML files associated with arxml.importer object ar. The XML files must contain the AUTOSAR software component mapped by the model, and must be suitable for code generation.

When comparing the current version of the XML file with the previous version, the comparison routine applies these rules in order:

1. If elements have the same UUID and type, the elements match. The function does not update the model.

2. If elements have different UUIDs, the elements do not match. The function updates the model with the ARXML change.

3. If elements have the same qualified name, the elements match. The function does not update the model.

4. Otherwise, elements do not match. The function updates the model with the ARXML changes.

The update generates and opens a report that details the changes made to the model, and required changes that were not made by the function. You can control whether this report opens using the OpenReport argument.

AUTOSAR package structure updates affect the stored AR-PACKAGE structure and are applied to future exports. Imported package structure updates do not affect AUTOSAR Dictionary package path XML options. The XML package path options apply to AUTOSAR elements created in Simulink^® rather than to imported elements.

This function is supported only for AUTOSAR Classic models.

updateModel(ar,archModelName) updates the specified open architecture model with changes found in the XML files associated with arxml.importer object ar. The XML files must contain the AUTOSAR software composition mapped by the model, and must be suitable for code generation.

updateModel(___,"OpenReport"=OpenReportValue) specifies name-value argument OpenReport in addition to any of the input argument combinations in previous syntaxes. To specify that the AUTOSAR Update Report opens when the update process is complete, set OpenReport to "on".

Examples

Update Model with AUTOSAR ARXML Changes

Update model mySWC with the AUTOSAR ARXML changes described in updatedSWC.arxml and open the AUTOSAR Update Report.

open_system("mySWC")
ar = arxml.importer("updatedSWC.arxml");
updateModel(ar,"mySWC","OpenReport"="on");

### Updating model mySWC
### Saving original model as mySWC_backup.slx
### Creating HTML report mySWC_update_report.html

Update Architecture Model with AUTOSAR ARXML Changes

Update an architecture model, myArchModel with the AUTOSAR ARXML changes described in updatedArchModel.arxml and open the AUTOSAR Update Report.

arModel = autosar.arch.loadModel("ControllerArchitecture");
impObj = arxml.importer("ControllerArchitecture.arxml");
updateModel(impObj,arModel)

### Updating model autosar_tpc_controller_bus
### Saving original model as autosar_tpc_controller_bus_backup_1.slx
### Creating HTML report autosar_tpc_controller_bus_update_report.html
Updated model 'autosar_tpc_controller_bus' for component 1 of 1: /Components/autosar_tpc_controller_bus
### Saving original model as ControllerArchitecture_backup.slx
Updating composition 1 of 1: /Components/ControllerArchitecture
### Creating HTML report ControllerArchitecture_update_report.html 

Input Arguments

ar — arxml.importer object

handle

AUTOSAR information previously imported from XML files, specified as an arxml.importer object handle.

modelName — Model name

character vector | string scalar

Name of an open model to be updated with changes in the XML files associated with an arxml.importer object.

Example: "mySWC"

archModelName — Architecture model name

character vector | string scalar

Name of an open architecture model to be updated with changes in the XML files associated with an arxml.importer object.

Example: "myArchModel"

OpenReportValue — Option to open report

"on" (default) | "off"

Option to open the AUTOSAR Update Report upon updating AUTOSAR properties, specified as "on" or "off".

• "on" — The report opens.

• "off" — The report does not open.

Example: updateModel(ar,"myControllerModel","OpenReport","off")

Limitations

You can branch ports to multiple runnable systems. If an ARXML update removes data access for some but not all runnables accessing the port, then the software does not update the model canvas and the AUTOSAR Update Report does not indicate a change. The connectors and ports on the affected runnable system must be removed manually.

Version History

Introduced in R2014a

R2024b: Update AUTOSAR model or architecture without opening the AUTOSAR Update Report

You can choose whether to open or not open the AUTOSAR Update Report when you update an AUTOSAR model or architecture.

R2024a: Support for AUTOSAR Classic architecture models

Starting in R2024a, you can update architecture models configured for the AUTOSAR Classic Platform from ARXML files using the updateModel function or the Update from ARXML button on the Modeling toolstrip.

R2022b: Import for Basic Software blocks

updateModel supports generating AUTOSAR Basic Software (BSW) caller blocks when updating with ARXML-imported software components that access Diagnostic Event Manager (Dem), NVRAM Manager (NvM), or Function Inhibition Manager (FiM) services.