Main Content

BytesAvailableFcnMode

Specify whether bytes-available event is generated after specified number of bytes are available in input buffer, or after terminator is read

Description

For serial port, TCPIP, UDP, or VISA-serial objects, you can configure BytesAvailableFcnMode to be terminator or byte. For all other instrument objects, you can configure BytesAvailableFcnMode to be eosCharCode or byte.

If BytesAvailableFcnMode is terminator, a bytes-available event occurs when the terminator specified by the Terminator property is read. If BytesAvailableFcnMode is eosCharCode, a bytes-available event occurs when the End-Of-String character specified by the EOSCharCode property is read. If BytesAvailableFcnMode is byte, a bytes-available event occurs when the number of bytes specified by the BytesAvailableFcnCount property is available.

The bytes-available event executes the callback function specified for the BytesAvailableFcn property.

You can configure BytesAvailableFcnMode only when the object is disconnected from the instrument. You disconnect an object with the fclose function. A disconnected object has a Status property value of closed.

Characteristics

Usage

Any instrument object

Read only

While open

Data type

Character vector

Values

Serial, TCPIP, UDP, and VISA-Serial

Default value is enclosed in braces ({}).

{terminator}

A bytes-available event is generated when the terminator is reached.

byte

A bytes-available event is generated when the specified number of bytes available.

GPIB, VISA-GPIB, VISA-VXI, and VISA-GPIB-VXI

Default value is enclosed in braces ({}).

{eosCharCode}

A bytes-available event is generated when the EOS (End-Of-String) character is reached.

byte

A bytes-available event is generated when the specified number of bytes is available.