Instrument Control Toolbox

Event Types and Action Properties

The GPIB event types and associated action properties are described below.

Table 3-9: GPIB Event Types and Action Properties  

Event Type	Associated Property Name
Bytes available	BytesAvailableAction
	BytesAvailableActionCount
	BytesAvailableActionMode
Error	ErrorAction
Output empty	OutputEmptyAction
Timer	TimerAction
	TimerPeriod

Bytes-Available Event.   A bytes-available event is generated immediately after a predetermined number of bytes are available in the input buffer or the End-Of-String character is read, as determined by the BytesAvailableActionMode property.

If BytesAvailableActionMode is byte, the bytes-available event executes the action function specified for the BytesAvailableAction property every time the number of bytes specified by BytesAvailableActionCount is stored in the input buffer. If BytesAvailableActionMode is eosCharCode, then the action function executes every time the character specified by the EOSCharCode property is read.

This event can be generated only during an asynchronous read operation.

Error Event.   An error event is generated immediately after an error, such as a timeout, occurs. A timeout occurs if a read or write operation does not successfully complete within the time specified by the Timeout property. An error event is not generated for configuration errors such as setting an invalid property value.

This event executes the action function specified for the ErrorAction property. It can be generated only during an asynchronous read or write operation.

Output-Empty Event.   An output-empty event is generated immediately after the output buffer is empty.

This event executes the action function specified for the OutputEmptyAction property. It can be generated only during an asynchronous write operation.

Timer Event.   A timer event is generated when the time specified by the TimerPeriod property passes. Time is measured relative to when the object is connected to the instrument.

This event executes the action function specified for the TimerAction property.

Using Events and Actions

Storing Event Information