niSwitch Configure Scan Trigger VI

NI Switches Help

Edition Date: April 2015

Part Number: 375472H-01

»View Product Info
Download Help (Windows Only)

Configures the scan triggers for the scan list established with the niSwitch Configure Scan List VI.

Refer to Devices to determine if the switch module supports scanning.

This VI sets the location where the switch expects to receive an input trigger to advance through the scan list. This VI also sets the location where it generates a scan advanced signal after it completes an entry in the scan list.

Related Topics

Details

niSwitch Configure Scan Trigger

/images/reference/en-XX/help/375472H-01/cio.gif

instrument handle identifies a particular NI-SWITCH session established with the niSwitch Initialize With Topology VI, the niSwitch Initialize With Options VI, or the niSwitch Initialize VI.

/images/reference/en-XX/help/375472H-01/cdbl.gif

scan delay specifies the minimum length of time you want the switch device to wait after it creates a path until it asserts a trigger on the Scan Advanced Output channel. NI-SWITCH uses this value to set the Scan Delay property. The scan delay is in addition to the settling time.

Default value: 0.0 (seconds)

/images/reference/en-XX/help/375472H-01/cenum.gif

trigger input specifies the trigger source you want the switch module to use during scanning. NI-SWITCH uses this value to set the Trigger Input property. The default value is External.

The switch module waits for a trigger at the specified location when it encounters a semicolon in the scan list. When the trigger occurs, the switch device advances to the next entry in the scan list and waits for a trigger from the location specified in trigger input.

Immediate (0)

Immediately processes the next entry in the scan list.

External (1)

Waits for a trigger on the front connector before processing the next entry in the scan list. Same as Front Connector.

Software Trigger Function (2)

Waits until the niSwitch Send Software Trigger VI is called.

TTLx (3)

Waits for a trigger on the PXI or SCXI trigger line x before processing the next entry in the scan list.

Rear Connector (4)

Valid only for SCXI. Waits for a trigger on the rear connector before processing the next entry in the scan list.

Front Connector (5)

Waits for a trigger on the front connector before processing the next entry in the scan list. Same as External.

Rear Connector of Module <1..12> (6)

Valid only for SCXI. Waits for a trigger on the rear connector of Slot <1..12> before processing the next entry in the scan list. Can be used as an alternative to calling the niSwitch Route Trigger Input VI.

Front Connector of Module <1..12> (7)

Valid only for SCXI. Waits for a trigger on the front connector of Slot <1..12> before processing the next entry in the scan list. Can be used as an alternative to calling the niSwitch Route Trigger Input VI.

/images/reference/en-XX/help/375472H-01/cenum.gif

scan advanced output (External) specifies the output terminal for the Scan Advanced Output trigger signal. NI-SWITCH uses this value to set the Scan Advanced Output property. The default value is External.

After the switch processes each entry in the scan list, it waits the length of time specified in scan delay and then asserts a trigger on the line specified in scan advanced output.

None (1)

No Scan Advanced Output trigger is produced.

External (2)

Sends the Scan Advanced Output trigger to the front connector of the switch module. Same as Front Connector.

TTLx (3)

Sends the Scan Advanced Output trigger to PXI or SCXI trigger line x.

PXI Star (4)

The switch waits until it receives a trigger on the PXI star trigger bus before processing the next entry in the scan list.

Rear Connector (5)

Valid only for SCXI. Sends the Scan Advanced Output trigger to the rear connector of the switch module.

Front Connector (6)

Sends the Scan Advanced Output trigger to the front connector of the switch module. Same as External.

Rear Connector <1..12> (7)

Valid only for SCXI. Sends a Scan Advanced Output trigger to the rear connector of Slot <1..12>. Can be used as an alternative to calling the niSwitch Route Scan Advanced Output VI.

Front Connector <1..12> (8)

Valid only for SCXI. Sends a Scan Advanced Output trigger to the front connector of Slot <1..12>. Can be used as an alternative to calling the niSwitch Route Scan Advanced Output VI.

/images/reference/en-XX/help/375472H-01/cerrcodeclst.gif

error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

/images/reference/en-XX/help/375472H-01/cbool.gif

status is TRUE (X) if an error occurred before this VI ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI ran. The default is FALSE.

/images/reference/en-XX/help/375472H-01/ci32.gif

code is the error or warning code. The default is 0. If status is TRUE, code is a non-zero error code. If status is FALSE, code is 0 or a warning code.

/images/reference/en-XX/help/375472H-01/cstr.gif

source describes the origin of the error or warning and is, in most cases, the name of the VI that produced the error or warning. The default is an empty string.

/images/reference/en-XX/help/375472H-01/iio.gif

instrument handle out identifies a particular NI-SWITCH session established with the niSwitch Initialize With Topology VI, the niSwitch Initialize With Options VI, or the niSwitch Initialize VI and used for all subsequent NI-SWITCH calls.

/images/reference/en-XX/help/375472H-01/ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

/images/reference/en-XX/help/375472H-01/ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

/images/reference/en-XX/help/375472H-01/ii32.gif

code is the error or warning code. If status is TRUE, code is a non-zero error code. If status is FALSE, code is 0 or a warning code.

/images/reference/en-XX/help/375472H-01/istr.gif

source describes the origin of the error or warning and is, in most cases, the name of the VI that produced the error or warning.

Details

For synchronous scanning, set scan advanced output to None and define trigger input. For handshaking, trigger input and scan advanced output must be set.

Triggers generally originate from the SCXI or PXI trigger bus, the terminals on the front connector of the switch module, or the AUX connector on the rear of the switch module (referred to as the rear connector and supported by SCXI only).

When scanning a module that is not directly cabled to the trigger from its own front or rear connector, use the niSwitch Route Trigger Input VI and/or the niSwitch Route Scan Advanced Output VI to route the triggers on the cabled module to one of the backplane lines. When using these VIs to route triggers to the backplane, specify the backplane trigger location when calling the niSwitch Configure Scan Trigger VI (even if it is the module cabled to the trigger source).

WAS THIS ARTICLE HELPFUL?

Not Helpful