GxSmuSourceSetModeArray

Applies To

GX3104, GX3116e

Purpose

Sets the specified array of channels operation mode, constant Voltage or Constant Current.

Syntax

GxSmuSourceSetModeArray (nHandle, nChannelListArraySize, panChannelListArray, nMode, 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.
nMode
SHORT
Specified array of channels operation mode, constant Voltage or Constant Current:
0.      GXSMU_SOURCE_MODE_CONSTANT_VOLTAGE: Source Voltage is constant while the current may change as a function of the load. In this mode the output behaves as a voltage source.
1.    GXSMU_SOURCE_MODE_CONSTANT_CURRENT: Source current is constant while the output voltage changes as a function of the load. In this mode the output behaves as a current source.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

In constant voltage, the Source Voltage is constant while the current may change as a function of the load. In this mode the output behaves as a voltage source, and the output is limited by the current limit value, i.e. the load can draw current up to the current limit value. Applicable APIs are:

·       GxSmuSourceSetVoltage

·       GxSmuSourceSetCurrentLimit

·       GxSmuSourceSetCurrentRange

In constant current, the Source current is constant while the output voltage changes as a function of the load. In this mode the output behaves as a current source, and the output is limited by the voltage limit value, i.e. the load can draw voltage up to the voltage limit value. Applicable APIs are:

·       GxSmuSourceSetCurrent

·       GxSmuSourceSetVoltageLimit

·       GxSmuSourceSetCurrentRange

Example

The following example sets channel 0 and 2 to constant voltage mode, and returns the settings:

 

SHORT nMode, nStatus;

SHORT  anChannelListArray [2];

// Fill channel array

anChannelListArray [0] = 0;

anChannelListArray [1] = 2;

GxSmuSourceSetModeArray (nHandle, 2, anChannelListArray, GXSMU_SOURCE_MODE_CONSTANT_VOLTAGE, &nStatus);

GxSmuSourceGetMode (nHandle, GX3104_CHANNEL_1, &nMode, &nStatus);

 

See Also

GxSmuSourceSetCurrent, GxSmuSourceSetCurrentLimit, GxSmuSourceSetCurrentClamps, GxSmuSourceSetCurrentRange, GxSmuSourceGetMode, GxSmuSourceSetOutputState, GxSmuSourceSetRangeMode, GxSmuSourceSetVoltage, GxSmuSourceSetVoltageLimit, GxSmuSourceSetVoltageLimits, GxSmuGetErrorString