Zynq UltraScale＋ MPSoC VCU TRD 2019.2 - VCU TRD: Multi Stream

...

1 Overview

The primary goal of this Design is to demonstrate the capabilities of VCU hard block present in Zynq UltraScale+ EV devices. The TRD will serve as a platform to tune the performance parameters of VCU and arrive at optimal configurations for encoder and decoder blocks.

This design supports the following video interfaces:

Sources:

Test pattern generator (TPG) implemented in the PL.
HDMI-Rx capture pipeline implemented in the PL.
MIPI CSI-2 Rx capture pipeline implemented in the PL.
File source (SD card, USB storage, SATA hard disk).
Stream-In from network or internet.

Sinks:

DP Tx display pipeline in the PS.
HDMI-Tx display pipeline implemented in the PL.

VCU Codec:

Video Encode/Decode capability using VCU hard block in PL
- AVC/HEVC encoding
- Encoder/decoder parameter configuration.
- Demonstrate the multi-stream capability of VCU at 4k 60 Hz throughput

Streaming Interfaces:

1G Ethernet PS GEM

Video format:

NV12

The below figure shows the TRD block diagram.

Demonstrate the multi-stream capability of VCU at 4k 60 Hz throughput.
- Supports 2-4KP30 multi-stream feature with any 2 of HDMI-Rx, TPG, and MIPI as the input source and HDMI-Tx as display pipeline.
- Supports 4-1080p60 multi-stream feature with 3 HDMI-Rx and 1 MIPI as the input source and HDMI-Tx as display pipeline.
- Supports 8-1080p30 multi-stream feature with 7 HDMI-Rx and 1 MIPI as the input source and HDMI-Tx as display pipeline.

Other features:

This design supports 8 channel memory-based SCD(Scene Change Detection) IP. SCD can be enabled or disabled through configuration

Supported Resolution:

The table below provides the supported resolution from GUI and command-line app in this design.

Resolution	GUI	Command Line
Resolution	Single Stream	Single Stream	Multi-stream
4kp60	X	√	NA
4kp30	√	√	√ (Max 2)
1080p60	√	√	√ (Max 4)
1080p30	X	√	√ (Max 8)

√ - Supported
NA – Not applicable
x – Not supported

The below table gives information about the features supported in this design.

Pipeline	Input source	Output Type	Resolution	VCU codec
Capture--> Display(Passthrough pipeline)	HDMI-Rx/MIPI/TPG	HDMI-Tx/DP	4KP/1080p	None
Single Stream: Capture--> SCD --> Encode--> Decode--> Display	HDMI-Rx/MIPI/TPG	HDMI-Tx/DP	4KP/1080p	HEVC/AVC
Multi-Stream (2 input sources): Capture--> SCD --> Encode--> Decode--> Display	HDMI-Rx/MIPI/TPG	HDMI-Tx	4KP30	HEVC/AVC
Multi-Stream(4 input sources): Capture--> SCD --> Encode--> Decode--> Display	HDMI-Rx/MIPI/TPG	HDMI-Tx	1080P60	HEVC/AVC
Multi-Stream(8 input sources): Capture--> SCD --> Encode--> Decode--> Display	7-HDMI-Rx + 1 MIPI	HDMI-Tx	1080P30	HEVC/AVC
Single Stream: Record/Stream-Out pipeline	HDMI-Rx/MIPI/TPG	File Sink/ Stream-Out	4K/1080p	HEVC/AVC
Multi-Stream(2 or 4 i/p sources): Record/Stream-Out pipeline	HDMI-Rx/MIPI/TPG	File Sink/ Stream-Out	2-4KP30/4-1080p60	HEVC/AVC
Multi-Stream(8 input sources): Record/Stream-Out pipeline	7-HDMI-Rx + 1 MIPI	File Sink/ Stream-Out	8-1080P30	HEVC/AVC
File/Streaming Playback pipeline	File Source/ Stream-In	HDMI-Tx/DP	4K/1080p	HEVC/AVC

