u-boot/include/dm
Abdellatif El Khlifi c09bfc666c 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>
Cc: Tom Rini <trini@konsulko.com>
Cc: Ilias Apalodimas <ilias.apalodimas@linaro.org>
Cc: Jens Wiklander <jens.wiklander@linaro.org>
Cc: Heinrich Schuchardt <xypron.glpk@gmx.de>
2023-07-24 15:30:03 -04:00
..
platform_data Merge https://gitlab.denx.de/u-boot/custodians/u-boot-spi 2023-07-13 20:39:10 -04:00
acpi.h acpi: Collect tables in the acpi_item list 2022-01-25 11:44:36 -07:00
device-internal.h dm: core: Add note about device_probe idempotence 2022-10-29 07:36:33 -06:00
device.h dm: treewide: Complete migration to new driver model schema 2023-02-14 09:43:27 -07:00
device_compat.h dm: Don't undefine dev_xxx macros 2020-10-16 09:44:27 -04:00
devres.h dm: core: Allow devres to be disabled in SPL 2022-04-18 17:53:56 -04:00
fdtaddr.h core: fdtaddr: add devfdt_get_addr_size_index_ptr function 2023-05-06 17:28:18 +08:00
lists.h dm: core: Document return value of device bind functions 2022-10-29 07:36:33 -06:00
of.h fdt: Align the start of the livetree 2023-07-14 12:54:51 -04:00
of_access.h dm: core: Expand integer-reading tests 2022-09-29 22:43:42 -04:00
of_addr.h doc: add include/dm/of*.h to the HTML documentation 2022-01-15 10:57:21 +01:00
of_extra.h doc: add include/dm/of*.h to the HTML documentation 2022-01-15 10:57:21 +01:00
ofnode.h fdt: Allow more general use of livetree 2023-07-14 12:54:51 -04:00
ofnode_decl.h dm: core: Add definitions for multiple ofnode trees 2022-09-29 22:43:43 -04:00
pci.h doc: replace @return by Return: 2022-01-19 18:11:34 +01:00
pinctrl.h pinctrl: Add third argument label for pinctrl_gpio_request() function 2022-07-28 15:17:45 +02:00
platdata.h doc: add include/dm/platdata.h to the HTML documentation 2022-01-15 10:57:21 +01:00
read.h core: read: fix dev_read_addr_size() 2023-07-20 14:10:57 -06:00
root.h dm: core: Add a command to show driver model statistics 2022-06-28 03:09:52 +01:00
simple_bus.h dm: core: Correctly read <ranges> of simple-bus 2021-04-15 14:22:17 +05:30
tag.h dm: core: Add a command to show driver model statistics 2022-06-28 03:09:52 +01:00
test.h dm: core: Switch the testbus driver to use a new struct 2022-06-28 03:09:52 +01:00
uclass-id.h arm_ffa: introduce Arm FF-A support 2023-07-24 15:30:03 -04:00
uclass-internal.h dm: core: Allow finding a uclass device by partial name 2022-04-25 10:00:03 -04:00
uclass.h dm: core: fix introduce uclass_get_device_by_of_path 2023-05-04 09:57:43 +02:00
util.h dm: core: Support sorting devices with dm tree 2023-01-23 18:11:39 -05:00