Scope of Work

The purpose of this page is to describe how to boot ZCU102 using USB boot mode. Here two ZCU102 boards are connected back-to-back and configured as USB Host and Device. This can be done by setting ZCU102 device board in USB Boot mode and using DFU utility. Binaries like PMUFW, FSBL, U-Boot, ATF, Linux kernel, Device Tree and Rootfs are downloaded through DFU utility from Host.

1 Introduction
2 Prerequisites
3 HW Test Environment
- 3.1 ZCU102 Host
- 3.2 ZCU102 Device
4 Test Version
5 Software Build Procedure
- 5.1 PetaLinux Tool Steps
  - 5.1.1 Create and Configure PetaLinux Project
    - 5.1.1.1 Create PetaLinux Project
    - 5.1.1.2 Configure PetaLinux
  - 5.1.2 Build PetaLinux with dfu-util utility for ZCU102 Host
    - 5.1.2.1 Add dfu-util utility to user-rootfsconfig file
    - 5.1.2.2 Enable dfu-util utility in rootfs
    - 5.1.2.3 Build PetaLinux
  - 5.1.3 Build PetaLinux with Device Mode changes for ZCU102 Device
    - 5.1.3.1 Enable Device Mode
    - 5.1.3.2 Build PetaLinux
- 5.2 Vitis Tool Steps
  - 5.2.1 Create FSBL Application Project
  - 5.2.2 Configure FSBL to Enable USB Boot Mode
  - 5.2.3 Create Boot Image with FSBL
  - 5.2.4 Create Boot Image with U-Boot
6 Test Procedure
- 6.1 Boot ZCU102 Host
- 6.2 Check DFU detection on Host
- 6.3 Download Binaries to Device
  - 6.3.1 Download PMUFW and FSBL
  - 6.3.2 Download U-Boot and ATF
  - 6.3.3 Enable Rootfs Download on Device
  - 6.3.4 Download Linux Image
  - 6.3.5 Download DTB
  - 6.3.6 Download ROOTFS
- 6.4 Boot ZCU102 Device
7 References

Introduction

Zynq UltraScale+ MPSoC, the next generation Zynq device, comes with a versatile Processing System (PS) integrated with a highly flexible and high-performance Programmable Logic (PL) section, all on a single system-on-a-chip (SoC).

Zynq Ultrascale+ MPSoC also supports USB Slave Boot Mode. This is using the USB DFU Device Firmware Upgrade (DFU) Device Class Specification of USB. Using a standard update utility such as DFU-Util, you will be able to load the newly created image on Zynq UltraScale+ via the USB Port of another Zynq Ultrascale+

Prerequisites

Vitis Tool
PetaLinux
Back-to-Back USB 3.0 Cable
Two ZCU102 boards

HW Test Environment

Connect two ZCU102 boards using USB 3.0 back-to-back setup. One in host mode and another in device mode.

ZCU102 Host

Jumper settings for Host mode

J7 - 1-2 Close
J113 - 1-2 Close
J110 - 2-3 Close

Please refer the image below for Host Mode jumper settings

ZCU102 Device

Jumper settings for Peripheral mode

J7 – 1-2 Open
J113 - 1-2 Close
J110 - 1-2 Close
Set USB Boot mode by setting SW6 (1-OFF, 2-OFF, 3-OFF, and 4-ON) as shown below

Please refer the image below for Device Mode jumper settings

Please refer image below for Switch settings to set Device in USB Boot mode

Please refer the image below for ZCU102 USB Back-to-Back setup

Test Version

Example tested with Vitis 2021.1
PetaLinux Project is based on 2021.1

Software Build Procedure

The following procedure is for USB Non Secure Boot Mode. The process to create Secure Binaries and Boot via USB DFU will be added to this wiki in future.

PetaLinux Tool Steps

Create and Configure PetaLinux Project

Create PetaLinux Project

Create PetaLinux project with 2021.1 bsp using the command below

$ petalinux-create --type project --name <PROJECT_NAME> --source <petalinux-v2021.1-BSP path>

Configure PetaLinux

Configure PetaLinux with command below

$ petalinux-config

Save and Exit to create petalinux-config file.

