Measurements Tab

Measurements are typically read-only values stored in an ECU.

The Measurements tab has a table to display all A2L file Measurement items and their properties.  Each row (below the 1st filtering row) defines a Measurement and each column is a property.  The default column configuration is shown in Figure 1.


Figure 1: The Measurements tab in the A2L file item area.

Columns in the table can be filtered, reorganized, added, and hidden.  These table features are common across all tabs in this area.

To add items to the table you can:

To edit items already in the table with the Edit Measurement dialog you can: Refer to Table 1 below for a description of each column on the Measurements tab.

Table 1: Column Descriptions for the Measurements Tab

Default Columns Description
Name Unique identifier of the Measurement.

Here are the main requirements for this field:
  • Max overall length = 1024 characters.
  • Max partial string length = 128 characters.
  • Allowed characters: A - Z, a - z, 0 - 9, underscores, periods, and brackets [ ].
  • Must NOT contain spaces.
  • First character must be a letter or an underscore.
  • Any brackets must occur in pairs at the end of a partial string.
  • Any bracket pairs must surround a number or string.
  • Name is case sensitive. (i.e. "b" and "B" are considered unique)


    • If in doubt about valid names, please refer to the ASAM specifications.
    Data Type Determines the number of bytes dedicated to the value and how those bytes are interpreted.  This property should be chosen early because it applies defaults to the Bit Mask, Lower Limit, and Upper Limit properties.

  • UBYTE - 1 byte unsigned integer
  • SBYTE - 1 byte signed integer
  • UWORD - 2 byte unsigned integer
  • SWORD - 2 byte signed integer
  • ULONG - 4 byte unsigned integer
  • SLONG - 4 byte signed integer
  • FLOAT32_IEEE - 4 byte (32 bit) floating point IEEE format
  • FLOAT64_IEEE - 8 byte (64 bit) floating point IEEE format
  • FLOAT32_TASKING - 4 byte (32 bit) floating point tasking format
    		•
    ECUAddress Memory Address of the Measurement in the ECU.
    Conversion Applies the selected Conversion Method to the value.  The dropdown selections come from the Conversion Methods tab.
    LowerLimit Lower limit of plausible range of values.  A default limit is determined mathematically by the Data Type selection.

    Note: The default limit is reapplied each time the Data Type is changed.
    UpperLimit Upper limit of plausible range of values.  A default limit is determined mathematically by the Data Type selection.

    Note: The default limit is reapplied each time the Data Type is changed.
    Resolution Smallest possible change in bits. (0 to 255)
    Accuracy Possible variation from exact value in %.
    BitMask Masks out single bits of the value to be processed.  0xFF = no mask for that byte.  This property defaults to no masking with the number of 0xFF's determined by the Data Type selection.

    Note: The default mask is reapplied each time the Data Type is changed.
    Format Display formatting applied to numerical values.  If specified, this Format property overrides any formatting in the Conversion property.

    The syntax for this field is: %Length.Layout
  • Length = overall length
  • Layout = number of decimal places
    		•
    In Group The Group this item is in.
    Hidden Columns Description
    DisplayIdentifier An alternative display name that is usually much shorter than the Name property.  Can be useful for devices with small display areas.
    KeyName Name from a map file symbol dropped into the A2L item area.
    LongIdentifier Comment or description.
    Manual Flag Manual flag setting from the Address tab on the Measurement's edit dialog.


      ASAP2 Editor Documentation - (C) Copyright 2021 Intrepid Control Systems, Inc.

    Last Update: Saturday, June 20, 2009