niSync_ConnectTrigTerminals

C Function Prototype

ViStatus niSync_ConnectTrigTerminals (ViSession vi, ViConstString sourceTerminal, ViConstString destinationTerminal, ViConstString synchronizationClock, ViInt32 invert, ViInt32 updateEdge);

Purpose

Routes triggers through the PXI backplane, between devices, or between multiple chassis.

Once a terminal route is connected, you can invert the trigger signal at the destination terminal, synchronize the trigger to the rising or falling edge of a synchronization clock, fire the trigger asynchronously, or route the trigger to other trigger terminals.

You can also route clocks along some trigger lines by setting a full speed or divided synchronization clock as the source terminal.

Note Note  The destination terminal determines the source of the trigger's synchronization clock. PFI and PFI_LVDS lines are in the front trigger zone, and PXI_Trig, PXI_Star, and PXIe_DStar lines are in the rear trigger zone.

Parameters

Name Type Description
vi ViSession The session handle that you obtain from niSync_init. The handle identifies a particular instrument session.

sourceTerminal ViConstString Specifies the source of the trigger you want to connect to the destination terminal.

Note  The source of the synchronization clock for trigger connections is determined by the destination terminal (either the PFI sync clock zone or the backplane sync clock zone). Also, the two divided versions of the synchronization clock are shared between the PFI sync clock zone and the backplane sync clock zone.


Valid Values:
NISYNC_VAL_PXITRIG0 (Default Value)
NISYNC_VAL_PXITRIG1
NISYNC_VAL_PXITRIG2
NISYNC_VAL_PXITRIG3
NISYNC_VAL_PXITRIG4
NISYNC_VAL_PXITRIG5
NISYNC_VAL_PXITRIG6
NISYNC_VAL_PXITRIG7
NISYNC_VAL_PXISTAR0
NISYNC_VAL_PXISTAR1
NISYNC_VAL_PXISTAR2
NISYNC_VAL_PXISTAR3
NISYNC_VAL_PXISTAR4
NISYNC_VAL_PXISTAR5
NISYNC_VAL_PXISTAR6
NISYNC_VAL_PXISTAR7
NISYNC_VAL_PXISTAR8
NISYNC_VAL_PXISTAR9
NISYNC_VAL_PXISTAR10
NISYNC_VAL_PXISTAR11
NISYNC_VAL_PXISTAR12
NISYNC_VAL_PXISTAR13
NISYNC_VAL_PXISTAR14
NISYNC_VAL_PXISTAR15
NISYNC_VAL_PXISTAR16
NISYNC_VAL_PFI0
NISYNC_VAL_PFI1
NISYNC_VAL_PFI2
NISYNC_VAL_PFI3
NISYNC_VAL_PFI4
NISYNC_VAL_PFI5
NISYNC_VAL_PFILVDS0
NISYNC_VAL_PFILVDS1
NISYNC_VAL_PFILVDS2
NISYNC_VAL_GND
NISYNC_VAL_SYNC_CLK_FULLSPEED
NISYNC_VAL_SYNC_CLK_DIV1
NISYNC_VAL_SYNC_CLK_DIV2
NISYNC_VAL_CLKIN
NISYNC_VAL_PXIEDSTARC0
NISYNC_VAL_PXIEDSTARC1
NISYNC_VAL_PXIEDSTARC2
NISYNC_VAL_PXIEDSTARC3
NISYNC_VAL_PXIEDSTARC4
NISYNC_VAL_PXIEDSTARC5
NISYNC_VAL_PXIEDSTARC6
NISYNC_VAL_PXIEDSTARC7
NISYNC_VAL_PXIEDSTARC8
NISYNC_VAL_PXIEDSTARC9
NISYNC_VAL_PXIEDSTARC10
NISYNC_VAL_PXIEDSTARC11
NISYNC_VAL_PXIEDSTARC12
NISYNC_VAL_PXIEDSTARC13
NISYNC_VAL_PXIEDSTARC14
NISYNC_VAL_PXIEDSTARC15
NISYNC_VAL_PXIEDSTARC16

Note  Each PXI_Star and PXIe_DStarC trigger is mapped to a single slot. This mapping is vendor specific. Your chassis documentation may describe this mapping in addition to the chassis.ini and pxisys.ini system description files the PXI Specification requires.
destinationTerminal ViConstString Specifies the destination trigger terminal that the source terminal will connect to..

