GxSmuSourceSetCurrentLimitArray

Apply To

GX3104

Purpose

Sets the specified array of channels current settings when in constant voltage mode.

Syntax

GxSmuSourceSetCurrentLimitArray (nHandle, nChannelListArraySize, panChannelListArray, pdCurrentLimit, pnStatus)

Parameters

Name
Type
Description
nHandle
SHORT
Handle to a GX3104 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
DOUBLE

Array specifying the channels numbers to be set:

GX3104: 0 (GX3104_CHANNEL_1) to 3 GX3104_CHANNEL_4.
pdCurrentLimit
PDOUBLE
Sets the specified channel’s current settings, the range for each current range is as follows:
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
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 limit settings:

 

SHORT nStatus;

SHORT  anChannelListArray [2];

// Fill channel array

anChannelListArray [0] = 0;

anChannelListArray [1] = 2;

GxSmuSourceSetCurrentLimitArray (nHandle, 2, anChannelListArray, 2.5, &nStatus);

 

See Also

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