GxSmuSourceSetCurrentClampsArray

Applies To

GX3116e

Purpose

Sets the specified array of channels current clamps source and sink settings when in constant voltage mode.

Syntax

GxSmuSourceSetCurrentClampsArray (nHandle, nChannelListArraySize, panChannelListArray, dCurrentClampSource, dCurrentClampSink, 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.
dCurrentClampSource
DOUBLE
Sets the specified channel’s programmed current clamps source settings in mA when in constant voltage mode, according to the programmed current range.
0.      GX3116_SOURCE_CURRENT_RANGE_512MA: Source Current Range +/-512mA
1.      GX3116_SOURCE_CURRENT_RANGE_25_POINT_6MA: Source Current Range +/-25.6mA (default)
2.    GX3116_SOURCE_CURRENT_RANGE_2_POINT_56MA: Source Current Range +/-2.56mA
dCurrentClampSink
DOUBLE
Sets the specified channel’s programmed current clamps sink settings in mA when in constant voltage mode, according to the programmed current range.
0.      GX3116_SOURCE_CURRENT_RANGE_512MA: Source Current Range +/-512mA
1.      GX3116_SOURCE_CURRENT_RANGE_25_POINT_6MA: Source Current Range +/-25.6mA (default)
2.    GX3116_SOURCE_CURRENT_RANGE_2_POINT_56MA: Source Current Range +/-2.56mA
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The function sets the specified channel’s current settings. The current value is in mA.

Example

The following example sets channel 0 and 2 current clamps settings, and returns channel 0 settings:

 

SHORT  nHandle, nStatus;

DOUBLE dCurrentLimit;

DOUBLE dCurrentClampSource, dCurrentClampSink;

SHORT  anChannelListArray [2];

// Fill channel array

anChannelListArray [0] = 0;

anChannelListArray [1] = 2;

GxSmuSourceSetCurrentClampssArray (nHandle, 2, anChannelListArray, 100.0, 100.0, &nStatus);

GxSmuSourceGetCurrentClamps (nHandle, GX3116_CHANNEL_1, &dCurrentClampSource, &dCurrentClampSink, &nStatus);

 

See Also

GxSmuSourceSetCurrent, GxSmuSourceGetCurrentClamps, GxSmuSourceSetCurrentRange, GxSmuSourceSetMode, GxSmuSourceSetOutputState, GxSmuSourceSetRangeMode, GxSmuSourceSetVoltage, GxSmuSourceSetVoltageLimit, GxSmuGetErrorString