Dan Handley | 610e7e1 | 2018-03-01 18:44:00 +0000 | [diff] [blame] | 1 | Arm CPU Specific Build Macros |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 2 | ============================= |
| 3 | |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 4 | This document describes the various build options present in the CPU specific |
| 5 | operations framework to enable errata workarounds and to enable optimizations |
| 6 | for a specific CPU on a platform. |
| 7 | |
Dimitris Papastamos | 446f7f1 | 2017-11-30 14:53:53 +0000 | [diff] [blame] | 8 | Security Vulnerability Workarounds |
| 9 | ---------------------------------- |
| 10 | |
Dan Handley | 610e7e1 | 2018-03-01 18:44:00 +0000 | [diff] [blame] | 11 | TF-A exports a series of build flags which control which security |
| 12 | vulnerability workarounds should be applied at runtime. |
Dimitris Papastamos | 446f7f1 | 2017-11-30 14:53:53 +0000 | [diff] [blame] | 13 | |
| 14 | - ``WORKAROUND_CVE_2017_5715``: Enables the security workaround for |
Dimitris Papastamos | 6d1f499 | 2018-03-28 12:06:40 +0100 | [diff] [blame] | 15 | `CVE-2017-5715`_. This flag can be set to 0 by the platform if none |
| 16 | of the PEs in the system need the workaround. Setting this flag to 0 provides |
| 17 | no performance benefit for non-affected platforms, it just helps to comply |
| 18 | with the recommendation in the spec regarding workaround discovery. |
| 19 | Defaults to 1. |
Dimitris Papastamos | 446f7f1 | 2017-11-30 14:53:53 +0000 | [diff] [blame] | 20 | |
Dimitris Papastamos | e6625ec | 2018-04-05 14:38:26 +0100 | [diff] [blame] | 21 | - ``WORKAROUND_CVE_2018_3639``: Enables the security workaround for |
| 22 | `CVE-2018-3639`_. Defaults to 1. The TF-A project recommends to keep |
| 23 | the default value of 1 even on platforms that are unaffected by |
| 24 | CVE-2018-3639, in order to comply with the recommendation in the spec |
| 25 | regarding workaround discovery. |
| 26 | |
Dimitris Papastamos | ba51d9e | 2018-05-16 11:36:14 +0100 | [diff] [blame] | 27 | - ``DYNAMIC_WORKAROUND_CVE_2018_3639``: Enables dynamic mitigation for |
| 28 | `CVE-2018-3639`_. This build option should be set to 1 if the target |
| 29 | platform contains at least 1 CPU that requires dynamic mitigation. |
| 30 | Defaults to 0. |
| 31 | |
Paul Beesley | f864067 | 2019-04-12 14:19:42 +0100 | [diff] [blame] | 32 | .. _arm_cpu_macros_errata_workarounds: |
| 33 | |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 34 | CPU Errata Workarounds |
| 35 | ---------------------- |
| 36 | |
Dan Handley | 610e7e1 | 2018-03-01 18:44:00 +0000 | [diff] [blame] | 37 | TF-A exports a series of build flags which control the errata workarounds that |
| 38 | are applied to each CPU by the reset handler. The errata details can be found |
| 39 | in the CPU specific errata documents published by Arm: |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 40 | |
| 41 | - `Cortex-A53 MPCore Software Developers Errata Notice`_ |
| 42 | - `Cortex-A57 MPCore Software Developers Errata Notice`_ |
Eleanor Bonnici | c3b4ca1 | 2017-08-02 18:33:41 +0100 | [diff] [blame] | 43 | - `Cortex-A72 MPCore Software Developers Errata Notice`_ |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 44 | |
| 45 | The errata workarounds are implemented for a particular revision or a set of |
| 46 | processor revisions. This is checked by the reset handler at runtime. Each |
| 47 | errata workaround is identified by its ``ID`` as specified in the processor's |
| 48 | errata notice document. The format of the define used to enable/disable the |
| 49 | errata workaround is ``ERRATA_<Processor name>_<ID>``, where the ``Processor name`` |
| 50 | is for example ``A57`` for the ``Cortex_A57`` CPU. |
| 51 | |
Paul Beesley | f864067 | 2019-04-12 14:19:42 +0100 | [diff] [blame] | 52 | Refer to :ref:`firmware_design_cpu_errata_reporting` for information on how to |
| 53 | write errata workaround functions. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 54 | |
| 55 | All workarounds are disabled by default. The platform is responsible for |
| 56 | enabling these workarounds according to its requirement by defining the |
| 57 | errata workaround build flags in the platform specific makefile. In case |
| 58 | these workarounds are enabled for the wrong CPU revision then the errata |
| 59 | workaround is not applied. In the DEBUG build, this is indicated by |
| 60 | printing a warning to the crash console. |
| 61 | |
| 62 | In the current implementation, a platform which has more than 1 variant |
| 63 | with different revisions of a processor has no runtime mechanism available |
| 64 | for it to specify which errata workarounds should be enabled or not. |
| 65 | |
John Tsichritzis | 4daa1de | 2018-07-23 09:11:59 +0100 | [diff] [blame] | 66 | The value of the build flags is 0 by default, that is, disabled. A value of 1 |
| 67 | will enable it. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 68 | |
Joel Hutton | 26d1676 | 2019-04-10 12:52:52 +0100 | [diff] [blame] | 69 | For Cortex-A9, the following errata build flags are defined : |
| 70 | |
Louis Mayencourt | e6469d5 | 2019-04-18 12:11:25 +0100 | [diff] [blame] | 71 | - ``ERRATA_A9_794073``: This applies errata 794073 workaround to Cortex-A9 |
Joel Hutton | 26d1676 | 2019-04-10 12:52:52 +0100 | [diff] [blame] | 72 | CPU. This needs to be enabled for all revisions of the CPU. |
| 73 | |
Ambroise Vincent | d4a51eb | 2019-03-04 16:56:26 +0000 | [diff] [blame] | 74 | For Cortex-A15, the following errata build flags are defined : |
| 75 | |
| 76 | - ``ERRATA_A15_816470``: This applies errata 816470 workaround to Cortex-A15 |
| 77 | CPU. This needs to be enabled only for revision >= r3p0 of the CPU. |
| 78 | |
Ambroise Vincent | 68b3812 | 2019-03-05 09:54:21 +0000 | [diff] [blame] | 79 | - ``ERRATA_A15_827671``: This applies errata 827671 workaround to Cortex-A15 |
| 80 | CPU. This needs to be enabled only for revision >= r3p0 of the CPU. |
| 81 | |
Ambroise Vincent | 8cf9eef | 2019-02-28 16:23:53 +0000 | [diff] [blame] | 82 | For Cortex-A17, the following errata build flags are defined : |
| 83 | |
| 84 | - ``ERRATA_A17_852421``: This applies errata 852421 workaround to Cortex-A17 |
| 85 | CPU. This needs to be enabled only for revision <= r1p2 of the CPU. |
| 86 | |
Ambroise Vincent | fa5c951 | 2019-03-04 13:20:56 +0000 | [diff] [blame] | 87 | - ``ERRATA_A17_852423``: This applies errata 852423 workaround to Cortex-A17 |
| 88 | CPU. This needs to be enabled only for revision <= r1p2 of the CPU. |
| 89 | |
Louis Mayencourt | 8a06127 | 2019-04-05 16:25:25 +0100 | [diff] [blame] | 90 | For Cortex-A35, the following errata build flags are defined : |
| 91 | |
| 92 | - ``ERRATA_A35_855472``: This applies errata 855472 workaround to Cortex-A35 |
| 93 | CPUs. This needs to be enabled only for revision r0p0 of Cortex-A35. |
| 94 | |
John Tsichritzis | 4daa1de | 2018-07-23 09:11:59 +0100 | [diff] [blame] | 95 | For Cortex-A53, the following errata build flags are defined : |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 96 | |
Ambroise Vincent | f5fdfbc | 2019-02-21 14:16:24 +0000 | [diff] [blame] | 97 | - ``ERRATA_A53_819472``: This applies errata 819472 workaround to all |
| 98 | CPUs. This needs to be enabled only for revision <= r0p1 of Cortex-A53. |
| 99 | |
| 100 | - ``ERRATA_A53_824069``: This applies errata 824069 workaround to all |
| 101 | CPUs. This needs to be enabled only for revision <= r0p2 of Cortex-A53. |
| 102 | |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 103 | - ``ERRATA_A53_826319``: This applies errata 826319 workaround to Cortex-A53 |
| 104 | CPU. This needs to be enabled only for revision <= r0p2 of the CPU. |
| 105 | |
Ambroise Vincent | f5fdfbc | 2019-02-21 14:16:24 +0000 | [diff] [blame] | 106 | - ``ERRATA_A53_827319``: This applies errata 827319 workaround to all |
| 107 | CPUs. This needs to be enabled only for revision <= r0p2 of Cortex-A53. |
| 108 | |
Douglas Raillard | b52353a | 2017-07-17 14:14:52 +0100 | [diff] [blame] | 109 | - ``ERRATA_A53_835769``: This applies erratum 835769 workaround at compile and |
| 110 | link time to Cortex-A53 CPU. This needs to be enabled for some variants of |
| 111 | revision <= r0p4. This workaround can lead the linker to create ``*.stub`` |
| 112 | sections. |
| 113 | |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 114 | - ``ERRATA_A53_836870``: This applies errata 836870 workaround to Cortex-A53 |
| 115 | CPU. This needs to be enabled only for revision <= r0p3 of the CPU. From |
| 116 | r0p4 and onwards, this errata is enabled by default in hardware. |
| 117 | |
Douglas Raillard | b52353a | 2017-07-17 14:14:52 +0100 | [diff] [blame] | 118 | - ``ERRATA_A53_843419``: This applies erratum 843419 workaround at link time |
| 119 | to Cortex-A53 CPU. This needs to be enabled for some variants of revision |
| 120 | <= r0p4. This workaround can lead the linker to emit ``*.stub`` sections |
| 121 | which are 4kB aligned. |
| 122 | |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 123 | - ``ERRATA_A53_855873``: This applies errata 855873 workaround to Cortex-A53 |
| 124 | CPUs. Though the erratum is present in every revision of the CPU, |
| 125 | this workaround is only applied to CPUs from r0p3 onwards, which feature |
Sandrine Bailleux | 15530dd | 2019-02-08 15:26:36 +0100 | [diff] [blame] | 126 | a chicken bit in CPUACTLR_EL1 to enable a hardware workaround. |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 127 | Earlier revisions of the CPU have other errata which require the same |
| 128 | workaround in software, so they should be covered anyway. |
| 129 | |
Manish V Badarkhe | a59fa01 | 2020-07-31 08:38:49 +0100 | [diff] [blame] | 130 | - ``ERRATA_A53_1530924``: This applies errata 1530924 workaround to all |
| 131 | revisions of Cortex-A53 CPU. |
| 132 | |
Ambroise Vincent | 7927fa0 | 2019-02-21 16:20:43 +0000 | [diff] [blame] | 133 | For Cortex-A55, the following errata build flags are defined : |
| 134 | |
| 135 | - ``ERRATA_A55_768277``: This applies errata 768277 workaround to Cortex-A55 |
| 136 | CPU. This needs to be enabled only for revision r0p0 of the CPU. |
| 137 | |
Ambroise Vincent | 6f31960 | 2019-02-21 16:25:37 +0000 | [diff] [blame] | 138 | - ``ERRATA_A55_778703``: This applies errata 778703 workaround to Cortex-A55 |
| 139 | CPU. This needs to be enabled only for revision r0p0 of the CPU. |
| 140 | |
Ambroise Vincent | 6a77f05 | 2019-02-21 16:27:34 +0000 | [diff] [blame] | 141 | - ``ERRATA_A55_798797``: This applies errata 798797 workaround to Cortex-A55 |
| 142 | CPU. This needs to be enabled only for revision r0p0 of the CPU. |
| 143 | |
Ambroise Vincent | dd961f7 | 2019-02-21 16:29:16 +0000 | [diff] [blame] | 144 | - ``ERRATA_A55_846532``: This applies errata 846532 workaround to Cortex-A55 |
| 145 | CPU. This needs to be enabled only for revision <= r0p1 of the CPU. |
| 146 | |
Ambroise Vincent | a1d6446 | 2019-02-21 16:29:50 +0000 | [diff] [blame] | 147 | - ``ERRATA_A55_903758``: This applies errata 903758 workaround to Cortex-A55 |
| 148 | CPU. This needs to be enabled only for revision <= r0p1 of the CPU. |
| 149 | |
Ambroise Vincent | b72fe7a | 2019-05-28 09:52:48 +0100 | [diff] [blame] | 150 | - ``ERRATA_A55_1221012``: This applies errata 1221012 workaround to Cortex-A55 |
| 151 | CPU. This needs to be enabled only for revision <= r1p0 of the CPU. |
| 152 | |
Manish V Badarkhe | a59fa01 | 2020-07-31 08:38:49 +0100 | [diff] [blame] | 153 | - ``ERRATA_A55_1530923``: This applies errata 1530923 workaround to all |
| 154 | revisions of Cortex-A55 CPU. |
| 155 | |
John Tsichritzis | 4daa1de | 2018-07-23 09:11:59 +0100 | [diff] [blame] | 156 | For Cortex-A57, the following errata build flags are defined : |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 157 | |
| 158 | - ``ERRATA_A57_806969``: This applies errata 806969 workaround to Cortex-A57 |
| 159 | CPU. This needs to be enabled only for revision r0p0 of the CPU. |
| 160 | |
| 161 | - ``ERRATA_A57_813419``: This applies errata 813419 workaround to Cortex-A57 |
| 162 | CPU. This needs to be enabled only for revision r0p0 of the CPU. |
| 163 | |
| 164 | - ``ERRATA_A57_813420``: This applies errata 813420 workaround to Cortex-A57 |
| 165 | CPU. This needs to be enabled only for revision r0p0 of the CPU. |
| 166 | |
Ambroise Vincent | 1b0db76 | 2019-02-21 16:35:07 +0000 | [diff] [blame] | 167 | - ``ERRATA_A57_814670``: This applies errata 814670 workaround to Cortex-A57 |
| 168 | CPU. This needs to be enabled only for revision r0p0 of the CPU. |
| 169 | |
Ambroise Vincent | aa2c029 | 2019-02-21 16:35:49 +0000 | [diff] [blame] | 170 | - ``ERRATA_A57_817169``: This applies errata 817169 workaround to Cortex-A57 |
| 171 | CPU. This needs to be enabled only for revision <= r0p1 of the CPU. |
| 172 | |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 173 | - ``ERRATA_A57_826974``: This applies errata 826974 workaround to Cortex-A57 |
| 174 | CPU. This needs to be enabled only for revision <= r1p1 of the CPU. |
| 175 | |
| 176 | - ``ERRATA_A57_826977``: This applies errata 826977 workaround to Cortex-A57 |
| 177 | CPU. This needs to be enabled only for revision <= r1p1 of the CPU. |
| 178 | |
| 179 | - ``ERRATA_A57_828024``: This applies errata 828024 workaround to Cortex-A57 |
| 180 | CPU. This needs to be enabled only for revision <= r1p1 of the CPU. |
| 181 | |
| 182 | - ``ERRATA_A57_829520``: This applies errata 829520 workaround to Cortex-A57 |
| 183 | CPU. This needs to be enabled only for revision <= r1p2 of the CPU. |
| 184 | |
| 185 | - ``ERRATA_A57_833471``: This applies errata 833471 workaround to Cortex-A57 |
| 186 | CPU. This needs to be enabled only for revision <= r1p2 of the CPU. |
| 187 | |
Eleanor Bonnici | 0c9bd27 | 2017-08-02 16:35:04 +0100 | [diff] [blame] | 188 | - ``ERRATA_A57_859972``: This applies errata 859972 workaround to Cortex-A57 |
| 189 | CPU. This needs to be enabled only for revision <= r1p3 of the CPU. |
| 190 | |
Manish V Badarkhe | a59fa01 | 2020-07-31 08:38:49 +0100 | [diff] [blame] | 191 | - ``ERRATA_A57_1319537``: This applies errata 1319537 workaround to all |
| 192 | revisions of Cortex-A57 CPU. |
Eleanor Bonnici | c3b4ca1 | 2017-08-02 18:33:41 +0100 | [diff] [blame] | 193 | |
John Tsichritzis | 4daa1de | 2018-07-23 09:11:59 +0100 | [diff] [blame] | 194 | For Cortex-A72, the following errata build flags are defined : |
Eleanor Bonnici | c3b4ca1 | 2017-08-02 18:33:41 +0100 | [diff] [blame] | 195 | |
| 196 | - ``ERRATA_A72_859971``: This applies errata 859971 workaround to Cortex-A72 |
| 197 | CPU. This needs to be enabled only for revision <= r0p3 of the CPU. |
| 198 | |
Manish V Badarkhe | a59fa01 | 2020-07-31 08:38:49 +0100 | [diff] [blame] | 199 | - ``ERRATA_A72_1319367``: This applies errata 1319367 workaround to all |
| 200 | revisions of Cortex-A72 CPU. |
| 201 | |
Louis Mayencourt | 4405de6 | 2019-02-21 16:38:16 +0000 | [diff] [blame] | 202 | For Cortex-A73, the following errata build flags are defined : |
| 203 | |
Louis Mayencourt | d69722c | 2019-02-27 14:24:16 +0000 | [diff] [blame] | 204 | - ``ERRATA_A73_852427``: This applies errata 852427 workaround to Cortex-A73 |
| 205 | CPU. This needs to be enabled only for revision r0p0 of the CPU. |
| 206 | |
Louis Mayencourt | 4405de6 | 2019-02-21 16:38:16 +0000 | [diff] [blame] | 207 | - ``ERRATA_A73_855423``: This applies errata 855423 workaround to Cortex-A73 |
| 208 | CPU. This needs to be enabled only for revision <= r0p1 of the CPU. |
| 209 | |
Louis Mayencourt | 78a0aed | 2019-02-20 12:11:41 +0000 | [diff] [blame] | 210 | For Cortex-A75, the following errata build flags are defined : |
| 211 | |
| 212 | - ``ERRATA_A75_764081``: This applies errata 764081 workaround to Cortex-A75 |
| 213 | CPU. This needs to be enabled only for revision r0p0 of the CPU. |
| 214 | |
Louis Mayencourt | 8d86870 | 2019-02-25 14:57:57 +0000 | [diff] [blame] | 215 | - ``ERRATA_A75_790748``: This applies errata 790748 workaround to Cortex-A75 |
| 216 | CPU. This needs to be enabled only for revision r0p0 of the CPU. |
| 217 | |
Louis Mayencourt | 0992447 | 2019-02-21 17:35:07 +0000 | [diff] [blame] | 218 | For Cortex-A76, the following errata build flags are defined : |
| 219 | |
Louis Mayencourt | 59fa218 | 2019-02-25 15:17:44 +0000 | [diff] [blame] | 220 | - ``ERRATA_A76_1073348``: This applies errata 1073348 workaround to Cortex-A76 |
| 221 | CPU. This needs to be enabled only for revision <= r1p0 of the CPU. |
| 222 | |
Louis Mayencourt | 0992447 | 2019-02-21 17:35:07 +0000 | [diff] [blame] | 223 | - ``ERRATA_A76_1130799``: This applies errata 1130799 workaround to Cortex-A76 |
| 224 | CPU. This needs to be enabled only for revision <= r2p0 of the CPU. |
| 225 | |
Louis Mayencourt | adda9d4 | 2019-02-25 11:37:38 +0000 | [diff] [blame] | 226 | - ``ERRATA_A76_1220197``: This applies errata 1220197 workaround to Cortex-A76 |
| 227 | CPU. This needs to be enabled only for revision <= r2p0 of the CPU. |
| 228 | |
Soby Mathew | 1d3ba1c | 2019-05-01 09:43:18 +0100 | [diff] [blame] | 229 | - ``ERRATA_A76_1257314``: This applies errata 1257314 workaround to Cortex-A76 |
| 230 | CPU. This needs to be enabled only for revision <= r3p0 of the CPU. |
| 231 | |
| 232 | - ``ERRATA_A76_1262606``: This applies errata 1262606 workaround to Cortex-A76 |
| 233 | CPU. This needs to be enabled only for revision <= r3p0 of the CPU. |
| 234 | |
| 235 | - ``ERRATA_A76_1262888``: This applies errata 1262888 workaround to Cortex-A76 |
| 236 | CPU. This needs to be enabled only for revision <= r3p0 of the CPU. |
| 237 | |
| 238 | - ``ERRATA_A76_1275112``: This applies errata 1275112 workaround to Cortex-A76 |
| 239 | CPU. This needs to be enabled only for revision <= r3p0 of the CPU. |
| 240 | |
johpow01 | 9603f98 | 2020-05-29 14:17:38 -0500 | [diff] [blame] | 241 | - ``ERRATA_A76_1791580``: This applies errata 1791580 workaround to Cortex-A76 |
| 242 | CPU. This needs to be enabled only for revision <= r4p0 of the CPU. |
| 243 | |
Manish V Badarkhe | a59fa01 | 2020-07-31 08:38:49 +0100 | [diff] [blame] | 244 | - ``ERRATA_A76_1165522``: This applies errata 1165522 workaround to all |
| 245 | revisions of Cortex-A76 CPU. This errata is fixed in r3p0 but due to |
| 246 | limitation of errata framework this errata is applied to all revisions |
| 247 | of Cortex-A76 CPU. |
| 248 | |
johpow01 | 81365e3 | 2020-09-29 17:19:09 -0500 | [diff] [blame] | 249 | - ``ERRATA_A76_1868343``: This applies errata 1868343 workaround to Cortex-A76 |
| 250 | CPU. This needs to be enabled only for revision <= r4p0 of the CPU. |
| 251 | |
johpow01 | 3e34e92 | 2020-12-15 19:02:18 -0600 | [diff] [blame] | 252 | - ``ERRATA_A76_1946160``: This applies errata 1946160 workaround to Cortex-A76 |
| 253 | CPU. This needs to be enabled only for revisions r3p0 - r4p1 of the CPU. |
| 254 | |
johpow01 | 68aedc7 | 2020-06-03 15:23:31 -0500 | [diff] [blame] | 255 | For Cortex-A77, the following errata build flags are defined : |
| 256 | |
laurenw-arm | 99ad976 | 2020-07-14 14:18:34 -0500 | [diff] [blame] | 257 | - ``ERRATA_A77_1508412``: This applies errata 1508412 workaround to Cortex-A77 |
| 258 | CPU. This needs to be enabled only for revision <= r1p0 of the CPU. |
| 259 | |
johpow01 | a2fa12c | 2020-09-10 13:39:26 -0500 | [diff] [blame] | 260 | - ``ERRATA_A77_1925769``: This applies errata 1925769 workaround to Cortex-A77 |
| 261 | CPU. This needs to be enabled only for revision <= r1p1 of the CPU. |
| 262 | |
laurenw-arm | f5dbbef | 2021-03-23 13:09:35 -0500 | [diff] [blame] | 263 | - ``ERRATA_A77_1946167``: This applies errata 1946167 workaround to Cortex-A77 |
| 264 | CPU. This needs to be enabled only for revision <= r1p1 of the CPU. |
| 265 | |
johpow01 | eb14610 | 2021-05-03 13:37:13 -0500 | [diff] [blame] | 266 | - ``ERRATA_A77_1791578``: This applies errata 1791578 workaround to Cortex-A77 |
| 267 | CPU. This needs to be enabled for r0p0, r1p0, and r1p1, it is still open. |
| 268 | |
Jimmy Brisson | 3571fb9 | 2020-06-01 10:18:22 -0500 | [diff] [blame] | 269 | For Cortex-A78, the following errata build flags are defined : |
Madhukar Pappireddy | 4efede7 | 2019-12-18 15:56:27 -0600 | [diff] [blame] | 270 | |
Jimmy Brisson | 3571fb9 | 2020-06-01 10:18:22 -0500 | [diff] [blame] | 271 | - ``ERRATA_A78_1688305``: This applies errata 1688305 workaround to Cortex-A78 |
| 272 | CPU. This needs to be enabled only for revision r0p0 - r1p0 of the CPU. |
Madhukar Pappireddy | 4efede7 | 2019-12-18 15:56:27 -0600 | [diff] [blame] | 273 | |
johpow01 | 9131eb8 | 2020-10-06 17:55:25 -0500 | [diff] [blame] | 274 | - ``ERRATA_A78_1941498``: This applies errata 1941498 workaround to Cortex-A78 |
| 275 | CPU. This needs to be enabled for revisions r0p0, r1p0, and r1p1 of the CPU. |
| 276 | |
johpow01 | 85ea43d | 2020-10-07 15:08:01 -0500 | [diff] [blame] | 277 | - ``ERRATA_A78_1951500``: This applies errata 1951500 workaround to Cortex-A78 |
| 278 | CPU. This needs to be enabled for revisions r1p0 and r1p1, r0p0 has the same |
| 279 | issue but there is no workaround for that revision. |
| 280 | |
johpow01 | b3e8294 | 2021-04-30 18:08:52 -0500 | [diff] [blame] | 281 | - ``ERRATA_A78_1821534``: This applies errata 1821534 workaround to Cortex-A78 |
| 282 | CPU. This needs to be enabled for revisions r0p0 and r1p0. |
| 283 | |
nayanpatel-arm | 80bf7a5 | 2021-08-11 13:33:00 -0700 | [diff] [blame] | 284 | - ``ERRATA_A78_1952683``: This applies errata 1952683 workaround to Cortex-A78 |
| 285 | CPU. This needs to be enabled for revision r0p0, it is fixed in r1p0. |
| 286 | |
nayanpatel-arm | 39e0865 | 2021-09-28 17:31:50 -0700 | [diff] [blame] | 287 | - ``ERRATA_A78_2132060``: This applies errata 2132060 workaround to Cortex-A78 |
| 288 | CPU. This needs to be enabled for revisions r0p0, r1p0, r1p1, and r1p2. It |
| 289 | is still open. |
| 290 | |
Varun Wadekar | a3110ad | 2021-07-27 00:39:40 -0700 | [diff] [blame] | 291 | For Cortex-A78 AE, the following errata build flags are defined : |
| 292 | |
Varun Wadekar | 0914fc4 | 2021-07-27 02:32:29 -0700 | [diff] [blame] | 293 | - ``ERRATA_A78_AE_1941500`` : This applies errata 1941500 workaround to Cortex-A78 |
| 294 | AE CPU. This needs to be enabled for revisions r0p0 and r0p1. This erratum is |
| 295 | still open. |
| 296 | |
Varun Wadekar | a3110ad | 2021-07-27 00:39:40 -0700 | [diff] [blame] | 297 | - ``ERRATA_A78_AE_1951502`` : This applies errata 1951502 workaround to Cortex-A78 |
| 298 | AE CPU. This needs to be enabled for revisions r0p0 and r0p1. This erratum is |
| 299 | still open. |
| 300 | |
lauwal01 | bd555f4 | 2019-06-24 11:23:50 -0500 | [diff] [blame] | 301 | For Neoverse N1, the following errata build flags are defined : |
| 302 | |
| 303 | - ``ERRATA_N1_1073348``: This applies errata 1073348 workaround to Neoverse-N1 |
| 304 | CPU. This needs to be enabled only for revision r0p0 and r1p0 of the CPU. |
| 305 | |
lauwal01 | 363ee3c | 2019-06-24 11:28:34 -0500 | [diff] [blame] | 306 | - ``ERRATA_N1_1130799``: This applies errata 1130799 workaround to Neoverse-N1 |
| 307 | CPU. This needs to be enabled only for revision <= r2p0 of the CPU. |
| 308 | |
lauwal01 | f2adb13 | 2019-06-24 11:32:40 -0500 | [diff] [blame] | 309 | - ``ERRATA_N1_1165347``: This applies errata 1165347 workaround to Neoverse-N1 |
| 310 | CPU. This needs to be enabled only for revision <= r2p0 of the CPU. |
| 311 | |
lauwal01 | e159044 | 2019-06-24 11:35:37 -0500 | [diff] [blame] | 312 | - ``ERRATA_N1_1207823``: This applies errata 1207823 workaround to Neoverse-N1 |
| 313 | CPU. This needs to be enabled only for revision <= r2p0 of the CPU. |
| 314 | |
lauwal01 | 197f14c | 2019-06-24 11:38:53 -0500 | [diff] [blame] | 315 | - ``ERRATA_N1_1220197``: This applies errata 1220197 workaround to Neoverse-N1 |
| 316 | CPU. This needs to be enabled only for revision <= r2p0 of the CPU. |
| 317 | |
lauwal01 | 07c2a23 | 2019-06-24 11:42:02 -0500 | [diff] [blame] | 318 | - ``ERRATA_N1_1257314``: This applies errata 1257314 workaround to Neoverse-N1 |
| 319 | CPU. This needs to be enabled only for revision <= r3p0 of the CPU. |
| 320 | |
lauwal01 | 42771af | 2019-06-24 11:44:58 -0500 | [diff] [blame] | 321 | - ``ERRATA_N1_1262606``: This applies errata 1262606 workaround to Neoverse-N1 |
| 322 | CPU. This needs to be enabled only for revision <= r3p0 of the CPU. |
| 323 | |
lauwal01 | 00396bf | 2019-06-24 11:47:30 -0500 | [diff] [blame] | 324 | - ``ERRATA_N1_1262888``: This applies errata 1262888 workaround to Neoverse-N1 |
| 325 | CPU. This needs to be enabled only for revision <= r3p0 of the CPU. |
| 326 | |
lauwal01 | 644b6ed | 2019-06-24 11:49:01 -0500 | [diff] [blame] | 327 | - ``ERRATA_N1_1275112``: This applies errata 1275112 workaround to Neoverse-N1 |
| 328 | CPU. This needs to be enabled only for revision <= r3p0 of the CPU. |
| 329 | |
Andre Przywara | b934740 | 2019-05-20 14:57:06 +0100 | [diff] [blame] | 330 | - ``ERRATA_N1_1315703``: This applies errata 1315703 workaround to Neoverse-N1 |
| 331 | CPU. This needs to be enabled only for revision <= r3p0 of the CPU. |
| 332 | |
laurenw-arm | 94accd3 | 2019-08-20 15:51:24 -0500 | [diff] [blame] | 333 | - ``ERRATA_N1_1542419``: This applies errata 1542419 workaround to Neoverse-N1 |
| 334 | CPU. This needs to be enabled only for revisions r3p0 - r4p0 of the CPU. |
| 335 | |
johpow01 | e2428fd | 2020-08-05 12:27:12 -0500 | [diff] [blame] | 336 | - ``ERRATA_N1_1868343``: This applies errata 1868343 workaround to Neoverse-N1 |
| 337 | CPU. This needs to be enabled only for revision <= r4p0 of the CPU. |
| 338 | |
johpow01 | f1a84f5 | 2020-10-07 14:33:15 -0500 | [diff] [blame] | 339 | - ``ERRATA_N1_1946160``: This applies errata 1946160 workaround to Neoverse-N1 |
| 340 | CPU. This needs to be enabled for revisions r3p0, r3p1, r4p0, and r4p1, for |
| 341 | revisions r0p0, r1p0, and r2p0 there is no workaround. |
| 342 | |
nayanpatel-arm | 277581e | 2021-08-06 17:46:10 -0700 | [diff] [blame] | 343 | For Neoverse N2, the following errata build flags are defined : |
| 344 | |
| 345 | - ``ERRATA_N2_2002655``: This applies errata 2002655 workaround to Neoverse-N2 |
| 346 | CPU. This needs to be enabled for revision r0p0 of the CPU, it is still open. |
| 347 | |
johpow01 | c73b03c | 2021-05-03 15:33:39 -0500 | [diff] [blame] | 348 | For Neoverse V1, the following errata build flags are defined : |
| 349 | |
laurenw-arm | 3c86d83 | 2021-08-02 13:22:32 -0500 | [diff] [blame] | 350 | - ``ERRATA_V1_1774420``: This applies errata 1774420 workaround to Neoverse-V1 |
| 351 | CPU. This needs to be enabled only for revisions r0p0 and r1p0, it is fixed |
| 352 | in r1p1. |
| 353 | |
johpow01 | c73b03c | 2021-05-03 15:33:39 -0500 | [diff] [blame] | 354 | - ``ERRATA_V1_1791573``: This applies errata 1791573 workaround to Neoverse-V1 |
| 355 | CPU. This needs to be enabled only for revisions r0p0 and r1p0, it is fixed |
| 356 | in r1p1. |
| 357 | |
laurenw-arm | b1923e9 | 2021-08-02 14:40:08 -0500 | [diff] [blame] | 358 | - ``ERRATA_V1_1852267``: This applies errata 1852267 workaround to Neoverse-V1 |
| 359 | CPU. This needs to be enabled only for revisions r0p0 and r1p0, it is fixed |
| 360 | in r1p1. |
| 361 | |
laurenw-arm | 6b56f96 | 2021-08-02 15:00:15 -0500 | [diff] [blame] | 362 | - ``ERRATA_V1_1925756``: This applies errata 1925756 workaround to Neoverse-V1 |
| 363 | CPU. This needs to be enabled for r0p0, r1p0, and r1p1, it is still open. |
| 364 | |
johpow01 | 07acb4f | 2020-10-07 16:38:37 -0500 | [diff] [blame] | 365 | - ``ERRATA_V1_1940577``: This applies errata 1940577 workaround to Neoverse-V1 |
| 366 | CPU. This needs to be enabled only for revision r1p0 and r1p1 of the |
| 367 | CPU. |
| 368 | |
johpow01 | 97db675 | 2021-08-02 18:59:08 -0500 | [diff] [blame] | 369 | - ``ERRATA_V1_1966096``: This applies errata 1966096 workaround to Neoverse-V1 |
| 370 | CPU. This needs to be enabled for revisions r1p0 and r1p1 of the CPU, the |
| 371 | issue is present in r0p0 as well but there is no workaround for that |
| 372 | revision. It is still open. |
| 373 | |
johpow01 | ad1ca34 | 2021-08-03 14:35:20 -0500 | [diff] [blame] | 374 | - ``ERRATA_V1_2139242``: This applies errata 2139242 workaround to Neoverse-V1 |
| 375 | CPU. This needs to be enabled for revisions r0p0, r1p0, and r1p1 of the |
| 376 | CPU. It is still open. |
| 377 | |
nayanpatel-arm | fc26ffe | 2021-09-28 13:41:03 -0700 | [diff] [blame] | 378 | - ``ERRATA_V1_2108267``: This applies errata 2108267 workaround to Neoverse-V1 |
| 379 | CPU. This needs to be enabled for revisions r0p0, r1p0, and r1p1 of the CPU. |
| 380 | It is still open. |
| 381 | |
nayanpatel-arm | e55d325 | 2021-08-06 16:39:48 -0700 | [diff] [blame] | 382 | For Cortex-A710, the following errata build flags are defined : |
| 383 | |
| 384 | - ``ERRATA_A710_1987031``: This applies errata 1987031 workaround to |
| 385 | Cortex-A710 CPU. This needs to be enabled only for revisions r0p0, r1p0 and |
| 386 | r2p0 of the CPU. It is still open. |
| 387 | |
nayanpatel-arm | 7597d08 | 2021-08-25 17:35:15 -0700 | [diff] [blame] | 388 | - ``ERRATA_A710_2081180``: This applies errata 2081180 workaround to |
| 389 | Cortex-A710 CPU. This needs to be enabled only for revisions r0p0, r1p0 and |
| 390 | r2p0 of the CPU. It is still open. |
| 391 | |
Bipin Ravi | cd39b14 | 2021-03-31 16:45:40 -0500 | [diff] [blame] | 392 | - ``ERRATA_A710_2055002``: This applies errata 2055002 workaround to |
| 393 | Cortex-A710 CPU. This needs to be enabled for revisions r1p0, r2p0 of the CPU |
| 394 | and is still open. |
| 395 | |
Bipin Ravi | 87e1d28 | 2021-03-31 18:45:55 -0500 | [diff] [blame] | 396 | - ``ERRATA_A710_2017096``: This applies errata 2017096 workaround to |
| 397 | Cortex-A710 CPU. This needs to be enabled for revisions r0p0, r1p0 and r2p0 |
| 398 | of the CPU and is still open. |
| 399 | |
nayanpatel-arm | 0b338b4 | 2021-09-16 15:27:53 -0700 | [diff] [blame] | 400 | - ``ERRATA_A710_2083908``: This applies errata 2083908 workaround to |
| 401 | Cortex-A710 CPU. This needs to be enabled for revision r2p0 of the CPU and |
| 402 | is still open. |
| 403 | |
nayanpatel-arm | f2dce0e | 2021-09-22 12:35:03 -0700 | [diff] [blame] | 404 | - ``ERRATA_A710_2058056``: This applies errata 2058056 workaround to |
| 405 | Cortex-A710 CPU. This needs to be enabled for revisions r0p0, r1p0 and r2p0 |
| 406 | of the CPU and is still open. |
| 407 | |
Bipin Ravi | eb35e85 | 2021-03-30 16:08:32 -0500 | [diff] [blame] | 408 | For Neoverse N2, the following errata build flags are defined : |
| 409 | |
| 410 | - ``ERRATA_N2_2067956``: This applies errata 2067956 workaround to Neoverse-N2 |
| 411 | CPU. This needs to be enabled for revision r0p0 of the CPU and is still open. |
| 412 | |
Bipin Ravi | 7f56547 | 2021-03-31 10:10:27 -0500 | [diff] [blame] | 413 | - ``ERRATA_N2_2025414``: This applies errata 2025414 workaround to Neoverse-N2 |
| 414 | CPU. This needs to be enabled for revision r0p0 of the CPU and is still open. |
| 415 | |
Bipin Ravi | 7e03069 | 2021-08-30 13:02:51 -0500 | [diff] [blame] | 416 | - ``ERRATA_N2_2189731``: This applies errata 2189731 workaround to Neoverse-N2 |
Bipin Ravi | 0ba631c | 2021-09-01 01:36:43 -0500 | [diff] [blame] | 417 | CPU. This needs to be enabled for revision r0p0 of the CPU and is still open. |
| 418 | |
| 419 | - ``ERRATA_N2_2138956``: This applies errata 2138956 workaround to Neoverse-N2 |
| 420 | CPU. This needs to be enabled for revision r0p0 of the CPU and is still open. |
Bipin Ravi | 7e03069 | 2021-08-30 13:02:51 -0500 | [diff] [blame] | 421 | |
nayanpatel-arm | d4c5f9c | 2021-09-28 09:46:45 -0700 | [diff] [blame] | 422 | - ``ERRATA_N2_2138953``: This applies errata 2138953 workaround to Neoverse-N2 |
| 423 | CPU. This needs to be enabled for revision r0p0 of the CPU and is still open. |
| 424 | |
John Tsichritzis | 4daa1de | 2018-07-23 09:11:59 +0100 | [diff] [blame] | 425 | DSU Errata Workarounds |
| 426 | ---------------------- |
| 427 | |
| 428 | Similar to CPU errata, TF-A also implements workarounds for DSU (DynamIQ |
| 429 | Shared Unit) errata. The DSU errata details can be found in the respective Arm |
| 430 | documentation: |
| 431 | |
| 432 | - `Arm DSU Software Developers Errata Notice`_. |
| 433 | |
| 434 | Each erratum is identified by an ``ID``, as defined in the DSU errata notice |
| 435 | document. Thus, the build flags which enable/disable the errata workarounds |
| 436 | have the format ``ERRATA_DSU_<ID>``. The implementation and application logic |
| 437 | of DSU errata workarounds are similar to `CPU errata workarounds`_. |
| 438 | |
| 439 | For DSU errata, the following build flags are defined: |
| 440 | |
Louis Mayencourt | 4498b15 | 2019-04-09 16:29:01 +0100 | [diff] [blame] | 441 | - ``ERRATA_DSU_798953``: This applies errata 798953 workaround for the |
| 442 | affected DSU configurations. This errata applies only for those DSUs that |
| 443 | revision is r0p0 (on r0p1 it is fixed). However, please note that this |
| 444 | workaround results in increased DSU power consumption on idle. |
| 445 | |
John Tsichritzis | 4daa1de | 2018-07-23 09:11:59 +0100 | [diff] [blame] | 446 | - ``ERRATA_DSU_936184``: This applies errata 936184 workaround for the |
| 447 | affected DSU configurations. This errata applies only for those DSUs that |
| 448 | contain the ACP interface **and** the DSU revision is older than r2p0 (on |
| 449 | r2p0 it is fixed). However, please note that this workaround results in |
| 450 | increased DSU power consumption on idle. |
| 451 | |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 452 | CPU Specific optimizations |
| 453 | -------------------------- |
| 454 | |
| 455 | This section describes some of the optimizations allowed by the CPU micro |
| 456 | architecture that can be enabled by the platform as desired. |
| 457 | |
| 458 | - ``SKIP_A57_L1_FLUSH_PWR_DWN``: This flag enables an optimization in the |
| 459 | Cortex-A57 cluster power down sequence by not flushing the Level 1 data |
| 460 | cache. The L1 data cache and the L2 unified cache are inclusive. A flush |
| 461 | of the L2 by set/way flushes any dirty lines from the L1 as well. This |
| 462 | is a known safe deviation from the Cortex-A57 TRM defined power down |
| 463 | sequence. Each Cortex-A57 based platform must make its own decision on |
| 464 | whether to use the optimization. |
| 465 | |
| 466 | - ``A53_DISABLE_NON_TEMPORAL_HINT``: This flag disables the cache non-temporal |
| 467 | hint. The LDNP/STNP instructions as implemented on Cortex-A53 do not behave |
| 468 | in a way most programmers expect, and will most probably result in a |
Dan Handley | 610e7e1 | 2018-03-01 18:44:00 +0000 | [diff] [blame] | 469 | significant speed degradation to any code that employs them. The Armv8-A |
| 470 | architecture (see Arm DDI 0487A.h, section D3.4.3) allows cores to ignore |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 471 | the non-temporal hint and treat LDNP/STNP as LDP/STP instead. Enabling this |
| 472 | flag enforces this behaviour. This needs to be enabled only for revisions |
| 473 | <= r0p3 of the CPU and is enabled by default. |
| 474 | |
| 475 | - ``A57_DISABLE_NON_TEMPORAL_HINT``: This flag has the same behaviour as |
| 476 | ``A53_DISABLE_NON_TEMPORAL_HINT`` but for Cortex-A57. This needs to be |
| 477 | enabled only for revisions <= r1p2 of the CPU and is enabled by default, |
| 478 | as recommended in section "4.7 Non-Temporal Loads/Stores" of the |
| 479 | `Cortex-A57 Software Optimization Guide`_. |
| 480 | |
Varun Wadekar | 5ee3abc | 2018-06-12 16:49:12 -0700 | [diff] [blame] | 481 | - ''A57_ENABLE_NON_CACHEABLE_LOAD_FWD'': This flag enables non-cacheable |
| 482 | streaming enhancement feature for Cortex-A57 CPUs. Platforms can set |
| 483 | this bit only if their memory system meets the requirement that cache |
| 484 | line fill requests from the Cortex-A57 processor are atomic. Each |
| 485 | Cortex-A57 based platform must make its own decision on whether to use |
| 486 | the optimization. This flag is disabled by default. |
| 487 | |
Javier Almansa Sobrino | 9faad3c | 2020-10-23 13:22:07 +0100 | [diff] [blame] | 488 | - ``NEOVERSE_Nx_EXTERNAL_LLC``: This flag indicates that an external last |
Manish Pandey | 3880a36 | 2020-01-24 11:54:44 +0000 | [diff] [blame] | 489 | level cache(LLC) is present in the system, and that the DataSource field |
| 490 | on the master CHI interface indicates when data is returned from the LLC. |
| 491 | This is used to control how the LL_CACHE* PMU events count. |
Javier Almansa Sobrino | 9faad3c | 2020-10-23 13:22:07 +0100 | [diff] [blame] | 492 | Default value is 0 (Disabled). |
Manish Pandey | 3880a36 | 2020-01-24 11:54:44 +0000 | [diff] [blame] | 493 | |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 494 | -------------- |
| 495 | |
laurenw-arm | f5dbbef | 2021-03-23 13:09:35 -0500 | [diff] [blame] | 496 | *Copyright (c) 2014-2021, Arm Limited and Contributors. All rights reserved.* |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 497 | |
John Tsichritzis | 3eeac41 | 2018-09-04 10:56:53 +0100 | [diff] [blame] | 498 | .. _CVE-2017-5715: http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5715 |
| 499 | .. _CVE-2018-3639: http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2018-3639 |
Paul Beesley | 2437ddc | 2019-02-08 16:43:05 +0000 | [diff] [blame] | 500 | .. _Cortex-A53 MPCore Software Developers Errata Notice: http://infocenter.arm.com/help/topic/com.arm.doc.epm048406/index.html |
| 501 | .. _Cortex-A57 MPCore Software Developers Errata Notice: http://infocenter.arm.com/help/topic/com.arm.doc.epm049219/index.html |
Eleanor Bonnici | c3b4ca1 | 2017-08-02 18:33:41 +0100 | [diff] [blame] | 502 | .. _Cortex-A72 MPCore Software Developers Errata Notice: http://infocenter.arm.com/help/topic/com.arm.doc.epm012079/index.html |
Douglas Raillard | d7c21b7 | 2017-06-28 15:23:03 +0100 | [diff] [blame] | 503 | .. _Cortex-A57 Software Optimization Guide: http://infocenter.arm.com/help/topic/com.arm.doc.uan0015b/Cortex_A57_Software_Optimization_Guide_external.pdf |
Sandrine Bailleux | 15530dd | 2019-02-08 15:26:36 +0100 | [diff] [blame] | 504 | .. _Arm DSU Software Developers Errata Notice: http://infocenter.arm.com/help/topic/com.arm.doc.epm138168/index.html |