Build PetaLinux with dfu-util utility for ZCU102 Host

Add dfu-util utility to user-rootfsconfig file

Enable dfu-util in PetaLinux
Add CONFIG_dfu-util to the last line of <PetaLinux Project>/project-spec/meta-user/conf/user-rootfsconfig

Please refer the below sample file

#Note: Mention Each package in individual line
#These packages will get added into rootfs menu entry

CONFIG_gpio-demo
CONFIG_peekpoke
CONFIG_dfu-util

Enable dfu-util utility in rootfs

$ petalinux-config -c rootfs

petalinux-config -c rootfs ->Configuration ->user packages ->dfu-util
Select “dfu-util” in “user-packages”. Please refer to the image below,

Build PetaLinux

Build PetaLinux with changes

$ petalinux-build

Create a copy of host binaries

$ cp images images_host -rf

Build PetaLinux with Device Mode changes for ZCU102 Device

Disable “dfu-util” in petalinux-config -c rootfs

Enable Device Mode

Modify PetaLinux U-Boot so that it can load the linux images. The Device tree needs to be modified to set USB in the peripheral mode. The default PetaLinux configuration is set for the USB in Host mode.

For this, follow the below steps to modify system-user.dtsi in the PetaLinux Project

Add the following code to <PetaLinux-project>/project-spec/meta-user/recipes-bsp/device-tree/files/system-user.dtsi, so that it looks like:

/include/ "system-conf.dtsi"
/ {
};

&dwc3_0 {
        status = "okay";
        dr_mode = "peripheral";
        maximum-speed = "super-speed";
};

Build PetaLinux

Build PetaLinux with changes.

$ petalinux-build

Vitis Tool Steps

Create FSBL Application Project

Use the information provided below to make your selections in the wizard. Please refer to the image below,

In Vitis, select File > New > Application Project to open the New Project wizard.
Create new platform from hardware(XSA) from <PetaLinux Project>/project-spec/hw-description/system.xsa file. Please refer to the image below,

Provide Application Project Name, please refer below image

Select Zynq MP FSBL template, please refer below image

Click Finish

Configure FSBL to Enable USB Boot Mode

In the Project Explorer tab, expand the fsbl_usb_boot project and open xfsbl_config.h from: fsbl_usb_boot > src > xfsbl_config.h
In xfsbl_config.h change or set following settings:
#define FSBL_QSPI_EXCLUDE_VAL (1U) #define FSBL_SD_EXCLUDE_VAL (1U) #define FSBL_USB_EXCLUDE_VAL (0U)
Use CTRL + S to save these changes
Select Release and Build FSBL (fsbl_usb_boot)

Please refer image below for reference

Create Boot Image with FSBL

In this section, you will create the Boot Images to be loaded, via USB using DFU utility. Device Firmware Upgrade (DFU) is intended to download and upload firmware to/from devices connected over USB. In this boot mode, the Boot loader (FSBL) and the PMUFW which are loaded by Boot ROM are copied to ZCU102 Device’s On Chip Memory (OCM) from ZCU102 Host’s USB port using DFU Utility. The size of OCM (256 KB) limits the size of boot image downloaded by BootROM in USB boot mode. Considering this, and subject to size requirement being met, only FSBL and PMUFW are stitched into the first BOOT.bin, which is copied to OCM. Rest of the Boot partitions will be stitched in another Boot image and copied to DDR to be loaded by the FSBL which is already loaded and running at this stage.

Follow the below steps to Create Boot Images for this boot mode.

In Vitis, select Xilinx > Create Boot Image.
BOOT.bin can be created either by Import from existing BIF file or Create new BIF file
Import from existing BIF file can be used by providing the BOOT.bif as input and files path can be edited accordingly.
Please refer the BOOT.bif code provided below for reference.

//arch = zynqmp; split = false; format = BIN
the_ROM_image:
{
    [bootloader, destination_cpu = a53-0]/home/fsbl_usb_boot.elf
    [destination_cpu = pmu]/home/pmufw.elf
}

Ensure that Architecture is “Zynq MP” and PMU Partition’s Destination CPU is set to “PMU”

