[Buildroot] [PATCH v2] Rewriting instructions to generate a zedboard image to be really verbose

Javier Domingo Cansino javierdo1 at gmail.com
Fri Jun 20 22:28:51 UTC 2014

Changes v1 -> v2:
  - Rewrote messages as suggested by spenser
 board/avnet/zedboard/readme.txt |   62 ++++++++++++++++++++++++++++++++-------
 1 file changed, 52 insertions(+), 10 deletions(-)

diff --git a/board/avnet/zedboard/readme.txt b/board/avnet/zedboard/readme.txt
index efd076f..28f4846 100644
--- a/board/avnet/zedboard/readme.txt
+++ b/board/avnet/zedboard/readme.txt
@@ -5,26 +5,68 @@ System-On-Chip.
 Zedboard information including schematics, reference designs, and manuals are
 available from http://www.zedboard.org .
-To boot the Zedboard using a buildroot generated image copy the following files
-to the sdcard:
-	zynq-zed.dtb -> devicetree.dtb
-	rootfs.cpio.gz.uboot -> uramdisk.image.gz
-	uImage -> uImage
-	boot.bin -> boot.bin
+The U-Boot firmware for the Xilinx Zynq All Programmable SoC depends
+on some propietary code. This dependency consists of a pair of
+files are available from the Xilinx SDK installation.
-U-Boot SPL Support
+You will need this files from Xilinx SDK installation to generate
+the U-Boot firmware:
+	ps7_init.c
+	ps7_init.h
+Buildroot will create the following files and place them in the
+<output>/images directory.
+	zynq-zed.dtb
+	rootfs.cpio.uboot
+	uImage
+	u-boot.img
+	boot.bin
+uboot.bin  -- U-Boot SPL w/ Xilinx boot.bin wrapper
 Due to licensing issues, the files ps7_init.c/h are not able to be
 distributed with the U-Boot source code.  These files are required to make a
 boot.bin file.
-If you already have the Xilinx tools installed, the follwing sequence will
+If you already have the Xilinx tools installed, the following sequence will
 unpack, patch and build the rfs, kernel, uboot, and uboot-spl.
 make zedboard_defconfig
 make uboot-patch
 cp ${XILINX}/ISE_DS/EDK/sw/lib/hwplatform_templates/zed_hw_platform/ps7_init.{c,h} \
+After copying these files into the U-Boot source tree, you can
+continue the build with:
+While the build will successfully complete without the ps7_init.*
+files,  the uboot.bin file generated by this configuration will not
+function properly on the Zedboard.  Therefore, it is imperative that
+the ps7_init.* files be copied into the U-Boot source tree any time
+the clean, or uboot-dirclean targets are made.
+Resulting system
+A FAT32 partition should be created at the beggining of the SD Card
+and the following files should be installed:
+	/boot.bin
+	/devicetree.dtb
+	/uImage
+	/uramdisk.image.gz
+	/u-boot.img
+All needed files can be taken from output/images/
+boot.bin, uImage and u-boot.img are direct copies of the same files
+available on output/images/
+devicetree.dtb is just zynq-zed.dtb renamed.
+uramdisk.image.gz is rootfs.cpio.uboot renamed

More information about the buildroot mailing list