diff options
Diffstat (limited to 'meta-xilinx-standalone/README.md')
-rw-r--r-- | meta-xilinx-standalone/README.md | 95 |
1 files changed, 52 insertions, 43 deletions
diff --git a/meta-xilinx-standalone/README.md b/meta-xilinx-standalone/README.md index 50ac9ad7..aa672b1d 100644 --- a/meta-xilinx-standalone/README.md +++ b/meta-xilinx-standalone/README.md @@ -1,62 +1,71 @@ -meta-xilinx-standalone -====================== +# meta-xilinx-standalone This layer is meant to augment Yocto/OE functionality to provide a -Baremetal/Standalone Toolchain as well as the foundation for building -the embeddedsw components that enable non-Linux software required for -Xilinx based FPGA/SOCs. +Baremetal/Standalone distribution as well as a generic version of various +firmware that is required to boot a ZynqMP or Versal system. -Note, the non-Linux software components are still in development and -this should be considered to be a preview release only. For instance, -some components may not be buildable, expect APIs to change on various -parts and pieces. +For optimized versions of the firmware and additional components you must +use the meta-xilinx-tools layer. +## Building -Maintainers, Mailing list, Patches -================================== +The software in this layer may be used in either a standard single +configuration build, or a multiconfig build. A multiconfig build, along +with the MACHINES defined in meta-xilinx-bsps will automate the generation +of certain firmwares. +--- +## Standalone Firmware -Please send any patches, pull requests, comments or questions for this -layer to the [meta-xilinx mailing list] -(https://lists.yoctoproject.org/listinfo/meta-xilinx): +The standalone firmware is a generically configured firmware, it can be +build either in a single standalone configuration, or via an automated +multiconfig approach only when needed. - meta-xilinx@lists.yoctoproject.org +* multiconfig setup -Maintainers: +To automatically build the standalone firmware with a Linux build, you need +to only add the following to your conf/local.conf file. This will use +the multiconfig mechanism within the Yocto Project to build the corresponding +standalone firmware on demand. - Sai Hari Chandana Kalluri <chandana.kalluri@xilinx.com> - Mark Hatle <mark.hatle@xilinx.com> +Edit the conf/local.conf file, add: -Dependencies -============ +``` +# For zynqmp-generic +BBMULTICONFIG += "fsbl-fw zynqmp-pmufw" +``` -This layer depends on: - - URI: git://git.yoctoproject.org/poky - - URI: git://git.yoctoproject.org/meta-xilinx/meta-xilinx-bsp - -Usage -===== +``` +# For versal-generic +BBMULTICONFIG += "versal-fw" +``` -1.- Clone this layer along with the specified layers +**To build:** -2.- $ source oe-init-build-env +``` +# For zynqmp, select a zynqmp machine or the generic one +$ MACHINE=zynqmp-generic bitbake fsbl pmufw +``` -3.- Add this layer to BBLAYERS on conf/bblayers.conf +``` +# For versal, select a versal machine or the generic one +$ MACHINE=versal-generic bitbake plmfw psmfw +``` +--- -4.- Add the following to your conf/local.conf to build for the -microblaze architecture: +## Dependencies -DISTRO="xilinx-standalone" - -MACHINE="microblaze-pmu" - -5.- Build a package: - -for example: +This layer depends on: -$ bitbake newlib + URI: https://git.yoctoproject.org/poky + layers: meta, meta-poky + branch: langdale -or + URI: https://git.openembedded.org/meta-openembedded + layers: meta-oe + branch: langdale -$ bitbake meta-toolchain + URI: + https://git.yoctoproject.org/meta-xilinx (official version) + https://github.com/Xilinx/meta-xilinx (development and amd xilinx release) + layers: meta-xilinx-microblaze, meta-xilinx-core, meta-xilinx-bsp + branch: langdale or amd xilinx release version (e.g. rel-v2023.1) |