N.A.T. NAMC-ZYNQ-FMC Manuel utilisateur

NAMC-ZYNQ-FMC –Board Support Package Manual

NAMC-ZYNQ-FMC

FMC AMC Module

Board Support Package Manual V1.1

NAMC-ZYNQ-FMC –Board Support Package Manual

Version 1.0 © N.A.T. GmbH II

N.A.T GmbH

Konrad-Zuse-Platz 9

53227 Bonn-Oberkassel

Phone: +49 / 228 / 96 58 64 –0

Fax: +49 / 228 / 96 58 64 –10

Internet: http://www.nateurope.com

NAMC-ZYNQ-FMC –Board Support Package Manual

Version 1.0 © N.A.T. GmbH III

Disclaimer

The following documentation, compiled by N.A.T GmbH (henceforth called N.A.T), repre-

sents the current status of the product´s development. The documentation is updated on

a regular basis. Any changes which might ensue, including those necessitated by updated

specifications, are considered in the latest version of this documentation. N.A.T is under

no obligation to notify any person, organization, or institution of such changes or to make

these changes public in any other way.

We must caution you, that this publication could include technical inaccuracies or

typographical errors.

N.A.T offers no warranty, either expressed or implied, for the contents of this

documentation or for the product described therein, including but not limited to the

warranties of merchantability or the fitness of the product for any specific purpose.

In no event will N.A.T be liable for any loss of data or for errors in data utilization or

processing resulting from the use of this product or the documentation. In particular,

N.A.T will not be responsible for any direct or indirect damages (including lost profits, lost

savings, delays or interruptions in the flow of business activities, including but not limited

to, special, incidental, consequential, or other similar damages) arising out of the use of

or inability to use this product or the associated documentation, even if N.A.T or any

authorized N.A.T representative has been advised of the possibility of such damages.

The use of registered names, trademarks, etc. in this publication does not imply, even in

the absence of a specific statement, that such names are exempt from the relevant

protective laws and regulations (patent laws, trade mark laws, etc.) and therefore free

for general use. In no case does N.A.T guarantee that the information given in this

documentation is free of such third-party rights.

Neither this documentation nor any part thereof may be copied, translated, or reduced to

any electronic medium or machine form without the prior written consent from N.A.T

GmbH.

This product (and the associated documentation) is governed by the N.A.T General

Conditions and Terms of Delivery and Payment.

NAMC-ZYNQ-FMC –Board Support Package Manual

Version 1.0 © N.A.T. GmbH IV

Table of Contents

LIST OF TABLES .................................................................................................. V

LIST OF FIGURES.............................................................................................. VI

CONVENTIONS.................................................................................................. VI

BOARD SUPPORT PACKAGE DESCRIPTION ................................................... 71

1.1 INTRODUCTION ........................................................................................... 7

1.2 PREREQUISITE FOR USING THE BSP ................................................................... 7

1.3 BSP STRUCTURE.......................................................................................... 7

1.4 VIVADO REFERENCE DESIGN ............................................................................ 8

1.5 INSTALLING THE BSP .................................................................................... 9

1.6 BUILDING A BOOT IMAGE FOR ZYNQ .................................................................10

1.7 PROGRAMMING FMC FRU EEPROM DATA ..........................................................12

TROUBLESHOOTING................................................................................... 152

KNOWN BUGS AND RESTRICTIONS .................................................................. 16

APPENDIX A: REFERENCE DOCUMENTATION .................................................... 17

APPENDIX B: DOCUMENT’S HISTORY ............................................................... 18

NAMC-ZYNQ-FMC –Board Support Package Manual

Version 1.0 © N.A.T. GmbH V

List of Tables

Table 1: BSP folder structure .................................................................................. 8

Table 2: Makefile description..................................................................................12

NAMC-ZYNQ-FMC –Board Support Package Manual

Version 1.0 © N.A.T. GmbH VI

List of Figures

Figure 1: Vivado Block Diagram .............................................................................. 9

Figure 2: Export Hardware...................................................................................... 9

Figure 3: Petalinux main configuration menu ...........................................................11

Figure 4: Petalinux components configuration ..........................................................11

Figure 5: U-boot selection .....................................................................................11

Figure 6: Kernel selection ......................................................................................11

Figure 7: TeraTerm Serial Port Setup ......................................................................13

Figure 8: MMC Boot Output....................................................................................13

