ASAM MCD-2 MC (ASAP2 / A2L)

Transcription

1 ASAM MCD-2 MC (ASAP2 / A2L) Data Model for ECU Measurement and Calibration Version Date: Base Standard by ASAM e.v., 2018

2 Disclaimer This document is the copyrighted property of ASAM e.v. Any use is limited to the scope described in the license terms. The license terms can be viewed at

3 Foreword 9 1 Introduction Overview Motivation Scope History 11 2 Relations to Other Standards Backward Compatibility to Earlier Releases Incompatibility of Keyword FORMULA Restriction for Brackets Win32 APIs for Seed&Key and Checksum Calculation Optional numbers for MATRIX_DIM References to Other Standards ASAM MCD-2 MC within the ASAM AE Overall Context ASAM MCD ASAM MCD ASAM MCD-2 D ODX ASAM MCD-2 NET ASAM MCD More ASAM Standards with an ASAM MCD-2 MC relation Division of the description data 16 4 Format of the description file Encoding of the A2L file Unicode Transformation Format Byte-Order Mark Whitespace definition Hierarchic division of the keywords Name Spaces Functions Groups Variants Measure and adjustable objects Transformer Conversion methods Conversion tables Memory segments Record layouts Type definitions Structure components Predefined data types ASAM MCD-2 MC Data Model for ECU MC Version

4 4.5 Mapping of predefined data Types to ASAM data types Comments Alphabetical list of keywords General A2ML A2ML_VERSION ADDR_EPK ADDRESS_TYPE ALIGNMENT_BYTE ALIGNMENT_FLOAT16_IEEE ALIGNMENT_FLOAT32_IEEE ALIGNMENT_FLOAT64_IEEE ALIGNMENT_INT ALIGNMENT_LONG ALIGNMENT_WORD ANNOTATION ANNOTATION_LABEL ANNOTATION_ORIGIN ANNOTATION_TEXT ARRAY_SIZE AR_COMPONENT AR_PROTOTYPE_OF ASAP2_VERSION AXIS_DESCR AXIS_PTS AXIS_PTS_REF AXIS_PTS_X / _Y / _Z / _4 / _ AXIS_RESCALE_X BIT_MASK BIT_OPERATION BLOB BYTE_ORDER CALIBRATION_ACCESS CALIBRATION_HANDLE CALIBRATION_HANDLE_TEXT CALIBRATION_METHOD CHARACTERISTIC COEFFS COEFFS_LINEAR COMPARISON_QUANTITY COMPU_METHOD COMPU_TAB COMPU_TAB_REF COMPU_VTAB COMPU_VTAB_RANGE CONSISTENT_EXCHANGE CONVERSION CPU_TYPE CURVE_AXIS_REF CUSTOMER CUSTOMER_NO DATA_SIZE DEF_CHARACTERISTIC ASAM MCD-2 MC Data Model for ECU MC Version

5 DEFAULT_VALUE DEFAULT_VALUE_NUMERIC DEPENDENT_CHARACTERISTIC DEPOSIT DISCRETE DISPLAY_IDENTIFIER DIST_OP_X / _Y / _Z / _4 / _ ECU ECU_ADDRESS ECU_ADDRESS_EXTENSION ECU_CALIBRATION_OFFSET ENCODING EPK ERROR_MASK EXTENDED_LIMITS FIX_AXIS_PAR FIX_AXIS_PAR_DIST FIX_AXIS_PAR_LIST FIX_NO_AXIS_PTS_X / _Y / _Z / _4 / _ FNC_VALUES FORMAT FORMULA FORMULA_INV FRAME FRAME_MEASUREMENT FUNCTION FUNCTION_LIST FUNCTION_VERSION GROUP GUARD_RAILS HEADER IDENTIFICATION IF_DATA (Example) IN_MEASUREMENT INPUT_QUANTITY INSTANCE LAYOUT LEFT_SHIFT LIMITS LOC_MEASUREMENT MAP_LIST MATRIX_DIM MAX_GRAD MAX_REFRESH MEASUREMENT MEMORY_LAYOUT MEMORY_SEGMENT MOD_COMMON MOD_PAR MODEL_LINK MODULE MONOTONY NO_AXIS_PTS_X / _Y / _Z / _4 / _ NO_OF_INTERFACES ASAM MCD-2 MC Data Model for ECU MC Version

