1 #ifndef _LINUX_APM_H
2 #define _LINUX_APM_H
3 
4 /*
5  * Include file for the interface to an APM BIOS
6  * Copyright 1994-2001 Stephen Rothwell (sfr@canb.auug.org.au)
7  *
8  * This program is free software; you can redistribute it and/or modify it
9  * under the terms of the GNU General Public License as published by the
10  * Free Software Foundation; either version 2, or (at your option) any
11  * later version.
12  *
13  * This program is distributed in the hope that it will be useful, but
14  * WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
16  * General Public License for more details.
17  */
18 
19 #include <linux/types.h>
20 
21 typedef unsigned short	apm_event_t;
22 typedef unsigned short	apm_eventinfo_t;
23 
24 struct apm_bios_info {
25 	__u16	version;
26 	__u16	cseg;
27 	__u32	offset;
28 	__u16	cseg_16;
29 	__u16	dseg;
30 	__u16	flags;
31 	__u16	cseg_len;
32 	__u16	cseg_16_len;
33 	__u16	dseg_len;
34 };
35 
36 #ifdef __KERNEL__
37 
38 #define APM_CS		(GDT_ENTRY_APMBIOS_BASE * 8)
39 #define APM_CS_16	(APM_CS + 8)
40 #define APM_DS		(APM_CS_16 + 8)
41 
42 /* Results of APM Installation Check */
43 #define APM_16_BIT_SUPPORT	0x0001
44 #define APM_32_BIT_SUPPORT	0x0002
45 #define APM_IDLE_SLOWS_CLOCK	0x0004
46 #define APM_BIOS_DISABLED      	0x0008
47 #define APM_BIOS_DISENGAGED     0x0010
48 
49 /*
50  * Data for APM that is persistent across module unload/load
51  */
52 struct apm_info {
53 	struct apm_bios_info	bios;
54 	unsigned short		connection_version;
55 	int			get_power_status_broken;
56 	int			get_power_status_swabinminutes;
57 	int			allow_ints;
58 	int			forbid_idle;
59 	int			realmode_power_off;
60 	int			disabled;
61 };
62 
63 /*
64  * The APM function codes
65  */
66 #define	APM_FUNC_INST_CHECK	0x5300
67 #define	APM_FUNC_REAL_CONN	0x5301
68 #define	APM_FUNC_16BIT_CONN	0x5302
69 #define	APM_FUNC_32BIT_CONN	0x5303
70 #define	APM_FUNC_DISCONN	0x5304
71 #define	APM_FUNC_IDLE		0x5305
72 #define	APM_FUNC_BUSY		0x5306
73 #define	APM_FUNC_SET_STATE	0x5307
74 #define	APM_FUNC_ENABLE_PM	0x5308
75 #define	APM_FUNC_RESTORE_BIOS	0x5309
76 #define	APM_FUNC_GET_STATUS	0x530a
77 #define	APM_FUNC_GET_EVENT	0x530b
78 #define	APM_FUNC_GET_STATE	0x530c
79 #define	APM_FUNC_ENABLE_DEV_PM	0x530d
80 #define	APM_FUNC_VERSION	0x530e
81 #define	APM_FUNC_ENGAGE_PM	0x530f
82 #define	APM_FUNC_GET_CAP	0x5310
83 #define	APM_FUNC_RESUME_TIMER	0x5311
84 #define	APM_FUNC_RESUME_ON_RING	0x5312
85 #define	APM_FUNC_TIMER		0x5313
86 
87 /*
88  * Function code for APM_FUNC_RESUME_TIMER
89  */
90 #define	APM_FUNC_DISABLE_TIMER	0
91 #define	APM_FUNC_GET_TIMER	1
92 #define	APM_FUNC_SET_TIMER	2
93 
94 /*
95  * Function code for APM_FUNC_RESUME_ON_RING
96  */
97 #define	APM_FUNC_DISABLE_RING	0
98 #define	APM_FUNC_ENABLE_RING	1
99 #define	APM_FUNC_GET_RING	2
100 
101 /*
102  * Function code for APM_FUNC_TIMER_STATUS
103  */
104 #define	APM_FUNC_TIMER_DISABLE	0
105 #define	APM_FUNC_TIMER_ENABLE	1
106 #define	APM_FUNC_TIMER_GET	2
107 
108 /*
109  * in arch/i386/kernel/setup.c
110  */
111 extern struct apm_info	apm_info;
112 
113 #endif	/* __KERNEL__ */
114 
115 /*
116  * Power states
117  */
118 #define APM_STATE_READY		0x0000
119 #define APM_STATE_STANDBY	0x0001
120 #define APM_STATE_SUSPEND	0x0002
121 #define APM_STATE_OFF		0x0003
122 #define APM_STATE_BUSY		0x0004
123 #define APM_STATE_REJECT	0x0005
124 #define APM_STATE_OEM_SYS	0x0020
125 #define APM_STATE_OEM_DEV	0x0040
126 
127 #define APM_STATE_DISABLE	0x0000
128 #define APM_STATE_ENABLE	0x0001
129 
130 #define APM_STATE_DISENGAGE	0x0000
131 #define APM_STATE_ENGAGE	0x0001
132 
133 /*
134  * Events (results of Get PM Event)
135  */
136 #define APM_SYS_STANDBY		0x0001
137 #define APM_SYS_SUSPEND		0x0002
138 #define APM_NORMAL_RESUME	0x0003
139 #define APM_CRITICAL_RESUME	0x0004
140 #define APM_LOW_BATTERY		0x0005
141 #define APM_POWER_STATUS_CHANGE	0x0006
142 #define APM_UPDATE_TIME		0x0007
143 #define APM_CRITICAL_SUSPEND	0x0008
144 #define APM_USER_STANDBY	0x0009
145 #define APM_USER_SUSPEND	0x000a
146 #define APM_STANDBY_RESUME	0x000b
147 #define APM_CAPABILITY_CHANGE	0x000c
148 
149 /*
150  * Error codes
151  */
152 #define APM_SUCCESS		0x00
153 #define APM_DISABLED		0x01
154 #define APM_CONNECTED		0x02
155 #define APM_NOT_CONNECTED	0x03
156 #define APM_16_CONNECTED	0x05
157 #define APM_16_UNSUPPORTED	0x06
158 #define APM_32_CONNECTED	0x07
159 #define APM_32_UNSUPPORTED	0x08
160 #define APM_BAD_DEVICE		0x09
161 #define APM_BAD_PARAM		0x0a
162 #define APM_NOT_ENGAGED		0x0b
163 #define APM_BAD_FUNCTION	0x0c
164 #define APM_RESUME_DISABLED	0x0d
165 #define APM_NO_ERROR		0x53
166 #define APM_BAD_STATE		0x60
167 #define APM_NO_EVENTS		0x80
168 #define APM_NOT_PRESENT		0x86
169 
170 /*
171  * APM Device IDs
172  */
173 #define APM_DEVICE_BIOS		0x0000
174 #define APM_DEVICE_ALL		0x0001
175 #define APM_DEVICE_DISPLAY	0x0100
176 #define APM_DEVICE_STORAGE	0x0200
177 #define APM_DEVICE_PARALLEL	0x0300
178 #define APM_DEVICE_SERIAL	0x0400
179 #define APM_DEVICE_NETWORK	0x0500
180 #define APM_DEVICE_PCMCIA	0x0600
181 #define APM_DEVICE_BATTERY	0x8000
182 #define APM_DEVICE_OEM		0xe000
183 #define APM_DEVICE_OLD_ALL	0xffff
184 #define APM_DEVICE_CLASS	0x00ff
185 #define APM_DEVICE_MASK		0xff00
186 
187 #ifdef __KERNEL__
188 /*
189  * This is the "All Devices" ID communicated to the BIOS
190  */
191 #define APM_DEVICE_BALL		((apm_info.connection_version > 0x0100) ? \
192 				 APM_DEVICE_ALL : APM_DEVICE_OLD_ALL)
193 #endif
194 
195 /*
196  * Battery status
197  */
198 #define APM_MAX_BATTERIES	2
199 
200 /*
201  * APM defined capability bit flags
202  */
203 #define APM_CAP_GLOBAL_STANDBY		0x0001
204 #define APM_CAP_GLOBAL_SUSPEND		0x0002
205 #define APM_CAP_RESUME_STANDBY_TIMER	0x0004 /* Timer resume from standby */
206 #define APM_CAP_RESUME_SUSPEND_TIMER	0x0008 /* Timer resume from suspend */
207 #define APM_CAP_RESUME_STANDBY_RING	0x0010 /* Resume on Ring fr standby */
208 #define APM_CAP_RESUME_SUSPEND_RING	0x0020 /* Resume on Ring fr suspend */
209 #define APM_CAP_RESUME_STANDBY_PCMCIA	0x0040 /* Resume on PCMCIA Ring	*/
210 #define APM_CAP_RESUME_SUSPEND_PCMCIA	0x0080 /* Resume on PCMCIA Ring	*/
211 
212 /*
213  * ioctl operations
214  */
215 #include <linux/ioctl.h>
216 
217 #define APM_IOC_STANDBY		_IO('A', 1)
218 #define APM_IOC_SUSPEND		_IO('A', 2)
219 
220 #endif	/* LINUX_APM_H */
221