Gitiles
Code Review Sign In
gerrit-public.fairphone.software / kernel / msm-4.19 / 9a47a8dccf8866b497bd80809da1c665e7b07c2c / . / include / linux / cpuidle.h
blob: 480c14dc1ddd5936d48820739ae6847c6e0c52bb [file] [log] [blame]
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]1/*
2 * cpuidle.h - a generic framework for CPU idle power management
3 *
4 * (C) 2007 Venkatesh Pallipadi <venkatesh.pallipadi@intel.com>
5 * Shaohua Li <shaohua.li@intel.com>
6 * Adam Belay <abelay@novell.com>
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>
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]16#include <linux/kobject.h>
17#include <linux/completion.h>
Robert Leee1689792012-03-20 15:22:42 -0500[diff] [blame]18#include <linux/hrtimer.h>
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]19
20#define CPUIDLE_STATE_MAX 8
21#define CPUIDLE_NAME_LEN 16
Venkatesh Pallipadi4fcb2fc2008-02-11 17:46:31 -0800[diff] [blame]22#define CPUIDLE_DESC_LEN 32
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]23
Paul Gortmakerde477252011-05-26 13:46:22 -0400[diff] [blame]24struct module;
25
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]26struct cpuidle_device;
Deepthi Dharwar46bcfad2011-10-28 16:20:42 +0530[diff] [blame]27struct cpuidle_driver;
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]28
29
30/****************************
31 * CPUIDLE DEVICE INTERFACE *
32 ****************************/
33
Deepthi Dharwar42027352011-10-28 16:20:33 +0530[diff] [blame]34struct cpuidle_state_usage {
ShuoX Liudc7fd272012-07-03 19:05:31 +0200[diff] [blame]35 unsigned long long disable;
Deepthi Dharwar42027352011-10-28 16:20:33 +0530[diff] [blame]36 unsigned long long usage;
37 unsigned long long time; /* in US */
38};
39
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]40struct cpuidle_state {
41 char name[CPUIDLE_NAME_LEN];
Venkatesh Pallipadi4fcb2fc2008-02-11 17:46:31 -0800[diff] [blame]42 char desc[CPUIDLE_DESC_LEN];
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]43
44 unsigned int flags;
45 unsigned int exit_latency; /* in US */
Boris Ostrovsky02401c02012-03-13 19:55:10 +0100[diff] [blame]46 int power_usage; /* in mW */
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]47 unsigned int target_residency; /* in US */
Rafael J. Wysockicbc9ef02012-07-03 19:07:42 +0200[diff] [blame]48 bool disabled; /* disabled on all CPUs */
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]49
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]50 int (*enter) (struct cpuidle_device *dev,
Deepthi Dharwar46bcfad2011-10-28 16:20:42 +0530[diff] [blame]51 struct cpuidle_driver *drv,
Deepthi Dharware978aa72011-10-28 16:20:09 +0530[diff] [blame]52 int index);
Boris Ostrovsky1a022e32012-03-13 19:55:09 +0100[diff] [blame]53
54 int (*enter_dead) (struct cpuidle_device *dev, int index);
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]55};
56
57/* Idle State Flags */
58#define CPUIDLE_FLAG_TIME_VALID (0x01) /* is residency time measurable? */
Colin Cross4126c012012-05-07 17:57:41 -0700[diff] [blame]59#define CPUIDLE_FLAG_COUPLED (0x02) /* state applies to multiple cpus */
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]60
61#define CPUIDLE_DRIVER_FLAGS_MASK (0xFFFF0000)
62
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]63struct cpuidle_device {
Venkatesh Pallipadidcb84f32008-05-19 19:09:27 -0400[diff] [blame]64 unsigned int registered:1;
Harvey Harrisonb5556a62008-02-06 22:39:44 +0100[diff] [blame]65 unsigned int enabled:1;
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]66 unsigned int cpu;
67
68 int last_residency;
69 int state_count;
Deepthi Dharwar42027352011-10-28 16:20:33 +0530[diff] [blame]70 struct cpuidle_state_usage states_usage[CPUIDLE_STATE_MAX];
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]71 struct cpuidle_state_kobj *kobjs[CPUIDLE_STATE_MAX];
Daniel Lezcanobf4d1b52012-10-31 16:44:48 +0000[diff] [blame]72 struct cpuidle_driver_kobj *kobj_driver;
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]73 struct list_head device_list;
74 struct kobject kobj;
75 struct completion kobj_unregister;
Colin Cross4126c012012-05-07 17:57:41 -0700[diff] [blame]76
77#ifdef CONFIG_ARCH_NEEDS_CPU_IDLE_COUPLED
78 int safe_state_index;
79 cpumask_t coupled_cpus;
80 struct cpuidle_coupled *coupled;
81#endif
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]82};
83
84DECLARE_PER_CPU(struct cpuidle_device *, cpuidle_devices);
85
86/**
87 * cpuidle_get_last_residency - retrieves the last state's residency time
88 * @dev: the target CPU
89 *
90 * NOTE: this value is invalid if CPUIDLE_FLAG_TIME_VALID isn't set
91 */
92static inline int cpuidle_get_last_residency(struct cpuidle_device *dev)
93{
94 return dev->last_residency;
95}
96
97
98/****************************
99 * CPUIDLE DRIVER INTERFACE *
100 ****************************/
101
102struct cpuidle_driver {
Daniel Lezcanodb70b042012-03-26 14:51:27 +0200[diff] [blame]103 const char *name;
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]104 struct module *owner;
Daniel Lezcano42f67f22012-10-31 16:44:45 +0000[diff] [blame]105 int refcnt;
Deepthi Dharwar46bcfad2011-10-28 16:20:42 +0530[diff] [blame]106
Robert Leee1689792012-03-20 15:22:42 -0500[diff] [blame]107 /* set to 1 to use the core cpuidle time keeping (for all states). */
108 unsigned int en_core_tk_irqen:1;
Daniel Lezcano8aef33a2013-01-15 14:18:04 +0100[diff] [blame]109 /* states array must be ordered in decreasing power consumption */
Deepthi Dharwar46bcfad2011-10-28 16:20:42 +0530[diff] [blame]110 struct cpuidle_state states[CPUIDLE_STATE_MAX];
111 int state_count;
112 int safe_state_index;
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]113};
114
115#ifdef CONFIG_CPU_IDLE
Len Brownd91ee582011-04-01 18:28:35 -0400[diff] [blame]116extern void disable_cpuidle(void);
Len Browna0bfa132011-04-01 19:34:59 -0400[diff] [blame]117extern int cpuidle_idle_call(void);
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]118extern int cpuidle_register_driver(struct cpuidle_driver *drv);
Rafael J. Wysocki6e797a02012-06-16 15:20:11 +0200[diff] [blame]119extern struct cpuidle_driver *cpuidle_get_driver(void);
120extern struct cpuidle_driver *cpuidle_driver_ref(void);
121extern void cpuidle_driver_unref(void);
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]122extern void cpuidle_unregister_driver(struct cpuidle_driver *drv);
123extern int cpuidle_register_device(struct cpuidle_device *dev);
124extern void cpuidle_unregister_device(struct cpuidle_device *dev);
125
126extern void cpuidle_pause_and_lock(void);
127extern void cpuidle_resume_and_unlock(void);
Preeti U Murthy8651f972012-07-09 10:12:56 +0200[diff] [blame]128extern void cpuidle_pause(void);
129extern void cpuidle_resume(void);
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]130extern int cpuidle_enable_device(struct cpuidle_device *dev);
131extern void cpuidle_disable_device(struct cpuidle_device *dev);
Robert Leee1689792012-03-20 15:22:42 -0500[diff] [blame]132extern int cpuidle_wrap_enter(struct cpuidle_device *dev,
133 struct cpuidle_driver *drv, int index,
134 int (*enter)(struct cpuidle_device *dev,
135 struct cpuidle_driver *drv, int index));
Boris Ostrovsky1a022e32012-03-13 19:55:09 +0100[diff] [blame]136extern int cpuidle_play_dead(void);
137
Daniel Lezcanobf4d1b52012-10-31 16:44:48 +0000[diff] [blame]138extern struct cpuidle_driver *cpuidle_get_cpu_driver(struct cpuidle_device *dev);
139extern int cpuidle_register_cpu_driver(struct cpuidle_driver *drv, int cpu);
140extern void cpuidle_unregister_cpu_driver(struct cpuidle_driver *drv, int cpu);
141
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]142#else
Len Brownd91ee582011-04-01 18:28:35 -0400[diff] [blame]143static inline void disable_cpuidle(void) { }
Len Browna0bfa132011-04-01 19:34:59 -0400[diff] [blame]144static inline int cpuidle_idle_call(void) { return -ENODEV; }
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]145static inline int cpuidle_register_driver(struct cpuidle_driver *drv)
Len Brown6b2c6762010-05-11 16:50:52 -0400[diff] [blame]146{return -ENODEV; }
Len Brown752138d2010-05-22 16:57:26 -0400[diff] [blame]147static inline struct cpuidle_driver *cpuidle_get_driver(void) {return NULL; }
Rafael J. Wysocki6e797a02012-06-16 15:20:11 +0200[diff] [blame]148static inline struct cpuidle_driver *cpuidle_driver_ref(void) {return NULL; }
149static inline void cpuidle_driver_unref(void) {}
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]150static inline void cpuidle_unregister_driver(struct cpuidle_driver *drv) { }
151static inline int cpuidle_register_device(struct cpuidle_device *dev)
Len Brown6b2c6762010-05-11 16:50:52 -0400[diff] [blame]152{return -ENODEV; }
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]153static inline void cpuidle_unregister_device(struct cpuidle_device *dev) { }
154
155static inline void cpuidle_pause_and_lock(void) { }
156static inline void cpuidle_resume_and_unlock(void) { }
Preeti U Murthy8651f972012-07-09 10:12:56 +0200[diff] [blame]157static inline void cpuidle_pause(void) { }
158static inline void cpuidle_resume(void) { }
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]159static inline int cpuidle_enable_device(struct cpuidle_device *dev)
Len Brown6b2c6762010-05-11 16:50:52 -0400[diff] [blame]160{return -ENODEV; }
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]161static inline void cpuidle_disable_device(struct cpuidle_device *dev) { }
Robert Leee1689792012-03-20 15:22:42 -0500[diff] [blame]162static inline int cpuidle_wrap_enter(struct cpuidle_device *dev,
163 struct cpuidle_driver *drv, int index,
164 int (*enter)(struct cpuidle_device *dev,
165 struct cpuidle_driver *drv, int index))
166{ return -ENODEV; }
Boris Ostrovsky1a022e32012-03-13 19:55:09 +0100[diff] [blame]167static inline int cpuidle_play_dead(void) {return -ENODEV; }
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]168#endif
169
Colin Cross20ff51a2012-05-07 17:57:42 -0700[diff] [blame]170#ifdef CONFIG_ARCH_NEEDS_CPU_IDLE_COUPLED
171void cpuidle_coupled_parallel_barrier(struct cpuidle_device *dev, atomic_t *a);
Arnd Bergmannc7a9b092012-08-15 20:51:54 +0000[diff] [blame]172#else
173static inline void cpuidle_coupled_parallel_barrier(struct cpuidle_device *dev, atomic_t *a)
174{
175}
Colin Cross20ff51a2012-05-07 17:57:42 -0700[diff] [blame]176#endif
177
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]178/******************************
179 * CPUIDLE GOVERNOR INTERFACE *
180 ******************************/
181
182struct cpuidle_governor {
183 char name[CPUIDLE_NAME_LEN];
184 struct list_head governor_list;
185 unsigned int rating;
186
Deepthi Dharwar46bcfad2011-10-28 16:20:42 +0530[diff] [blame]187 int (*enable) (struct cpuidle_driver *drv,
188 struct cpuidle_device *dev);
189 void (*disable) (struct cpuidle_driver *drv,
190 struct cpuidle_device *dev);
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]191
Deepthi Dharwar46bcfad2011-10-28 16:20:42 +0530[diff] [blame]192 int (*select) (struct cpuidle_driver *drv,
193 struct cpuidle_device *dev);
Deepthi Dharware978aa72011-10-28 16:20:09 +0530[diff] [blame]194 void (*reflect) (struct cpuidle_device *dev, int index);
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]195
196 struct module *owner;
197};
198
199#ifdef CONFIG_CPU_IDLE
200
201extern int cpuidle_register_governor(struct cpuidle_governor *gov);
202extern void cpuidle_unregister_governor(struct cpuidle_governor *gov);
203
204#else
205
206static inline int cpuidle_register_governor(struct cpuidle_governor *gov)
207{return 0;}
208static inline void cpuidle_unregister_governor(struct cpuidle_governor *gov) { }
209
210#endif
211
venkatesh.pallipadi@intel.com9a0b8412008-01-31 17:35:06 -0800[diff] [blame]212#ifdef CONFIG_ARCH_HAS_CPU_RELAX
213#define CPUIDLE_DRIVER_STATE_START 1
214#else
215#define CPUIDLE_DRIVER_STATE_START 0
216#endif
217
Len Brown4f86d3a2007-10-03 18:58:00 -0400[diff] [blame]218#endif /* _LINUX_CPUIDLE_H */