readSingleValue

Read single sample of specified measurement from memory

Syntax

value = readSingleValue(xcpch,'measurementName')

Description

value = readSingleValue(xcpch,'measurementName') acquires a single value for the specified measurement through the configured XCP channel and stores it in a variable for later use. The values are read directly from memory.

Examples

Acquire a Single Value for Triangle Measurement

Read a single value from a '100ms' event 'Triangle' measurement.

Create an object to parse an A2L file and connect that to an XCP channel.

a2lfile = xcpA2L('XCPSIM.a2l')
xcpch = xcpChannel(a2lfile,'CAN','Vector','Virtual 1',1);

Connect the channel to the server module.

connect(xcpch)

Acquire data for the 'Triangle' measurement.

value = readSingleValue(xcpch,'Triangle')

value =

    14

Input Arguments

xcpch — XCP channel

XCP channel object

XCP channel, specified as an XCP channel object created using xcpChannel. The XCP channel object can then communicate with the specified server module defined by the A2L file.

measurementName — Name of single XCP measurement

character vector | string

Name of a single XCP measurement specified as a character vector or string. Make sure measurementName matches the corresponding measurement name defined in your A2L file.

Data Types: char | string

Output Arguments

value — Value of the measurement

numeric value

Value of the selected measurement, returned as a numeric value.

Version History

Introduced in R2013a