mirror of
https://github.com/ARM-software/arm-trusted-firmware.git
synced 2025-04-16 01:24:27 +00:00
docs(msm8916): document new build options
Update the MSM8916 platform documentation with the new build options introduced in the previous changes: - AArch32 (BL32/SP_MIN) - UART selection While at it, also document the build options that allow changing the memory addresses (PRELOADED_BL33_BASE, BL31_BASE, BL32_BASE). Change-Id: I2370c8264982317693f69fda0b03a255f12bafe2 Signed-off-by: Stephan Gerhold <stephan@gerhold.net>
This commit is contained in:
Stephan Gerhold
Manish Pandey
parent
aad23f1a2c
commit
b4e49e3fe4
1 changed files with 98 additions and 20 deletions
|
|
@ -7,7 +7,7 @@ APQ8016(E), ...) that are all very similar. A popular device based on APQ8016E
|
|||
is the `DragonBoard 410c`_ single-board computer, but the SoC is also used in
|
||||
various mid-range smartphones/tablets.
|
||||
|
||||
The TF-A/BL31 port for MSM8916 provides a minimal, community-maintained
|
||||
The TF-A port for MSM8916 provides a minimal, community-maintained
|
||||
EL3 firmware. It is primarily based on information from the public
|
||||
`Snapdragon 410E Technical Reference Manual`_ combined with a lot of
|
||||
trial and error to actually make it work.
|
||||
|
|
@ -20,8 +20,7 @@ trial and error to actually make it work.
|
|||
|
||||
Functionality
|
||||
-------------
|
||||
|
||||
The BL31 port is much more minimal compared to the original firmware and
|
||||
The TF-A port is much more minimal compared to the original firmware and
|
||||
therefore expects the non-secure world (e.g. Linux) to manage more hardware,
|
||||
such as the SMMUs and all remote processors (RPM, WCNSS, Venus, Modem).
|
||||
Everything except modem is currently functional with a slightly modified version
|
||||
|
|
@ -41,28 +40,74 @@ will be added later once ready.
|
|||
|
||||
Boot Flow
|
||||
---------
|
||||
BL31 replaces the original ``tz`` firmware in the boot flow::
|
||||
BL31 (AArch64) or BL32/SP_MIN (AArch32) replaces the original ``tz`` firmware
|
||||
in the boot flow::
|
||||
|
||||
Boot ROM (PBL) -> SBL -> BL31 (EL3) -> U-Boot (EL2) -> Linux (EL2)
|
||||
|
||||
By default, BL31 enters the non-secure world in EL2 AArch64 state at address
|
||||
``0x8f600000``. The original hypervisor firmware (``hyp``) is not used, you can
|
||||
use KVM or another hypervisor. The entry address is fixed in the BL31 binary
|
||||
but can be changed using the ``PRELOADED_BL33_BASE`` make file parameter.
|
||||
After initialization the normal world starts at a fixed entry address in EL2/HYP
|
||||
mode, configured using ``PRELOADED_BL33_BASE``. At runtime, it is expected that
|
||||
the normal world bootloader was already loaded into RAM by a previous firmware
|
||||
component (usually SBL) and that it is capable of running in EL2/HYP mode.
|
||||
|
||||
Using an AArch64 bootloader (such as `U-Boot for DragonBoard 410c`_) is
|
||||
recommended. AArch32 bootloaders (such as the original Little Kernel bootloader
|
||||
from Qualcomm) are not directly supported, although it is possible to use an EL2
|
||||
shim loader to temporarily switch to AArch32 state.
|
||||
`U-Boot for DragonBoard 410c`_ is recommended if possible. The original Little
|
||||
Kernel-based bootloader from Qualcomm does not support EL2/HYP, but can be
|
||||
booted using an additional shim loader such as `tfalkstub`_.
|
||||
|
||||
Build
|
||||
-----
|
||||
It is possible to build for either AArch64 or AArch32. AArch64 is the preferred
|
||||
build option.
|
||||
|
||||
AArch64 (BL31)
|
||||
^^^^^^^^^^^^^^
|
||||
Setup the cross compiler for AArch64 and build BL31 for ``msm8916``::
|
||||
|
||||
$ make CROSS_COMPILE=aarch64-none-elf- PLAT=msm8916
|
||||
|
||||
The BL31 ELF image is generated in ``build/msm8916/release/bl31/bl31.elf``.
|
||||
|
||||
AArch32 (BL32/SP_MIN)
|
||||
^^^^^^^^^^^^^^^^^^^^^
|
||||
Setup the cross compiler for AArch32 and build BL32 with SP_MIN for ``msm8916``::
|
||||
|
||||
$ make CROSS_COMPILE=arm-none-eabi- PLAT=msm8916 ARCH=aarch32 AARCH32_SP=sp_min
|
||||
|
||||
The BL32 ELF image is generated in ``build/msm8916/release/bl32/bl32.elf``.
|
||||
|
||||
Build Options
|
||||
-------------
|
||||
Some options can be changed at build time by adding them to the make command line:
|
||||
|
||||
* ``QTI_UART_NUM``: Number of UART controller to use for debug output and crash
|
||||
reports. This must be the same UART as used by earlier boot firmware since
|
||||
the UART controller does not get fully initialized at the moment. Defaults to
|
||||
the usual debug UART used for the platform (see ``platform.mk``).
|
||||
* ``QTI_RUNTIME_UART``: By default (``0``) the UART is only used for the boot
|
||||
process and critical crashes. If set to ``1`` it is also used for runtime
|
||||
messages. Note that this option can only be used if the UART is reserved in
|
||||
the normal world and the necessary clocks remain enabled.
|
||||
|
||||
The memory region used for the different firmware components is not fixed and
|
||||
can be changed on the make command line. The default values match the addresses
|
||||
used by the original firmware (see ``platform.mk``):
|
||||
|
||||
* ``PRELOADED_BL33_BASE``: The entry address for the normal world. Usually
|
||||
refers to the first bootloader (e.g. U-Boot).
|
||||
* ``BL31_BASE``: Base address for the BL31 firmware component. Must point to
|
||||
a 64K-aligned memory region with at least 128 KiB space that is permanently
|
||||
reserved in the normal world.
|
||||
* ``BL32_BASE``: Base address for the BL32 firmware component.
|
||||
|
||||
* **AArch32:** BL32 is used in place of BL31, so the option is equivalent to
|
||||
``BL31_BASE``.
|
||||
* **AArch64:** Secure-EL1 Payload. Defaults to using 128 KiB of space
|
||||
directly after BL31. For testing only, the port is primarily intended as
|
||||
a minimal PSCI implementation without a separate secure world.
|
||||
|
||||
Installation
|
||||
------------
|
||||
First, setup the cross compiler for AArch64 and build TF-A for ``msm8916``::
|
||||
|
||||
$ make CROSS_COMPILE=aarch64-linux-gnu- PLAT=msm8916
|
||||
|
||||
The BL31 ELF image is generated in ``build/msm8916/release/bl31/bl31.elf``.
|
||||
This image must be "signed" before flashing it, even if the board has secure
|
||||
The ELF image must be "signed" before flashing it, even if the board has secure
|
||||
boot disabled. In this case the signature does not provide any security,
|
||||
but it provides the firmware with required metadata.
|
||||
|
||||
|
|
@ -75,6 +120,10 @@ use e.g. `qtestsign`_::
|
|||
Then install the resulting ``build/msm8916/release/bl31/bl31-test-signed.mbn``
|
||||
to the ``tz`` partition on the device. BL31 should be running after a reboot.
|
||||
|
||||
.. note::
|
||||
On AArch32 the ELF image is called ``bl32.elf``.
|
||||
The installation procedure is identical.
|
||||
|
||||
.. warning::
|
||||
Do not flash incorrectly signed firmware on devices that have secure
|
||||
boot enabled! Make sure that you have a way to recover the board in case
|
||||
|
|
@ -82,8 +131,11 @@ to the ``tz`` partition on the device. BL31 should be running after a reboot.
|
|||
|
||||
Boot Trace
|
||||
----------
|
||||
BL31 prints some lines on the debug console UART2, which will usually look like
|
||||
this (with ``DEBUG=1``, otherwise only the ``NOTICE`` lines are shown)::
|
||||
|
||||
AArch64 (BL31)
|
||||
^^^^^^^^^^^^^^
|
||||
BL31 prints some lines on the debug console, which will usually look like this
|
||||
(with ``DEBUG=1``, otherwise only the ``NOTICE`` lines are shown)::
|
||||
|
||||
...
|
||||
S - DDR Frequency, 400 MHz
|
||||
|
|
@ -109,8 +161,34 @@ this (with ``DEBUG=1``, otherwise only the ``NOTICE`` lines are shown)::
|
|||
Qualcomm-DragonBoard 410C
|
||||
...
|
||||
|
||||
AArch32 (BL32/SP_MIN)
|
||||
^^^^^^^^^^^^^^^^^^^^^
|
||||
BL32/SP_MIN prints some lines on the debug console, which will usually look like
|
||||
this (with ``DEBUG=1``, otherwise only the ``NOTICE`` lines are shown)::
|
||||
|
||||
...
|
||||
S - DDR Frequency, 400 MHz
|
||||
NOTICE: SP_MIN: v2.8(debug):v2.8
|
||||
NOTICE: SP_MIN: Built : 23:03:31, Mar 31 2023
|
||||
INFO: SP_MIN: Platform setup start
|
||||
INFO: ARM GICv2 driver initialized
|
||||
INFO: SP_MIN: Platform setup done
|
||||
INFO: SP_MIN: Initializing runtime services
|
||||
INFO: BL32: cortex_a53: CPU workaround for 819472 was applied
|
||||
INFO: BL32: cortex_a53: CPU workaround for 824069 was applied
|
||||
INFO: BL32: cortex_a53: CPU workaround for 826319 was applied
|
||||
INFO: BL32: cortex_a53: CPU workaround for 827319 was applied
|
||||
INFO: BL32: cortex_a53: CPU workaround for disable_non_temporal_hint was applied
|
||||
INFO: SP_MIN: Preparing exit to normal world
|
||||
INFO: Entry point address = 0x86400000
|
||||
INFO: SPSR = 0x1da
|
||||
Android Bootloader - UART_DM Initialized!!!
|
||||
[0] welcome to lk
|
||||
...
|
||||
|
||||
.. _Qualcomm Snapdragon 410: https://www.qualcomm.com/products/snapdragon-processors-410
|
||||
.. _DragonBoard 410c: https://www.96boards.org/product/dragonboard410c/
|
||||
.. _Snapdragon 410E Technical Reference Manual: https://developer.qualcomm.com/download/sd410/snapdragon-410e-technical-reference-manual.pdf
|
||||
.. _U-Boot for DragonBoard 410c: https://u-boot.readthedocs.io/en/latest/board/qualcomm/dragonboard410c.html
|
||||
.. _qtestsign: https://github.com/msm8916-mainline/qtestsign
|
||||
.. _tfalkstub: https://github.com/msm8916-mainline/tfalkstub
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue