Zynq Base TRD 2013.2

Table of Contents

1 Introduction

1.1 About the Base TRD

1.2 Download the TRD

1.3 Base TRD Package Contents

2 Prerequisites

3 Building the FPGA Hardware Bitstream

3.1 Building the Bitstream

3.2 Steps for exporting the hardware platform to SDK

4 Building the First Stage Boot Loader (FSBL)

5 Installation of Petalinux SDK

5.1 Prerequisites

5.2 Extract the PetaLinux Package

5.3 Install License

5.4 Setup PetaLinux Working Environment

5.4 Verify Petalinux Installation

6 Zynq Base TRD BSP Installation Procedure

7 Upgrading petalinux kernel version to 3.9

8 Select Zynq Base TRD Platform

9 Import TRD user applications and libraries to Petalinux SDK.

9.1 Import user applications

9.2 Select user applications in Petalinux build

9.3 Import user libraries

9.4 Select user libraries in Petalinux build

10 Build Petalinux.

11 Generate BOOT image for Zynq

12 Running Video Demo Applications

12.1 Hardware Setup Requirements

12.2 Board Setup

12.3 Run Qt GUI Application in 1080p mode.

12.4 Run Qt GUI Application in 720p mode.

12.5 Run UART Menu Application in 1080p mode.

12.6 Run UART Menu Application in 720p mode

13 References

14 Appendix

14.1 Vivado HLS Flow for generating Sobel filter Vivado IP

14.2 EDID Extended display identification data .

14.3 Add Custom resolution to sobel application

14.4 Known Issues

History
ISE DS 14.5 Targeted Base Reference Design
ISE DS 14.4 Targeted Base Reference Design
ISE DS 14.3 Targeted Base Reference Design
ISE DS 14.2 Targeted Base Reference Design
ISE DS 14.1 Targeted Base Reference Design

1 Introduction

This page provides instructions on how to build various components of the Zynq Base Targeted Reference Design (TRD) and how to setup the hardware platform and run the design on the ZC702 Evaluation Kit. The ZC702 Evaluation kit is based on a XC7Z020 CLG484-1 Zynq-7000 SoC device. For additional information, refer to Zynq-7000 SoC: ZC702 Evaluation Kit and Video and Imaging Kit Getting Started Guide.

1.1 About the Base TRD

The Base TRD is an embedded video processing application designed to showcase various features and capabilities of the Zynq Z-7020 SoC device for the embedded domain. The Base TRD consists of two elements: The Zynq-7000 SoC Processing System (PS) and a video processing pipeline implemented in Programmable Logic (PL). The SoC allows the user to implement a video processing algorithm that performs edge detection on an image (Sobel filter) either as a software program running on the Zynq-7000 SoC based PS or as a hardware accelerator inside the SoC based PL. The Base TRD demonstrates how the user can seamlessly switch between a software or a hardware implementation and evaluate the cost and benefit of each implementation. The TRD also demonstrates the value of offloading computation-intensive tasks onto PL, thereby freeing the CPU resources to be available for user-specific applications. For additional information, please refer to UG925: Zynq-7000 SoC: ZC702 Base Targeted Reference Design User Guide.

1.2 Download the TRD

An archive with the TRD files can be downloaded here (requires to sign up).

1.3 Base TRD Package Contents

The Zynq Base TRD package is released with the source code, Xilinx Vivado and SDK projects, and an SD card image that enables the user to run the video demonstration and software application. It also includes the binaries necessary to configure and boot the Zynq-7000 SoC board. This wiki page assumes the user has already downloaded the Base TRD package and extracted its contents to the Base TRD home directory referred to as ZYNQ_TRD_HOME in this wiki.

Open

2 Prerequisites

• The ZC702 Evaluation Kit ships with the Xilinx Vivado™ Design Suite version 2013.2 Device-locked to the Zynq-7000 XC7Z020 CLG484-1 device and all required licenses to build the TRD. For additional information, refer to UG798 ISE Design Suite 14: Installation and Licensing Guide. A 30-day evaluation license can be generated after registering a Xilinx account.

• Xilinx IP evaluation licenses for the Video Timing Controller and Chroma Resampler IP cores can be ordered online.

• Xylon logiCVC-ML is shipped as evaluation IP core that does not require a license. License options are listed on the Xylon logiCVC-ML product site.

Note: The provided logiCVC evaluation IP core has a 1 hour timeout built-in such that the display freezes after the timer expires. The pre-built bitfile and boot images are built from a full logiCVC IP core and don't expire.

• A Linux development PC with the ARM GNU tools installed. The ARM GNU tools are included with the Xilinx ISE Design Suite Embedded Edition or can be downloaded separately.

• A Linux development PC with the distributed version control system Git installed. For more information, refer to the Xilinx Git wiki and to UG821: Xilinx Zynq-7000 SoC Software Developers Guide.

• A Linux development PC with Petalinux SDK installed . For more information , refer to Xilinx Petalinux user manuals .

• A Linux development PC with QT and QWT libraries cross-compiled for Zynq platform. Set ZYNQ_QT_INSTALL environment variable by referring to Xilinx Zynq Qt/Qwt Libraries - Build Instructions

3 Building the FPGA Hardware Bitstream

This section explains how to generate the FPGA hardware bitstream using the Xilinx Vivado tool and how to export the hardware platform to Xilinx Software Development Kit (SDK) for software application development.

3.1 Building the Bitstream

Steps for building the FPGA hardware bitstream

Launch Vivado :

• On Windows 7, select Start > All Programs > Xilinx Design Tools > Vivado 2013.2 > Vivado 2013.2.

• On Linux, enter vivado at the command prompt.

From the Vivado welcome screen, in TCL console, run following commands
1. cd $ZYNQ_TRD_HOME/hardware/vivado
2. source ./scripts/project.tcl

Open

The above step creates a project 'zynq_base_trd_2013.2'.

In the Flow Navigator pane on the left-hand side under Program and Debug, click Generate Bitstream. The bitstream will be generated at $ZYNQ_TRD_HOME/hardware/vivado/project/zynq_base_trd_2013.2.runs/impl_1/system_top_wrapper.bit

Open

Exporting the Hardware Platform to SDK
A pre-generated hardware platform project can be found at $ZYNQ_TRD_HOME/software/workspace/hw_platform/.

3.2 Steps for exporting the hardware platform to SDK

Open

From the Vivado menu bar, select File > Export > Export Hardware for SDK

In the Export Hardware window press OK. The SDK hardware platform will be exported to $ZYNQ_TRD_HOME/hardware/vivado/project/zynq_base_trd_2013.2.sdk/SDK/SDK_Export.

Open

Note: If the Launch SDK option is checked in the Export Hardware window, SDK will be launched immediately after SDK export has completed. This is not recommended at this point.

4 Building the First Stage Boot Loader (FSBL)

This section explains how to import and build the First Stage Boot Loader (FSBL) and the standalone OS based Board Support Package(BSP) from the provided SDK projects.

Note: The provided FSBL project is a customized version of the FSBL SDK project template. The following features have been added to the Base TRD version:

• I2C mux reset.

• FMC detection sequence.

• I2C initialization sequence for HDMI receiver (ADV7611) on Avnet IMAGEON FMC.

All the above customizations are added to FsblHookBeforeHandoff routine part of
$ZYNQ_TRD_HOME/software/workspace/zynq_fsbl/src/fsbl_hooks.c.

Steps for building the FSBL
Launch Xilinx SDK:

• On Windows 7, select Start > All Programs > Xilinx Design Tools > SDK 2013.2 > Xilinx SDK 2013.2.

• On Linux, enter xsdk at the command prompt.

In the Workspace Launcher window, click Browse and navigate to $ZYNQ_TRD_HOME/software/workspace, then click OK. Close the welcome screen.

Open

To import the hardware platform (hw_platform) , FSBL (zynq_fsbl) and FSBL BSP (zynq_fsbl_bsp) into the SDK workspace,
Select File > Import.

Open

Note: The zynq_fsbl project requires a hardware platform SDK project generated by SDK export. Instead of the provided hw_platform project, the one generated in Section 3.2 can be used.
This requires the user to update the project reference of the zynq_fsbl project.
In the Import wizard, expand the General folder, select Existing Projects into Workspace, and click Next.

Open

All projects are located at the top-level inside your SDK workspace. Click Browse and navigate to $ZYNQ_TRD_HOME/software/workspace. Press OK.

Open

Make sure the hw_platform, zynq_fsbl and zynq_fsbl_bsp projects are checked . Press Finish.

Open

The build process will start automatically and builds the BSP first and then the FSBL. The generated Zynq FSBL executable can be found at $ZYNQ_TRD_HOME/software/workspace/zynq_fsbl/Debug/zynq_fsbl.elf.
This option can be changed by unchecking Project > Build Automatically from the menu bar.