To create a new BIF file, select Create new BIF file and add the fsbl_usb_boot.elf and pmu_fw.elf partitions.
Select FSBL from <Vitis workspace path>/fsbl_usb_boot/Release/fsbl_usb_boot.elf

Select PMUFW from <PetaLinux Project>/images/linux/pmufw.elf
PetaLinux <PetaLinux Project>/pre-built/linux/images/pmufw.elf can also be used to create BOOT.bin

Select FSBL and PMUFW partitions and set them as shown in the following figure.

Click on Create Image to generate BOOT.bin

Create Boot Image with U-Boot

The following steps describe how to create usb_boot.bin.

In Vitis, select Xilinx > Create Boot Image.
usb_boot.bin can be created either from Import from existing BIF file or Create new BIF file
Import from existing BIF file can be used by providing the usb_boot.bif as input and files path can be edited accordingly.
Please refer the usb_boot.bif code provided below for reference.

//arch = zynqmp; split = false; format = BIN
the_ROM_image:
{
    [bootloader, destination_cpu = a53-0]/home/fsbl_usb_boot.elf
    [destination_cpu = pmu]/home/pmufw.elf
    [destination_cpu = a53-0, exception_level = el-3, trustzone]/home/bl31.elf
    [destination_cpu = a53-0, exception_level = el-2]/home/u-boot.elf
    [load = 0x100000, destination_cpu = a53-0]/home/system.dtb
}

To create a new BIF file, select Create new BIF file and add the fsbl_usb_boot.elf, pmu_fw.elf, bl31.elf, u-boot.elf and system.dtb partitions.
Select FSBL from <Vitis workspace path>/fsbl_usb_boot/Release/fsbl_usb_boot.elf
Select PMUFW from <PetaLinux Project>/images/linux/pmufw.elf

Ensure that you have set the correct exception levels for ATF (EL-3, Trustzone) and U-Boot (EL-2) partitions. These settings can be ignored for other partitions.

Select ATF from <PetaLinux Project>/images/linux/bl31.elf. Please refer below image,

Select U-BOOT from <PetaLinux Project>/images/linux/u-boot.elf. Please refer below image,

Select DTB from <PetaLinux Project>/images/linux/system.dtb. Please refer below image,

Select the partitions and set them as shown in the following figure.

Click on Create Image to generate usb_boot.bin

In addition to BOOT.bin and usb_boot.bin, binaries like Image, rootfs.cpio.gz.u-boot and system.dtb are required to boot the Device. These binaries can be loaded by DFU utility separately.

Test Procedure

Boot ZCU102 Host

Boot Host with dfu-util enabled PetaLinux images.
Copy Device’s binaries (BOOT.bin, usb_boot.bin, Image, rootfs.cpio.gz.u-boot and system.dtb) to SD Card and insert it into SD slot of Host.

Check DFU detection on Host

Check if the Host’s DFU can detect the USB target.

[  147.619619] usb 1-1: new high-speed USB device number 2 using xhci-hcd
[  147.772135] usb 1-1: New USB device found, idVendor=03fd, idProduct=0050, bcdDevice= 1.00
[  147.780313] usb 1-1: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[  147.787444] usb 1-1: Product: Xilinx DFU Downloader
[  147.792321] usb 1-1: Manufacturer: XILINX
[  147.796328] usb 1-1: SerialNumber: 2A49876D9CC1AA4
root@xilinx-zcu102-2021_1:~# dfu-util -l
dfu-util 0.9

Copyright 2005-2009 Weston Schmidt, Harald Welte and OpenMoko Inc.
Copyright 2010-2016 Tormod Volden and Stefan Schmidt
This program is Free Software and has ABSOLUTELY NO WARRANTY
Please report bugs to http://sourceforge.net/p/dfu-util/tickets/
Found DFU: [03fd:0050] ver=0100, devnum=3, cfg=1, intf=0, path="1-1", alt=0, name="Xilinx DFU Downloader", serial="2A49876D9CC1AA4"

If you do not see the ‘Found DFU’ message, verify the connection and retry.

Download Binaries to Device

Download PMUFW and FSBL

ZCU102 Host	ZCU102 Device

