TCP/IP Receive

R2026b

Receive data over TCP/IP network from remote host

expand all in page
  • TCP/IP Receive block

Libraries:
Simulink Coder Support Package for BeagleBone Blue Hardware / Communication
Simulink Support Package for Android Devices / Communication
Simulink Support Package for LEGO MINDSTORMS EV3 Hardware
Raspberry Pi Blockset / Network

Description

Receive data from a remote host/another target hardware over a network. When you set the connection mode as server, you must provide the local port. The local port acts as the listening port of the TCP/IP server. When you set the block as a client, you must provide the remote address and the remote port of the TCP/IP server to receive data. The block accepts data either in blocking mode or in non-blocking mode. The Data port output contains the requested data at each time step. The Status port contains 0 or 1 to indicate whether the new data at the specified time step is received. The Status port value 1 indicates that the data from Data port is valid.

In the blocking mode, the model blocks the execution while it waits for the requested data to become available.

blocking mode

At time step 1, the block requests four data, and the buffer gets four data values. The block returns the four received data values at the Data port, and the execution continues.

At time step 2, the block requests data again, but the buffer gets only three values. Because the requested data size is 4, the block waits until the buffer receives the fourth data value or the timeout value elapses. During this phase, the execution pauses.

At time step 3, the buffer contains sufficient data to satisfy the request. The block returns the first four data values in the order received, and the execution resumes. Any remaining data values are used in the next receipt cycle.

In non-blocking mode, the model runs continuously.

non blocking mode

At time step 1, the block requests data, and the buffer gets four data values. The block sets the Status port value to 1, indicating that the requested data is available. The Data port, at this point, contains the newly received data values.

At time step 2, the block requests data again, but the buffer gets only three values. The block cannot return the data because the data size is specified as 4. Therefore, the block sets the Status port value to 0, indicating that the requested data is not available. All values on the Data port become 0. The buffer, at this point, has three data values. However, during this phase, the execution does not stop unlike in the blocking mode.

At time step 3, the buffer has five data values, and the block returns the first four data values in the order received and sets the Status port value to 1. The remaining data value is used in the next receipt cycle.

Ports

Output

expand all

Data received by the block from the remote address , returned as an [Nx1] array.

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean

Status of data received by the block.

  • 1 — Indicates the block received the requested amount of data, and the data at the Data port is valid.

  • 0 — Indicates the requested amount of data is not available. The block outputs zeros at the Data port.

Data Types: Boolean

Parameters

expand all

Main Tab

Select the option to connect the block as TCP/IP server or TCP/IP client.

Enter the local port number which acts as the listening port of the TCP/IP server. This parameter appears only when you set the Connection mode to Server

Enter the remote server address from which to receive the data. This parameter appears only when you set the Connection mode to Client.

Enter the remote server port. This parameter appears only when you set the Connection mode to Client.

Select the data type that is to be received from the remote host.

Enter the data size to be received from the remote host.

Enter the time frequency at which to receive data.

Advanced Tab

Allow manual specification of local IP port at which to receive data. This parameter appears only when you set the Connection mode to Client.

Enter the local port of the client to receive data. This parameter appears only when you set the Connection mode to Client and select the check box Manually specify local IP port.

Select this option to specify if the block waits for the data to be received. Selecting this check box enables the blocking mode.

Specify the time the block waits for the data to be received during each simulation time step. This field is unavailable, if you have not selected Wait until data received parameter. Enter ‘inf’ value in this parameter, if you want the block to wait indefinitely until it receives the data.

Version History

Introduced in R2017a