Purpose

Creates a Measurement object in memory. Format

mcTypeStatus mcMeasurementCreate(
mcTypeTaskRef ECURefNum,
char *MeasurementName,
mcAddress Address,
i32 DataType,
u8 DataSize,
char *ConversionName);

Input

ECURefNum

ECURefNum is the task reference which links to the selected ECU. This reference is originally returned from mcECUCreate.

Address

Configures the target address for the programming operation in the ECU. mcAddress is a C struct consisting of:

Address

Specifies the address part of the programming address.

Extension

Extension contains the extension part of the address.

DataType

DataType sets the data type of the measurement task.

DataType Data Format
0 Unsigned byte
1 Signed byte
2 Unsigned word
3 Signed word
4 Unsigned long
5 Signed long
6 Float 32

DataSize

Sets the size of the measurement data and corresponds to the selected DataType.

Data Format DataSize
Unsigned byte 1
Signed byte 1
Unsigned word 2
Signed word 2
Unsigned long 4
Signed long 4
Float 32 4

ConversionName

ConversionName identifies the referred conversion object that mcConversionCreate defines. Output

Return Value

The return value indicates the status of the function call as a signed 32-bit integer. Zero means the function executed successfully. A negative value specifies an error, which means the function did not perform the expected behavior. A positive value specifies a warning, which means the function performed as expected, but a condition arose that may require attention.

Use the function of the ECU M&C API to obtain a descriptive string for the return value.

Description

Use mcMeasurementCreate to create a measurement object in memory instead of referring to a predefined measurement in the A2L database.