| Abdellatif El Khlifi | 2f403d1 | 2023-08-04 14:33:40 +0100 | [diff] [blame] | 1 | # SPDX-License-Identifier: GPL-2.0 |
| 2 | |
| 3 | config ARM_FFA_TRANSPORT |
| 4 | bool "Enable Arm Firmware Framework for Armv8-A driver" |
| Abdellatif El Khlifi | 4970d5b | 2023-08-04 14:33:41 +0100 | [diff] [blame^] | 5 | depends on DM && (ARM64 || SANDBOX) |
| 6 | select ARM_SMCCC if !SANDBOX |
| 7 | select ARM_SMCCC_FEATURES if !SANDBOX |
| Abdellatif El Khlifi | 2f403d1 | 2023-08-04 14:33:40 +0100 | [diff] [blame] | 8 | select LIB_UUID |
| 9 | select DEVRES |
| 10 | help |
| 11 | The Firmware Framework for Arm A-profile processors (FF-A) |
| 12 | describes interfaces (ABIs) that standardize communication |
| 13 | between the Secure World and Normal World leveraging TrustZone |
| 14 | technology. |
| 15 | |
| 16 | The FF-A support in U-Boot is based on FF-A specification v1.0 and uses SMC32 |
| 17 | calling convention. |
| 18 | |
| 19 | FF-A specification: |
| 20 | |
| 21 | https://developer.arm.com/documentation/den0077/a/?lang=en |
| 22 | |
| 23 | In U-Boot FF-A design, FF-A is considered as a discoverable bus. |
| 24 | FF-A bus is discovered using ARM_SMCCC_FEATURES mechanism performed |
| 25 | by the PSCI driver. |
| 26 | The Secure World is considered as one entity to communicate with |
| 27 | using the FF-A bus. |
| 28 | FF-A communication is handled by one device and one instance (the bus). |
| 29 | The FF-A support on U-Boot takes care of all the interactions between Normal |
| 30 | world and Secure World. |
| 31 | |
| 32 | Generic FF-A methods are implemented in the Uclass (arm-ffa-uclass.c). |
| 33 | Arm specific methods are implemented in the Arm driver (arm-ffa.c). |
| 34 | |
| Abdellatif El Khlifi | 4970d5b | 2023-08-04 14:33:41 +0100 | [diff] [blame^] | 35 | FF-A sandbox is provided to run FF-A under sandbox and allows to test the FF-A Uclass. |
| 36 | Sandbox support includes an emulator for Arm FF-A which emulates the FF-A side of |
| 37 | the Secure World and provides FF-A ABIs inspection methods (ffa-emul-uclass.c). |
| 38 | An FF-A sandbox driver is also provided for FF-A communication with the emulated |
| 39 | Secure World (sandbox_ffa.c). |
| Abdellatif El Khlifi | 2f403d1 | 2023-08-04 14:33:40 +0100 | [diff] [blame] | 40 | |
| Abdellatif El Khlifi | 4970d5b | 2023-08-04 14:33:41 +0100 | [diff] [blame^] | 41 | For more details about the FF-A support, please refer to doc/arch/arm64.ffa.rst |