MC Characteristic Write Single Value.vi

ECU Measurement and Calibration Toolkit Help

Edition Date: October 2018

Part Number: 371602T-01

»View Product Info
Download Help (Windows Only)

Purpose

Writes a value to a named Characteristic on the ECU.

Format

diagram

Input

string Characteristic name is the name of the Characteristic defined in the A2L database to which one value may be written.
long unsigned integer 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.
long unsigned integer x is an input that refers to the array offset if the Characteristic is defined in the A2L database file as 1- or 2-dimensional. If the Characteristic is defined as having 0 dimensions, the input can be left unwired.
long unsigned integer y is an input that refers to the array offset if the Characteristic is defined in the A2L database file as 2-dimensional. If the Characteristic is defined as having 0 or 1 dimensions, the input can be left unwired.
cluster 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.
boolean status is TRUE if an error occurred. This VI is not executed when status is TRUE.
long unsigned integer 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.
string source identifies the VI where the error occurred.
poly Characteristic value is the value to be set for the Characteristic. The type of the poly input is determined by the poly VI selection. For information on the different poly VI types provided by MC Characteristic Write 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.

Output

long unsigned integer ECU ref out is the same as ECU ref in. Wire the task reference to subsequent VIs for this task.
cluster 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.
boolean status is TRUE if an error occurred.
long signed integer 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.
string source identifies the VI where the error occurred.

Description

MC Characteristic Write Single Value.vi writes a value to a defined Characteristic on the ECU which is identified by the ECU Reference handle. The location to which the value is written is identified by the x and y indices. If the Characteristic array has 0 or 1 dimensions, y and/or x can be left unwired.

Poly VI Types for the Characteristic Value Parameter

VI TypeDescription
Parameter (Dbl)Writes a single scaled double value at the specified x- and y-position to the selected Characteristic name.
Parameter (Raw)Writes a single unscaled unsigned 64-bit integer value at the specified x- and y-position to the selected Characteristic name.

WAS THIS ARTICLE HELPFUL?

Not Helpful