pipx40_psuGetInfo

ViStatus pipx40_psuGetInfo (ViSession instrumentHandle, ViUInt32 subunitNumber, ViPUInt32 subunitType, ViPReal64 voltage, ViPReal64 current, ViPUInt32 precision, ViPUInt32 capabilities);

Purpose

Obtains type and characteristic information for a power supply sub-unit, as numeric values.

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:  must correspond to a power supply sub-unit
of the chosen card

Output
Name Type Description
subunitType ViUInt32 (passed by reference)

Variable to receive the numeric type code of the chosen power supply sub-unit.
Type codes:
9 = pipx40_TYPE_PSUDC   Power Supply, DC

voltage ViReal64 (passed by reference)

Variable to receive the rated output voltage of the chosen power supply sub-unit.
For programmable voltage supplies this is the maximum output voltage that can be set.

current ViReal64 (passed by reference)

Variable to receive the rated output current of the chosen power supply sub-unit.
For programmable current supplies this is the maximum output current that can be set.

precision ViUInt32 (passed by reference)

For programmable voltage and/or current supplies, receives the number of bits resolution with which output settings can be made.

capabilities ViUInt32 (passed by reference)

Receives a set of bit-flags indicating particular capabilities of a power supply sub-unit.
Bit significance:
0x00000010 = pipx40_PSU_CAP_CURRENT_MODE_SENSE
Can sense if operating in current-limited mode
0x00000008 = pipx40_PSU_CAP_PROG_CURRENT
Output current is programmable
0x00000004 = pipx40_PSU_CAP_PROG_VOLTAGE
Output voltage is programmable
0x00000002 = pipx40_PSU_CAP_OUTPUT_SENSE
Has logic-level sensing of output active state
0x00000001 = pipx40_PSU_CAP_OUTPUT_CONTROL
Has output on/off control

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

Power Supplies
Pickering Interfaces PXI VISA
Alphabetical Function Index
Hierarchical Function Index