Main Content


Read samples and times of specified measurement in DAQ list

Since R2024a



    valuetables = readDAQList(xcpch) reads all DAQ list samples and timestamps from the specified XCP channel object xcpch, and returns the results to the cell array of timetables, valuetables. The cell array contains one timetable for each DAQ list.


    You cannot combine use of readDAQList with readDAQ or readDAQListData.

    valuetables = readDAQList(xcpch,Name=Value) accepts name-value pair arguments such as Count and ReadRaw, to specify the number and treatment of data values.


    collapse all

    Read 10 data samples as physical values for a specified DAQ list measurement.

    a2lObj = xcpA2L('myFile.a2l');
    xcpch = xcpChannel(a2lObj,'CAN','Vector','CANcaseXL 1',1);
    valuetables = readDAQList(xcpch,Count=10);

    With only one DAQ list specified, valuetables is a cell array with only one timetable in it.

    Read all available raw data values instead of converted physical values.

    valuetables = readDAQList(xcpch,ReadRaw=true);

    Input Arguments

    collapse all

    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.

    Name-Value Arguments

    Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

    Example: Count=10

    Number of data samples to read, specified as a positive integer value. The function returns fewer than Count samples if fewer samples are available.

    Example: Count=10

    Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

    Return raw data values, specified as a logical false (default) or true. If false, or unspecified, the function returns converted physical values.

    Example: ReadRaw=true

    Data Types: logical

    Output Arguments

    collapse all

    Values and times from the XCP channel DAQ lists measurements, returned in a cell array of timetables. Each timetable corresponds to a DAQ list.

    Version History

    Introduced in R2024a