Table of Contents

Revision History

• Update all projects, IPs, and tools versions to 2019.1
• Various fixes and improvements

Overview

• Sources (blue):
  • Virtual video device (vivid) implemented purely in software
  • USB webcam connected to the PS (optional)
  • Test pattern generator (TPG) implemented in the PL
  • HDMI Rx capture pipeline implemented in the PL
  • MIPI CSI-2 Rx based image sensor pipeline implemented in PL + FMC
  • File source (raw video only)
• Sinks (green):
  • DP Tx display pipeline in the PS
  • HDMI Tx display pipeline implemented in the PL

• 2D-Convolution filter with programmable coefficients
• Dense optical flow algorithm

• How to setup the ZCU102 evaluation board and run the reference design.
• How to build all the TRD components based on the provided source files via detailed step-by-step tutorials.

• Zynq UltraScale+ MPSoC Base TRD user guide UG1221: contains information about system, software and hardware architecture.

Software Tools and System Requirements

Hardware

• ZCU102 evaluation board
  • rev 1.0 or rev D2 with production silicon
• Monitor with DisplayPort or HDMI input supporting one of the following resolutions:
  • 3840x2160 or
  • 1920x1080 or
  • 1280x720
• Display Port cable (DP certified) or HDMI cable
• Micro-USB cable, connected to laptop or desktop for the terminal emulator
• Xilinx USB3 micro-B adapter
  • adapter shipped with ZCU102 rev 1.0 + production silicon
  • adapter needs to be purchased separately for ZCU102 rev D2 with production silicon
• USB mouse
• SD card

• HDMI video source with output supporting one of the following resolutions:
  • 3840x2160 or
  • 1920x1080 or
  • 1280x720
• USB webcam
• USB 3.0 hub (supplied with ZCU102 kit)
• Leopard LI-IMX274MIPI-FMC (only supported on rev 1.0 boards)

Compatibility

• Cable Matters DisplayPort Cable-E342987
• Monster Advanced DisplayPort Cable-E194698

• Crucial BX200 2.5in SATA SSD 240GB
• San Disk UltraFit USB3.0 Flash Drive 16 GB

Software

• Linux host machine for all tool flow tutorials (see UG1144 for detailed OS requirements)
• SDSoC Development Environment version 2019.1 (see UG1238 for installation instructions)
• PetaLinux Tools version 2019.1 (see UG1144 for installation instructions)
• Git distributed version control system
• Silicon Labs quad CP210x USB-to-UART bridge driver
• Serial terminal emulator e.g. teraterm
• Reference Design Zip File for ZCU102 rev 1.0 or rev D2 / production silicon including all source code and project files.

Licensing

• Important: Certain material in this reference design is separately licensed by third parties and may be subject to the GNU General Public License version 2, the GNU Lesser General License version 2.1, or other licenses.
  The Third Party Library Sources zip file provides a copy of separately licensed material that is not included in the reference design.
• You will need only the SDSoC license to build the design which includes all the required IP licenses. You can evaluate for 60-days or purchase it here.

1. Log in here with your work E-mail address (If you do not yet have an account, follow the steps under Create Account)
2. Generate a license from “Create New Licenses” by checking "SDSoC Environment, 60 Day Evaluation License"
   
3. Under system information, give the host details.
4. Proceed until you get the license agreement and accept it.
5. The License (.lic file) will be sent to the email-id mentioned in the login details.
6. Copy the license file locally and give the same path in the SDSoC license manager.

Design Files

Design Modules

• DM1 – APU SMP Linux
• DM2 – RPU0 FreeRTOS Application
• DM3 – RPU1 Bare-metal Application
• DM4 – APU/RPU1 Inter Process Communication
• DM5 – APU Qt Application
• DM6 – PL Video Capture
• DM7 – OpenCV-based Image Processing
• DM8 – PL-accelerated Image Processing
• DM9 – Two Image Processing Functions
• DM10 – Full-fledged Base TRD

Design Components

rdf0421-zcu102-base-trd-2019-1/
├── IMPORTANT_NOTICE_CONCERNING_THIRD_PARTY_CONTENT.txt
├── petalinux
│   ├── sdk.sh
│   └── zcu102-prod-base-dm10.bsp
├── README.txt
├── sd_card
│   └── dm10
│       ├── BOOT.BIN
│       ├── image.ub
│       ├── libgstsdxfilter2d.so
│       ├── libgstsdxopticalflow.so
│       └── perfapm-server.elf
├── workspaces
│   ├── ws_heartbeat
│   │   ├── heartbeat
│   │   ├── heartbeat_bsp
│   │   └── hw_platform_0
│   ├── ws_perfapm-ctl
│   │   ├── hw_platform_0
│   │   ├── perfapm
│   │   ├── perfapm_bsp
│   │   └── perfapm-ctl
│   └── ws_perfapm-server
│       ├── hw_platform_0
│       ├── perfapm
│       ├── perfapm_bsp
│       └── perfapm-server
└── zcu102_base_trd
    ├── hw
    │   └── zcu102_base_trd.dsa
    ├── samples
    │   ├── gstsdxfilter2d
    │   └── gstsdxopticalflow
    ├── sw
    │   ├── a53_linux
    │   ├── prebuilt
    │   └── zcu102_base_trd.spfm
    └── zcu102_base_trd.xpfm

Tutorials

Board Setup

• Connect power supply to 12V power connector.
• Connect USB mouse via USB hub to the USB3 micro-AB connector.
• Display
  • Connect a DisplayPort cable to DisplayPort connector on the board; connect the other end to a monitor OR
  • Connect an HDMI cable to HDMI Tx connector (top) on the board; connect the other end to a monitor
  Note: Certain monitors have multiple HDMI ports supporting different HDMI standards. Make sure you choose an HDMI 2.0 capable port (if available) for 4k60 performance
  Note: Make sure you only connect either DP or HDMI Tx on the board, not both, otherwise the design might malfunction
• Connect micro-USB cable to the USB-UART connector; use the following settings for your terminal emulator:
  • Baud Rate: 115200
  • Data: 8 bit
  • Parity: None
  • Stop: 1 bit
  • Flow Control: None
• Insert SD card (FAT formatted) with binaries copied from $TRD_HOME/images/dm10 directory.

• Connect a USB webcam to the USB hub.
  Note: The USB webcam needs to output YUYV pixel format. Other formats are not supported in this design.
• Connect an HDMI cable to HDMI Rx connector (bottom) on the board; connect the other end to an HDMI source
• Connect the LI-IMX274MIPI-FMC module to the HPC0 FMC connector on the board
  Note: The design only supports this FMC on rev 1.0 boards. Vadj needs to be set to 1.2V for correct operation of the daughter card. If the FMC card does not seem functional, please follow the instructions explained in Answer Record AR67308 to check and/or set Vadj.

Jumpers & Switches:

• Set boot mode to SD card:
  • Rev 1.0: SW6[4:1] - off,off,off, on
  • Rev D2: SW6[4:1] - on, off on, off
• Configure USB jumpers for host mode
  • J110: 2-3
  • J109: 1-2
  • J112: 2-3
  • J7: 1-2
  • J113: 1-2