1 /* 2 * cpuidle.h - a generic framework for CPU idle power management 3 * 4 * (C) 2007 Venkatesh Pallipadi <[email protected]> 5 * Shaohua Li <[email protected]> 6 * Adam Belay <[email protected]> 7 * 8 * This code is licenced under the GPL. 9 */ 10 11 #ifndef _LINUX_CPUIDLE_H 12 #define _LINUX_CPUIDLE_H 13 14 #include <linux/percpu.h> 15 #include <linux/list.h> 16 #include <linux/kobject.h> 17 #include <linux/completion.h> 18 #include <linux/hrtimer.h> 19 20 #define CPUIDLE_STATE_MAX 8 21 #define CPUIDLE_NAME_LEN 16 22 #define CPUIDLE_DESC_LEN 32 23 24 struct module; 25 26 struct cpuidle_device; 27 struct cpuidle_driver; 28 29 30 /**************************** 31 * CPUIDLE DEVICE INTERFACE * 32 ****************************/ 33 34 struct cpuidle_state_usage { 35 unsigned long long disable; 36 unsigned long long usage; 37 unsigned long long time; /* in US */ 38 }; 39 40 struct cpuidle_state { 41 char name[CPUIDLE_NAME_LEN]; 42 char desc[CPUIDLE_DESC_LEN]; 43 44 unsigned int flags; 45 unsigned int exit_latency; /* in US */ 46 int power_usage; /* in mW */ 47 unsigned int target_residency; /* in US */ 48 bool disabled; /* disabled on all CPUs */ 49 50 int (*enter) (struct cpuidle_device *dev, 51 struct cpuidle_driver *drv, 52 int index); 53 54 int (*enter_dead) (struct cpuidle_device *dev, int index); 55 }; 56 57 /* Idle State Flags */ 58 #define CPUIDLE_FLAG_TIME_VALID (0x01) /* is residency time measurable? */ 59 #define CPUIDLE_FLAG_COUPLED (0x02) /* state applies to multiple cpus */ 60 #define CPUIDLE_FLAG_TIMER_STOP (0x04) /* timer is stopped on this state */ 61 62 #define CPUIDLE_DRIVER_FLAGS_MASK (0xFFFF0000) 63 64 struct cpuidle_device { 65 unsigned int registered:1; 66 unsigned int enabled:1; 67 unsigned int cpu; 68 69 int last_residency; 70 int state_count; 71 struct cpuidle_state_usage states_usage[CPUIDLE_STATE_MAX]; 72 struct cpuidle_state_kobj *kobjs[CPUIDLE_STATE_MAX]; 73 struct cpuidle_driver_kobj *kobj_driver; 74 struct list_head device_list; 75 struct kobject kobj; 76 struct completion kobj_unregister; 77 78 #ifdef CONFIG_ARCH_NEEDS_CPU_IDLE_COUPLED 79 int safe_state_index; 80 cpumask_t coupled_cpus; 81 struct cpuidle_coupled *coupled; 82 #endif 83 }; 84 85 DECLARE_PER_CPU(struct cpuidle_device *, cpuidle_devices); 86 87 /** 88 * cpuidle_get_last_residency - retrieves the last state's residency time 89 * @dev: the target CPU 90 * 91 * NOTE: this value is invalid if CPUIDLE_FLAG_TIME_VALID isn't set 92 */ 93 static inline int cpuidle_get_last_residency(struct cpuidle_device *dev) 94 { 95 return dev->last_residency; 96 } 97 98 99 /**************************** 100 * CPUIDLE DRIVER INTERFACE * 101 ****************************/ 102 103 struct cpuidle_driver { 104 const char *name; 105 struct module *owner; 106 int refcnt; 107 108 /* set to 1 to use the core cpuidle time keeping (for all states). */ 109 unsigned int en_core_tk_irqen:1; 110 /* used by the cpuidle framework to setup the broadcast timer */ 111 unsigned int bctimer:1; 112 /* states array must be ordered in decreasing power consumption */ 113 struct cpuidle_state states[CPUIDLE_STATE_MAX]; 114 int state_count; 115 int safe_state_index; 116 }; 117 118 #ifdef CONFIG_CPU_IDLE 119 extern void disable_cpuidle(void); 120 extern int cpuidle_idle_call(void); 121 extern int cpuidle_register_driver(struct cpuidle_driver *drv); 122 extern struct cpuidle_driver *cpuidle_get_driver(void); 123 extern struct cpuidle_driver *cpuidle_driver_ref(void); 124 extern void cpuidle_driver_unref(void); 125 extern void cpuidle_unregister_driver(struct cpuidle_driver *drv); 126 extern int cpuidle_register_device(struct cpuidle_device *dev); 127 extern void cpuidle_unregister_device(struct cpuidle_device *dev); 128 129 extern void cpuidle_pause_and_lock(void); 130 extern void cpuidle_resume_and_unlock(void); 131 extern void cpuidle_pause(void); 132 extern void cpuidle_resume(void); 133 extern int cpuidle_enable_device(struct cpuidle_device *dev); 134 extern void cpuidle_disable_device(struct cpuidle_device *dev); 135 extern int cpuidle_wrap_enter(struct cpuidle_device *dev, 136 struct cpuidle_driver *drv, int index, 137 int (*enter)(struct cpuidle_device *dev, 138 struct cpuidle_driver *drv, int index)); 139 extern int cpuidle_play_dead(void); 140 141 extern struct cpuidle_driver *cpuidle_get_cpu_driver(struct cpuidle_device *dev); 142 extern int cpuidle_register_cpu_driver(struct cpuidle_driver *drv, int cpu); 143 extern void cpuidle_unregister_cpu_driver(struct cpuidle_driver *drv, int cpu); 144 145 #else 146 static inline void disable_cpuidle(void) { } 147 static inline int cpuidle_idle_call(void) { return -ENODEV; } 148 static inline int cpuidle_register_driver(struct cpuidle_driver *drv) 149 {return -ENODEV; } 150 static inline struct cpuidle_driver *cpuidle_get_driver(void) {return NULL; } 151 static inline struct cpuidle_driver *cpuidle_driver_ref(void) {return NULL; } 152 static inline void cpuidle_driver_unref(void) {} 153 static inline void cpuidle_unregister_driver(struct cpuidle_driver *drv) { } 154 static inline int cpuidle_register_device(struct cpuidle_device *dev) 155 {return -ENODEV; } 156 static inline void cpuidle_unregister_device(struct cpuidle_device *dev) { } 157 158 static inline void cpuidle_pause_and_lock(void) { } 159 static inline void cpuidle_resume_and_unlock(void) { } 160 static inline void cpuidle_pause(void) { } 161 static inline void cpuidle_resume(void) { } 162 static inline int cpuidle_enable_device(struct cpuidle_device *dev) 163 {return -ENODEV; } 164 static inline void cpuidle_disable_device(struct cpuidle_device *dev) { } 165 static inline int cpuidle_wrap_enter(struct cpuidle_device *dev, 166 struct cpuidle_driver *drv, int index, 167 int (*enter)(struct cpuidle_device *dev, 168 struct cpuidle_driver *drv, int index)) 169 { return -ENODEV; } 170 static inline int cpuidle_play_dead(void) {return -ENODEV; } 171 #endif 172 173 #ifdef CONFIG_ARCH_NEEDS_CPU_IDLE_COUPLED 174 void cpuidle_coupled_parallel_barrier(struct cpuidle_device *dev, atomic_t *a); 175 #else 176 static inline void cpuidle_coupled_parallel_barrier(struct cpuidle_device *dev, atomic_t *a) 177 { 178 } 179 #endif 180 181 /****************************** 182 * CPUIDLE GOVERNOR INTERFACE * 183 ******************************/ 184 185 struct cpuidle_governor { 186 char name[CPUIDLE_NAME_LEN]; 187 struct list_head governor_list; 188 unsigned int rating; 189 190 int (*enable) (struct cpuidle_driver *drv, 191 struct cpuidle_device *dev); 192 void (*disable) (struct cpuidle_driver *drv, 193 struct cpuidle_device *dev); 194 195 int (*select) (struct cpuidle_driver *drv, 196 struct cpuidle_device *dev); 197 void (*reflect) (struct cpuidle_device *dev, int index); 198 199 struct module *owner; 200 }; 201 202 #ifdef CONFIG_CPU_IDLE 203 204 extern int cpuidle_register_governor(struct cpuidle_governor *gov); 205 extern void cpuidle_unregister_governor(struct cpuidle_governor *gov); 206 207 #else 208 209 static inline int cpuidle_register_governor(struct cpuidle_governor *gov) 210 {return 0;} 211 static inline void cpuidle_unregister_governor(struct cpuidle_governor *gov) { } 212 213 #endif 214 215 #ifdef CONFIG_ARCH_HAS_CPU_RELAX 216 #define CPUIDLE_DRIVER_STATE_START 1 217 #else 218 #define CPUIDLE_DRIVER_STATE_START 0 219 #endif 220 221 #endif /* _LINUX_CPUIDLE_H */ 222