Setting Up the Yocto Environment

This page collects the one-time setup needed before any EDF Yocto build: configuring git, fetching the source layers with repo, sourcing the build environment, and pointing at local download and shared-state caches.

Configure Git

$ git config --global user.name "Your Name"
$ git config --global user.email "you@example.com"

Using Repo to Fetch and Manage Source Layers

EDF uses the repo tool to manage multiple Git repositories that are needed by the Yocto build. After installation, make sure the tool is in the system path and that Git is configured.

You can then use repo to initialize and sync with the AMD yocto-manifests for EDF, which define all required layers for a specific release. This downloads all source repositories needed for the build.

Example:

Download the Repo script:

$ curl https://storage.googleapis.com/git-repo-downloads/repo > repo

Make it executable:

$ chmod a+x repo

Move it onto the system path:

$ mv repo ~/bin/

Initialize the repo for the EDF release:

$ repo init -u https://github.com/Xilinx/yocto-manifests.git \
            -b rel-v2026.1 \
            -m default-edf.xml

The -m argument selects which manifest from the yocto-manifests repository to use. default-edf.xml is the manifest for external users of the EDF flow and is the recommended starting point. For the full list of available manifests and which one to use for a given audience, see the yocto-manifests README.

Note

repo requires that the build host shell be bash (not tcsh or dash). If repo init fails with manifest '...' not available, double-check that the manifest filename above matches a file that exists on the selected branch in yocto-manifests.

Sync to get all sources:

$ repo sync

Optional:

$ repo start <branch_name> --all

Source the Build Environment

Use the scripts provided by AMD to configure the Yocto build environment. This is a wrapper around Yocto’s oe-init-build-env and sets up paths, environment variables, and the build directory. Refer to the AMD Yocto wiki for version details, features, and known issues.

Source the environment to build using bitbake:

$ source <AMD EDF-init-build>-env

Configure Your Environment

Set up local downloads and sstate directories to save compile time. See Optimizing Build Time Locally - Central Download and Shared State Locations for details.