Packaging Images with Ext4 rootfs in the Vitis IDE - 2020.2 English

Vitis Unified Software Platform Documentation: Application Acceleration Development (UG1393)
Document ID
UG1393
Release Date
2021-03-22
Version
2020.2 English
When ext4 rootfs is provided to the Vitis IDE, the generated sd_card.img file includes the following:
  • The xclbin file for PL kernel
  • The host application
  • The Linux kernel image
  • The device tree
  • The u-boot configuration file: boot.scr
  • The platform initialization script init.sh and platform name in platform_desc.txt.
    Note: init.sh sets up the environment variable XILINX_XRT and copies the platform_desc.txt file to /etc/xocl.txt. This must be executed manually.
  • The ext4 rootfs in the Ext4 partition

To package an image with Ext4 rootfs in the Vitis IDE:

  1. Select File > New > Application Project to create a new application project in the Vitis IDE.
  2. Select the platform (for example, xilinx_zcu102_base_202010_1), and click Next.
  3. Provide a name for the application project (for example, vadd)
  4. For the System Project selection, select Create New.
  5. For the Target processor, select the processor that can run the Linux domain (for example, psu_cortexa53 SMP), and click Next.
  6. In the Domain page, select xrt and provide the following application settings:
    • Sysroot path (for example, xilinx-zynqmp-common-v2020.1/sysroots/aarch64-xilinx-linux)
    • Root FS (for example, xilinx-zynqmp-common-v2020.1/rootfs.ext4)
    • Kernel Image (for example, xilinx-zynqmp-common-v2020.1/Image)
  7. Click Next.
  8. Select an application template (for example, Vector Addition) and click Finish.
  9. Select the system project and click the Build () button to build the project.
  10. Verify that the sd_card.img file was created in the package directory under the Emulation-SW, Emulation-HW or Hardware directory.
Tip: To change the path for sysroot, rootfs, or kernel after the application project has been created, double-click the .sprj file and change the path in the Options dialog box.