xref: /aosp_15_r20/external/arm-trusted-firmware/readme.rst (revision 54fd6939e177f8ff529b10183254802c76df6d08)
1*54fd6939SJiyong ParkTrusted Firmware-A
2*54fd6939SJiyong Park==================
3*54fd6939SJiyong Park
4*54fd6939SJiyong ParkTrusted Firmware-A (TF-A) is a reference implementation of secure world software
5*54fd6939SJiyong Parkfor `Arm A-Profile architectures`_ (Armv8-A and Armv7-A), including an Exception
6*54fd6939SJiyong ParkLevel 3 (EL3) `Secure Monitor`_. It provides a suitable starting point for
7*54fd6939SJiyong Parkproductization of secure world boot and runtime firmware, in either the AArch32
8*54fd6939SJiyong Parkor AArch64 execution states.
9*54fd6939SJiyong Park
10*54fd6939SJiyong ParkTF-A implements Arm interface standards, including:
11*54fd6939SJiyong Park
12*54fd6939SJiyong Park-  `Power State Coordination Interface (PSCI)`_
13*54fd6939SJiyong Park-  `Trusted Board Boot Requirements CLIENT (TBBR-CLIENT)`_
14*54fd6939SJiyong Park-  `SMC Calling Convention`_
15*54fd6939SJiyong Park-  `System Control and Management Interface (SCMI)`_
16*54fd6939SJiyong Park-  `Software Delegated Exception Interface (SDEI)`_
17*54fd6939SJiyong Park
18*54fd6939SJiyong ParkThe code is designed to be portable and reusable across hardware platforms and
19*54fd6939SJiyong Parksoftware models that are based on the Armv8-A and Armv7-A architectures.
20*54fd6939SJiyong Park
21*54fd6939SJiyong ParkIn collaboration with interested parties, we will continue to enhance TF-A
22*54fd6939SJiyong Parkwith reference implementations of Arm standards to benefit developers working
23*54fd6939SJiyong Parkwith Armv7-A and Armv8-A TrustZone technology.
24*54fd6939SJiyong Park
25*54fd6939SJiyong ParkUsers are encouraged to do their own security validation, including penetration
26*54fd6939SJiyong Parktesting, on any secure world code derived from TF-A.
27*54fd6939SJiyong Park
28*54fd6939SJiyong ParkMore Info and Documentation
29*54fd6939SJiyong Park---------------------------
30*54fd6939SJiyong Park
31*54fd6939SJiyong ParkTo find out more about Trusted Firmware-A, please `view the full documentation`_
32*54fd6939SJiyong Parkthat is available through `trustedfirmware.org`_.
33*54fd6939SJiyong Park
34*54fd6939SJiyong Park--------------
35*54fd6939SJiyong Park
36*54fd6939SJiyong Park*Copyright (c) 2013-2019, Arm Limited and Contributors. All rights reserved.*
37*54fd6939SJiyong Park
38*54fd6939SJiyong Park.. _Armv7-A and Armv8-A: https://developer.arm.com/products/architecture/a-profile
39*54fd6939SJiyong Park.. _Secure Monitor: http://www.arm.com/products/processors/technologies/trustzone/tee-smc.php
40*54fd6939SJiyong Park.. _Power State Coordination Interface (PSCI): PSCI_
41*54fd6939SJiyong Park.. _PSCI: http://infocenter.arm.com/help/topic/com.arm.doc.den0022d/Power_State_Coordination_Interface_PDD_v1_1_DEN0022D.pdf
42*54fd6939SJiyong Park.. _Trusted Board Boot Requirements CLIENT (TBBR-CLIENT): https://developer.arm.com/docs/den0006/latest/trusted-board-boot-requirements-client-tbbr-client-armv8-a
43*54fd6939SJiyong Park.. _SMC Calling Convention: http://infocenter.arm.com/help/topic/com.arm.doc.den0028b/ARM_DEN0028B_SMC_Calling_Convention.pdf
44*54fd6939SJiyong Park.. _System Control and Management Interface (SCMI): SCMI_
45*54fd6939SJiyong Park.. _SCMI: http://infocenter.arm.com/help/topic/com.arm.doc.den0056a/DEN0056A_System_Control_and_Management_Interface.pdf
46*54fd6939SJiyong Park.. _Software Delegated Exception Interface (SDEI): SDEI_
47*54fd6939SJiyong Park.. _SDEI: http://infocenter.arm.com/help/topic/com.arm.doc.den0054a/ARM_DEN0054A_Software_Delegated_Exception_Interface.pdf
48*54fd6939SJiyong Park.. _Arm A-Profile architectures: https://developer.arm.com/architectures/cpu-architecture/a-profile
49*54fd6939SJiyong Park.. _view the full documentation: https://www.trustedfirmware.org/docs/tf-a
50*54fd6939SJiyong Park.. _trustedfirmware.org: http://www.trustedfirmware.org
51*54fd6939SJiyong Park
52