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.

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 directory

  • Power 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:~#
  • 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

Preset

Encoder Type

Bitrate

AVC Low

H264

10Mbps

AVC Medium

H264

30Mbps

AVC High

H264

60Mbps

HEVC Low

H265

10Mbps