NOTE: DP will support a max resolution of 4kp30

TPG will not support 1080p30 resolution mode.

The below figure shows the VCU TRD design hardware block diagram.

VCU TRD Design hardware block diagram

The below figure shows the VCU TRD design software block diagram.

VCU TRD Design software block diagram

1.1 Board Setup

Refer below link for Board Setup

Zynq UltraScale+ MPSoC VCU TRD 2019.2 Board Setup

...

Code Block

theme	Midnight

root@zcu106_vcu_trd:/media/card# xmedia-ctl -p -d /dev/mediaX
Media controller API version 4.19.0

Media device information
------------------------
driver          xilinx-video
model           Xilinx Video Composite Device
serial          
bus info        
hw revision     0x0
driver version  4.19.0

Device topology
- entity 1: vcap_hdmi output 0 (1 pad, 1 link)
            type Node subtype V4L flags 0
            device node name /dev/video0 -----> Video node for HDMI Rx source
        pad0: Sink
                <- "a0080000.v_proc_ss":1 [ENABLED]

- entity 5: a0080000.v_proc_ss (2 pads, 2 links)
            type V4L2 subdev subtype Unknown flags 0
            device node name /dev/v4l-subdev21
        pad0: Sink
                [fmt:RBG888_1X24/3840x2160 field:none]
                <- "a0000000.v_hdmi_rx_ss":0 [ENABLED]
        pad1: Source
                [fmt:VYYUYY8_1X24/3840x2160 field:none]
                -> "vcap_hdmi output 0":0 [ENABLED]

- entity 8: a0000000.v_hdmi_rx_ss (1 pad, 1 link)
            type V4L2 subdev subtype Unknown flags 0
            device node name /dev/v4l-subdev22
        pad0: Source
                [fmt:RBG888_1X24/3840x2160 field:none colorspace:srgb]
                [dv.caps:BT.656/1120 min:0x0@25000000 max:4096x2160@297000000 stds:CEA-861,DMT,CVT,GTF caps:progressive,reduced-blanking,custom]
                [dv.query:no-link] -----> HDMI Rx Link Status
                -> "a0080000.v_proc_ss":0 [ENABLED]

NOTE: Here "dv.query:no-link" under "v_hdmi_rx_ss" node shows HDMI-Rx source is not connected or HDMI-Rx source is not active(Try waking up the device by pressing a key on remote).

Follow the below steps to switch the HDMI-Rx resolution from 1080p60 to 4kp60.

Check current HDMI Input Source Resolution (1080p60) by following the above-mentioned steps.

Run vcu_gst_app for current HDMI resolution (1080p60) by executing the following command

Notes for gst-launch-1.0 commands:

Video node for HDMI Rx source can be checked using xmedia-ctl command. Run below xmedia-ctl command to check video node for HDMI Rx source where "mediaX" indicates media node for HDMI input source.

Code Block

theme	Midnight

...

xmedia-ctl -p -d /dev/mediaX

Make sure HDMI-Rx media pipeline is configured for 4kp60 resolution and source/sink have the same colour format. Run below xmedia-ctl commands to set resolution and format of HDMI scaler node where "mediaX" indicates media node for HDMI input source.

When HDMI Input Source is NVIDIA SHIELD

Code Block

theme	Midnight

...

xmedia-ctl -d /dev/mediaX -V "\"a0080000.v_proc_ss\":0

...

Set the HDMI source resolution to 4kp60 (Homepage → settings → display & Sound → Resolution → change to 4kp60).
Save the configuration to take place the change.

...

 [fmt:RBG888_1X24/3840x2160 field:none]"
$ xmedia-ctl -d /dev/mediaX -V "\"a0080000.v_proc_ss\":1  [fmt:VYYUYY8_1X24/3840x2160 field:none]"

NOTE: Make sure NVIDIA SHIELD is configured for 4kp resolution and RGB888 colour format.

When HDMI Input Source is ABOX

Code Block

theme	Midnight

