DioGetOutputOverCurrentStates

Applies To

GX5055

Purpose

Returns all 32 channels over current high and low flags states of the specifies board.

Syntax

DioGetOutputOverCurrentStates (nHandle, dwOverCurrentHi, pdwOverCurrentLo, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Board handle.
pdwOverCurrentHi
PDWORD
Channels over current high flags states, each bit corresponds to a channel, i.e. bit 0 represents channel 0 and bit 31 represents channel 31.
A bit with logic high signals that an over current condition occurs on the output high voltage. A low signals that no over current occurs.
Once over current condition has been detected the corresponded channels’ driver is placed in HiZ until the flag is cleared.
pdwOverCurrentLo
PDWORD
Channels over current low flags states, each bit corresponds to a channel, i.e. bit 0 represents channel 0 and bit 31 represents channel 31.
A bit with logic high signals that an over current condition occurs on the output low voltage. A low signals that no over current occurs.
Once over current condition has been detected the corresponded channels’ driver is placed in HiZ until the flag is cleared.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

Note: over current condition can only be cleared by calling DioResetOutputOverCurrentStates. After the over current is cleared the channel output driver will be active again.

Channels over current high and low flags states can be read back and set dynamically at any time even while the DIO is running mode.

Example

The following example returns all 32 channels over current high and low flags states:

 

DWORD dwOverCurrentHi, dwOverCurrentLo;

DioGetOutputOverCurrentStates (nHandle, &dwOverCurrentHi, &dwOverCurrentLo, &nStatus);

 

See Also

DioSetupOutputDataFormat, DioSetupInputLoadCommutatingVoltage, DioSetupInputLoadResistance,  DioSetupInputThresholdVoltages, DioGetErrorString