osfmk/i386/pmCPU.h

   1 /*
   2  * Copyright (c) 2006-2010 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 #ifdef KERNEL_PRIVATE
  29 #ifndef _I386_PMCPU_H_
  30 #define _I386_PMCPU_H_
  31
  32 #include <i386/cpu_topology.h>
  33
  34 #ifndef ASSEMBLER
  35
  36 /*
  37  * This value should be changed each time that pmDispatch_t or pmCallBacks_t
  38  * changes.
  39  */
  40 #define PM_DISPATCH_VERSION     102
  41
  42 /*
  43  * Dispatch table for functions that get installed when the power
  44  * management KEXT loads.
  45  *
  46  * pmDispatch_t is the set of functions that the kernel can use to call
  47  * into the power management KEXT.
  48  *
  49  * pmCallBacks_t is the set of functions that the power management kext
  50  * can call to get at specific kernel functions.
  51  */
  52 typedef struct{
  53         kern_return_t       (*pmCPUStateInit)(void);
  54         void                (*cstateInit)(void);
  55         uint64_t            (*MachineIdle)(uint64_t maxIdleDuration);
  56         uint64_t            (*GetDeadline)(x86_lcpu_t *lcpu);
  57         uint64_t            (*SetDeadline)(x86_lcpu_t *lcpu, uint64_t);
  58         void                (*Deadline)(x86_lcpu_t *lcpu);
  59         boolean_t           (*exitIdle)(x86_lcpu_t *lcpu);
  60         void                (*markCPURunning)(x86_lcpu_t *lcpu);
  61         int                 (*pmCPUControl)(uint32_t cmd, void *datap);
  62         void                (*pmCPUHalt)(void);
  63         uint64_t            (*getMaxSnoop)(void);
  64         void                (*setMaxBusDelay)(uint64_t time);
  65         uint64_t            (*getMaxBusDelay)(void);
  66         void                (*setMaxIntDelay)(uint64_t time);
  67         uint64_t            (*getMaxIntDelay)(void);
  68         void                (*pmCPUSafeMode)(x86_lcpu_t *lcpu, uint32_t flags);
  69         void                (*pmTimerStateSave)(void);
  70         void                (*pmTimerStateRestore)(void);
  71         kern_return_t       (*exitHalt)(x86_lcpu_t *lcpu);
  72         kern_return_t       (*exitHaltToOff)(x86_lcpu_t *lcpu);
  73         void                (*markAllCPUsOff)(void);
  74         void                (*pmSetRunCount)(uint32_t count);
  75         boolean_t           (*pmIsCPUUnAvailable)(x86_lcpu_t *lcpu);
  76         int                 (*pmChooseCPU)(int startCPU, int endCPU, int preferredCPU);
  77         int                 (*pmIPIHandler)(void *state);
  78         void                (*pmThreadTellUrgency)(int urgency, uint64_t rt_period, uint64_t rt_deadline);
  79         void                (*pmActiveRTThreads)(boolean_t active);
  80         boolean_t           (*pmInterruptPrewakeApplicable)(void);
  81         void                (*pmThreadGoingOffCore)(thread_t old_thread, boolean_t transfer_load,
  82             uint64_t last_dispatch, boolean_t thread_runnable);
  83 } pmDispatch_t;
  84
  85 /* common time fields exported to PM code. This structure may be
  86  * allocated on the stack, so avoid making it unnecessarily large.
  87  */
  88 typedef struct pm_rtc_nanotime {
  89         uint64_t        tsc_base;               /* timestamp */
  90         uint64_t        ns_base;                /* nanoseconds */
  91         uint32_t        scale;                  /* tsc -> nanosec multiplier */
  92         uint32_t        shift;                  /* tsc -> nanosec shift/div */
  93         uint32_t        generation;             /* 0 == being updated */
  94 } pm_rtc_nanotime_t;
  95
  96 typedef struct {
  97         uint64_t            (*setRTCPop)(uint64_t time);
  98         void                (*resyncDeadlines)(int cpu);
  99         void                (*initComplete)(void);
 100         x86_lcpu_t          *(*GetLCPU)(int cpu);
 101         x86_core_t          *(*GetCore)(int cpu);
 102         x86_die_t           *(*GetDie)(int cpu);
 103         x86_pkg_t           *(*GetPackage)(int cpu);
 104         x86_lcpu_t          *(*GetMyLCPU)(void);
 105         x86_core_t          *(*GetMyCore)(void);
 106         x86_die_t           *(*GetMyDie)(void);
 107         x86_pkg_t           *(*GetMyPackage)(void);
 108         x86_pkg_t           *(*GetPkgRoot)(void);
 109         void                (*LockCPUTopology)(int lock);
 110         boolean_t           (*GetHibernate)(int cpu);
 111         processor_t         (*LCPUtoProcessor)(int lcpu);
 112         processor_t         (*ThreadBind)(processor_t proc);
 113         uint32_t            (*GetSavedRunCount)(void);
 114         void                (*pmSendIPI)(int cpu);
 115         void                (*GetNanotimeInfo)(pm_rtc_nanotime_t *);
 116         int                 (*ThreadGetUrgency)(uint64_t *rt_period, uint64_t *rt_deadline);
 117         uint32_t            (*timerQueueMigrate)(int cpu);
 118         void                (*RTCClockAdjust)(uint64_t adjustment);
 119         x86_topology_parameters_t   *topoParms;
 120         boolean_t           (*InterruptPending)(void);
 121         boolean_t           (*IsInterrupting)(uint8_t vector);
 122         void                (*InterruptStats)(uint64_t intrs[256]);
 123         void                (*DisableApicTimer)(void);
 124 } pmCallBacks_t;
 125
 126 extern pmDispatch_t     *pmDispatch;
 127
 128 void power_management_init(void);
 129 void pmKextRegister(uint32_t version, pmDispatch_t *cpuFuncs,
 130     pmCallBacks_t *callbacks);
 131 void pmUnRegister(pmDispatch_t *cpuFuncs);
 132 void pmCPUStateInit(void);
 133 uint64_t pmCPUGetDeadline(struct cpu_data *cpu);
 134 uint64_t pmCPUSetDeadline(struct cpu_data *cpu, uint64_t deadline);
 135 void pmCPUDeadline(struct cpu_data *cpu);
 136 boolean_t pmCPUExitIdle(struct cpu_data *cpu);
 137 void pmCPUMarkRunning(struct cpu_data *cpu);
 138 void pmMarkAllCPUsOff(void);
 139 int pmCPUControl(uint32_t cmd, void *datap);
 140 void pmCPUHalt(uint32_t reason);
 141 void pmTimerSave(void);
 142 void pmTimerRestore(void);
 143 kern_return_t pmCPUExitHalt(int cpu);
 144 kern_return_t pmCPUExitHaltToOff(int cpu);
 145 uint32_t pmTimerQueueMigrate(int);
 146
 147 #define PM_HALT_NORMAL          0               /* normal halt path */
 148 #define PM_HALT_DEBUG           1               /* debug code wants to halt */
 149 #define PM_HALT_PANIC           2               /* panic code wants to halt */
 150 #define PM_HALT_SLEEP           3               /* sleep code wants to halt */
 151
 152 void pmSafeMode(x86_lcpu_t *lcpu, uint32_t flags);
 153
 154 #define PM_SAFE_FL_NORMAL       0x00000001      /* put CPU into "normal" power mode */
 155 #define PM_SAFE_FL_SAFE         0x00000002      /* put CPU into a "safe" power mode */
 156 #define PM_SAFE_FL_PAUSE        0x00000010      /* pause execution on the CPU */
 157 #define PM_SAFE_FL_RESUME       0x00000020      /* resume execution on the CPU */
 158
 159 extern int pmsafe_debug;
 160 /* Default urgency timing threshold for the DEBUG build */
 161 #define         URGENCY_NOTIFICATION_ASSERT_NS (5 * 1000 * 1000)
 162 extern uint64_t urgency_notification_assert_abstime_threshold;
 163
 164 x86_lcpu_t *
 165 pmGetLogicalCPU(int cpu);
 166 x86_lcpu_t *
 167 pmGetMyLogicalCPU(void);
 168 processor_t
 169 pmLCPUtoProcessor(int lcpu);
 170 x86_pkg_t *
 171 pmGetPkgRoot(void);
 172
 173
 174 /******************************************************************************
 175 *
 176 * All of the following are deprecated interfaces and no longer used.
 177 *
 178 ******************************************************************************/
 179
 180
 181 #endif /* ASSEMBLER */
 182
 183 #endif /* _I386_PMCPU_H_ */
 184 #endif /* KERNEL_PRIVATE */