RTSP Video Stream Receive

R2026b

Receive video from network over real-time streaming protocol

Since R2024b

• 

RTSP Video Stream Receive block

To add a block to a model, double-click the canvas and start typing the block name. Then, select the block from the list.

Libraries:
Raspberry Pi Blockset / Audio and Video

Description

Use the RTSP Video Stream Receive block to receive a real-time streaming protocol (RTSP) video stream from a network from a streaming source. You can create a source to stream the video over a network using either the RTSP Video Stream Transmit block or any other RTSP streaming device. The block outputs either a grayscale, RGB, or YCbCr video. The block can decode the video stream using the H264 or JPEG video encoding standards.

Note

To generate C/C++ code for this block, you must have an Embedded Coder^® license.

Examples

Stream Video over Network Using Raspberry Pi RTSP Video Stream Transmit Block

Use the RTSP Video Stream Transmit block from Raspberry Pi® Blockset to stream a live video over a network using real-time streaming protocol (RTSP).

• Open Model

Receive Video over Network Using Raspberry Pi RTSP Video Stream Receive Block

Use the RTSP Video Stream Receive block from the Raspberry Pi® Blockset to receive a live video over a network using real-time streaming protocol (RTSP).

• Open Model

Ports

Output

Status — Status of stream video

scalar

The port outputs the status of the RTSP Video Stream Receive block upon the video reception from the transmitter.

• 0 — Indicates a successful read operation of the video stream over the network.

• 1 — Indicates an interrupted stream from the transmitter which further results that the RTSP Video Stream Receive block cannot read any further data from the transmitter.

• 2 — Indicates a stream error that requires user intervention to fix it, for example, the Raspberry Pi^® hardware fails to receive data from the transmitter.

• 3 — Indicates a GStreamer pipeline creation error that can occur due to misconfiguration of stream URL or image properties.

• 4 — Indicates a fatal error that prevents the further execution of the block, for example, an internal program failure.

Data Types: int32

R — Red component of output video

matrix

Red channel signal of the RGB video, specified as an M-by-N grid of pixels. Here, M is the number of rows and N is the number of columns for the red component.

Dependencies

• To enable this port, set Image format to RGB.

Data Types: uint8

G — Green component of output video

matrix

Green channel signal of the RGB video, specified as an M-by-N grid of pixels. Here, M is the number of rows and N is the number of columns for the green component.

Dependencies

• To enable this port, set Image format to RGB.

Data Types: uint8

B — Blue component of output video

matrix

Blue channel signal of the RGB video, specified as an M-by-N grid of pixels. Here, M is the number of rows and N is the number of columns for the blue component.

Dependencies

• To enable this port, set Image format to RGB.

Data Types: uint8

Y — Luma component of output video

matrix

Luminance component of video, specified as an M-by-N grid of pixels. Here, M is the number of rows and N is the number of columns for the luminance component.

Dependencies

• To enable this port, set Image format to YCbCr 4:2:2.

Data Types: uint8

Cb — Blue difference chroma component of output video

matrix

Blue difference chroma component of video, specified as an M-by-N grid of pixels. Here, M is the number of rows and N is the number of columns for the blue difference chroma component.

Dependencies

• To enable this port, set Image format to YCbCr 4:2:2.

Data Types: uint8

Cr — Red difference chroma component of output video

matrix

Red difference chroma component of video, specified as an M-by-N grid of pixels. Here, M is the number of rows and N is the number of columns for the red difference chroma component.

Dependencies

• To enable this port, set Image format to YCbCr 4:2:2.

Data Types: uint8

I — Grayscale output video

matrix

Grayscale video, specified as an M-by-N grid of pixels. Here, M is the number of rows and N is the number of columns for the grayscale video.

Dependencies

• To enable this port, set Image format to Grayscale.

Data Types: uint8

Parameters

RTSP URL — RTSP stream URL

rtsp://127.0.0.1:8554/stream01 (default) | char | string

Specify a unique RTSP URL to receive the video stream in this format: rtsp://<raspberrypi IP address>/<mount point identifier>

Image format — Output video stream format

RGB (default) | YCbCr 4:2:2 | Grayscale

Specify the format of the output video stream.

Tip

To view a color video on your device, set this parameter to YCbCr 4:2:2. Because this format requires less bandwidth, you can stream the video without significantly affecting the video quality.

Image size — Image resolution of video frames

640x480 (default) | 160x120 | 320x240 | 800x600 | 1280x720 | custom

Specify image resolution of the video frames, in pixels.

Image size ([width, height]) — Custom image resolution

[640, 480] (default) | [width, height]

Specify customized resolution of the output image, in pixels.

Dependencies

• To enable this parameter, set Image size to custom.

Video compression — Decoding format for video stream

H264 (default) | JPEG

Select decoding format for the real-time streaming protocol (RTSP) video stream.

Sample time — Time frequency at which block outputs image frame

0.1 (default) | scalar

Specify how often the block outputs an image frame from the video stream.

Programmatic Use: Add Block

To add the block programmatically, use the add_block function with one of these library block paths as the source.

"raspberrypiAVlib/RTSP Video Stream Receive"

Example: add_block("raspberrypiAVlib/RTSP Video Stream Receive","myModel/myBlock",MakeNameUnique="on")

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using Simulink® Coder™.

To generate C/C++ code for this block, you must have an Embedded Coder license. For more information on selecting the right product stack according to your development goals, see Product Stack for Raspberry Pi Blockset.

Version History

Introduced in R2024b