board/zynqmp: add custom board documentation

The readme.txt file for zynqmp boards does not have documentation for working
with custom boards.  This patch adds documentation for custom board support.

Signed-off-by: Neal Frager <neal.frager@amd.com>
Signed-off-by: Julien Olivain <ju.o@free.fr>
This commit is contained in:
Neal Frager
2025-06-17 15:15:34 +01:00
committed by Julien Olivain
parent c6c559aaee
commit 4ad9c49ec8

View File

@@ -65,6 +65,47 @@ Where 'sdX' is the device node of the SD.
Eject the SD card, insert it in the board, and power it up. Eject the SD card, insert it in the board, and power it up.
Support for other boards:
=========================
If you want to build a system for other boards based on the same SoC, and the
board is already supported by the upstream kernel and U-Boot, you simply need
to change the following Buildroot options:
- Kernel Device Tree file name (BR2_LINUX_KERNEL_INTREE_DTS_NAME)
- U-Boot (BR2_TARGET_UBOOT_CUSTOM_MAKEOPTS="DEVICE_TREE=<dts file name>")
Custom psu_init_gpl.c/h support:
To generate a working boot.bin image, psu_init_gpl.c/h are required in
the U-Boot source tree. Without those files, boot.bin will be built
successfully but it will not be functional at all. Those files are
output from the Xilinx tools, but for convenience, U-Boot includes the
default psu_init_gpl.c/h of popular boards. Those files may need to be
updated for any programmable logic or DDR customizations which impact
psu_init (clock/pin setup & mapping/AXI bridge setup/etc). See
board/xilinx/zynqmp/ directory of U-Boot for natively supported psu_init
files. If the psu_init files for your board are not found in U-Boot,
you need to add them by yourself.
1) Start with a defconfig supported by Buildroot (e.g. ZCU106)
make zynqmp_zcu106_defconfig
2) make uboot-menuconfig
Visit the following menu and enable CONFIG_XILINX_PS_INIT_FILE
ARM architecture --->
[*] Zynq/ZynqMP PS init file(s) location
3) Copy psu_init_gpl.c/h generated by the Xilinx Vivado tools into
output/build/uboot-custom/board/xilinx/zynqmp/custom_hw_platform/
4) make
Note: The files in step 3 will need to be re-copied after cleaning the
output directory and at this time, there is no way to save them as
part of the buildroot configuration, except as a U-Boot patch.
============== ==============
Important Note Important Note
============== ==============