Purpose

Reads the value of a named characteristic from an ECU identified by ECU reference handle.

Format

Input

Characteristic name is the name of the characteristic defined in the A2L database.
ECU ref in is the task reference which links to the selected ECU. This reference is originally returned from MC ECU Open.vi or MC ECU Select.vi, and then wired through subsequent VIs.
x is the horizontal index if the Characteristic consists of 1 or 2 dimensions.
y is the vertical index if the Characteristic consists of 2 dimensions.
Error in is a cluster which describes error conditions occurring before the VI executes. If an error has already occurred, the VI returns the value of the error in cluster to error out.
status is TRUE if an error occurred. This VI is not executed when status is TRUE.
code is the error code number identifying an error. A value of 0 means success. A negative value means error: VI did not execute the intended operation. A positive value means warning: VI executed intended operation, but an informational warning is returned. For a description of the code, wire the error cluster to a LabVIEW error-handling VI, such as the Simple Error Handler.
source identifies the VI where the error occurred.

Output

ECU ref out is the same as ECU ref in. Wire the task reference to subsequent VIs for this task.
Characteristic value returns a single sample for the specified Characteristic. The type of the poly output is determined by the poly VI selection. For information on the different poly VI types provided by MC Characteristic Read Single Value.vi, refer to the table in the Description section.

To select the data type, right-click the VI, go to Select Type, and select the type by name.
Error out describes error conditions. If the Error in cluster indicated an error, the Error out cluster contains the same information. Otherwise, Error out describes the error status of this VI.
status is TRUE if an error occurred.
code is the error code number identifying an error. A value of 0 means success. A negative value means error: VI did not execute the intended operation. A positive value means warning: VI executed intended operation, but an informational warning is returned. For a description of the code, wire the error cluster to a LabVIEW error-handling VI, such as the Simple Error Handler.
source identifies the VI where the error occurred.

Description

MC Characteristic Read Single Value.vi reads the value of a named characteristic from an ECU identified by ECU reference handle. The value to be read is identified by the x and y indices. If the array is 1- or 0-dimensional (simple double), y and/or x can be left unwired.

Poly VI Types for the Characteristic Value Parameter

VI Type Description
Parameter (Dbl) Returns a single scaled double value from the specified x- and y-position of the selected Characteristic name.
Parameter (Raw) Returns a single unscaled unsigned 64-bit integer value from the specified x- and y-position of the selected Characteristic name.