UDP Receive

Receive UDP packets from UDP host

Since R2022b

• 

Libraries:
STM32 Microcontroller Blockset / (Legacy) STM32 MBED Based Boards / STM32F7
STM32 Microcontroller Blockset / (Legacy) STM32 MBED Based Boards / STM32H7

Description

The UDP Receive block receives UDP packets from a UDP host. Use the block for stateless and connectionless data transmission.

With each sample, the block outputs the contents of a UDP packet as a (Nx1) array.

The block receives the packets on the port number specified in the Local IP Port parameter from the IP address specified in the Remote IP address (0.0.0.0 for accepting all) parameter. To receive packets from all the sending hosts, specify the remote IP address as 0.0.0.0. Match the port number specified in the Local IP Port parameter with the remote port number of the sending host.

You can choose to receive the UDP packets in blocking or non-blocking mode.

Note

• Ensure to configure the Ethernet options in STM32CubeMX project. For more, see Ethernet Configuration in STM32CubeMX for STM32 Processor-Based Boards.

• If you are having trouble using UDP to communicate with a computer, investigate if antivirus or firewall software is blocking UDP traffic. If so, try to configure the software to allow the traffic for a specific IP port number.

Examples

Get Started with STMicroelectronics STM32 Processor Based Boards

Run a Simulink model on STM32 processor.

• Open Model

Ports

Output

Data — Output UDP packets received from UDP host

vector

At each sample time, the port outputs the contents of a packet received as a data vector of the size that you specify in the Data size (N) parameter.

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

Status — Determine if requested data is received at given time step

scalar

At each sample time, the port outputs 0 when the length of data received is greater than or equal to the length specified in the Data size (N) parameter. A value of 0 indicates that the requested data is received at the given time step. Otherwise, it outputs a nonzero value, indicating that no new data is available.

For more information, see Receive UDP Packets.

Dependencies

To enable this port, select the Output error status parameter.

Data Types: uint16

Parameters

Remote IP address (0.0.0.0 for accepting all) — IP address from which block receives UDP packets

0.0.0.0 (default)

Specify the IP address of the remote host from which the block receives packets. To receive packets from all the sending hosts, specify 0.0.0.0.

Programmatic Use

Block Parameter: RemoteIPAddress

Local IP Port — IP port on receiving UDP host

25010 (default) | Any integer between 1 and 65535

Specify the port number of the application from which you want to receive the packets. Match the local port number with the remote port number of the sending host.

Programmatic Use

Block Parameter: LocalPort

Wait until data received — Wait until requested data is available

off (default) | on

• on — When you select this parameter, the read operation runs in the Blocking mode. The read operation is blocked while waiting for the requested data to be available. If data is available, the Data port outputs data. If data is not available, the Data port waits for data.

  A task overrun occurs if the target hardware is still waiting for the data to be available when the next read operation is scheduled to begin.

  To fix overruns:

  • Increase the time step by using the Sample time parameter.

  • Reduce the length of data requested by using the Data size (N) parameter.

• off — When you clear this parameter, the read operation runs in the Non-blocking mode. When reading data, if data is not available, the Data port contains the packet received in the previous time step. In this mode, the block does not wait for the requested data to be available.

Programmatic Use

Block Parameter: BlockingMode

Data type — Data type of elements in UDP packets

uint8 (default) | double | single | int8 | int16 | uint16 | int32 | uint32 | boolean

Select the data type in which the block receives the elements from the sending host. The size of each element depends on its data type.

Programmatic Use

Block Parameter: DataType

Data size (N) — Number of data elements in each UDP packet

1 (default) | scalar

Specify the number of elements that you want to receive in each packet. The data size must be scalar values.

Programmatic Use

Block Parameter: DataLength

Output error status — Option to display the error status during data transmission

off (default) | on

Select this parameter to display the error status during data transmission.

When you select the Output error status parameter, the block configures an output port. The port on the block is labeled as Status, indicating that the block outputs the status of the read operation at the output port.

Programmatic Use

Block Parameter: OutputStatus

Sample time — How often this block reads packets from the sending UDP host

-1 (default)

When you specify this parameter as-1, Simulink^® determines the best sample time for the block based on the block context within the model.

Programmatic Use

Block Parameter: SampleTime

More About

Receive UDP Packets

This example describes the values at the output ports when the length of the packets received is less than, greater than, or equal to the length of requested data.

• Length of UDP packet received = Data size (N): The Data port outputs the packet as a data vector of the size specified in the Data size (N) parameter.

  The Status port outputs 0, indicating that the requested data is received.

  Suppose that the Data size (N) parameter specified is 4 and the length of the packet received is also 4.

  In this case, the Data port outputs a data vector of size 4 filled with the elements of the packet.

  The value at the Status port is 0.

  

• Length of UDP packet received < Data size (N): The Data port outputs the packet as a data vector of the size specified in the Data size (N) parameter. All the empty spaces in the vector are filled with random values.

  The Status port outputs a nonzero value, indicating that no new data is received.

  Suppose that the Data size (N) parameter specified is 4 and the length of data received is 3 bytes.

  In this case, the Data port outputs a data vector of size 4. The first three elements in the vector are the elements from the received packet. The remaining space is filled with a random value.

  The Status port outputs a nonzero value.

  

• Length of UDP packet received > Data size (N): The Data port outputs a data vector of the size specified in the Data size (N) parameter. The vector contains only the first N elements from the packet. The remaining elements are dropped.

  The Status port outputs 0, indicating that the requested data is received.

  Suppose that the Data size (N) parameter specified is 4 and the length of data received is 5 bytes. In this case, the Data port outputs a data vector of size 4. The vector contains only the first four elements from the received packet. The remaining element is dropped. The value at the Status port is 0.

  

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2022b