GxSmuSourceSetTripMode

Applies To

GX3116e

Purpose

Sets the specified channel’s trip mode.

Syntax

GxSmuSourceSetTripMode (nHandle, nChannel, nTripMode, pnStatus)

Parameters

Name
Type
Description
nHandle
SHORT
Handle to a GX3116e board.
nChannel
SHORT
GX3116e: Specifies channel number (0-15) is GX3116_CHANNEL_1 to 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 channel’s 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 the channel 1 trip, and returns the settings:

 

SHORT  nHandle, nStatus, nTripMode;

 

GxSmuSourceSetTripMode (nHandle, GX3116_CHANNEL_1, GXSMU_SOURCE_TRIP_MODE_ENABLE, &nStatus);

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

 

See Also

GxSmuSourceGetTripMode, GxSmuGetStatusRegister, GxSmuGetStatusRegisterChannel, GxSmuGetErrorString