diff options
authorMark Hatle <mark.hatle@xilinx.com>2021-03-20 16:41:14 -0700
committerMark Hatle <mark.hatle@xilinx.com>2021-03-20 16:41:14 -0700
commit6cc7dc94af09ab83c39d0acaabdadcee995bc5d1 (patch)
parent770eb410e21ddbbec943a1a813258d47646efef6 (diff)
meta-xilinx-standalone: Update README.md
Signed-off-by: Mark Hatle <mark.hatle@xilinx.com>
1 files changed, 61 insertions, 8 deletions
diff --git a/meta-xilinx-standalone/README.md b/meta-xilinx-standalone/README.md
index 50ac9ad7..48b83e1a 100644
--- a/meta-xilinx-standalone/README.md
+++ b/meta-xilinx-standalone/README.md
@@ -2,14 +2,67 @@ 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.
-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.
+Baremetal/Standalone Toolchain as well as a generic version of various
+firmware that is required to boot a ZynqMP or Versal system.
+For optimized versions of the firmware and additional components you must
+use the meta-xilinx-tools layer.
+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.
+To build standalone toolchains similar to those embedded with the
+Xilinx xsct tooling:
+Use one of the custom machines:
+ aarch32-tc - 32-bit ARM toolchains (various)
+ aarch64-tc - 64-bit ARM toolchains (various)
+ arm-rm-tc - ARM Cortex-R (and various)
+ microblaze-tc - Microblaze toolchains (various)
+MACHINE=<machine> DISTRO=xilinx-standalone bitbake meta-toolchain
+To build the standalone firmware in a standard single configuration build:
+Select a machine:
+ cortexa53-zynqmp - ZynqMP based Cortex-A53 target
+ cortexa72-versal - Versal based Cortex-A72 target
+ cortexa9-zynq - Zynq based cortex-A9 target
+ cortexr5-versal - Versal based Cortex-R5 target
+ cortexr5-zynqmp - ZynqMP based Cortex-R5 target
+ microblaze-versal-fw - Microblaze for Versal PSM/PLM firmware
+ microblaze-zyqmp-pmu - Microblaze for ZynqMP PMU firmware
+To build ZynqMP PMU Firmware:
+MACHINE=microblaze-zynqmp-pmu DISTRO=xilinx-standalone bitbake pmu-firmware
+To build Versal PLM and PSM Firwmare
+MACHINE=microblaze-versal-fw DISTRO=xilinx-standalone bitbake plm-firmware psm-firmware
+In a multiconfig build, add the following pre-defined multiconfigs to enable
+firmware building, and automatic packaging by the Linux side software.
+Edit the local.conf file, add:
+# For zynqmp
+BBMULTICONFIG += "zynqmp-pmufw"
+# For versal
+BBMULTICONFIG += "versal-fw"
+To build:
+# For zynqmp, select a zynqmp machine or the generic one
+MACHINE=zynqmp-generic bitbake pmufw
+# For versal, select a versal machine or the generic one
+MACHINE=versal-generic bitbake plmfw psmfw
Maintainers, Mailing list, Patches