Valid Values:
NISYNC_VAL_PXITRIG0
NISYNC_VAL_PXITRIG1 (Default Value)
NISYNC_VAL_PXITRIG2
NISYNC_VAL_PXITRIG3
NISYNC_VAL_PXITRIG4
NISYNC_VAL_PXITRIG5
NISYNC_VAL_PXITRIG6
NISYNC_VAL_PXITRIG7
NISYNC_VAL_PXISTAR0
NISYNC_VAL_PXISTAR1
NISYNC_VAL_PXISTAR2
NISYNC_VAL_PXISTAR3
NISYNC_VAL_PXISTAR4
NISYNC_VAL_PXISTAR5
NISYNC_VAL_PXISTAR6
NISYNC_VAL_PXISTAR7
NISYNC_VAL_PXISTAR8
NISYNC_VAL_PXISTAR9
NISYNC_VAL_PXISTAR10
NISYNC_VAL_PXISTAR11
NISYNC_VAL_PXISTAR12
NISYNC_VAL_PXISTAR13
NISYNC_VAL_PXISTAR14
NISYNC_VAL_PXISTAR15
NISYNC_VAL_PXISTAR16
NISYNC_VAL_PFI0
NISYNC_VAL_PFI1
NISYNC_VAL_PFI2
NISYNC_VAL_PFI3
NISYNC_VAL_PFI4
NISYNC_VAL_PFI5
NISYNC_VAL_PFILVDS0
NISYNC_VAL_PFILVDS1
NISYNC_VAL_PFILVDS2
NISYNC_VAL_PXIEDSTARB0
NISYNC_VAL_PXIEDSTARB1
NISYNC_VAL_PXIEDSTARB2
NISYNC_VAL_PXIEDSTARB3
NISYNC_VAL_PXIEDSTARB4
NISYNC_VAL_PXIEDSTARB5
NISYNC_VAL_PXIEDSTARB6
NISYNC_VAL_PXIEDSTARB7
NISYNC_VAL_PXIEDSTARB8
NISYNC_VAL_PXIEDSTARB9
NISYNC_VAL_PXIEDSTARB10
NISYNC_VAL_PXIEDSTARB11
NISYNC_VAL_PXIEDSTARB12
NISYNC_VAL_PXIEDSTARB13
NISYNC_VAL_PXIEDSTARB14
NISYNC_VAL_PXIEDSTARB15
NISYNC_VAL_PXIEDSTARB16

Note  Each PXI_Star and PXIe_DStarB trigger is mapped to a single slot. This mapping is vendor specific. Your chassis documentation may describe this mapping in addition to the chassis.ini and pxisys.ini system description files the PXI Specification requires.


synchronizationClock ViConstString Specifies whether to use the full-speed or a divided synchronization clock to control when the trigger fires. The trigger will be synchronized with the rising or falling edge of the clock you select in this terminal.

Note  The source of the synchronization clock for software trigger connections is determined by the destination terminal trigger "zone" ("front" for the PFI and PFI_LVDS lines, and "rear" for the PXI_Trig, PXI_Star, and PXIe_DStarB terminals). The source of the synchronization clock for a given trigger zone can be selected using the NISYNC_ATTR_FRONT_SYNC_CLK_SRC (PFI zone) and NISYNC_ATTR_REAR_SYNC_CLK_SRC (PXI backplane zone) attributes.


Valid Values:
NISYNC_VAL_SYNC_CLK_ASYNC (Default)
NISYNC_VAL_SYNC_CLK_FULLSPEED
NISYNC_VAL_SYNC_CLK_DIV1
NISYNC_VAL_SYNC_CLK_DIV2

invert ViInt32 Specifies whether or not to invert the source terminal signal at the destination terminal.

Note  The source and destination must be connected synchronously for the signal to be inverted.


Valid Values:
NISYNC_VAL_DONT_INVERT (Default Value)
NISYNC_VAL_INVERT

updateEdge ViInt32 Specifies on which update edge of the synchronization clock to propagate the trigger.
Note Note  You must connect the source and destination terminals synchronously for this parameter to apply.


Valid Values:
NISYNC_VAL_UPDATE_EDGE_RISING (Default Value)
NISYNC_VAL_UPDATE_EDGE_FALLING

Return Values