X-Git-Url: https://git.saurik.com/apple/xnu.git/blobdiff_plain/89b3af67bb32e691275bf6fa803d1834b2284115..d9a64523371fa019c4575bb400cbbc3a50ac9903:/osfmk/i386/pmCPU.h diff --git a/osfmk/i386/pmCPU.h b/osfmk/i386/pmCPU.h index 6fa8c3016..1ed973e4c 100644 --- a/osfmk/i386/pmCPU.h +++ b/osfmk/i386/pmCPU.h @@ -1,5 +1,5 @@ /* - * Copyright (c) 2006 Apple Computer, Inc. All rights reserved. + * Copyright (c) 2006-2010 Apple Inc. All rights reserved. * * @APPLE_OSREFERENCE_LICENSE_HEADER_START@ * @@ -29,119 +29,155 @@ #ifndef _I386_PMCPU_H_ #define _I386_PMCPU_H_ -#include +#include #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 { - Cstate_number_t number; - uint32_t hint; -} Cstate_hint_t; - - -struct pmData { - uint8_t pad[93]; -}; -typedef struct pmData pmData_t; - -#define pmNapHalt 0x00000010 -#define pmNapC1 0x00000008 -#define pmNapC2 0x00000004 -#define pmNapC3 0x00000002 -#define pmNapC4 0x00000001 -#define pmNapMask 0x000000FF - -#define cfgAdr 0xCF8 -#define cfgDat 0xCFC -#define lpcCfg (0x80000000 | (0 << 16) | (31 << 11) | (0 << 8)) +/* + * This value should be changed each time that pmDispatch_t or pmCallBacks_t + * changes. + */ +#define PM_DISPATCH_VERSION 102 /* * Dispatch table for functions that get installed when the power * management KEXT loads. + * + * pmDispatch_t is the set of functions that the kernel can use to call + * into the power management KEXT. + * + * pmCallBacks_t is the set of functions that the power management kext + * can call to get at specific kernel functions. */ typedef struct { - /* - * 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); - kern_return_t (*pmsCPUSetPStateLimit)(uint32_t limit); - - /* - * The following are the 'C' State interfaces. - */ - void (*cstateInit)(void); - void (*cstateMachineIdle)(uint32_t napCtl); - kern_return_t (*cstateTableSet)(Cstate_hint_t *tablep, unsigned int nstates); - uint32_t (*cstateNapPolicy)(uint32_t forcenap, uint32_t napCtl); + kern_return_t (*pmCPUStateInit)(void); + void (*cstateInit)(void); + uint64_t (*MachineIdle)(uint64_t maxIdleDuration); + 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); + int (*pmCPUControl)(uint32_t cmd, void *datap); + void (*pmCPUHalt)(void); + uint64_t (*getMaxSnoop)(void); + void (*setMaxBusDelay)(uint64_t time); + uint64_t (*getMaxBusDelay)(void); + void (*setMaxIntDelay)(uint64_t time); + uint64_t (*getMaxIntDelay)(void); + void (*pmCPUSafeMode)(x86_lcpu_t *lcpu, uint32_t flags); + void (*pmTimerStateSave)(void); + void (*pmTimerStateRestore)(void); + kern_return_t (*exitHalt)(x86_lcpu_t *lcpu); + kern_return_t (*exitHaltToOff)(x86_lcpu_t *lcpu); + void (*markAllCPUsOff)(void); + void (*pmSetRunCount)(uint32_t count); + boolean_t (*pmIsCPUUnAvailable)(x86_lcpu_t *lcpu); + int (*pmChooseCPU)(int startCPU, int endCPU, int preferredCPU); + int (*pmIPIHandler)(void *state); + void (*pmThreadTellUrgency)(int urgency, uint64_t rt_period, uint64_t rt_deadline); + void (*pmActiveRTThreads)(boolean_t active); + boolean_t (*pmInterruptPrewakeApplicable)(void); } pmDispatch_t; -typedef struct { - uint32_t PState; - uint32_t PLimit; - uint16_t VIDTable[MAX_PSTATES]; - uint32_t VIDTableCount; - Cstate_hint_t CStates[Cnmax]; - uint32_t CStatesCount; -} pmInitState_t; +/* common time fields exported to PM code. This structure may be + * allocated on the stack, so avoid making it unnecessarily large. + */ +typedef struct pm_rtc_nanotime { + uint64_t tsc_base; /* timestamp */ + uint64_t ns_base; /* nanoseconds */ + uint32_t scale; /* tsc -> nanosec multiplier */ + uint32_t shift; /* tsc -> nanosec shift/div */ + uint32_t generation; /* 0 == being updated */ +} pm_rtc_nanotime_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); - pmInitState_t *InitState; - void (*resetPop)(void); + uint64_t (*setRTCPop)(uint64_t time); + void (*resyncDeadlines)(int cpu); + void (*initComplete)(void); + x86_lcpu_t *(*GetLCPU)(int cpu); + x86_core_t *(*GetCore)(int cpu); + x86_die_t *(*GetDie)(int cpu); + x86_pkg_t *(*GetPackage)(int cpu); + x86_lcpu_t *(*GetMyLCPU)(void); + x86_core_t *(*GetMyCore)(void); + x86_die_t *(*GetMyDie)(void); + x86_pkg_t *(*GetMyPackage)(void); + x86_pkg_t *(*GetPkgRoot)(void); + void (*LockCPUTopology)(int lock); + boolean_t (*GetHibernate)(int cpu); + processor_t (*LCPUtoProcessor)(int lcpu); + processor_t (*ThreadBind)(processor_t proc); + uint32_t (*GetSavedRunCount)(void); + void (*pmSendIPI)(int cpu); + void (*GetNanotimeInfo)(pm_rtc_nanotime_t *); + int (*ThreadGetUrgency)(uint64_t *rt_period, uint64_t *rt_deadline); + uint32_t (*timerQueueMigrate)(int cpu); + void (*RTCClockAdjust)(uint64_t adjustment); + x86_topology_parameters_t *topoParms; + boolean_t (*InterruptPending)(void); + boolean_t (*IsInterrupting)(uint8_t vector); + void (*InterruptStats)(uint64_t intrs[256]); + void (*DisableApicTimer)(void); } 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 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 pmMarkAllCPUsOff(void); +int pmCPUControl(uint32_t cmd, void *datap); +void pmCPUHalt(uint32_t reason); +void pmTimerSave(void); +void pmTimerRestore(void); +kern_return_t pmCPUExitHalt(int cpu); +kern_return_t pmCPUExitHaltToOff(int cpu); +uint32_t pmTimerQueueMigrate(int); + +#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 */ +#define PM_HALT_SLEEP 3 /* sleep 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; +/* Default urgency timing threshold for the DEBUG build */ +#define URGENCY_NOTIFICATION_ASSERT_NS (5 * 1000 * 1000) +extern uint64_t urgency_notification_assert_abstime_threshold; + +x86_lcpu_t * +pmGetLogicalCPU(int cpu); +x86_lcpu_t * +pmGetMyLogicalCPU(void); +processor_t +pmLCPUtoProcessor(int lcpu); +x86_pkg_t * +pmGetPkgRoot(void); + + +/****************************************************************************** + * + * All of the following are deprecated interfaces and no longer used. + * + ******************************************************************************/ + #endif /* ASSEMBLER */ + #endif /* _I386_PMCPU_H_ */ #endif /* KERNEL_PRIVATE */