$ xmedia-ctl -d /dev/mediaX -V "\"a0080000.v_proc_ss\":0  [fmt:VYYUYY8_1X24/3840x2160 field:none]"
$ xmedia-ctl -d /dev/mediaX -V "\"a0080000.v_proc_ss\":1  [fmt:VYYUYY8_1X24/3840x2160 field:none]"

NOTE: Make sure ABOX is configured for 4kp resolution and VYYUYY8 colour format.

Notes to set the format of SCD media node:

Run the following command to check the current resolution of SCD nodes(here mediaX is SCD media node),

Code Block

theme	Midnight

$ xmedia-ctl -p -d /dev/mediaX

Make sure SCD media node resolution is set as per current pipeline resolution

Run the following command to change the resolution of SCD nodes(here mediaX is SCD media node and xlnx-scdchan.Y is SCD channel),

For 4kp resolution

Code Block

theme	Midnight

$ xmedia-ctl -d /dev/mediaX -V "\"xlnx-scdchan.Y\":0 [fmt:VYYUYY8_1X24/3840x2160 field:none]"

For 1080p resolution

Code Block

theme	Midnight

$ xmedia-ctl -d /dev/mediaX -V "\"xlnx-scdchan.Y\":0 [fmt:VYYUYY8_1X24/1920x1080 field:none]"

Follow the below steps to switch the HDMI-Rx resolution from 1080p60 to 4kp60.
- Check current HDMI Input Source Resolution (1080p60) by following the above-mentioned steps.
If HDMI Tx link-up issue is observed after Linux booting, use
- Run vcu_gst_app for current HDMI resolution (1080p60) by executing the following command
:
- .

Code Block

theme	Midnight

$ modetest -D a0070000.v_mix -s 41:3840x2160-60@BG24

Run the following gst-launch-1.0 command to display passthrough pipeline. Where "videoX" indicates a video node for the input source

vcu_gst_app /media/card/config/input.cfg

Below configurations needs to be set in input.cfg for HDMI-1080p60.

Code Block

theme	Midnight

$ gst-launch-1.0 v4l2src device=/dev/videoX io-mode=4 ! video/x-raw, width=3840, height=2160, format=NV12, framerate=60/1 ! queue ! kmssink bus-id="a0070000.v_mix"

Run the following gst-launch-1.0 command to display processed pipeline (capture → scd → encode → decode → display) on HDMI-Tx. Where "videoX" indicates a video node for the input source.

Code Block

theme	Midnight

$ gst-launch-1.0 v4l2src device=/dev/videoX io-mode=4 ! video/x-raw, width=3840, height=2160, format=NV12, framerate=60/1 ! xilinxscd io-mode=5 ! omxh265enc qp-mode=auto gop-mode=basic gop-length=60 b-frames=0 target-bitrate=60000 num-slices=8 control-rate=constant prefetch-buffer=true low-bandwidth=false filler-data=true cpb-size=1000 initial-delay=500 ! video/x-h265, profile=main, alignment=au ! queue ! omxh265dec internal-entropy-buffers=5 low-latency=0 ! queue max-size-bytes=0 ! kmssink bus-id="a0070000.v_mix"

Run the following gst-launch-1.0 command to record video using GStreamer pipeline. Where "videoX" indicates a video node for the input source.

Code Block

theme	Midnight

$ gst-launch-1.0 v4l2src device=/dev/videoX io-mode=4 num-buffers=3600 ! video/x-raw, format=NV12,width=3840,height=2160,framerate=60/1 ! xilinxscd io-mode=5 ! omxh265enc qp-mode=auto gop-mode=basic gop-length=60 b-frames=0 target-bitrate=60000 num-slices=8 control-rate=constant prefetch-buffer=true low-bandwidth=false filler-data=true cpb-size=1000 initial-delay=500 ! queue ! video/x-h265, profile=main, alignment=au ! mpegtsmux alignment=7 name=mux ! filesink location="/run/media/sda/test.ts"

