Learn more about Instrument Control Toolbox

tcpip - Create TCPIP object

Syntax

obj = tcpip('rhost') obj = tcpip('rhost',rport) obj = tcpip(...,'PropertyName',PropertyValue,...)

Arguments

`'rhost'`	The remote host.
`rport`	The remote port.
`'``PropertyName``'`	A TCPIP property name.
`PropertyValue`	A property value supported by `PropertyName`.
`obj`	The TCPIP object.

Description

obj = tcpip('rhost') creates a TCPIP object, obj, associated with remote host rhost and the default remote port value of 80.

obj = tcpip('rhost',rport) creates a TCPIP object with remote port value rport.

obj = tcpip(...,'PropertyName',PropertyValue,...) creates a TCPIP object with the specified property name/property value pairs. If an invalid property name or property value is specified, the object is not created.

Remarks

At any time, you can use the instrhelp function to view a complete listing of properties and functions associated with TCPIP objects.

instrhelp tcpip

When you create a TCPIP object, these property values are automatically configured:

Type is given by tcpip.
Name is given by concatenating TCPIP with the remote host name specified in the tcpip function.
RemoteHost and RemotePort are given by the values specified in the tcpip function.

You can specify the property names and property values using any format supported by the set function. For example, you can use property name/property value cell array pairs. Additionally, you can specify property names without regard to case, and you can make use of property name completion. For example, the following commands are all valid.

t = tcpip('144.212.113.252','InputBufferSize',1024);
t = tcpip('144.212.113.252','inputbuffersize',1024);
t = tcpip('144.212.113.252','INPUT',1024);

When the TCPIP object is constructed, the Status property value is closed. Once the object is connected to the host with the fopen function, the Status property is configured to open.

The default local host in multihome hosts is the system's default. The LocalPort property defaults to a value of [] and it causes any free local port to be used. LocalPort is updated when fopen is issued.

Examples

Start a TCP/IP echo server and create a TCPIP object.

echotcpip('on',4012)
t = tcpip('localhost',4012);

Connect the TCPIP object to the host.

fopen(t)

Write to the host and read from the host.

fwrite(t,65:74)
A = fread(t, 10);

Disconnect the TCPIP object from the host and stop the echo server.

fclose(t)
echotcpip('off')

tcpip - Create TCPIP object

Syntax

Arguments

Description

Remarks

Examples

See Also

Functions

Properties

Recommended Products