Configure Model Data Elements for ASAP2 File Generation

R2026b

When you generate an ASAP2 file from a model, the ASAP2 file includes information about the data elements in your model such as characteristics and measurement variables. Each data element is described by information such as the memory address, storage structure, data types and conversion rules. In Simulink^® you can now customize how the data elements are described in an ASAP2 file. You can choose only those characteristics and measurements that you are interested in exporting into ASAP2 file.

For a data element to appear in the generated ASAP2 file, the element must use a non-auto storage class so that the code generator produces an addressable variable. You can then use the calibration profile properties to control which eligible elements are included in the ASAP2 file and how they are described.

To configure data elements for ASAP2 file generation in the Code Mappings Editor – C display, use the tabs:

• Inports

• Outports

• Parameters

• Data Stores

• Signals/States

View Calibration Attributes

1. Open a model with multiple data elements.

   openExample('ConfigurationRapidPrototypingInterface');
   cm = coder.mapping.api.get('ConfigurationRapidPrototypingInterface');

2. Open the Embedded Coder^® app. On the C Code tab, select Code Interface + Individual Element Code Mappings.

3. On the C Code tab, select Settings + Calibration and Measurement properties.

   

Configure Inport for ASAP2 File Generation

1. On the Inports tab, select an inport and click the icon.

2. Specify the measurement property fields for the inport.

   

3. Alternatively, at the command line, you can enter these commands:

   setInport(cm,'In1','CalibrationAccess','Calibration');
   setInport(cm,'In1','CompuMethod','CM_Inport');
   setInport(cm,'In1','DisplayIdentifier','inport_display_name');
   setInport(cm,'In1','Format','%4.2');

4. Build the model.

5. Generate the ASAP2 file by using this command:

   coder.asap2.export('ConfigurationRapidPrototypingInterface');

6. Verify the exported inport in the ASAP2 file and verify the fields that you specified are present.

   

You can configure an outport in the same way. By default, the Export property for all inports and outports is set to true, and these elements are exported to the A2L file. To avoid exporting an inport or an outport to the A2L file, set the Export property to false using the command:

setInport(cm,'In1','Export',false);

Configure Parameter for ASAP2 File Generation

1. On the Parameters tab, select a parameter and click the icon.

2. Specify the calibration property fields for the parameter.

   

3. Alternatively, at the command line, you can enter these commands:

   setModelParameter(cm,'LOWER','CalibrationAccess','Calibration');
   setModelParameter(cm,'LOWER','CompuMethod','CM_param');
   setModelParameter(cm,'LOWER','DisplayIdentifier','param_lower');
   setModelParameter(cm,'LOWER','Format','%4.2');

4. Build the model.

5. Generate the ASAP2 file by using this command:

   coder.asap2.export('ConfigurationRapidPrototypingInterface');

6. Verify the exported parameter in the ASAP2 file and verify the fields that you specified are present.

   

Note

For an element associated with the custom storage class where Type is set to Other , create a custom attributes class for the custom storage class and associate the custom attributes class with a Boolean property, SupportSILPIL set to true. For more information, see Interfaces That Produce Additional Generated Code.

You can configure data stores and states in the same way. By default, the Export property for signals, states, and data stores is set to true. However, for these data elements to appear in the generated A2L file, you must also configure the data element to use a non-auto storage class (for example, ExportedGlobal). Data elements with the default Auto storage class do not produce addressable variables in the generated code and are not included in the A2L file regardless of the Export setting. To avoid exporting an eligible data element to the A2L file, set the Export property to false using the command:

setModelParameter(cm,'LOWER','Export',false);

Video - Customize ASAP2 File using Calibration Profile

This video walks you through how to customize an ASAP2 file using Calibration profile.

Video Transcript