2 * bios-less APM driver for ARM Linux
3 * Jamey Hicks <jamey@crl.dec.com>
4 * adapted from the APM BIOS driver for Linux by Stephen Rothwell (sfr@linuxcare.com)
7 * Intel Corporation, Microsoft Corporation. Advanced Power Management
8 * (APM) BIOS Interface Specification, Revision 1.2, February 1996.
10 * [This document is available from Microsoft at:
11 * http://www.microsoft.com/hwdev/busbios/amp_12.htm]
13 #include <linux/module.h>
14 #include <linux/poll.h>
15 #include <linux/slab.h>
16 #include <linux/proc_fs.h>
17 #include <linux/miscdevice.h>
18 #include <linux/apm_bios.h>
19 #include <linux/capability.h>
20 #include <linux/sched.h>
22 #include <linux/apm-emulation.h>
23 #include <linux/device.h>
24 #include <linux/kernel.h>
25 #include <linux/list.h>
26 #include <linux/init.h>
27 #include <linux/completion.h>
28 #include <linux/kthread.h>
29 #include <linux/delay.h>
31 #include <asm/system.h>
34 * The apm_bios device is one of the misc char devices.
35 * This is its minor number.
37 #define APM_MINOR_DEV 134
40 * See Documentation/Config.help for the configuration options.
42 * Various options can be changed at boot time as follows:
43 * (We allow underscores for compatibility with the modules code)
44 * apm=on/off enable/disable APM
48 * Maximum number of events stored
50 #define APM_MAX_EVENTS 16
53 unsigned int event_head
;
54 unsigned int event_tail
;
55 apm_event_t events
[APM_MAX_EVENTS
];
59 * The per-file APM data
62 struct list_head list
;
64 unsigned int suser
: 1;
65 unsigned int writer
: 1;
66 unsigned int reader
: 1;
69 unsigned int suspend_state
;
70 #define SUSPEND_NONE 0 /* no suspend pending */
71 #define SUSPEND_PENDING 1 /* suspend pending read */
72 #define SUSPEND_READ 2 /* suspend read, pending ack */
73 #define SUSPEND_ACKED 3 /* suspend acked */
74 #define SUSPEND_WAIT 4 /* waiting for suspend */
75 #define SUSPEND_DONE 5 /* suspend completed */
77 struct apm_queue queue
;
83 static int suspends_pending
;
84 static int apm_disabled
;
85 static struct task_struct
*kapmd_tsk
;
87 static DECLARE_WAIT_QUEUE_HEAD(apm_waitqueue
);
88 static DECLARE_WAIT_QUEUE_HEAD(apm_suspend_waitqueue
);
91 * This is a list of everyone who has opened /dev/apm_bios
93 static DECLARE_RWSEM(user_list_lock
);
94 static LIST_HEAD(apm_user_list
);
97 * kapmd info. kapmd provides us a process context to handle
98 * "APM" events within - specifically necessary if we're going
99 * to be suspending the system.
101 static DECLARE_WAIT_QUEUE_HEAD(kapmd_wait
);
102 static DEFINE_SPINLOCK(kapmd_queue_lock
);
103 static struct apm_queue kapmd_queue
;
105 static DEFINE_MUTEX(state_lock
);
107 static const char driver_version
[] = "1.13"; /* no spaces */
112 * Compatibility cruft until the IPAQ people move over to the new
115 static void __apm_get_power_status(struct apm_power_info
*info
)
120 * This allows machines to provide their own "apm get power status" function.
122 void (*apm_get_power_status
)(struct apm_power_info
*) = __apm_get_power_status
;
123 EXPORT_SYMBOL(apm_get_power_status
);
127 * APM event queue management.
129 static inline int queue_empty(struct apm_queue
*q
)
131 return q
->event_head
== q
->event_tail
;
134 static inline apm_event_t
queue_get_event(struct apm_queue
*q
)
136 q
->event_tail
= (q
->event_tail
+ 1) % APM_MAX_EVENTS
;
137 return q
->events
[q
->event_tail
];
140 static void queue_add_event(struct apm_queue
*q
, apm_event_t event
)
142 q
->event_head
= (q
->event_head
+ 1) % APM_MAX_EVENTS
;
143 if (q
->event_head
== q
->event_tail
) {
147 printk(KERN_ERR
"apm: an event queue overflowed\n");
148 q
->event_tail
= (q
->event_tail
+ 1) % APM_MAX_EVENTS
;
150 q
->events
[q
->event_head
] = event
;
153 static void queue_event(apm_event_t event
)
157 down_read(&user_list_lock
);
158 list_for_each_entry(as
, &apm_user_list
, list
) {
160 queue_add_event(&as
->queue
, event
);
162 up_read(&user_list_lock
);
163 wake_up_interruptible(&apm_waitqueue
);
167 * queue_suspend_event - queue an APM suspend event.
169 * Check that we're in a state where we can suspend. If not,
170 * return -EBUSY. Otherwise, queue an event to all "writer"
171 * users. If there are no "writer" users, return '1' to
172 * indicate that we can immediately suspend.
174 static int queue_suspend_event(apm_event_t event
, struct apm_user
*sender
)
179 mutex_lock(&state_lock
);
180 down_read(&user_list_lock
);
183 * If a thread is still processing, we can't suspend, so reject
186 list_for_each_entry(as
, &apm_user_list
, list
) {
187 if (as
!= sender
&& as
->reader
&& as
->writer
&& as
->suser
&&
188 as
->suspend_state
!= SUSPEND_NONE
) {
194 list_for_each_entry(as
, &apm_user_list
, list
) {
195 if (as
!= sender
&& as
->reader
&& as
->writer
&& as
->suser
) {
196 as
->suspend_state
= SUSPEND_PENDING
;
198 queue_add_event(&as
->queue
, event
);
203 up_read(&user_list_lock
);
204 mutex_unlock(&state_lock
);
205 wake_up_interruptible(&apm_waitqueue
);
209 static void apm_suspend(void)
212 int err
= pm_suspend(PM_SUSPEND_MEM
);
215 * Anyone on the APM queues will think we're still suspended.
216 * Send a message so everyone knows we're now awake again.
218 queue_event(APM_NORMAL_RESUME
);
221 * Finally, wake up anyone who is sleeping on the suspend.
223 mutex_lock(&state_lock
);
224 down_read(&user_list_lock
);
225 list_for_each_entry(as
, &apm_user_list
, list
) {
226 if (as
->suspend_state
== SUSPEND_WAIT
||
227 as
->suspend_state
== SUSPEND_ACKED
) {
228 as
->suspend_result
= err
;
229 as
->suspend_state
= SUSPEND_DONE
;
232 up_read(&user_list_lock
);
233 mutex_unlock(&state_lock
);
235 wake_up(&apm_suspend_waitqueue
);
238 static ssize_t
apm_read(struct file
*fp
, char __user
*buf
, size_t count
, loff_t
*ppos
)
240 struct apm_user
*as
= fp
->private_data
;
242 int i
= count
, ret
= 0;
244 if (count
< sizeof(apm_event_t
))
247 if (queue_empty(&as
->queue
) && fp
->f_flags
& O_NONBLOCK
)
250 wait_event_interruptible(apm_waitqueue
, !queue_empty(&as
->queue
));
252 while ((i
>= sizeof(event
)) && !queue_empty(&as
->queue
)) {
253 event
= queue_get_event(&as
->queue
);
256 if (copy_to_user(buf
, &event
, sizeof(event
)))
259 mutex_lock(&state_lock
);
260 if (as
->suspend_state
== SUSPEND_PENDING
&&
261 (event
== APM_SYS_SUSPEND
|| event
== APM_USER_SUSPEND
))
262 as
->suspend_state
= SUSPEND_READ
;
263 mutex_unlock(&state_lock
);
265 buf
+= sizeof(event
);
275 static unsigned int apm_poll(struct file
*fp
, poll_table
* wait
)
277 struct apm_user
*as
= fp
->private_data
;
279 poll_wait(fp
, &apm_waitqueue
, wait
);
280 return queue_empty(&as
->queue
) ? 0 : POLLIN
| POLLRDNORM
;
284 * apm_ioctl - handle APM ioctl
287 * This IOCTL is overloaded, and performs two functions. It is used to:
288 * - initiate a suspend
289 * - acknowledge a suspend read from /dev/apm_bios.
290 * Only when everyone who has opened /dev/apm_bios with write permission
291 * has acknowledge does the actual suspend happen.
294 apm_ioctl(struct inode
* inode
, struct file
*filp
, u_int cmd
, u_long arg
)
296 struct apm_user
*as
= filp
->private_data
;
300 if (!as
->suser
|| !as
->writer
)
304 case APM_IOC_SUSPEND
:
305 mutex_lock(&state_lock
);
307 as
->suspend_result
= -EINTR
;
309 if (as
->suspend_state
== SUSPEND_READ
) {
313 * If we read a suspend command from /dev/apm_bios,
314 * then the corresponding APM_IOC_SUSPEND ioctl is
315 * interpreted as an acknowledge.
317 as
->suspend_state
= SUSPEND_ACKED
;
319 pending
= suspends_pending
== 0;
320 mutex_unlock(&state_lock
);
323 * If there are no further acknowledges required,
324 * suspend the system.
330 * Wait for the suspend/resume to complete. If there
331 * are pending acknowledges, we wait here for them.
333 * Note: we need to ensure that the PM subsystem does
334 * not kick us out of the wait when it suspends the
337 flags
= current
->flags
;
338 current
->flags
|= PF_NOFREEZE
;
340 wait_event(apm_suspend_waitqueue
,
341 as
->suspend_state
== SUSPEND_DONE
);
343 as
->suspend_state
= SUSPEND_WAIT
;
344 mutex_unlock(&state_lock
);
347 * Otherwise it is a request to suspend the system.
348 * Queue an event for all readers, and expect an
349 * acknowledge from all writers who haven't already
352 err
= queue_suspend_event(APM_USER_SUSPEND
, as
);
355 * Avoid taking the lock here - this
358 as
->suspend_state
= SUSPEND_NONE
;
366 * Wait for the suspend/resume to complete. If there
367 * are pending acknowledges, we wait here for them.
369 * Note: we need to ensure that the PM subsystem does
370 * not kick us out of the wait when it suspends the
373 flags
= current
->flags
;
374 current
->flags
|= PF_NOFREEZE
;
376 wait_event_interruptible(apm_suspend_waitqueue
,
377 as
->suspend_state
== SUSPEND_DONE
);
380 current
->flags
= flags
;
382 mutex_lock(&state_lock
);
383 err
= as
->suspend_result
;
384 as
->suspend_state
= SUSPEND_NONE
;
385 mutex_unlock(&state_lock
);
392 static int apm_release(struct inode
* inode
, struct file
* filp
)
394 struct apm_user
*as
= filp
->private_data
;
397 filp
->private_data
= NULL
;
399 down_write(&user_list_lock
);
401 up_write(&user_list_lock
);
404 * We are now unhooked from the chain. As far as new
405 * events are concerned, we no longer exist. However, we
406 * need to balance suspends_pending, which means the
407 * possibility of sleeping.
409 mutex_lock(&state_lock
);
410 if (as
->suspend_state
!= SUSPEND_NONE
) {
411 suspends_pending
-= 1;
412 pending
= suspends_pending
== 0;
414 mutex_unlock(&state_lock
);
422 static int apm_open(struct inode
* inode
, struct file
* filp
)
426 as
= kzalloc(sizeof(*as
), GFP_KERNEL
);
429 * XXX - this is a tiny bit broken, when we consider BSD
430 * process accounting. If the device is opened by root, we
431 * instantly flag that we used superuser privs. Who knows,
432 * we might close the device immediately without doing a
433 * privileged operation -- cevans
435 as
->suser
= capable(CAP_SYS_ADMIN
);
436 as
->writer
= (filp
->f_mode
& FMODE_WRITE
) == FMODE_WRITE
;
437 as
->reader
= (filp
->f_mode
& FMODE_READ
) == FMODE_READ
;
439 down_write(&user_list_lock
);
440 list_add(&as
->list
, &apm_user_list
);
441 up_write(&user_list_lock
);
443 filp
->private_data
= as
;
446 return as
? 0 : -ENOMEM
;
449 static struct file_operations apm_bios_fops
= {
450 .owner
= THIS_MODULE
,
455 .release
= apm_release
,
458 static struct miscdevice apm_device
= {
459 .minor
= APM_MINOR_DEV
,
461 .fops
= &apm_bios_fops
465 #ifdef CONFIG_PROC_FS
467 * Arguments, with symbols from linux/apm_bios.h.
469 * 0) Linux driver version (this will change if format changes)
470 * 1) APM BIOS Version. Usually 1.0, 1.1 or 1.2.
471 * 2) APM flags from APM Installation Check (0x00):
472 * bit 0: APM_16_BIT_SUPPORT
473 * bit 1: APM_32_BIT_SUPPORT
474 * bit 2: APM_IDLE_SLOWS_CLOCK
475 * bit 3: APM_BIOS_DISABLED
476 * bit 4: APM_BIOS_DISENGAGED
480 * 0x02: On backup power (BIOS >= 1.1 only)
487 * 0x04: Selected battery not present (BIOS >= 1.2 only)
494 * bit 7: No system battery
496 * 6) Remaining battery life (percentage of charge):
499 * 7) Remaining battery life (time units):
500 * Number of remaining minutes or seconds
502 * 8) min = minutes; sec = seconds
504 static int apm_get_info(char *buf
, char **start
, off_t fpos
, int length
)
506 struct apm_power_info info
;
510 info
.ac_line_status
= 0xff;
511 info
.battery_status
= 0xff;
512 info
.battery_flag
= 0xff;
513 info
.battery_life
= -1;
517 if (apm_get_power_status
)
518 apm_get_power_status(&info
);
520 switch (info
.units
) {
521 default: units
= "?"; break;
522 case 0: units
= "min"; break;
523 case 1: units
= "sec"; break;
526 ret
= sprintf(buf
, "%s 1.2 0x%02x 0x%02x 0x%02x 0x%02x %d%% %d %s\n",
527 driver_version
, APM_32_BIT_SUPPORT
,
528 info
.ac_line_status
, info
.battery_status
,
529 info
.battery_flag
, info
.battery_life
,
536 static int kapmd(void *arg
)
542 wait_event_interruptible(kapmd_wait
,
543 !queue_empty(&kapmd_queue
) || kthread_should_stop());
545 if (kthread_should_stop())
548 spin_lock_irq(&kapmd_queue_lock
);
550 if (!queue_empty(&kapmd_queue
))
551 event
= queue_get_event(&kapmd_queue
);
552 spin_unlock_irq(&kapmd_queue_lock
);
558 case APM_LOW_BATTERY
:
559 case APM_POWER_STATUS_CHANGE
:
563 case APM_USER_SUSPEND
:
564 case APM_SYS_SUSPEND
:
565 ret
= queue_suspend_event(event
, NULL
);
568 * We were busy. Try again in 50ms.
570 queue_add_event(&kapmd_queue
, event
);
577 case APM_CRITICAL_SUSPEND
:
586 static int __init
apm_init(void)
591 printk(KERN_NOTICE
"apm: disabled on user request.\n");
595 kapmd_tsk
= kthread_create(kapmd
, NULL
, "kapmd");
596 if (IS_ERR(kapmd_tsk
)) {
597 ret
= PTR_ERR(kapmd_tsk
);
601 kapmd_tsk
->flags
|= PF_NOFREEZE
;
602 wake_up_process(kapmd_tsk
);
604 #ifdef CONFIG_PROC_FS
605 create_proc_info_entry("apm", 0, NULL
, apm_get_info
);
608 ret
= misc_register(&apm_device
);
610 remove_proc_entry("apm", NULL
);
611 kthread_stop(kapmd_tsk
);
617 static void __exit
apm_exit(void)
619 misc_deregister(&apm_device
);
620 remove_proc_entry("apm", NULL
);
622 kthread_stop(kapmd_tsk
);
625 module_init(apm_init
);
626 module_exit(apm_exit
);
628 MODULE_AUTHOR("Stephen Rothwell");
629 MODULE_DESCRIPTION("Advanced Power Management");
630 MODULE_LICENSE("GPL");
633 static int __init
apm_setup(char *str
)
635 while ((str
!= NULL
) && (*str
!= '\0')) {
636 if (strncmp(str
, "off", 3) == 0)
638 if (strncmp(str
, "on", 2) == 0)
640 str
= strchr(str
, ',');
642 str
+= strspn(str
, ", \t");
647 __setup("apm=", apm_setup
);
651 * apm_queue_event - queue an APM event for kapmd
654 * Queue an APM event for kapmd to process and ultimately take the
655 * appropriate action. Only a subset of events are handled:
657 * %APM_POWER_STATUS_CHANGE
660 * %APM_CRITICAL_SUSPEND
662 void apm_queue_event(apm_event_t event
)
666 spin_lock_irqsave(&kapmd_queue_lock
, flags
);
667 queue_add_event(&kapmd_queue
, event
);
668 spin_unlock_irqrestore(&kapmd_queue_lock
, flags
);
670 wake_up_interruptible(&kapmd_wait
);
672 EXPORT_SYMBOL(apm_queue_event
);