Gx3748TriggerSetGroupMode

Purpose

Sets all the specified group channels with the same trigger mode.

Syntax

Gx3748TriggerSetGroupMode (nHandle, nGroup, nMode, 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.

nMode

SHORT
Trigger mode can be as followed:
0.      GX3748_TRIGGER_MODE_LEVEL_HIGH: High Level leads to trigger generation.
1.      GX3748_TRIGGER_MODE_LEVEL_LOW: Low Level leads to trigger generation.
2.      GX3748_TRIGGER_MODE_RISING_EDGE: Rising edge leads to trigger generation.
3.    GX3748_TRIGGER_MODE_FALLING_EDGE: Falling edge leads to trigger generation.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The function sets all the specified group channels with the same trigger mode.

There are three groups each with 16 channels. The user can enable any specific channel in any group trigger generate an PXI Trigger whenever the input complies with the trigger settings by calling Gx3748TriggerSetChannelToPxiTriggerState() API . The user can also call Gx3748TriggerReadChannelStatus() API to find out if a specific channel generates a trigger condition. Once a trigger condition is detected on any given channel the user need to clear that condition by calling Gx3748TriggerClearChannelStatus() API in order to enable additional triggers on the specified channel. Once a trigger condition was detected the trigger can then be routed to generate an IRQ (providing that the channel’s IRQ state was enabled by calling Gx3748IRQSetSourceChannelState() API) as well as generating a trigger out to the PXI Trigger bus (providing that the channel’s trigger state was enabled by calling Gx3748TriggerSetGroupToPxiTriggerState() API). The specified PXI Trigger line can be set by calling Gx3748TriggerSetOutputPxiTrigger() 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, Gx3748TriggerReadGroupStatus, Gx3748TriggerSetChannelAssertTime, Gx3748TriggerSetChannelMode, Gx3748TriggerSetGroupAssertTime, Gx3748TriggerSetOutputPxiTrigger, Gx3748TriggerSetChannelToPxiTriggerState, GxFpgaGetErrorString