Zephyr Project API  3.3.0
A Scalable Open Source RTOS
lib_helpers.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2021 Carlo Caione <ccaione@baylibre.com>
3 *
4 * SPDX-License-Identifier: Apache-2.0
5 */
6
7#ifndef ZEPHYR_INCLUDE_ARCH_ARM64_LIB_HELPERS_H_
8#define ZEPHYR_INCLUDE_ARCH_ARM64_LIB_HELPERS_H_
9
10#ifndef _ASMLANGUAGE
11
13#include <stdint.h>
14
15/* All the macros need a memory clobber */
16
17#define read_sysreg(reg) \
18({ \
19 uint64_t val; \
20 __asm__ volatile ("mrs %0, " STRINGIFY(reg) \
21 : "=r" (val) :: "memory"); \
22 val; \
23})
24
25#define write_sysreg(val, reg) \
26({ \
27 __asm__ volatile ("msr " STRINGIFY(reg) ", %0" \
28 :: "r" (val) : "memory"); \
29})
30
31#define zero_sysreg(reg) \
32({ \
33 __asm__ volatile ("msr " STRINGIFY(reg) ", xzr" \
34 ::: "memory"); \
35})
36
37#define MAKE_REG_HELPER(reg) \
38 static ALWAYS_INLINE uint64_t read_##reg(void) \
39 { \
40 return read_sysreg(reg); \
41 } \
42 static ALWAYS_INLINE void write_##reg(uint64_t val) \
43 { \
44 write_sysreg(val, reg); \
45 } \
46 static ALWAYS_INLINE void zero_##reg(void) \
47 { \
48 zero_sysreg(reg); \
49 }
50
51#define MAKE_REG_HELPER_EL123(reg) \
52 MAKE_REG_HELPER(reg##_el1) \
53 MAKE_REG_HELPER(reg##_el2) \
54 MAKE_REG_HELPER(reg##_el3)
55
56MAKE_REG_HELPER(ccsidr_el1);
57MAKE_REG_HELPER(clidr_el1);
58MAKE_REG_HELPER(cntfrq_el0);
59MAKE_REG_HELPER(cnthctl_el2);
60MAKE_REG_HELPER(cnthp_ctl_el2);
61MAKE_REG_HELPER(cnthps_ctl_el2);
62MAKE_REG_HELPER(cntv_ctl_el0)
63MAKE_REG_HELPER(cntv_cval_el0)
64MAKE_REG_HELPER(cntvct_el0);
65MAKE_REG_HELPER(cntvoff_el2);
66MAKE_REG_HELPER(currentel);
67MAKE_REG_HELPER(csselr_el1);
70MAKE_REG_HELPER(id_aa64pfr0_el1);
71MAKE_REG_HELPER(id_aa64mmfr0_el1);
72MAKE_REG_HELPER(mpidr_el1);
75MAKE_REG_HELPER(tpidrro_el0);
76MAKE_REG_HELPER(vmpidr_el2);
77
90
91#if defined(CONFIG_ARM_MPU)
92/* Armv8-R aarch64 mpu registers */
93#define mpuir_el1 S3_0_c0_c0_4
94#define prselr_el1 S3_0_c6_c2_1
95#define prbar_el1 S3_0_c6_c8_0
96#define prlar_el1 S3_0_c6_c8_1
97
98MAKE_REG_HELPER(mpuir_el1);
99MAKE_REG_HELPER(prselr_el1);
100MAKE_REG_HELPER(prbar_el1);
101MAKE_REG_HELPER(prlar_el1);
102#endif
103
105{
106 __asm__ volatile ("msr DAIFClr, %0"
107 :: "i" (DAIFCLR_DBG_BIT) : "memory");
108}
109
111{
112 __asm__ volatile ("msr DAIFSet, %0"
113 :: "i" (DAIFSET_DBG_BIT) : "memory");
114}
115
117{
118 __asm__ volatile ("msr DAIFClr, %0"
119 :: "i" (DAIFCLR_ABT_BIT) : "memory");
120}
121
123{
124 __asm__ volatile ("msr DAIFSet, %0"
125 :: "i" (DAIFSET_ABT_BIT) : "memory");
126}
127
128static ALWAYS_INLINE void enable_irq(void)
129{
130 __asm__ volatile ("msr DAIFClr, %0"
131 :: "i" (DAIFCLR_IRQ_BIT) : "memory");
132}
133
134static ALWAYS_INLINE void disable_irq(void)
135{
136 __asm__ volatile ("msr DAIFSet, %0"
137 :: "i" (DAIFSET_IRQ_BIT) : "memory");
138}
139
140static ALWAYS_INLINE void enable_fiq(void)
141{
142 __asm__ volatile ("msr DAIFClr, %0"
143 :: "i" (DAIFCLR_FIQ_BIT) : "memory");
144}
145
146static ALWAYS_INLINE void disable_fiq(void)
147{
148 __asm__ volatile ("msr DAIFSet, %0"
149 :: "i" (DAIFSET_FIQ_BIT) : "memory");
150}
151
152#define sev() __asm__ volatile("sev" : : : "memory")
153#define wfe() __asm__ volatile("wfe" : : : "memory")
154#define wfi() __asm__ volatile("wfi" : : : "memory")
155
156#define dsb() __asm__ volatile ("dsb sy" ::: "memory")
157#define dmb() __asm__ volatile ("dmb sy" ::: "memory")
158#define isb() __asm__ volatile ("isb" ::: "memory")
159
160/* Zephyr needs these as well */
161#define __ISB() isb()
162#define __DMB() dmb()
163#define __DSB() dsb()
164
165static inline bool is_el_implemented(unsigned int el)
166{
167 unsigned int shift;
168
169 if (el > 3) {
170 return false;
171 }
172
173 shift = ID_AA64PFR0_EL1_SHIFT * el;
174
175 return (((read_id_aa64pfr0_el1() >> shift) & ID_AA64PFR0_ELX_MASK) != 0U);
176}
177
178static inline bool is_el_highest_implemented(void)
179{
180 uint32_t el_highest;
181 uint32_t curr_el;
182
183 el_highest = read_id_aa64pfr0_el1() & 0xFFFF;
184 el_highest = (31U - __builtin_clz(el_highest)) / 4;
185
186 curr_el = GET_EL(read_currentel());
187
188 if (curr_el < el_highest)
189 return false;
190
191 return true;
192}
193
194static inline bool is_el2_sec_supported(void)
195{
197 ID_AA64PFR0_SEL2_MASK) != 0U);
198}
199
200static inline bool is_in_secure_state(void)
201{
202 /* We cannot read SCR_EL3 from EL2 or EL1 */
203 return !IS_ENABLED(CONFIG_ARMV8_A_NS);
204}
205
206#endif /* !_ASMLANGUAGE */
207
208#endif /* ZEPHYR_INCLUDE_ARCH_ARM64_LIB_HELPERS_H_ */
static ALWAYS_INLINE void disable_serror_exceptions(void)
Definition: lib_helpers.h:122
static ALWAYS_INLINE uint64_t read_id_aa64pfr0_el1(void)
Definition: lib_helpers.h:70
#define MAKE_REG_HELPER(reg)
Definition: lib_helpers.h:37
static ALWAYS_INLINE void disable_debug_exceptions(void)
Definition: lib_helpers.h:110
static bool is_el_implemented(unsigned int el)
Definition: lib_helpers.h:165
static bool is_el_highest_implemented(void)
Definition: lib_helpers.h:178
static ALWAYS_INLINE void disable_irq(void)
Definition: lib_helpers.h:134
static ALWAYS_INLINE void enable_irq(void)
Definition: lib_helpers.h:128
static ALWAYS_INLINE void disable_fiq(void)
Definition: lib_helpers.h:146
static ALWAYS_INLINE void enable_debug_exceptions(void)
Definition: lib_helpers.h:104
#define MAKE_REG_HELPER_EL123(reg)
Definition: lib_helpers.h:51
static ALWAYS_INLINE void enable_serror_exceptions(void)
Definition: lib_helpers.h:116
static ALWAYS_INLINE uint64_t read_currentel(void)
Definition: lib_helpers.h:66
static ALWAYS_INLINE void enable_fiq(void)
Definition: lib_helpers.h:140
static bool is_in_secure_state(void)
Definition: lib_helpers.h:200
static bool is_el2_sec_supported(void)
Definition: lib_helpers.h:194
#define ALWAYS_INLINE
Definition: common.h:124
#define IS_ENABLED(config_macro)
Check for macro definition in compiler-visible expressions.
Definition: util_macro.h:121
#define GET_EL(_mode)
Definition: cpu.h:92
#define DAIFCLR_ABT_BIT
Definition: cpu.h:19
#define DAIFSET_IRQ_BIT
Definition: cpu.h:13
#define ID_AA64PFR0_SEL2_MASK
Definition: cpu.h:114
#define DAIFSET_ABT_BIT
Definition: cpu.h:14
#define DAIFSET_FIQ_BIT
Definition: cpu.h:12
#define DAIFCLR_IRQ_BIT
Definition: cpu.h:18
#define ID_AA64PFR0_SEL2_SHIFT
Definition: cpu.h:113
#define ID_AA64PFR0_EL1_SHIFT
Definition: cpu.h:109
#define DAIFCLR_FIQ_BIT
Definition: cpu.h:17
#define ID_AA64PFR0_ELX_MASK
Definition: cpu.h:112
#define DAIFSET_DBG_BIT
Definition: cpu.h:15
#define DAIFCLR_DBG_BIT
Definition: cpu.h:20
__UINT32_TYPE__ uint32_t
Definition: stdint.h:90