kumquat-buildroot/board/zynqmp
Luca Ceresoli 822c34c301 uboot: zynqmp: allow to use custom psu_init files
U-Boot SPL configures pinmuxes, clocks and other low-level devices. On
the Xilinx ZynqMP SoCs the code to do this resides in a file called
psu_init_gpl.c which is initially generated by the Xilinx development
tools. Add an option to pass these files from the outside (e.g. in the
board files).

For this to work properly, a patch to U-Boot is needed. However this
patch must be applied by each defconfig using
BR2_TARGET_UBOOT_ZYNQMP_PSU_INIT_DIR. If it were in boot/uboot/ to be
applied unconditionally, it would break the build for configs using a
U-Boot version where the patch is already applied.

Signed-off-by: Luca Ceresoli <luca@lucaceresoli.net>
Cc: Joel Carlson <joelsoncarl@gmail.com>
Reviewed-by: Joel Carlson <JoelsonCarl@gmail.com>
Tested-by: Joel Carlson <JoelsonCarl@gmail.com>
[Thomas: add comment about U-Boot version requirements to use this
option.]
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@bootlin.com>
2018-07-28 19:27:38 +02:00
..
patches/uboot uboot: zynqmp: allow to use custom psu_init files 2018-07-28 19:27:38 +02:00
genimage.cfg configs/zynqmp_zcu106_defconfig: add Xilinx ZCU106 board (ZynqMP SoC) 2018-07-28 19:18:31 +02:00
post-image.sh configs/zynqmp_zcu106_defconfig: add Xilinx ZCU106 board (ZynqMP SoC) 2018-07-28 19:18:31 +02:00
readme.txt configs/zynqmp_zcu106_defconfig: add Xilinx ZCU106 board (ZynqMP SoC) 2018-07-28 19:18:31 +02:00

********************************
Xilinx ZCU106 board - ZynqMP SoC
********************************

This document describes the Buildroot support for the ZCU106 board by
Xilinx, based on the Zynq UltraScale+ MPSoC (aka ZynqMP). It has been
tested with the EK-U1-ZCU106-ES2 pre-production board.

How to build it
===============

Configure Buildroot:

    $ make zynqmp_zcu106_defconfig

Compile everything and build the rootfs image:

    $ make

Result of the build
-------------------

After building, you should get a tree like this:

    output/images/
    +-- atf-uboot.ub
    +-- bl31.bin
    +-- boot.bin
    +-- boot.vfat
    +-- Image
    +-- rootfs.ext2
    +-- rootfs.ext4 -> rootfs.ext2
    +-- sdcard.img
    +-- system.dtb -> zynqmp-zcu106-revA.dtb
    +-- u-boot.bin
    `-- zynqmp-zcu106-revA.dtb

How to write the SD card
========================

WARNING! This will destroy all the card content. Use with care!

The sdcard.img file is a complete bootable image ready to be written
on the boot medium. To install it, simply copy the image to an SD
card:

    # dd if=output/images/sdcard.img of=/dev/sdX

Where 'sdX' is the device node of the SD.

Eject the SD card, insert it in the board, and power it up.