Add New Device and Configure Connection

R2026b

Toolstrip Settings

In the Resource section of the toolstrip, identify the instrument you want to connect to,by specifying the Interface and Resource name.

1. Select the interface that you want to use to connect to your instrument. Possible options for Interface are TCP/IP VXI-11, TCP/IP HiSLIP, and TCP/IP Socket.

2. Enter the full Resource name. If you are not sure of the resource name format, click Generate Resource for a dialog box to generate the name.

   • Use the Generate Resource and Test Connection dialog box to construct the resource name. Specify the required parameters, including the instrument board index, host name or IP address, port, and device ID.

   • Click Generate Resource to have the Resource Name field filled in for you.

   • Click Test Connection to validate the resource name and verify a test connection to the device.

   • When the test is successful, click Confirm to close the dialog box. In the app toolstrip, the Resource field is automatically filled with the constructed name.

   For more information on the format of resource names for different interfaces, see the Resource Name Formats table below.

3. In the Driver pull-down menu, select the driver for your device. If your driver is not available in the list, click Don't See Your Driver? for more information.

4. The Class-Compliant menu indicates:

   • true — The IVI class-compliant driver for the instrument is used for connection and communication operations.

   • false — The driver itself is used for communicating with the instrument.

   The app allows the Class-Compliant setting to be changed for some drivers. For more information on IVI class-compliant drivers, click Don't See Your Driver?

5. In the Optional Parameters section, set any parameter values where you do not want to use the default. For descriptions, see the Optional Parameters table below.

6. To start communicating with your instrument, click Confirm Parameters. If the connection is successful, your resource appears in the Device List.

You can return to the device selection view at any time by clicking Cancel.

Resource Name Formats

Each interface has a different format, as described in the following table. Replace the italicized text with values for the specified parameters. The parameters in brackets are optional.

Interface	Resource Name
TCP/IP VXI-11 and TCP/IP HiSLIP	TCPIP[board]::remote_host[::lan_device_name]::INSTR
TCP/IP Socket	TCPIP[board]::remote_host::port::SOCKET

Optional Parameters

Parameter	Description
Simulate	Run the instrument in simulation mode, without requiring hardware. You can specify additional parameters, such as a simulated instrument model, using the Driver Setup option.
Cache	The driver caches attribute values to offer better performance by reducing I/O traffic.
Interchange Check	The driver keeps track of each interchangeability warning it encounters.
Query Instrument Status	The driver checks the instrument's error status after each operation.
Range Check	The driver validates parameter values that you pass into driver functions.
Record Coercions	The driver keeps a record of each value coercion.
ID Query	Query the instrument ID and check that it is valid for the driver.
Reset Device	Reset the instrument to a known state.
Timeout	Allowed time to find and connect to the instrument, specified in seconds.
Driver Setup	Specify additional settings defined by the vendor driver. Refer to the vendor driver documentation for more information.
Additional Option String	Specify instrument attribute values in the same format that you pass into InitWithOptions. You can copy the option string from your C code and use it here.