Agilent Technologies VXI E1439 - Manual (Page 186)

176
Agilent E1439 Programmer's Reference
Functions listed alphabetically
age1439_status_get
Reads status register information for the module.
VXIplug&play Syntax
#include "age1439".h
ViStatus age1439_status_get(ViSession id, ViPInt16 statusPtr);
Parameters
id is the VXI instrument session pointer returned by the age1439_init function.
statusPtr points to the status word. The bits are defined below:
Status Bit Definition Description
0-1 AGE1439_STATUS_MEAS_ARM_WAIT
AGE1439_STATUS_MEAS_IDLE
AGE1439_STATUS_MEAS_IN_
PROGRESS
AGE1439_STATUS_MEAS_TRIG_WAIT These two bits indicate the current state of the
measurement loop. See
“The measurement loop” in
chapter 3 and “age1439_meas_status_get” on page 156
for more information about these states
2 AGE1439_STATUS_PASSED Passed: This bit is always set to 1
3 AGE1439_STATUS_READY This bit is set when the module is ready after power-on. See
the VXIbus Specifications for more information.
4 AGE1439_STATUS_FIBER_ACTIVE This bit is set internally whenever any data has been written
to the receive FIFO, or read from the transmit FIFO of the
fiber interface within the past 500 milliseconds,
approximately. The bit is cleared automatically when activity
ceases on the fiber interface
5 AGE1439_STATUS_FIBER_ERROR This bit is set internally whenever an error condition occurs
on the fiber interface. Reading the status register does not
clear this bit. To do this, the
age1439_fiber_error_clear
function must be used explicitly. The function age1439_
fiber_error_get can be used to read the contents of the fiber
error register. If the error is continuously present, the bit will
not be cleared.
6 AGE1439_STATUS_SETUP_ERROR Setup error: An invalid parameter value was requested. If an
invalid block size was requested, the closest valid block size
is used until a change to an interrelated parameter makes the
requested block size valid. If a data resolution, data type,
filter bandwidth, trigger delay, or filter decimation parameter
was requested which would result in an inability to make a
measurement, the previous valid parameter is used until a
change to an interrelated parameter makes the requested
parameter valid
7 AGE1439_STATUS_SYNC_COMPLETE Sync/Idle Complete: This bit is set when the most recent
user-initiated Sync or Idle change has propagated through to
all modules in a system. The change is a result of asserting
Sync or forcing Idle via the Control Register or issuing a
meas_control command or function