ZCU102 Host	ZCU102 Device
Use the command below to download BOOT.bin to Device `root@xilinx-zcu102-2021_1:~# dfu-util -d 03fd:0050 -D BOOT.bin`	Verify from Device’s Serial Terminal whether the FSBL is loaded successfully. `Xilinx Zynq MP First Stage Boot Loader Release 2021.1 Apr 15 2021 - 13:29:46`

As Device mode is enabled in FSBL, after FSBL gets loaded, USB DFU will be re-enumerated on Host.

Download U-Boot and ATF

ZCU102 Host	ZCU102 Device

ZCU102 Host

ZCU102 Device

Use the command below to download usb_boot.bin to Device

root@xilinx-zcu102-2021_1:~# dfu-util -d 03fd:0050 -D usb_boot.bin

Check UART 0 terminal and wait until U-Boot loads.

On U-Boot prompt, press Enter key to terminate autoboot.

PMU Firmware 2021.1	Mar 24 2021   17:58:53
PMU_ROM ê
ATF running on XCZU9EG/silicon v4/RTL5.1 at 0xfffea000
NOTICE:  BL31: v2.2(release):xilinx-v2020.2
NOTICE:  BL31: Built : 16:49:36, Apr  8 2021

U-Boot 2021.01 (Feb 02 2021 - 16:42:22 +0000)

Model: ZynqMP ZCU102 Rev1.0
Board: Xilinx ZynqMP
DRAM:  4 GiB
PMUFW:	v1.1
EL Level:	EL2
Chip ID:	zu9eg
NAND:  0 MiB
MMC:   mmc@ff170000: 0
In:    serial
Out:   serial
Err:   serial
Bootmode: USB_MODE
Reset reason:	EXTERNAL 
Net:   
ZYNQ GEM: ff0e0000, mdio bus ff0e0000, phyaddr 12, interface rgmii-id

Warning: ethernet@ff0e0000 (eth0) using random MAC address - 42:fe:41:9a:7a:30
eth0: ethernet@ff0e0000
Hit any key to stop autoboot:  2 1 0

Enable Rootfs Download on Device

On Device’s U-Boot console, modify dfu_ram_info to enable rootfs download via DFU.

ZynqMP> setenv dfu_ram_info "setenv dfu_alt_info Image ram 0x80000 $kernel_size_r\\;system.dtb ram $fdt_addr_r $fdt_size_r\\;rootfs.cpio.gz.u-boot ram 0x7000000 0x10000000"

Verify the dfu_ram_info using printenv.

ZynqMP> printenv dfu_ram_info
dfu_ram_info=setenv dfu_alt_info Image ram 0x80000 0x10000000\;system.dtb ram 0x40000000 0x400000\;rootfs.cpio.gz.u-boot ram 0x7000000 0x10000000

Download Linux Image

ZCU102 Device	ZCU102 Host

ZCU102 Device

ZCU102 Host

On Device’s U-Boot console start DFU_RAM to download Linux Image

After executing the command below, Device gets detected on Host

ZynqMP> run dfu_ram

Check if the DFU can detect the USB target.

root@xilinx-zcu102-2021_1:~# dfu-util -l
dfu-util 0.9

Copyright 2005-2009 Weston Schmidt, Harald Welte and OpenMoko Inc.
Copyright 2010-2016 Tormod Volden and Stefan Schmidt
This program is Free Software and has ABSOLUTELY NO WARRANTY
Please report bugs to http://sourceforge.net/p/dfu-util/tickets/

Found DFU: [03fd:0300] ver=0223, devnum=2, cfg=1, intf=0, path="2-1", alt=2, name="rootfs.cpio.gz.u-boot", serial="UNKNOWN"
Found DFU: [03fd:0300] ver=0223, devnum=2, cfg=1, intf=0, path="2-1", alt=1, name="system.dtb", serial="UNKNOWN"
Found DFU: [03fd:0300] ver=0223, devnum=2, cfg=1, intf=0, path="2-1", alt=0, name="Image", serial="UNKNOWN"

Please note down the “alt” parameter from the above log(dfu-util -l).

…alt=2, name="rootfs.cpio.gz.u-boot”

…alt=1, name="system.dtb"

…alt=0, name="Image"

