Configuring U-Boot Boot Script (boot.scr) - 2021.2 English

PetaLinux Tools Documentation: Reference Guide
Document ID
UG1144
Release Date
2021-10-27
Version
2021.2 English
  1. Change into the root directory of your PetaLinux project.
    $ cd <plnx-proj-root>
  2. Launch the top level system configuration menu. 
    $ petalinux-config
  3. Select u-boot Configuration > u-boot script configuration.
  4. In the u-boot script configuration submenu, you have the following options:

    • To append provided offsets to the memory/DDR base address, select [*] Append base address to image offsets. PetaLinux reads the DDR base address from the hardware file and appends it to the offsets provided. This is enabled by default.
    • To add any U-Boot environment variables which have to be executed before the boot command, select () Pre bootenv.
    • To check/modify the JTAG/DDR offsets, use JTAG/DDR image offsets –->. These are used in the JTAG boot mode and also to load the images from flash/storage to the DDR memory.
      Note: By default, the following load addresses are used by PetaLinux for the boot.scr on the JTAG boot:
      Table 1. Default Load Address on JTAG Boot
      Device Load Address of boot.scr
      Zynq UltraScale+ MPSoC and Versal ACAP DDR base address + 0x20000000
      Zynq-7000 devices DDR base address + 0x3000000
      MicroBlaze processors (DDR base address + DDR size) - 0xe00000


    • To check/modify the QSPI/OSPI offsets/sizes, use QSPI/OSPI image offsets  ---> configuration menu. Make sure the specified offsets/sizes do not overlap with boot.scr or image to image.
      Note: By default, the following load addresses are used by PetaLinux for the boot.scr on the QSPI/OSPI boot:
      Table 2. Default Load Address on QSPI/OSPI Boot
      Device Load Address of boot.scr
      Zynq UltraScale+ MPSoC 0x3E80000
      Versal ACAP 0x7F80000
      Zynq-7000 devices 0xFC0000
      MicroBlaze processors 0x1F00000


    • To check/modify the NAND offsets/sizes, use the NAND image offsets –-> configuration menu. Make sure the specified offsets/sizes do not overlap with the boot.scr or image to image.
      Note: By default, the following load addresses are used by PetaLinux for the boot.scr on the NAND boot:
      Table 3. Default Load Address on NAND Boot
      Device Load Address of boot.scr
      Zynq UltraScale+ MPSoC 0x3E80000
      Versal ACAP 0x7F80000
      Zynq-7000 devices 0xFC0000
      MicroBlaze processors 0x1F00000