GxSmuSourceSetVoltageLimitsArray

Applies To

GX3116e

Purpose

Sets the specified array of channels voltage high and low limits settings when in constant voltage mode.

Syntax

GxSmuSourceSetVoltageLimitArray (nHandle, nChannelListArraySize, panChannelListArray, dVoltageClampHigh, pdVoltageClampLow, pnStatus)

Parameters

Name
Type
Description
nHandle
SHORT
Handle to a 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:
GX3116e: 0 (GX3116_CHANNEL_1) to 15 GX3116_CHANNEL_16.
dVoltageClampHigh
DOUBLE
Sets the specified channel’s voltage limit high settings when in constant current mode. Voltage range is -2.0V to +10.5V.  
pdVoltageClampLow,
DOUBLE
Sets the specified channel’s voltage limit low settings when in constant current mode. Voltage range is -2.0V to +10.5V.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

Sets the specified channel’s voltage limits high and low settings when in constant current mode. The voltage range is -2.0V to +10.5V.

The user can call the GxSmuGetStatusRegisterChannel() API at any time, in order to find out if at any time the limits were met.

Example

The following example sets channel 0 and 2to constant current mode, sets the high voltage limit to +10V and the low limit to -1.0Vand returns the settings:

 

SHORT nStatus;

DOUBLE dVoltageClampHigh, dVoltageClampLow;

SHORT  anChannelListArray [2];

// Fill channel array

anChannelListArray [0] = 0;

anChannelListArray [1] = 2;

GxSmuSourceSetModeArray (nHandle, 2, anChannelListArrayGX3116_CHANNEL_, GXSMU_SOURCE_MODE_CONSTANT_CURRENT, &nStatus);

GxSmuSourceSetCurrentRangeArray (nHandle, 2, anChannelListArrayGX3116_CHANNEL_, GX3116_SOURCE_CURRENT_RANGE_512MA, &nStatus);

GxSmuSourceSetVoltageLimitsArray (nHandle, 2, anChannelListArrayGX3116_CHANNEL_, 10.0, -1.0,&nStatus);

GxSmuSourceGetVoltageLimitsArray (nHandle, GX3116_CHANNEL_1, &dVoltageClampHigh, &dVoltageClampLow, &nStatus);

 

See Also

GxSmuSourceSetCurrent, GxSmuSourceSetCurrentClamps, GxSmuSourceSetCurrentRange, GxSmuSourceSetMode, GxSmuSourceSetOutputState, GxSmuSourceSetRangeMode, GxSmuSourceSetVoltage, GxSmuSourceSetVoltageClamps, GxSmuGetErrorString