xref: /rk3399_ARM-atf/include/arch/aarch64/arch_features.h (revision 09a4bcb81bc37def40ecb638b121e00e05bcbcbd)
1 /*
2  * Copyright (c) 2019-2025, Arm Limited. All rights reserved.
3  *
4  * SPDX-License-Identifier: BSD-3-Clause
5  */
6 
7 #ifndef ARCH_FEATURES_H
8 #define ARCH_FEATURES_H
9 
10 #include <stdbool.h>
11 
12 #include <arch_helpers.h>
13 #include <common/feat_detect.h>
14 
15 #define ISOLATE_FIELD(reg, feat, mask)						\
16 	((unsigned int)(((reg) >> (feat)) & mask))
17 
18 #define CREATE_FEATURE_SUPPORTED(name, read_func, guard)			\
19 __attribute__((always_inline))							\
20 static inline bool is_ ## name ## _supported(void)				\
21 {										\
22 	if ((guard) == FEAT_STATE_DISABLED) {					\
23 		return false;							\
24 	}									\
25 	if ((guard) == FEAT_STATE_ALWAYS) {					\
26 		return true;							\
27 	}									\
28 	return read_func();							\
29 }
30 
31 #define CREATE_FEATURE_PRESENT(name, idreg, idfield, mask, idval)		\
32 __attribute__((always_inline))							\
33 static inline bool is_ ## name ## _present(void)				\
34 {										\
35 	return (ISOLATE_FIELD(read_ ## idreg(), idfield, mask) >= idval) 	\
36 		? true : false; 						\
37 }
38 
39 #define CREATE_FEATURE_FUNCS(name, idreg, idfield, mask, idval, guard)		\
40 CREATE_FEATURE_PRESENT(name, idreg, idfield, mask, idval)			\
41 CREATE_FEATURE_SUPPORTED(name, is_ ## name ## _present, guard)
42 
43 
44 /* +----------------------------+
45  * |	Features supported	|
46  * +----------------------------+
47  * |	GENTIMER		|
48  * +----------------------------+
49  * |	FEAT_PAN		|
50  * +----------------------------+
51  * |	FEAT_VHE		|
52  * +----------------------------+
53  * |	FEAT_TTCNP		|
54  * +----------------------------+
55  * |	FEAT_UAO		|
56  * +----------------------------+
57  * |	FEAT_PACQARMA3		|
58  * +----------------------------+
59  * |	FEAT_PAUTH		|
60  * +----------------------------+
61  * |	FEAT_TTST		|
62  * +----------------------------+
63  * |	FEAT_BTI		|
64  * +----------------------------+
65  * |	FEAT_MTE2		|
66  * +----------------------------+
67  * |	FEAT_SSBS		|
68  * +----------------------------+
69  * |	FEAT_NMI		|
70  * +----------------------------+
71  * |	FEAT_GCS		|
72  * +----------------------------+
73  * |	FEAT_EBEP		|
74  * +----------------------------+
75  * |	FEAT_SEBEP		|
76  * +----------------------------+
77  * |	FEAT_SEL2		|
78  * +----------------------------+
79  * |	FEAT_TWED		|
80  * +----------------------------+
81  * |	FEAT_FGT		|
82  * +----------------------------+
83  * |	FEAT_EC/ECV2		|
84  * +----------------------------+
85  * |	FEAT_RNG		|
86  * +----------------------------+
87  * |	FEAT_TCR2		|
88  * +----------------------------+
89  * |	FEAT_S2POE		|
90  * +----------------------------+
91  * |	FEAT_S1POE		|
92  * +----------------------------+
93  * |	FEAT_S2PIE		|
94  * +----------------------------+
95  * |	FEAT_S1PIE		|
96  * +----------------------------+
97  * |	FEAT_AMU/AMUV1P1	|
98  * +----------------------------+
99  * |	FEAT_MPAM		|
100  * +----------------------------+
101  * |	FEAT_HCX		|
102  * +----------------------------+
103  * |	FEAT_RNG_TRAP		|
104  * +----------------------------+
105  * |	FEAT_RME		|
106  * +----------------------------+
107  * |	FEAT_SB			|
108  * +----------------------------+
109  * |	FEAT_CSV2/CSV3		|
110  * +----------------------------+
111  * |	FEAT_SPE		|
112  * +----------------------------+
113  * |	FEAT_SVE		|
114  * +----------------------------+
115  * |	FEAT_RAS		|
116  * +----------------------------+
117  * |	FEAT_DIT		|
118  * +----------------------------+
119  * |	FEAT_SYS_REG_TRACE	|
120  * +----------------------------+
121  * |	FEAT_TRF		|
122  * +----------------------------+
123  * |	FEAT_NV/NV2		|
124  * +----------------------------+
125  * |	FEAT_BRBE		|
126  * +----------------------------+
127  * |	FEAT_TRBE		|
128  * +----------------------------+
129  * |	FEAT_SME/SME2		|
130  * +----------------------------+
131  * |	FEAT_PMUV3		|
132  * +----------------------------+
133  * |	FEAT_MTPMU		|
134  * +----------------------------+
135  * |	FEAT_FGT2		|
136  * +----------------------------+
137  * |	FEAT_THE		|
138  * +----------------------------+
139  * |	FEAT_SCTLR2		|
140  * +----------------------------+
141  * |	FEAT_D128		|
142  * +----------------------------+
143  * |	FEAT_LS64_ACCDATA	|
144  * +----------------------------+
145  * |	FEAT_FPMR		|
146  * +----------------------------+
147  * |	FEAT_MOPS		|
148  * +----------------------------+
149  * |	FEAT_PAUTH_LR		|
150  * +----------------------------+
151  * |    FEAT_FGWTE3             |
152  * +----------------------------+
153  * |	FEAT_MPAM_PE_BW_CTRL	|
154  * +----------------------------+
155  * |    FEAT_CPA2               |
156  * +----------------------------+
157  * |	FEAT_AIE		|
158  * +----------------------------+
159  * |	FEAT_PFAR		|
160  * +----------------------------+
161  * |	FEAT_RME_GPC2		|
162  * +----------------------------+
163  */
164 
165 __attribute__((always_inline))
166 static inline bool is_armv7_gentimer_present(void)
167 {
168 	/* The Generic Timer is always present in an ARMv8-A implementation */
169 	return true;
170 }
171 
172 /* FEAT_PAN: Privileged access never */
173 CREATE_FEATURE_FUNCS(feat_pan, id_aa64mmfr1_el1, ID_AA64MMFR1_EL1_PAN_SHIFT,
174 		     ID_AA64MMFR1_EL1_PAN_MASK, 1U, ENABLE_FEAT_PAN)
175 
176 /* FEAT_VHE: Virtualization Host Extensions */
177 CREATE_FEATURE_FUNCS(feat_vhe, id_aa64mmfr1_el1, ID_AA64MMFR1_EL1_VHE_SHIFT,
178 		     ID_AA64MMFR1_EL1_VHE_MASK, 1U, ENABLE_FEAT_VHE)
179 
180 /* FEAT_TTCNP: Translation table common not private */
181 CREATE_FEATURE_PRESENT(feat_ttcnp, id_aa64mmfr2_el1, ID_AA64MMFR2_EL1_CNP_SHIFT,
182 			ID_AA64MMFR2_EL1_CNP_MASK, 1U)
183 
184 /* FEAT_UAO: User access override */
185 CREATE_FEATURE_PRESENT(feat_uao, id_aa64mmfr2_el1, ID_AA64MMFR2_EL1_UAO_SHIFT,
186 			ID_AA64MMFR2_EL1_UAO_MASK, 1U)
187 
188 /* If any of the fields is not zero, QARMA3 algorithm is present */
189 CREATE_FEATURE_PRESENT(feat_pacqarma3, id_aa64isar2_el1, 0,
190 			((ID_AA64ISAR2_GPA3_MASK << ID_AA64ISAR2_GPA3_SHIFT) |
191 			(ID_AA64ISAR2_APA3_MASK << ID_AA64ISAR2_APA3_SHIFT)), 1U)
192 
193 /* FEAT_PAUTH: Pointer Authentication */
194 __attribute__((always_inline))
195 static inline bool is_feat_pauth_present(void)
196 {
197 	uint64_t mask_id_aa64isar1 =
198 		(ID_AA64ISAR1_GPI_MASK << ID_AA64ISAR1_GPI_SHIFT) |
199 		(ID_AA64ISAR1_GPA_MASK << ID_AA64ISAR1_GPA_SHIFT) |
200 		(ID_AA64ISAR1_API_MASK << ID_AA64ISAR1_API_SHIFT) |
201 		(ID_AA64ISAR1_APA_MASK << ID_AA64ISAR1_APA_SHIFT);
202 
203 	/*
204 	 * If any of the fields is not zero or QARMA3 is present,
205 	 * PAuth is present
206 	 */
207 	return ((read_id_aa64isar1_el1() & mask_id_aa64isar1) != 0U ||
208 		is_feat_pacqarma3_present());
209 }
210 CREATE_FEATURE_SUPPORTED(feat_pauth, is_feat_pauth_present, ENABLE_PAUTH)
211 CREATE_FEATURE_SUPPORTED(ctx_pauth, is_feat_pauth_present, CTX_INCLUDE_PAUTH_REGS)
212 
213 /*
214  * FEAT_PAUTH_LR
215  * This feature has a non-standard discovery method so define this function
216  * manually then call use the CREATE_FEATURE_SUPPORTED macro with it. This
217  * feature is enabled with ENABLE_PAUTH when present.
218  */
219 __attribute__((always_inline))
220 static inline bool is_feat_pauth_lr_present(void)
221 {
222 	/*
223 	 * FEAT_PAUTH_LR support is indicated by up to 3 fields, if one or more
224 	 * of these is 0b0110 then the feature is present.
225 	 *   1) id_aa64isr1_el1.api
226 	 *   2) id_aa64isr1_el1.apa
227 	 *   3) id_aa64isr2_el1.apa3
228 	 */
229 	if (ISOLATE_FIELD(read_id_aa64isar1_el1(), ID_AA64ISAR1_API_SHIFT, ID_AA64ISAR1_API_MASK) == 0b0110) {
230 		return true;
231 	}
232 	if (ISOLATE_FIELD(read_id_aa64isar1_el1(), ID_AA64ISAR1_APA_SHIFT, ID_AA64ISAR1_APA_MASK) == 0b0110) {
233 		return true;
234 	}
235 	if (ISOLATE_FIELD(read_id_aa64isar2_el1(), ID_AA64ISAR2_APA3_SHIFT, ID_AA64ISAR2_APA3_MASK) == 0b0110) {
236 		return true;
237 	}
238 	return false;
239 }
240 CREATE_FEATURE_SUPPORTED(feat_pauth_lr, is_feat_pauth_lr_present, ENABLE_FEAT_PAUTH_LR)
241 
242 /* FEAT_TTST: Small translation tables */
243 CREATE_FEATURE_PRESENT(feat_ttst, id_aa64mmfr2_el1, ID_AA64MMFR2_EL1_ST_SHIFT,
244 			ID_AA64MMFR2_EL1_ST_MASK, 1U)
245 
246 /* FEAT_BTI: Branch target identification */
247 CREATE_FEATURE_FUNCS(feat_bti, id_aa64pfr1_el1, ID_AA64PFR1_EL1_BT_SHIFT,
248 			ID_AA64PFR1_EL1_BT_MASK, BTI_IMPLEMENTED, ENABLE_BTI)
249 
250 /* FEAT_MTE2: Memory tagging extension */
251 CREATE_FEATURE_FUNCS(feat_mte2, id_aa64pfr1_el1, ID_AA64PFR1_EL1_MTE_SHIFT,
252 		     ID_AA64PFR1_EL1_MTE_MASK, MTE_IMPLEMENTED_ELX, ENABLE_FEAT_MTE2)
253 
254 /* FEAT_SSBS: Speculative store bypass safe */
255 CREATE_FEATURE_PRESENT(feat_ssbs, id_aa64pfr1_el1, ID_AA64PFR1_EL1_SSBS_SHIFT,
256 			ID_AA64PFR1_EL1_SSBS_MASK, 1U)
257 
258 /* FEAT_NMI: Non-maskable interrupts */
259 CREATE_FEATURE_PRESENT(feat_nmi, id_aa64pfr1_el1, ID_AA64PFR1_EL1_NMI_SHIFT,
260 			ID_AA64PFR1_EL1_NMI_MASK, NMI_IMPLEMENTED)
261 
262 /* FEAT_EBEP */
263 CREATE_FEATURE_FUNCS(feat_ebep, id_aa64dfr1_el1, ID_AA64DFR1_EBEP_SHIFT,
264 		     ID_AA64DFR1_EBEP_MASK, 1U,  ENABLE_FEAT_EBEP)
265 
266 /* FEAT_SEBEP */
267 CREATE_FEATURE_PRESENT(feat_sebep, id_aa64dfr0_el1, ID_AA64DFR0_SEBEP_SHIFT,
268 			ID_AA64DFR0_SEBEP_MASK, SEBEP_IMPLEMENTED)
269 
270 /* FEAT_SEL2: Secure EL2 */
271 CREATE_FEATURE_FUNCS(feat_sel2, id_aa64pfr0_el1, ID_AA64PFR0_SEL2_SHIFT,
272 		     ID_AA64PFR0_SEL2_MASK, 1U, ENABLE_FEAT_SEL2)
273 
274 /* FEAT_TWED: Delayed trapping of WFE */
275 CREATE_FEATURE_FUNCS(feat_twed, id_aa64mmfr1_el1, ID_AA64MMFR1_EL1_TWED_SHIFT,
276 		     ID_AA64MMFR1_EL1_TWED_MASK, 1U, ENABLE_FEAT_TWED)
277 
278 /* FEAT_FGT: Fine-grained traps */
279 CREATE_FEATURE_FUNCS(feat_fgt, id_aa64mmfr0_el1, ID_AA64MMFR0_EL1_FGT_SHIFT,
280 		     ID_AA64MMFR0_EL1_FGT_MASK, 1U, ENABLE_FEAT_FGT)
281 
282 /* FEAT_FGT2: Fine-grained traps extended */
283 CREATE_FEATURE_FUNCS(feat_fgt2, id_aa64mmfr0_el1, ID_AA64MMFR0_EL1_FGT_SHIFT,
284 		     ID_AA64MMFR0_EL1_FGT_MASK, FGT2_IMPLEMENTED, ENABLE_FEAT_FGT2)
285 
286 /* FEAT_FGWTE3: Fine-grained write traps EL3 */
287 CREATE_FEATURE_FUNCS(feat_fgwte3, id_aa64mmfr4_el1, ID_AA64MMFR4_EL1_FGWTE3_SHIFT,
288 		     ID_AA64MMFR4_EL1_FGWTE3_MASK, FGWTE3_IMPLEMENTED,
289 		     ENABLE_FEAT_FGWTE3)
290 
291 /* FEAT_ECV: Enhanced Counter Virtualization */
292 CREATE_FEATURE_FUNCS(feat_ecv, id_aa64mmfr0_el1, ID_AA64MMFR0_EL1_ECV_SHIFT,
293 		     ID_AA64MMFR0_EL1_ECV_MASK, 1U, ENABLE_FEAT_ECV)
294 CREATE_FEATURE_FUNCS(feat_ecv_v2, id_aa64mmfr0_el1, ID_AA64MMFR0_EL1_ECV_SHIFT,
295 		     ID_AA64MMFR0_EL1_ECV_MASK, ID_AA64MMFR0_EL1_ECV_SELF_SYNCH, ENABLE_FEAT_ECV)
296 
297 /* FEAT_RNG: Random number generator */
298 CREATE_FEATURE_FUNCS(feat_rng, id_aa64isar0_el1, ID_AA64ISAR0_RNDR_SHIFT,
299 		     ID_AA64ISAR0_RNDR_MASK, 1U, ENABLE_FEAT_RNG)
300 
301 /* FEAT_TCR2: Support TCR2_ELx regs */
302 CREATE_FEATURE_FUNCS(feat_tcr2, id_aa64mmfr3_el1, ID_AA64MMFR3_EL1_TCRX_SHIFT,
303 		     ID_AA64MMFR3_EL1_TCRX_MASK, 1U, ENABLE_FEAT_TCR2)
304 
305 /* FEAT_S2POE */
306 CREATE_FEATURE_FUNCS(feat_s2poe, id_aa64mmfr3_el1, ID_AA64MMFR3_EL1_S2POE_SHIFT,
307 		     ID_AA64MMFR3_EL1_S2POE_MASK, 1U, ENABLE_FEAT_S2POE)
308 
309 /* FEAT_S1POE */
310 CREATE_FEATURE_FUNCS(feat_s1poe, id_aa64mmfr3_el1, ID_AA64MMFR3_EL1_S1POE_SHIFT,
311 		     ID_AA64MMFR3_EL1_S1POE_MASK, 1U, ENABLE_FEAT_S1POE)
312 
313 __attribute__((always_inline))
314 static inline bool is_feat_sxpoe_supported(void)
315 {
316 	return is_feat_s1poe_supported() || is_feat_s2poe_supported();
317 }
318 
319 /* FEAT_S2PIE */
320 CREATE_FEATURE_FUNCS(feat_s2pie, id_aa64mmfr3_el1, ID_AA64MMFR3_EL1_S2PIE_SHIFT,
321 		     ID_AA64MMFR3_EL1_S2PIE_MASK, 1U, ENABLE_FEAT_S2PIE)
322 
323 /* FEAT_S1PIE */
324 CREATE_FEATURE_FUNCS(feat_s1pie, id_aa64mmfr3_el1, ID_AA64MMFR3_EL1_S1PIE_SHIFT,
325 		     ID_AA64MMFR3_EL1_S1PIE_MASK, 1U, ENABLE_FEAT_S1PIE)
326 
327 /* FEAT_THE: Translation Hardening Extension */
328 CREATE_FEATURE_FUNCS(feat_the, id_aa64pfr1_el1, ID_AA64PFR1_EL1_THE_SHIFT,
329 		     ID_AA64PFR1_EL1_THE_MASK, THE_IMPLEMENTED, ENABLE_FEAT_THE)
330 
331 /* FEAT_SCTLR2 */
332 CREATE_FEATURE_FUNCS(feat_sctlr2, id_aa64mmfr3_el1, ID_AA64MMFR3_EL1_SCTLR2_SHIFT,
333 		     ID_AA64MMFR3_EL1_SCTLR2_MASK, SCTLR2_IMPLEMENTED,
334 		     ENABLE_FEAT_SCTLR2)
335 
336 /* FEAT_D128 */
337 CREATE_FEATURE_FUNCS(feat_d128, id_aa64mmfr3_el1, ID_AA64MMFR3_EL1_D128_SHIFT,
338 		     ID_AA64MMFR3_EL1_D128_MASK, D128_IMPLEMENTED,
339 		     ENABLE_FEAT_D128)
340 
341 /* FEAT_RME_GPC2 */
342 CREATE_FEATURE_PRESENT(feat_rme_gpc2, id_aa64pfr0_el1,
343 		       ID_AA64PFR0_FEAT_RME_SHIFT, ID_AA64PFR0_FEAT_RME_MASK,
344 		       RME_GPC2_IMPLEMENTED)
345 
346 /* FEAT_FPMR */
347 CREATE_FEATURE_FUNCS(feat_fpmr, id_aa64pfr2_el1, ID_AA64PFR2_EL1_FPMR_SHIFT,
348 		     ID_AA64PFR2_EL1_FPMR_MASK, FPMR_IMPLEMENTED,
349 		     ENABLE_FEAT_FPMR)
350 /* FEAT_MOPS */
351 CREATE_FEATURE_FUNCS(feat_mops, id_aa64isar2_el1, ID_AA64ISAR2_EL1_MOPS_SHIFT,
352 		     ID_AA64ISAR2_EL1_MOPS_MASK, MOPS_IMPLEMENTED,
353 		     ENABLE_FEAT_MOPS)
354 
355 __attribute__((always_inline))
356 static inline bool is_feat_sxpie_supported(void)
357 {
358 	return is_feat_s1pie_supported() || is_feat_s2pie_supported();
359 }
360 
361 /* FEAT_GCS: Guarded Control Stack */
362 CREATE_FEATURE_FUNCS(feat_gcs, id_aa64pfr1_el1, ID_AA64PFR1_EL1_GCS_SHIFT,
363 		     ID_AA64PFR1_EL1_GCS_MASK, 1U, ENABLE_FEAT_GCS)
364 
365 /* FEAT_AMU: Activity Monitors Extension */
366 CREATE_FEATURE_FUNCS(feat_amu, id_aa64pfr0_el1, ID_AA64PFR0_AMU_SHIFT,
367 		     ID_AA64PFR0_AMU_MASK, 1U, ENABLE_FEAT_AMU)
368 
369 /* Auxiliary counters for FEAT_AMU */
370 CREATE_FEATURE_FUNCS(feat_amu_aux, amcfgr_el0, AMCFGR_EL0_NCG_SHIFT,
371 		     AMCFGR_EL0_NCG_MASK, 1U, ENABLE_AMU_AUXILIARY_COUNTERS)
372 
373 /* FEAT_AMUV1P1: AMU Extension v1.1 */
374 CREATE_FEATURE_FUNCS(feat_amuv1p1, id_aa64pfr0_el1, ID_AA64PFR0_AMU_SHIFT,
375 		     ID_AA64PFR0_AMU_MASK, ID_AA64PFR0_AMU_V1P1, ENABLE_FEAT_AMUv1p1)
376 
377 /*
378  * Return MPAM version:
379  *
380  * 0x00: None Armv8.0 or later
381  * 0x01: v0.1 Armv8.4 or later
382  * 0x10: v1.0 Armv8.2 or later
383  * 0x11: v1.1 Armv8.4 or later
384  *
385  */
386 __attribute__((always_inline))
387 static inline bool is_feat_mpam_present(void)
388 {
389 	unsigned int ret = (unsigned int)((((read_id_aa64pfr0_el1() >>
390 		ID_AA64PFR0_MPAM_SHIFT) & ID_AA64PFR0_MPAM_MASK) << 4) |
391 		((read_id_aa64pfr1_el1() >> ID_AA64PFR1_MPAM_FRAC_SHIFT)
392 			& ID_AA64PFR1_MPAM_FRAC_MASK));
393 	return ret;
394 }
395 
396 CREATE_FEATURE_SUPPORTED(feat_mpam, is_feat_mpam_present, ENABLE_FEAT_MPAM)
397 
398 
399 
400 /* FEAT_MPAM_PE_BW_CTRL: MPAM PE-side bandwidth controls */
401 __attribute__((always_inline))
402 static inline bool is_feat_mpam_pe_bw_ctrl_present(void)
403 {
404 	if (is_feat_mpam_present()) {
405 		return ((unsigned long long)(read_mpamidr_el1() &
406 				MPAMIDR_HAS_BW_CTRL_BIT) != 0U);
407 	}
408 	return false;
409 }
410 
411 CREATE_FEATURE_SUPPORTED(feat_mpam_pe_bw_ctrl, is_feat_mpam_pe_bw_ctrl_present,
412 		ENABLE_FEAT_MPAM_PE_BW_CTRL)
413 
414 /*
415  * FEAT_DebugV8P9: Debug extension. This function checks the field 3:0 of
416  * ID_AA64DFR0 Aarch64 Debug Feature Register 0 for the version of
417  * Feat_Debug supported. The value of the field determines feature presence
418  *
419  * 0b0110 - Arm v8.0 debug
420  * 0b0111 - Arm v8.0 debug architecture with Virtualization host extensions
421  * 0x1000 - FEAT_Debugv8p2 is supported
422  * 0x1001 - FEAT_Debugv8p4 is supported
423  * 0x1010 - FEAT_Debugv8p8 is supported
424  * 0x1011 - FEAT_Debugv8p9 is supported
425  *
426  */
427 CREATE_FEATURE_FUNCS(feat_debugv8p9, id_aa64dfr0_el1, ID_AA64DFR0_DEBUGVER_SHIFT,
428 		ID_AA64DFR0_DEBUGVER_MASK, DEBUGVER_V8P9_IMPLEMENTED,
429 		ENABLE_FEAT_DEBUGV8P9)
430 
431 /* FEAT_HCX: Extended Hypervisor Configuration Register */
432 CREATE_FEATURE_FUNCS(feat_hcx, id_aa64mmfr1_el1, ID_AA64MMFR1_EL1_HCX_SHIFT,
433 		     ID_AA64MMFR1_EL1_HCX_MASK, 1U, ENABLE_FEAT_HCX)
434 
435 /* FEAT_RNG_TRAP: Trapping support */
436 CREATE_FEATURE_FUNCS(feat_rng_trap, id_aa64pfr1_el1, ID_AA64PFR1_EL1_RNDR_TRAP_SHIFT,
437 		      ID_AA64PFR1_EL1_RNDR_TRAP_MASK, RNG_TRAP_IMPLEMENTED, ENABLE_FEAT_RNG_TRAP)
438 
439 /* Return the RME version, zero if not supported. */
440 CREATE_FEATURE_FUNCS(feat_rme, id_aa64pfr0_el1, ID_AA64PFR0_FEAT_RME_SHIFT,
441 		    ID_AA64PFR0_FEAT_RME_MASK, 1U, ENABLE_RME)
442 
443 /* FEAT_SB: Speculation barrier instruction */
444 CREATE_FEATURE_PRESENT(feat_sb, id_aa64isar1_el1, ID_AA64ISAR1_SB_SHIFT,
445 		       ID_AA64ISAR1_SB_MASK, 1U)
446 
447 /* FEAT_MEC: Memory Encryption Contexts */
448 CREATE_FEATURE_FUNCS(feat_mec, id_aa64mmfr3_el1, ID_AA64MMFR3_EL1_MEC_SHIFT,
449 		ID_AA64MMFR3_EL1_MEC_MASK, 1U, ENABLE_FEAT_MEC)
450 
451 /*
452  * FEAT_CSV2: Cache Speculation Variant 2. This checks bit fields[56-59]
453  * of id_aa64pfr0_el1 register and can be used to check for below features:
454  * FEAT_CSV2_2: Cache Speculation Variant CSV2_2.
455  * FEAT_CSV2_3: Cache Speculation Variant CSV2_3.
456  * 0b0000 - Feature FEAT_CSV2 is not implemented.
457  * 0b0001 - Feature FEAT_CSV2 is implemented, but FEAT_CSV2_2 and FEAT_CSV2_3
458  *          are not implemented.
459  * 0b0010 - Feature FEAT_CSV2_2 is implemented but FEAT_CSV2_3 is not
460  *          implemented.
461  * 0b0011 - Feature FEAT_CSV2_3 is implemented.
462  */
463 
464 CREATE_FEATURE_FUNCS(feat_csv2_2, id_aa64pfr0_el1, ID_AA64PFR0_CSV2_SHIFT,
465 		     ID_AA64PFR0_CSV2_MASK, CSV2_2_IMPLEMENTED, ENABLE_FEAT_CSV2_2)
466 CREATE_FEATURE_FUNCS(feat_csv2_3, id_aa64pfr0_el1, ID_AA64PFR0_CSV2_SHIFT,
467 		     ID_AA64PFR0_CSV2_MASK, CSV2_3_IMPLEMENTED, ENABLE_FEAT_CSV2_3)
468 
469 /* FEAT_SPE: Statistical Profiling Extension */
470 CREATE_FEATURE_FUNCS(feat_spe, id_aa64dfr0_el1, ID_AA64DFR0_PMS_SHIFT,
471 		     ID_AA64DFR0_PMS_MASK, 1U, ENABLE_SPE_FOR_NS)
472 
473 /* FEAT_SVE: Scalable Vector Extension */
474 CREATE_FEATURE_FUNCS(feat_sve, id_aa64pfr0_el1, ID_AA64PFR0_SVE_SHIFT,
475 		     ID_AA64PFR0_SVE_MASK, 1U, ENABLE_SVE_FOR_NS)
476 
477 /* FEAT_RAS: Reliability, Accessibility, Serviceability */
478 CREATE_FEATURE_FUNCS(feat_ras, id_aa64pfr0_el1, ID_AA64PFR0_RAS_SHIFT,
479 		     ID_AA64PFR0_RAS_MASK, 1U, ENABLE_FEAT_RAS)
480 
481 /* FEAT_DIT: Data Independent Timing instructions */
482 CREATE_FEATURE_FUNCS(feat_dit, id_aa64pfr0_el1, ID_AA64PFR0_DIT_SHIFT,
483 		     ID_AA64PFR0_DIT_MASK, 1U, ENABLE_FEAT_DIT)
484 
485 /* FEAT_SYS_REG_TRACE */
486 CREATE_FEATURE_FUNCS(feat_sys_reg_trace, id_aa64dfr0_el1, ID_AA64DFR0_TRACEVER_SHIFT,
487 		    ID_AA64DFR0_TRACEVER_MASK, 1U, ENABLE_SYS_REG_TRACE_FOR_NS)
488 
489 /* FEAT_TRF: TraceFilter */
490 CREATE_FEATURE_FUNCS(feat_trf, id_aa64dfr0_el1, ID_AA64DFR0_TRACEFILT_SHIFT,
491 		     ID_AA64DFR0_TRACEFILT_MASK, 1U, ENABLE_TRF_FOR_NS)
492 
493 /* FEAT_NV2: Enhanced Nested Virtualization */
494 CREATE_FEATURE_FUNCS(feat_nv, id_aa64mmfr2_el1, ID_AA64MMFR2_EL1_NV_SHIFT,
495 		     ID_AA64MMFR2_EL1_NV_MASK, 1U, 0U)
496 CREATE_FEATURE_FUNCS(feat_nv2, id_aa64mmfr2_el1, ID_AA64MMFR2_EL1_NV_SHIFT,
497 		     ID_AA64MMFR2_EL1_NV_MASK, NV2_IMPLEMENTED, CTX_INCLUDE_NEVE_REGS)
498 
499 /* FEAT_BRBE: Branch Record Buffer Extension */
500 CREATE_FEATURE_FUNCS(feat_brbe, id_aa64dfr0_el1, ID_AA64DFR0_BRBE_SHIFT,
501 		     ID_AA64DFR0_BRBE_MASK, 1U, ENABLE_BRBE_FOR_NS)
502 
503 /* FEAT_TRBE: Trace Buffer Extension */
504 CREATE_FEATURE_FUNCS(feat_trbe, id_aa64dfr0_el1, ID_AA64DFR0_TRACEBUFFER_SHIFT,
505 		     ID_AA64DFR0_TRACEBUFFER_MASK, 1U, ENABLE_TRBE_FOR_NS)
506 
507 /* FEAT_SME_FA64: Full A64 Instruction support in streaming SVE mode */
508 CREATE_FEATURE_PRESENT(feat_sme_fa64, id_aa64smfr0_el1, ID_AA64SMFR0_EL1_SME_FA64_SHIFT,
509 		    ID_AA64SMFR0_EL1_SME_FA64_MASK, 1U)
510 
511 /* FEAT_SMEx: Scalar Matrix Extension */
512 CREATE_FEATURE_FUNCS(feat_sme, id_aa64pfr1_el1, ID_AA64PFR1_EL1_SME_SHIFT,
513 		     ID_AA64PFR1_EL1_SME_MASK, 1U, ENABLE_SME_FOR_NS)
514 
515 CREATE_FEATURE_FUNCS(feat_sme2, id_aa64pfr1_el1, ID_AA64PFR1_EL1_SME_SHIFT,
516 		     ID_AA64PFR1_EL1_SME_MASK, SME2_IMPLEMENTED, ENABLE_SME2_FOR_NS)
517 
518 /* FEAT_LS64_ACCDATA: */
519 CREATE_FEATURE_FUNCS(feat_ls64_accdata, id_aa64isar1_el1, ID_AA64ISAR1_LS64_SHIFT,
520 		     ID_AA64ISAR1_LS64_MASK, LS64_ACCDATA_IMPLEMENTED,
521 		     ENABLE_FEAT_LS64_ACCDATA)
522 
523 /* FEAT_AIE: */
524 CREATE_FEATURE_FUNCS(feat_aie, id_aa64mmfr3_el1, ID_AA64MMFR3_EL1_AIE_SHIFT,
525 		     ID_AA64MMFR3_EL1_AIE_MASK, 1U, ENABLE_FEAT_AIE)
526 
527 /* FEAT_PFAR: */
528 CREATE_FEATURE_FUNCS(feat_pfar, id_aa64pfr1_el1, ID_AA64PFR1_EL1_PFAR_SHIFT,
529 		     ID_AA64PFR1_EL1_PFAR_MASK, 1U, ENABLE_FEAT_PFAR)
530 
531 /*******************************************************************************
532  * Function to get hardware granularity support
533  ******************************************************************************/
534 
535 __attribute__((always_inline))
536 static inline bool is_feat_tgran4K_present(void)
537 {
538 	unsigned int tgranx = ISOLATE_FIELD(read_id_aa64mmfr0_el1(),
539 			     ID_AA64MMFR0_EL1_TGRAN4_SHIFT, ID_REG_FIELD_MASK);
540 	return (tgranx < 8U);
541 }
542 
543 CREATE_FEATURE_PRESENT(feat_tgran16K, id_aa64mmfr0_el1, ID_AA64MMFR0_EL1_TGRAN16_SHIFT,
544 		       ID_AA64MMFR0_EL1_TGRAN16_MASK, TGRAN16_IMPLEMENTED)
545 
546 __attribute__((always_inline))
547 static inline bool is_feat_tgran64K_present(void)
548 {
549 	unsigned int tgranx = ISOLATE_FIELD(read_id_aa64mmfr0_el1(),
550 			     ID_AA64MMFR0_EL1_TGRAN64_SHIFT, ID_REG_FIELD_MASK);
551 	return (tgranx < 8U);
552 }
553 
554 /* FEAT_PMUV3 */
555 CREATE_FEATURE_PRESENT(feat_pmuv3, id_aa64dfr0_el1, ID_AA64DFR0_PMUVER_SHIFT,
556 		      ID_AA64DFR0_PMUVER_MASK, 1U)
557 
558 /* FEAT_MTPMU */
559 __attribute__((always_inline))
560 static inline bool is_feat_mtpmu_present(void)
561 {
562 	unsigned int mtpmu = ISOLATE_FIELD(read_id_aa64dfr0_el1(), ID_AA64DFR0_MTPMU_SHIFT,
563 					   ID_AA64DFR0_MTPMU_MASK);
564 	return (mtpmu != 0U) && (mtpmu != MTPMU_NOT_IMPLEMENTED);
565 }
566 
567 CREATE_FEATURE_SUPPORTED(feat_mtpmu, is_feat_mtpmu_present, DISABLE_MTPMU)
568 
569 /*************************************************************************
570  * Function to identify the presence of FEAT_GCIE (GICv5 CPU interface
571  * extension).
572  ************************************************************************/
573 CREATE_FEATURE_FUNCS(feat_gcie, id_aa64pfr2_el1, ID_AA64PFR2_EL1_GCIE_SHIFT,
574 		     ID_AA64PFR2_EL1_GCIE_MASK, 1U, ENABLE_FEAT_GCIE)
575 
576 CREATE_FEATURE_FUNCS(feat_cpa2, id_aa64isar3_el1, ID_AA64ISAR3_EL1_CPA_SHIFT,
577 		     ID_AA64ISAR3_EL1_CPA_MASK, CPA2_IMPLEMENTED,
578 		     ENABLE_FEAT_CPA2)
579 
580 #endif /* ARCH_FEATURES_H */
581