Configuring U-Boot Boot Script (boot.scr)

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

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID

UG1144

Release Date

2023-10-18

Version

2023.2 English

Change into the root directory of your PetaLinux project.
```
cd <plnx-proj-root>
```
Launch the top level system configuration menu.
```
petalinux-config
```
Select u-boot Configuration > u-boot script configuration.

In the U-Boot script configuration submenu, you have the following options:

To append memory/DDR base address to provided offsets, 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.
Example: The following screen shot is for AMD Versal™ load address.

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 adaptive SoC	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 offset are used by PetaLinux for the boot.scr on the QSPI/OSPI boot:

Table 2. Default offset on QSPI/OSPI Boot
Device	offset of boot.scr
Zynq UltraScale+ MPSoC	0x3E80000
Versal adaptive SoC	0x7F80000
Zynq 7000 devices	0xFC0000
MicroBlaze processors	0xFC0000

Note: You should check and update offset which is specified in petalinux-config → u-boot Configuration → u-boot script configuration QSPI/OSPI fit image offset should be match with the kernel offset in petalinux-config → Subsystem AUTO Hardware Settings → Flash Settings. If they do not match, the process can fail at U-Boot prompt.

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 offsets are used by PetaLinux for the boot.scr on the NAND boot:

Table 3. Default Offset on NAND Boot
Device	Offset of boot.scr
Zynq UltraScale+ MPSoC	0x3E80000
Versal adaptive SoC	0x7F80000
Zynq 7000 devices	0xFC0000
MicroBlaze processors	0xFC0000