summaryrefslogtreecommitdiffstats
path: root/meta-xilinx-standalone-sdt
diff options
context:
space:
mode:
authorSandeep Gundlupet Raju <sandeep.gundlupet-raju@amd.com>2024-08-05 19:25:53 -0600
committerMark Hatle <mark.hatle@amd.com>2024-08-08 18:00:57 -0500
commit19d6e256b228a06db096065d2fcf5c07c258124c (patch)
tree14d8364787703cc2e74321de5ef14483f7cf77e6 /meta-xilinx-standalone-sdt
parent417b367457efd9744d5ff4459e7dd3f47026ca35 (diff)
downloadmeta-xilinx-19d6e256b228a06db096065d2fcf5c07c258124c.tar.gz
README.md: Add instructions for Zynq-7000 SDT build
Add instructions for Zynq-7000 system device tree build. Signed-off-by: Sandeep Gundlupet Raju <sandeep.gundlupet-raju@amd.com> Signed-off-by: Mark Hatle <mark.hatle@amd.com>
Diffstat (limited to 'meta-xilinx-standalone-sdt')
-rw-r--r--meta-xilinx-standalone-sdt/README.md51
1 files changed, 29 insertions, 22 deletions
diff --git a/meta-xilinx-standalone-sdt/README.md b/meta-xilinx-standalone-sdt/README.md
index d2d54c2e..0ecc6e4d 100644
--- a/meta-xilinx-standalone-sdt/README.md
+++ b/meta-xilinx-standalone-sdt/README.md
@@ -33,26 +33,22 @@ $ git clone -b <rel-version> https://github.com/Xilinx/meta-openamp
33 meta-kria and meta-system-controller if included in bblayers.conf), then add 33 meta-kria and meta-system-controller if included in bblayers.conf), then add
34 the meta-xilinx-standalone-sdt and meta-openamp layer. 34 the meta-xilinx-standalone-sdt and meta-openamp layer.
35 35
36> **Note:** SDT builds for following devices are not supported in 2024.1 release. 36> **Note:** SDT builds for following devices are not supported in 2024.2 release.
37> * Zynq 7000 37> * MicroBlaze
38> * MicoBlaze 38
39> * Kria
40> * System Controller
41 39
42``` 40```
43$ bitbake-layers remove-layer meta-xilinx-tools 41$ bitbake-layers remove-layer meta-xilinx-tools
44$ bitbake-layers remove-layer meta-kria
45$ bitbake-layers remove-layer meta-system-controller
46$ bitbake-layers add-layer ./<path-to-layer>/meta-xilinx/meta-xilinx-standalone-sdt 42$ bitbake-layers add-layer ./<path-to-layer>/meta-xilinx/meta-xilinx-standalone-sdt
47$ bitbake-layers add-layer ./<path-to-layer>/meta-openamp 43$ bitbake-layers add-layer ./<path-to-layer>/meta-openamp
48``` 44```
49 45
505. Export gen-machineconf tool. 461. Export gen-machineconf tool.
51``` 47```
52$ export PATH=$PATH:<ABSOLUTE_PATH>/gen-machine-conf 48$ export PATH=$PATH:<ABSOLUTE_PATH>/gen-machine-conf
53``` 49```
54 50
556. Run the script from the build or ${TOPDIR} directory. This step describes 511. Run the script from the build or ${TOPDIR} directory. This step describes
56 System Device Tree (SDT) with and without pl overlays. Configruations are same 52 System Device Tree (SDT) with and without pl overlays. Configruations are same
57 for both SDT with and without pl overlays except for linux dts content. 53 for both SDT with and without pl overlays except for linux dts content.
58 54
@@ -82,7 +78,7 @@ $ export PATH=$PATH:<ABSOLUTE_PATH>/gen-machine-conf
82> needs to use the *_partial.dtsi and *_partial.pdi/bit from sdtgen output 78> needs to use the *_partial.dtsi and *_partial.pdi/bit from sdtgen output
83> artifacts to DFx partial firmware recipes. 79> artifacts to DFx partial firmware recipes.
84 80
85 * ZynqMP Full bitstream or Versal Segmented Configuration: 81 * Zynq-700 or ZynqMP Full bitstream or Versal Segmented Configuration:
86``` 82```
87 $ gen-machineconf parse-sdt --hw-description <path_to_sdtgen_output_directory> -c <conf> -l conf/local.conf -g full 83 $ gen-machineconf parse-sdt --hw-description <path_to_sdtgen_output_directory> -c <conf> -l conf/local.conf -g full
88``` 84```
@@ -92,15 +88,15 @@ $ export PATH=$PATH:<ABSOLUTE_PATH>/gen-machine-conf
92 $ gen-machineconf parse-sdt --hw-description <path_to_sdtgen_output_directory> -c <conf> -l conf/local.conf -g dfx 88 $ gen-machineconf parse-sdt --hw-description <path_to_sdtgen_output_directory> -c <conf> -l conf/local.conf -g dfx
93``` 89```
94 90
95For example, zynqmp: 91For example, Zynq-7000:
96``` 92```
97$ gen-machineconf --soc-family zynqmp --hw-description <path_to_sdtgen_output_directory> -c conf/ -l conf/local.conf 93$ gen-machineconf parse-sdt --hw-description <path_to_sdtgen_output_directory> -c conf/ -l conf/local.conf
98``` 94```
99The following will be written to the end of the conf/local.conf file: 95The following will be written to the end of the conf/local.conf file:
100 96
101``` 97```
102# Use the newly generated MACHINE 98# Use the newly generated MACHINE
103MACHINE = "xlnx-zynqmp-zcu102-rev1-0" 99MACHINE = "xlnx-zynq-zc702"
104 100
105# Avoid errors in some baremetal configs as these layers may be present 101# Avoid errors in some baremetal configs as these layers may be present
106# but are not used. Note the following lines are optional and can be 102# but are not used. Note the following lines are optional and can be
@@ -108,15 +104,29 @@ MACHINE = "xlnx-zynqmp-zcu102-rev1-0"
108SKIP_META_VIRT_SANITY_CHECK = "1" 104SKIP_META_VIRT_SANITY_CHECK = "1"
109SKIP_META_SECURITY_SANITY_CHECK = "1" 105SKIP_META_SECURITY_SANITY_CHECK = "1"
110SKIP_META_TPM_SANITY_CHECK = "1" 106SKIP_META_TPM_SANITY_CHECK = "1"
107```
111 108
112# Each generated multiconfig defines it's own TMPDIR, either edit the 109For example, ZynqMP:
113# multiconfig files, or uncomment and adjust MC_TMPDIR_PREFIX below
114#MC_TMPDIR_PREFIX = "${TOPDIR}/tmp"
115``` 110```
111$ gen-machineconf parse-sdt --hw-description <path_to_sdtgen_output_directory> -c conf/ -l conf/local.conf
112```
113The following will be written to the end of the conf/local.conf file:
116 114
117For example, versal:
118``` 115```
119$ gen-machineconf --soc-family versal --hw-description <path_to_sdtgen_output_directory> -c conf/ -l conf/local.conf 116# Use the newly generated MACHINE
117MACHINE = "xlnx-zynqmp-zcu102-rev1-0"
118
119# Avoid errors in some baremetal configs as these layers may be present
120# but are not used. Note the following lines are optional and can be
121# safetly disabled.
122SKIP_META_VIRT_SANITY_CHECK = "1"
123SKIP_META_SECURITY_SANITY_CHECK = "1"
124SKIP_META_TPM_SANITY_CHECK = "1"
125```
126
127For example, Versal:
128```
129$ gen-machineconf parse-sdt --hw-description <path_to_sdtgen_output_directory> -c conf/ -l conf/local.conf
120``` 130```
121 131
122The following will be written to the end of the conf/local.conf file: 132The following will be written to the end of the conf/local.conf file:
@@ -131,11 +141,8 @@ MACHINE = "xlnx-versal-vmk180-rev1-1-x-ebm-01-reva"
131SKIP_META_VIRT_SANITY_CHECK = "1" 141SKIP_META_VIRT_SANITY_CHECK = "1"
132SKIP_META_SECURITY_SANITY_CHECK = "1" 142SKIP_META_SECURITY_SANITY_CHECK = "1"
133SKIP_META_TPM_SANITY_CHECK = "1" 143SKIP_META_TPM_SANITY_CHECK = "1"
134
135# Each generated multiconfig defines it's own TMPDIR, either edit the
136# multiconfig files, or uncomment and adjust MC_TMPDIR_PREFIX below
137#MC_TMPDIR_PREFIX = "${TOPDIR}/tmp"
138``` 144```
145
139> **Bitbake Performance Note:** 146> **Bitbake Performance Note:**
140Each BBMULTICONFIG value requires all of the recipes to be parsed for that 147Each BBMULTICONFIG value requires all of the recipes to be parsed for that
141configuration. Thus each multiconfig will add more parsing time. A long list 148configuration. Thus each multiconfig will add more parsing time. A long list