DioPmuGetForcedCurrentCommutatingVoltage

Applies To

GX5055, GX5295, File

Purpose

Returns the channel PMU forced current commutating voltage

Syntax

DioPmuGetForcedCurrentCommutatingVoltage (nHandle, nChannel, pdVComHi, pdVComLo, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Master board handle, Board handle or File board handle.
nChannel
SHORT
If Board Handle was passed:
Channel number in the DIO board, each board has 32 I/O channels. I/O channels number range is 0-31.
Gx5295: Each DIO board has 4 Auxiliary channels. Auxiliary channels number range is 0-3.
If Master Board Handle was passed:
Channel number in the DIO domain, each DIO board adds 32 I/O channels. I/O channels number range is 0-991 (1 master and 30 slaves).
Gx5295: Each DIO board adds 4 Auxiliary channels, Auxiliary channels number range is 0-123 (1 master and 30 slaves)
pdVComHi
PDOUBLE
Gx5055: Input channel high commutating voltages value, voltage can be set from negative voltage rail voltage (VDD) + 2V to positive voltage rail voltage (VEE) -2V.
Gx5295: Input channel high commutating voltages value, voltage can be set from --2V to +7V.
pdVComLo
PDOUBLE
Gx5055: Input channel low commutating voltages value, voltage can be set from negative voltage rail voltage (VDD) + 2V to positive voltage rail voltage (VEE) -2V.
Gx5295: Input channel low commutating voltages value, voltage can be set from --2V to +7V.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

Each PMU has a set of programmable commutating voltage that limit the voltage swing when the PMU is forcing current. These commutating voltage protect the DUT when current is being forced into a high impedance node at the DUT.

If the sensed voltage exceeds the high or low commutating voltage the PMU reduces the output current in order for the output voltage to not exceed the commutating voltage. If the voltage subsequently returns back to within the commutating voltage thresholds, the PMU resumes forcing the programmed current.

The Channels PMU forced current commutating voltage can be read back and set dynamically at any time even while the DIO is running mode.

Example

The following example returns channel 0 PMU forced current commutating voltage:

 

DOUBLE dVComHi, dVComLo;

DioPmuGetForcedCurrentCommutatingVoltage (nHandle, 0, &dVComHi, &dVComLo, &nStatus);

 

See Also

DioSetupChannelMode, DioPmuSetupForcedCurrent, DioPmuSetupForcedVoltage, DioPmuSetupForcedCurrentCommutatingVoltage, DioGetErrorString