xref: /freebsd/sys/dev/acpica/acpivar.h (revision 6adf353a56a161443406b44a45d00c688ca7b857)
1 /*-
2  * Copyright (c) 2000 Mitsuru IWASAKI <iwasaki@jp.freebsd.org>
3  * Copyright (c) 2000 Michael Smith <msmith@freebsd.org>
4  * Copyright (c) 2000 BSDi
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26  * SUCH DAMAGE.
27  *
28  *	$FreeBSD$
29  */
30 
31 #include "bus_if.h"
32 #include <sys/eventhandler.h>
33 #include <sys/sysctl.h>
34 
35 #include <machine/bus.h>
36 #include <machine/resource.h>
37 
38 extern devclass_t	acpi_devclass;
39 
40 struct acpi_softc {
41     device_t		acpi_dev;
42     dev_t		acpi_dev_t;
43 
44     struct resource	*acpi_irq;
45     int			acpi_irq_rid;
46     void		*acpi_irq_handle;
47 
48     int			acpi_enabled;
49     int			acpi_sstate;
50 
51     struct sysctl_ctx_list acpi_sysctl_ctx;
52     struct sysctl_oid	*acpi_sysctl_tree;
53 #define ACPI_POWER_BUTTON_DEFAULT_SX	ACPI_STATE_S5;
54 #define ACPI_SLEEP_BUTTON_DEFAULT_SX	ACPI_STATE_S1;
55 #define ACPI_LID_SWITCH_DEFAULT_SX	ACPI_STATE_S1;
56     int			acpi_power_button_sx;
57     int			acpi_sleep_button_sx;
58     int			acpi_lid_switch_sx;
59 
60     bus_dma_tag_t	acpi_waketag;
61     bus_dmamap_t	acpi_wakemap;
62     vm_offset_t		acpi_wakeaddr;
63     vm_offset_t		acpi_wakephys;
64 
65     struct sysctl_ctx_list	 acpi_battery_sysctl_ctx;
66     struct sysctl_oid		*acpi_battery_sysctl_tree;
67 };
68 
69 struct acpi_device {
70     /* ACPI ivars */
71     ACPI_HANDLE			ad_handle;
72     int				ad_magic;
73     void			*ad_private;
74 
75     /* resources */
76     struct resource_list	ad_rl;
77 
78 };
79 
80 /*
81  * The ACPI subsystem lives under a single mutex.  You *must*
82  * acquire this mutex before calling any of the acpi_ or Acpi* functions.
83  *
84  * XXX the ACPI_MSLEEP macro should go away once locking is resolved
85  */
86 extern struct mtx	acpi_mutex;
87 #if 0
88 # define ACPI_LOCK			mtx_lock(&acpi_mutex)
89 # define ACPI_UNLOCK			mtx_unlock(&acpi_mutex)
90 # define ACPI_ASSERTLOCK		mtx_assert(&acpi_mutex, MA_OWNED)
91 # define ACPI_MSLEEP(a, b, c, d, e)	msleep(a, b, c, d, e)
92 #else
93 # define ACPI_LOCK
94 # define ACPI_UNLOCK
95 # define ACPI_ASSERTLOCK
96 # define ACPI_MSLEEP(a, b, c, d, e)	tsleep(a, c, d, e)
97 #endif
98 
99 /*
100  * This is a cheap and nasty way to get around the horrid counted list
101  * argument format that AcpiEvalateObject uses.
102  */
103 #define ACPI_OBJECTLIST_MAX	16
104 struct acpi_object_list {
105     UINT32	count;
106     ACPI_OBJECT	*pointer[ACPI_OBJECTLIST_MAX];
107     ACPI_OBJECT	object[ACPI_OBJECTLIST_MAX];
108 };
109 
110 static __inline struct acpi_object_list *
111 acpi_AllocObjectList(int nobj) {
112     struct acpi_object_list	*l;
113     int				i;
114 
115     if (nobj > ACPI_OBJECTLIST_MAX)
116 	return(NULL);
117     if ((l = AcpiOsAllocate(sizeof(*l))) == NULL)
118 	return(NULL);
119     bzero(l, sizeof(*l));
120     for (i = 0; i < ACPI_OBJECTLIST_MAX; i++)
121 	l->pointer[i] = &l->object[i];
122     l->count = nobj;
123     return(l);
124 }
125 
126 #define ACPI_IVAR_HANDLE	0x100
127 #define ACPI_IVAR_MAGIC		0x101
128 #define ACPI_IVAR_PRIVATE	0x102
129 
130 static __inline ACPI_HANDLE
131 acpi_get_handle(device_t dev) {
132     ACPI_HANDLE	h;
133 
134     if (BUS_READ_IVAR(device_get_parent(dev), dev, ACPI_IVAR_HANDLE, (uintptr_t *)&h))
135 	return(NULL);
136     return(h);
137 }
138 
139 static __inline int
140 acpi_set_handle(device_t dev, ACPI_HANDLE h) {
141     return(BUS_WRITE_IVAR(device_get_parent(dev), dev, ACPI_IVAR_HANDLE, (uintptr_t)h));
142 }
143 
144 static __inline int
145 acpi_get_magic(device_t dev) {
146     int	m;
147 
148     if (BUS_READ_IVAR(device_get_parent(dev), dev, ACPI_IVAR_MAGIC, (uintptr_t *)&m))
149 	return(0);
150     return(m);
151 }
152 
153 static __inline int
154 acpi_set_magic(device_t dev, int m) {
155     return(BUS_WRITE_IVAR(device_get_parent(dev), dev, ACPI_IVAR_MAGIC, (uintptr_t)m));
156 }
157 
158 static __inline void *
159 acpi_get_private(device_t dev) {
160     void *p;
161 
162     if (BUS_READ_IVAR(device_get_parent(dev), dev, ACPI_IVAR_PRIVATE, (uintptr_t *)&p))
163 	return(NULL);
164     return(p);
165 }
166 
167 static __inline int
168 acpi_set_private(device_t dev, void *p) {
169     return(BUS_WRITE_IVAR(device_get_parent(dev), dev, ACPI_IVAR_PRIVATE, (uintptr_t)p));
170 }
171 
172 static __inline ACPI_OBJECT_TYPE
173 acpi_get_type(device_t dev) {
174     ACPI_HANDLE		h;
175     ACPI_OBJECT_TYPE	t;
176 
177     if ((h = acpi_get_handle(dev)) == NULL)
178 	return(ACPI_TYPE_NOT_FOUND);
179     if (AcpiGetType(h, &t) != AE_OK)
180 	return(ACPI_TYPE_NOT_FOUND);
181     return(t);
182 }
183 
184 #ifdef ENABLE_DEBUGGER
185 extern void		acpi_EnterDebugger(void);
186 #endif
187 
188 #ifdef ACPI_DEBUG
189 #include <sys/cons.h>
190 #define STEP(x)		do {printf x, printf("\n"); cngetc();} while (0)
191 #else
192 #define STEP(x)
193 #endif
194 
195 extern BOOLEAN		acpi_DeviceIsPresent(device_t dev);
196 extern BOOLEAN		acpi_MatchHid(device_t dev, char *hid);
197 extern ACPI_STATUS	acpi_GetHandleInScope(ACPI_HANDLE parent, char *path, ACPI_HANDLE *result);
198 extern ACPI_BUFFER	*acpi_AllocBuffer(int size);
199 extern ACPI_STATUS	acpi_GetIntoBuffer(ACPI_HANDLE handle,
200 					   ACPI_STATUS (*func)(ACPI_HANDLE, ACPI_BUFFER *),
201 					   ACPI_BUFFER *buf);
202 extern ACPI_STATUS	acpi_GetTableIntoBuffer(ACPI_TABLE_TYPE table, UINT32 instance, ACPI_BUFFER *buf);
203 extern ACPI_STATUS	acpi_EvaluateIntoBuffer(ACPI_HANDLE object, ACPI_STRING pathname,
204 						ACPI_OBJECT_LIST *params, ACPI_BUFFER *buf);
205 extern ACPI_STATUS	acpi_EvaluateInteger(ACPI_HANDLE handle, char *path, int *number);
206 extern ACPI_STATUS	acpi_ForeachPackageObject(ACPI_OBJECT *obj,
207 						  void (* func)(ACPI_OBJECT *comp, void *arg),
208 						  void *arg);
209 extern ACPI_STATUS	acpi_FindIndexedResource(ACPI_BUFFER *buf, int index, ACPI_RESOURCE **resp);
210 extern ACPI_STATUS	acpi_AppendBufferResource(ACPI_BUFFER *buf, ACPI_RESOURCE *res);
211 
212 extern ACPI_STATUS	acpi_SetSleepState(struct acpi_softc *sc, int state);
213 extern ACPI_STATUS	acpi_Enable(struct acpi_softc *sc);
214 extern ACPI_STATUS	acpi_Disable(struct acpi_softc *sc);
215 
216 struct acpi_parse_resource_set {
217     void	(* set_init)(device_t dev, void **context);
218     void	(* set_done)(device_t dev, void *context);
219     void	(* set_ioport)(device_t dev, void *context, u_int32_t base, u_int32_t length);
220     void	(* set_iorange)(device_t dev, void *context, u_int32_t low, u_int32_t high,
221 				u_int32_t length, u_int32_t align);
222     void	(* set_memory)(device_t dev, void *context, u_int32_t base, u_int32_t length);
223     void	(* set_memoryrange)(device_t dev, void *context, u_int32_t low, u_int32_t high,
224 				    u_int32_t length, u_int32_t align);
225     void	(* set_irq)(device_t dev, void *context, u_int32_t irq);
226     void	(* set_drq)(device_t dev, void *context, u_int32_t drq);
227     void	(* set_start_dependant)(device_t dev, void *context, int preference);
228     void	(* set_end_dependant)(device_t dev, void *context);
229 };
230 
231 extern struct acpi_parse_resource_set	acpi_res_parse_set;
232 extern ACPI_STATUS	acpi_parse_resources(device_t dev, ACPI_HANDLE handle,
233 					     struct acpi_parse_resource_set *set);
234 /* XXX until Intel fix this in their headers, based on NEXT_RESOURCE */
235 #define ACPI_RESOURCE_NEXT(Res)      (ACPI_RESOURCE *)((UINT8 *) Res + Res->Length)
236 
237 /*
238  * ACPI event handling
239  */
240 extern UINT32		acpi_eventhandler_power_button_for_sleep(void *context);
241 extern UINT32		acpi_eventhandler_power_button_for_wakeup(void *context);
242 extern UINT32		acpi_eventhandler_sleep_button_for_sleep(void *context);
243 extern UINT32		acpi_eventhandler_sleep_button_for_wakeup(void *context);
244 
245 #define ACPI_EVENT_PRI_FIRST      0
246 #define ACPI_EVENT_PRI_DEFAULT    10000
247 #define ACPI_EVENT_PRI_LAST       20000
248 
249 typedef void (*acpi_event_handler_t) __P((void *, int));
250 
251 EVENTHANDLER_DECLARE(acpi_sleep_event, acpi_event_handler_t);
252 EVENTHANDLER_DECLARE(acpi_wakeup_event, acpi_event_handler_t);
253 
254 /*
255  * Device power control.
256  */
257 extern ACPI_STATUS	acpi_pwr_switch_consumer(ACPI_HANDLE consumer, int state);
258 
259 /*
260  * Misc.
261  */
262 static __inline struct acpi_softc *
263 acpi_device_get_parent_softc(device_t child)
264 {
265     device_t	parent;
266 
267     parent = device_get_parent(child);
268     if (parent == NULL) {
269 	return(NULL);
270     }
271     return(device_get_softc(parent));
272 }
273 
274 extern char	*acpi_name(ACPI_HANDLE handle);
275 extern int	acpi_avoid(ACPI_HANDLE handle);
276 extern int	acpi_disabled(char *subsys);
277 
278 extern void	acpi_install_wakeup_handler(struct acpi_softc *sc);
279 extern int	acpi_sleep_machdep(struct acpi_softc *sc, int state);
280 
281 /*
282  * Battery Abstruction.
283  */
284 struct acpi_battinfo;
285 
286 extern int	acpi_battery_register(int, int);
287 extern int	acpi_cmbat_get_battinfo(int, struct acpi_battinfo *);
288 
289 /*
290  * System power API.
291  *
292  * XXX should this be further generalised?
293  *
294  */
295 #define POWERPROFILE_PERFORMANCE	0
296 #define POWERPROFILE_ECONOMY		1
297 
298 extern int	powerprofile_get_state(void);
299 extern void	powerprofile_set_state(int state);
300 
301 typedef void (*powerprofile_change_hook)(void *);
302 EVENTHANDLER_DECLARE(powerprofile_change, powerprofile_change_hook);
303