Zynq UltraScale+ MPSoC VCU TRD 2021.2 - Run and Build Flow
This page describes the detailed run and build flow for all the TRD components.
Table of Contents
1 Overview
For the overview, software tools, system requirements, design files, and board setup follow the link below:
2 Run Flow
This section will describe the flow to run the pre-built images which each design module contains.
Set up the board as explained in “Board Setup” Section in link Zynq UltraScale+ MPSoC VCU TRD 2021.2 Board Setup
Prepare the SD card. There are many options to format the SD Card in the windows tool. But, always format with FAT32 option. Use the SD Card Formatter tool to format the SD card, https://www.sdcard.org/downloads/formatter_4/
Please note that the Windows format option can't be used.
Copy all the files from the
$TRD_HOME/images/<Path to Design Images>/
to FAT32 formatted SD card directoryPower on the board; make sure INIT_B, DONE and all power rail LEDs are lit green
After a successful boot, a shell prompt would appear as shown below.
root@zcu106_vcu_trd_multistream_video:~#
Now proceed with either GUI based application(Section 2.1) or command-line based GStreamer application(Section 2.2)
The SD card file system is mounted at
/media/card
. Optional storage medium SATA and USB are mounted at/media/sata
and/media/usb
respectively.
2.1 Graphic User Interface
A QT based graphical user interface (GUI) provides control and monitoring interface. GUI will run on DP only.
Qt GUI will work on VCU TRD Multi-stream design and VCU Multi-stream Audio design.
Make sure the monitor is in DP mode before running the QT GUI app.
Run the below command to launch GUI on Display port when connected.
$ cd /opt/vcu_qt/bin
$ ./run_vcu.sh |
The GUI is not supported in HDMI-Tx. In HDMI 4kp60 mode, GUI requires an additional ~2GB memory bandwidth. By Invoking the GUI on HDMI-Tx will cause memory bandwidth issue. So, for HDMI-Tx, use only command line application (vcu_gst_app). The table below provides the supported display interfaces for both GUI and command-line applications.
Display Interface | GUI | Command Line Application |
Display Port | √ | √ |
HDMI | Not supported | √ |
The figure below shows the home screen of the GUI when only DP is connected.
GUI only supports single-stream playback. Supported resolutions are 1080p and 4kp. The supported frame rate for 1080p is 60 fps and 30fps for 4K. For all multi-stream use cases and 4kp60 single stream, the user has to run command-line applications.
For 4K use cases, use 4Kp30 supported Display/TV with DP Port; and for 1080p use cases, use 1080p60 supported Display/TV with DP Port
Qt GUI has the following options for the user to select:
Number of Input
This determines the number of active video sources. Only one input source is supported.
Output
This option allows the user to select a sink for the pipeline. Supported output sink types are display port, record, and stream. For the Display Port, the available Codec options are either enc-dec or Pass-through. For Record and Stream Out, the available Codec option is Enc.
Demo Mode
By clicking this button, the button text state changes to stop and the user can play all pipelines(TPG, MIPI, HDMI) with raw and presets configurations.
For every 10 seconds, playback preset changes and it plays in a loop till the user clicks on the stop button.
If no source connected it displays an error popup.
If any error returns in any playback, it skips and continues to play other pipelines.
With Multi Stream Audio Video Capture and Display design, To enable audio in a demo mode follow below steps and Click on Demo Mode
Input Settings
Input1: HDMI
Settings → Audio Settings → Enable Audio → True
Input Settings
The below figure shows the input settings window with configuration options.
Different configuration options available in the QT pop up window are:
Input Source (Input 1)
The following video sources (4K) are available as part of input video selection:
HDMI-Rx: To select the HDMI-Rx source as input.
File: To select a file source as input.
Test Pattern Generator (TPG): To select TPG source as input.
MIPI: To select MIPI Camera source as input.
Stream-In: To select a streaming pipeline.
Codec
The following options are available as part of Codec functionality
Enc-Dec: This option is to select encode and decode in the pipeline.
Enc: This option is to select encode only in the pipeline for record or stream out a use case.
Pass-through: This option is to display raw video.
Preset
There are six predefined presets. If the user edits any control options preset mode switches to “Custom”.
Preset | Encoder Type | Bitrate |
---|---|---|
AVC Low | H264 | 10Mbps |
AVC Medium | H264 | 30Mbps |
AVC High | H264 | 60Mbps |
HEVC Low | H265 | 10Mbps |