mirror of
https://github.com/ARM-software/arm-trusted-firmware.git
synced 2025-04-15 09:04:17 +00:00
c540769349
The Arm FVP documentation has grown organically over the years. As a
result, it has become a big document, which can be difficult to digest.
Also, the organization of some of the sections does not make sense. In
particular, all "Running on the ... FVP" sections live under a section
named "Booting a preloaded kernel image (Base FVP)". To illustrate this,
here is the current table of contents:
Arm Fixed Virtual Platforms (FVP)
Fixed Virtual Platform (FVP) Support
Arm FVP Platform Specific Build Options
Booting Firmware Update images
Booting an EL3 payload
Booting a preloaded kernel image (Base FVP)
Obtaining the Flattened Device Treesp
Running on the Foundation FVP with reset to BL1 entrypoint
Running on the AEMv8 Base FVP with reset to BL1 entrypoint
Running on the AEMv8 Base FVP (AArch32) with reset to BL1 entrypoint
Running on the Cortex-A57-A53 Base FVP with reset to BL1 entrypoint
Running on the Cortex-A32 Base FVP (AArch32) with reset to BL1 entrypoint
Running on the AEMv8 Base FVP with reset to BL31 entrypoint
Running on the AEMv8 Base FVP (AArch32) with reset to SP_MIN entrypoint
Running on the Cortex-A57-A53 Base FVP with reset to BL31 entrypoint
Running on the Cortex-A32 Base FVP (AArch32) with reset to SP_MIN entrypoint
This patch breaks down this document in sub-documents, which are now
included from the index file. The table of contents (ToC) reflects the
new documents hierarchy. The depth of the ToC has been reduced to
simplify the index page. Here is what it looks like now:
Arm Fixed Virtual Platforms (FVP)
Fixed Virtual Platform (FVP) Support
Arm FVP Platform Specific Build Options
Running on the Foundation FVP
Running on the AEMv8 Base FVP
Running on the Cortex-A57-A53 Base FVP
Running on the Cortex-A32 Base FVP (AArch32)
Booting Firmware Update images
Booting an EL3 payload
Booting a preloaded kernel image (Base FVP)
Apart from moving information around in separate files, this patch also
makes the following minor changes to the contents:
- Add a brief introduction about FVPs in the index page.
- Change some of the titles names for conciseness.
Signed-off-by: Sandrine Bailleux <sandrine.bailleux@arm.com>
Signed-off-by: Manish V Badarkhe <Manish.Badarkhe@arm.com>
Change-Id: Icb650e0ec2c7a86ccd6e7eea4e16a84c41442c96
42 lines
1.9 KiB
ReStructuredText
42 lines
1.9 KiB
ReStructuredText
Running on the Foundation FVP
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
The following ``Foundation_Platform`` parameters should be used to boot Linux with
|
|
4 CPUs using the AArch64 build of TF-A.
|
|
|
|
.. code:: shell
|
|
|
|
<path-to>/Foundation_Platform \
|
|
--cores=4 \
|
|
--arm-v8.0 \
|
|
--secure-memory \
|
|
--visualization \
|
|
--gicv3 \
|
|
--data="<path-to>/<bl1-binary>"@0x0 \
|
|
--data="<path-to>/<FIP-binary>"@0x08000000 \
|
|
--data="<path-to>/<kernel-binary>"@0x80080000 \
|
|
--data="<path-to>/<ramdisk-binary>"@0x84000000
|
|
|
|
Notes:
|
|
|
|
- BL1 is loaded at the start of the Trusted ROM.
|
|
- The Firmware Image Package is loaded at the start of NOR FLASH0.
|
|
- The firmware loads the FDT packaged in FIP to the DRAM. The FDT load address
|
|
is specified via the ``load-address`` property in the ``hw-config`` node of
|
|
`FW_CONFIG for FVP`_.
|
|
- The default use-case for the Foundation FVP is to use the ``--gicv3`` option
|
|
and enable the GICv3 device in the model. Note that without this option,
|
|
the Foundation FVP defaults to legacy (Versatile Express) memory map which
|
|
is not supported by TF-A.
|
|
- In order for TF-A to run correctly on the Foundation FVP, the architecture
|
|
versions must match. The Foundation FVP defaults to the highest v8.x
|
|
version it supports but the default build for TF-A is for v8.0. To avoid
|
|
issues either start the Foundation FVP to use v8.0 architecture using the
|
|
``--arm-v8.0`` option, or build TF-A with an appropriate value for
|
|
``ARM_ARCH_MINOR``.
|
|
|
|
--------------
|
|
|
|
*Copyright (c) 2019-2024, Arm Limited. All rights reserved.*
|
|
|
|
.. _FW_CONFIG for FVP: https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git/tree/plat/arm/board/fvp/fdts/fvp_fw_config.dts
|