Figure 9: FRU wizard.............................................................................................14

Conventions

If not otherwise specified, addresses and memory maps are written in hexadecimal

notation, identified by 0x.

The following table gives a list of the abbreviations used in this document.

Abbreviation

Description

BSP

Board Support Package

FSBL

First Stage Bootloader

SoC

System on Chip

Operating System

FMC

FPGA Mezzanine Card

NAMC-ZYNQ-FMC –Board Support Package Manual

Version 1.0 © N.A.T. GmbH 7

Board Support Package Description1

1.1 Introduction

The Board Support Package (BSP) is shipped with the NAMC-ZYNQ-FMC to support

customers generating a complete linux distribution including FSBL, U-Boot and kernel

image for the Xilinx ZYNQ FPGA SoC. The BSP ensures a basic working infrastructure

including necessary communication and memory interfaces to support customers

developing their own FMC drivers and applications on top of that.

The software part is based on the Petalinux build system that is officially supported by

Xilinx. Before you can use the BSP you will have to install the necessary Xilinx tools and

the N.A.T sources. This is going to be explained in the next chapters. Although N.A.T

recommends using the BSP you are completely free whether to use your own software

distributions. It is also possible to run a bare metal application without any OS on the

SoC but there approaches are outside of the manuals scope.

For generating the necessary hardware description files you may use the N.A.T Vivado

example project that is also included in the board support package. The example project

contains a block diagram that customers could use as a template to build their logic on

top of that. It ensures the basic hardware functionality such as standard communication

interfaces.

Common information about the Petalinux build system can be found at “UG1144

Petalinux Tools Documentation Reference Guide” [2] or at Xilinx wiki:

http://www.wiki.xilinx.com/Petalinux

1.2 Prerequisite for using the BSP

Before you can use the BSP you will have to set up a few things:

A host system (linux or windows) with Vivado installed

A host system (linux) containing the Petalinux toolchain and SDK

The N.A.T reference FPGA configuration image was created with Xilinx Vivado 2015.2.1

thus for best compatibility N.A.T recommends to use both the Petalinux 2015.2.1 build

system and the corresponding Vivado version. Please follow the Xilinx Petalinux

Documentation “UG1144 Petalinux Tools Reference Guide” on how to install the Xilinx

tools on your host machine.

1.3 BSP structure

Referring to the table below, the board support package contains four folders. The bsp

folder includes the software project containing the build output of the kernel image and

other components. The image folder contains all images that are needed for the device to

operate including the FPGA bitstream, u-boot and kernel binaries. The subsystem folder

is used for holding user configuration (e.g. device-tree). In the /doc folder you can find

any necessary documentation. The /src folder is intended to be used by the bsp for

holding user application data and patch files in order for the software components to

work with the hardware that were made by N.A.T. These files are patched by using the

NAMC-ZYNQ-FMC –Board Support Package Manual

Version 1.0 © N.A.T. GmbH 8

makefile delivered with the bsp. The /vivado folder contains the hardware reference

project that can be used as a template for bitstream generation. The overview of the

folder structure is shown at the table below:

bsp

Petalinux project folder (bsp=project name)

build

Object files from build process

components

Contains FSBL sources

hw-description

Contains FPGA configuration file

images

Contains images for booting the device

subsystems

Several configuration files (device tree, startup configs)

doc

Documentation

src

User defined sources

patches

Patch files

components

Linux-Kernel and U-boot sources

apps

User applications

vivado

Vivado project folder containing reference

hardware design for NAMC-ZYNQ-FMC

Table 1: BSP folder structure

1.4 Vivado reference design

The BSP has a folder /vivado witch contains the reference design for the ZYNQ FPGA that

customers may use as a template for developing further logic on top of that. The design

was created with Vivado 2015.2.1. Opening and compiling the design requires a license

file for the ZYNQ FPGA device (xc7z045ffg900-2) that can be purchased at Xilinx store.

The design brings a block diagram (see figure below) with basic communication and

memory interfaces, such as Ethernet, AXI PCIe and a DDR3 memory controller. There is

also an instance that serves 100 MHz telecom clocks TCLKB, TCLKD to the backplane. To

use that feature, just change the constant value from “0” to “1”.

For interfacing with the FMC using SPI or I2C protocol you may use the FPGA EMIO to

route these protocols directly into the ARM core. That will enable you to use the

peripherals quickly within the standard linux drivers. All you need to do is to assign the

