Meta AMD EDF

https://github.com/xilinx/meta-amd-edf
Admin
A Yocto meta-layer that provides AMD Embedded Development Framework (EDF) metadata for building...
Tokens:4,496
Snippets:47
Trust Score:9.3
Update:4 months ago
Show doc for...
Tokens:
Raw
### Download and Install Repo Tool

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/README.build.md

Download, make executable, move, and add the Repo tool to the PATH.

```bash
curl https://storage.googleapis.com/git-repo-downloads/repo > repo
chmod a+x repo
mv repo ~/bin/
PATH=~/bin:$PATH
repo --help
```

--------------------------------

### Start Development Branch

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/README.build.md

Start a new branch for development, based on the revision specified in the manifest. This is an optional step.

```bash
repo start <branch_name> --all
```

--------------------------------

### Generating Boot.bin

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/conf/templates/default/conf-notes.txt

Example command to generate a boot.bin for a specific platform.

```bash
MACHINE=zynqmp-zcu104-sdt-full bitbake xilinx-bootbin
```

--------------------------------

### Patch Example

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/README.md

Example of creating a patch with a specific subject prefix.

```bash
git format-patch -s --subject-prefix="meta-amd-edf][scarthgap][PATCH" -1
```

--------------------------------

### Building EDF Linux Disk Image

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/conf/templates/default/conf-notes.txt

Example command to build the edf-linux-disk-image for a specific machine.

```bash
MACHINE=amd-cortexa72-common bitbake edf-linux-disk-image
```

--------------------------------

### Build qemu-helper-native Package

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/README.build.md

Build the qemu-helper-native package to set up QEMU network tap devices.

```bash
bitbake qemu-helper-native
```

--------------------------------

### Fetch Repositories

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/README.build.md

Fetch all the repositories defined in the manifest.

```bash
repo sync
```

--------------------------------

### Initialize Repo Client

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/README.build.md

Initialize a Repo client by cloning the Yocto meta layer source using a specified manifest.

```bash
repo init -u https://github.com/Xilinx/yocto-manifests.git -b <release_version> -m default-edf.xml
```

--------------------------------

### Build Boot.bin Image

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/README.build.md

Commands to build the boot.bin image for different ZynqMP and Versal boards.

```bash
$ MACHINE=zynqmp-zcu104-sdt-full bitbake xilinx-bootbin
or
$ MACHINE=zynqmp-zcu111-sdt-full bitbake xilinx-bootbin
or
$ MACHINE=versal-vek280-sdt-seg bitbake xilinx-bootbin
```

--------------------------------

### Create Project Directory

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/README.build.md

Create the directory structure for the Yocto EDF project.

```bash
mkdir -p yocto/<release_version>/edf
cd yocto/<release_version>/edf
```

--------------------------------

### Configure Tap Interface

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/README.build.md

Manually configure a tap interface for the build system by running a script as root.

```bash
sudo ./<path-to-layer>/poky/scripts/runqemu-gen-tapdevs $(id -g $USER) 4
```

--------------------------------

### Initialize Build Environment

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/README.build.md

Source the 'edf-init-build-env' script to initialize the Yocto build environment.

```bash
source edf-init-build-env
```

--------------------------------

### Generate boot.bin for System Controller

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/conf/templates/default-sc/conf-notes.txt

This command generates a boot.bin image for the zynqmp-k24-sc-sdt-base platform.

```bash
MACHINE=zynqmp-k24-sc-sdt-base bitbake xilinx-bootbin
```

--------------------------------

### Configure Git Settings

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/README.build.md

Configure global git email and name before running repo commands.

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

--------------------------------

### Build SoC Common Disk Image (wic)

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/README.build.md

Commands to build the SoC common disk image for various AMD Cortex families.

```bash
$ MACHINE=amd-cortexa53-common bitbake edf-linux-disk-image
```

```bash
$ MACHINE=amd-cortexa53-mali-common bitbake edf-linux-disk-image
```

```bash
$ MACHINE=amd-cortexa72-common bitbake edf-linux-disk-image
```

```bash
$ MACHINE=amd-cortexa78-mali-common bitbake edf-linux-disk-image
```

--------------------------------

### Option to Save Disk Space

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/README.build.md

Add a variable to local.conf to remove the work directory after build, keeping only logs.

```bash
INHERIT += "rm_work"
```

--------------------------------

### Generate QSPI image for System Controller

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/conf/templates/default-sc/conf-notes.txt

This command generates a qspi image for the zynqmp-k24-sc-sdt-base platform.

```bash
MACHINE=zynqmp-k24-sc-sdt-base bitbake edf-qspi
```

--------------------------------

### Sending Patches

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/README.md

Command to send patches to the meta-xilinx mailing list.

```bash
git send-email --to meta-xilinx@lists.yoctoproject.org *.patch
```

--------------------------------

### Configure TMPDIR for NFS Build Host

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/README.build.md

Modify local.conf to set the TMPDIR path for NFS build host systems.

```bash
TMPDIR = "/tmp/$USER/yocto/release_version/build"
```

--------------------------------

### Patch Syntax

Source: https://github.com/xilinx/meta-amd-edf/blob/rel-v2025.1/README.md

Syntax for creating patches with a specific subject prefix.

```bash
git format-patch -s --subject-prefix="meta-amd-edf][<BRANCH_NAME>][PATCH" -1
```
Tokens:
Raw