Scanning Configuration:Scan List Property

NI Switches Help

Edition Date: April 2015

Part Number: 375472H-01

»View Product Info
Download Help (Windows Only)

Short Name: Scan List

Property of niSwitch

Contains a scan list (a string that specifies channel connections and trigger conditions). The niSwitch Initiate Scan VI makes or breaks connections and waits for triggers according to the instructions in the scan list. The scan list is comprised of channel names separated by special characters that determine the operations the scanner performs on the channels when it executes the scan list.

To create a path between two channels, use the following character between the two channel names: -> (a dash followed by a '>' sign) Example: 'CH1->CH2' tells the switch to make a path from channel CH1 to channel CH2.

To break or clear a path, use the following character as a prefix before the path: ~ (tilde) Example: '~CH1->CH2' tells the switch to break the path from channel CH1 to channel CH2.

To tell the switch module to wait for a trigger event, use the following character as a separator between paths: ; (semi-colon) Example: 'CH1->CH2;CH3->CH4' tells the switch to make the path from channel CH1 to channel CH2, wait for a trigger, and then make the path from CH3 to CH4.

To tell the switch module to create multiple paths as quickly as possible, use the & (ampersand) or && (double ampersand) as a separator between the paths. The & in 'CH0->CH1;CH2->CH3&CH4->CH5' instructs the scanner to make the path between channels CH0 and CH1, wait for a trigger, and then make the paths between channels CH2 and CH3 and between channels CH4 and CH5 in no particular order without waiting for settling or waiting for a trigger. If wait for settling is desired, replace & with &&. The && in 'CH0->CH1;CH2->CH3&&CH4->CH5' instructs the scanner to make the path between channels CH0 and CH1, wait for a trigger, and then make the path between channels CH2 and CH3, wait for settling, then make the path between channels CH4 and CH5.

Related topics

Remarks

The following table lists the characteristics of this property.

Datatype string
PermissionsRead/Write
Channel-based No
ResettableNo

WAS THIS ARTICLE HELPFUL?

Not Helpful