Instrument Control Toolbox    
BytesAvailableActionMode

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

Description

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

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

The bytes-available event executes the M-file action function specified for the BytesAvailableAction property.

You can configure BytesAvailableActionMode 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
String

Values

Serial and VISA-serial

{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 are available.

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

{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 are available.

See Also

Functions

fclose

Properties

BytesAvailableAction, BytesAvailableActionCount, EOSCharCode, Status, Terminator


 BytesAvailableActionCount BytesToOutput