GxSmuSourceSetOutputStateEx

Applies To

GX3104, GX3116e

Purpose

Sets the specified channel’s output relay state, and apply voltage/currents gradually.

Syntax

GxSmuSourceSetOutputStateEx (nHandle, nChannel, nState, 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
nState
SHORT
Specified channel’s output relay state:
0.      GXSMU_SOURCE_OUTPUT_OFF: the specified channel’s output is disconnected from the connector.
1.  GXSMU_SOURCE_OUTPUT_ON: the specified channel’s output is connected to the connector.  
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

The function controls the specified channel’s output relay. The user can connect and disconnect the channel at any time.

In constant Voltage mode: the function will ramp the output voltage from 0 volts, to the previously set voltage as it set by the GxSmuSourceSetConstantVoltage() API.

In constant Current mode: the function will ramp the output current from 0 mA, to the previously set current as it set previously by the GxSmuSourceSetConstantCurrent() API.

GX3104:

The function ramps up/down the specified Voltage and Current values gradually over the specified time ramp. The ramp time is in time in mSec.

While setting the both voltage limit and current, 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 limit and current 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:

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

While setting the both voltage clamp and current, 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 clamp and current 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.

Example

The following example enables channel 1 output and returns the output state:

 

SHORT nState, nStatus;

 

GxSmuSourceSetOutputStateEx (nHandle, GX3104_CHANNEL_1, GXSMU_SOURCE_OUTPUT_ON, 10.0, &nStatus);

GxSmuSourceGetOutputState (nHandle, GX3104_CHANNEL_1, &nState, &nStatus);

 

See Also

GxSmuSourceSetCurrent, GxSmuSourceSetCurrentLimit, GxSmuSourceSetCurrentClamps, GxSmuSourceSetCurrentRange, GxSmuSourceSetMode, GxSmuSourceGetOutputState, GxSmuSourceSetRangeMode, GxSmuSourceSetVoltage, GxSmuSourceSetVoltageLimit, GxSmuSourceSetVoltageClamps, GxSmuGetErrorString