Gx3756PioGetChannelToPxiTrigger

Purpose

Returns the specified digital I/O channel to PXI trigger line settings.

Syntax

Gx3756PioGetChannelToPxiTrigger (nHandle, nChannel, pnPxiTriggerLine, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Handle to a GX3756 board.
nChannel
SHORT
Specified digital I/O channel may be 4-7.
pnPxiTriggerLine
PSHORT
Returns the specified digital I/O channel to PXI trigger line settings:
0.      GX3756_PIO_TO_PXI_TRIGGER_DISABLED: specified digital I/O channel is not connected to any PXI trigger line.
1.      GX3756_PIO_TO_PXI_TRIGGER_0: specified digital I/O channel is connected to PXI trigger line 0.
2.      GX3756_PIO_TO_PXI_TRIGGER_1: specified digital I/O channel is connected to PXI trigger line 1.
3.      GX3756_PIO_TO_PXI_TRIGGER_2: specified digital I/O channel is connected to PXI trigger line 2.
4.      GX3756_PIO_TO_PXI_TRIGGER_3: specified digital I/O channel is connected to PXI trigger line 3.
5.      GX3756_PIO_TO_PXI_TRIGGER_4: specified digital I/O channel is connected to PXI trigger line 4.
6.      GX3756_PIO_TO_PXI_TRIGGER_5: specified digital I/O channel is connected to PXI trigger line 5.
7.      GX3756_PIO_TO_PXI_TRIGGER_6: specified digital I/O channel is connected to PXI trigger line 6.
8.    GX3756_PIO_TO_PXI_TRIGGER_7: specified digital I/O channel is connected to PXI trigger line 7.  
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The purpose of this function is to connect between a digital I/O channel, channels 4-7 only, to the PXI trigger lines.

There are 56 Digital I/O channels, channel’s direction control is set in groups of 4 channels, e.g. channels 0-3, channels 4-7, etc. Any group of channels can be programmed to be all in or all out. If a group of channels is direction is set to input, the user can use specific channel is set Gx3756PioReadGroup(), Gx3756PioReadChannel(), and Gx3756PioReadAllChannels() APIs to read back the actual logic input levels.

Channels 0-3 (Group 0) can be programmed to operate as serial-out transmitter. See Gx3756SerialOutSetMode() API for more details.

Channels 3-7 (Group 1) can be programmed as an external trigger source to channels 0-3 (Group 0), when they are set to serial-out operation mode. See Gx3756SerialOutSetMode(), and Gx3756SerialOutGetTriggerSource() APIs for more details.

See the Gx3756PioSetGroupDirection() API for complete example.

Example

The following example returns channel 4 connection to PXI trigger line:

 

SHORT nHandle, nStatus;

SHORT nValue;

 

Gx3756PioGetChannelToPxiTrigger (nHandle, 4, &nValue, &nStatus);

 

See Also

Gx3756PioSetChannelToPxiTrigger, Gx3756PioReadAllChannels, Gx3756PioReadGroup, Gx3756PioReadGroupChannel, Gx3756PioResetGroup, Gx3756PioSetAllChannels, Gx3756PioSetAllGroupsDirection, Gx3756PioSetGroup, Gx3756PioSetGroupChannel, Gx3756PioSetGroupDirection, GxFpgaGetErrorString