6 NO_RESCALE_X NUMBER OFFSET_X / _Y / _Z / _4 / _ OUT_MEASUREMENT OVERWRITE PHONE_NO PHYS_UNIT PROJECT PROJECT_NO READ_ONLY READ_WRITE RECORD_LAYOUT REF_CHARACTERISTIC REF_GROUP REF_MEASUREMENT REF_MEMORY_SEGMENT /DEPRECATED REF_UNIT RESERVED RIGHT_SHIFT RIP_ADDR_W / _X / _Y / _Z / _4 / _ ROOT SHIFT_OP_X / _Y / _Z / _4 / _ SIGN_EXTEND SI_EXPONENTS SRC_ADDR_X / _Y / _Z / _4 / _ STATIC_ADDRESS_OFFSETS STATIC_RECORD_LAYOUT STATUS_STRING_REF STEP_SIZE STRUCTURE_COMPONENT SUB_FUNCTION SUB_GROUP SUPPLIER SYMBOL_LINK SYMBOL_TYPE_LINK SYSTEM_CONSTANT TRANSFORMER TRANSFORMER_IN_OBJECTS TRANSFORMER_OUT_OBJECTS TYPEDEF_AXIS TYPEDEF_BLOB TYPEDEF_CHARACTERISTIC TYPEDEF_MEASUREMENT TYPEDEF_STRUCTURE UNIT UNIT_CONVERSION USER USER_RIGHTS VAR_ADDRESS VAR_CHARACTERISTIC VAR_CRITERION VAR_FORBIDDEN_COMB VAR_MEASUREMENT VAR_NAMING ASAM MCD-2 MC Data Model for ECU MC Version

7 VAR_SELECTION_CHARACTERISTIC VAR_SEPARATOR VARIANT_CODING VERSION VIRTUAL VIRTUAL_CHARACTERISTIC Include mechanism ASAM MCD-2 MC Metalanguage General Format of the ASAM MCD-2 MC metalanguage Designing AML-file Terms and Definitions Symbols and Abbreviated Terms Bibliography 276 Appendix: A. IEEE-Floating-Point-Format 277 A Bit Format A Bit Format A Bit Format Appendix: B. Using Reference Curves as Normalization Axes for Maps 279 B.1. Background B.1.1. General B.1.2. Overall technique B.1.3. Determining the map indices B.1.4. Determining the map normalized value B.2. Example Appendix: C. Codes for scaling units (CSE) 282 Appendix: D. Transformer 284 D.1. Basics D.2. Transformer DLL API definition and rules D.2.1. General API description D.2.2. Detailed C transformer API definition D Typedefs D IsTransformationPossible DLL Function D GetTransformerDescription DLL Function D GetDllDescription DLL Function D ExecuteTransformation DLL Function ASAM MCD-2 MC Data Model for ECU MC Version

8 Appendix: E. ASAP2 Container 294 E.1. Container E.2. Common E.3. Category E.4. ABLOCK E.5. FILES E.6. AREF E.7. Example for Container Catalog File Appendix: F. Formulas 302 F.1. Basic Formula F.2. Extended Formula Appendix: G. Calculation of Dependent Characteristics 305 G.1. Background G.1.1. General G.1.2. Supported Characteristics G.1.3. Combination of Characteristic Types G.1.4. Execution Time G.1.5. Calculation Sequence G.1.6. Data Types G.1.7. Computation Methods G.1.8. Special functions for Dependent Characteristics G Function min(x) G Function max(x) G Function interp(x,a [,b [,c [,d [,e]]]] ) G.2. Example G.2.1. Existing characteristics G Arrays G Curves G Maps G Scalars G.2.2. Dependent characteristics G.2.3. Example " Dependent Function interp()" Index of Keywords and Enum Values 315 Figure Directory 318 Table Directory 319 ASAM MCD-2 MC Data Model for ECU MC Version

9 Foreword Foreword ASAM MCD-2 MC describes a data model for ECU Measurement and Calibration via a non XML format. Such data resides inside the memory of the ECU. The format definition makes the data accessible through application systems for tuning real-time testing. The description contains information about data types, dimensions, record layouts and memory locations of ECU variables. Further information describes how the variable values shall be converted into human-readable quantities and displayed in an MC-System. In addition to the data description, the standard allows to describe the device interface between the MC-System and the ECU for read- and write access. As a result, the ASAM MCD-2 MC description contains all information in one place that is needed to access, modify, interpret and display ECU-internal variables. The format definition describes the following content: A2L description file keywords AML format description AML template A2L and AML example ASAM MCD-2 MC Data Model for ECU MC Version