Model 2651A High Power System SourceMeter® Instrument Reference Manual
Appendix E: Status model
2651A-901-01 Rev. A / March 2011
E-25
Queues
The Model 2651A uses two queues, which are first-in, first-out (FIFO) queues:
•
Output queue: Used to hold response messages.
•
Error queue: Used to hold error and status messages (see
The Model 2651A status model (
(on page E-4)) shows how the two queues
are structured with the other registers.
Output queue
All interfaces share the same output queue. The output queue sets the message available (MAV) bits
in the status model. The data in the output queue clears if the mode changes to local mode.
NOTE
You must save the data from the output queue while the instrument is communicating with the remote
command interface. All data in the output queue is cleared when the instrument returns to local mode.
Error queue
The error queue holds error and status messages. When an error or status event occurs, a message
that defines the error or status is placed in the error queue.
When a message is placed in the error queue, the error available (EAV) bit in the Status Byte
Register is set. An error or status message is cleared from the error queue when it is read. The error
queue is considered cleared when it is empty. An empty error queue clears the EAV bit in the Status
Byte Register.
The commands to control the error queue are listed below. When you read a single message in the
error queue, the oldest message is read and then removed from the queue. When the instrument
power is turned on, the error queue is initially empty. If there are problems detected when the
instrument power is turned on, entries will be placed in the queue. When empty, the error number 0
and “No Error” is placed in the queue.
Messages in the error queue include a code number, message text, severity, and TSP-Link
®
node
number. The messages are listed in
Error queue commands
Error queue command
Description
errorqueue.clear()
Clear error queue of all errors.
errorqueue.count
Number of messages in the error/event queue.
errorCode, message,
severity, errorNode =
errorqueue.next()
Request error code, text message, severity, and TSP-Link node
number.