To manually build the project, right click zynq_fsbl in the Project Explorer and select Build Project; to clean the project, select Clean Project.

Open

5 Installation of Petalinux SDK

5.1 Prerequisites

• Minimum workstation requirements:

• 2GB RAM (recommended minimum for Xilinx tools)

• Pentium 4 2GHz CPU clock or equivalent

• 5 GB free HDD space

• Recommended OS: CentOS RHEL 5 (32-bit), or Ubuntu 10.04 (32-bit or 64-bit)

• You have obtained the PetaLinux release package.

• You have obtained a license for PetaLinux.

• A number of common system packages and libraries are required to be installed on your workstation and the installation process will check for these.See the section "Required Tools and Libraries" for more details.

Download Petalinux SDK software from Xilinx download , ISE design tools> Version 14.6 > Petalinux SDK- 14.6 Utilities > PetaLinux 13.04 Installation archive for Zynq and MicroBlaze

5.2 Extract the PetaLinux Package

Assuming all the prerequisites described in the last subsection are satisfied, PetaLinux installation is very straight forward. Extract the compressed PetaLinux package by running the following command on your workstation:

PetaLinux will be installed in the petalinux-v2013.04-final-full directory, directly underneath the working directory of this command.
So, if you extract the package from your home directory /home/user, PetaLinux will be installed in /home/user/petalinux-v2013.04-final-full.
You may move the resulting petalinux-v2013.04-final-full directory to a preferred location before continuing.

5.3 Install License

PetaLinux licenses are managed using the same system as all other Xilinx Design Tools. For more details on licensing and setup of license please refer to the
"Xilinx Design Tools: Installation and Licensing Guide (UG798)" section "Obtaining and Managing a License".

5.4 Setup PetaLinux Working Environment

After extracting the package, the remainder of the setup is completed automatically.
1. Go to the PetaLinux root directory by running this command on the command console:
cd <path-to-installed-PetaLinux>
e.g.:

2. Source the appropriate PetaLinux setup script by running this command on the command console:
For Bash:

The first time the setup script is sourced, it will perform some post installation tasks to check system dependencies and initialise the Linux kernel source tree.
Below is an example of the output from sourcing the setup script for the first time:

PetaLinux environment set to ’/home/user/petalinux-v2013.04-final-full’
INFO: Finalising PetaLinux installation
INFO: Checking free disk space
INFO: Checking installed tools
INFO: Checking installed development libraries
INFO: Checking network and other services
INFO: Checking for sudo permissions - you may be prompted to enter
your password
Password: *
INFO: Initialising kernel tree. Please be patient.
INFO: PetaLinux post-installation completed successfully

The post-install step only occurs once. Subsequent runs of the settings script should be much quicker, and simply output a confirmation message such as that shown below:
PetaLinux environment set to ’/home/user/petalinux-v2013.04-final-full’

5.4 Verify Petalinux Installation

Verify that the PetaLinux working environment has been set:

/home/user/petalinux-v2013.04-final-full
Environment variable "$PETALINUX" should point to the path to the installed PetaLinux. Your echo output may be different from this example, depending upon where you installed PetaLinux.

6 Zynq Base TRD BSP Installation Procedure

PetaLinux includes reference designs for you to start working with and customise for your own projects. These are provided in the form of installable BSP (Board Support Package) files, and include
all necessary design and configuration files, including pre-built and tested hardware and software images, ready for download to your board or for booting in the QEMU system simulation environment.

Run petalinux-install-bsp command on the command console:
petalinux-install-bsp <Path-to-TRD BSP>

Example:

INFO: Processing BSP package 'Xilinx-zc702-trd-v2013_2.bsp'
<snip>
INFO: Default BSP settings restored
INFO: BSP successfully installed

7 Upgrading petalinux kernel version to 3.9

Upgrade the existing petalinux linux repo. Since petalinux linux repo is maintained as a git repo we can easily fast-forward it to latest OSL kernel version i.e 3.9.
Steps for building the Linux kernel.

Create a new branch named zynq_base_trd_v2013.2 based on the xilinx-v14.6.02 tag.

Apply the Base TRD specific patch on top of the xilinx-v14.6.02. The patch includes:

• Mouse sensitivity patch (As default mouse sensitivity on embedded QT GUI is quite fast)

Configure the Linux kernel for the Zynq ZC702 Base TRD.

8 Select Zynq Base TRD Platform

Select Zynq Base TRD platform configuration and apply it to current petalinux build session.

