u-boot/doc/arch
Abdellatif El Khlifi 39d383bdac arm_ffa: introduce Arm FF-A support
Add Arm FF-A support implementing Arm Firmware Framework for Armv8-A v1.0

The Firmware Framework for Arm A-profile processors (FF-A v1.0) [1]
describes interfaces (ABIs) that standardize communication
between the Secure World and Normal World leveraging TrustZone
technology.

This driver uses 64-bit registers as per SMCCCv1.2 spec and comes
on top of the SMCCC layer. The driver provides the FF-A ABIs needed for
querying the FF-A framework from the secure world.

The driver uses SMC32 calling convention which means using the first
32-bit data of the Xn registers.

All supported ABIs come with their 32-bit version except FFA_RXTX_MAP
which has 64-bit version supported.

Both 32-bit and 64-bit direct messaging are supported which allows both
32-bit and 64-bit clients to use the FF-A bus.

FF-A is a discoverable bus and similar to architecture features.
FF-A bus is discovered using ARM_SMCCC_FEATURES mechanism performed
by the PSCI driver.

Clients are able to probe then use the FF-A bus by calling the DM class
searching APIs (e.g: uclass_first_device).

The Secure World is considered as one entity to communicate with
using the FF-A bus. FF-A communication is handled by one device and
one instance (the bus). This FF-A driver takes care of all the
interactions between Normal world and Secure World.

The driver exports its operations to be used by upper layers.

Exported operations:

- ffa_partition_info_get
- ffa_sync_send_receive
- ffa_rxtx_unmap

Generic FF-A methods are implemented in the Uclass (arm-ffa-uclass.c).
Arm specific methods are implemented in the Arm driver (arm-ffa.c).

For more details please refer to the driver documentation [2].

[1]: https://developer.arm.com/documentation/den0077/latest/
[2]: doc/arch/arm64.ffa.rst

Signed-off-by: Abdellatif El Khlifi <abdellatif.elkhlifi@arm.com>
Reviewed-by: Simon Glass <sjg@chromium.org>
Reviewed-by: Ilias Apalodimas <ilias.apalodimas@linaro.org>
Cc: Tom Rini <trini@konsulko.com>
Cc: Jens Wiklander <jens.wiklander@linaro.org>
Cc: Heinrich Schuchardt <xypron.glpk@gmx.de>
2023-08-08 10:22:03 -04:00
..
sandbox Revert "Merge branch '2023-07-24-introduce-FF-A-suppport'" 2023-07-24 19:51:05 -04:00
arc.rst doc: arch: Convert README.ARC to reST 2019-07-24 10:10:04 -04:00
arm64.ffa.rst arm_ffa: introduce Arm FF-A support 2023-08-08 10:22:03 -04:00
arm64.rst vexpress64: Add ARMv8R-64 board variant 2022-04-01 15:03:03 -04:00
index.rst arm_ffa: introduce Arm FF-A support 2023-08-08 10:22:03 -04:00
m68k.rst doc: arch: m68k: fix maintainer email 2023-04-06 19:10:08 -04:00
mips.rst doc: arch: Convert README.mips to reST 2019-07-24 10:07:24 -04:00
nios2.rst global: Move remaining CONFIG_SYS_SDRAM_* to CFG_SYS_SDRAM_* 2022-12-05 16:06:07 -05:00
riscv.rst doc: arch: Add document for RISC-V architecture 2023-02-19 21:15:15 +01:00
sh.rst sh: Remove r7780mp board 2021-02-15 10:16:23 -05:00
x86.rst global: Migrate CONFIG_EXTRA_ENV_SETTINGS to CFG 2022-12-23 10:09:42 -05:00
xtensa.rst doc: arch: Convert README.xtensa to reST 2019-07-24 10:10:12 -04:00