GX3104, GX3116e
Sets the specified array of channels output relay state, and apply voltage/currents gradually.
GxSmuSourceSetOutputStateExArray (nHandle, nChannelListArraySize, panChannelListArray, nState, dRampTimeInMiliSec, pnStatus)
Name |
Type |
Description |
nHandle |
SHORT |
Handle to a GX3104 or GX3116e board. |
nChannelListArraySize |
SHORT |
Specifies the number of channels in panChannelListArray. If nChannelListArraySize=-1, then panChannelListArray parameter is ignored (can be set to NULL) and settings will be applied to all the channels. |
panChannelListArray |
PSHORT |
Array specifying the channels numbers to be set:GX3104: 0 (GX3104_CHANNEL_1) to 3 GX3104_CHANNEL_4.GX3116e: 0 (GX3116_CHANNEL_1) to 15 GX3116_CHANNEL_16. |
nState |
SHORT |
Specified array of channels 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. |
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 Limit 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 connect channel 0 and 2 output and returns the output state, and returns the settings:
SHORT nState, nStatus;
SHORT anChannelListArray [2];
// Fill channel array
anChannelListArray [0] = 0;
anChannelListArray [1] = 2;
GxSmuSourceSetOutputStateExArray (nHandle, 2, anChannelListArray, GXSMU_SOURCE_OUTPUT_ON, 10.0, &nStatus);
GxSmuSourceGetOutputState (nHandle, GX3104_CHANNEL_1, &nState, &nStatus);
GxSmuSourceSetCurrent, GxSmuSourceSetCurrentLimit, GxSmuSourceSetCurrentClamps, GxSmuSourceSetCurrentRange, GxSmuSourceSetMode, GxSmuSourceGetOutputState, GxSmuSourceSetRangeMode, GxSmuSourceSetVoltage, GxSmuSourceSetVoltageLimit, GxSmuGetErrorString