Boot Image Setup in Vitis - 2024.2 English - UG1209

1. If the Vitis IDE is not already running, start it and set the workspace as indicated in Build Software for PS Subsystems.

2. Select Vitis → Create Boot Image.

3. Select Zynq Ultrascale+ as the Architecture.

4. Select the Create new BIF file option.

5. Ensure that the Output format is set to BIN.

6. In the Basic page, browse to and select the Output BIF file path and output path.

   

7. Next, add boot partitions using the following steps:

   1. Click the + button to open the Add Partition view.

   2. In the Add Partition view, click the Browse button to select the FSBL executable.

      1. For FSBL, ensure that the Partition type is selected as boot loader and the correct destination CPU is selected by the tool. The tool is configured to make this selection based on the FSBL executable.

         

      2. Ignore the Exception Level, as FSBL is set to EL3 by default. Also, leave the TrustZone setting unselected for this example.

      3. Click OK to select the FSBL and go back to the Create Boot Image wizard.

   3. Click the + button to open the Add Partition window to add the next partition.

   4. The next partition is the PMU firmware for the Platform Management Unit.

      1. Select the Partition type as datafile and the Destination Device as PS.

      2. Select PMU for Destination CPU.

      3. Click OK.

         

   5. The next partition to be added is the TF-A firmware. For this, set the Partition type to datafile.

      1. The TF-A executable bl31.elf can be found in the PetaLinux images folder <PetaLinux_project\/images/linux/.

      2. Select the Destination Device as PS and the Destination CPU as A53 0.

      3. Set the Exception Level to EL3 and select Enable TrustZone.

         

      4. Click OK.

   6. Click the + button to add the R5 bare-metal executable.

      1. Add the R5 executable and enable it in lockstep mode, as shown in the following image.

      2. Click OK.

         

   7. Click the + button to add the U-Boot partition. u-boot.elf can be found in <PetaLinux_Project>/images/linux/.

      1. For U-Boot, make the following selections:

         1. Set the Partition Type to datafile.

         2. Set the Destination Device to PS.

         3. Set the Destination CPU to A53 0.

         4. Set the Exception Level to EL2.

         

      2. Click OK.

   8. Click the + button to add the image.ub Linux image file.

      1. The image.ub image file can be found in PetaLinux project in the images/Linux directory.

      2. For image.ub, make the following selections:

         1. Set Partition Type to datafile.

         2. Set the Destination Device to PS.

         3. Set the Destination CPU to A53 0.

      3. Enter 0xF00000 as the offset.

      4. Leave Exception Level and TrustZone unselected.

   9. Click the + button to add the boot.scr script file.

      1. The boot.scr file is located in the images/linux directory of the PetaLinux project.

      2. For boot.scr, select the following:

         1. Set the partition type to datafile.

         2. Set the Destination Device to PS.

         3. Set the Destination CPU to A53 0.

      3. Enter 0x3e80000 as the offset.

      4. Leave Exception Level and TrustZone unselected.

         

8. Click Create Image to create the qspi_BOOT.bin image.

   You can also create qspi_BOOT.bin images using the BIF attributes and the Bootgen command. You can view the BIF attributes for this configuration by clicking Preview BIF Changes. For this configuration, the BIF file contains the following attributes:

   //arch = zynqmp; split = false; format = BIN
   the_ROM_image:
   {
   [bootloader, destination_cpu = a53-0]C:\edt\fsbl_a53\Debug\fsbl_a53.elf
   [destination_cpu = pmu]C:\edt\edt_zcu102_wrapper\export\edt_zcu102_wrapper\sw\edt_zcu102_wrapper\boot\pmufw.elf
   [destination_cpu = a53-0, exception_level = el-3, trustzone]C:\edt\qspi_boot\bl31.elf
   [destination_cpu = r5-lockstep]C:\edt\testapp_r5\Debug\testapp_r5.elf
   [destination_cpu = a53-0, exception_level = el-2]C:\edt\qspi_boot\u-boot.elf
   [offset = 0xF00000, destination_cpu = a53-0]C:\edt\qspi_boot\image.ub
   [offset = 0x3e80000, destination_cpu = a53-0]C:\edt\qspi_boot\boot.scr
   }
   

The Vitis IDE calls the following Bootgen command to generate the qspi_BOOT.bin image for this configuration.

bootgen -image qspi_boot.bif -arch zynqmp -o C:\edt\qspi_BOOT.bin``