6.2.1. Arm Juno Development Platform
6.2.1.1. Platform-specific build options
JUNO_TZMP1
: Boolean option to configure Juno to be used for TrustZone Media Protection (TZ-MP1). Default value of this flag is 0.
6.2.1.2. Running software on Juno
This version of TF-A has been tested on variants r0, r1 and r2 of Juno.
To run TF-A on Juno, you need to first prepare an SD card with Juno software
stack that includes TF-A. This version of TF-A is tested with pre-built
Linaro release software stack version 20.01. You can alternatively
build the software stack yourself by following the
Juno platform software user guide. Once you prepare the software stack
on an SD card, you can replace the bl1.bin
and fip.bin
binaries in the SOFTWARE/
directory with custom built TF-A binaries.
6.2.1.3. Preparing TF-A images
This section provides Juno and FVP specific instructions to build Trusted Firmware, obtain the additional required firmware, and pack it all together in a single FIP binary. It assumes that a Linaro release software stack has been installed.
Note
Pre-built binaries for AArch32 are available from Linaro Release 16.12 onwards. Before that release, pre-built binaries are only available for AArch64.
Warning
Follow the full instructions for one platform before switching to a different one. Mixing instructions for different platforms may result in corrupted binaries.
Warning
The uboot image downloaded by the Linaro workspace script does not always match the uboot image packaged as BL33 in the corresponding fip file. It is recommended to use the version that is packaged in the fip file using the instructions below.
Note
For the FVP, the kernel FDT is packaged in FIP during build and loaded by the firmware at runtime.
Clean the working directory
make realclean
Obtain SCP binaries (Juno)
This version of TF-A is tested with SCP version 2.8.0 on Juno. You can download pre-built SCP binaries (
scp_bl1.bin
andscp_bl2.bin
) from TF-A downloads page. Alternatively, you can build the binaries from source.Obtain BL33 (all platforms)
Use the fiptool to extract the BL33 image from the FIP package included in the Linaro release:
# Build the fiptool make [DEBUG=1] [V=1] fiptool # Unpack firmware images from Linaro FIP ./tools/fiptool/fiptool unpack <path-to-linaro-release>/[SOFTWARE]/fip.bin
The unpack operation will result in a set of binary images extracted to the current working directory. BL33 corresponds to
nt-fw.bin
.Note
The fiptool will complain if the images to be unpacked already exist in the current directory. If that is the case, either delete those files or use the
--force
option to overwrite.Note
For AArch32, the instructions below assume that nt-fw.bin is a normal world boot loader that supports AArch32.
Build TF-A images and create a new FIP for FVP
# AArch64 make PLAT=fvp BL33=nt-fw.bin all fip # AArch32 make PLAT=fvp ARCH=aarch32 AARCH32_SP=sp_min BL33=nt-fw.bin all fip
Build TF-A images and create a new FIP for Juno
For AArch64:
Building for AArch64 on Juno simply requires the addition of
SCP_BL2
as a build parameter.make PLAT=juno BL33=nt-fw.bin SCP_BL2=scp_bl2.bin all fip
For AArch32:
Hardware restrictions on Juno prevent cold reset into AArch32 execution mode, therefore BL1 and BL2 must be compiled for AArch64, and BL32 is compiled separately for AArch32.
Before building BL32, the environment variable
CROSS_COMPILE
must point to the AArch32 Linaro cross compiler.export CROSS_COMPILE=<path-to-aarch32-gcc>/bin/arm-linux-gnueabihf-
Build BL32 in AArch32.
make ARCH=aarch32 PLAT=juno AARCH32_SP=sp_min \ RESET_TO_SP_MIN=1 JUNO_AARCH32_EL3_RUNTIME=1 bl32
Save
bl32.bin
to a temporary location and clean the build products.cp <path-to-build>/bl32.bin <path-to-temporary> make realclean
Before building BL1 and BL2, the environment variable
CROSS_COMPILE
must point to the AArch64 Linaro cross compiler.export CROSS_COMPILE=<path-to-aarch64-gcc>/bin/aarch64-none-elf-
The following parameters should be used to build BL1 and BL2 in AArch64 and point to the BL32 file.
make ARCH=aarch64 PLAT=juno JUNO_AARCH32_EL3_RUNTIME=1 \ BL33=nt-fw.bin SCP_BL2=scp_bl2.bin \ BL32=<path-to-temporary>/bl32.bin all fip
The resulting BL1 and FIP images may be found in:
# Juno
./build/juno/release/bl1.bin
./build/juno/release/fip.bin
# FVP
./build/fvp/release/bl1.bin
./build/fvp/release/fip.bin
After building TF-A, the files bl1.bin
, fip.bin
and scp_bl1.bin
need to be copied to the SOFTWARE/
directory on the Juno SD card.
6.2.1.4. Booting Firmware Update images
The new images must be programmed in flash memory by adding
an entry in the SITE1/HBI0262x/images.txt
configuration file
on the Juno SD card (where x
depends on the revision of the Juno board).
Refer to the Juno Getting Started Guide, section 2.3 “Flash memory
programming” for more information. User should ensure these do not
overlap with any other entries in the file.
NOR10UPDATE: AUTO ;Image Update:NONE/AUTO/FORCE
NOR10ADDRESS: 0x00400000 ;Image Flash Address [ns_bl2u_base_address]
NOR10FILE: \SOFTWARE\fwu_fip.bin ;Image File Name
NOR10LOAD: 00000000 ;Image Load Address
NOR10ENTRY: 00000000 ;Image Entry Point
NOR11UPDATE: AUTO ;Image Update:NONE/AUTO/FORCE
NOR11ADDRESS: 0x03EB8000 ;Image Flash Address [ns_bl1u_base_address]
NOR11FILE: \SOFTWARE\ns_bl1u.bin ;Image File Name
NOR11LOAD: 00000000 ;Image Load Address
The address ns_bl1u_base_address is the value of NS_BL1U_BASE - 0x8000000. In the same way, the address ns_bl2u_base_address is the value of NS_BL2U_BASE - 0x8000000.
6.2.1.5. Booting an EL3 payload
If the EL3 payload is able to execute in place, it may be programmed in flash
memory by adding an entry in the SITE1/HBI0262x/images.txt
configuration file
on the Juno SD card (where x
depends on the revision of the Juno board).
Refer to the Juno Getting Started Guide, section 2.3 “Flash memory
programming” for more information.
Alternatively, the same DS-5 command mentioned in the FVP section above can be used to load the EL3 payload’s ELF file over JTAG on Juno.
For more information on EL3 payloads in general, see Booting an EL3 payload.
6.2.1.6. Booting a preloaded kernel image
The Trusted Firmware must be compiled in a similar way as for FVP explained above. The process to load binaries to memory is the one explained in plat_juno_booting_el3_payload.
6.2.1.7. Testing System Suspend
The SYSTEM SUSPEND is a PSCI API which can be used to implement system suspend to RAM. For more details refer to section 5.16 of PSCI. To test system suspend on Juno, at the linux shell prompt, issue the following command:
echo +10 > /sys/class/rtc/rtc0/wakealarm
echo -n mem > /sys/power/state
The Juno board should suspend to RAM and then wakeup after 10 seconds due to wakeup interrupt from RTC.
6.2.1.8. Additional Resources
Please visit the Arm Platforms Portal to get support and obtain any other Juno software information. Please also refer to the Juno Getting Started Guide to get more detailed information about the Juno Arm development platform and how to configure it.
Copyright (c) 2019-2023, Arm Limited. All rights reserved.