niSE Connect And Disconnect VI
- Updated2023-02-21
- 6 minute(s) read
niSE Connect And Disconnect VI
Connects the routes specified by the Connection Specification. When connecting, it may allow for multiconnection based on the Multiconnect Mode. Disconnects the routes specified in the Disconnection Specification. This VI is useful for switching from one state to another state.
This function will not wait for debounce. Call the niSE Wait for Debounce function to wait for debounce.
 |
Multiconnect Mode (Use Default Mode) sets the connection mode for the VI. The mode may be one of the following:
|
||||||
 |
NISE Session (in) is the session referencing this NI Switch Executive virtual device. Session handles are created through a call to the niSE Open Session VI. |
||||||
 |
Connection Specification ("") is the string describing the connections to be made. Refer to Route Specification Strings for more information. |
||||||
|
Disconnection Specification ("") is the string describing the disconnections to be made. Refer to Route Specification Strings for more information. You can use an asterisk in this parameter to accomplish the following: 1. For NISE_VAL_BREAK_BEFORE_MAKE operation order, an asterisk (*) will disconnect all connections currently connected and connect what is in the Connection Specification parameter. However, this action maintains as closed those connections currently connected that also exist in the Connection Specification parameter. This behavior minimizes relay actuation and thus extends the life of the relays. 2. For NISE_VAL_BREAK_AFTER_MAKE operation order, the VI connects what is in the Connection Specification parameter and the asterisk (*) will disconnect all other connections. As in case 1, this action maintains as closed those connections currently connected that also exist in the Connection Specification parameter. This behavior minimizes relay actuation and thus extends the life of the relays. |
||||||
 |
error in (no error) describes error conditions that occur before this node runs. This input provides standard error in functionality.
|
||||||
 |
Wait For Debounce (T), if TRUE, waits for all switches to debounce before it returns. If FALSE, it immediately returns after the switch control is completed.
|
||||||
|
Operation Order (Break After Make) sets the order of the operation for the VI. Defined values are Break Before Make and Break After Make.
|
||||||
 |
NISE Session (out) is the session referencing this NI Switch Executive virtual device. Session handles are created through a call to the niSE Open Session VI. This session handle is the copy of the session handle that was passed in and provides for easier wiring between NI Switch Executive VIs. |
||||||
 |
error out contains error information. This output provides standard error out functionality.
|
Details
The niSE Connect And Disconnect VI manipulates the hardware connections and disconnections only when the routes are different between the connection and disconnection specifications. If any routes are common between the connection and disconnection specifications, NI Switch Executive determines whether the relays need to be switched. This functionality has the distinct advantage of increased throughput for shared connections, because hardware does not have to be involved and potentially increases relay lifetime by decreasing the number of times that the relay has to be switched.
In the event of an error, the call to the niSE Connect And Disconnect VI attempts to undo any connections made, but does not attempt to reconnect disconnections. Some errors can be caught before manipulating hardware, although it is feasible that a hardware call could fail causing some connections to be momentarily closed and then reopened.