2 * Copyright (c) 2000-2006 Apple Computer, Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
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.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
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.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
30 * i386 platform expert initialization.
33 #include <sys/types.h>
34 #include <mach/vm_param.h>
35 #include <machine/machine_routines.h>
36 #include <pexpert/protos.h>
37 #include <pexpert/pexpert.h>
38 #include <pexpert/boot.h>
39 #include <pexpert/device_tree.h>
40 #include <pexpert/pe_images.h>
41 #include <kern/sched_prim.h>
42 #include <kern/debug.h>
48 #include "boot_images.h"
50 /* extern references */
51 extern void pe_identify_machine(void * args
);
52 extern int kdb_printf(const char *format
, ...) __printflike(1,2);
56 /* Clock Frequency Info */
57 clock_frequency_info_t gPEClockFrequencyInfo
;
59 void *gPEEFISystemTable
;
60 void *gPEEFIRuntimeServices
;
62 static boot_icon_element
* norootIcon_lzss
;
63 static const uint8_t* norootClut_lzss
;
65 int PE_initialize_console( PE_Video
* info
, int op
)
67 static int last_console
= -1;
72 info
->v_display
= GRAPHICS_MODE
;
77 case kPEDisableScreen
:
78 initialize_screen(info
, op
);
79 kprintf("kPEDisableScreen %d\n", last_console
);
80 if (!console_is_serial())
81 last_console
= switch_to_serial_console();
85 initialize_screen(info
, op
);
86 if (info
) PE_state
.video
= *info
;
87 kprintf("kPEEnableScreen %d\n", last_console
);
88 if( last_console
!= -1)
89 switch_to_old_console( last_console
);
92 case kPEBaseAddressChange
:
93 if (info
) PE_state
.video
= *info
;
97 initialize_screen(info
, op
);
104 void PE_init_iokit(void)
106 enum { kMaxBootVar
= 128 };
108 boolean_t bootClutInitialized
= FALSE
;
109 boolean_t noroot_rle_Initialized
= FALSE
;
114 boot_progress_element
*bootPict
;
116 norootIcon_lzss
= NULL
;
117 norootClut_lzss
= NULL
;
119 PE_init_kprintf(TRUE
);
120 PE_init_printf(TRUE
);
122 kprintf("Kernel boot args: '%s'\n", PE_boot_args());
125 * Fetch the CLUT and the noroot image.
128 if( kSuccess
== DTLookupEntry(NULL
, "/chosen/memory-map", &entry
)) {
129 if( kSuccess
== DTGetProperty(entry
, "BootCLUT", (void **) &map
, &size
)) {
130 if (sizeof(appleClut8
) <= map
[1]) {
131 bcopy( (void *)ml_static_ptovirt(map
[0]), appleClut8
, sizeof(appleClut8
) );
132 bootClutInitialized
= TRUE
;
136 if( kSuccess
== DTGetProperty(entry
, "Pict-FailedBoot", (void **) &map
, &size
)) {
137 bootPict
= (boot_progress_element
*) ml_static_ptovirt(map
[0]);
138 default_noroot
.width
= bootPict
->width
;
139 default_noroot
.height
= bootPict
->height
;
140 default_noroot
.dx
= 0;
141 default_noroot
.dy
= bootPict
->yOffset
;
142 default_noroot_data
= &bootPict
->data
[0];
143 noroot_rle_Initialized
= TRUE
;
146 if( kSuccess
== DTGetProperty(entry
, "FailedCLUT", (void **) &map
, &size
)) {
147 norootClut_lzss
= (uint8_t*) ml_static_ptovirt(map
[0]);
150 if( kSuccess
== DTGetProperty(entry
, "FailedImage", (void **) &map
, &size
)) {
151 norootIcon_lzss
= (boot_icon_element
*) ml_static_ptovirt(map
[0]);
152 if (norootClut_lzss
== NULL
) {
153 printf("ERROR: No FailedCLUT provided for noroot icon!\n");
158 if (!bootClutInitialized
) {
159 bcopy( (void *) (uintptr_t) bootClut
, (void *) appleClut8
, sizeof(appleClut8
) );
162 if (!noroot_rle_Initialized
) {
163 default_noroot
.width
= kFailedBootWidth
;
164 default_noroot
.height
= kFailedBootHeight
;
165 default_noroot
.dx
= 0;
166 default_noroot
.dy
= kFailedBootOffset
;
167 default_noroot_data
= failedBootPict
;
171 * Initialize the spinning wheel (progress indicator).
173 vc_progress_initialize(&default_progress
,
174 default_progress_data1x
,
175 default_progress_data2x
,
176 default_progress_data3x
,
177 (unsigned char *) appleClut8
);
179 StartIOKit( PE_state
.deviceTreeHead
, PE_state
.bootArgs
, gPEEFIRuntimeServices
, NULL
);
182 void PE_init_platform(boolean_t vm_initialized
, void * _args
)
184 boot_args
*args
= (boot_args
*)_args
;
186 if (PE_state
.initialized
== FALSE
) {
187 PE_state
.initialized
= TRUE
;
190 PE_state
.bootArgs
= _args
;
191 PE_state
.deviceTreeHead
= (void *) ml_static_ptovirt(args
->deviceTreeP
);
192 if (args
->Video
.v_baseAddr
) {
193 PE_state
.video
.v_baseAddr
= args
->Video
.v_baseAddr
; // remains physical address
194 PE_state
.video
.v_rowBytes
= args
->Video
.v_rowBytes
;
195 PE_state
.video
.v_width
= args
->Video
.v_width
;
196 PE_state
.video
.v_height
= args
->Video
.v_height
;
197 PE_state
.video
.v_depth
= args
->Video
.v_depth
;
198 PE_state
.video
.v_display
= args
->Video
.v_display
;
199 strlcpy(PE_state
.video
.v_pixelFormat
, "PPPPPPPP",
200 sizeof(PE_state
.video
.v_pixelFormat
));
202 PE_state
.video
.v_baseAddr
= args
->VideoV1
.v_baseAddr
; // remains physical address
203 PE_state
.video
.v_rowBytes
= args
->VideoV1
.v_rowBytes
;
204 PE_state
.video
.v_width
= args
->VideoV1
.v_width
;
205 PE_state
.video
.v_height
= args
->VideoV1
.v_height
;
206 PE_state
.video
.v_depth
= args
->VideoV1
.v_depth
;
207 PE_state
.video
.v_display
= args
->VideoV1
.v_display
;
208 strlcpy(PE_state
.video
.v_pixelFormat
, "PPPPPPPP",
209 sizeof(PE_state
.video
.v_pixelFormat
));
212 #ifdef kBootArgsFlagHiDPI
213 if (args
->flags
& kBootArgsFlagHiDPI
)
214 PE_state
.video
.v_scale
= kPEScaleFactor2x
;
216 PE_state
.video
.v_scale
= kPEScaleFactor1x
;
218 PE_state
.video
.v_scale
= kPEScaleFactor1x
;
222 if (!vm_initialized
) {
224 if (PE_state
.deviceTreeHead
) {
225 DTInit(PE_state
.deviceTreeHead
);
228 pe_identify_machine(args
);
234 void PE_create_console( void )
236 if ( PE_state
.video
.v_display
== GRAPHICS_MODE
)
237 PE_initialize_console( &PE_state
.video
, kPEGraphicsMode
);
239 PE_initialize_console( &PE_state
.video
, kPETextMode
);
242 int PE_current_console( PE_Video
* info
)
244 *info
= PE_state
.video
;
249 void PE_display_icon( __unused
unsigned int flags
, __unused
const char * name
)
251 if ( norootIcon_lzss
&& norootClut_lzss
) {
252 uint32_t width
= norootIcon_lzss
->width
;
253 uint32_t height
= norootIcon_lzss
->height
;
254 uint32_t x
= ((PE_state
.video
.v_width
- width
) / 2);
255 uint32_t y
= ((PE_state
.video
.v_height
- height
) / 2) + norootIcon_lzss
->y_offset_from_center
;
257 vc_display_lzss_icon(x
, y
, width
, height
,
258 &norootIcon_lzss
->data
[0],
259 norootIcon_lzss
->data_size
,
262 else if ( default_noroot_data
) {
263 vc_display_icon( &default_noroot
, default_noroot_data
);
265 printf("ERROR: No data found for noroot icon!\n");
270 PE_get_hotkey(__unused
unsigned char key
)
275 static timebase_callback_func gTimebaseCallback
;
277 void PE_register_timebase_callback(timebase_callback_func callback
)
279 gTimebaseCallback
= callback
;
281 PE_call_timebase_callback();
284 void PE_call_timebase_callback(void)
286 struct timebase_freq_t timebase_freq
;
287 unsigned long num
, den
, cnt
;
289 num
= gPEClockFrequencyInfo
.bus_clock_rate_num
* gPEClockFrequencyInfo
.bus_to_dec_rate_num
;
290 den
= gPEClockFrequencyInfo
.bus_clock_rate_den
* gPEClockFrequencyInfo
.bus_to_dec_rate_den
;
294 if ((num
% cnt
) || (den
% cnt
)) {
303 timebase_freq
.timebase_num
= num
;
304 timebase_freq
.timebase_den
= den
;
306 if (gTimebaseCallback
) gTimebaseCallback(&timebase_freq
);
310 * The default (non-functional) PE_poll_input handler.
313 PE_stub_poll_input(__unused
unsigned int options
, char * c
)
316 return 1; /* 0 for success, 1 for unsupported */
320 * Called by the kernel debugger to poll for keyboard input.
321 * Keyboard drivers may replace the default stub function
322 * with their polled-mode input function.
324 int (*PE_poll_input
)(unsigned int options
, char * c
)
325 = PE_stub_poll_input
;
328 PE_reboot_on_panic(void)
330 boot_args
*args
= (boot_args
*)PE_state
.bootArgs
;
332 if (args
->flags
& kBootArgsFlagRebootOnPanic
)
339 PE_sync_panic_buffers(void)
343 /* rdar://problem/21244753 */
345 PE_i_can_has_debugger(uint32_t *debug_flags
)
347 #if DEVELOPMENT || DEBUG
349 assert(debug_boot_arg_inited
);
354 if (csr_check(CSR_ALLOW_KERNEL_DEBUGGER
) != 0) {
361 *debug_flags
= debug_boot_arg
;
367 PE_get_offset_into_panic_region(char *location
)
369 assert(panic_info
!= NULL
);
370 assert(location
> (char *) panic_info
);
372 return (uint32_t) (location
- (char *) panic_info
);
376 PE_init_panicheader()
378 bzero(panic_info
, offsetof(struct macos_panic_header
, mph_data
));
379 panic_info
->mph_panic_log_offset
= PE_get_offset_into_panic_region(debug_buf_base
);
381 panic_info
->mph_magic
= MACOS_PANIC_MAGIC
;
382 panic_info
->mph_version
= MACOS_PANIC_HEADER_CURRENT_VERSION
;
388 * Tries to update the panic header to keep it consistent on nested panics.
390 * NOTE: The purpose of this function is NOT to detect/correct corruption in the panic region,
391 * it is to update the panic header to make it consistent when we nest panics.
393 * We try to avoid nested panics/asserts on x86 because they are difficult to debug, so log any
394 * inconsistencies we find.
397 PE_update_panicheader_nestedpanic()
399 /* If the panic log offset is not set, re-init the panic header */
400 if (panic_info
->mph_panic_log_offset
== 0) {
401 PE_init_panicheader();
402 panic_info
->mph_panic_flags
|= MACOS_PANIC_HEADER_FLAG_NESTED_PANIC
;
406 panic_info
->mph_panic_flags
|= MACOS_PANIC_HEADER_FLAG_NESTED_PANIC
;
408 /* Usually indicative of corruption in the panic region */
409 if(!(((panic_info
->mph_stackshot_offset
== 0) && (panic_info
->mph_stackshot_len
== 0)) ||
410 ((panic_info
->mph_stackshot_offset
!= 0) && (panic_info
->mph_stackshot_len
!= 0)))) {
411 kdb_printf("panic_info contains invalid stackshot metadata: mph_stackshot_offset 0x%x mph_stackshot_len 0x%x\n",
412 panic_info
->mph_stackshot_offset
, panic_info
->mph_stackshot_len
);
416 * macOS panic logs contain nested panic data, if we've already closed the panic log,
417 * begin the other log.
419 if ((panic_info
->mph_panic_log_len
!= 0) && (panic_info
->mph_other_log_offset
== 0)) {
420 panic_info
->mph_other_log_offset
= PE_get_offset_into_panic_region(debug_buf_ptr
);
422 /* Usually indicative of corruption in the panic region */
423 if (panic_info
->mph_other_log_len
!= 0) {
424 kdb_printf("panic_info contains invalid other log metadata (zero offset but non-zero length), length was 0x%x, zeroing value\n",
425 panic_info
->mph_other_log_len
);
426 panic_info
->mph_other_log_len
= 0;