Main Content

Import AUTOSAR Component to Simulink

Create Simulink® model from XML description of AUTOSAR software component.

Import AUTOSAR Component from ARXML File to Simulink

Here is an AUTOSAR application software component that implements a controller in an automotive throttle position control system. The controller component takes input values from an accelerator pedal position (APP) sensor and a throttle position sensor (TPS). The controller translates the values into input values for a throttle actuator.

The component was created in an AUTOSAR authoring tool and exported to the file ThrottlePositionControlComposition.arxml.

Use the MATLAB function createComponentAsModel to import the AUTOSAR XML (ARXML) description and create an initial Simulink representation of the AUTOSAR component. First, parse the ARXML description file and list the components it contains.

ar = arxml.importer('ThrottlePositionControlComposition.arxml');
names = getComponentNames(ar)
names = 5x1 cell
    {'/Company/Components/Controller'                     }
    {'/Company/Components/ThrottlePositionMonitor'        }
    {'/Company/Components/AccelerationPedalPositionSensor'}
    {'/Company/Components/ThrottlePositionActuator'       }
    {'/Company/Components/ThrottlePositionSensor'         }

For the Controller software component, use createComponentAsModel to create a Simulink representation.

createComponentAsModel(ar,'/Company/Components/Controller',...
    'ModelPeriodicRunnablesAs','AtomicSubsystem');

The function call creates a component model that represents an AUTOSAR application software component. An atomic subsystem represents an AUTOSAR periodic runnable, and an Initialize Function block represents an AUTOSAR initialize runnable. Simulink inports and outports represent AUTOSAR ports.

em_controller_initial_import.png

Develop AUTOSAR Component Algorithm, Simulate, and Generate Code

After creating an initial Simulink representation of the AUTOSAR component, you develop the component. You refine the AUTOSAR configuration and create algorithmic model content.

For example, the Runnable_Step_sys subsystem in the Controller component model contains an initial stub implementation of the controller behavior.

em_controller_runnablestepsys.png

Here is a possible implementation of the throttle position controller behavior. (To explore this implementation, see the model autosar_swc_controller, which is provided with the example Design and Simulate AUTOSAR Components and Generate Code.) The component takes as inputs an APP sensor percent value from a pedal position sensor and a TPS percent value from a throttle position sensor. Based on these values, the controller calculates the error. The error is the difference between where the operator wants the throttle, based on the pedal sensor, and the current throttle position. In this implementation, a Discrete PID Controller block uses the error value to calculate a throttle command percent value to provide to a throttle actuator. A scope displays the error value and the Discrete PID Controller block output value over time.

As you develop AUTOSAR components, you can:

  • Simulate the component model individually or in a containing composition or test harness.

  • Generate ARXML component description files and algorithmic C code for testing in Simulink or integration into an AUTOSAR run-time environment. (AUTOSAR code generation requires Simulink Coder and Embedded Coder.)

For more information on developing, simulating, and building AUTOSAR components, see example Design and Simulate AUTOSAR Components and Generate Code.

Update AUTOSAR Component Model with Architectural Changes from Authoring Tool

Suppose that, after you imported the AUTOSAR software component into Simulink and began developing algorithms, architectural changes were made to the component in the AUTOSAR authoring tool.

Here is the revised component. The changes add a control override receive port and a throttle command override provide port. In the AUTOSAR authoring tool, the revised component is exported to the file ThrottlePositionControlComposition_updated.arxml.

Use the MATLAB function updateModel to import the architectural revisions from the ARXML file. The function updates the AUTOSAR component model with the changes and reports the results.

ar2 = arxml.importer('ThrottlePositionControlComposition_updated.arxml');
updateModel(ar2,'Controller');
### Updating model Controller
### Saving original model as Controller_backup.slx
### Creating HTML report Controller_update_report.html

After the update, in the component model, highlighting indicates where changes occurred.

em_update_added_blocks.png

The function also generates and displays an HTML AUTOSAR update report. The report lists changes that the update made to Simulink and AUTOSAR elements in the component model. In the report, you can click hyperlinks to navigate from change descriptions to model changes.

Connect the added blocks, update the inports and outports inside the subsystem, and update the model diagram. For example:

em_controller_connected_added_blocks.png

Related Links