xref: /xnu-8792.61.2/osfmk/arm/cpu_data_internal.h (revision 42e220869062b56f8d7d0726fd4c88954f87902c)
1 /*
2  * Copyright (c) 2007-2021 Apple Inc. All rights reserved.
3  *
4  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
5  *
6  * This file contains Original Code and/or Modifications of Original Code
7  * as defined in and that are subject to the Apple Public Source License
8  * Version 2.0 (the 'License'). You may not use this file except in
9  * compliance with the License. The rights granted to you under the License
10  * may not be used to create, or enable the creation or redistribution of,
11  * unlawful or unlicensed copies of an Apple operating system, or to
12  * circumvent, violate, or enable the circumvention or violation of, any
13  * terms of an Apple operating system software license agreement.
14  *
15  * Please obtain a copy of the License at
16  * http://www.opensource.apple.com/apsl/ and read it before using this file.
17  *
18  * The Original Code and all software distributed under the License are
19  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23  * Please see the License for the specific language governing rights and
24  * limitations under the License.
25  *
26  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
27  */
28 /*
29  * @OSF_COPYRIGHT@
30  *
31  */
32 
33 #ifndef ARM_CPU_DATA_INTERNAL
34 #define ARM_CPU_DATA_INTERNAL
35 
36 #include <mach_assert.h>
37 #include <kern/assert.h>
38 #include <kern/kern_types.h>
39 #include <kern/percpu.h>
40 #include <kern/processor.h>
41 #include <pexpert/pexpert.h>
42 #include <arm/dbgwrap.h>
43 #include <arm/machine_routines.h>
44 #include <arm64/proc_reg.h>
45 #include <arm/thread.h>
46 #include <arm/pmap.h>
47 
48 #if MONOTONIC
49 #include <machine/monotonic.h>
50 #endif /* MONOTONIC */
51 
52 #include <san/kcov_data.h>
53 
54 #define NSEC_PER_HZ     (NSEC_PER_SEC / 100)
55 
56 typedef struct reset_handler_data {
57 	vm_offset_t     assist_reset_handler;           /* Assist handler phys address */
58 	vm_offset_t     cpu_data_entries;                       /* CpuDataEntries phys address */
59 } reset_handler_data_t;
60 
61 extern  reset_handler_data_t    ResetHandlerData;
62 
63 /* Put the static check for cpumap_t here as it's defined in <kern/processor.h> */
64 static_assert(sizeof(cpumap_t) * CHAR_BIT >= MAX_CPUS, "cpumap_t bitvector is too small for current MAX_CPUS value");
65 
66 #define CPUWINDOWS_BASE_MASK            0xFFFFFFFFFFE00000UL
67 #define CPUWINDOWS_BASE                 (VM_MAX_KERNEL_ADDRESS & CPUWINDOWS_BASE_MASK)
68 #define CPUWINDOWS_TOP                  (CPUWINDOWS_BASE + (MAX_CPUS * CPUWINDOWS_MAX * ARM_PGBYTES))
69 
70 static_assert((CPUWINDOWS_BASE >= VM_MIN_KERNEL_ADDRESS) && ((CPUWINDOWS_TOP - 1) <= VM_MAX_KERNEL_ADDRESS),
71     "CPU copy windows too large for CPUWINDOWS_BASE_MASK value");
72 
73 typedef struct cpu_data_entry {
74 	void                           *cpu_data_paddr;         /* Cpu data physical address */
75 	struct  cpu_data               *cpu_data_vaddr;         /* Cpu data virtual address */
76 #if !defined(__arm64__)
77 #error Check cpu_data_entry padding for this architecture
78 #endif
79 } cpu_data_entry_t;
80 
81 
82 typedef struct rtclock_timer {
83 	mpqueue_head_t                  queue;
84 	uint64_t                        deadline;
85 	uint32_t                        is_set:1,
86 	    has_expired:1,
87 	:0;
88 } rtclock_timer_t;
89 
90 typedef struct {
91 	/*
92 	 * The wake variants of these counters are reset to 0 when the CPU wakes.
93 	 */
94 	uint64_t irq_ex_cnt;
95 	uint64_t irq_ex_cnt_wake;
96 	uint64_t ipi_cnt;
97 	uint64_t ipi_cnt_wake;
98 	uint64_t timer_cnt;
99 #if MONOTONIC
100 	uint64_t pmi_cnt_wake;
101 #endif /* MONOTONIC */
102 	uint64_t undef_ex_cnt;
103 	uint64_t unaligned_cnt;
104 	uint64_t vfp_cnt;
105 	uint64_t data_ex_cnt;
106 	uint64_t instr_ex_cnt;
107 } cpu_stat_t;
108 
109 typedef struct cpu_data {
110 	short                           cpu_number;
111 	unsigned short                  cpu_flags;
112 	int                             cpu_type;
113 	int                             cpu_subtype;
114 	int                             cpu_threadtype;
115 
116 	vm_offset_t                     istackptr;
117 	vm_offset_t                     intstack_top;
118 #if __arm64__
119 	vm_offset_t                     excepstackptr;
120 	vm_offset_t                     excepstack_top;
121 #endif
122 	thread_t                        cpu_active_thread;
123 	vm_offset_t                     cpu_active_stack;
124 	cpu_id_t                        cpu_id;
125 	unsigned volatile int           cpu_signal;
126 	ast_t                           cpu_pending_ast;
127 	cache_dispatch_t                cpu_cache_dispatch;
128 
129 #if __arm64__
130 	uint64_t                        cpu_base_timebase;
131 	uint64_t                        cpu_timebase;
132 #endif
133 	bool                            cpu_hibernate; /* This cpu is currently hibernating the system */
134 	bool                            cpu_running;
135 	bool                            cluster_master;
136 #if __ARM_ARCH_8_5__
137 	bool                            sync_on_cswitch;
138 #endif /* __ARM_ARCH_8_5__ */
139 	/* true if processor_start() or processor_exit() is operating on this CPU */
140 	bool                            in_state_transition;
141 
142 	uint32_t                        cpu_decrementer;
143 	get_decrementer_t               cpu_get_decrementer_func;
144 	set_decrementer_t               cpu_set_decrementer_func;
145 	fiq_handler_t                   cpu_get_fiq_handler;
146 
147 	void                            *cpu_tbd_hardware_addr;
148 	void                            *cpu_tbd_hardware_val;
149 
150 	processor_idle_t                cpu_idle_notify;
151 	uint64_t                        cpu_idle_latency;
152 	uint64_t                        cpu_idle_pop;
153 
154 #if     __ARM_KERNEL_PROTECT__
155 	vm_offset_t                     cpu_exc_vectors;
156 #endif /* __ARM_KERNEL_PROTECT__ */
157 	vm_offset_t                     cpu_reset_handler;
158 	uintptr_t                       cpu_reset_assist;
159 	uint32_t                        cpu_reset_type;
160 
161 	unsigned int                    interrupt_source;
162 	void                            *cpu_int_state;
163 	IOInterruptHandler              interrupt_handler;
164 	void                            *interrupt_nub;
165 	void                            *interrupt_target;
166 	void                            *interrupt_refCon;
167 
168 	idle_timer_t                    idle_timer_notify;
169 	void                            *idle_timer_refcon;
170 	uint64_t                        idle_timer_deadline;
171 
172 	uint64_t                        rtcPop;
173 	rtclock_timer_t                 rtclock_timer;
174 	struct _rtclock_data_           *rtclock_datap;
175 
176 	arm_debug_state_t               *cpu_user_debug; /* Current debug state */
177 	vm_offset_t                     cpu_debug_interface_map;
178 
179 	volatile int                    debugger_active;
180 	volatile int                    PAB_active; /* Tells the console if we are dumping backtraces */
181 
182 	void                            *cpu_xcall_p0;
183 	void                            *cpu_xcall_p1;
184 	void                            *cpu_imm_xcall_p0;
185 	void                            *cpu_imm_xcall_p1;
186 
187 
188 #if     __arm64__
189 	vm_offset_t                     coresight_base[CORESIGHT_REGIONS];
190 #endif
191 
192 	/* CCC ARMv8 registers */
193 	uint64_t                        cpu_regmap_paddr;
194 
195 	uint32_t                        cpu_phys_id;
196 	uint32_t                        cpu_l2_access_penalty;
197 	platform_error_handler_t        platform_error_handler;
198 
199 	int                             cpu_mcount_off;
200 
201 	#define ARM_CPU_ON_SLEEP_PATH   0x50535553UL
202 	volatile unsigned int           cpu_sleep_token;
203 	unsigned int                    cpu_sleep_token_last;
204 
205 	cluster_type_t                  cpu_cluster_type;
206 	uint32_t                        cpu_cluster_id;
207 	uint32_t                        cpu_l2_id;
208 	uint32_t                        cpu_l2_size;
209 	uint32_t                        cpu_l3_id;
210 	uint32_t                        cpu_l3_size;
211 
212 	enum {
213 		CPU_NOT_HALTED = 0,
214 		CPU_HALTED,
215 		CPU_HALTED_WITH_STATE
216 	}                               halt_status;
217 #if defined(HAS_APPLE_PAC)
218 	uint64_t                        rop_key;
219 	uint64_t                        jop_key;
220 #endif /* defined(HAS_APPLE_PAC) */
221 
222 	/* large structs with large alignment requirements */
223 #if KPC
224 	/* double-buffered performance counter data */
225 	uint64_t                        *cpu_kpc_buf[2];
226 	/* PMC shadow and reload value buffers */
227 	uint64_t                        *cpu_kpc_shadow;
228 	uint64_t                        *cpu_kpc_reload;
229 #endif
230 #if MONOTONIC
231 	struct mt_cpu                   cpu_monotonic;
232 #endif /* MONOTONIC */
233 	cpu_stat_t                      cpu_stat;
234 #if !XNU_MONITOR
235 	struct pmap_cpu_data            cpu_pmap_cpu_data;
236 #endif
237 	dbgwrap_thread_state_t          halt_state;
238 #if DEVELOPMENT || DEBUG
239 	uint64_t                        wfe_count;
240 	uint64_t                        wfe_deadline_checks;
241 	uint64_t                        wfe_terminations;
242 #endif
243 #if CONFIG_KCOV
244 	kcov_cpu_data_t                 cpu_kcov_data;
245 #endif
246 #if __arm64__
247 	/**
248 	 * Stash the state of the system when an IPI is received. This will be
249 	 * dumped in the case a panic is getting triggered.
250 	 */
251 	uint64_t ipi_pc;
252 	uint64_t ipi_lr;
253 	uint64_t ipi_fp;
254 #endif
255 } cpu_data_t;
256 
257 /*
258  * cpu_flags
259  */
260 #define SleepState                      0x0800
261 #define StartedState                    0x1000
262 
263 extern  cpu_data_entry_t                CpuDataEntries[MAX_CPUS];
264 PERCPU_DECL(cpu_data_t, cpu_data);
265 #define BootCpuData                     __PERCPU_NAME(cpu_data)
266 extern  boot_args                      *BootArgs;
267 
268 #if __arm64__
269 extern  unsigned int                    LowResetVectorBase;
270 extern  unsigned int                    LowResetVectorEnd;
271 #if WITH_CLASSIC_S2R
272 extern  uint8_t                         SleepToken[8];
273 #endif
274 extern  unsigned int                    LowExceptionVectorBase;
275 #else
276 #error Unknown arch
277 #endif
278 
279 extern cpu_data_t      *cpu_datap(int cpu);
280 extern cpu_data_t      *cpu_data_alloc(boolean_t is_boot);
281 extern void             cpu_stack_alloc(cpu_data_t*);
282 extern void             cpu_data_init(cpu_data_t *cpu_data_ptr);
283 extern void             cpu_data_free(cpu_data_t *cpu_data_ptr);
284 extern kern_return_t    cpu_data_register(cpu_data_t *cpu_data_ptr);
285 extern cpu_data_t      *processor_to_cpu_datap( processor_t processor);
286 
287 #if __arm64__
288 typedef struct sysreg_restore {
289 	uint64_t                tcr_el1;
290 } sysreg_restore_t;
291 
292 extern sysreg_restore_t sysreg_restore;
293 #endif  /* __arm64__ */
294 
295 #endif  /* ARM_CPU_DATA_INTERNAL */
296