Press "Enter" on "Vendor/Product Selection" menu.
Select the Vendor you wish to target : Vendor(Xilinx)
Select the Product you wish to target: Xilinx Products (zc702)

Open

Exit the menuconfig and select "<Yes>" to question "Do you wish to save your new kernel configuration?"save changes and exit the configuration.

9 Import TRD user applications and libraries to Petalinux SDK.

9.1 Import user applications

It can be added to Petalinux SDK by copying application sources to petalinux user-apps directory.

9.2 Select user applications in Petalinux build

Select user applications to be included in the PetaLinux build process. This is not enabled by default.

Run ’make appconfig’ in your "$PETALINUX/software/petalinux-dist" directory

"PetaLinux Configuration" menu will show up:

Press the down arrow key to scroll down the menu to "User Applications". Press "Enter" to go into the "User Applications" sub-menu:
You will see your mentioned TRD applications listed in the menu. "init_scripts",”sobel_cmd_wrapper”,”sobel_qt_wrapper”.

Open

Select applications and press exit twice to come out of petalinux configuration menu.
Select "<Yes>" to question "Do you wish to save your new kernel configuration?"save changes.

9.3 Import user libraries

User libraries can be added to Petalinux SDK by copying sources to petalinux user-libs directory.

9.4 Select user libraries in Petalinux build

Select user libararies to be included in the PetaLinux build process. It is not enabled by default.
Run ’make appconfig’ in your "$PETALINUX/software/petalinux-dist" directory

"PetaLinux Configuration" menu will show up:

Press the down arrow key to scroll down the menu to "User libraries". Press "Enter" to go into the "User libraries" sub-menu:
You will see your mentioned user libraries listed in the menu."qt_lib”, “sobel_lib_wrapper”.

Open

Select libraries and press exit twice to come out of petalinux configuration menu.
Select "<Yes>" to question "Do you wish to save your new kernel configuration?"save changes.

10 Build Petalinux.

Finally, it’s time to build your petalinux image.

Run ’make’ in the petalinux-dist directory to build the PetaLinux system image:

Note: For more verbose build message use make PV=3.

The console shows the compilation progress. e.g.:
[INFO ] Building ucfront tool
[INFO ] Building kernel
[00:00]
And the compilation log stores in build.log file in the petalinux-dist/ directory.

11 Generate BOOT image for Zynq

Follow the steps below to generate the boot image (BOOT.bin) .

petalinux-gen-zynq-boot -b <Path to FSBL image> -f <Path to FPGA bitstream> -u <Path to uboot image> -o <output file>

The parameters are as follows:
-b <FSBL image> - Path to FSBL image location
-f <FPGA image> - Path to FPGA bitstream location
-u <uboot image> - Path to uboot image (default is images/u-boot.elf)
-o <output file> - Output image name (default is images/BOOT.BIN)

petalinux-gen-zynq-boot command requires bootgen binary in its path.Petalinux SDK version also checks whether XILINX_EDK environment var is set.
So to fake the check we need to set XILINX_EDK.

Move to petalinux images directory.

Note: BOOT.bin and BOOT.BIN are synonymous and can be used interchangeably.‎

SD BOOT mode Petalinux Deployment Binaries:
a) BOOT.bin
b) image.ub

12 Running Video Demo Applications

This section explains through step by step instructions how to bring up the ZC702 board for video demonstration part of the TRD and running different video demonstrations out of the box.
The ZC702 Evaluation Kit comes with an SD-MMC card pre-loaded with binaries that enable the user to run the video demonstration and software applications. It also includes the binaries necessary to
configure and boot the Zynq-7000 SoC based ZC-702 board.

Note:
a) If the evaluation kit design files were downloaded online, copy the entire folder ZYNQ_TRD_HOME/ready_to_test from the package onto the primary partition of the SD-MMC card
which is formatted as FAT32 using a SD-MMC card reader.
b) Petalinux console login details:-
User : root
Password : root

12.1 Hardware Setup Requirements

The ZC702 board setup to run & test the video demonstration applications require the following items:

Requirements for TRD Linux application demo setup

• The ZC702 evaluation board with the XC7Z020 CLG484-1 part

• AC power adapter (12 VDC)

• An USB Type-A to USB Mini-B cable (for UART communications) and a Tera Term Pro (or similar) UART terminal program.

• USB-UART drivers from Silicon Labs

• A HDMI cable.

• Optional: FMC (FPGA Mezzanine Card).

• Optional: External Video Source e.g. Roku HD Streaming player.