Instrument Control Toolbox

Creating a TCP/IP Object

You create a TCP/IP object with the tcpip function. tcpip requires the name of the remote host as an input argument. In most cases, you need to specify the remote port value. If you do not specify the remote port, then 80 is used. As described in Configuring Property Values, you can also configure property values during object creation.

Each TCP/IP object is associated with one instrument. For example, to create a TCP/IP object for a Sony/Tektronix AWG520 Arbitrary Waveform Generator:

• t = tcpip('sonytekawg.mathworks.com',4000);
  

Note that the port number is fixed and is found in the instrument's documentation.

The TCP/IP object t now exists in the MATLAB workspace. You can display the class of t with the whos command.

• whos t
    Name      Size                   Bytes  Class
  
    t         1x1                      640  tcpip object
  
  Grand total is 16 elements using 640 bytes
  

Once the TCP/IP object is created, the properties listed below are automatically assigned values. These general purpose properties provide descriptive information about the TCP/IP object based on the object type, the remote host, and the remote port.

Table 6-1: TCP/IP Descriptive Properties 

Property Name	Description
Name	Specify a descriptive name for the TCP/IP object.
RemoteHost	Specify the remote host.
RemotePort	Specify the remote host port for the connection.
Type	Indicate the object type.

You can display the values of these properties for t with the get function.

• get(t,{'Name','RemoteHost','RemotePort','Type'})
  ans = 
      [1x31 char]    [1x24 char]    [4000]    'tcpip'
  

TCP/IP and UDP Overview

The TCP/IP Object Display