NOTE: File location should be SATA SSD(ext4 format) to avoid the read-write bandwidth issue.

Run the following gst-launch-1.0 command to play the recorded file on HDMI-Tx using the GStreamer pipeline.

Code Block

theme	Midnight

$ gst-launch-1.0 uridecodebin uri="file:///run/media/sda/test.ts" ! queue max-size-bytes=0 ! kmssink bus-id="a0070000.v_mix"

NOTE: File location should be SATA SSD(ext4 format) to avoid the read-write bandwidth issue.

Run the following gst-launch-1.0 command for cbr stream-out pipeline. Where "videoX" indicates a video node for the input source.

Code Block

theme	Midnight

$ gst-launch-1.0 v4l2src device=/dev/videoX io-mode=4 ! video/x-raw, format=NV12, width=3840, height=2160, framerate=60/1 ! xilinxscd io-mode=5 ! omxh265enc qp-mode=auto gop-mode=basic gop-length=60 b-frames=0 target-bitrate=60000 num-slices=8 control-rate=constant prefetch-buffer=true low-bandwidth=false filler-data=true cpb-size=1000 initial-delay=500 periodicity-idr=60 ! video/x-h265, profile=main, alignment=au ! queue ! mpegtsmux alignment=7 name=mux ! rtpmp2tpay ! udpsink host=192.168.25.89 port=5004

NOTE: Here 192.168.25.89 is host/client IP address and 5004 is port no.

Run the following gst-launch-1.0 command to display cbr stream-in on HDMI-Tx video using Gstreamer pipeline where 5004 is port no.

...

Common Configuration    : START
Num Of Input            : 1
Output                  : HDMI
Out Type                : Display
Frame Rate              : 60
Exit

Input Configuration     : START
Input Num               : 1
Input Type              : hdmi
Raw                     : TRUE
Width                   : 1920
Height                  : 1080
Exit

- Change Resolution of HDMI Input Source from 1080p60 to 4kp60 by following below steps.
  - Set the HDMI source resolution to 4kp60 (Homepage → settings → display & Sound → Resolution → change to 4kp60).
  - Save the configuration to take place the change.
- Verify the desired HDMI Input Source Resolution (4kp60) by following the above-mentioned steps.

If HDMI Tx link-up issue is observed after Linux booting, use the following command:

Code Block

theme	Midnight

$ modetest -D a0070000.v_mix -s 41:3840x2160-60@BG24

Run the following gst-launch-1.0 command to display passthrough pipeline. Where "videoX" indicates a video node for the input source.

Code Block

theme	Midnight

$ gst-launch-1.0

...

v4l2src

...

device=/dev/videoX io-mode=4 ! video/x-

...

raw,

...

width=3840, height=2160, format=NV12, framerate=60/1 ! queue ! kmssink bus-id="a0070000.v_mix"

Run the following gst-launch-1.0 command

...

to display processed pipeline (capture → scd → encode → decode → display) on HDMI-Tx. Where "videoX" indicates a video node for the input source.

Code Block

theme	Midnight

$ gst-launch-1.0 v4l2src

...

device=/dev/videoX io-mode=4 ! video/x-raw, width=3840, height=2160, format=NV12, framerate=60/1 ! xilinxscd io-mode=5 ! omxh265enc qp-mode=auto gop-mode=

...

basic gop-length

...

=60 b-frames=0 target-bitrate=

...

60000 num-slices=8 control-rate=

...

constant prefetch-buffer=

...

true low-bandwidth=false filler-data=

...

true cpb-size=1000 initial-delay=500 ! video/x-h265, profile=main, alignment=

...

au ! queue

...

! omxh265dec internal-entropy-buffers=5 low-latency=0 !

...

 queue max-size-bytes=0 !

...

kmssink bus-id="a0070000.v_mix"

Run the following gst-launch-1.0 command to

...

record video using

...

GStreamer pipeline

...

. Where "videoX" indicates a video node for the input source.

Code Block

theme	Midnight

