From 2b6679baba30ed7b7d54cddd529fdf8b2ffe3d60 Mon Sep 17 00:00:00 2001 From: Javier Domingo Cansino Date: Sat, 21 Jun 2014 00:28:51 +0200 Subject: [PATCH] board/avnet/zedboard/: improve readme.txt explanations [Thomas: fix small grammar issue noticed by Spenser Gilliland, adjust commit title.] Signed-off-by: Javier Domingo Cansino Signed-off-by: Thomas Petazzoni --- 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 efd076f91f..fe8c75ef1f 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 these 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 +/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} \ -output/build/uboot-xilinx-v2014.1/boards/xilinx/zynq/ +output/build/uboot-xilinx-v2014.1/board/xilinx/zynq/ + +After copying these files into the U-Boot source tree, you can +continue the build with: + make +*Notice* +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 -- 2.30.2