Gx3748TriggerReadGroupStatus

Purpose

The function reads back the current trigger status of all the 16 channels in the specified group channel.

Syntax

Gx3748TriggerReadCGroupStatus (nHandle, nGroup, pnGroupStatus, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Handle for a GX3748 board.
nGroup
SHORT
Group number as follows:
0.      GX3748_GROUP0: J1 input connector pins 2 to 17.
1.      GX3748_GROUP1: J1 input connector pins 23 to 38.
2.    GX3748_GROUP2: J1 input connector pins 44 to 59.
pnGroupStatus
PSHORT
Each bit represents a channel, bit 0 channel 0 etc. Each channel’s bit trigger status can be:
0.     No trigger was detected.
1.     Trigger was detected.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The function reads back the current trigger status on the specified group channel.

Assert time is time between an input channel identifies a trigger and until that trigger is actually generated. The assert time can be from 0 (GX3748_TRIGGER_MIN_ASSERT_TIME) to the max of 6553.6 (GX3748_TRIGGER_MAX_ASSERT_TIME). Assert time can be set in a 0.1mSec intervals. The assert time counter is automatically cleared once the trigger condition is invalid or when the user calls the Gx3748TriggerClearChannelStatus() API.

Example

The following example sets the trigger condition for group 0 channel 0, enable IRQ and PXI trigger and disables all IRQ and trigger states:

 

SHORT nHandle, nStatus;

 

Gx3748IRQSetSourceChannelState(nHandle, GX3748_GROUP0, GX3748_GROUP_CH0, GX3748_IRQ_SOURCE_ENABLE, &nStatus);

Gx3748TriggerSetChannelToPxiTriggerState(nHandle, GX3748_GROUP0, GX3748_GROUP_CH0, GX3748_TRIGGER_SOURCE_ENABLE, &nStatus);

Gx3748TriggerSetOutputPxiTrigger(nHandle, GX3748_TRIGGER_TO_PXI_TRIGGER_0, &nStatus);

Gx3748IRQDisableAllSources(nHandle, &nStatus);

 

See Also

Gx3748IRQDisableAllSources, Gx3748IRQSetSourceChannelState, Gx3748IRQSetSourceGroupState, Gx3748TriggerClearAllStatus, Gx3748TriggerClearChannelStatus, Gx3748TriggerClearGroupStatus, Gx3748TriggerDisableAllSources, Gx3748TriggerReadAssertCounter, Gx3748TriggerReadChannelStatus, Gx3748TriggerSetChannelAssertTime, Gx3748TriggerSetChannelMode, Gx3748TriggerSetGroupAssertTime, Gx3748TriggerSetGroupMode, Gx3748TriggerSetOutputPxiTrigger,  Gx3748TriggerSetChannelToPxiTriggerState, GxFpgaGetErrorString