GxSmuSourceSetRangeModeArray

Applies To

GX3104, GX3116e

Purpose

Sets the specified array of channels current range mode.

Syntax

GxSmuSourceSetRangeModeArray (nHandle, nChannelListArraySize, panChannelListArray, nSourceRangeMode, pnStatus)

Parameters

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.
nSourceRangeMode
SHORT
Specified array of channels current range mode:
0.      GXSMU_SOURCE_RANGE_MODE_AUTO: Auto setting of Source Voltage and current range.
1.    GXSMU_SOURCE_RANGE_MODE_USER: User defined of Source Voltage and current range
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The function sets the specified channel’s current range mode.

When the user sets the range mode to “Auto setting”, then whenever the current is set, the driver then finds the best current range that fits that value in order to get the best accuracy as well as taking in to account the minimum required by each current range and adjusting accordingly. Using this mode will guarantee that the requested current will be able to be set.

When the user sets the range mode to “User defined”, then he needs to know in advance if the current can fit in the current range settings.

GX3104:

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

GX3116e:

0.      GX3116_SOURCE_CURRENT_RANGE_512MA: Source Current Range +/-512mA

1.      GX3116_SOURCE_CURRENT_RANGE_25_POINT_6MA: Source Current Range +/-25.6mA (default after reset).

2.      GX3116_SOURCE_CURRENT_RANGE_2_POINT_56MA: Source Current Range +/-2.56mA

Example

The following example sets channel 0 and 2 range to auto and returns the settings:

 

SHORT nSourceRangeMode, nStatus;

SHORT  anChannelListArray [2];

// Fill channel array

anChannelListArray [0] = 0;

anChannelListArray [1] = 2;

GxSmuSourceSetRangeModeArray (nHandle, 2, anChannelListArray, GXSMU_SOURCE_RANGE_MODE_AUTO, &nStatus);

GxSmuSourceGetRangeMode (nHandle, GX3104_CHANNEL_1, &nSourceRangeMode, &nStatus);

 

See Also

GxSmuSourceSetCurrent, GxSmuSourceSetCurrentLimit, GxSmuSourceSetCurrentClamps, GxSmuSourceSetCurrentRange, GxSmuSourceSetMode, GxSmuSourceSetOutputState, GxSmuSourceGetRangeMode, GxSmuSourceSetVoltage, GxSmuSourceSetVoltageLimit, GxSmuSourceSetVoltageClamps, GxSmuGetErrorString