Boot Configurations; Generating The Image File; Qspi Flash Boot; Preparing The Hardware - Enclustra Mars ZX2 User Manual

4 Boot Configurations

Once a software application has been developed and tested, this can be used to build a boot image for
the module.
The boot image contains the FSBL, the bitstream for programming the PL and the software bare-metal
application.
In order to use a software application for the boot image, the code must be mapped for execution from
the external DDR memory. If the program is mapped to the on-chip memory, it will overwrite the boot
loader during execution.
For a fast test of the boot configurations, the pre-generated .bin images may be used for boot, instead
of rebuilding the image. You need to select the file corresponding to the Mars ZX2 SoC module variant.
Pre-generated binaries for any ZX2 variant are released on the ZX2 Reference Design Github page.
4.0.1

Generating the Image File

Step Description
1 Create the boot image from Xilinx Vitis 2022.1 (see Figure 6):
1. Right click on the system project of the application in the Project Explorer
2. Select Create Boot Image
An image will be created for example in <workspace>\HelloWorld\_system\_ide\
bootimage\BOOT.bin.
Table 8: Generating the Boot Image File Step-by-Step Guide
Beside the methods presented in this section, there are additional methods how a boot device can be
programmed. Please refer to the Enclustra Build Environment's User Documentation for details [7].
4.1

QSPI Flash Boot

4.1.1

Preparing the Hardware

Step Description
1 Remove the power supply from the Mars ST3 base board (see label
2 Enable the QSPI flash boot mode by setting the configuration DIP switches on the Mars ST3
base board as follows (see labels
CFG = [1: ON, 2: OFF, 3: ON, 4: OFF]
3 Connect the 12 V DC power supply plug to the power connector of the Mars ST3 base board
(see label 12 V DC
Table 9: Preparing the Hardware for QSPI Flash Boot Mode Step-by-Step Guide
D-0000-489-003
Create Image
CFG in Figure 2):
in Figure 2).
16 / 25
12 V DC in Figure 2).
Version 2022.1_v2.0.1, 15.10.2022