GxSmuSourceSetTripModeArray

Applies To

GX3116e

Purpose

Sets the specified array of channels trip mode.

Syntax

GxSmuSourceSetTripModeArray (nHandle, nChannelListArraySize, panChannelListArray, nTripMode, 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.
nTripMode
SHORT
Trip modes are as followed:
0.      GXSMU_SOURCE_TRIP_MODE_DISABLE: specified channel’s trip mode is disabled
1.    GXSMU_SOURCE_TRIP_MODE_ENABLE: specified channel’s trip mode is enabled
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The function sets the specified array of channels trip mode. When the channel’s trip is enabled, the following conditions will trip the specified channel and generate a fault that will disable the channel’s output. The user can clear the channel’s fault using the GxSmuReset(), GxSmuResetChannel(),GxSmuClearFaults(), GxSmuClearFaultsArray() APIs.

The user can retrieve the channel’s fault status using GxSmuGetStatusRegisterChannel() API.

Channel is in constant voltage:

Real Time Over Current Sink
Sink current exceeded sink clamp current
Latched Over Current Sink
Sink current exceeded sink clamp current since the last time a GxSmuReset() API was called.
Real Time Over Current Source
Source current exceeded source clamp current
Latched Over Current Source
Source current exceeded source clamp current since the last time a GxSmuReset() API was called
Real Time Over Temp
Internal channel’s temperature exceeds +135°C
Latched Over Temp
Internal channel’s temperature exceeds +135°C was exceeded
Group Real Time Over Temp
One or more channels in the group of channels (channels 1-8 or 9-16) generated Real Time Over Temp: An internal thermal monitor, when the internal channel’s temperature exceeds +135°C
Group Latched Over Temp
One or more channels in the group of channels (channels 1-8 or 9-16) generated Latched Over Temp: An internal thermal monitor, when the internal channel’s temperature exceeds +135°C

Channel is in constant current:

Bit name
Description
Real Time Over Current Sink
Sink current exceeded sink clamp current
Latched Over Current Sink
Sink current exceeded sink clamp current since the last time a GxSmuReset() API was called
Real Time Over Current Source
Source current exceeded source clamp current
Latched Over Current Source
Source current exceeded source clamp current since the last time a GxSmuReset() API was called
Real Time Over Temp
Internal channel’s temperature exceeds +135°C
Latched Over Temp
Internal channel’s temperature exceeds +135°C was exceeded
Group Real Time Over Temp
One or more channels in the group of channels (channels 1-8 or 9-16) generated Real Time Over Temp: An internal thermal monitor, when the internal channel’s temperature exceeds +135°C
Group Latched Over Temp
One or more channels in the group of channels (channels 1-8 or 9-16) generated Latched Over Temp: An internal thermal monitor, when the internal channel’s temperature exceeds +135°C was exceeded right now or since the last time a GxSmuReset() API was called.

Example

The following example enables sets channel 0 and 2 trip, and returns the settings:

 

SHORT  nHandle, nStatus, nTripMode;

SHORT  anChannelListArray [2];

// Fill channel array

anChannelListArray [0] = 0;

anChannelListArray [1] = 2;

 

GxSmuSourceSetTripModeArray (nHandle, 2, anChannelListArray, GXSMU_SOURCE_TRIP_MODE_ENABLE, &nStatus);

GxSmuSourceGetTripMode (nHandle, GX3116_CHANNEL_1, &nTripMode, &nStatus);

 

See Also

GxSmuSourceSetTripMode, GxSmuSourceGetTripMode, GxSmuGetStatusRegister, GxSmuGetStatusRegisterChannel, GxSmuGetErrorString