$ gst-launch-1.0 udpsrcv4l2src port=5004 buffer-size=60000000 caps="application/x-rtp, media=video, clock-rate=90000, payload=96, encoding-name=H265" ! rtpjitterbuffer latencydevice=/dev/videoX io-mode=4 num-buffers=3600 ! video/x-raw, format=NV12,width=3840,height=2160,framerate=60/1 ! xilinxscd io-mode=5 ! rtph265depay ! h265parse ! video/x-h265, alignment=nal ! omxh265dec low-latency=1 ! video/x-raw ! queue max-size-bytes=0 ! fpsdisplaysink name=fpssink text-overlay=false video-sink="kmssink bus-id=a0070000.v_mix plane-id=30" sync=true

NOTE: The low latency stream-out pipeline is supported with tsmux in vcu_gst_app and low latency stream-in pipeline is not supported in vcu_gst_app.

Notes for gst-launch-1.0 commands:

Video node for HDMI Rx source can be checked using xmedia-ctl command. Run below xmedia-ctl command to check video node for HDMI Rx source where "mediaX" indicates media node for HDMI input source.

Code Block

theme	Midnight

$ xmedia-ctl -p -d /dev/mediaX

Make sure HDMI-Rx media pipeline is configured for 4kp60 resolution and source/sink have the same colour format. Run below xmedia-ctl commands to set resolution and format of HDMI scaler node where "mediaX" indicates media node for HDMI input source.

...

omxh265enc qp-mode=auto gop-mode=basic gop-length=60 b-frames=0 target-bitrate=60000 num-slices=8 control-rate=constant prefetch-buffer=true low-bandwidth=false filler-data=true cpb-size=1000 initial-delay=500 ! queue ! video/x-h265, profile=main, alignment=au ! mpegtsmux alignment=7 name=mux ! filesink location="/run/media/sda/test.ts"

NOTE: File location should be SATA SSD(ext4 format) to avoid the read-write bandwidth issue.

Run the following gst-launch-1.0 command to play the recorded file on HDMI-Tx using the GStreamer pipeline.

Code Block

theme	Midnight

$ gst-launch-1.0 uridecodebin uri="file:///run/media/sda/test.ts" ! queue max-size-bytes=0 ! kmssink bus-id="a0070000.v_mix"

NOTE: File location should be SATA SSD(ext4 format) to avoid the read-write bandwidth issue.

Run the following gst-launch-1.0 command for cbr stream-out pipeline. Where "videoX" indicates a video node for the input source.

Code Block

theme	Midnight

$ gst-launch-1.0 v4l2src device=/dev/videoX io-mode=4 ! video/x-raw, format=NV12, width=3840, height=2160, framerate=60/1 ! xilinxscd io-mode=5 ! omxh265enc qp-mode=auto gop-mode=basic gop-length=60 b-frames=0 target-bitrate=60000 num-slices=8 control-rate=constant prefetch-buffer=true low-bandwidth=false filler-data=true cpb-size=1000 initial-delay=500 periodicity-idr=60 ! video/x-h265, profile=main, alignment=au ! queue ! mpegtsmux alignment=7 name=mux ! rtpmp2tpay ! udpsink host=192.168.25.89 port=5004

NOTE: Here 192.168.25.89 is host/client IP address and 5004 is port no.

Run the following gst-launch-1.0 command to display cbr stream-in on HDMI-Tx video using Gstreamer pipeline where 5004 is port no.

Code Block

theme	Midnight

$ gst-launch-1.0 udpsrc port=5004 buffer-size=60000000 caps="application/x-rtp, clock-rate=90000" ! rtpjitterbuffer latency=1000 ! rtpmp2tdepay ! tsparse ! video/mpegts ! tsdemux name=demux ! queue ! h265parse ! video/x-h265, profile=main, alignment=au ! omxh265dec internal-entropy-buffers=5 low-latency=0 ! queue max-size-bytes=0 ! kmssink bus-id="a0070000.v_mix"

