UDP Receive
Receive UDP packet
Add-On Required: This feature requires the Embedded Coder Support Package for AMD SoC Devices add-on.
Description
The UDP Receive block receives UDP packets from an IP network port and saves them to its buffer.
With each sample, the block output the contents of a single UDP packet as a data vector.
Ports
Outputs
Message — Received messages
N-by-1 array
The UDP Receive block outputs the received UDP packets
as an N-by-1 data vector. The Data type for Message
and Length
parameters set the vector data type and
length, N, respectively.
This port is unnamed while Output variable-size
signal
is enabled.
Data Types: single
| double
| int8
| int16
| int32
| uint8
| uint16
| uint32
| Boolean
Length — Length of the Message vector
positive scalar
This port outputs the length of the message vector signal on port
Message
.
This port is hidden while Output variable-size
signal
is enabled.
Data Types: single
Parameters
Local IP port — Local IP port
25000
(default) | 1 – 65535
Enter the IP port number on your hardware board that receives UDP data packets.
Note
On Linux®, to set the IP port number below 1024, run MATLAB® with root privileges. For example, at the Linux command line, enter:
sudo matlab
Remote IP address — Remote IP address
'0.0.0.0'
(default) | character vector
Enter the IP address from which to accept packets. Entering a specific IP
address blocks UDP packets from other addresses. To accept packets from any
IP address, enter '0.0.0.0'
.
Receive buffer size (bytes) — Receive buffer size
8192 (default) | positive integer scalar
Make the receive buffer large enough to avoid data loss caused by buffer overflows.
Maximum length for Message — Maximum length for Message
255 (default) | positive integer scalar
Enter the maximum length, in vector elements, of the data output vector. Set this parameter to a value equal or greater than the data size of a UDP packet. The system truncates data that exceeds this length.
If you disable Output variable-size signal, the block outputs a fixed-length output the same length as the Maximum length for Message.
Data type for Message — Data type for Message
uint8 (default) | single | double | int8 | int16 | uint16 | int32 | uint32 | boolean
Set the data type of the vector elements in the Message output. Match the data type with the data input used to create the UDP packets.
Output variable-size signal — Output variable-size signal
on (default) | off
To support signals of varying length in your model, select this parameter. To support fixed-length signals, clear this parameter. When you clear this parameter, the block:
Emits the data vector of fixed-length, set by the Maximum length for Message, from the Message output.
Emits the length of the valid data from the Length output.
If the UDP packet contains less data than the fixed-length output, the difference contains invalid data.
In both cases, the block truncates data that exceeds the Maximum length for Message.
Blocking time (seconds) — Time to wait for UDP packet
inf (default) | positive scalar
For each sample, wait this length of time for a UDP packet before
returning control to the scheduler. This value defaults to
inf
, which indicates to wait indefinitely.
Sample time (seconds) — Sample time
0.01 (default) | positive scalar
Enter how often the scheduler runs this block. Enter a value greater than zero. In real-time operation, setting this option to a large value reduces the likelihood of dropped UDP messages.
Extended Capabilities
C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.
Comando de MATLAB
Ha hecho clic en un enlace que corresponde a este comando de MATLAB:
Ejecute el comando introduciéndolo en la ventana de comandos de MATLAB. Los navegadores web no admiten comandos de MATLAB.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)