GxPsSetVoltageAndWaitUntilReady

Purpose

Sets the specified channel’s voltage, and wait until the specified voltage is set.

Syntax

GxPsSetVoltageAndWaitUntilReady (nHandle, nChannel, dVoltage, pnStatus)

Parameters

Name
Type
Description
nHandle
SHORT
GX7400 slot number.
nChannel
SHORT
Specifies the Channel for which to set the voltage:
1. GXPS_CHANNEL1: Channel 1
2. GXPS_CHANNEL2: Channel 2
dVoltage
DOUBLE
Voltage.
  • Programmable 0-15V: 0.00V-15.00V
  • Programmable 0-30V: 0.00V-30.00V
  • Programmable 0-60V: 0.00V-60.00V
pnStatus
LPSHORT
Returned status: 0 on success, negative number on failure.

Comments

The function sets the specified channel’s voltage and wait for the specified voltage to be reached. The function may return with a warning (GXPS_SET_VOLTAGE_TIMEOUT) if the specified voltage cannot be set, e.g. low current limit will restrict the output voltage.

If the specified channel was in Standby (output disabled) while calling this function an internal flag will be set. The next time the channel’s output is enabled the driver will wait until the voltage is stable before returning.

Programmable modules current resolution is:

  1. 0-15V module: 0.915 mV/step, 0-30V module: 1.83 mV/step, 0-60V module: 3.66 mA/step.

  2. If total power exceeds 150 W (maximum output power), output voltages will drop to satisfy the power limit.

Not supported by fixed modules.

Example

The following example sets the voltage in Channel A to 3.42 volts.

 

SHORT nHandle, nStatus;

GxPsSetVoltageAndWaitUntilReady (nHandle, GXPS_CHANNEL1, 3.42, &nStatus);

 

See Also

GxSpSetVoltage, GxPsGetVoltage, GxPsSetCurrentLimit, GxPsGetCurrent, GxPsGetCurrentLimit, GxPsSetStandby, GxPsGetStandby, GxPsGetErrorString, GxPsInitialize