niSwitch Configure Scan Trigger

NI-SWITCH LabVIEW

niSwitch Configure Scan Trigger

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

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. Details

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

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.00 (seconds)

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.

ValueSwitch Behavior
ImmediateImmediately processes the next entry in the scan list.
ExternalWaits for a trigger on the front connector before processing the next entry in the scan list. Same as Front Connector.
Software Trigger FunctionWaits until niSwitch Send Software Trigger is called.
TTLx Waits for a trigger on the PXI or SCXI trigger line x before processing the next entry in the scan list.
Rear ConnectorValid only for SCXI. Waits for a trigger on the rear connector before processing the next entry in the scan list.
Front ConnectorWaits 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>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 niSwitch Route Trigger Input.
Front Connector of Module <1..12>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 niSwitch Route Trigger Input.

scan advanced output—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.

ValueSwitch Behavior
NoneNo Scan Advanced Output trigger is produced.
ExternalSends the Scan Advanced Output trigger to the front connector of the switch module. Same as Front Connector.
TTLxSends the Scan Advanced Output trigger to PXI or SCXI trigger line x.
Rear ConnectorValid only for SCXI. Sends the Scan Advanced Output trigger to the rear connector of the switch module.
Front ConnectorSends the Scan Advanced Output trigger to the front connector of the switch module. Same as External.
Rear Connector <1..12>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 niSwitch Route Scan Advanced Output.
Front Connector <1..12>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 niSwitch Route Scan Advanced Output.
error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurs before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.
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.
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.
source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
instrument handle out identifies a particular NI-SWITCH session established with niSwitch Initialize With Topology, niSwitch Initialize With Options, or niSwitch Initialize and used for all subsequent NI-SWITCH calls.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out indicator on the front panel and select Explain Error from the shortcut menu for more information about the error.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
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.
source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

niSwitch Configure Scan Trigger 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 niSwitch Route Trigger Input and/or niSwitch Route Scan Advanced Output 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 niSwitch Configure Scan Trigger (even if it is the module cabled to the trigger source).