kumquat-buildroot/board/zynqmp/kria
Neal Frager f67720baa3 configs/zynqmp_kria_kv260_defconfig: fix to u-boot.itb generation
This patch is a temporary fix for the kv260 u-boot.itb generation
until a proper fix has been implemented within u-boot.

The problem is u-boot can only be configured to use the kria k26
som dts configuration at build time, and the kv260 carrier board
overlay is missing from the build.  Without this, all of the carrier
board drivers are missing.

This patch will be removed from buildroot once u-boot can build a
correct u-boot.itb for the kria kv260 starter kit including the
carrier board overlay and corresponding drivers:

    https://lore.kernel.org/all/20920b0df6b067aca4040459a9677d7d1d6d766a.1615354376.git.viresh.kumar@linaro.org/

Signed-off-by: Neal Frager <neal.frager@xilinx.com>
Reviewed-by: Luca Ceresoli <luca.ceresoli@bootlin.com>
[yann.morin.1998@free.fr: add URL provided by Luca]
Signed-off-by: Yann E. MORIN <yann.morin.1998@free.fr>
2022-06-22 22:24:03 +02:00
..
kv260 configs/zynqmp_kria_kv260_defconfig: fix to u-boot.itb generation 2022-06-22 22:24:03 +02:00
readme.txt

**************************************************
Xilinx Kria SOM Starter Kits - ZynqMP SoC
**************************************************

This document describes the Buildroot support for the Kria 
KV260 starter kit by Xilinx, based on Kria SOM including the 
Zynq UltraScale+ MPSoC (aka ZynqMP).  It has been tested with 
the KV260 production board.

Evaluation board features can be found here with the link below.

KV260:
https://www.xilinx.com/products/boards-and-kits/kv260.html

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

Configure Buildroot:

    $ make zynqmp_kria_kv260_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 -> smk-k26-revA-sck-kv-g-revB.dtb
    +-- u-boot.itb
    `-- smk-k26-revA-sck-kv-g-revB.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.

How to write the boot.bn to QSPI boot flash
===========================================

The Kria SOMs are preconfigured to boot initially from QSPI.
This makes these boards different from other ZynqMP boards
in that the boot.bin needs to be flashed into the QSPI boot
flash such that the U-Boot SPL can then load all of the
remaining images from the SD card.

In addition, the KV260 Starter Kit QSPI comes pre-flashed with
a utility designed to make updating the QSPI flash memory
easier.

Instructions for using these utilities to update the boot.bin
in QSPI flash can be found on the wiki link below.

https://xilinx-wiki.atlassian.net/wiki/spaces/A/pages/1641152513/Kria+K26+SOM#Boot-Firmware-Updates

It is possible to boot the Buildroot generated SD card image without
updating the QSPI boot.bin image, so this is an optional step.