ECU Measurement and Calibration Toolkit C API Reference

Content Type
Programming Language
Current manual

mcMeasurementReadRaw

mcMeasurementReadRaw

Purpose

Reads a single raw (unscaled) Measurement value from the ECU.

Format

mcTypeStatus mcMeasurementReadRaw(
mcTypeTaskRefECURefNum,
char*MeasurementName,
u64*Value);

Input

ECURefNum

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

MeasurementName

MeasurementName is the name of a Measurement channel stored in the A2L database file from which a Measurement value is to be read.

Output

Value

Returns a single sample for the Measurement channel initialized in MeasurementName.

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 mcStatusToString function of the ECU M&C API to obtain a descriptive string for the return value.

Description

mcMeasurementReadRaw performs a single point read (upload) of a single raw Measurement from the selected ECU without opening a Measurement task.

Was this information helpful?