pipx40_getSubStatus
ViStatus pipx40_getSubStatus (ViSession instrumentHandle,
ViUInt32 subunitNumber,
ViPUInt32 subunitStatus);
Purpose
Obtains bit-flags indicating the current operational status of a sub-unit. Certain card-level conditions affecting the sub-unit's functionality are also reported.
Diagnostic information on any fault conditions indicated in the status value can be obtained using "Get Diagnostic Information" - function pipx40_getDiagnostic().
Parameters
| Input |
| Name |
Type |
Description |
| instrumentHandle |
ViSession |
Instrument handle obtained by the pipx40_init call used to open the card.
|
| subunitNumber |
ViUInt32 |
The number of the sub-unit to access.
Valid Values: 1 thru the number of output sub-units available
on the card
|
| Output |
| Name |
Type |
Description |
| subunitStatus |
ViUInt32 (passed by reference) |
Variable to receive a set of bit-flags indicating the current operational status of the sub-unit.
Bit Significance:
0x00000000 = pipx40_STAT_OK
Card functional and stable
0x80000000 = pipx40_STAT_NO_CARD
No Pickering card open on the session
0x40000000 = pipx40_STAT_WRONG_DRIVER
Card requires later driver version
0x20000000 = pipx40_STAT_EEPROM_ERR
Error interpreting card EEPROM data
0x10000000 = pipx40_STAT_DISABLED
Card is disabled
0x08000000 = pipx40_STAT_NO_SUB
Card has no sub-unit with specified number
0x04000000 = pipx40_STAT_BUSY
Sub-unit operations not yet completed
0x02000000 = pipx40_STAT_HW_FAULT
Hardware fault
0x01000000 = pipx40_STAT_PARITY_ERROR
PCIbus parity error
0x00800000 = pipx40_STAT_PSU_INHIBITED
PSU sub-unit - supply is disabled (by software)
0x00400000 = pipx40_STAT_PSU_SHUTDOWN
PSU sub-unit - supply is shutdown (due to
overload)
0x00200000 = pipx40_STAT_PSU_CURRENT_LIMIT
PSU sub-unit - supply is operating in
current-limited mode
0x00100000 = pipx40_STAT_CORRUPTED
Sub-unit logical state is corrupted
0x00080000 = pipx40_STAT_CARD_INACCESSIBLE
Card cannot be accessed
(failed/removed/unpowered)
0x00040000 = pipx40_STAT_UNCALIBRATED
Sub-unit is uncalibrated
0x00020000 = pipx40_STAT_CALIBRATION_DUE
Sub-unit is due for calibration
|
Return Value
| Name |
Type |
Description |
| status |
ViStatus |
A numeric code indicating the success or failure of the operation.
VI_SUCCESS = Successful operation.
Negative values are error codes and positive values are warnings.
To get a description of an error, pass the error code to pipx40_error_message.
|
References
ID & Status
Pickering Interfaces PXI VISA
Alphabetical Function Index
Hierarchical Function Index