Gx3748TriggerGetChannelToPxiTriggerState

Purpose

Returns the specified channel in the group PXI trigger generation state.

Syntax

Gx3748TriggerGetChannelToPxiTriggerState (nHandle, nGroup, nChannel, pnState, 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.
nChannel
SHORT
Channel number in the group, channel numbers are 0-15:
0.      GX3748_GROUP_CH0: channel 0 in the group.
1.      GX3748_GROUP_CH1: channel 1 in the group.
2.      GX3748_GROUP_CH2: channel 2 in the group.
3.      GX3748_GROUP_CH3: channel 3 in the group.
4.      GX3748_GROUP_CH4: channel 4 in the group.
5.      GX3748_GROUP_CH5: channel 5 in the group.
6.      GX3748_GROUP_CH6: channel 6 in the group.
7.      GX3748_GROUP_CH7: channel 7 in the group.
8.      GX3748_GROUP_CH8: channel 8 in the group.
9.      GX3748_GROUP_CH9: channel 9 in the group.
10.   GX3748_GROUP_CH10: channel 10 in the group.
11.   GX3748_GROUP_CH11: channel 11 in the group.
12.   GX3748_GROUP_CH12: channel 12 in the group.
13.   GX3748_GROUP_CH13: channel 13 in the group.
14.   GX3748_GROUP_CH14: channel 14 in the group.
15.  GX3748_GROUP_CH15: channel 15 in the group.
pnState
PSHORT
The specified channel in the group trigger generation state can be:
0.      GX3748_ TRIGGER _SOURCE_DISABLE: Disables the generation of a trigger on the specified channel.
1.    GX3748_ TRIGGER _SOURCE_ENABLE: Enables the generation of a trigger on the specified channel.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The function returns the specified channel in the group trigger generation state.

There are three groups each with 16 channels. The user can enable any specific channel in any group to generate an IRQ whenever the input complies with the trigger settings by calling Gx3748IRQSetSourceChannelState() 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, Gx3748TriggerSetGroupMode, Gx3748TriggerSetOutputPxiTrigger,  Gx3748TriggerSetChannelToPxiTriggerState, GxFpgaGetErrorString