1 /* 2 * Copyright (c) 2017-2024, Arm Limited and Contributors. All rights reserved. 3 * 4 * SPDX-License-Identifier: BSD-3-Clause 5 */ 6 7 #ifndef ERRATA_REPORT_H 8 #define ERRATA_REPORT_H 9 10 #include <lib/cpus/cpu_ops.h> 11 12 13 #define ERRATUM_WA_FUNC_SIZE CPU_WORD_SIZE 14 #define ERRATUM_CHECK_FUNC_SIZE CPU_WORD_SIZE 15 #define ERRATUM_ID_SIZE 4 16 #define ERRATUM_CVE_SIZE 2 17 #define ERRATUM_CHOSEN_SIZE 1 18 #define ERRATUM_MITIGATED_SIZE 1 19 20 #define ERRATUM_WA_FUNC 0 21 #define ERRATUM_CHECK_FUNC ERRATUM_WA_FUNC + ERRATUM_WA_FUNC_SIZE 22 #define ERRATUM_ID ERRATUM_CHECK_FUNC + ERRATUM_CHECK_FUNC_SIZE 23 #define ERRATUM_CVE ERRATUM_ID + ERRATUM_ID_SIZE 24 #define ERRATUM_CHOSEN ERRATUM_CVE + ERRATUM_CVE_SIZE 25 #define ERRATUM_MITIGATED ERRATUM_CHOSEN + ERRATUM_CHOSEN_SIZE 26 #define ERRATUM_ENTRY_SIZE ERRATUM_MITIGATED + ERRATUM_MITIGATED_SIZE 27 28 /* Errata status */ 29 #define ERRATA_NOT_APPLIES 0 30 #define ERRATA_APPLIES 1 31 #define ERRATA_MISSING 2 32 33 #ifndef __ASSEMBLER__ 34 #include <lib/cassert.h> 35 36 void print_errata_status(void); 37 38 #if ERRATA_A75_764081 39 bool errata_a75_764081_applies(void); 40 #else errata_a75_764081_applies(void)41static inline bool errata_a75_764081_applies(void) 42 { 43 return false; 44 } 45 #endif 46 47 #if ERRATA_A520_2938996 || ERRATA_X4_2726228 48 unsigned int check_if_affected_core(void); 49 #endif 50 51 /* 52 * NOTE that this structure will be different on AArch32 and AArch64. The 53 * uintptr_t will reflect the change and the alignment will be correct in both. 54 */ 55 struct erratum_entry { 56 uintptr_t (*wa_func)(uint64_t cpu_rev); 57 uintptr_t (*check_func)(uint64_t cpu_rev); 58 /* Will fit CVEs with up to 10 character in the ID field */ 59 uint32_t id; 60 /* Denote CVEs with their year or errata with 0 */ 61 uint16_t cve; 62 uint8_t chosen; 63 /* TODO(errata ABI): placeholder for the mitigated field */ 64 uint8_t _mitigated; 65 } __packed; 66 67 CASSERT(sizeof(struct erratum_entry) == ERRATUM_ENTRY_SIZE, 68 assert_erratum_entry_asm_c_different_sizes); 69 #else 70 71 /* 72 * errata framework macro helpers 73 * 74 * NOTE an erratum and CVE id could clash. However, both numbers are very large 75 * and the probablity is minuscule. Working around this makes code very 76 * complicated and extremely difficult to read so it is not considered. In the 77 * unlikely event that this does happen, prepending the CVE id with a 0 should 78 * resolve the conflict 79 */ 80 #define ERRATUM(id) 0, id 81 #define CVE(year, id) year, id 82 #define NO_ISB 1 83 #define NO_ASSERT 0 84 #define NO_APPLY_AT_RESET 0 85 #define APPLY_AT_RESET 1 86 #define GET_CPU_REV 1 87 #define NO_GET_CPU_REV 0 88 89 /* useful for errata that end up always being worked around */ 90 #define ERRATUM_ALWAYS_CHOSEN 1 91 92 #endif /* __ASSEMBLER__ */ 93 94 /* Macro to get CPU revision code for checking errata version compatibility. */ 95 #define CPU_REV(r, p) ((r << 4) | p) 96 97 #endif /* ERRATA_REPORT_H */ 98