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:

• Drag/drop symbols from an ECU map file.
• Use the Create tool or right click menu selection.
• Import an existing A2L file.

To edit items already in the table with the Edit Measurement dialog you can:

• Double click on a cell in the table.

• Use the Edit tool or right click menu selection.

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.