Using the SHEL Flow to create a Yocto Project machine configuration from a `.xsa` file

Using the SHEL Flow to create a Yocto Project machine configuration from a `.xsa` file

This page is intended to provide the high level overview as well as a very simple tutorial on how to use the SHEL flow to create a Linux image for AMD™ Adaptive SoC hardware.

SHEL.svg
High level overview of the SHEL flow

Table of Contents

SHEL flow in a few steps

  1. Run System Device Tree Generator (SDTGen) as instructed in its README file.

  2. Set up a yocto environment that includes the xilinx meta layers. meta-xilinx/README.building.md at master · Xilinx/meta-xilinx

  3. Run gen-machine-conf on the resultant output. This will generate a new Yocto “Machine” appropriate for your system.

gen-machine-conf parse-sdt --hw-description <path_to_sdtgen_output_directory> -c <conf-directory> -l <path-to-build-directory>/build/conf/local.conf --machine-name <your machine name>

Ensure you are using your new machine configuration in Yocto by prepending MACHINE=<your machine name> to all yocto commands or a add MACHINE=<your machine name> to your projects local.conf

Congratulations! you should now be in a Yocto Project environment! You should be able to build images with:

MACHINE=<your machine name> bitbake edf-linux-disk-image

and then emulate with

runqemu qemuarm

 

© 2025 Advanced Micro Devices, Inc. Privacy Policy