Run the following gst-launch-1.0 command for low-latency(LLP1) stream-out pipeline. Where "videoX" indicates a video node for the input source.

Code Block

theme	Midnight

$ xmedia-ctl -d gst-launch-1.0 v4l2src io-mode=4 device=/dev/mediaX -V "\"a0080000.v_proc_ss\":0  [fmt:RBG888_1X24/3840x2160 field:none]"
$ xmedia-ctl -d /dev/mediaX -V "\"a0080000.v_proc_ss\":1  [fmt:VYYUYY8_1X24/3840x2160 field:none]"

NOTE: Make sure NVIDIA SHIELD is configured for 4kp resolution and RGB888 colour format.

When HDMI Input Source is ABOX

Code Block

theme	Midnight

$ xmedia-ctl -d /dev/mediaX -V "\"a0080000.v_proc_ss\":0  [fmt:VYYUYY8_1X24/3840x2160 field:none]"
$ xmedia-ctl -d /dev/mediaX -V "\"a0080000.v_proc_ss\":1  [fmt:VYYUYY8_1X24/3840x2160 field:none]"

NOTE: Make sure ABOX is configured for 4kp resolution and VYYUYY8 colour format.

Notes to set the format of SCD media node:

Run the following command to check the current resolution of SCD nodes(here mediaX is SCD media node),

Code Block

theme	Midnight

$ xmedia-ctl -p -d /dev/mediaX

Make sure SCD media node resolution is set as per current pipeline resolution

Run the following command to change the resolution of SCD nodes(here mediaX is SCD media node and xlnx-scdchan.Y is SCD channel),

For 4kp resolution

Code Block

theme	Midnight

$ xmedia-ctl -d /dev/mediaX -V "\"xlnx-scdchan.Y\":0 [fmt:VYYUYY8_1X24/3840x2160 field:none]"

For 1080p resolution

Code Block

theme	Midnight

$ xmedia-ctl -d /dev/mediaX -V "\"xlnx-scdchan.Y\":0 [fmt:VYYUYY8_1X24/1920x1080 field:none]"videoX ! video/x-raw, width=3840, height=2160, format=NV12, framerate=60/1 ! omxh265enc qp-mode=auto gop-mode=low-delay-p gop-length=60 periodicity-idr=60 b-frames=0 target-bitrate=25000 num-slices=8 control-rate=low-latency prefetch-buffer=TRUE low-bandwidth=false filler-data=0 cpb-size=1000 initial-delay=500 ! video/x-h265, alignment=nal ! queue max-size-buffers=0 ! rtph265pay ! udpsink host=192.168.25.89 port=5004 buffer-size=60000000 max-bitrate=120000000 max-lateness=-1 qos-dscp=60 async=false

NOTE: Here 192.168.25.89 is host/client IP address and 5004 is port no.

Run the following gst-launch-1.0 command to display low-latency(LLP1) stream-in on HDMI-Tx video using Gstreamer pipeline where 5004 is port no.

Code Block

theme	Midnight

$ gst-launch-1.0 udpsrc port=5004 buffer-size=60000000 caps="application/x-rtp, media=video, clock-rate=90000, payload=96, encoding-name=H265" ! rtpjitterbuffer latency=5 ! rtph265depay ! h265parse ! video/x-h265, alignment=nal ! omxh265dec low-latency=1 ! video/x-raw ! queue max-size-bytes=0 ! fpsdisplaysink name=fpssink text-overlay=false video-sink="kmssink bus-id=a0070000.v_mix plane-id=30" sync=true

NOTE: The low latency stream-out pipeline is supported with tsmux in vcu_gst_app and low latency stream-in pipeline is not supported in vcu_gst_app.

Versions Compared

Old Version 13

New Version Current

Key

Zynq UltraScale＋ MPSoC VCU TRD 2019.2 - VCU TRD: Multi Stream

Table of Contents

1 Overview

1.1 Board Setup

Page Comparison

Versions Compared

Old Version 13

New Version Current

Key

Table of Contents

1 Overview

1.1 Board Setup