README.md

Xilinx ZCU10X

1) Get firmware

Download latest pre-built Zynq UltraScale+ MPSoC Firmware and use bootgen to build the firmware binary:

git clone https://github.com/Xilinx/soc-prebuilt-firmware.git --depth 1 \
    --branch xilinx_v2023.1 $BAO_DEMOS_WRKDIR_SRC/zcu-firmware
cd $BAO_DEMOS_WRKDIR_SRC/zcu-firmware/$PLATFORM-zynqmp && 
    bootgen -arch zynqmp -image bootgen.bif -w -o $BAO_DEMOS_WRKDIR_PLAT/BOOT.BIN

2) Prepare a U-boot image

Run mkimage to create the final system image:

mkimage -n bao_uboot -A arm64 -O linux -C none -T kernel -a 0x200000\
    -e 0x200000 -d $BAO_DEMOS_WRKDIR_IMGS/bao.bin $BAO_DEMOS_WRKDIR_IMGS/bao.img

3) Setup SD card

After preparing your sd card, copy the firmware and bao's final image to it:

cp $BAO_DEMOS_WRKDIR_PLAT/BOOT.BIN $BAO_DEMOS_SDCARD
cp $BAO_DEMOS_WRKDIR_IMGS/bao.img $BAO_DEMOS_SDCARD
umount $BAO_DEMOS_SDCARD

4) Setup board

First make sure you have the board configured to boot from the SD card. If you are not sure how, check the MPSoC Device Configuration section in the board's User Guide:

• ZCU102
• ZCU104

Insert the sd card in the board's sd slot and connect to the baord via the available micro-USB JTAG/UART port.

Connect to both UARTs available on the zcu (baud 115200). In our setup:

• /dev/ttyUSB1 and /dev/ttyUSB2 for ZCU104
• /dev/ttyUSB0 and /dev/ttyUSB1 for ZCU102

Open a new terminal and connect to it. For example:

screen /dev/ttyUSB1 115200

Turn on/reset your board.

5) Run u-boot commands

Quickly press any key to skip autoboot. If not possibly press ctrl-c until you get the u-boot prompt. Then load the bao image, and jump to it:

fatload mmc 0 0x200000 bao.img; bootm start 0x200000; bootm loados; bootm go

You should see the firmware, bao and its guests printing on the UARTs.

At this point, depending on your demo, you might be able connect to one of the guests via ssh by connecting to the board's ethernet RJ45 socket.