instrcomm (Instrument Control Toolbox)

Instrument Control Toolbox

instrcomm

Graphical tool for communicating with an instrument using text data

Syntax

```
instrcomm(obj)
```

instrcomm

Arguments

obj
An instrument object

`obj`	An instrument object

Description

instrcomm(obj) launches the Instrument Control ASCII Communication Tool for the instrument object obj. instrcomm provides you with these features and capabilities:

Connect obj to the instrument, and disconnect obj from the instrument.
Initiate and terminate recording.
Perform synchronous read, write, and query operations for text commands. A history of transferred data is also provided.
Flush the input buffer.
Monitor the values sent and values received.

instrcomm launches the Instrument Control Configuration Tool, instrcreate. After you create an instrument object, it is automatically passed to the Instrument Control ASCII Communication Tool.

Example

This example uses instrcomm to communicate with a Tektronix TDS 210 oscilloscope, and saves the data to a record file. The read and write operations are taken from Example: Writing and Reading Text Data.

First, create the GPIB object g at the command line. Note that you can also create this object using instrcreate.

```
g = gpib('ni',0,1);
```

Launch the Instrument Control ASCII Communication Tool for g.

```
instrcomm(g)
```

The initial instrcomm window is shown below. Note that the object name is displayed in the figure title.

The communication session follows these steps:

In the Communication State panel, select the Connect button to connect g to the instrument, and select the Start button to initiate recording.
Input the instrument commands one at a time, and select the Write, Read, or Query button as needed for each command.

You can specify the command and data format using the Format parameters, and you can clear the commands and data from the interface tool using the Clear Commands and Clear Data buttons, respectively.

The complete communication session is shown below. The most recent command written to the instrument is at the top of the Command list, while the most recent command response read from the instrument is at the bottom of the Data list.

See Also

Functions

instrcreate

instrcallback instrcreate