/*
- * Copyright (c) 2006 Apple Computer, Inc. All rights reserved.
+ * Copyright (c) 2006-2007 Apple Inc. All rights reserved.
*
- * @APPLE_LICENSE_HEADER_START@
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
*
- * The contents of this file constitute Original Code as defined in and
- * are subject to the Apple Public Source License Version 1.1 (the
- * "License"). You may not use this file except in compliance with the
- * License. Please obtain a copy of the License at
- * http://www.apple.com/publicsource and read it before using this file.
+ * This file contains Original Code and/or Modifications of Original Code
+ * as defined in and that are subject to the Apple Public Source License
+ * Version 2.0 (the 'License'). You may not use this file except in
+ * compliance with the License. The rights granted to you under the License
+ * may not be used to create, or enable the creation or redistribution of,
+ * unlawful or unlicensed copies of an Apple operating system, or to
+ * circumvent, violate, or enable the circumvention or violation of, any
+ * terms of an Apple operating system software license agreement.
*
- * This Original Code and all software distributed under the License are
- * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
+ * Please obtain a copy of the License at
+ * http://www.opensource.apple.com/apsl/ and read it before using this file.
+ *
+ * The Original Code and all software distributed under the License are
+ * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. Please see the
- * License for the specific language governing rights and limitations
- * under the License.
+ * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
+ * Please see the License for the specific language governing rights and
+ * limitations under the License.
*
- * @APPLE_LICENSE_HEADER_END@
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
*/
#ifdef KERNEL_PRIVATE
#ifndef _I386_PMCPU_H_
#define _I386_PMCPU_H_
#include <kern/pms.h>
+#include <i386/cpu_topology.h>
#ifndef ASSEMBLER
-typedef enum { C1, C2, C3, C4, Hlt, C3Res, All, Cnum } pm_Cstate_t;
-typedef struct pmStats {
- uint64_t pmNapCnt[Cnum]; /* Total nap calls for states */
- uint64_t pmNapTime[Cnum]; /* Total nap time for states */
- uint64_t pmNapC2HPET; /* Total nap time for C2 using HPET for stats */
- uint64_t pmNapC4HPET; /* Total nap time for C4 using HPET for stats */
- uint64_t pmNapHPETPops; /* Number of times we detect HPET popping */
- uint64_t pmHPETRupt; /* Number of HPET interruptions */
- uint32_t pmCurC3Res; /* Current value of the C3 residency timer */
- uint32_t pmLastApic; /* Last value of apic timer */
- uint32_t pmNewApic; /* New value of apic timer */
- uint64_t pmHpetTim; /* Time to next interrupt in HPET ticks */
- uint64_t pmHpetCmp; /* HPET comparator */
- uint64_t pmHpetCfg; /* HPET configuration */
- uint64_t pmLSNs; /* (TEST) Last set nanotime */
- uint64_t pmLLHpet; /* (TEST) Last loaded HPET */
-} pmStats_t;
-
#define MAX_PSTATES 32 /* architectural limit */
-typedef enum { Cn1, Cn2, Cn3, Cn4, Cnmax } Cstate_number_t;
-typedef struct {
+typedef enum
+{
+ Cn1, Cn2, Cn3, Cn4, Cn5, Cn6, CnHlt, Cn0, CnRun, Cnmax
+} Cstate_number_t;
+
+typedef struct
+{
Cstate_number_t number;
uint32_t hint;
} Cstate_hint_t;
#define cfgDat 0xCFC
#define lpcCfg (0x80000000 | (0 << 16) | (31 << 11) | (0 << 8))
+/*
+ * This value should be changed each time that pmDsipatch_t or pmCallBacks_t
+ * changes.
+ */
+#define PM_DISPATCH_VERSION 7
+
/*
* Dispatch table for functions that get installed when the power
* management KEXT loads.
/*
* The following are the stepper table interfaces.
*/
- void (*pmsCPUMachineInit)(void);
- void (*pmsCPUInit)(void);
- void (*pmsCPUSet)(uint32_t sel);
- void (*pmsCPUConf)(void);
- void (*pmsCPURun)(uint32_t nstep);
- uint32_t (*pmsCPUQuery)(void);
- uint32_t (*pmsCPUPackageQuery)(void);
- void (*pmsCPUYellowFlag)(void);
- void (*pmsCPUGreenFlag)(void);
- kern_return_t (*pmsCPULoadVIDTable)(uint16_t *tablep, int nstates);
+ int (*pmCPUStateInit)(void);
+ void (*pmsInit)(void);
+ void (*pmsStart)(void);
+ void (*pmsPark)(void);
kern_return_t (*pmsCPUSetPStateLimit)(uint32_t limit);
+ /*
+ * The following are legacy stepper interfaces.
+ */
+ void (*pmsRun)(uint32_t nstep);
+ kern_return_t (*pmsBuild)(pmsDef *pd, uint32_t pdsize, pmsSetFunc_t *functab, uint32_t platformData, pmsQueryFunc_t queryFunc);
+ kern_return_t (*pmsCPULoadVIDTable)(uint16_t *tablep, int nstates);
+
/*
* The following are the 'C' State interfaces.
*/
- void (*cstateInit)(void);
- void (*cstateMachineIdle)(uint32_t napCtl);
+ void (*cstateInit)(void);
+ uint64_t (*cstateMachineIdle)(uint64_t maxIdleDuration);
kern_return_t (*cstateTableSet)(Cstate_hint_t *tablep, unsigned int nstates);
- uint32_t (*cstateNapPolicy)(uint32_t forcenap, uint32_t napCtl);
+ uint64_t (*GetDeadline)(x86_lcpu_t *lcpu);
+ uint64_t (*SetDeadline)(x86_lcpu_t *lcpu, uint64_t);
+ void (*Deadline)(x86_lcpu_t *lcpu);
+ boolean_t (*exitIdle)(x86_lcpu_t *lcpu);
+ void (*markCPURunning)(x86_lcpu_t *lcpu);
+ void (*HPETInterrupt)(void);
+ int (*pmCPUControl)(uint32_t cmd, void *datap);
+ void (*pmCPUHalt)(void);
+ uint64_t (*getMaxSnoop)(void);
+ void (*setMaxBusDelay)(uint64_t time);
+ uint64_t (*getMaxBusDelay)(void);
+ void (*pmCPUSafeMode)(x86_lcpu_t *lcpu, uint32_t flags);
} pmDispatch_t;
typedef struct {
uint32_t VIDTableCount;
Cstate_hint_t CStates[Cnmax];
uint32_t CStatesCount;
+ uint64_t maxBusDelay;
} pmInitState_t;
typedef struct {
- void (*Park)(void);
- void (*Run)(uint32_t nstep);
- void (*RunLocal)(uint32_t nstep);
- void (*SetStep)(uint32_t nstep, int dir);
- void (*NapPolicy)(void);
- kern_return_t (*Build)(pmsDef *pd, uint32_t pdsize, pmsSetFunc_t *functab, uint32_t platformData, pmsQueryFunc_t queryFunc);
- pmStats_t *(*Stats)(void);
- pmsd *(*StepperData)(void);
- uint64_t *(*HPETAddr)(void);
+ uint64_t *(*HPETAddr)(void);
pmInitState_t *InitState;
- void (*resetPop)(void);
+ int (*setRTCPop)(uint64_t time);
+ void (*resyncDeadlines)(void);
+ void (*initComplete)(void);
+ x86_lcpu_t *(*GetLCPU)(int cpu);
+ x86_core_t *(*GetCore)(int cpu);
+ x86_pkg_t *(*GetPackage)(int cpu);
+ x86_lcpu_t *(*GetMyLCPU)(void);
+ x86_core_t *(*GetMyCore)(void);
+ x86_pkg_t *(*GetMyPackage)(void);
+ uint32_t CoresPerPkg;
+ x86_pkg_t *(*GetPkgRoot)(void);
+ void (*LockCPUTopology)(int lock);
+ boolean_t (*GetHibernate)(int cpu);
+ processor_t (*LCPUtoProcessor)(int lcpu);
} pmCallBacks_t;
extern pmDispatch_t *pmDispatch;
-extern uint32_t maxBusDelay;
-extern uint32_t C4C2SnoopDelay;
extern uint32_t forcenap;
void power_management_init(void);
void machine_nap_policy(void);
kern_return_t Cstate_table_set(Cstate_hint_t *tablep, unsigned int nstates);
-void machine_idle_cstate(void);
-void pmRegister(pmDispatch_t *cpuFuncs, pmCallBacks_t *callbacks);
+void machine_idle_cstate(boolean_t halted);
+void pmKextRegister(uint32_t version, pmDispatch_t *cpuFuncs,
+ pmCallBacks_t *callbacks);
void pmUnRegister(pmDispatch_t *cpuFuncs);
+void pmCPUStateInit(void);
+uint64_t pmCPUGetDeadline(struct cpu_data *cpu);
+uint64_t pmCPUSetDeadline(struct cpu_data *cpu, uint64_t deadline);
+void pmCPUDeadline(struct cpu_data *cpu);
+boolean_t pmCPUExitIdle(struct cpu_data *cpu);
+void pmCPUMarkRunning(struct cpu_data *cpu);
+void pmHPETInterrupt(void);
+int pmCPUControl(uint32_t cmd, void *datap);
+void pmCPUHalt(uint32_t reason);
+
+#define PM_HALT_NORMAL 0 /* normal halt path */
+#define PM_HALT_DEBUG 1 /* debug code wants to halt */
+#define PM_HALT_PANIC 2 /* panic code wants to halt */
+
+void pmSafeMode(x86_lcpu_t *lcpu, uint32_t flags);
+
+#define PM_SAFE_FL_NORMAL 0x00000001 /* put CPU into "normal" power mode */
+#define PM_SAFE_FL_SAFE 0x00000002 /* put CPU into a "safe" power mode */
+#define PM_SAFE_FL_PAUSE 0x00000010 /* pause execution on the CPU */
+#define PM_SAFE_FL_RESUME 0x00000020 /* resume execution on the CPU */
+
+extern int pmsafe_debug;
#endif /* ASSEMBLER */
+
#endif /* _I386_PMCPU_H_ */
#endif /* KERNEL_PRIVATE */