GxSmuSourceSetConstantVoltage

Apply To

GX3104, GX3116e

Purpose

Sets the specified channel’s current range, output voltage, GX3104: sets the current limit, GX3116e: sets the Current Clamp Source and Current Clamp Sink, and ramp time when in constant voltage mode.

Syntax

GxSmuSourceSetConstantVoltage (nHandle, nChannel, nCurrentRange, dVoltage, dCurrentLimitOrClampSource, dCurrentClampSink, dRampTimeInMiliSec, pnStatus)

Parameters

Name
Type
Description
nHandle
SHORT
Handle to a GX3104 or GX3116e board.
nChannel
SHORT
GX3104: Specifies the channel number (0-3): GX3104_CHANNEL_1 to GX3104_CHANNEL_4
GX3116e: Specifies channel number (0-15) is GX3116_CHANNEL_1 to GX3116_CHANNEL_16
nCurrentRange
SHORT
Sets the specified channel’s current range for each current range is as follows:
GX3104:
0.      GX3104_SOURCE_CURRENT_RANGE_1000MA: Source Current Range +/-1000mA, Supported by channel 1 only, channels 2-4 can be set up to +/-500mA
1.      GX3104_SOURCE_CURRENT_RANGE_250MA: Source Current Range +/-250mA
2.      GX3104_SOURCE_CURRENT_RANGE_25MA: Source Current Range +/-25mA (default after reset).
3.      GX3104_SOURCE_CURRENT_RANGE_2500UA: Source Current Range +/-2.5mA
4.      GX3104_SOURCE_CURRENT_RANGE_250UA: Source Current Range +/-250uA
5.      GX3104_SOURCE_CURRENT_RANGE_25UA: Source Current Range -+/-25uA
6.      GX3104_SOURCE_CURRENT_RANGE_2500NA: Source Current Range -2.5uA to -1uA, and 1uA to 2.5uA
GX3116e:
0.      GX3116_SOURCE_CURRENT_RANGE_512MA: Source Current Range -512mA to +512mA
1.      GX3116_SOURCE_CURRENT_RANGE_25_POINT_6MA: Source Current Range -25.6mA to +25.6mA (default)
2.      GX3116_SOURCE_CURRENT_RANGE_2_POINT_56MA: Source Current Range -2.56mA to +2.56mA
dVoltage
DOUBLE
GX3104:
Sets the specified channel’s voltage limit settings when in constant current mode. Voltage range is -20.0V to +20.0V.
GX3116e:
Sets the specified channel’s voltage clamp high settings when in constant current mode.
Current range 512mA: Voltage range is 0V to +9.0.
Current range 25.6 mA and 2.56mA: Voltage range is -2.0V to +10.5V.
dCurrentLimitOrClampSource
DOUBLE
GX3104:
Sets the specified channel’s current limit, the specified value must match the current limit range settings, as it was set by the nCurrentRange parameter.
GX3116e:
Sets the specified channel’s current clamp source, the specified value must match the current limit range settings, as it was set by the nCurrentRange parameter.
dCurrentClampSink
DOUBLE
GX3104:
Not used, can be pass as NULL.
GX3116e:
Sets the specified channel’s current clamp sink, the specified value must match the current limit range settings, as it was set by the nCurrentRange parameter.
dRampTimeInMiliSec
DOUBLE
Sets the specified ramp time in mSec, value can be 0 mSec to 4000 mSec
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

GX3104:

Sets the specified channel’s current range, output voltage, current limit, and ramp time when in constant current voltage mode.

The function applies the specified channel’s voltage and current limit settings when in constant voltage mode. The function ramps up/down the specified Voltage and Current Limit values gradually over the specified time ramp. The ramp time is in time in mSec.

While setting the both voltage and current limit, there might be excessive over/under shoot voltages depending on the DUT characteristics. In order to reduce those over/under shoot voltages, this function allows the user to set the output voltages and current limit gradually over the user specified time. The function intended to help the user better tailor the channel’s voltage DUT response, and will require a trial and error in order to find the best ramp time and the transition current range.

GX3116e:

Sets the specified channel’s current range, output voltage, Current Clamp Source and Current Clamp Sink, and ramp time when in constant current mode.

The function applies the specified channel’s voltage and current clamp settings when in constant voltage mode. The function ramps up/down the specified Voltage and Current Clamp values gradually over the specified time ramp. The ramp time is in time in mSec.

While setting the both voltage and current clamp, there might be excessive over/under shoot voltages depending on the DUT characteristics. In order to reduce those over/under shoot voltages, this function allows the user to set the output voltages and current limit gradually over the user specified time. The function intended to help the user better tailor the channel’s voltage DUT response, and will require a trial and error in order to find the best ramp time and the transition current range.

Note: the channel must be in constant voltage mode prior calling this function.

Example

GX3104:

The following example sets channel 1 current range to +/-250mA, voltage to +10V, current limit to 200mA,in 10 mSec:

 

SHORT nStatus;

 

GxSmuSourceSetConstantCurrent (nHandle, GX3104_CHANNEL_1, GX3104_SOURCE_CURRENT_RANGE_250MA, 10.0, 200.0, 0.0, 10, &nStatus);

 

GX3116e:

 

SHORT nStatus;

 

The following example sets channel 1 current range to +/-512mA, voltage to +10V, current clamp source to 200mA, , current clamp sink to 100mA, in 10 mSec:

 

SHORT nStatus;

GxSmuSourceSetConstantVoltageEx (nHandle, GX3116_CHANNEL_1, GX3116_SOURCE_CURRENT_RANGE_512MA, 10.0, 200.0, 100, &nStatus);

 

See Also

GxSmuSourceSetConstantCurrent, GxSmuSourceGetCurrent, GxSmuSourceSetCurrentLimit,, GxSmuSourceSetCurrentClamps, GxSmuSourceSetCurrentRange, GxSmuSourceSetMode, GxSmuSourceSetOutputState, GxSmuSourceSetRangeMode, GxSmuSourceSetVoltage, GxSmuSourceSetVoltageLimit, GxSmuGetErrorString