Paul Beesley | fc11863 | 2019-03-25 16:45:23 +0000 | [diff] [blame] | 1 | Trusted Firmware-A - version 2.1 |
Dan Handley | 610e7e1 | 2018-03-01 18:44:00 +0000 | [diff] [blame] | 2 | ================================ |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 3 | |
John Tsichritzis | 55478d9 | 2019-04-11 17:23:32 +0100 | [diff] [blame] | 4 | .. section-numbering:: |
| 5 | :suffix: . |
| 6 | |
| 7 | .. contents:: |
| 8 | |
Dan Handley | 610e7e1 | 2018-03-01 18:44:00 +0000 | [diff] [blame] | 9 | Trusted Firmware-A (TF-A) provides a reference implementation of secure world |
Dan Handley | cc573cb | 2018-03-14 13:01:39 +0000 | [diff] [blame] | 10 | software for `Armv7-A and Armv8-A`_, including a `Secure Monitor`_ executing |
| 11 | at Exception Level 3 (EL3). It implements various Arm interface standards, |
| 12 | such as: |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 13 | |
| 14 | - The `Power State Coordination Interface (PSCI)`_ |
Sandrine Bailleux | 3091842 | 2019-04-24 10:41:24 +0200 | [diff] [blame] | 15 | - `Trusted Board Boot Requirements CLIENT (TBBR-CLIENT)`_ |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 16 | - `SMC Calling Convention`_ |
Paul Beesley | 2bb814c | 2019-01-10 15:42:39 +0000 | [diff] [blame] | 17 | - `System Control and Management Interface (SCMI)`_ |
Dan Handley | cc573cb | 2018-03-14 13:01:39 +0000 | [diff] [blame] | 18 | - `Software Delegated Exception Interface (SDEI)`_ |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 19 | |
Dan Handley | cc573cb | 2018-03-14 13:01:39 +0000 | [diff] [blame] | 20 | Where possible, the code is designed for reuse or porting to other Armv7-A and |
| 21 | Armv8-A model and hardware platforms. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 22 | |
Paul Beesley | fc11863 | 2019-03-25 16:45:23 +0000 | [diff] [blame] | 23 | This release provides a suitable starting point for productization of secure |
| 24 | world boot and runtime firmware, in either the AArch32 or AArch64 execution |
| 25 | states. |
| 26 | |
| 27 | Users are encouraged to do their own security validation, including penetration |
| 28 | testing, on any secure world code derived from TF-A. |
| 29 | |
Dan Handley | 610e7e1 | 2018-03-01 18:44:00 +0000 | [diff] [blame] | 30 | Arm will continue development in collaboration with interested parties to |
| 31 | provide a full reference implementation of Secure Monitor code and Arm standards |
Dan Handley | cc573cb | 2018-03-14 13:01:39 +0000 | [diff] [blame] | 32 | to the benefit of all developers working with Armv7-A and Armv8-A TrustZone |
| 33 | technology. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 34 | |
John Tsichritzis | 55478d9 | 2019-04-11 17:23:32 +0100 | [diff] [blame] | 35 | Documentation contents |
| 36 | ---------------------- |
| 37 | |
| 38 | The `Trusted Firmware-A Documentation Contents`_ page contains an overview of |
| 39 | the documentation that is available, with links to facilitate easier browsing. |
| 40 | |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 41 | License |
| 42 | ------- |
| 43 | |
| 44 | The software is provided under a BSD-3-Clause `license`_. Contributions to this |
| 45 | project are accepted under the same license with developer sign-off as |
| 46 | described in the `Contributing Guidelines`_. |
| 47 | |
| 48 | This project contains code from other projects as listed below. The original |
| 49 | license text is included in those source files. |
| 50 | |
Antonio Nino Diaz | cf0f805 | 2018-08-17 10:45:47 +0100 | [diff] [blame] | 51 | - The libc source code is derived from `FreeBSD`_ and `SCC`_. FreeBSD uses |
| 52 | various BSD licenses, including BSD-3-Clause and BSD-2-Clause. The SCC code |
| 53 | is used under the BSD-3-Clause license with the author's permission. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 54 | |
Dan Handley | 5274dc2 | 2018-07-25 16:42:10 +0100 | [diff] [blame] | 55 | - The libfdt source code is disjunctively dual licensed |
| 56 | (GPL-2.0+ OR BSD-2-Clause). It is used by this project under the terms of |
| 57 | the BSD-2-Clause license. Any contributions to this code must be made under |
| 58 | the terms of both licenses. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 59 | |
Dan Handley | 5274dc2 | 2018-07-25 16:42:10 +0100 | [diff] [blame] | 60 | - The LLVM compiler-rt source code is disjunctively dual licensed |
| 61 | (NCSA OR MIT). It is used by this project under the terms of the NCSA |
| 62 | license (also known as the University of Illinois/NCSA Open Source License), |
| 63 | which is a permissive license compatible with BSD-3-Clause. Any |
| 64 | contributions to this code must be made under the terms of both licenses. |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 65 | |
Dan Handley | cc573cb | 2018-03-14 13:01:39 +0000 | [diff] [blame] | 66 | - The zlib source code is licensed under the Zlib license, which is a |
| 67 | permissive license compatible with BSD-3-Clause. |
| 68 | |
Dan Handley | 5274dc2 | 2018-07-25 16:42:10 +0100 | [diff] [blame] | 69 | - Some STMicroelectronics platform source code is disjunctively dual licensed |
| 70 | (GPL-2.0+ OR BSD-3-Clause). It is used by this project under the terms of the |
| 71 | BSD-3-Clause license. Any contributions to this code must be made under the |
| 72 | terms of both licenses. |
| 73 | |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 74 | Functionality |
Paul Beesley | fc11863 | 2019-03-25 16:45:23 +0000 | [diff] [blame] | 75 | ------------- |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 76 | |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 77 | - Initialization of the secure world, for example exception vectors, control |
| 78 | registers and interrupts for the platform. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 79 | |
| 80 | - Library support for CPU specific reset and power down sequences. This |
Dan Handley | 610e7e1 | 2018-03-01 18:44:00 +0000 | [diff] [blame] | 81 | includes support for errata workarounds and the latest Arm DynamIQ CPUs. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 82 | |
Dan Handley | 610e7e1 | 2018-03-01 18:44:00 +0000 | [diff] [blame] | 83 | - Drivers to enable standard initialization of Arm System IP, for example |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 84 | Generic Interrupt Controller (GIC), Cache Coherent Interconnect (CCI), |
| 85 | Cache Coherent Network (CCN), Network Interconnect (NIC) and TrustZone |
| 86 | Controller (TZC). |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 87 | |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 88 | - A generic `SCMI`_ driver to interface with conforming power controllers, for |
Dan Handley | 610e7e1 | 2018-03-01 18:44:00 +0000 | [diff] [blame] | 89 | example the Arm System Control Processor (SCP). |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 90 | |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 91 | - SMC (Secure Monitor Call) handling, conforming to the `SMC Calling |
| 92 | Convention`_ using an EL3 runtime services framework. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 93 | |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 94 | - `PSCI`_ library support for CPU, cluster and system power management |
| 95 | use-cases. |
| 96 | This library is pre-integrated with the AArch64 EL3 Runtime Software, and |
| 97 | is also suitable for integration with other AArch32 EL3 Runtime Software, |
| 98 | for example an AArch32 Secure OS. |
| 99 | |
| 100 | - A minimal AArch32 Secure Payload (SP\_MIN) to demonstrate `PSCI`_ library |
| 101 | integration with AArch32 EL3 Runtime Software. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 102 | |
| 103 | - Secure Monitor library code such as world switching, EL1 context management |
| 104 | and interrupt routing. |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 105 | When a Secure-EL1 Payload (SP) is present, for example a Secure OS, the |
Paul Beesley | 640e5d3 | 2019-01-10 16:14:04 +0000 | [diff] [blame] | 106 | AArch64 EL3 Runtime Software must be integrated with a Secure Payload |
| 107 | Dispatcher (SPD) component to customize the interaction with the SP. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 108 | |
Paul Beesley | 640e5d3 | 2019-01-10 16:14:04 +0000 | [diff] [blame] | 109 | - A Test SP and SPD to demonstrate AArch64 Secure Monitor functionality and SP |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 110 | interaction with PSCI. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 111 | |
Paul Beesley | fb80fe0 | 2019-01-10 15:53:12 +0000 | [diff] [blame] | 112 | - SPDs for the `OP-TEE Secure OS`_, `NVIDIA Trusted Little Kernel`_ |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 113 | and `Trusty Secure OS`_. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 114 | |
| 115 | - A Trusted Board Boot implementation, conforming to all mandatory TBBR |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 116 | requirements. This includes image authentication, Firmware Update (or |
| 117 | recovery mode), and packaging of the various firmware images into a |
| 118 | Firmware Image Package (FIP). |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 119 | |
Dan Handley | cc573cb | 2018-03-14 13:01:39 +0000 | [diff] [blame] | 120 | - Pre-integration of TBB with the Arm CryptoCell product, to take advantage of |
| 121 | its hardware Root of Trust and crypto acceleration services. |
| 122 | |
| 123 | - Reliability, Availability, and Serviceability (RAS) functionality, including |
| 124 | |
| 125 | - A Secure Partition Manager (SPM) to manage Secure Partitions in |
| 126 | Secure-EL0, which can be used to implement simple management and |
| 127 | security services. |
| 128 | |
| 129 | - An SDEI dispatcher to route interrupt-based SDEI events. |
| 130 | |
| 131 | - An Exception Handling Framework (EHF) that allows dispatching of EL3 |
| 132 | interrupts to their registered handlers, to facilitate firmware-first |
| 133 | error handling. |
| 134 | |
| 135 | - A dynamic configuration framework that enables each of the firmware images |
| 136 | to be configured at runtime if required by the platform. It also enables |
| 137 | loading of a hardware configuration (for example, a kernel device tree) |
| 138 | as part of the FIP, to be passed through the firmware stages. |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 139 | |
| 140 | - Support for alternative boot flows, for example to support platforms where |
| 141 | the EL3 Runtime Software is loaded using other firmware or a separate |
Dan Handley | cc573cb | 2018-03-14 13:01:39 +0000 | [diff] [blame] | 142 | secure system processor, or where a non-TF-A ROM expects BL2 to be loaded |
| 143 | at EL3. |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 144 | |
Dan Handley | 610e7e1 | 2018-03-01 18:44:00 +0000 | [diff] [blame] | 145 | - Support for the GCC, LLVM and Arm Compiler 6 toolchains. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 146 | |
Paul Beesley | fc11863 | 2019-03-25 16:45:23 +0000 | [diff] [blame] | 147 | - Support for combining several libraries into a "romlib" image that may be |
| 148 | shared across images to reduce memory footprint. The romlib image is stored |
| 149 | in ROM but is accessed through a jump-table that may be stored |
Joanna Farley | 325ef90 | 2018-09-11 15:51:31 +0100 | [diff] [blame] | 150 | in read-write memory, allowing for the library code to be patched. |
| 151 | |
Paul Beesley | fc11863 | 2019-03-25 16:45:23 +0000 | [diff] [blame] | 152 | - A prototype implementation of a Secure Partition Manager (SPM) that is based |
Paul Beesley | bd1c416 | 2019-03-29 10:14:56 +0000 | [diff] [blame] | 153 | on the SPCI Alpha 1 and SPRT draft specifications. |
Paul Beesley | fc11863 | 2019-03-25 16:45:23 +0000 | [diff] [blame] | 154 | |
| 155 | - Support for ARMv8.3 pointer authentication in the normal and secure worlds. |
| 156 | The use of pointer authentication in the normal world is enabled whenever |
| 157 | architectural support is available, without the need for additional build |
| 158 | flags. Use of pointer authentication in the secure world remains an |
| 159 | experimental configuration at this time and requires the ``ENABLE_PAUTH`` |
| 160 | build flag to be set. |
| 161 | |
| 162 | - Position-Independent Executable (PIE) support. Initially for BL31 only, with |
| 163 | further support to be added in a future release. |
| 164 | |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 165 | For a full description of functionality and implementation details, please |
| 166 | see the `Firmware Design`_ and supporting documentation. The `Change Log`_ |
| 167 | provides details of changes made since the last release. |
| 168 | |
| 169 | Platforms |
Paul Beesley | fc11863 | 2019-03-25 16:45:23 +0000 | [diff] [blame] | 170 | --------- |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 171 | |
Paul Beesley | 640e5d3 | 2019-01-10 16:14:04 +0000 | [diff] [blame] | 172 | Various AArch32 and AArch64 builds of this release have been tested on r0, r1 |
| 173 | and r2 variants of the `Juno Arm Development Platform`_. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 174 | |
Ambroise Vincent | 6f4c0fc | 2019-03-28 12:51:48 +0000 | [diff] [blame] | 175 | The latest version of the AArch64 build of TF-A has been tested on the following |
| 176 | Arm FVPs without shifted affinities, and that do not support threaded CPU cores |
| 177 | (64-bit host machine only). |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 178 | |
John Tsichritzis | d189425 | 2019-05-20 13:09:34 +0100 | [diff] [blame] | 179 | The FVP models used are Version 11.6 Build 45, unless otherwise stated. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 180 | |
Joanna Farley | 325ef90 | 2018-09-11 15:51:31 +0100 | [diff] [blame] | 181 | - ``FVP_Base_AEMv8A-AEMv8A`` |
| 182 | - ``FVP_Base_AEMv8A-AEMv8A-AEMv8A-AEMv8A-CCN502`` |
Joanna Farley | 325ef90 | 2018-09-11 15:51:31 +0100 | [diff] [blame] | 183 | - ``FVP_Base_RevC-2xAEMv8A`` |
| 184 | - ``FVP_Base_Cortex-A32x4`` |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 185 | - ``FVP_Base_Cortex-A35x4`` |
| 186 | - ``FVP_Base_Cortex-A53x4`` |
Joanna Farley | 325ef90 | 2018-09-11 15:51:31 +0100 | [diff] [blame] | 187 | - ``FVP_Base_Cortex-A55x4+Cortex-A75x4`` |
| 188 | - ``FVP_Base_Cortex-A55x4`` |
Ambroise Vincent | 6f4c0fc | 2019-03-28 12:51:48 +0000 | [diff] [blame] | 189 | - ``FVP_Base_Cortex-A57x1-A53x1`` |
| 190 | - ``FVP_Base_Cortex-A57x2-A53x4`` |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 191 | - ``FVP_Base_Cortex-A57x4-A53x4`` |
| 192 | - ``FVP_Base_Cortex-A57x4`` |
| 193 | - ``FVP_Base_Cortex-A72x4-A53x4`` |
| 194 | - ``FVP_Base_Cortex-A72x4`` |
| 195 | - ``FVP_Base_Cortex-A73x4-A53x4`` |
| 196 | - ``FVP_Base_Cortex-A73x4`` |
Joanna Farley | 325ef90 | 2018-09-11 15:51:31 +0100 | [diff] [blame] | 197 | - ``FVP_Base_Cortex-A75x4`` |
| 198 | - ``FVP_Base_Cortex-A76x4`` |
John Tsichritzis | d189425 | 2019-05-20 13:09:34 +0100 | [diff] [blame] | 199 | - ``FVP_Base_Cortex-A76AEx4`` |
| 200 | - ``FVP_Base_Cortex-A76AEx8`` |
| 201 | - ``FVP_Base_Neoverse-N1x4`` |
Ambroise Vincent | 6f4c0fc | 2019-03-28 12:51:48 +0000 | [diff] [blame] | 202 | - ``FVP_Base_Deimos`` |
| 203 | - ``FVP_CSS_SGI-575`` (Version 11.3 build 42) |
| 204 | - ``FVP_CSS_SGM-775`` (Version 11.3 build 42) |
| 205 | - ``FVP_RD_E1Edge`` (Version 11.3 build 42) |
John Tsichritzis | d189425 | 2019-05-20 13:09:34 +0100 | [diff] [blame] | 206 | - ``FVP_RD_N1Edge`` |
Joanna Farley | 325ef90 | 2018-09-11 15:51:31 +0100 | [diff] [blame] | 207 | - ``Foundation_Platform`` |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 208 | |
Joanna Farley | 325ef90 | 2018-09-11 15:51:31 +0100 | [diff] [blame] | 209 | The latest version of the AArch32 build of TF-A has been tested on the following |
Ambroise Vincent | 6f4c0fc | 2019-03-28 12:51:48 +0000 | [diff] [blame] | 210 | Arm FVPs without shifted affinities, and that do not support threaded CPU cores |
Joanna Farley | 325ef90 | 2018-09-11 15:51:31 +0100 | [diff] [blame] | 211 | (64-bit host machine only). |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 212 | |
Dan Handley | cc573cb | 2018-03-14 13:01:39 +0000 | [diff] [blame] | 213 | - ``FVP_Base_AEMv8A-AEMv8A`` |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 214 | - ``FVP_Base_Cortex-A32x4`` |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 215 | |
Ambroise Vincent | 6f4c0fc | 2019-03-28 12:51:48 +0000 | [diff] [blame] | 216 | NOTE: The ``FVP_Base_RevC-2xAEMv8A`` FVP only supports shifted affinities. |
| 217 | |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 218 | The Foundation FVP can be downloaded free of charge. The Base FVPs can be |
Dan Handley | 610e7e1 | 2018-03-01 18:44:00 +0000 | [diff] [blame] | 219 | licensed from Arm. See the `Arm FVP website`_. |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 220 | |
Joanna Farley | 325ef90 | 2018-09-11 15:51:31 +0100 | [diff] [blame] | 221 | All the above platforms have been tested with `Linaro Release 18.04`_. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 222 | |
| 223 | This release also contains the following platform support: |
| 224 | |
Paul Beesley | fc11863 | 2019-03-25 16:45:23 +0000 | [diff] [blame] | 225 | - Allwinner sun50i_a64 and sun50i_h6 |
Antonio Nino Diaz | fe75b05 | 2018-10-10 23:52:39 +0100 | [diff] [blame] | 226 | - Amlogic Meson S905 (GXBB) |
Remi Pommarel | 75e43e0 | 2019-04-01 11:34:09 +0200 | [diff] [blame] | 227 | - Amlogic Meson S905x (GXL) |
Paul Beesley | fc11863 | 2019-03-25 16:45:23 +0000 | [diff] [blame] | 228 | - Arm Juno Software Development Platform |
| 229 | - Arm Neoverse N1 System Development Platform (N1SDP) |
| 230 | - Arm Neoverse Reference Design N1 Edge (RD-N1-Edge) FVP |
| 231 | - Arm Neoverse Reference Design E1 Edge (RD-E1-Edge) FVP |
| 232 | - Arm SGI-575 and SGM-775 |
| 233 | - Arm Versatile Express FVP |
Dan Handley | cc573cb | 2018-03-14 13:01:39 +0000 | [diff] [blame] | 234 | - HiKey, HiKey960 and Poplar boards |
Paul Beesley | fc11863 | 2019-03-25 16:45:23 +0000 | [diff] [blame] | 235 | - Intel Stratix 10 SoC FPGA |
Antonio Nino Diaz | 3129153 | 2019-01-17 12:16:07 +0000 | [diff] [blame] | 236 | - Marvell Armada 3700 and 8K |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 237 | - MediaTek MT6795 and MT8173 SoCs |
Antonio Nino Diaz | 3129153 | 2019-01-17 12:16:07 +0000 | [diff] [blame] | 238 | - NVIDIA T132, T186 and T210 SoCs |
Paul Beesley | fc11863 | 2019-03-25 16:45:23 +0000 | [diff] [blame] | 239 | - NXP QorIQ LS1043A, i.MX8MM, i.MX8MQ, i.MX8QX, i.MX8QM and i.MX7Solo WaRP7 |
Antonio Nino Diaz | 3129153 | 2019-01-17 12:16:07 +0000 | [diff] [blame] | 240 | - QEMU |
| 241 | - Raspberry Pi 3 |
Paul Beesley | fc11863 | 2019-03-25 16:45:23 +0000 | [diff] [blame] | 242 | - Renesas R-Car Generation 3 |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 243 | - RockChip RK3328, RK3368 and RK3399 SoCs |
Sumit Garg | 760c1d3 | 2018-06-21 11:28:18 +0530 | [diff] [blame] | 244 | - Socionext UniPhier SoC family and SynQuacer SC2A11 SoCs |
Joanna Farley | 325ef90 | 2018-09-11 15:51:31 +0100 | [diff] [blame] | 245 | - STMicroelectronics STM32MP1 |
Nishanth Menon | 0192f89 | 2016-10-14 01:13:34 +0000 | [diff] [blame] | 246 | - Texas Instruments K3 SoCs |
Antonio Nino Diaz | 3129153 | 2019-01-17 12:16:07 +0000 | [diff] [blame] | 247 | - Xilinx Versal and Zynq UltraScale + MPSoC |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 248 | |
Dan Handley | cc573cb | 2018-03-14 13:01:39 +0000 | [diff] [blame] | 249 | Still to come |
Paul Beesley | fc11863 | 2019-03-25 16:45:23 +0000 | [diff] [blame] | 250 | ------------- |
| 251 | |
| 252 | - Support for additional platforms. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 253 | |
Paul Beesley | fc11863 | 2019-03-25 16:45:23 +0000 | [diff] [blame] | 254 | - Refinements to Position Independent Executable (PIE) support. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 255 | |
Paul Beesley | bd1c416 | 2019-03-29 10:14:56 +0000 | [diff] [blame] | 256 | - Refinements to the SPCI-based SPM implementation as the draft SPCI and SPRT |
| 257 | specifications continue to evolve. |
Paul Beesley | fc11863 | 2019-03-25 16:45:23 +0000 | [diff] [blame] | 258 | |
| 259 | - Documentation enhancements. |
Dan Handley | cc573cb | 2018-03-14 13:01:39 +0000 | [diff] [blame] | 260 | |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 261 | - Ongoing support for new architectural features, CPUs and System IP. |
| 262 | |
Dan Handley | cc573cb | 2018-03-14 13:01:39 +0000 | [diff] [blame] | 263 | - Ongoing support for new Arm system architecture specifications. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 264 | |
| 265 | - Ongoing security hardening, optimization and quality improvements. |
| 266 | |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 267 | For a full list of detailed issues in the current code, please see the `Change |
Louis Mayencourt | 72ef3d4 | 2019-03-22 11:47:22 +0000 | [diff] [blame] | 268 | Log`_ and the `issue tracker`_. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 269 | |
Dan Handley | cc573cb | 2018-03-14 13:01:39 +0000 | [diff] [blame] | 270 | Getting started |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 271 | --------------- |
| 272 | |
Louis Mayencourt | 72ef3d4 | 2019-03-22 11:47:22 +0000 | [diff] [blame] | 273 | See the `User Guide`_ for instructions on how to download, install, build and |
| 274 | use TF-A with the Arm `FVP`_\ s. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 275 | |
Paul Beesley | 640e5d3 | 2019-01-10 16:14:04 +0000 | [diff] [blame] | 276 | See the `Firmware Design`_ for information on how TF-A works. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 277 | |
| 278 | See the `Porting Guide`_ as well for information about how to use this |
Dan Handley | cc573cb | 2018-03-14 13:01:39 +0000 | [diff] [blame] | 279 | software on another Armv7-A or Armv8-A platform. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 280 | |
| 281 | See the `Contributing Guidelines`_ for information on how to contribute to this |
| 282 | project and the `Acknowledgments`_ file for a list of contributors to the |
| 283 | project. |
| 284 | |
| 285 | Feedback and support |
| 286 | ~~~~~~~~~~~~~~~~~~~~ |
| 287 | |
Dan Handley | 610e7e1 | 2018-03-01 18:44:00 +0000 | [diff] [blame] | 288 | Arm welcomes any feedback on TF-A. If you think you have found a security |
| 289 | vulnerability, please report this using the process defined in the TF-A |
Sandrine Bailleux | b9f7ba7 | 2019-03-12 15:07:27 +0100 | [diff] [blame] | 290 | `Security Center`_. For all other feedback, please use the |
Louis Mayencourt | 72ef3d4 | 2019-03-22 11:47:22 +0000 | [diff] [blame] | 291 | `issue tracker`_. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 292 | |
Dan Handley | 610e7e1 | 2018-03-01 18:44:00 +0000 | [diff] [blame] | 293 | Arm licensees may contact Arm directly via their partner managers. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 294 | |
Joel Hutton | 0f79fb1 | 2019-02-26 16:23:54 +0000 | [diff] [blame] | 295 | Security advisories |
Paul Beesley | fc11863 | 2019-03-25 16:45:23 +0000 | [diff] [blame] | 296 | ------------------- |
Joel Hutton | 0f79fb1 | 2019-02-26 16:23:54 +0000 | [diff] [blame] | 297 | |
Sandrine Bailleux | 6dffc67 | 2019-03-12 15:10:49 +0100 | [diff] [blame] | 298 | - `Security Advisory TFV-1`_ |
| 299 | - `Security Advisory TFV-2`_ |
| 300 | - `Security Advisory TFV-3`_ |
| 301 | - `Security Advisory TFV-4`_ |
| 302 | - `Security Advisory TFV-5`_ |
| 303 | - `Security Advisory TFV-6`_ |
| 304 | - `Security Advisory TFV-7`_ |
| 305 | - `Security Advisory TFV-8`_ |
Joel Hutton | 0f79fb1 | 2019-02-26 16:23:54 +0000 | [diff] [blame] | 306 | |
| 307 | |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 308 | -------------- |
| 309 | |
Antonio Nino Diaz | 3129153 | 2019-01-17 12:16:07 +0000 | [diff] [blame] | 310 | *Copyright (c) 2013-2019, Arm Limited and Contributors. All rights reserved.* |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 311 | |
Dan Handley | cc573cb | 2018-03-14 13:01:39 +0000 | [diff] [blame] | 312 | .. _Armv7-A and Armv8-A: https://developer.arm.com/products/architecture/a-profile |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 313 | .. _Secure Monitor: http://www.arm.com/products/processors/technologies/trustzone/tee-smc.php |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 314 | .. _Power State Coordination Interface (PSCI): PSCI_ |
| 315 | .. _PSCI: http://infocenter.arm.com/help/topic/com.arm.doc.den0022d/Power_State_Coordination_Interface_PDD_v1_1_DEN0022D.pdf |
Sandrine Bailleux | 3091842 | 2019-04-24 10:41:24 +0200 | [diff] [blame] | 316 | .. _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 | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 317 | .. _SMC Calling Convention: http://infocenter.arm.com/help/topic/com.arm.doc.den0028b/ARM_DEN0028B_SMC_Calling_Convention.pdf |
Paul Beesley | 2bb814c | 2019-01-10 15:42:39 +0000 | [diff] [blame] | 318 | .. _System Control and Management Interface (SCMI): SCMI_ |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 319 | .. _SCMI: http://infocenter.arm.com/help/topic/com.arm.doc.den0056a/DEN0056A_System_Control_and_Management_Interface.pdf |
danh-arm | 190e4fa | 2018-03-20 17:01:39 +0000 | [diff] [blame] | 320 | .. _Software Delegated Exception Interface (SDEI): SDEI_ |
Dan Handley | cc573cb | 2018-03-14 13:01:39 +0000 | [diff] [blame] | 321 | .. _SDEI: http://infocenter.arm.com/help/topic/com.arm.doc.den0054a/ARM_DEN0054A_Software_Delegated_Exception_Interface.pdf |
Dan Handley | 610e7e1 | 2018-03-01 18:44:00 +0000 | [diff] [blame] | 322 | .. _Juno Arm Development Platform: http://www.arm.com/products/tools/development-boards/versatile-express/juno-arm-development-platform.php |
| 323 | .. _Arm FVP website: FVP_ |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 324 | .. _FVP: https://developer.arm.com/products/system-design/fixed-virtual-platforms |
Joanna Farley | 325ef90 | 2018-09-11 15:51:31 +0100 | [diff] [blame] | 325 | .. _Linaro Release 18.04: https://community.arm.com/dev-platforms/b/documents/posts/linaro-release-notes-deprecated#LinaroRelease18.04 |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 326 | .. _OP-TEE Secure OS: https://github.com/OP-TEE/optee_os |
Paul Beesley | fb80fe0 | 2019-01-10 15:53:12 +0000 | [diff] [blame] | 327 | .. _NVIDIA Trusted Little Kernel: http://nv-tegra.nvidia.com/gitweb/?p=3rdparty/ote_partner/tlk.git;a=summary |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 328 | .. _Trusty Secure OS: https://source.android.com/security/trusty |
Louis Mayencourt | 72ef3d4 | 2019-03-22 11:47:22 +0000 | [diff] [blame] | 329 | .. _trustedfirmware.org: https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git |
John Tsichritzis | 55478d9 | 2019-04-11 17:23:32 +0100 | [diff] [blame] | 330 | .. _issue tracker: https://developer.trustedfirmware.org/project/board/1/ |
John Tsichritzis | 1f9be34 | 2019-05-24 12:27:49 +0100 | [diff] [blame] | 331 | .. _Security Center: ./docs/process/security.rst |
Dan Handley | ed09d38 | 2017-07-05 17:40:29 +0100 | [diff] [blame] | 332 | .. _license: ./license.rst |
John Tsichritzis | 1f9be34 | 2019-05-24 12:27:49 +0100 | [diff] [blame] | 333 | .. _Contributing Guidelines: ./docs/process/contributing.rst |
| 334 | .. _Acknowledgments: ./docs/acknowledgements.rst |
| 335 | .. _Firmware Design: ./docs/design/firmware-design.rst |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 336 | .. _Change Log: ./docs/change-log.rst |
John Tsichritzis | e14a9bb | 2019-05-28 12:45:06 +0100 | [diff] [blame] | 337 | .. _User Guide: ./docs/getting_started/user-guide.rst |
| 338 | .. _Porting Guide: ./docs/getting_started/porting-guide.rst |
Antonio Nino Diaz | cf0f805 | 2018-08-17 10:45:47 +0100 | [diff] [blame] | 339 | .. _FreeBSD: http://www.freebsd.org |
| 340 | .. _SCC: http://www.simple-cc.org/ |
Joel Hutton | 0f79fb1 | 2019-02-26 16:23:54 +0000 | [diff] [blame] | 341 | .. _Security Advisory TFV-1: ./docs/security_advisories/security-advisory-tfv-1.rst |
| 342 | .. _Security Advisory TFV-2: ./docs/security_advisories/security-advisory-tfv-2.rst |
| 343 | .. _Security Advisory TFV-3: ./docs/security_advisories/security-advisory-tfv-3.rst |
| 344 | .. _Security Advisory TFV-4: ./docs/security_advisories/security-advisory-tfv-4.rst |
| 345 | .. _Security Advisory TFV-5: ./docs/security_advisories/security-advisory-tfv-5.rst |
| 346 | .. _Security Advisory TFV-6: ./docs/security_advisories/security-advisory-tfv-6.rst |
| 347 | .. _Security Advisory TFV-7: ./docs/security_advisories/security-advisory-tfv-7.rst |
| 348 | .. _Security Advisory TFV-8: ./docs/security_advisories/security-advisory-tfv-8.rst |
Paul Beesley | fc11863 | 2019-03-25 16:45:23 +0000 | [diff] [blame] | 349 | .. _Trusted Firmware-A Documentation Contents: ./docs/contents.rst |