Use the corresponding “alt” parameter value to download specific Image/system.dtb/rootfs.cpio.gz.u-boot.gz

Please refer the log below

Download Linux Image using following command

root@xilinx-zcu102-2021_1:~# dfu-util -d 03fd:0300 -D Image --alt 0
dfu-util 0.9

Copyright 2005-2009 Weston Schmidt, Harald Welte and OpenMoko Inc.
Copyright 2010-2016 Tormod Volden and Stefan Schmidt
This program is Free Software and has ABSOLUTELY NO WARRANTY
Please report bugs to http://sourceforge.net/p/dfu-util/tickets/

dfu-util: Invalid DFU suffix signature
dfu-util: A valid DFU suffix will be required in a future dfu-util release!!!
Opening DFU capable USB device...
ID 03fd:0300
Run-time device DFU version 0110
Claiming USB DFU Interface...
Setting Alternate Setting #0 ...
Determining device status: state = dfuIDLE, status = 0
dfuIDLE, continuing
DFU mode device DFU version 0110
Device returned transfer size 4096
Copying data from PC to DFU device

Download [=========================] 100%     32000512 bytes
Download done.
state(7) = dfuMANIFEST, status(0) = No error condition is present
state(2) = dfuIDLE, status(0) = No error condition is present
Done!

After successful download of Linux Image, execute CTRL+C on U-Boot console to stop dfu_ram.

ZynqMP> run dfu_ram
##DOWNLOAD ... OK
Ctrl+C to exit ...

Download DTB

ZCU102 Device	ZCU102 Host

ZCU102 Device

ZCU102 Host

On Device’s U-Boot console start DFU_RAM to download system.dtb

After executing the command below, Device gets detected on Host

ZynqMP> run dfu_ram

Download system.dtb using following command from Host

root@xilinx-zcu102-2021_1:~# dfu-util -d 03fd:0050 -D system.dtb --alt 1

After successful download of Linux Image, execute CTRL+C on U-Boot console to stop dfu_ram.

ZynqMP> run dfu_ram
##DOWNLOAD ... OK
Ctrl+C to exit ...

Download ROOTFS

ZCU102 Device	ZCU102 Host

ZCU102 Device

ZCU102 Host

On Device’s U-Boot console start DFU_RAM to download rootfs.cpio.gz.u-boot

After executing the command below, Device gets detected on Host

ZynqMP> run dfu_ram

Download rootfs.cpio.gz.u-boot using following command from Host

root@xilinx-zcu102-2021_1:~# dfu-util -d 03fd:0050 -D rootfs.cpio.gz.u-boot --alt 2

After successful download of Linux Image, execute CTRL+C on U-Boot console to stop dfu_ram.

ZynqMP> run dfu_ram
##DOWNLOAD ... OK
Ctrl+C to exit ...

Boot ZCU102 Device

On Device, Boot Linux with booti command on U-Boot Console.

ZynqMP> booti 0x80000 0x7000000 0x40000000

References

https://www.xilinx.com/support/documentation/sw_manuals/xilinx2020_1/ug1209-embedded-design-tutorial.pdf

Xilinx Wiki

USB Boot example using ZCU102 Host and ZCU102 Device

Table of Contents

Introduction

Prerequisites

HW Test Environment

ZCU102 Host

ZCU102 Device

Test Version

Software Build Procedure

PetaLinux Tool Steps

Create and Configure PetaLinux Project

Create PetaLinux Project

Configure PetaLinux

Build PetaLinux with dfu-util utility for ZCU102 Host

Add dfu-util utility to user-rootfsconfig file

Enable dfu-util utility in rootfs

Build PetaLinux

Build PetaLinux with Device Mode changes for ZCU102 Device

Enable Device Mode

Build PetaLinux

Vitis Tool Steps

Create FSBL Application Project

Configure FSBL to Enable USB Boot Mode

Create Boot Image with FSBL

Create Boot Image with U-Boot

Test Procedure

Boot ZCU102 Host

Check DFU detection on Host

Download Binaries to Device

Download PMUFW and FSBL

Download U-Boot and ATF

Enable Rootfs Download on Device

Download Linux Image

Download DTB

Download ROOTFS

Boot ZCU102 Device

References

Related content