~ubuntu-branches/ubuntu/precise/linux-lts-saucy/precise-proposed

« back to all changes in this revision

Viewing changes to Documentation/cpuidle/driver.txt

  • Committer: Package Import Robot
  • Author(s): Tim Gardner
  • Date: 2013-10-09 13:31:18 UTC
  • Revision ID: package-import@ubuntu.com-20131009133118-l5q5o2hmtz96hefq
Tags: upstream-3.11.0
ImportĀ upstreamĀ versionĀ 3.11.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
 
 
2
 
 
3
                Supporting multiple CPU idle levels in kernel
 
4
 
 
5
                                cpuidle drivers
 
6
 
 
7
 
 
8
 
 
9
 
 
10
cpuidle driver hooks into the cpuidle infrastructure and handles the
 
11
architecture/platform dependent part of CPU idle states. Driver
 
12
provides the platform idle state detection capability and also
 
13
has mechanisms in place to support actual entry-exit into CPU idle states.
 
14
 
 
15
cpuidle driver initializes the cpuidle_device structure for each CPU device
 
16
and registers with cpuidle using cpuidle_register_device.
 
17
 
 
18
If all the idle states are the same, the wrapper function cpuidle_register
 
19
could be used instead.
 
20
 
 
21
It can also support the dynamic changes (like battery <-> AC), by using
 
22
cpuidle_pause_and_lock, cpuidle_disable_device and cpuidle_enable_device,
 
23
cpuidle_resume_and_unlock.
 
24
 
 
25
Interfaces:
 
26
extern int cpuidle_register(struct cpuidle_driver *drv,
 
27
                            const struct cpumask *const coupled_cpus);
 
28
extern int cpuidle_unregister(struct cpuidle_driver *drv);
 
29
extern int cpuidle_register_driver(struct cpuidle_driver *drv);
 
30
extern void cpuidle_unregister_driver(struct cpuidle_driver *drv);
 
31
extern int cpuidle_register_device(struct cpuidle_device *dev);
 
32
extern void cpuidle_unregister_device(struct cpuidle_device *dev);
 
33
 
 
34
extern void cpuidle_pause_and_lock(void);
 
35
extern void cpuidle_resume_and_unlock(void);
 
36
extern int cpuidle_enable_device(struct cpuidle_device *dev);
 
37
extern void cpuidle_disable_device(struct cpuidle_device *dev);