Instrument Control Toolbox

ValuesReceived

Indicate the total number of values read from the instrument

Description

ValuesReceived indicates the total number of values read from the instrument. The value is updated after each successful read operation, and is set to 0 after the fopen function is issued. If the terminator is read from the instrument, then this value is reflected by ValuesReceived.

If you are reading data asynchronously, use the BytesAvailable property to return the number of bytes currently available in the input buffer.

When performing a read operation, the received data is represented by values rather than bytes. A value consists of one or more bytes. For example, one uint32 value consists of four bytes. Refer to The Output Buffer and Data Flow for more information about bytes and values.

Characteristics

Usage	Any instrument object
Read only	Always
Data type	Double

Values

The default value is 0.

Example

Suppose you create a serial port object associated with the serial port COM1.

• s = serial('COM1');
  fopen(s)
  

If you write the RS232? command, and then read back the response using fscanf, ValuesReceived is 17 because the instrument is configured to send the LF terminator.

• fprintf(s,'RS232?')
  out = fscanf(s)
  out =
  9600;0;0;NONE;LF
  s.ValuesReceived
  ans =
      17
  

See Also

Functions

fopen

Properties

BytesAvailable

UserData

ValuesSent