Getting started with Yocto Xilinx layer

Table of Contents

Repo Tool overview

Repo is a repository management tool that is built on top of Git. Repo unifies the many Git repositories when necessary, and automates parts of the development workflow. Repo is not meant to replace Git, only to make it easier to work with Git in the context of development.The repo command is an executable Python script that you can put anywhere in your path. In working with the source files, you will use Repo for across-network operations. For example, with a single Repo command you can download files from multiple repositories into your local working directory.

More details about repo tool is present at

Step 1: Preparing the Build Environment

Install Repo

Fetch all sources

Release 2017.1 and above :

Release 2016.3 or below :

where current-release is rel-v2016.3 or rel-v2016.1 etc

Source environment

Edit configuration files

You should be in the 'build' directory at this point. You may need to edit the following files in the 'conf' directory:

  1. Edit bblayers.conf so that it has the appropriate layers for your build.
  2. Edit local.conf to reflect your choices for the build. If using the sstate-cache downloaded above, you need these lines:
    1. SSTATE_DIR ?= "${TOPDIR}/../sstate-rel-v2017.2/aarch64/sstate-cache"
    2. DL_DIR ?= "${TOPDIR}/../sstate-rel-v2017.2/downloads

Edit configuration files for building FSBL and PMUFW

Note :

  1. HDF_BASE could be "git" for git repo or "file://" for local
  2. if xsct does not work set XILINX_SDK_TOOLCHAIN in conf/local.conf pointing to xsct
  3. All the hdf file provided should be of build 2016.3 or higher

Step 2: Build using bitbake

You can choose between 'petalinux-image', 'petalinux-image-minimal' and 'petalinux-image-full' below.

Similarly build for other machine (ZC702, ZC706 etc)

Release 2016.1 to 2016.4:

Below information is applicable only to Releases 2016.1 to 2016.4
Following has to be present in your configuration to use XIlinx SDK toolchain (local.conf or override.conf)

<current-version> will be 2016.3, 2016.1 etc
<current-release> will be 2016.3, 2016.1 etc

Re-running bitbake

If you need to run bitbake again, for example if your build failed the first time, source setupsdk like in Step 1 and rerun bitbake

Related Links

Xilinx Yocto