xref: /rk3399_ARM-atf/docs/design/cpu-specific-build-macros.rst (revision 885ed9e05eace7f128629380bd0b1a72bb6f6b2c)
1Arm CPU Specific Build Macros
2=============================
3
4This document describes the various build options present in the CPU specific
5operations framework to enable errata workarounds and to enable optimizations
6for a specific CPU on a platform.
7
8Security Vulnerability Workarounds
9----------------------------------
10
11TF-A exports a series of build flags which control which security
12vulnerability workarounds should be applied at runtime.
13
14-  ``WORKAROUND_CVE_2017_5715``: Enables the security workaround for
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.
20
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
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
32-  ``WORKAROUND_CVE_2022_23960``: Enables mitigation for `CVE-2022-23960`_.
33   This build option should be set to 1 if the target platform contains at
34   least 1 CPU that requires this mitigation. Defaults to 1.
35
36-  ``WORKAROUND_CVE_2024_5660``: Enables mitigation for `CVE-2024-5660`.
37   The fix is to disable hardware page aggregation by setting CPUECTLR_EL1[46]
38   in EL3 FW. This build option should be set to 1 if the target platform contains
39   at least 1 CPU that requires this mitigation. Defaults to 1.
40
41-  ``WORKAROUND_CVE_2024_7881``: Enables mitigation for `CVE-2024-7881`.
42   This build option should be set to 1 if the target platform contains at
43   least 1 CPU that requires this mitigation. Defaults to 1.
44
45.. _arm_cpu_macros_errata_workarounds:
46
47CPU Errata Workarounds
48----------------------
49
50TF-A exports a series of build flags which control the errata workarounds that
51are applied to each CPU by the reset handler. The errata details can be found
52in the CPU specific errata documents published by Arm:
53
54-  `Cortex-A53 MPCore Software Developers Errata Notice`_
55-  `Cortex-A57 MPCore Software Developers Errata Notice`_
56-  `Cortex-A72 MPCore Software Developers Errata Notice`_
57
58The errata workarounds are implemented for a particular revision or a set of
59processor revisions. This is checked by the reset handler at runtime. Each
60errata workaround is identified by its ``ID`` as specified in the processor's
61errata notice document. The format of the define used to enable/disable the
62errata workaround is ``ERRATA_<Processor name>_<ID>``, where the ``Processor name``
63is for example ``A57`` for the ``Cortex_A57`` CPU.
64
65Refer to :ref:`firmware_design_cpu_errata_implementation` for information on how to
66write errata workaround functions.
67
68All workarounds are disabled by default. The platform is responsible for
69enabling these workarounds according to its requirement by defining the
70errata workaround build flags in the platform specific makefile. In case
71these workarounds are enabled for the wrong CPU revision then the errata
72workaround is not applied. In the DEBUG build, this is indicated by
73printing a warning to the crash console.
74
75In the current implementation, a platform which has more than 1 variant
76with different revisions of a processor has no runtime mechanism available
77for it to specify which errata workarounds should be enabled or not.
78
79The value of the build flags is 0 by default, that is, disabled. A value of 1
80will enable it.
81
82For Cortex-A9, the following errata build flags are defined :
83
84-  ``ERRATA_A9_794073``: This applies errata 794073 workaround to Cortex-A9
85   CPU. This needs to be enabled for all revisions of the CPU.
86
87For Cortex-A15, the following errata build flags are defined :
88
89-  ``ERRATA_A15_816470``: This applies errata 816470 workaround to Cortex-A15
90   CPU. This needs to be enabled only for revision >= r3p0 of the CPU.
91
92-  ``ERRATA_A15_827671``: This applies errata 827671 workaround to Cortex-A15
93   CPU. This needs to be enabled only for revision >= r3p0 of the CPU.
94
95For Cortex-A17, the following errata build flags are defined :
96
97-  ``ERRATA_A17_852421``: This applies errata 852421 workaround to Cortex-A17
98   CPU. This needs to be enabled only for revision <= r1p2 of the CPU.
99
100-  ``ERRATA_A17_852423``: This applies errata 852423 workaround to Cortex-A17
101   CPU. This needs to be enabled only for revision <= r1p2 of the CPU.
102
103For Cortex-A35, the following errata build flags are defined :
104
105-  ``ERRATA_A35_855472``: This applies errata 855472 workaround to Cortex-A35
106   CPUs. This needs to be enabled only for revision r0p0 of Cortex-A35.
107
108For Cortex-A53, the following errata build flags are defined :
109
110-  ``ERRATA_A53_819472``: This applies errata 819472 workaround to all
111   CPUs. This needs to be enabled only for revision <= r0p1 of Cortex-A53.
112
113-  ``ERRATA_A53_824069``: This applies errata 824069 workaround to all
114   CPUs. This needs to be enabled only for revision <= r0p2 of Cortex-A53.
115
116-  ``ERRATA_A53_826319``: This applies errata 826319 workaround to Cortex-A53
117   CPU. This needs to be enabled only for revision <= r0p2 of the CPU.
118
119-  ``ERRATA_A53_827319``: This applies errata 827319 workaround to all
120   CPUs. This needs to be enabled only for revision <= r0p2 of Cortex-A53.
121
122-  ``ERRATA_A53_835769``: This applies erratum 835769 workaround at compile and
123   link time to Cortex-A53 CPU. This needs to be enabled for some variants of
124   revision <= r0p4. This workaround can lead the linker to create ``*.stub``
125   sections.
126
127-  ``ERRATA_A53_836870``: This applies errata 836870 workaround to Cortex-A53
128   CPU. This needs to be enabled only for revision <= r0p3 of the CPU. From
129   r0p4 and onwards, this errata is enabled by default in hardware. Identical to
130   ``A53_DISABLE_NON_TEMPORAL_HINT``.
131
132-  ``ERRATA_A53_843419``: This applies erratum 843419 workaround at link time
133   to Cortex-A53 CPU.  This needs to be enabled for some variants of revision
134   <= r0p4. This workaround can lead the linker to emit ``*.stub`` sections
135   which are 4kB aligned.
136
137-  ``ERRATA_A53_855873``: This applies errata 855873 workaround to Cortex-A53
138   CPUs. Though the erratum is present in every revision of the CPU,
139   this workaround is only applied to CPUs from r0p3 onwards, which feature
140   a chicken bit in CPUACTLR_EL1 to enable a hardware workaround.
141   Earlier revisions of the CPU have other errata which require the same
142   workaround in software, so they should be covered anyway.
143
144-  ``ERRATA_A53_1530924``: This applies errata 1530924 workaround to all
145   revisions of Cortex-A53 CPU.
146
147For Cortex-A55, the following errata build flags are defined :
148
149-  ``ERRATA_A55_768277``: This applies errata 768277 workaround to Cortex-A55
150   CPU. This needs to be enabled only for revision r0p0 of the CPU.
151
152-  ``ERRATA_A55_778703``: This applies errata 778703 workaround to Cortex-A55
153   CPU. This needs to be enabled only for revision r0p0 of the CPU.
154
155-  ``ERRATA_A55_798797``: This applies errata 798797 workaround to Cortex-A55
156   CPU. This needs to be enabled only for revision r0p0 of the CPU.
157
158-  ``ERRATA_A55_846532``: This applies errata 846532 workaround to Cortex-A55
159   CPU. This needs to be enabled only for revision <= r0p1 of the CPU.
160
161-  ``ERRATA_A55_903758``: This applies errata 903758 workaround to Cortex-A55
162   CPU. This needs to be enabled only for revision <= r0p1 of the CPU.
163
164-  ``ERRATA_A55_1221012``: This applies errata 1221012 workaround to Cortex-A55
165   CPU. This needs to be enabled only for revision <= r1p0 of the CPU.
166
167-  ``ERRATA_A55_1530923``: This applies errata 1530923 workaround to all
168   revisions of Cortex-A55 CPU.
169
170For Cortex-A57, the following errata build flags are defined :
171
172-  ``ERRATA_A57_806969``: This applies errata 806969 workaround to Cortex-A57
173   CPU. This needs to be enabled only for revision r0p0 of the CPU.
174
175-  ``ERRATA_A57_813419``: This applies errata 813419 workaround to Cortex-A57
176   CPU. This needs to be enabled only for revision r0p0 of the CPU.
177
178-  ``ERRATA_A57_813420``: This applies errata 813420 workaround to Cortex-A57
179   CPU. This needs to be enabled only for revision r0p0 of the CPU.
180
181-  ``ERRATA_A57_814670``: This applies errata 814670 workaround to Cortex-A57
182   CPU. This needs to be enabled only for revision r0p0 of the CPU.
183
184-  ``ERRATA_A57_817169``: This applies errata 817169 workaround to Cortex-A57
185   CPU. This needs to be enabled only for revision <= r0p1 of the CPU.
186
187-  ``ERRATA_A57_826974``: This applies errata 826974 workaround to Cortex-A57
188   CPU. This needs to be enabled only for revision <= r1p1 of the CPU.
189
190-  ``ERRATA_A57_826977``: This applies errata 826977 workaround to Cortex-A57
191   CPU. This needs to be enabled only for revision <= r1p1 of the CPU.
192
193-  ``ERRATA_A57_828024``: This applies errata 828024 workaround to Cortex-A57
194   CPU. This needs to be enabled only for revision <= r1p1 of the CPU.
195
196-  ``ERRATA_A57_829520``: This applies errata 829520 workaround to Cortex-A57
197   CPU. This needs to be enabled only for revision <= r1p2 of the CPU.
198
199-  ``ERRATA_A57_833471``: This applies errata 833471 workaround to Cortex-A57
200   CPU. This needs to be enabled only for revision <= r1p2 of the CPU.
201
202-  ``ERRATA_A57_859972``: This applies errata 859972 workaround to Cortex-A57
203   CPU. This needs to be enabled only for revision <= r1p3 of the CPU.
204
205-  ``ERRATA_A57_1319537``: This applies errata 1319537 workaround to all
206   revisions of Cortex-A57 CPU.
207
208For Cortex-A72, the following errata build flags are defined :
209
210-  ``ERRATA_A72_859971``: This applies errata 859971 workaround to Cortex-A72
211   CPU. This needs to be enabled only for revision <= r0p3 of the CPU.
212
213-  ``ERRATA_A72_1319367``: This applies errata 1319367 workaround to all
214   revisions of Cortex-A72 CPU.
215
216For Cortex-A73, the following errata build flags are defined :
217
218-  ``ERRATA_A73_852427``: This applies errata 852427 workaround to Cortex-A73
219   CPU. This needs to be enabled only for revision r0p0 of the CPU.
220
221-  ``ERRATA_A73_855423``: This applies errata 855423 workaround to Cortex-A73
222   CPU. This needs to be enabled only for revision <= r0p1 of the CPU.
223
224For Cortex-A75, the following errata build flags are defined :
225
226-  ``ERRATA_A75_764081``: This applies errata 764081 workaround to Cortex-A75
227   CPU. This needs to be enabled only for revision r0p0 of the CPU.
228
229-  ``ERRATA_A75_790748``: This applies errata 790748 workaround to Cortex-A75
230    CPU. This needs to be enabled only for revision r0p0 of the CPU.
231
232For Cortex-A76, the following errata build flags are defined :
233
234-  ``ERRATA_A76_1073348``: This applies errata 1073348 workaround to Cortex-A76
235   CPU. This needs to be enabled only for revision <= r1p0 of the CPU.
236
237-  ``ERRATA_A76_1130799``: This applies errata 1130799 workaround to Cortex-A76
238   CPU. This needs to be enabled only for revision <= r2p0 of the CPU.
239
240-  ``ERRATA_A76_1220197``: This applies errata 1220197 workaround to Cortex-A76
241   CPU. This needs to be enabled only for revision <= r2p0 of the CPU.
242
243-  ``ERRATA_A76_1257314``: This applies errata 1257314 workaround to Cortex-A76
244   CPU. This needs to be enabled only for revision <= r3p0 of the CPU.
245
246-  ``ERRATA_A76_1262606``: This applies errata 1262606 workaround to Cortex-A76
247   CPU. This needs to be enabled only for revision <= r3p0 of the CPU.
248
249-  ``ERRATA_A76_1262888``: This applies errata 1262888 workaround to Cortex-A76
250   CPU. This needs to be enabled only for revision <= r3p0 of the CPU.
251
252-  ``ERRATA_A76_1275112``: This applies errata 1275112 workaround to Cortex-A76
253   CPU. This needs to be enabled only for revision <= r3p0 of the CPU.
254
255-  ``ERRATA_A76_1791580``: This applies errata 1791580 workaround to Cortex-A76
256   CPU. This needs to be enabled only for revision <= r4p0 of the CPU.
257
258-  ``ERRATA_A76_1165522``: This applies errata 1165522 workaround to all
259   revisions of Cortex-A76 CPU. This errata is fixed in r3p0 but due to
260   limitation of errata framework this errata is applied to all revisions
261   of Cortex-A76 CPU.
262
263-  ``ERRATA_A76_1868343``: This applies errata 1868343 workaround to Cortex-A76
264   CPU. This needs to be enabled only for revision <= r4p0 of the CPU.
265
266-  ``ERRATA_A76_1946160``: This applies errata 1946160 workaround to Cortex-A76
267   CPU. This needs to be enabled only for revisions r3p0 - r4p1 of the CPU.
268
269-  ``ERRATA_A76_2743102``: This applies errata 2743102 workaround to Cortex-A76
270   CPU. This needs to be enabled for all revisions <= r4p1 of the CPU and is
271   still open.
272
273For Cortex-A77, the following errata build flags are defined :
274
275-  ``ERRATA_A77_1508412``: This applies errata 1508412 workaround to Cortex-A77
276   CPU. This needs to be enabled only for revision <= r1p0 of the CPU.
277
278-  ``ERRATA_A77_1925769``: This applies errata 1925769 workaround to Cortex-A77
279   CPU. This needs to be enabled only for revision <= r1p1 of the CPU.
280
281-  ``ERRATA_A77_1946167``: This applies errata 1946167 workaround to Cortex-A77
282   CPU. This needs to be enabled only for revision <= r1p1 of the CPU.
283
284-  ``ERRATA_A77_1791578``: This applies errata 1791578 workaround to Cortex-A77
285   CPU. This needs to be enabled for r0p0, r1p0, and r1p1, it is still open.
286
287-  ``ERRATA_A77_2356587``: This applies errata 2356587 workaround to Cortex-A77
288   CPU. This needs to be enabled for r0p0, r1p0, and r1p1, it is still open.
289
290 -  ``ERRATA_A77_1800714``: This applies errata 1800714 workaround to Cortex-A77
291    CPU. This needs to be enabled for revisions <= r1p1 of the CPU.
292
293 -  ``ERRATA_A77_2743100``: This applies errata 2743100 workaround to Cortex-A77
294    CPU. This needs to be enabled for r0p0, r1p0, and r1p1, it is still open.
295
296For Cortex-A78, the following errata build flags are defined :
297
298-  ``ERRATA_A78_1688305``: This applies errata 1688305 workaround to Cortex-A78
299   CPU. This needs to be enabled only for revision r0p0 - r1p0 of the CPU.
300
301-  ``ERRATA_A78_1941498``: This applies errata 1941498 workaround to Cortex-A78
302   CPU. This needs to be enabled for revisions r0p0, r1p0, and r1p1 of the CPU.
303
304-  ``ERRATA_A78_1951500``: This applies errata 1951500 workaround to Cortex-A78
305   CPU. This needs to be enabled for revisions r1p0 and r1p1, r0p0 has the same
306   issue but there is no workaround for that revision.
307
308-  ``ERRATA_A78_1821534``: This applies errata 1821534 workaround to Cortex-A78
309   CPU. This needs to be enabled for revisions r0p0 and r1p0.
310
311-  ``ERRATA_A78_1952683``: This applies errata 1952683 workaround to Cortex-A78
312   CPU. This needs to be enabled for revision r0p0, it is fixed in r1p0.
313
314-  ``ERRATA_A78_2242635``: This applies errata 2242635 workaround to Cortex-A78
315   CPU. This needs to be enabled for revisions r1p0, r1p1, and r1p2. The issue
316   is present in r0p0 but there is no workaround. It is still open.
317
318-  ``ERRATA_A78_2376745``: This applies errata 2376745 workaround to Cortex-A78
319   CPU. This needs to be enabled for revisions r0p0, r1p0, r1p1, and r1p2, and
320   it is still open.
321
322-  ``ERRATA_A78_2395406``: This applies errata 2395406 workaround to Cortex-A78
323   CPU. This needs to be enabled for revisions r0p0, r1p0, r1p1, and r1p2, and
324   it is still open.
325
326- ``ERRATA_A78_2712571``: This applies erratum 2712571 workaround to Cortex-A78
327   CPU, this erratum affects system configurations that do not use an ARM
328   interconnect IP. This needs to be enabled for revisions r0p0, r1p0, r1p1
329   and r1p2 and it is still open.
330
331-  ``ERRATA_A78_2742426``: This applies erratum 2742426 workaround to Cortex-A78
332   CPU. This needs to be enabled for revisions r0p0, r1p0, r1p1 and r1p2 and
333   it is still open.
334
335-  ``ERRATA_A78_2772019``: This applies errata 2772019 workaround to Cortex-A78
336   CPU. This needs to be enabled for revisions r0p0, r1p0, r1p1, and r1p2, and
337   it is still open.
338
339-  ``ERRATA_A78_2779479``: This applies erratum 2779479 workaround to Cortex-A78
340   CPU. This needs to be enabled for revisions r0p0, r1p0, r1p1 and r1p2 and
341   it is still open.
342
343For Cortex-A78AE, the following errata build flags are defined :
344
345- ``ERRATA_A78_AE_1941500`` : This applies errata 1941500 workaround to
346   Cortex-A78AE CPU. This needs to be enabled for revisions r0p0 and r0p1.
347   This erratum is still open.
348
349- ``ERRATA_A78_AE_1951502`` : This applies errata 1951502 workaround to
350  Cortex-A78AE CPU. This needs to be enabled for revisions r0p0 and r0p1. This
351  erratum is still open.
352
353- ``ERRATA_A78_AE_2376748`` : This applies errata 2376748 workaround to
354  Cortex-A78AE CPU. This needs to be enabled for revisions r0p0, r0p1 and r0p2.
355  This erratum is still open.
356
357- ``ERRATA_A78_AE_2395408`` : This applies errata 2395408 workaround to
358  Cortex-A78AE CPU. This needs to be enabled for revisions r0p0 and r0p1. This
359  erratum is still open.
360
361- ``ERRATA_A78_AE_2712574`` : This applies erratum 2712574 workaround to
362  Cortex-A78AE CPU. This erratum affects system configurations that do not use
363  an ARM interconnect IP. This needs to be enabled for revisions r0p0, r0p1 and
364  r0p2. This erratum is still open.
365
366For Cortex-A78C, the following errata build flags are defined :
367
368- ``ERRATA_A78C_1827430`` : This applies errata 1827430 workaround to
369  Cortex-A78C CPU. This needs to be enabled for revision r0p0. The erratum is
370  fixed in r0p1.
371
372- ``ERRATA_A78C_1827440`` : This applies errata 1827440 workaround to
373  Cortex-A78C CPU. This needs to be enabled for revision r0p0. The erratum is
374  fixed in r0p1.
375
376- ``ERRATA_A78C_2242638`` : This applies errata 2242638 workaround to
377  Cortex-A78C CPU. This needs to be enabled for revisions r0p1, r0p2 and
378  it is still open.
379
380- ``ERRATA_A78C_2376749`` : This applies errata 2376749 workaround to
381  Cortex-A78C CPU. This needs to be enabled for revisions r0p1 and r0p2. This
382  erratum is still open.
383
384- ``ERRATA_A78C_2395411`` : This applies errata 2395411 workaround to
385  Cortex-A78C CPU. This needs to be enabled for revisions r0p1 and r0p2. This
386  erratum is still open.
387
388- ``ERRATA_A78C_2683027`` : This applies errata 2683027 workaround to
389  Cortex-A78C CPU. This needs to be enabled for revisions r0p1 and r0p2. This
390  erratum is still open.
391
392- ``ERRATA_A78C_2712575`` : This applies erratum 2712575 workaround to
393  Cortex-A78C CPU, this erratum affects system configurations that do not use
394  an ARM interconnect IP. This needs to be enabled for revisions r0p1 and r0p2
395  and is still open.
396
397- ``ERRATA_A78C_2743232`` : This applies erratum 2743232 workaround to
398  Cortex-A78C CPU. This needs to be enabled for revisions r0p1 and r0p2.
399  This erratum is still open.
400
401- ``ERRATA_A78C_2772121`` : This applies errata 2772121 workaround to
402  Cortex-A78C CPU. This needs to be enabled for revisions r0p0, r0p1 and r0p2.
403  This erratum is still open.
404
405- ``ERRATA_A78C_2779484`` : This applies errata 2779484 workaround to
406  Cortex-A78C CPU. This needs to be enabled for revisions r0p1 and r0p2.
407  This erratum is still open.
408
409For Cortex-X1 CPU, the following errata build flags are defined:
410
411- ``ERRATA_X1_1821534`` : This applies errata 1821534 workaround to Cortex-X1
412   CPU. This needs to be enabled only for revision <= r1p0 of the CPU.
413
414- ``ERRATA_X1_1688305`` : This applies errata 1688305 workaround to Cortex-X1
415   CPU. This needs to be enabled only for revision <= r1p0 of the CPU.
416
417- ``ERRATA_X1_1827429`` : This applies errata 1827429 workaround to Cortex-X1
418   CPU. This needs to be enabled only for revision <= r1p0 of the CPU.
419
420For Neoverse N1, the following errata build flags are defined :
421
422-  ``ERRATA_N1_1073348``: This applies errata 1073348 workaround to Neoverse-N1
423   CPU. This needs to be enabled only for revision r0p0 and r1p0 of the CPU.
424
425-  ``ERRATA_N1_1130799``: This applies errata 1130799 workaround to Neoverse-N1
426   CPU. This needs to be enabled only for revision <= r2p0 of the CPU.
427
428-  ``ERRATA_N1_1165347``: This applies errata 1165347 workaround to Neoverse-N1
429   CPU. This needs to be enabled only for revision <= r2p0 of the CPU.
430
431-  ``ERRATA_N1_1207823``: This applies errata 1207823 workaround to Neoverse-N1
432   CPU. This needs to be enabled only for revision <= r2p0 of the CPU.
433
434-  ``ERRATA_N1_1220197``: This applies errata 1220197 workaround to Neoverse-N1
435   CPU. This needs to be enabled only for revision <= r2p0 of the CPU.
436
437-  ``ERRATA_N1_1257314``: This applies errata 1257314 workaround to Neoverse-N1
438   CPU. This needs to be enabled only for revision <= r3p0 of the CPU.
439
440-  ``ERRATA_N1_1262606``: This applies errata 1262606 workaround to Neoverse-N1
441   CPU. This needs to be enabled only for revision <= r3p0 of the CPU.
442
443-  ``ERRATA_N1_1262888``: This applies errata 1262888 workaround to Neoverse-N1
444   CPU. This needs to be enabled only for revision <= r3p0 of the CPU.
445
446-  ``ERRATA_N1_1275112``: This applies errata 1275112 workaround to Neoverse-N1
447   CPU. This needs to be enabled only for revision <= r3p0 of the CPU.
448
449-  ``ERRATA_N1_1315703``: This applies errata 1315703 workaround to Neoverse-N1
450   CPU. This needs to be enabled only for revision <= r3p0 of the CPU.
451
452-  ``ERRATA_N1_1542419``: This applies errata 1542419 workaround to Neoverse-N1
453   CPU. This needs to be enabled only for revisions r3p0 - r4p0 of the CPU.
454
455-  ``ERRATA_N1_1868343``: This applies errata 1868343 workaround to Neoverse-N1
456   CPU. This needs to be enabled only for revision <= r4p0 of the CPU.
457
458-  ``ERRATA_N1_1946160``: This applies errata 1946160 workaround to Neoverse-N1
459   CPU. This needs to be enabled for revisions r3p0, r3p1, r4p0, and r4p1, for
460   revisions r0p0, r1p0, and r2p0 there is no workaround.
461
462-  ``ERRATA_N1_2743102``: This applies errata 2743102 workaround to Neoverse-N1
463   CPU. This needs to be enabled for all revisions <= r4p1 of the CPU and is
464   still open.
465
466For Neoverse V1, the following errata build flags are defined :
467
468-  ``ERRATA_V1_1618635``: This applies errata 1618635 workaround to Neoverse-V1
469   CPU. This needs to be enabled for revision r0p0 of the CPU, it is fixed in
470   r1p0.
471
472-  ``ERRATA_V1_1774420``: This applies errata 1774420 workaround to Neoverse-V1
473   CPU. This needs to be enabled only for revisions r0p0 and r1p0, it is fixed
474   in r1p1.
475
476-  ``ERRATA_V1_1791573``: This applies errata 1791573 workaround to Neoverse-V1
477   CPU. This needs to be enabled only for revisions r0p0 and r1p0, it is fixed
478   in r1p1.
479
480-  ``ERRATA_V1_1852267``: This applies errata 1852267 workaround to Neoverse-V1
481   CPU. This needs to be enabled only for revisions r0p0 and r1p0, it is fixed
482   in r1p1.
483
484-  ``ERRATA_V1_1925756``: This applies errata 1925756 workaround to Neoverse-V1
485   CPU. This needs to be enabled for r0p0, r1p0, and r1p1, it is still open.
486
487-  ``ERRATA_V1_1940577``: This applies errata 1940577 workaround to Neoverse-V1
488   CPU. This needs to be enabled only for revision r1p0 and r1p1 of the
489   CPU.
490
491-  ``ERRATA_V1_1966096``: This applies errata 1966096 workaround to Neoverse-V1
492   CPU. This needs to be enabled for revisions r1p0 and r1p1 of the CPU, the
493   issue is present in r0p0 as well but there is no workaround for that
494   revision.  It is still open.
495
496-  ``ERRATA_V1_2139242``: This applies errata 2139242 workaround to Neoverse-V1
497   CPU. This needs to be enabled for revisions r0p0, r1p0, and r1p1 of the
498   CPU.  It is still open.
499
500-  ``ERRATA_V1_2216392``: This applies errata 2216392 workaround to Neoverse-V1
501   CPU. This needs to be enabled for revisions r1p0 and r1p1 of the CPU, the
502   issue is present in r0p0 as well but there is no workaround for that
503   revision.  It is still open.
504
505-  ``ERRATA_V1_2294912``: This applies errata 2294912 workaround to Neoverse-V1
506   CPU. This needs to be enabled for revisions r0p0, r1p0, and r1p1 and r1p2 of
507   the CPU.
508
509-  ``ERRATA_V1_2348377``: This applies errata 2348377 workaroud to Neoverse-V1
510   CPU. This needs to be enabled for revisions r0p0, r1p0 and r1p1 of the CPU.
511   It has been fixed in r1p2.
512
513-  ``ERRATA_V1_2372203``: This applies errata 2372203 workaround to Neoverse-V1
514   CPU. This needs to be enabled for revisions r0p0, r1p0 and r1p1 of the CPU.
515   It is still open.
516
517- ``ERRATA_V1_2701953``: This applies erratum 2701953 workaround to Neoverse-V1
518   CPU, this erratum affects system configurations that do not use an ARM
519   interconnect IP. This needs to be enabled for revisions r0p0, r1p0 and r1p1.
520   It has been fixed in r1p2.
521
522-  ``ERRATA_V1_2743093``: This applies errata 2743093 workaround to Neoverse-V1
523   CPU. This needs to be enabled for revisions r0p0, r1p0, r1p1 and r1p2 of the
524   CPU. It is still open.
525
526-  ``ERRATA_V1_2743233``: This applies erratum 2743233 workaround to Neoverse-V1
527   CPU. This needs to be enabled for revisions r0p0, r1p0, r1p1, and r1p2 of the
528   CPU. It is still open.
529
530-  ``ERRATA_V1_2779461``: This applies erratum 2779461 workaround to Neoverse-V1
531   CPU. This needs to be enabled for revisions r0p0, r1p0, r1p1, r1p2 of the
532   CPU. It is still open.
533
534For Neoverse V2, the following errata build flags are defined :
535
536-  ``ERRATA_V2_2618597``: This applies errata 2618597 workaround to Neoverse-V2
537   CPU. This needs to be enabled for revisions r0p0 and r0p1. It is fixed in
538   r0p2.
539
540-  ``ERRATA_V2_2662553``: This applies errata 2662553 workaround to Neoverse-V2
541   CPU. This needs to be enabled for revisions r0p0 and r0p1. It is fixed in
542   r0p2.
543
544-  ``ERRATA_V2_2719103``: This applies errata 2719103 workaround to Neoverse-V2
545   CPU, this affects system configurations that do not use and ARM interconnect
546   IP. This needs to be enabled for revisions r0p0 and r0p1. It has been fixed
547   in r0p2.
548
549-  ``ERRATA_V2_2719105``: This applies errata 2719105 workaround to Neoverse-V2
550   CPU. This needs to be enabled for revisions r0p0 and r0p1. It is fixed in
551   r0p2.
552
553-  ``ERRATA_V2_2743011``: This applies errata 2743011 workaround to Neoverse-V2
554   CPU. This needs to be enabled for revisions r0p0 and r0p1. It is fixed in
555   r0p2.
556
557-  ``ERRATA_V2_2779510``: This applies errata 2779510 workaround to Neoverse-V2
558   CPU. This needs to be enabled for revisions r0p0 and r0p1. It is fixed in
559   r0p2.
560
561-  ``ERRATA_V2_2801372``: This applies errata 2801372 workaround to Neoverse-V2
562   CPU, this affects all configurations. This needs to be enabled for revisions
563   r0p0 and r0p1. It has been fixed in r0p2.
564
565-  ``ERRATA_V2_3701771``: This applies errata 3701771 workaround to Neoverse-V2
566   CPU. This needs to be enabled for revisions r0p0, r0p1 and r0p2 and is
567   still open.
568
569-  ``ERRATA_V2_3841324``: This applies errata 3841324 workaround to Neoverse-V2
570   CPU. This needs to be enabled only for revisions r0p0 and r0p1 of
571   the CPU. It is fixed in r0p2.
572
573For Neoverse V3, the following errata build flags are defined :
574
575- ``ERRATA_V3_2970647``: This applies errata 2970647 workaround to Neoverse-V3
576  CPU. This needs to be enabled for revision r0p0. It is fixed in r0p1.
577
578- ``ERRATA_V3_3701767``: This applies errata 3701767 workaround to Neoverse-V3
579  CPU. This needs to be enabled for revisions r0p0, r0p1, r0p2 of the CPU and
580  is still open.
581
582For Cortex-A710, the following errata build flags are defined :
583
584-  ``ERRATA_A710_1901946``: This applies errata 1901946 workaround to
585   Cortex-A710 CPU. This needs to be enabled only for revision r1p0. It has
586   been fixed in r2p0.
587
588-  ``ERRATA_A710_1916945``: This applies errata 1916945 workaround to
589   Cortex-A710 CPU. This needs to be enabled only for revisions r0p0 and r1p0.
590   It has been fixed in r2p0.
591
592-  ``ERRATA_A710_1917258``: This applies errata 1917258 workaround to
593   Cortex-A710 CPU. This needs to be enabled only for revisions r0p0 and r1p0.
594   It has been fixed in r2p0.
595
596-  ``ERRATA_A710_1927200``: This applies errata 1927200 workaround to
597   Cortex-A710 CPU. This needs to be enabled only for revisions r0p0 and r1p0.
598   It has been fixed in r2p0.
599
600-  ``ERRATA_A710_1987031``: This applies errata 1987031 workaround to
601   Cortex-A710 CPU. This needs to be enabled only for revisions r0p0, r1p0 and
602   r2p0 of the CPU. It is still open.
603
604-  ``ERRATA_A710_2081180``: This applies errata 2081180 workaround to
605   Cortex-A710 CPU. This needs to be enabled only for revisions r0p0, r1p0 and
606   r2p0 of the CPU. It is still open.
607
608-  ``ERRATA_A710_2055002``: This applies errata 2055002 workaround to
609   Cortex-A710 CPU. This needs to be enabled for revisions r1p0, r2p0 of the CPU
610   and is still open.
611
612-  ``ERRATA_A710_2017096``: This applies errata 2017096 workaround to
613   Cortex-A710 CPU. This needs to be enabled for revisions r0p0, r1p0 and r2p0
614   of the CPU and is still open.
615
616-  ``ERRATA_A710_2083908``: This applies errata 2083908 workaround to
617   Cortex-A710 CPU. This needs to be enabled for revision r2p0 of the CPU and
618   is still open.
619
620-  ``ERRATA_A710_2267065``: This applies errata 2267065 workaround to
621   Cortex-A710 CPU. This needs to be enabled for revisions r0p0, r1p0 and r2p0
622   of the CPU and is fixed in r2p1.
623
624-  ``ERRATA_A710_2136059``: This applies errata 2136059 workaround to
625   Cortex-A710 CPU. This needs to be enabled for revisions r0p0, r1p0 and r2p0
626   of the CPU and is fixed in r2p1.
627
628-  ``ERRATA_A710_2147715``: This applies errata 2147715 workaround to
629   Cortex-A710 CPU. This needs to be enabled for revision r2p0 of the CPU
630   and is fixed in r2p1.
631
632-  ``ERRATA_A710_2216384``: This applies errata 2216384 workaround to
633   Cortex-A710 CPU. This needs to be enabled for revisions r0p0, r1p0 and r2p0
634   of the CPU and is fixed in r2p1.
635
636-  ``ERRATA_A710_2282622``: This applies errata 2282622 workaround to
637   Cortex-A710 CPU. This needs to be enabled for revisions r0p0, r1p0, r2p0 and
638   r2p1 of the CPU and is still open.
639
640- ``ERRATA_A710_2291219``: This applies errata 2291219 workaround to
641   Cortex-A710 CPU. This needs to be enabled for revisions r0p0, r1p0 and r2p0
642   of the CPU and is fixed in r2p1.
643
644-  ``ERRATA_A710_2008768``: This applies errata 2008768 workaround to
645   Cortex-A710 CPU. This needs to be enabled for revisions r0p0, r1p0 and r2p0
646   of the CPU and is fixed in r2p1.
647
648-  ``ERRATA_A710_2371105``: This applies errata 2371105 workaround to
649   Cortex-A710 CPU. This needs to be enabled for revisions r0p0, r1p0 and r2p0
650   of the CPU and is fixed in r2p1.
651
652-  ``ERRATA_A710_2701952``: This applies erratum 2701952 workaround to Cortex-A710
653   CPU, and applies to system configurations that do not use and ARM
654   interconnect IP. This needs to be enabled for r0p0, r1p0, r2p0 and r2p1 and
655   is still open.
656
657-  ``ERRATA_A710_2742423``: This applies errata 2742423 workaround to
658   Cortex-A710 CPU. This needs to be enabled for revisions r0p0, r1p0, r2p0 and
659   r2p1 of the CPU and is still open.
660
661-  ``ERRATA_A710_2768515``: This applies errata 2768515 workaround to
662   Cortex-A710 CPU. This needs to be enabled for revisions r0p0, r1p0, r2p0 and
663   r2p1 of the CPU and is still open.
664
665-  ``ERRATA_A710_2778471``: This applies errata 2778471 workaround to Cortex-A710
666   CPU. This needs to be enabled for revisions r0p0, r1p0, r2p0 and r2p1 of the
667   CPU and is still open.
668
669- ``ERRATA_A710_3701772``: This applies errata 3701772 workaround to Cortex-A710
670  CPU. This needs to be enabled for revisions r0p0, r1p0, r2p0, r2p1 of the
671  CPU and is still open.
672
673For Neoverse N2, the following errata build flags are defined :
674
675-  ``ERRATA_N2_2002655``: This applies errata 2002655 workaround to Neoverse-N2
676   CPU. This needs to be enabled for revision r0p0 of the CPU and is fixed in r0p1.
677
678-  ``ERRATA_N2_2009478``: This applies errata 2009478 workaround to Neoverse-N2
679   CPU. This needs to be enabled for revision r0p0 of the CPU and is fixed in r0p1.
680
681-  ``ERRATA_N2_2067956``: This applies errata 2067956 workaround to Neoverse-N2
682   CPU. This needs to be enabled for revision r0p0 of the CPU and is fixed in r0p1.
683
684-  ``ERRATA_N2_2025414``: This applies errata 2025414 workaround to Neoverse-N2
685   CPU. This needs to be enabled for revision r0p0 of the CPU and is fixed in r0p1.
686
687-  ``ERRATA_N2_2189731``: This applies errata 2189731 workaround to Neoverse-N2
688   CPU. This needs to be enabled for revision r0p0 of the CPU and is fixed in r0p1.
689
690-  ``ERRATA_N2_2138956``: This applies errata 2138956 workaround to Neoverse-N2
691   CPU. This needs to be enabled for revision r0p0 of the CPU and is fixed in r0p1.
692
693-  ``ERRATA_N2_2242415``: This applies errata 2242415 workaround to Neoverse-N2
694   CPU. This needs to be enabled for revision r0p0 of the CPU and is fixed in r0p1.
695
696-  ``ERRATA_N2_2138958``: This applies errata 2138958 workaround to Neoverse-N2
697   CPU. This needs to be enabled for revision r0p0 of the CPU and is fixed in r0p1.
698
699-  ``ERRATA_N2_2242400``: This applies errata 2242400 workaround to Neoverse-N2
700   CPU. This needs to be enabled for revision r0p0 of the CPU and is fixed in r0p1.
701
702-  ``ERRATA_N2_2280757``: This applies errata 2280757 workaround to Neoverse-N2
703   CPU. This needs to be enabled for revision r0p0 of the CPU and is fixed in r0p1.
704
705-  ``ERRATA_N2_2326639``: This applies errata 2326639 workaround to Neoverse-N2
706   CPU. This needs to be enabled for revision r0p0 of the CPU, it is fixed in
707   r0p1.
708
709-  ``ERRATA_N2_2340933``: This applies errata 2340933 workaround to Neoverse-N2
710   CPU. This needs to be enabled for revision r0p0 of the CPU, it is fixed in
711   r0p1.
712
713-  ``ERRATA_N2_2346952``: This applies errata 2346952 workaround to Neoverse-N2
714   CPU. This needs to be enabled for revisions r0p0, r0p1 and r0p2 of the CPU,
715   it is fixed in r0p3.
716
717-  ``ERRATA_N2_2376738``: This applies errata 2376738 workaround to Neoverse-N2
718   CPU. This needs to be enabled for revision r0p0, r0p1, r0p2, r0p3 and is still open.
719
720-  ``ERRATA_N2_2388450``: This applies errata 2388450 workaround to Neoverse-N2
721   CPU. This needs to be enabled for revision r0p0 of the CPU, it is fixed in
722   r0p1.
723
724-  ``ERRATA_N2_2743014``: This applies errata 2743014 workaround to Neoverse-N2
725   CPU. This needs to be enabled for revisions r0p0, r0p1 and r0p2. It is fixed
726   in r0p3.
727
728-  ``ERRATA_N2_2743089``: This applies errata 2743089 workaround to Neoverse-N2
729   CPU. This needs to be enabled for revisions r0p0, r0p1 and r0p2. It is fixed
730   in r0p3.
731
732- ``ERRATA_N2_2728475``: This applies erratum 2728475 workaround to Neoverse-N2
733   CPU, this erratum affects system configurations that do not use and ARM
734   interconnect IP. This needs to be enabled for revisions r0p0, r0p1 and r0p2.
735   It is fixed in r0p3.
736
737-  ``ERRATA_N2_2779511``: This applies errata 2779511 workaround to Neoverse-N2
738   CPU. This needs to be enabled for revisions r0p0, r0p1 and r0p2. It is fixed
739   in r0p3.
740
741-  ``ERRATA_N2_3701773``: This applies errata 3701773 workaround to Neoverse-N2
742   CPU. This needs to be enabled for revisions r0p0, r0p1, r0p2, r0p3 and is
743   still open.
744
745For Neoverse N3, the following errata build flags are defined :
746
747-  ``ERRATA_N3_3699563``: This applies errata 3699563 workaround to Neoverse-N3
748   CPU. This needs to be enabled for revisions r0p0 and is still open.
749
750For Cortex-X2, the following errata build flags are defined :
751
752-  ``ERRATA_X2_1901946``: This applies errata 1901946 workaround to Cortex-X2
753   CPU. This needs to be enabled only for r1p0, it is fixed in r2p0.
754
755-  ``ERRATA_X2_1916945``: This applies errata 1916945 workaround to Cortex-X2
756   CPU. This needs to be enabled only for revisions r0p0 and r1p0 of the CPU, it
757   is fixed in r2p0.
758
759-  ``ERRATA_X2_1917258``: This applies errata 1917258 workaround to Cortex-X2
760   CPU. This needs to be enabled only for revisions r0p0 and r1p0 of the CPU, it
761   is fixed in r2p0.
762
763-  ``ERRATA_X2_1927200``: This applies errata 1927200 workaround to Cortex-X2
764   CPU. This needs to be enabled only for revisions r0p0 and r1p0 of the CPU, it
765   is fixed in r2p0.
766
767-  ``ERRATA_X2_1934260``: This applies errata 1934260 workaround to Cortex-X2
768   CPU. This needs to be enabled only for revision r1p0 of the CPU, it is fixed
769   in r2p0.
770
771-  ``ERRATA_X2_2002765``: This applies errata 2002765 workaround to Cortex-X2
772   CPU. This needs to be enabled only for revisions r0p0, r1p0 and r2p0 of the
773   CPU, it is fixed in r2p1.
774
775-  ``ERRATA_X2_2017096``: This applies errata 2017096 workaround to Cortex-X2
776   CPU. This needs to be enabled only for revisions r0p0, r1p0 and r2p0 of the
777   CPU, it is fixed in r2p1.
778
779-  ``ERRATA_X2_2081180``: This applies errata 2081180 workaround to Cortex-X2
780   CPU. This needs to be enabled only for revisions r0p0, r1p0 and r2p0 of the
781   CPU, it is fixed in r2p1.
782
783-  ``ERRATA_X2_2083908``: This applies errata 2083908 workaround to Cortex-X2
784   CPU. This needs to be enabled only for revision r2p0 of the CPU, it is fixed
785   in r2p1.
786
787-  ``ERRATA_X2_2136059``: This applies errata 2136059 workaround to Cortex-X2
788   CPU. This needs to be enabled only for revisions r0p0, r1p0 and r2p0 of the
789   CPU, it is fixed in r2p1.
790
791-  ``ERRATA_X2_2147715``: This applies errata 2147715 workaround to Cortex-X2
792   CPU. This needs to be enabled only for revision r2p0 of the CPU, it is fixed
793   in r2p1.
794
795-  ``ERRATA_X2_2216384``: This applies errata 2216384 workaround to Cortex-X2
796   CPU. This needs to be enabled only for revisions r0p0, r1p0 and r2p0 of the
797   CPU, it is fixed in r2p1.
798
799-  ``ERRATA_X2_2267065``: This applies errata 2267065 workaround to Cortex-X2
800   CPU. This needs to be enabled only for revisions r0p0, r1p0 and r2p0 of the
801   CPU, it is fixed in r2p1.
802
803-  ``ERRATA_X2_2282622``: This applies errata 2282622 workaround to Cortex-X2
804   CPU. This needs to be enabled for revisions r0p0, r1p0, r2p0 and r2p1 of the
805   CPU and is still open.
806
807-  ``ERRATA_X2_2291219``: This applies errata 2291219 workaround to Cortex-X2
808   CPU. This needs to be enabled only for revisions r0p0, r1p0 and r2p0 of the
809   CPU, it is fixed in r2p1.
810
811-  ``ERRATA_X2_2371105``: This applies errata 2371105 workaround to Cortex-X2
812   CPU. This needs to be enabled only for revisions r0p0, r1p0 and r2p0 of the
813   CPU, it is fixed in r2p1.
814
815- ``ERRATA_X2_2701952``: This applies errata 2701952 workaround to Cortex-X2
816   CPU and affects system configurations that do not use an Arm interconnect IP.
817   This needs to be enabled for revisions r0p0, r1p0, r2p0 and r2p1 and is
818   still open.
819
820-  ``ERRATA_X2_2742423``: This applies errata 2742423 workaround to Cortex-X2
821   CPU. This needs to be enabled for revisions r0p0, r1p0, r2p0 and r2p1 of the
822   CPU and is still open.
823
824-  ``ERRATA_X2_2768515``: This applies errata 2768515 workaround to Cortex-X2
825   CPU. This needs to be enabled for revisions r0p0, r1p0, r2p0 and r2p1 of the
826   CPU and is still open.
827
828-  ``ERRATA_X2_2778471``: This applies errata 2778471 workaround to Cortex-X2
829   CPU. This needs to be enabled for revisions r0p0, r1p0, r2p0 and r2p1 of the
830   CPU and is still open.
831
832-  ``ERRATA_X2_3701772``: This applies errata 3701772 workaround to Cortex-X2
833   CPU. This needs to be enabled for revisions r0p0, r1p0, r2p0 and r2p1 of the
834   CPU and is still open.
835
836For Cortex-X3, the following errata build flags are defined :
837
838- ``ERRATA_X3_2266875``: This applies errata 2266875 workaround to the Cortex-X3
839  CPU. This needs to be enabled only for revisions r0p0 and r1p0 of the CPU, it
840  is fixed in r1p1.
841
842- ``ERRATA_X3_2302506``: This applies errata 2302506 workaround to the Cortex-X3
843  CPU. This needs to be enabled only for revisions r0p0, r1p0 and r1p1, it is
844  fixed in r1p2.
845
846- ``ERRATA_X3_2313909``: This applies errata 2313909 workaround to
847  Cortex-X3 CPU. This needs to be enabled only for revisions r0p0 and r1p0
848  of the CPU, it is fixed in r1p1.
849
850- ``ERRATA_X3_2372204``: This applies errata 2372204 workaround to
851  Cortex-X3 CPU. This needs to be enabled only for revisions r0p0 and r1p0
852  of the CPU, it is fixed in r1p1.
853
854- ``ERRATA_X3_2615812``: This applies errata 2615812 workaround to Cortex-X3
855  CPU. This needs to be enabled only for revisions r0p0, r1p0 and r1p1 of the
856  CPU, it is fixed in r1p2.
857
858- ``ERRATA_X3_2641945``: This applies errata 2641945 workaround to Cortex-X3
859  CPU. This needs to be enabled only for revisions r0p0 and r1p0 of the CPU.
860  It is fixed in r1p1.
861
862- ``ERRATA_X3_2701951``: This applies erratum 2701951 workaround to Cortex-X3
863  CPU and affects system configurations that do not use an ARM interconnect
864  IP. This needs to be applied to revisions r0p0, r1p0 and r1p1. It is fixed
865  in r1p2.
866
867- ``ERRATA_X3_2742421``: This applies errata 2742421 workaround to
868  Cortex-X3 CPU. This needs to be enabled only for revisions r0p0, r1p0 and
869  r1p1. It is fixed in r1p2.
870
871- ``ERRATA_X3_2743088``: This applies errata 2743088 workaround to Cortex-X3
872  CPU. This needs to be enabled only for revisions r0p0, r1p0 and r1p1. It is
873  fixed in r1p2.
874
875- ``ERRATA_X3_2779509``: This applies errata 2779509 workaround to Cortex-X3
876  CPU. This needs to be enabled only for revisions r0p0, r1p0 and r1p1 of the
877  CPU. It is fixed in r1p2.
878
879- ``ERRATA_X3_3213672``: This applies errata 3213672 workaround to Cortex-X3
880  CPU. This needs to be enabled for revisions r0p0, r1p0, r1p1 and r1p2
881  of the CPU. It is still open.
882
883- ``ERRATA_X3_3692984``: This applies errata 3692984 workaround to Cortex-X3
884  CPU. This needs to be enabled for revisions r0p0, r1p0, r1p1 and r1p2
885  of the CPU. It is still open.
886
887- ``ERRATA_X3_3701769``: This applies errata 3701769 workaround to Cortex-X3
888  CPU. This needs to be enabled only for revisions r0p0, r1p0, r1p1 and r1p2
889  of the CPU and it is still open.
890
891- ``ERRATA_X3_3827463``: This applies errata 3827463 workaround to Cortex-X3
892  CPU. This needs to be enabled only for revisions r0p0, r1p0 and r1p1 of
893  the CPU. It is fixed in r1p2.
894
895For Cortex-X4, the following errata build flags are defined :
896
897- ``ERRATA_X4_2701112``: This applies erratum 2701112 workaround to Cortex-X4
898  CPU and affects system configurations that do not use an Arm interconnect IP.
899  This needs to be enabled for revisions r0p0 and is fixed in r0p1.
900  The workaround for this erratum is not implemented in EL3, but the flag can
901  be enabled/disabled at the platform level. The flag is used when the errata ABI
902  feature is enabled and can assist the Kernel in the process of
903  mitigation of the erratum.
904
905- ``ERRATA_X4_2726228``: This applies erratum 2726228 workaround to Cortex-X4
906  CPU. This needs to be enabled for revisions r0p0 and r0p1. It is fixed in
907  r0p2.
908
909-  ``ERRATA_X4_2740089``: This applies errata 2740089 workaround to Cortex-X4
910   CPU. This needs to be enabled for revisions r0p0 and r0p1. It is fixed
911   in r0p2.
912
913- ``ERRATA_X4_2763018``: This applies errata 2763018 workaround to Cortex-X4
914  CPU. This needs to be enabled for revisions r0p0 and r0p1. It is fixed in r0p2.
915
916- ``ERRATA_X4_2816013``: This applies errata 2816013 workaround to Cortex-X4
917  CPU. This needs to be enabled for revisions r0p0 and r0p1. It is fixed in r0p2.
918
919- ``ERRATA_X4_2897503``: This applies errata 2897503 workaround to Cortex-X4
920  CPU. This needs to be enabled for revisions r0p0 and r0p1. It is fixed in r0p2.
921
922- ``ERRATA_X4_2923985``: This applies errata 2923985 workaround to Cortex-X4
923  CPU. This needs to be enabled for revisions r0p0 and r0p1. It is fixed in r0p2.
924
925- ``ERRATA_X4_2957258``: This applies errata 2957258 workaround to Cortex-X4
926  CPU. This needs to be enabled for revisions r0p0 and r0p1. It is fixed in r0p2.
927
928- ``ERRATA_X4_3076789``: This applies errata 3076789 workaround to Cortex-X4
929  CPU. This needs to be enabled for revisions r0p0 and r0p1. It is fixed in r0p2.
930
931- ``ERRATA_X4_3133195``: This applies errata 3133195 workaround to Cortex-X4
932  CPU. This needs to be enabled for revision r0p2. It is fixed in r0p3.
933
934- ``ERRATA_X4_3701758``: This applies errata 3701758 workaround to Cortex-X4
935  CPU. This needs to be enabled for revisions r0p0, r0p1, r0p2 and r0p3.
936  It is still open.
937
938- ``ERRATA_X4_3887999``: This applies errata 3887999 workaround to Cortex-X4
939  CPU. This needs to be enabled for revision r0p0, r0p1, r0p2 and r0p3.
940  It is still open.
941
942For Cortex-X925, the following errata build flags are defined :
943
944- ``ERRATA_X925_2963999``: This applies errata 2963999 workaround to Cortex-X925
945  CPU. This needs to be enabled for revision r0p0. It is fixed in r0p1.
946
947- ``ERRATA_X925_3701747``: This applies errata 3701747 workaround to Cortex-X925
948  CPU. This needs to be enabled for revisions r0p0 and r0p1. It is still open.
949
950For Cortex-A510, the following errata build flags are defined :
951
952-  ``ERRATA_A510_2008766``: This applies errata 2008766 workaround to
953   Cortex-A510 CPU. This needs to be enabled for revisions r0p0, r0p1, r0p2,
954   r0p3, r1p0, r1p1, r1p2 and r1p3. It is still open.
955
956-  ``ERRATA_A510_2288014``: This applies errata 2288014 workaround to
957   Cortex-A510 CPU. This needs to be enabled only for revisions r0p0, r0p1,
958   r0p2, r0p3 and r1p0, it is fixed in r1p1.
959
960-  ``ERRATA_A510_2042739``: This applies errata 2042739 workaround to
961   Cortex-A510 CPU. This needs to be enabled only for revisions r0p0, r0p1 and
962   r0p2, it is fixed in r0p3.
963
964-  ``ERRATA_A510_2041909``: This applies errata 2041909 workaround to
965   Cortex-A510 CPU. This needs to be enabled only for revision r0p2 and is fixed
966   in r0p3. The issue is also present in r0p0 and r0p1 but there is no
967   workaround for those revisions.
968
969-  ``ERRATA_A510_2080326``: This applies errata 2080326 workaround to
970   Cortex-A510 CPU. This needs to be enabled only for revision r0p2 and is
971   fixed in r0p3. This issue is also present in r0p0 and r0p1 but there is no
972   workaround for those revisions.
973
974-  ``ERRATA_A510_2169012``: This applies errata 2169012 workaround to
975   Cortex-A510 CPU. This needs to be enabled only for revisions r0p0, r0p1,
976   r0p2, r0p3 and r1p0, it is fixed in r1p1.
977
978-  ``ERRATA_A510_2218134``: This applies errata 2218134 workaround to
979   Cortex-A510 CPU. This needs to be enabled only for revision r1p0 and is fixed
980   in r1p1.
981
982-  ``ERRATA_A510_2250311``: This applies errata 2250311 workaround to
983   Cortex-A510 CPU. This needs to be enabled for revisions r0p0, r0p1, r0p2,
984   r0p3 and r1p0, it is fixed in r1p1. This workaround disables MPMM even if
985   ENABLE_MPMM=1.
986
987-  ``ERRATA_A510_2218950``: This applies errata 2218950 workaround to
988   Cortex-A510 CPU. This needs to be enabled for revisions r0p0, r0p1, r0p2,
989   r0p3 and r1p0, it is fixed in r1p1.
990
991-  ``ERRATA_A510_2172148``: This applies errata 2172148 workaround to
992   Cortex-A510 CPU. This needs to be enabled for revisions r0p0, r0p1, r0p2,
993   r0p3 and r1p0, it is fixed in r1p1.
994
995-  ``ERRATA_A510_2347730``: This applies errata 2347730 workaround to
996   Cortex-A510 CPU. This needs to be enabled for revisions r0p0, r0p1, r0p2,
997   r0p3, r1p0 and r1p1. It is fixed in r1p2.
998
999-  ``ERRATA_A510_2371937``: This applies errata 2371937 workaround to
1000   Cortex-A510 CPU. This needs to applied for revisions r0p0, r0p1, r0p2,
1001   r0p3, r1p0, r1p1, and is fixed in r1p2.
1002
1003-  ``ERRATA_A510_2420992``: This applies errata 2420992 workaround to
1004   Cortex-A510 CPU. This needs to applied for revisions r1p0 and r1p1, and is
1005   fixed in r1p2.
1006
1007-  ``ERRATA_A510_2666669``: This applies errata 2666669 workaround to
1008   Cortex-A510 CPU. This needs to applied for revisions r0p0, r0p1, r0p2,
1009   r0p3, r1p0, r1p1. It is fixed in r1p2.
1010
1011-  ``ERRATA_A510_2684597``: This applies erratum 2684597 workaround to
1012   Cortex-A510 CPU. This needs to be applied to revision r0p0, r0p1, r0p2,
1013   r0p3, r1p0, r1p1 and r1p2. It is fixed in r1p3.
1014
1015-  ``ERRATA_A510_2971420``: This applies erratum 2971420 workaround to
1016   Cortex-A510 CPU. This needs to be applied to revisions r0p1, r0p2, r0p3,
1017   r1p0, r1p1, r1p2 and r1p3 and is still open.
1018
1019-  ``ERRATA_A510_3672349``: This applies erratum 3672349 workaround to
1020   Cortex-A510 CPU. This needs to be applied to revisions r0p1, r0p2, r0p3,
1021   r1p0, r1p1, r1p2 and r1p3 and is still open.
1022
1023-  ``ERRATA_A510_3704847``: This applies erratum 3704847 workaround to
1024   Cortex-A510 CPU. This needs to be applied to revisions r0p1, r0p2, r0p3,
1025   r1p0, r1p1, r1p2 and r1p3 and is still open.
1026
1027For Cortex-A520, the following errata build flags are defined :
1028
1029-  ``ERRATA_A520_2630792``: This applies errata 2630792 workaround to
1030   Cortex-A520 CPU. This needs to applied for revisions r0p0, r0p1 of the
1031   CPU and is still open.
1032
1033-  ``ERRATA_A520_2858100``: This applies errata 2858100 workaround to
1034   Cortex-A520 CPU. This needs to be enabled for revisions r0p0 and r0p1.
1035   It is still open.
1036
1037-  ``ERRATA_A520_2938996``: This applies errata 2938996 workaround to
1038   Cortex-A520 CPU. This needs to be enabled for revisions r0p0 and r0p1.
1039   It is fixed in r0p2.
1040
1041For Cortex-A715, the following errata build flags are defined :
1042
1043-  ``ERRATA_A715_2331818``: This applies errata 2331818 workaround to
1044   Cortex-A715 CPU. This needs to be enabled for revisions r0p0 and r1p0.
1045   It is fixed in r1p1.
1046
1047- ``ERRATA_A715_2344187``: This applies errata 2344187 workaround to
1048   Cortex-A715 CPU. This needs to be enabled for revisions r0p0 and r1p0. It is
1049   fixed in r1p1.
1050
1051-  ``ERRATA_A715_2413290``: This applies errata 2413290 workaround to
1052   Cortex-A715 CPU. This needs to be enabled only for revision r1p0 and
1053   when SPE(Statistical profiling extension)=True. The errata is fixed
1054   in r1p1.
1055
1056-  ``ERRATA_A715_2420947``: This applies errata 2420947 workaround to
1057   Cortex-A715 CPU. This needs to be enabled only for revision r1p0.
1058   It is fixed in r1p1.
1059
1060-  ``ERRATA_A715_2429384``: This applies errata 2429384 workaround to
1061   Cortex-A715 CPU. This needs to be enabled for revision r1p0. There is no
1062   workaround for revision r0p0. It is fixed in r1p1.
1063
1064-  ``ERRATA_A715_2561034``: This applies errata 2561034 workaround to
1065   Cortex-A715 CPU. This needs to be enabled only for revision r1p0.
1066   It is fixed in r1p1.
1067
1068-  ``ERRATA_A715_2728106``: This applies errata 2728106 workaround to
1069   Cortex-A715 CPU. This needs to be enabled for revisions r0p0, r1p0
1070   and r1p1. It is fixed in r1p2.
1071
1072-  ``ERRATA_A715_2804830``: This applies errata 2804830 workaround to
1073   Cortex-A715 CPU. This needs to be enabled for revisions r0p0, r1p0,
1074   r1p1 and r1p2. It is fixed in r1p3.
1075
1076-  ``ERRATA_A715_3699560``: This applies errata 3699560 workaround to
1077   Cortex-A715 CPU. This needs to be enabled for revisions r0p0, r1p0,
1078   r1p2 and r1p3. It is still open.
1079
1080For Cortex-A720, the following errata build flags are defined :
1081
1082-  ``ERRATA_A720_2729604``: This applies errata 2729604 workaround to
1083   Cortex-A720 CPU. This needs to be enabled for revisions r0p0 and r0p1.
1084   It is fixed in r0p2.
1085
1086-  ``ERRATA_A720_2792132``: This applies errata 2792132 workaround to
1087   Cortex-A720 CPU. This needs to be enabled for revisions r0p0 and r0p1.
1088   It is fixed in r0p2.
1089
1090-  ``ERRATA_A720_2844092``: This applies errata 2844092 workaround to
1091   Cortex-A720 CPU. This needs to be enabled for revisions r0p0 and r0p1.
1092   It is fixed in r0p2.
1093
1094-  ``ERRATA_A720_2926083``: This applies errata 2926083 workaround to
1095   Cortex-A720 CPU. This needs to be enabled for revisions r0p0 and r0p1.
1096   It is fixed in r0p2.
1097
1098-  ``ERRATA_A720_2940794``: This applies errata 2940794 workaround to
1099   Cortex-A720 CPU. This needs to be enabled for revisions r0p0 and r0p1.
1100   It is fixed in r0p2.
1101
1102-  ``ERRATA_A720_3699561``: This applies errata 3699561 workaround to
1103   Cortex-A720 CPU. This needs to be enabled for revisions r0p0, r0p1
1104   and r0p2. It is still open.
1105
1106-  ``ERRATA_A720_3711910``: This applies errata 3711910 workaround to
1107   Cortex-A720 CPU. This needs to be enabled for revisions r0p0, r0p1
1108   and r0p2. It is still open.
1109
1110For Cortex-A720_AE, the following errata build flags are defined :
1111
1112-  ``ERRATA_A720_AE_3699562``: This applies errata 3699562 workaround
1113   to Cortex-A720_AE CPU. This needs to be enabled for revisions r0p0.
1114   It is still open.
1115
1116For Cortex-A725, the following errata build flags are defined :
1117
1118-  ``ERRATA_A725_3699564``: This applies errata 3699564 workaround to
1119   Cortex-A725 CPU. This needs to be enabled for revisions r0p0 and r0p1.
1120   It is fixed in r0p2.
1121
1122DSU Errata Workarounds
1123----------------------
1124
1125Similar to CPU errata, TF-A also implements workarounds for DSU (DynamIQ
1126Shared Unit) errata. The DSU errata details can be found in the respective Arm
1127documentation:
1128
1129- `Arm DSU Software Developers Errata Notice`_.
1130
1131Each erratum is identified by an ``ID``, as defined in the DSU errata notice
1132document. Thus, the build flags which enable/disable the errata workarounds
1133have the format ``ERRATA_DSU_<ID>``. The implementation and application logic
1134of DSU errata workarounds are similar to `CPU errata workarounds`_.
1135
1136For DSU errata, the following build flags are defined:
1137
1138-  ``ERRATA_DSU_798953``: This applies errata 798953 workaround for the
1139   affected DSU configurations. This errata applies only for those DSUs that
1140   revision is r0p0 (on r0p1 it is fixed). However, please note that this
1141   workaround results in increased DSU power consumption on idle.
1142
1143-  ``ERRATA_DSU_936184``: This applies errata 936184 workaround for the
1144   affected DSU configurations. This errata applies only for those DSUs that
1145   contain the ACP interface **and** the DSU revision is older than r2p0 (on
1146   r2p0 it is fixed). However, please note that this workaround results in
1147   increased DSU power consumption on idle.
1148
1149-  ``ERRATA_DSU_2313941``: This applies errata 2313941 workaround for the
1150   affected DSU configurations. This errata applies for those DSUs with
1151   revisions r0p0, r1p0, r2p0, r2p1, r3p0, r3p1 and is still open. However,
1152   please note that this workaround results in increased DSU power consumption
1153   on idle.
1154
1155-  ``ERRATA_DSU_2900952``: This applies errata 2900952 workaround for the
1156   affected DSU-120 configurations. This erratum applies to some r2p0
1157   implementations and is fixed in r2p1. The affected r2p0 implementations
1158   are determined by reading the IMP_CLUSTERREVIDR_EL1[1] register bit
1159   and making sure it's clear.
1160
1161CPU Specific optimizations
1162--------------------------
1163
1164This section describes some of the optimizations allowed by the CPU micro
1165architecture that can be enabled by the platform as desired.
1166
1167-  ``SKIP_A57_L1_FLUSH_PWR_DWN``: This flag enables an optimization in the
1168   Cortex-A57 cluster power down sequence by not flushing the Level 1 data
1169   cache. The L1 data cache and the L2 unified cache are inclusive. A flush
1170   of the L2 by set/way flushes any dirty lines from the L1 as well. This
1171   is a known safe deviation from the Cortex-A57 TRM defined power down
1172   sequence. Each Cortex-A57 based platform must make its own decision on
1173   whether to use the optimization.
1174
1175-  ``A53_DISABLE_NON_TEMPORAL_HINT``: This flag disables the cache non-temporal
1176   hint. The LDNP/STNP instructions as implemented on Cortex-A53 do not behave
1177   in a way most programmers expect, and will most probably result in a
1178   significant speed degradation to any code that employs them. The Armv8-A
1179   architecture (see Arm DDI 0487A.h, section D3.4.3) allows cores to ignore
1180   the non-temporal hint and treat LDNP/STNP as LDP/STP instead. Enabling this
1181   flag enforces this behaviour. This needs to be enabled only for revisions
1182   <= r0p3 of the CPU and is enabled by default.
1183
1184-  ``A57_DISABLE_NON_TEMPORAL_HINT``: This flag has the same behaviour as
1185   ``A53_DISABLE_NON_TEMPORAL_HINT`` but for Cortex-A57. This needs to be
1186   enabled only for revisions <= r1p2 of the CPU and is enabled by default,
1187   as recommended in section "4.7 Non-Temporal Loads/Stores" of the
1188   `Cortex-A57 Software Optimization Guide`_.
1189
1190- ''A57_ENABLE_NON_CACHEABLE_LOAD_FWD'': This flag enables non-cacheable
1191   streaming enhancement feature for Cortex-A57 CPUs. Platforms can set
1192   this bit only if their memory system meets the requirement that cache
1193   line fill requests from the Cortex-A57 processor are atomic. Each
1194   Cortex-A57 based platform must make its own decision on whether to use
1195   the optimization. This flag is disabled by default.
1196
1197-  ``NEOVERSE_Nx_EXTERNAL_LLC``: This flag indicates that an external last
1198   level cache(LLC) is present in the system, and that the DataSource field
1199   on the master CHI interface indicates when data is returned from the LLC.
1200   This is used to control how the LL_CACHE* PMU events count.
1201   Default value is 0 (Disabled).
1202
1203GIC Errata Workarounds
1204----------------------
1205-  ``GIC600_ERRATA_WA_2384374``: This flag applies part 2 of errata 2384374
1206   workaround for the affected GIC600 and GIC600-AE implementations. It applies
1207   to implementations of GIC600 and GIC600-AE with revisions less than or equal
1208   to r1p6 and r0p2 respectively. If the platform sets GICV3_SUPPORT_GIC600,
1209   then this flag is enabled; otherwise, it is 0 (Disabled).
1210
1211--------------
1212
1213*Copyright (c) 2014-2025, Arm Limited and Contributors. All rights reserved.*
1214
1215.. _CVE-2017-5715: http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5715
1216.. _CVE-2018-3639: http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2018-3639
1217.. _CVE-2022-23960: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2022-23960
1218.. _Cortex-A53 MPCore Software Developers Errata Notice: http://infocenter.arm.com/help/topic/com.arm.doc.epm048406/index.html
1219.. _Cortex-A57 MPCore Software Developers Errata Notice: http://infocenter.arm.com/help/topic/com.arm.doc.epm049219/index.html
1220.. _Cortex-A72 MPCore Software Developers Errata Notice: http://infocenter.arm.com/help/topic/com.arm.doc.epm012079/index.html
1221.. _Cortex-A57 Software Optimization Guide: http://infocenter.arm.com/help/topic/com.arm.doc.uan0015b/Cortex_A57_Software_Optimization_Guide_external.pdf
1222.. _Arm DSU Software Developers Errata Notice: http://infocenter.arm.com/help/topic/com.arm.doc.epm138168/index.html
1223