1.1 Preparing the Linux Kernel using PetaLinux 2019.1

Zynq UltraScale plus MPSoC Power Management

Release Date
2023-04-24

1.1.1 Download the PetaLinux petalinux-v2019.1-final-installer.run and ZCU102 BSP for corresponding board.

Petalinux user guide. /settings.sh (e.g. source /scratch/Xilinx/PetaLinux/settings.sh) Note: Or use source /settings.csh command for c shell. Cross check that the PETALINUX environment variable is set to the above installation path echo $PETALINUX 1.1.1.3.Create the PetaLinux project in a working directory with the below command (cd /scratch/edt) petalinux-create -t project –s (e.g. petalinux-create -t project –s /home/jerrywo/Downloads/xilinx-zcu102-v2019.1-final.bsp) Change the directory to the created Petalinux project. (e.g. cd /scratch/edt/xilinx-zcu102-2019.1) 1.1.1.4.Initially configure the PetaLinux project with the corresponding hardware file. (The file may be copied to /scratch/edt/xilinx-zcu102-2019.1 from your Windows machine C:\zynqus\pwr\sw\pl_lib_wrapper_hw_platform\system.hdf) petalinux-config --get-hw-description= (e.g. petalinux-config --get-hw-description=/scratch/edt/xilinx-zcu102-2019.1)

When menu opens, enable FPGA Manager (leave hw path blank)

save and exit

1.1.2 System Configuration

(Nothing is changed by step 1.1.2, this step may be skipped.) Change directory to /xilinx-zcu102-2019.1 and enter the following command to configure Linux: (cd /scratch/edt/xilinx-zcu102-2018.1) petalinux-config

1.1.3 Kernel Configuration

(Nothing is changed by step 1.1.3, this step may be skipped.) Change directory to /xilinx-zcu102-2019.1 and enter the following command to configure the kernel: (cd /scratch/edt/xilinx-zcu102-2019.1) petalinux-config –c kernel

1.1.4 Rootfs Configuration

(Nothing is changed by step 1.1.4, this step may be skipped.) Change directory to /xilinx-zcu102-2019.1 and enter the following command to configure the rootfs: (cd /scratch/edt/xilinx-zcu102-2019.1) petalinux-config –c rootfs

1.1.5 Device Tree

(Nothing is changed by step 1.1.5, this step may be skipped.) Change directory to /xilinx-zcu102-2019.1/project-spec/meta-user/recipes-bsp/device-tree/files and edit system-user.dtsi: (cd /scratch/edt/xilinx-zcu102-2019.1/project-spec/meta-user/recipes-bsp/device-tree/files)

1.1.6 Building the apps, kernel and device tree blob

petalinux-create -t apps -n pl-power --enable Replace project-spec/meta-user/recipes-apps/pl-power with /software/recipes-apps/pl-power Change directory to /xilinx-zcu102-2019.1 and enter the following command to build the image.ub and BOOT.BIN under the images/linux/ folder. These two files are the ones that will be copied to the BOOT partition of the SD card. (cd /scratch/edt/xilinx-zcu102-2019.1) (Note: The GPIOs get assigned dynamically, so you may need to edit pl-power.c) petalinux-build -c pl-power petalinux-build -c rootfs petalinux-build (Note: Ignore the warning "PMU firmware is not built...")

Now I have to automatically run the fpgautil to download the full bitstream

petalinux-create -t apps --name startup --enableReplace project-spec/meta-user/recipes-apps/startup with /software/recipes-apps/startup petalinux-build cd /xilinx-zcu102-2019.1/images/linux (cd /scratch/edt/xilinx-zcu102-2019.1/images/linux) petalinux-package --boot --fsbl zynqmp_fsbl.elf --u-boot --force (Note: Ignore the warning "Unable to access the TFTPBOOT folder...") cd /hw/scripts Edit copy_pr_bits_bins.sh to change the paths per your installation source copy_pr_bits_bins.sh

1.2 Running the Linux Design from SD Image

The steps to run the Linux design from SD Image are as follows:
  • After Building the Linux Design in 1.1, Copy image.ub and BOOT.bin to a blank (FAT32 format) SD card.
  • Also copy C:\zynqus\pwr\sd\Terminals\*.bit.bin to the SD card. They contain the partial bitstreams (Vivado files).
  • Also copy C:\zynqus\pwr\sd\Terminals\pl-power-init.sh to the SD card.
  • Insert the SD card into the SD Card slot on the ZCU102, set Mode SW6 to Off-Off-Off-On, and power cycle the ZCU102.