readme.rst 2.63 KB
Newer Older
1
2
Trusted Firmware-A
==================
3

4
5
6
7
8
Trusted Firmware-A (TF-A) is a reference implementation of secure world software
for `Arm A-Profile architectures`_ (Armv8-A and Armv7-A), including an Exception
Level 3 (EL3) `Secure Monitor`_. It provides a suitable starting point for
productization of secure world boot and runtime firmware, in either the AArch32
or AArch64 execution states.
John Tsichritzis's avatar
John Tsichritzis committed
9

10
TF-A implements Arm interface standards, including:
John Tsichritzis's avatar
John Tsichritzis committed
11

12
-  `Power State Coordination Interface (PSCI)`_
13
-  `Trusted Board Boot Requirements CLIENT (TBBR-CLIENT)`_
Dan Handley's avatar
Dan Handley committed
14
-  `SMC Calling Convention`_
15
-  `System Control and Management Interface (SCMI)`_
16
-  `Software Delegated Exception Interface (SDEI)`_
Dan Handley's avatar
Dan Handley committed
17

18
19
The code is designed to be portable and reusable across hardware platforms and
software models that are based on the Armv8-A and Armv7-A architectures.
20

21
In collaboration with interested parties, we will continue to enhance TF-A
22
23
with reference implementations of Arm standards to benefit developers working
with Armv7-A and Armv8-A TrustZone technology.
24
25
26
27

Users are encouraged to do their own security validation, including penetration
testing, on any secure world code derived from TF-A.

28
29
More Info and Documentation
---------------------------
30

31
32
To find out more about Trusted Firmware-A, please `view the full documentation`_
that is available through `trustedfirmware.org`_.
33

34
35
--------------

36
*Copyright (c) 2013-2019, Arm Limited and Contributors. All rights reserved.*
37

38
.. _Armv7-A and Armv8-A: https://developer.arm.com/products/architecture/a-profile
39
.. _Secure Monitor: http://www.arm.com/products/processors/technologies/trustzone/tee-smc.php
Dan Handley's avatar
Dan Handley committed
40
41
.. _Power State Coordination Interface (PSCI): PSCI_
.. _PSCI: http://infocenter.arm.com/help/topic/com.arm.doc.den0022d/Power_State_Coordination_Interface_PDD_v1_1_DEN0022D.pdf
42
.. _Trusted Board Boot Requirements CLIENT (TBBR-CLIENT): https://developer.arm.com/docs/den0006/latest/trusted-board-boot-requirements-client-tbbr-client-armv8-a
Dan Handley's avatar
Dan Handley committed
43
.. _SMC Calling Convention: http://infocenter.arm.com/help/topic/com.arm.doc.den0028b/ARM_DEN0028B_SMC_Calling_Convention.pdf
44
.. _System Control and Management Interface (SCMI): SCMI_
Dan Handley's avatar
Dan Handley committed
45
.. _SCMI: http://infocenter.arm.com/help/topic/com.arm.doc.den0056a/DEN0056A_System_Control_and_Management_Interface.pdf
Dan Handley's avatar
Dan Handley committed
46
.. _Software Delegated Exception Interface (SDEI): SDEI_
47
.. _SDEI: http://infocenter.arm.com/help/topic/com.arm.doc.den0054a/ARM_DEN0054A_Software_Delegated_Exception_Interface.pdf
48
49
50
51
.. _Arm A-Profile architectures: https://developer.arm.com/architectures/cpu-architecture/a-profile
.. _view the full documentation: https://www.trustedfirmware.org/docs/tf-a
.. _trustedfirmware.org: http://www.trustedfirmware.org