Get Information Operation (IVI Switching Mode)

Switch Info Tab

The Switch Info tab for the Get Information operation contains the following options:

• Can Connect —Returns a value that indicates whether the switch module can create a given path without actually creating the path.
  • Channel 1 —The end points for the path you are creating.
  • Channel 2 —The end points for the path you are creating.
  • Destination —A variable or property to which the step assigns the return value.
  The return value is valid at the time the step is called. You can make a successful connection when the Can Connect operation return value is Path Available . Any other return value gives a reason why an attempt at a connection between the channels fails. If an implicit connection exists between the two specified channels, the Can Connect operation returns a warning that the connection already exists.

  Supported Value	Description
  Channel Not Available (6)	Specifies that the driver cannot create a path between the two channels because one of the channels is a Configuration channel and thus unavailable for external connections.
  Path Available (1)	Specifies that the driver can create a path at this time.
  Path Exists (2)	Specifies that the explicit path between the channels already exists.
  Path Unsupported (3)	Specifies that the instrument is not capable of creating a path between the two channels.
  Resource In Use (4)	Specifies that, although the path is valid, the driver cannot create the path at this moment because the switch module is currently using one or more of the required channels to create another path. You must destroy the other path before you create this one.
  Source Conflict (5)	Specifies that the instrument cannot create a path between the two channels because both are connected to a different source channel.

• Is Scanning —A variable or property to which the step assigns the value that indicates whether the switch module is currently scanning through the scan list. Polling this function is one way to determine if the switch module scanning is complete. You can also use the Wait operation and enable the Wait For Scan Complete option, which blocks until the scan is complete. If the instrument is waiting for a trigger, TestStand returns a value of True .
• Is Debounced —A variable or property to which a step assigns the value that indicates whether or not all signals flowing through the switch have settled and whether it is safe to make a measurement at this time.
• Get Path —Returns the list of connections, as comma-delimited channel pairs, established to connect the two given channels.
  • Channel 1 —The end points for the path you are trying to retrieve.
  • Channel 2 —The end points for the path you are trying to retrieve.
  • Destination —A variable or property to which the step assigns the path.
  Use the Get Path operation to understand the signal characteristics of the path and to provide an explicit path for Set Path in the Configure Scan operation. The first and last names in the path are the channel names of the path and all others channels in the path are Configuration channels. The only valid paths that can be returned are those explicitly set using Set Path or a Connect/Disconnect operation. If no explicit path exists between the two specified channels, TestStand returns an error.
• Get Number of Columns —A variable or property to which a step assigns the value that indicates the maximum number of channels on the column of a matrix or scanner. If the switch module is a scanner, this value is the number of input channels. The number returned is dependent on the wire mode settings.
• Get Number of Rows —A variable or property to which a step assigns the value that indicates the maximum number of channels on the row of a matrix or scanner. If the switch module is a scanner, this value is the number of output channels (commons) of the scanner. The number returned is dependent on the wire mode settings.

See Also

Route Specification Strings