pexpert/pexpert/pexpert.h

   1 /*
   2  * Copyright (c) 2000-2006 Apple Computer, 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 #ifndef _PEXPERT_PEXPERT_H_
  29 #define _PEXPERT_PEXPERT_H_
  30
  31 #include <sys/cdefs.h>
  32
  33 #include <IOKit/IOInterrupts.h>
  34 #include <kern/kern_types.h>
  35
  36 __BEGIN_DECLS
  37 #include <mach/boolean.h>
  38 #include <mach/kern_return.h>
  39 #include <mach/machine/vm_types.h>
  40
  41 #ifdef PEXPERT_KERNEL_PRIVATE
  42 #include <pexpert/protos.h>
  43 #endif
  44 #include <pexpert/boot.h>
  45
  46 #if     defined(PEXPERT_KERNEL_PRIVATE) || defined(IOKIT_KERNEL_PRIVATE)
  47 typedef void *cpu_id_t;
  48 #else
  49 typedef void *cpu_id_t;
  50 #endif
  51
  52
  53 void PE_enter_debugger(
  54         const char *cause);
  55
  56 void PE_init_platform(
  57         boolean_t vm_initialized,
  58         void *args);
  59
  60
  61
  62
  63 void PE_init_kprintf(
  64         boolean_t vm_initialized);
  65
  66 extern int32_t gPESerialBaud;
  67
  68 unsigned int PE_init_taproot(vm_offset_t *taddr);
  69
  70 extern void (*PE_kputc)(char c);
  71
  72 void PE_init_printf(
  73         boolean_t vm_initialized);
  74
  75 extern void (*PE_putc)(char c);
  76
  77 void PE_init_iokit(
  78         void);
  79
  80 struct clock_frequency_info_t {
  81   unsigned long bus_clock_rate_hz;
  82   unsigned long cpu_clock_rate_hz;
  83   unsigned long dec_clock_rate_hz;
  84   unsigned long bus_clock_rate_num;
  85   unsigned long bus_clock_rate_den;
  86   unsigned long bus_to_cpu_rate_num;
  87   unsigned long bus_to_cpu_rate_den;
  88   unsigned long bus_to_dec_rate_num;
  89   unsigned long bus_to_dec_rate_den;
  90   unsigned long timebase_frequency_hz;
  91   unsigned long timebase_frequency_num;
  92   unsigned long timebase_frequency_den;
  93   unsigned long long bus_frequency_hz;
  94   unsigned long long bus_frequency_min_hz;
  95   unsigned long long bus_frequency_max_hz;
  96   unsigned long long cpu_frequency_hz;
  97   unsigned long long cpu_frequency_min_hz;
  98   unsigned long long cpu_frequency_max_hz;
  99   unsigned long long prf_frequency_hz;
 100   unsigned long long prf_frequency_min_hz;
 101   unsigned long long prf_frequency_max_hz;
 102   unsigned long long mem_frequency_hz;
 103   unsigned long long mem_frequency_min_hz;
 104   unsigned long long mem_frequency_max_hz;
 105   unsigned long long fix_frequency_hz;
 106 };
 107
 108 typedef struct clock_frequency_info_t clock_frequency_info_t;
 109
 110 extern clock_frequency_info_t gPEClockFrequencyInfo;
 111
 112 struct timebase_freq_t {
 113   unsigned long timebase_num;
 114   unsigned long timebase_den;
 115 };
 116
 117 typedef void (*timebase_callback_func)(struct timebase_freq_t *timebase_freq);
 118
 119 void PE_register_timebase_callback(timebase_callback_func callback);
 120
 121 void PE_call_timebase_callback(void);
 122
 123 void PE_install_interrupt_handler(
 124         void *nub, int source,
 125         void *target, IOInterruptHandler handler, void *refCon);
 126
 127 #ifndef _FN_KPRINTF
 128 #define _FN_KPRINTF
 129 void kprintf(const char *fmt, ...) __printflike(1,2);
 130 #endif
 131
 132 #if CONFIG_NO_KPRINTF_STRINGS
 133 #define kprintf(x, ...) do {} while (0)
 134 #endif
 135
 136 void init_display_putc(unsigned char *baseaddr, int rowbytes, int height);
 137 void display_putc(char c);
 138
 139 enum {
 140     kPEReadTOD,
 141     kPEWriteTOD
 142 };
 143 extern int (*PE_read_write_time_of_day)(
 144         unsigned int options,
 145         long * secs);
 146
 147 enum {
 148     kPEWaitForInput     = 0x00000001,
 149     kPERawInput         = 0x00000002
 150 };
 151 extern int (*PE_poll_input)(
 152         unsigned int options,
 153         char * c);
 154
 155 extern int (*PE_write_IIC)(
 156         unsigned char addr,
 157         unsigned char reg,
 158         unsigned char data);
 159
 160 /* Private Stuff - eventually put in pexpertprivate.h */
 161 enum {
 162     kDebugTypeNone    = 0,
 163     kDebugTypeDisplay = 1,
 164     kDebugTypeSerial  = 2
 165 };
 166
 167 struct PE_Video {
 168         unsigned long   v_baseAddr;     /* Base address of video memory */
 169         unsigned long   v_rowBytes;     /* Number of bytes per pixel row */
 170         unsigned long   v_width;        /* Width */
 171         unsigned long   v_height;       /* Height */
 172         unsigned long   v_depth;        /* Pixel Depth */
 173         unsigned long   v_display;      /* Text or Graphics */
 174         char            v_pixelFormat[64];
 175         unsigned long   v_offset;       /* offset into video memory to start at */
 176         unsigned long   v_length;       /* length of video memory (0 for v_rowBytes * v_height) */
 177         long            v_resv[ 2 ];
 178 };
 179
 180 typedef struct PE_Video       PE_Video;
 181
 182 extern void initialize_screen(PE_Video *, unsigned int);
 183
 184 extern int PE_current_console(
 185         PE_Video *info);
 186
 187 extern void PE_create_console(
 188         void);
 189
 190 extern int PE_initialize_console(
 191         PE_Video *newInfo,
 192         int op);
 193
 194 #define kPEGraphicsMode         1
 195 #define kPETextMode             2
 196 #define kPETextScreen           3
 197 #define kPEAcquireScreen        4
 198 #define kPEReleaseScreen        5
 199 #define kPEEnableScreen         6
 200 #define kPEDisableScreen        7
 201
 202 extern void PE_display_icon( unsigned int flags,
 203                              const char * name );
 204
 205 typedef struct PE_state {
 206         boolean_t       initialized;
 207         PE_Video        video;
 208         void            *deviceTreeHead;
 209         void            *bootArgs;
 210 #if defined(i386) || defined(arm)
 211         void            *fakePPCBootArgs;
 212 #endif
 213 } PE_state_t;
 214
 215 extern PE_state_t PE_state;
 216
 217 extern char * PE_boot_args(
 218         void);
 219
 220 extern boolean_t PE_parse_boot_arg(
 221         const char      *arg_string,
 222         void            *arg_ptr);
 223
 224 extern boolean_t PE_parse_boot_argn(
 225         const char      *arg_string,
 226         void            *arg_ptr,
 227         int                     max_arg);
 228
 229 enum {
 230     kPEOptionKey        = 0x3a,
 231     kPECommandKey       = 0x37,
 232     kPEControlKey       = 0x36,
 233     kPEShiftKey         = 0x38
 234 };
 235
 236 extern boolean_t PE_get_hotkey(
 237         unsigned char   key);
 238
 239 extern kern_return_t PE_cpu_start(
 240         cpu_id_t target,
 241         vm_offset_t start_paddr,
 242         vm_offset_t arg_paddr);
 243
 244 extern void PE_cpu_halt(
 245         cpu_id_t target);
 246
 247 extern void PE_cpu_signal(
 248         cpu_id_t source,
 249         cpu_id_t target);
 250
 251 extern void PE_cpu_machine_init(
 252         cpu_id_t target,
 253         boolean_t bootb);
 254
 255 extern void PE_cpu_machine_quiesce(
 256         cpu_id_t target);
 257
 258 extern void pe_init_debug(void);
 259
 260
 261 __END_DECLS
 262
 263 #endif /* _PEXPERT_PEXPERT_H_ */