FMC I/O pin to the IIC_1 and SPI_0 interface before implementing the design.

NAMC-ZYNQ-FMC –Board Support Package Manual

Version 1.0 © N.A.T. GmbH 9

Figure 1: Vivado Block Diagram

Before you can use the design with the Petalinux build system you will have to export the

hardware description file once you have implemented and generated a bitstream. To do

so, select “File->Export->Export Hardware”.

Figure 2: Export Hardware

This step is necessary to enable you to import the hardware description file with the

Petalinux build system.

1.5 Installing the BSP

With having both Xilinx Vivado and Petalinux tools installed the next step is to install the

BSP sources and set up several paths. First you have to copy the main BSP folder to any

working directory (e.g. \home\myname\namc-zynq-fmc\). To make the installation easy

N.A.T provides a makefile that does all of the jobs for you. To use the makefile you have

to set up two environment variables that are noted at the first lines in the makefile. To

edit the file chose any text editor of your choice. If your installation paths of Petalinux

and Vivado are set to default you do not have to change anything.

NAMC-ZYNQ-FMC –Board Support Package Manual

Version 1.0 © N.A.T. GmbH 10

PETALINUX_INSTALL = /opt/xilinx/petalinux-v2015.2.1

VIVADO_INSTALL = /opt/xilinx/Vivado/2015.2

When you are done with that navigate to the top level of your project folder and execute

the makefile with:

make import-components

This command will copy the u-boot and linux-kernel sources that came with the Petalinux

installation to your project into the directory /src/components/. This step is necessary as

we want to leave the original sources untouched. The next thing to do is to patch the

kernel and u-boot sources with the files located in /src/patch/. To do so just execute the

makefile again with the following target:

make patch-components

The last thing to do is to create symbolic links at the place where the components are

stored in the petalinux installation path. This is mandatory because the petalinux system

uses this path as reference to find any components to be built. The symbolic link ensures

that we will be able to select the patched sources located in the project folder later

during the build system configuration. The link gets created using the makefile:

make setup-links

[NOTE] Depending on the owner of the petalinux installation it may be the case

that you have to execute this command as a root user.

With these steps executed you are ready to build the first boot image. The next chapter

will tell how to do that.

1.6 Building a boot image for ZYNQ

This chapter will instruct you how to build an executable build image for the NAMC-

ZYNQ-FMC device. The first thing you have to do is to create a new petalinux project. To

this with the makefile using:

make create-project

[NOTE] The default project name is “bsp”. If you wish to create a project with a different

name set the makefile environment “PROJECT_NAME”.

The next step is export the hardware image from within the Vivado Project (see Chapter

1.4). Then you will be able import the hardware description from Vivado into the

petalinux project. Simply do this using the makefile:

make import-hw

After importing is done the configuration for the build system should appear and you

should be able to choose the components (u-boot and kernel) we have initially created

with the makefile in the chapter before. See figures below as a reference:

Table des matières

Autres manuels N.A.T. Unité de contrôle

N.A.T.

N.A.T. powerBridge NAMC-EXT Manuel du produit

Manuels Unité de contrôle populaires d'autres marques

Festo

Festo Compact Performance CP-FB6-E Manuel de la liste des pièces

Elo TouchSystems

Elo TouchSystems DMS-SA19P-EXTME Manuel utilisateur

JS Automation

JS Automation MPC3034A Manuel utilisateur

JAUDT

JAUDT SW GII 6406 Series Guide rapide

Spektrum

Spektrum Air Module System Manuel utilisateur

BOC Edwards

BOC Edwards Q Series Manuel utilisateur

KHADAS

KHADAS BT Magic Manuel utilisateur

Etherma

Etherma eNEXHO-IL Manuel utilisateur

PMFoundations

PMFoundations Attenuverter Manuel utilisateur

GEA

GEA VARIVENT Manuel utilisateur

Walther Systemtechnik

Walther Systemtechnik VMS-05 Manuel utilisateur

Altronix

Altronix LINQ8PD Instructions de montage

Eaton

Eaton Powerware Series Manuel utilisateur

WAGO

WAGO 750-407/040-000 Manuel utilisateur

Sony

Sony CCU-590 Manuel utilisateur

Graco

Graco 25D614 Manuel utilisateur

Task Force Tips

Task Force Tips YE-RF-900 Manuel de programmation

Shini

Shini SPV-U Series Manuel utilisateur