Main Content

TCP/IP Interface

Communication using the TCP/IP clients and servers

Transmission Control Protocol (TCP) is a transport protocol layered on top of the Internet Protocol (IP) and is one of the most used networking protocols. Instrument Control Toolbox™ support for TCP/IP communication includes the ability to create clients and servers. TCP/IP client support enables you to use network socket communication to connect to remote hosts from MATLAB® for reading and writing both binary and ASCII data. TCP/IP server support enables you to create a network socket for communication between MATLAB and a single client.

Use tcpclient to create a TCP/IP client that connects to a server or hardware and perform read and write operations. Use tcpserver to create a TCP/IP server.

Functions

expand all

Connect and Configure

tcpclientCreate TCP/IP client connection with TCP/IP server
configureTerminatorSet terminator for ASCII string communication with remote host over TCP/IP
configureCallbackSet callback function and trigger condition for communication with remote host over TCP/IP

Read and Write

readRead data from remote host over TCP/IP
readlineRead line of ASCII string data from remote host over TCP/IP
readbinblockRead one binblock of data from remote host over TCP/IP
writeWrite data to remote host over TCP/IP
writelineWrite line of ASCII data to remote host over TCP/IP
writebinblockWrite one binblock of data to remote host over TCP/IP
writereadWrite command to remote host over TCP/IP and read response
flushClear buffers for communication with remote host over TCP/IP

Connect and Configure

tcpserverCreate TCP/IP server
configureTerminatorSet terminator for ASCII string communication
configureCallbackSet callback function and trigger condition for communication

Read and Write

readRead data sent to TCP/IP server
readlineRead line of ASCII string data sent to TCP/IP server
readbinblockRead one binblock of data sent to TCP/IP server
writeWrite data from TCP/IP server
writelineWrite line of ASCII data from TCP/IP server
writebinblockWrite one binblock of data from TCP/IP server
flushClear buffers for communication using TCP/IP server
resolvehostResolve network host name or IP address
echotcpipStart or stop TCP/IP echo server

Blocks

Query InstrumentQuery or read instrument data
To InstrumentSend simulation data to instrument
TCP/IP ReceiveReceive data over TCP/IP from specified remote machine
TCP/IP SendSend data over TCP/IP to specified remote machine

Topics

TCP/IP Communication

TCP/IP Communication Overview

Use network socket communication to connect to remote hosts from MATLAB for reading and writing data over TCP/IP.

TCP/IP and UDP Comparison

Compare the TCP/IP and UDP protocols to determine which to use.

TCP/IP Client

Create TCP/IP Client and Configure Settings

Connect to remote hosts or hardware from MATLAB for reading and writing data over TCP/IP.

Write and Read Data over TCP/IP Interface

Write and read data to and from the remote host connected to the tcpclient object.

Use Callbacks for TCP/IP Communication

Enhance TCP/IP communication by executing a callback function when a specified event occurs.

Transition Your Code to tcpclient Interface

Create TCP/IP client connections using tcpclient instead of tcpip.

TCP/IP Server

Communicate Using TCP/IP Server Sockets

Communicate between a client and MATLAB, or between two instances of MATLAB.

Transition Your Code to tcpserver Interface

Create TCP/IP server connections using tcpserver instead of tcpip.

Troubleshooting

Troubleshooting TCP/IP Client Interface

Troubleshoot the TCP/IP client interface.

Resolve TCP/IP Client Warning: Unable to Read Any Data

Troubleshoot when you receive no data and you get the warning message: 'tcpclient' unable to read any data.

Troubleshooting TCP/IP Server Interface

Troubleshoot the TCP/IP server interface.

Resolve TCP/IP Server Warning: Unable to Read Any Data

Troubleshoot when you receive some data and you get the warning message: 'tcpserver' unable to read any data.

Resolve TCP/IP Server Warning: Unable to Read All Data

Troubleshoot when you receive some data and you get the warning message: 'tcpserver' unable to read all requested data.

Featured Examples