pipx40_psuGetInfo

VB

Function

pipx40_psuGetInfo (ByVal vi As Long, ByVal subUnit As Long, ByRef typeNum As Long, ByRef voltage As Double, ByRef current As Double, ByRef precision As Long, ByRef capabilities As Long) As Long

C++

ViStatus

pipx40_psuGetInfo (ViSession vi, ViUInt32 subUnit, ViPUInt32 typeNum, ViPReal64 voltage, ViPReal64 current, ViPUInt32 precision, ViPUInt32 capabilities);

 

Parameter

I/O

Description

vi

in

Instrument handle

subUnit

in

Numeric variable indicating the sub-unit for which information is to be obtained

typeNum

out

pointer to variable to receive type code

voltage

out

pointer to variable to receive voltage rating

current

out

pointer to variable to receive current rating

precision

out

pointer to variable to receive precision (the number of bits resolution - for programmable supplies only)

capabilities

out

pointer to variable to receive capability flags - see below

Return Value

0 = Successful operation. Negative values are error codes and positive values are warnings. To get a description of the error, pass the error code to pipx40_error_message.

Description

Obtains a type description of a power supply sub-unit, as numeric values.

 

Power supply sub-unit type codes are:

Driver constant

typeNum

value

Description

pipx40_TYPE_PSUDC

9

Power supply, DC

 

The capabilities value is the sum of a number of individual bit-flags, as follows:

Driver constant

bit value -

hexadecimal

Description

pipx40_PSU_CAP_CURRENT_MODE_SENSE

00000010

Can sense if operating in current-limited mode

pipx40_PSU_CAP_PROG_CURRENT

00000008

Output current is programmable

pipx40_PSU_CAP_PROG_VOLTAGE

00000004

Output voltage is programmable

pipx40_PSU_CAP_OUTPUT_SENSE

00000002

Has logic-level sensing of output active state

pipx40_PSU_CAP_OUTPUT_CONTROL

00000001

Has output on/off control

 

Certain driver functions are only usable with power supply sub-units having appropriate capabilities - examples being:

pipx40_psuEnable

pipx40_psuSetVoltage