xref: /freebsd/sys/dev/acpica/acpi.c (revision 3ee5c55415a7b08c6c4c403cc6b96e30d768e1c9)
1 /*-
2  * Copyright (c) 2000 Takanori Watanabe <takawata@jp.freebsd.org>
3  * Copyright (c) 2000 Mitsuru IWASAKI <iwasaki@jp.freebsd.org>
4  * Copyright (c) 2000, 2001 Michael Smith
5  * Copyright (c) 2000 BSDi
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
21  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27  * SUCH DAMAGE.
28  */
29 
30 #include <sys/cdefs.h>
31 __FBSDID("$FreeBSD$");
32 
33 #include "opt_acpi.h"
34 
35 #include <sys/param.h>
36 #include <sys/kernel.h>
37 #include <sys/proc.h>
38 #include <sys/fcntl.h>
39 #include <sys/malloc.h>
40 #include <sys/module.h>
41 #include <sys/bus.h>
42 #include <sys/conf.h>
43 #include <sys/ioccom.h>
44 #include <sys/reboot.h>
45 #include <sys/sysctl.h>
46 #include <sys/ctype.h>
47 #include <sys/linker.h>
48 #include <sys/power.h>
49 #include <sys/sbuf.h>
50 #include <sys/sched.h>
51 #include <sys/smp.h>
52 #include <sys/timetc.h>
53 
54 #if defined(__i386__) || defined(__amd64__)
55 #include <machine/pci_cfgreg.h>
56 #endif
57 #include <machine/resource.h>
58 #include <machine/bus.h>
59 #include <sys/rman.h>
60 #include <isa/isavar.h>
61 #include <isa/pnpvar.h>
62 
63 #include <contrib/dev/acpica/include/acpi.h>
64 #include <contrib/dev/acpica/include/accommon.h>
65 #include <contrib/dev/acpica/include/acnamesp.h>
66 
67 #include <dev/acpica/acpivar.h>
68 #include <dev/acpica/acpiio.h>
69 
70 #include <dev/pci/pcivar.h>
71 
72 #include <vm/vm_param.h>
73 
74 static MALLOC_DEFINE(M_ACPIDEV, "acpidev", "ACPI devices");
75 
76 /* Hooks for the ACPI CA debugging infrastructure */
77 #define _COMPONENT	ACPI_BUS
78 ACPI_MODULE_NAME("ACPI")
79 
80 static d_open_t		acpiopen;
81 static d_close_t	acpiclose;
82 static d_ioctl_t	acpiioctl;
83 
84 static struct cdevsw acpi_cdevsw = {
85 	.d_version =	D_VERSION,
86 	.d_open =	acpiopen,
87 	.d_close =	acpiclose,
88 	.d_ioctl =	acpiioctl,
89 	.d_name =	"acpi",
90 };
91 
92 struct acpi_interface {
93 	ACPI_STRING	*data;
94 	int		num;
95 };
96 
97 static char *sysres_ids[] = { "PNP0C01", "PNP0C02", NULL };
98 static char *pcilink_ids[] = { "PNP0C0F", NULL };
99 
100 /* Global mutex for locking access to the ACPI subsystem. */
101 struct mtx	acpi_mutex;
102 struct callout	acpi_sleep_timer;
103 
104 /* Bitmap of device quirks. */
105 int		acpi_quirks;
106 
107 /* Supported sleep states. */
108 static BOOLEAN	acpi_sleep_states[ACPI_S_STATE_COUNT];
109 
110 static void	acpi_lookup(void *arg, const char *name, device_t *dev);
111 static int	acpi_modevent(struct module *mod, int event, void *junk);
112 static int	acpi_probe(device_t dev);
113 static int	acpi_attach(device_t dev);
114 static int	acpi_suspend(device_t dev);
115 static int	acpi_resume(device_t dev);
116 static int	acpi_shutdown(device_t dev);
117 static device_t	acpi_add_child(device_t bus, u_int order, const char *name,
118 			int unit);
119 static int	acpi_print_child(device_t bus, device_t child);
120 static void	acpi_probe_nomatch(device_t bus, device_t child);
121 static void	acpi_driver_added(device_t dev, driver_t *driver);
122 static int	acpi_read_ivar(device_t dev, device_t child, int index,
123 			uintptr_t *result);
124 static int	acpi_write_ivar(device_t dev, device_t child, int index,
125 			uintptr_t value);
126 static struct resource_list *acpi_get_rlist(device_t dev, device_t child);
127 static void	acpi_reserve_resources(device_t dev);
128 static int	acpi_sysres_alloc(device_t dev);
129 static int	acpi_set_resource(device_t dev, device_t child, int type,
130 			int rid, rman_res_t start, rman_res_t count);
131 static struct resource *acpi_alloc_resource(device_t bus, device_t child,
132 			int type, int *rid, rman_res_t start, rman_res_t end,
133 			rman_res_t count, u_int flags);
134 static int	acpi_adjust_resource(device_t bus, device_t child, int type,
135 			struct resource *r, rman_res_t start, rman_res_t end);
136 static int	acpi_release_resource(device_t bus, device_t child, int type,
137 			int rid, struct resource *r);
138 static void	acpi_delete_resource(device_t bus, device_t child, int type,
139 		    int rid);
140 static uint32_t	acpi_isa_get_logicalid(device_t dev);
141 static int	acpi_isa_get_compatid(device_t dev, uint32_t *cids, int count);
142 static char	*acpi_device_id_probe(device_t bus, device_t dev, char **ids);
143 static ACPI_STATUS acpi_device_eval_obj(device_t bus, device_t dev,
144 		    ACPI_STRING pathname, ACPI_OBJECT_LIST *parameters,
145 		    ACPI_BUFFER *ret);
146 static ACPI_STATUS acpi_device_scan_cb(ACPI_HANDLE h, UINT32 level,
147 		    void *context, void **retval);
148 static ACPI_STATUS acpi_device_scan_children(device_t bus, device_t dev,
149 		    int max_depth, acpi_scan_cb_t user_fn, void *arg);
150 static int	acpi_set_powerstate(device_t child, int state);
151 static int	acpi_isa_pnp_probe(device_t bus, device_t child,
152 		    struct isa_pnp_id *ids);
153 static void	acpi_probe_children(device_t bus);
154 static void	acpi_probe_order(ACPI_HANDLE handle, int *order);
155 static ACPI_STATUS acpi_probe_child(ACPI_HANDLE handle, UINT32 level,
156 		    void *context, void **status);
157 static void	acpi_sleep_enable(void *arg);
158 static ACPI_STATUS acpi_sleep_disable(struct acpi_softc *sc);
159 static ACPI_STATUS acpi_EnterSleepState(struct acpi_softc *sc, int state);
160 static void	acpi_shutdown_final(void *arg, int howto);
161 static void	acpi_enable_fixed_events(struct acpi_softc *sc);
162 static BOOLEAN	acpi_has_hid(ACPI_HANDLE handle);
163 static void	acpi_resync_clock(struct acpi_softc *sc);
164 static int	acpi_wake_sleep_prep(ACPI_HANDLE handle, int sstate);
165 static int	acpi_wake_run_prep(ACPI_HANDLE handle, int sstate);
166 static int	acpi_wake_prep_walk(int sstate);
167 static int	acpi_wake_sysctl_walk(device_t dev);
168 static int	acpi_wake_set_sysctl(SYSCTL_HANDLER_ARGS);
169 static void	acpi_system_eventhandler_sleep(void *arg, int state);
170 static void	acpi_system_eventhandler_wakeup(void *arg, int state);
171 static int	acpi_sname2sstate(const char *sname);
172 static const char *acpi_sstate2sname(int sstate);
173 static int	acpi_supported_sleep_state_sysctl(SYSCTL_HANDLER_ARGS);
174 static int	acpi_sleep_state_sysctl(SYSCTL_HANDLER_ARGS);
175 static int	acpi_debug_objects_sysctl(SYSCTL_HANDLER_ARGS);
176 static int	acpi_pm_func(u_long cmd, void *arg, ...);
177 static int	acpi_child_location_str_method(device_t acdev, device_t child,
178 					       char *buf, size_t buflen);
179 static int	acpi_child_pnpinfo_str_method(device_t acdev, device_t child,
180 					      char *buf, size_t buflen);
181 #if defined(__i386__) || defined(__amd64__)
182 static void	acpi_enable_pcie(void);
183 #endif
184 static void	acpi_hint_device_unit(device_t acdev, device_t child,
185 		    const char *name, int *unitp);
186 static void	acpi_reset_interfaces(device_t dev);
187 
188 static device_method_t acpi_methods[] = {
189     /* Device interface */
190     DEVMETHOD(device_probe,		acpi_probe),
191     DEVMETHOD(device_attach,		acpi_attach),
192     DEVMETHOD(device_shutdown,		acpi_shutdown),
193     DEVMETHOD(device_detach,		bus_generic_detach),
194     DEVMETHOD(device_suspend,		acpi_suspend),
195     DEVMETHOD(device_resume,		acpi_resume),
196 
197     /* Bus interface */
198     DEVMETHOD(bus_add_child,		acpi_add_child),
199     DEVMETHOD(bus_print_child,		acpi_print_child),
200     DEVMETHOD(bus_probe_nomatch,	acpi_probe_nomatch),
201     DEVMETHOD(bus_driver_added,		acpi_driver_added),
202     DEVMETHOD(bus_read_ivar,		acpi_read_ivar),
203     DEVMETHOD(bus_write_ivar,		acpi_write_ivar),
204     DEVMETHOD(bus_get_resource_list,	acpi_get_rlist),
205     DEVMETHOD(bus_set_resource,		acpi_set_resource),
206     DEVMETHOD(bus_get_resource,		bus_generic_rl_get_resource),
207     DEVMETHOD(bus_alloc_resource,	acpi_alloc_resource),
208     DEVMETHOD(bus_adjust_resource,	acpi_adjust_resource),
209     DEVMETHOD(bus_release_resource,	acpi_release_resource),
210     DEVMETHOD(bus_delete_resource,	acpi_delete_resource),
211     DEVMETHOD(bus_child_pnpinfo_str,	acpi_child_pnpinfo_str_method),
212     DEVMETHOD(bus_child_location_str,	acpi_child_location_str_method),
213     DEVMETHOD(bus_activate_resource,	bus_generic_activate_resource),
214     DEVMETHOD(bus_deactivate_resource,	bus_generic_deactivate_resource),
215     DEVMETHOD(bus_setup_intr,		bus_generic_setup_intr),
216     DEVMETHOD(bus_teardown_intr,	bus_generic_teardown_intr),
217     DEVMETHOD(bus_hint_device_unit,	acpi_hint_device_unit),
218     DEVMETHOD(bus_get_cpus,		acpi_get_cpus),
219     DEVMETHOD(bus_get_domain,		acpi_get_domain),
220 
221     /* ACPI bus */
222     DEVMETHOD(acpi_id_probe,		acpi_device_id_probe),
223     DEVMETHOD(acpi_evaluate_object,	acpi_device_eval_obj),
224     DEVMETHOD(acpi_pwr_for_sleep,	acpi_device_pwr_for_sleep),
225     DEVMETHOD(acpi_scan_children,	acpi_device_scan_children),
226 
227     /* ISA emulation */
228     DEVMETHOD(isa_pnp_probe,		acpi_isa_pnp_probe),
229 
230     DEVMETHOD_END
231 };
232 
233 static driver_t acpi_driver = {
234     "acpi",
235     acpi_methods,
236     sizeof(struct acpi_softc),
237 };
238 
239 static devclass_t acpi_devclass;
240 DRIVER_MODULE(acpi, nexus, acpi_driver, acpi_devclass, acpi_modevent, 0);
241 MODULE_VERSION(acpi, 1);
242 
243 ACPI_SERIAL_DECL(acpi, "ACPI root bus");
244 
245 /* Local pools for managing system resources for ACPI child devices. */
246 static struct rman acpi_rman_io, acpi_rman_mem;
247 
248 #define ACPI_MINIMUM_AWAKETIME	5
249 
250 /* Holds the description of the acpi0 device. */
251 static char acpi_desc[ACPI_OEM_ID_SIZE + ACPI_OEM_TABLE_ID_SIZE + 2];
252 
253 SYSCTL_NODE(_debug, OID_AUTO, acpi, CTLFLAG_RD, NULL, "ACPI debugging");
254 static char acpi_ca_version[12];
255 SYSCTL_STRING(_debug_acpi, OID_AUTO, acpi_ca_version, CTLFLAG_RD,
256 	      acpi_ca_version, 0, "Version of Intel ACPI-CA");
257 
258 /*
259  * Allow overriding _OSI methods.
260  */
261 static char acpi_install_interface[256];
262 TUNABLE_STR("hw.acpi.install_interface", acpi_install_interface,
263     sizeof(acpi_install_interface));
264 static char acpi_remove_interface[256];
265 TUNABLE_STR("hw.acpi.remove_interface", acpi_remove_interface,
266     sizeof(acpi_remove_interface));
267 
268 /* Allow users to dump Debug objects without ACPI debugger. */
269 static int acpi_debug_objects;
270 TUNABLE_INT("debug.acpi.enable_debug_objects", &acpi_debug_objects);
271 SYSCTL_PROC(_debug_acpi, OID_AUTO, enable_debug_objects,
272     CTLFLAG_RW | CTLTYPE_INT, NULL, 0, acpi_debug_objects_sysctl, "I",
273     "Enable Debug objects");
274 
275 /* Allow the interpreter to ignore common mistakes in BIOS. */
276 static int acpi_interpreter_slack = 1;
277 TUNABLE_INT("debug.acpi.interpreter_slack", &acpi_interpreter_slack);
278 SYSCTL_INT(_debug_acpi, OID_AUTO, interpreter_slack, CTLFLAG_RDTUN,
279     &acpi_interpreter_slack, 1, "Turn on interpreter slack mode.");
280 
281 /* Ignore register widths set by FADT and use default widths instead. */
282 static int acpi_ignore_reg_width = 1;
283 TUNABLE_INT("debug.acpi.default_register_width", &acpi_ignore_reg_width);
284 SYSCTL_INT(_debug_acpi, OID_AUTO, default_register_width, CTLFLAG_RDTUN,
285     &acpi_ignore_reg_width, 1, "Ignore register widths set by FADT");
286 
287 /* Allow users to override quirks. */
288 TUNABLE_INT("debug.acpi.quirks", &acpi_quirks);
289 
290 static int acpi_susp_bounce;
291 SYSCTL_INT(_debug_acpi, OID_AUTO, suspend_bounce, CTLFLAG_RW,
292     &acpi_susp_bounce, 0, "Don't actually suspend, just test devices.");
293 
294 int acpi_susp_deep_bounce;
295 SYSCTL_INT(_debug_acpi, OID_AUTO, suspend_deep_bounce, CTLFLAG_RW,
296     &acpi_susp_deep_bounce, 0, "Don't actually suspend, "
297     "bail out just before entering the sleep state.");
298 
299 /*
300  * ACPI can only be loaded as a module by the loader; activating it after
301  * system bootstrap time is not useful, and can be fatal to the system.
302  * It also cannot be unloaded, since the entire system bus hierarchy hangs
303  * off it.
304  */
305 static int
306 acpi_modevent(struct module *mod, int event, void *junk)
307 {
308     switch (event) {
309     case MOD_LOAD:
310 	if (!cold) {
311 	    printf("The ACPI driver cannot be loaded after boot.\n");
312 	    return (EPERM);
313 	}
314 	break;
315     case MOD_UNLOAD:
316 	if (!cold && power_pm_get_type() == POWER_PM_TYPE_ACPI)
317 	    return (EBUSY);
318 	break;
319     default:
320 	break;
321     }
322     return (0);
323 }
324 
325 /*
326  * Perform early initialization.
327  */
328 ACPI_STATUS
329 acpi_Startup(void)
330 {
331     static int started = 0;
332     ACPI_STATUS status;
333     int val;
334 
335     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
336 
337     /* Only run the startup code once.  The MADT driver also calls this. */
338     if (started)
339 	return_VALUE (AE_OK);
340     started = 1;
341 
342     /*
343      * Initialize the ACPICA subsystem.
344      */
345     if (ACPI_FAILURE(status = AcpiInitializeSubsystem())) {
346 	printf("ACPI: Could not initialize Subsystem: %s\n",
347 	    AcpiFormatException(status));
348 	return_VALUE (status);
349     }
350 
351     /*
352      * Pre-allocate space for RSDT/XSDT and DSDT tables and allow resizing
353      * if more tables exist.
354      */
355     if (ACPI_FAILURE(status = AcpiInitializeTables(NULL, 2, TRUE))) {
356 	printf("ACPI: Table initialisation failed: %s\n",
357 	    AcpiFormatException(status));
358 	return_VALUE (status);
359     }
360 
361     /* Set up any quirks we have for this system. */
362     if (acpi_quirks == ACPI_Q_OK)
363 	acpi_table_quirks(&acpi_quirks);
364 
365     /* If the user manually set the disabled hint to 0, force-enable ACPI. */
366     if (resource_int_value("acpi", 0, "disabled", &val) == 0 && val == 0)
367 	acpi_quirks &= ~ACPI_Q_BROKEN;
368     if (acpi_quirks & ACPI_Q_BROKEN) {
369 	printf("ACPI disabled by blacklist.  Contact your BIOS vendor.\n");
370 	status = AE_SUPPORT;
371     }
372 
373     return_VALUE (status);
374 }
375 
376 /*
377  * Detect ACPI and perform early initialisation.
378  */
379 int
380 acpi_identify(void)
381 {
382     ACPI_TABLE_RSDP	*rsdp;
383     ACPI_TABLE_HEADER	*rsdt;
384     ACPI_PHYSICAL_ADDRESS paddr;
385     struct sbuf		sb;
386 
387     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
388 
389     if (!cold)
390 	return (ENXIO);
391 
392     /* Check that we haven't been disabled with a hint. */
393     if (resource_disabled("acpi", 0))
394 	return (ENXIO);
395 
396     /* Check for other PM systems. */
397     if (power_pm_get_type() != POWER_PM_TYPE_NONE &&
398 	power_pm_get_type() != POWER_PM_TYPE_ACPI) {
399 	printf("ACPI identify failed, other PM system enabled.\n");
400 	return (ENXIO);
401     }
402 
403     /* Initialize root tables. */
404     if (ACPI_FAILURE(acpi_Startup())) {
405 	printf("ACPI: Try disabling either ACPI or apic support.\n");
406 	return (ENXIO);
407     }
408 
409     if ((paddr = AcpiOsGetRootPointer()) == 0 ||
410 	(rsdp = AcpiOsMapMemory(paddr, sizeof(ACPI_TABLE_RSDP))) == NULL)
411 	return (ENXIO);
412     if (rsdp->Revision > 1 && rsdp->XsdtPhysicalAddress != 0)
413 	paddr = (ACPI_PHYSICAL_ADDRESS)rsdp->XsdtPhysicalAddress;
414     else
415 	paddr = (ACPI_PHYSICAL_ADDRESS)rsdp->RsdtPhysicalAddress;
416     AcpiOsUnmapMemory(rsdp, sizeof(ACPI_TABLE_RSDP));
417 
418     if ((rsdt = AcpiOsMapMemory(paddr, sizeof(ACPI_TABLE_HEADER))) == NULL)
419 	return (ENXIO);
420     sbuf_new(&sb, acpi_desc, sizeof(acpi_desc), SBUF_FIXEDLEN);
421     sbuf_bcat(&sb, rsdt->OemId, ACPI_OEM_ID_SIZE);
422     sbuf_trim(&sb);
423     sbuf_putc(&sb, ' ');
424     sbuf_bcat(&sb, rsdt->OemTableId, ACPI_OEM_TABLE_ID_SIZE);
425     sbuf_trim(&sb);
426     sbuf_finish(&sb);
427     sbuf_delete(&sb);
428     AcpiOsUnmapMemory(rsdt, sizeof(ACPI_TABLE_HEADER));
429 
430     snprintf(acpi_ca_version, sizeof(acpi_ca_version), "%x", ACPI_CA_VERSION);
431 
432     return (0);
433 }
434 
435 /*
436  * Fetch some descriptive data from ACPI to put in our attach message.
437  */
438 static int
439 acpi_probe(device_t dev)
440 {
441 
442     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
443 
444     device_set_desc(dev, acpi_desc);
445 
446     return_VALUE (BUS_PROBE_NOWILDCARD);
447 }
448 
449 static int
450 acpi_attach(device_t dev)
451 {
452     struct acpi_softc	*sc;
453     ACPI_STATUS		status;
454     int			error, state;
455     UINT32		flags;
456     UINT8		TypeA, TypeB;
457     char		*env;
458 
459     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
460 
461     sc = device_get_softc(dev);
462     sc->acpi_dev = dev;
463     callout_init(&sc->susp_force_to, 1);
464 
465     error = ENXIO;
466 
467     /* Initialize resource manager. */
468     acpi_rman_io.rm_type = RMAN_ARRAY;
469     acpi_rman_io.rm_start = 0;
470     acpi_rman_io.rm_end = 0xffff;
471     acpi_rman_io.rm_descr = "ACPI I/O ports";
472     if (rman_init(&acpi_rman_io) != 0)
473 	panic("acpi rman_init IO ports failed");
474     acpi_rman_mem.rm_type = RMAN_ARRAY;
475     acpi_rman_mem.rm_descr = "ACPI I/O memory addresses";
476     if (rman_init(&acpi_rman_mem) != 0)
477 	panic("acpi rman_init memory failed");
478 
479     /* Initialise the ACPI mutex */
480     mtx_init(&acpi_mutex, "ACPI global lock", NULL, MTX_DEF);
481 
482     /*
483      * Set the globals from our tunables.  This is needed because ACPI-CA
484      * uses UINT8 for some values and we have no tunable_byte.
485      */
486     AcpiGbl_EnableInterpreterSlack = acpi_interpreter_slack ? TRUE : FALSE;
487     AcpiGbl_EnableAmlDebugObject = acpi_debug_objects ? TRUE : FALSE;
488     AcpiGbl_UseDefaultRegisterWidths = acpi_ignore_reg_width ? TRUE : FALSE;
489 
490 #ifndef ACPI_DEBUG
491     /*
492      * Disable all debugging layers and levels.
493      */
494     AcpiDbgLayer = 0;
495     AcpiDbgLevel = 0;
496 #endif
497 
498     /* Override OS interfaces if the user requested. */
499     acpi_reset_interfaces(dev);
500 
501     /* Load ACPI name space. */
502     status = AcpiLoadTables();
503     if (ACPI_FAILURE(status)) {
504 	device_printf(dev, "Could not load Namespace: %s\n",
505 		      AcpiFormatException(status));
506 	goto out;
507     }
508 
509 #if defined(__i386__) || defined(__amd64__)
510     /* Handle MCFG table if present. */
511     acpi_enable_pcie();
512 #endif
513 
514     /*
515      * Note that some systems (specifically, those with namespace evaluation
516      * issues that require the avoidance of parts of the namespace) must
517      * avoid running _INI and _STA on everything, as well as dodging the final
518      * object init pass.
519      *
520      * For these devices, we set ACPI_NO_DEVICE_INIT and ACPI_NO_OBJECT_INIT).
521      *
522      * XXX We should arrange for the object init pass after we have attached
523      *     all our child devices, but on many systems it works here.
524      */
525     flags = 0;
526     if (testenv("debug.acpi.avoid"))
527 	flags = ACPI_NO_DEVICE_INIT | ACPI_NO_OBJECT_INIT;
528 
529     /* Bring the hardware and basic handlers online. */
530     if (ACPI_FAILURE(status = AcpiEnableSubsystem(flags))) {
531 	device_printf(dev, "Could not enable ACPI: %s\n",
532 		      AcpiFormatException(status));
533 	goto out;
534     }
535 
536     /*
537      * Call the ECDT probe function to provide EC functionality before
538      * the namespace has been evaluated.
539      *
540      * XXX This happens before the sysresource devices have been probed and
541      * attached so its resources come from nexus0.  In practice, this isn't
542      * a problem but should be addressed eventually.
543      */
544     acpi_ec_ecdt_probe(dev);
545 
546     /* Bring device objects and regions online. */
547     if (ACPI_FAILURE(status = AcpiInitializeObjects(flags))) {
548 	device_printf(dev, "Could not initialize ACPI objects: %s\n",
549 		      AcpiFormatException(status));
550 	goto out;
551     }
552 
553     /*
554      * Setup our sysctl tree.
555      *
556      * XXX: This doesn't check to make sure that none of these fail.
557      */
558     sysctl_ctx_init(&sc->acpi_sysctl_ctx);
559     sc->acpi_sysctl_tree = SYSCTL_ADD_NODE(&sc->acpi_sysctl_ctx,
560 			       SYSCTL_STATIC_CHILDREN(_hw), OID_AUTO,
561 			       device_get_name(dev), CTLFLAG_RD, 0, "");
562     SYSCTL_ADD_PROC(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
563 	OID_AUTO, "supported_sleep_state", CTLTYPE_STRING | CTLFLAG_RD,
564 	0, 0, acpi_supported_sleep_state_sysctl, "A",
565 	"List supported ACPI sleep states.");
566     SYSCTL_ADD_PROC(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
567 	OID_AUTO, "power_button_state", CTLTYPE_STRING | CTLFLAG_RW,
568 	&sc->acpi_power_button_sx, 0, acpi_sleep_state_sysctl, "A",
569 	"Power button ACPI sleep state.");
570     SYSCTL_ADD_PROC(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
571 	OID_AUTO, "sleep_button_state", CTLTYPE_STRING | CTLFLAG_RW,
572 	&sc->acpi_sleep_button_sx, 0, acpi_sleep_state_sysctl, "A",
573 	"Sleep button ACPI sleep state.");
574     SYSCTL_ADD_PROC(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
575 	OID_AUTO, "lid_switch_state", CTLTYPE_STRING | CTLFLAG_RW,
576 	&sc->acpi_lid_switch_sx, 0, acpi_sleep_state_sysctl, "A",
577 	"Lid ACPI sleep state. Set to S3 if you want to suspend your laptop when close the Lid.");
578     SYSCTL_ADD_PROC(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
579 	OID_AUTO, "standby_state", CTLTYPE_STRING | CTLFLAG_RW,
580 	&sc->acpi_standby_sx, 0, acpi_sleep_state_sysctl, "A", "");
581     SYSCTL_ADD_PROC(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
582 	OID_AUTO, "suspend_state", CTLTYPE_STRING | CTLFLAG_RW,
583 	&sc->acpi_suspend_sx, 0, acpi_sleep_state_sysctl, "A", "");
584     SYSCTL_ADD_INT(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
585 	OID_AUTO, "sleep_delay", CTLFLAG_RW, &sc->acpi_sleep_delay, 0,
586 	"sleep delay in seconds");
587     SYSCTL_ADD_INT(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
588 	OID_AUTO, "s4bios", CTLFLAG_RW, &sc->acpi_s4bios, 0, "S4BIOS mode");
589     SYSCTL_ADD_INT(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
590 	OID_AUTO, "verbose", CTLFLAG_RW, &sc->acpi_verbose, 0, "verbose mode");
591     SYSCTL_ADD_INT(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
592 	OID_AUTO, "disable_on_reboot", CTLFLAG_RW,
593 	&sc->acpi_do_disable, 0, "Disable ACPI when rebooting/halting system");
594     SYSCTL_ADD_INT(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
595 	OID_AUTO, "handle_reboot", CTLFLAG_RW,
596 	&sc->acpi_handle_reboot, 0, "Use ACPI Reset Register to reboot");
597 
598     /*
599      * Default to 1 second before sleeping to give some machines time to
600      * stabilize.
601      */
602     sc->acpi_sleep_delay = 1;
603     if (bootverbose)
604 	sc->acpi_verbose = 1;
605     if ((env = kern_getenv("hw.acpi.verbose")) != NULL) {
606 	if (strcmp(env, "0") != 0)
607 	    sc->acpi_verbose = 1;
608 	freeenv(env);
609     }
610 
611     /* Only enable reboot by default if the FADT says it is available. */
612     if (AcpiGbl_FADT.Flags & ACPI_FADT_RESET_REGISTER)
613 	sc->acpi_handle_reboot = 1;
614 
615 #if !ACPI_REDUCED_HARDWARE
616     /* Only enable S4BIOS by default if the FACS says it is available. */
617     if (AcpiGbl_FACS != NULL && AcpiGbl_FACS->Flags & ACPI_FACS_S4_BIOS_PRESENT)
618 	sc->acpi_s4bios = 1;
619 #endif
620 
621     /* Probe all supported sleep states. */
622     acpi_sleep_states[ACPI_STATE_S0] = TRUE;
623     for (state = ACPI_STATE_S1; state < ACPI_S_STATE_COUNT; state++)
624 	if (ACPI_SUCCESS(AcpiEvaluateObject(ACPI_ROOT_OBJECT,
625 	    __DECONST(char *, AcpiGbl_SleepStateNames[state]), NULL, NULL)) &&
626 	    ACPI_SUCCESS(AcpiGetSleepTypeData(state, &TypeA, &TypeB)))
627 	    acpi_sleep_states[state] = TRUE;
628 
629     /*
630      * Dispatch the default sleep state to devices.  The lid switch is set
631      * to UNKNOWN by default to avoid surprising users.
632      */
633     sc->acpi_power_button_sx = acpi_sleep_states[ACPI_STATE_S5] ?
634 	ACPI_STATE_S5 : ACPI_STATE_UNKNOWN;
635     sc->acpi_lid_switch_sx = ACPI_STATE_UNKNOWN;
636     sc->acpi_standby_sx = acpi_sleep_states[ACPI_STATE_S1] ?
637 	ACPI_STATE_S1 : ACPI_STATE_UNKNOWN;
638     sc->acpi_suspend_sx = acpi_sleep_states[ACPI_STATE_S3] ?
639 	ACPI_STATE_S3 : ACPI_STATE_UNKNOWN;
640 
641     /* Pick the first valid sleep state for the sleep button default. */
642     sc->acpi_sleep_button_sx = ACPI_STATE_UNKNOWN;
643     for (state = ACPI_STATE_S1; state <= ACPI_STATE_S4; state++)
644 	if (acpi_sleep_states[state]) {
645 	    sc->acpi_sleep_button_sx = state;
646 	    break;
647 	}
648 
649     acpi_enable_fixed_events(sc);
650 
651     /*
652      * Scan the namespace and attach/initialise children.
653      */
654 
655     /* Register our shutdown handler. */
656     EVENTHANDLER_REGISTER(shutdown_final, acpi_shutdown_final, sc,
657 	SHUTDOWN_PRI_LAST);
658 
659     /*
660      * Register our acpi event handlers.
661      * XXX should be configurable eg. via userland policy manager.
662      */
663     EVENTHANDLER_REGISTER(acpi_sleep_event, acpi_system_eventhandler_sleep,
664 	sc, ACPI_EVENT_PRI_LAST);
665     EVENTHANDLER_REGISTER(acpi_wakeup_event, acpi_system_eventhandler_wakeup,
666 	sc, ACPI_EVENT_PRI_LAST);
667 
668     /* Flag our initial states. */
669     sc->acpi_enabled = TRUE;
670     sc->acpi_sstate = ACPI_STATE_S0;
671     sc->acpi_sleep_disabled = TRUE;
672 
673     /* Create the control device */
674     sc->acpi_dev_t = make_dev(&acpi_cdevsw, 0, UID_ROOT, GID_WHEEL, 0644,
675 			      "acpi");
676     sc->acpi_dev_t->si_drv1 = sc;
677 
678     if ((error = acpi_machdep_init(dev)))
679 	goto out;
680 
681     /* Register ACPI again to pass the correct argument of pm_func. */
682     power_pm_register(POWER_PM_TYPE_ACPI, acpi_pm_func, sc);
683 
684     if (!acpi_disabled("bus")) {
685 	EVENTHANDLER_REGISTER(dev_lookup, acpi_lookup, NULL, 1000);
686 	acpi_probe_children(dev);
687     }
688 
689     /* Update all GPEs and enable runtime GPEs. */
690     status = AcpiUpdateAllGpes();
691     if (ACPI_FAILURE(status))
692 	device_printf(dev, "Could not update all GPEs: %s\n",
693 	    AcpiFormatException(status));
694 
695     /* Allow sleep request after a while. */
696     callout_init_mtx(&acpi_sleep_timer, &acpi_mutex, 0);
697     callout_reset(&acpi_sleep_timer, hz * ACPI_MINIMUM_AWAKETIME,
698 	acpi_sleep_enable, sc);
699 
700     error = 0;
701 
702  out:
703     return_VALUE (error);
704 }
705 
706 static void
707 acpi_set_power_children(device_t dev, int state)
708 {
709 	device_t child;
710 	device_t *devlist;
711 	int dstate, i, numdevs;
712 
713 	if (device_get_children(dev, &devlist, &numdevs) != 0)
714 		return;
715 
716 	/*
717 	 * Retrieve and set D-state for the sleep state if _SxD is present.
718 	 * Skip children who aren't attached since they are handled separately.
719 	 */
720 	for (i = 0; i < numdevs; i++) {
721 		child = devlist[i];
722 		dstate = state;
723 		if (device_is_attached(child) &&
724 		    acpi_device_pwr_for_sleep(dev, child, &dstate) == 0)
725 			acpi_set_powerstate(child, dstate);
726 	}
727 	free(devlist, M_TEMP);
728 }
729 
730 static int
731 acpi_suspend(device_t dev)
732 {
733     int error;
734 
735     GIANT_REQUIRED;
736 
737     error = bus_generic_suspend(dev);
738     if (error == 0)
739 	acpi_set_power_children(dev, ACPI_STATE_D3);
740 
741     return (error);
742 }
743 
744 static int
745 acpi_resume(device_t dev)
746 {
747 
748     GIANT_REQUIRED;
749 
750     acpi_set_power_children(dev, ACPI_STATE_D0);
751 
752     return (bus_generic_resume(dev));
753 }
754 
755 static int
756 acpi_shutdown(device_t dev)
757 {
758 
759     GIANT_REQUIRED;
760 
761     /* Allow children to shutdown first. */
762     bus_generic_shutdown(dev);
763 
764     /*
765      * Enable any GPEs that are able to power-on the system (i.e., RTC).
766      * Also, disable any that are not valid for this state (most).
767      */
768     acpi_wake_prep_walk(ACPI_STATE_S5);
769 
770     return (0);
771 }
772 
773 /*
774  * Handle a new device being added
775  */
776 static device_t
777 acpi_add_child(device_t bus, u_int order, const char *name, int unit)
778 {
779     struct acpi_device	*ad;
780     device_t		child;
781 
782     if ((ad = malloc(sizeof(*ad), M_ACPIDEV, M_NOWAIT | M_ZERO)) == NULL)
783 	return (NULL);
784 
785     resource_list_init(&ad->ad_rl);
786 
787     child = device_add_child_ordered(bus, order, name, unit);
788     if (child != NULL)
789 	device_set_ivars(child, ad);
790     else
791 	free(ad, M_ACPIDEV);
792     return (child);
793 }
794 
795 static int
796 acpi_print_child(device_t bus, device_t child)
797 {
798     struct acpi_device	 *adev = device_get_ivars(child);
799     struct resource_list *rl = &adev->ad_rl;
800     int retval = 0;
801 
802     retval += bus_print_child_header(bus, child);
803     retval += resource_list_print_type(rl, "port",  SYS_RES_IOPORT, "%#jx");
804     retval += resource_list_print_type(rl, "iomem", SYS_RES_MEMORY, "%#jx");
805     retval += resource_list_print_type(rl, "irq",   SYS_RES_IRQ,    "%jd");
806     retval += resource_list_print_type(rl, "drq",   SYS_RES_DRQ,    "%jd");
807     if (device_get_flags(child))
808 	retval += printf(" flags %#x", device_get_flags(child));
809     retval += bus_print_child_domain(bus, child);
810     retval += bus_print_child_footer(bus, child);
811 
812     return (retval);
813 }
814 
815 /*
816  * If this device is an ACPI child but no one claimed it, attempt
817  * to power it off.  We'll power it back up when a driver is added.
818  *
819  * XXX Disabled for now since many necessary devices (like fdc and
820  * ATA) don't claim the devices we created for them but still expect
821  * them to be powered up.
822  */
823 static void
824 acpi_probe_nomatch(device_t bus, device_t child)
825 {
826 #ifdef ACPI_ENABLE_POWERDOWN_NODRIVER
827     acpi_set_powerstate(child, ACPI_STATE_D3);
828 #endif
829 }
830 
831 /*
832  * If a new driver has a chance to probe a child, first power it up.
833  *
834  * XXX Disabled for now (see acpi_probe_nomatch for details).
835  */
836 static void
837 acpi_driver_added(device_t dev, driver_t *driver)
838 {
839     device_t child, *devlist;
840     int i, numdevs;
841 
842     DEVICE_IDENTIFY(driver, dev);
843     if (device_get_children(dev, &devlist, &numdevs))
844 	    return;
845     for (i = 0; i < numdevs; i++) {
846 	child = devlist[i];
847 	if (device_get_state(child) == DS_NOTPRESENT) {
848 #ifdef ACPI_ENABLE_POWERDOWN_NODRIVER
849 	    acpi_set_powerstate(child, ACPI_STATE_D0);
850 	    if (device_probe_and_attach(child) != 0)
851 		acpi_set_powerstate(child, ACPI_STATE_D3);
852 #else
853 	    device_probe_and_attach(child);
854 #endif
855 	}
856     }
857     free(devlist, M_TEMP);
858 }
859 
860 /* Location hint for devctl(8) */
861 static int
862 acpi_child_location_str_method(device_t cbdev, device_t child, char *buf,
863     size_t buflen)
864 {
865     struct acpi_device *dinfo = device_get_ivars(child);
866     char buf2[32];
867     int pxm;
868 
869     if (dinfo->ad_handle) {
870         snprintf(buf, buflen, "handle=%s", acpi_name(dinfo->ad_handle));
871         if (ACPI_SUCCESS(acpi_GetInteger(dinfo->ad_handle, "_PXM", &pxm))) {
872                 snprintf(buf2, 32, " _PXM=%d", pxm);
873                 strlcat(buf, buf2, buflen);
874         }
875     } else {
876         snprintf(buf, buflen, "unknown");
877     }
878     return (0);
879 }
880 
881 /* PnP information for devctl(8) */
882 static int
883 acpi_child_pnpinfo_str_method(device_t cbdev, device_t child, char *buf,
884     size_t buflen)
885 {
886     struct acpi_device *dinfo = device_get_ivars(child);
887     ACPI_DEVICE_INFO *adinfo;
888 
889     if (ACPI_FAILURE(AcpiGetObjectInfo(dinfo->ad_handle, &adinfo))) {
890 	snprintf(buf, buflen, "unknown");
891 	return (0);
892     }
893 
894     snprintf(buf, buflen, "_HID=%s _UID=%lu",
895 	(adinfo->Valid & ACPI_VALID_HID) ?
896 	adinfo->HardwareId.String : "none",
897 	(adinfo->Valid & ACPI_VALID_UID) ?
898 	strtoul(adinfo->UniqueId.String, NULL, 10) : 0UL);
899     AcpiOsFree(adinfo);
900 
901     return (0);
902 }
903 
904 /*
905  * Handle per-device ivars
906  */
907 static int
908 acpi_read_ivar(device_t dev, device_t child, int index, uintptr_t *result)
909 {
910     struct acpi_device	*ad;
911 
912     if ((ad = device_get_ivars(child)) == NULL) {
913 	device_printf(child, "device has no ivars\n");
914 	return (ENOENT);
915     }
916 
917     /* ACPI and ISA compatibility ivars */
918     switch(index) {
919     case ACPI_IVAR_HANDLE:
920 	*(ACPI_HANDLE *)result = ad->ad_handle;
921 	break;
922     case ACPI_IVAR_PRIVATE:
923 	*(void **)result = ad->ad_private;
924 	break;
925     case ACPI_IVAR_FLAGS:
926 	*(int *)result = ad->ad_flags;
927 	break;
928     case ISA_IVAR_VENDORID:
929     case ISA_IVAR_SERIAL:
930     case ISA_IVAR_COMPATID:
931 	*(int *)result = -1;
932 	break;
933     case ISA_IVAR_LOGICALID:
934 	*(int *)result = acpi_isa_get_logicalid(child);
935 	break;
936     case PCI_IVAR_CLASS:
937 	*(uint8_t*)result = (ad->ad_cls_class >> 16) & 0xff;
938 	break;
939     case PCI_IVAR_SUBCLASS:
940 	*(uint8_t*)result = (ad->ad_cls_class >> 8) & 0xff;
941 	break;
942     case PCI_IVAR_PROGIF:
943 	*(uint8_t*)result = (ad->ad_cls_class >> 0) & 0xff;
944 	break;
945     default:
946 	return (ENOENT);
947     }
948 
949     return (0);
950 }
951 
952 static int
953 acpi_write_ivar(device_t dev, device_t child, int index, uintptr_t value)
954 {
955     struct acpi_device	*ad;
956 
957     if ((ad = device_get_ivars(child)) == NULL) {
958 	device_printf(child, "device has no ivars\n");
959 	return (ENOENT);
960     }
961 
962     switch(index) {
963     case ACPI_IVAR_HANDLE:
964 	ad->ad_handle = (ACPI_HANDLE)value;
965 	break;
966     case ACPI_IVAR_PRIVATE:
967 	ad->ad_private = (void *)value;
968 	break;
969     case ACPI_IVAR_FLAGS:
970 	ad->ad_flags = (int)value;
971 	break;
972     default:
973 	panic("bad ivar write request (%d)", index);
974 	return (ENOENT);
975     }
976 
977     return (0);
978 }
979 
980 /*
981  * Handle child resource allocation/removal
982  */
983 static struct resource_list *
984 acpi_get_rlist(device_t dev, device_t child)
985 {
986     struct acpi_device		*ad;
987 
988     ad = device_get_ivars(child);
989     return (&ad->ad_rl);
990 }
991 
992 static int
993 acpi_match_resource_hint(device_t dev, int type, long value)
994 {
995     struct acpi_device *ad = device_get_ivars(dev);
996     struct resource_list *rl = &ad->ad_rl;
997     struct resource_list_entry *rle;
998 
999     STAILQ_FOREACH(rle, rl, link) {
1000 	if (rle->type != type)
1001 	    continue;
1002 	if (rle->start <= value && rle->end >= value)
1003 	    return (1);
1004     }
1005     return (0);
1006 }
1007 
1008 /*
1009  * Wire device unit numbers based on resource matches in hints.
1010  */
1011 static void
1012 acpi_hint_device_unit(device_t acdev, device_t child, const char *name,
1013     int *unitp)
1014 {
1015     const char *s;
1016     long value;
1017     int line, matches, unit;
1018 
1019     /*
1020      * Iterate over all the hints for the devices with the specified
1021      * name to see if one's resources are a subset of this device.
1022      */
1023     line = 0;
1024     while (resource_find_dev(&line, name, &unit, "at", NULL) == 0) {
1025 	/* Must have an "at" for acpi or isa. */
1026 	resource_string_value(name, unit, "at", &s);
1027 	if (!(strcmp(s, "acpi0") == 0 || strcmp(s, "acpi") == 0 ||
1028 	    strcmp(s, "isa0") == 0 || strcmp(s, "isa") == 0))
1029 	    continue;
1030 
1031 	/*
1032 	 * Check for matching resources.  We must have at least one match.
1033 	 * Since I/O and memory resources cannot be shared, if we get a
1034 	 * match on either of those, ignore any mismatches in IRQs or DRQs.
1035 	 *
1036 	 * XXX: We may want to revisit this to be more lenient and wire
1037 	 * as long as it gets one match.
1038 	 */
1039 	matches = 0;
1040 	if (resource_long_value(name, unit, "port", &value) == 0) {
1041 	    /*
1042 	     * Floppy drive controllers are notorious for having a
1043 	     * wide variety of resources not all of which include the
1044 	     * first port that is specified by the hint (typically
1045 	     * 0x3f0) (see the comment above fdc_isa_alloc_resources()
1046 	     * in fdc_isa.c).  However, they do all seem to include
1047 	     * port + 2 (e.g. 0x3f2) so for a floppy device, look for
1048 	     * 'value + 2' in the port resources instead of the hint
1049 	     * value.
1050 	     */
1051 	    if (strcmp(name, "fdc") == 0)
1052 		value += 2;
1053 	    if (acpi_match_resource_hint(child, SYS_RES_IOPORT, value))
1054 		matches++;
1055 	    else
1056 		continue;
1057 	}
1058 	if (resource_long_value(name, unit, "maddr", &value) == 0) {
1059 	    if (acpi_match_resource_hint(child, SYS_RES_MEMORY, value))
1060 		matches++;
1061 	    else
1062 		continue;
1063 	}
1064 	if (matches > 0)
1065 	    goto matched;
1066 	if (resource_long_value(name, unit, "irq", &value) == 0) {
1067 	    if (acpi_match_resource_hint(child, SYS_RES_IRQ, value))
1068 		matches++;
1069 	    else
1070 		continue;
1071 	}
1072 	if (resource_long_value(name, unit, "drq", &value) == 0) {
1073 	    if (acpi_match_resource_hint(child, SYS_RES_DRQ, value))
1074 		matches++;
1075 	    else
1076 		continue;
1077 	}
1078 
1079     matched:
1080 	if (matches > 0) {
1081 	    /* We have a winner! */
1082 	    *unitp = unit;
1083 	    break;
1084 	}
1085     }
1086 }
1087 
1088 /*
1089  * Fetch the NUMA domain for a device by mapping the value returned by
1090  * _PXM to a NUMA domain.  If the device does not have a _PXM method,
1091  * -2 is returned.  If any other error occurs, -1 is returned.
1092  */
1093 static int
1094 acpi_parse_pxm(device_t dev)
1095 {
1096 #ifdef NUMA
1097 	ACPI_HANDLE handle;
1098 	ACPI_STATUS status;
1099 	int pxm;
1100 
1101 	handle = acpi_get_handle(dev);
1102 	if (handle == NULL)
1103 		return (-2);
1104 	status = acpi_GetInteger(handle, "_PXM", &pxm);
1105 	if (ACPI_SUCCESS(status))
1106 		return (acpi_map_pxm_to_vm_domainid(pxm));
1107 	if (status == AE_NOT_FOUND)
1108 		return (-2);
1109 #endif
1110 	return (-1);
1111 }
1112 
1113 int
1114 acpi_get_cpus(device_t dev, device_t child, enum cpu_sets op, size_t setsize,
1115     cpuset_t *cpuset)
1116 {
1117 	int d, error;
1118 
1119 	d = acpi_parse_pxm(child);
1120 	if (d < 0)
1121 		return (bus_generic_get_cpus(dev, child, op, setsize, cpuset));
1122 
1123 	switch (op) {
1124 	case LOCAL_CPUS:
1125 		if (setsize != sizeof(cpuset_t))
1126 			return (EINVAL);
1127 		*cpuset = cpuset_domain[d];
1128 		return (0);
1129 	case INTR_CPUS:
1130 		error = bus_generic_get_cpus(dev, child, op, setsize, cpuset);
1131 		if (error != 0)
1132 			return (error);
1133 		if (setsize != sizeof(cpuset_t))
1134 			return (EINVAL);
1135 		CPU_AND(cpuset, &cpuset_domain[d]);
1136 		return (0);
1137 	default:
1138 		return (bus_generic_get_cpus(dev, child, op, setsize, cpuset));
1139 	}
1140 }
1141 
1142 /*
1143  * Fetch the NUMA domain for the given device 'dev'.
1144  *
1145  * If a device has a _PXM method, map that to a NUMA domain.
1146  * Otherwise, pass the request up to the parent.
1147  * If there's no matching domain or the domain cannot be
1148  * determined, return ENOENT.
1149  */
1150 int
1151 acpi_get_domain(device_t dev, device_t child, int *domain)
1152 {
1153 	int d;
1154 
1155 	d = acpi_parse_pxm(child);
1156 	if (d >= 0) {
1157 		*domain = d;
1158 		return (0);
1159 	}
1160 	if (d == -1)
1161 		return (ENOENT);
1162 
1163 	/* No _PXM node; go up a level */
1164 	return (bus_generic_get_domain(dev, child, domain));
1165 }
1166 
1167 /*
1168  * Pre-allocate/manage all memory and IO resources.  Since rman can't handle
1169  * duplicates, we merge any in the sysresource attach routine.
1170  */
1171 static int
1172 acpi_sysres_alloc(device_t dev)
1173 {
1174     struct resource *res;
1175     struct resource_list *rl;
1176     struct resource_list_entry *rle;
1177     struct rman *rm;
1178     device_t *children;
1179     int child_count, i;
1180 
1181     /*
1182      * Probe/attach any sysresource devices.  This would be unnecessary if we
1183      * had multi-pass probe/attach.
1184      */
1185     if (device_get_children(dev, &children, &child_count) != 0)
1186 	return (ENXIO);
1187     for (i = 0; i < child_count; i++) {
1188 	if (ACPI_ID_PROBE(dev, children[i], sysres_ids) != NULL)
1189 	    device_probe_and_attach(children[i]);
1190     }
1191     free(children, M_TEMP);
1192 
1193     rl = BUS_GET_RESOURCE_LIST(device_get_parent(dev), dev);
1194     STAILQ_FOREACH(rle, rl, link) {
1195 	if (rle->res != NULL) {
1196 	    device_printf(dev, "duplicate resource for %jx\n", rle->start);
1197 	    continue;
1198 	}
1199 
1200 	/* Only memory and IO resources are valid here. */
1201 	switch (rle->type) {
1202 	case SYS_RES_IOPORT:
1203 	    rm = &acpi_rman_io;
1204 	    break;
1205 	case SYS_RES_MEMORY:
1206 	    rm = &acpi_rman_mem;
1207 	    break;
1208 	default:
1209 	    continue;
1210 	}
1211 
1212 	/* Pre-allocate resource and add to our rman pool. */
1213 	res = BUS_ALLOC_RESOURCE(device_get_parent(dev), dev, rle->type,
1214 	    &rle->rid, rle->start, rle->start + rle->count - 1, rle->count, 0);
1215 	if (res != NULL) {
1216 	    rman_manage_region(rm, rman_get_start(res), rman_get_end(res));
1217 	    rle->res = res;
1218 	} else if (bootverbose)
1219 	    device_printf(dev, "reservation of %jx, %jx (%d) failed\n",
1220 		rle->start, rle->count, rle->type);
1221     }
1222     return (0);
1223 }
1224 
1225 /*
1226  * Reserve declared resources for devices found during attach once system
1227  * resources have been allocated.
1228  */
1229 static void
1230 acpi_reserve_resources(device_t dev)
1231 {
1232     struct resource_list_entry *rle;
1233     struct resource_list *rl;
1234     struct acpi_device *ad;
1235     struct acpi_softc *sc;
1236     device_t *children;
1237     int child_count, i;
1238 
1239     sc = device_get_softc(dev);
1240     if (device_get_children(dev, &children, &child_count) != 0)
1241 	return;
1242     for (i = 0; i < child_count; i++) {
1243 	ad = device_get_ivars(children[i]);
1244 	rl = &ad->ad_rl;
1245 
1246 	/* Don't reserve system resources. */
1247 	if (ACPI_ID_PROBE(dev, children[i], sysres_ids) != NULL)
1248 	    continue;
1249 
1250 	STAILQ_FOREACH(rle, rl, link) {
1251 	    /*
1252 	     * Don't reserve IRQ resources.  There are many sticky things
1253 	     * to get right otherwise (e.g. IRQs for psm, atkbd, and HPET
1254 	     * when using legacy routing).
1255 	     */
1256 	    if (rle->type == SYS_RES_IRQ)
1257 		continue;
1258 
1259 	    /*
1260 	     * Don't reserve the resource if it is already allocated.
1261 	     * The acpi_ec(4) driver can allocate its resources early
1262 	     * if ECDT is present.
1263 	     */
1264 	    if (rle->res != NULL)
1265 		continue;
1266 
1267 	    /*
1268 	     * Try to reserve the resource from our parent.  If this
1269 	     * fails because the resource is a system resource, just
1270 	     * let it be.  The resource range is already reserved so
1271 	     * that other devices will not use it.  If the driver
1272 	     * needs to allocate the resource, then
1273 	     * acpi_alloc_resource() will sub-alloc from the system
1274 	     * resource.
1275 	     */
1276 	    resource_list_reserve(rl, dev, children[i], rle->type, &rle->rid,
1277 		rle->start, rle->end, rle->count, 0);
1278 	}
1279     }
1280     free(children, M_TEMP);
1281     sc->acpi_resources_reserved = 1;
1282 }
1283 
1284 static int
1285 acpi_set_resource(device_t dev, device_t child, int type, int rid,
1286     rman_res_t start, rman_res_t count)
1287 {
1288     struct acpi_softc *sc = device_get_softc(dev);
1289     struct acpi_device *ad = device_get_ivars(child);
1290     struct resource_list *rl = &ad->ad_rl;
1291 #if defined(__i386__) || defined(__amd64__)
1292     ACPI_DEVICE_INFO *devinfo;
1293 #endif
1294     rman_res_t end;
1295 
1296     /* Ignore IRQ resources for PCI link devices. */
1297     if (type == SYS_RES_IRQ && ACPI_ID_PROBE(dev, child, pcilink_ids) != NULL)
1298 	return (0);
1299 
1300     /*
1301      * Ignore most resources for PCI root bridges.  Some BIOSes
1302      * incorrectly enumerate the memory ranges they decode as plain
1303      * memory resources instead of as ResourceProducer ranges.  Other
1304      * BIOSes incorrectly list system resource entries for I/O ranges
1305      * under the PCI bridge.  Do allow the one known-correct case on
1306      * x86 of a PCI bridge claiming the I/O ports used for PCI config
1307      * access.
1308      */
1309 #if defined(__i386__) || defined(__amd64__)
1310     if (type == SYS_RES_MEMORY || type == SYS_RES_IOPORT) {
1311 	if (ACPI_SUCCESS(AcpiGetObjectInfo(ad->ad_handle, &devinfo))) {
1312 	    if ((devinfo->Flags & ACPI_PCI_ROOT_BRIDGE) != 0) {
1313 		if (!(type == SYS_RES_IOPORT && start == CONF1_ADDR_PORT)) {
1314 		    AcpiOsFree(devinfo);
1315 		    return (0);
1316 		}
1317 	    }
1318 	    AcpiOsFree(devinfo);
1319 	}
1320     }
1321 #endif
1322 
1323     /* If the resource is already allocated, fail. */
1324     if (resource_list_busy(rl, type, rid))
1325 	return (EBUSY);
1326 
1327     /* If the resource is already reserved, release it. */
1328     if (resource_list_reserved(rl, type, rid))
1329 	resource_list_unreserve(rl, dev, child, type, rid);
1330 
1331     /* Add the resource. */
1332     end = (start + count - 1);
1333     resource_list_add(rl, type, rid, start, end, count);
1334 
1335     /* Don't reserve resources until the system resources are allocated. */
1336     if (!sc->acpi_resources_reserved)
1337 	return (0);
1338 
1339     /* Don't reserve system resources. */
1340     if (ACPI_ID_PROBE(dev, child, sysres_ids) != NULL)
1341 	return (0);
1342 
1343     /*
1344      * Don't reserve IRQ resources.  There are many sticky things to
1345      * get right otherwise (e.g. IRQs for psm, atkbd, and HPET when
1346      * using legacy routing).
1347      */
1348     if (type == SYS_RES_IRQ)
1349 	return (0);
1350 
1351     /*
1352      * Reserve the resource.
1353      *
1354      * XXX: Ignores failure for now.  Failure here is probably a
1355      * BIOS/firmware bug?
1356      */
1357     resource_list_reserve(rl, dev, child, type, &rid, start, end, count, 0);
1358     return (0);
1359 }
1360 
1361 static struct resource *
1362 acpi_alloc_resource(device_t bus, device_t child, int type, int *rid,
1363     rman_res_t start, rman_res_t end, rman_res_t count, u_int flags)
1364 {
1365 #ifndef INTRNG
1366     ACPI_RESOURCE ares;
1367 #endif
1368     struct acpi_device *ad;
1369     struct resource_list_entry *rle;
1370     struct resource_list *rl;
1371     struct resource *res;
1372     int isdefault = RMAN_IS_DEFAULT_RANGE(start, end);
1373 
1374     /*
1375      * First attempt at allocating the resource.  For direct children,
1376      * use resource_list_alloc() to handle reserved resources.  For
1377      * other devices, pass the request up to our parent.
1378      */
1379     if (bus == device_get_parent(child)) {
1380 	ad = device_get_ivars(child);
1381 	rl = &ad->ad_rl;
1382 
1383 	/*
1384 	 * Simulate the behavior of the ISA bus for direct children
1385 	 * devices.  That is, if a non-default range is specified for
1386 	 * a resource that doesn't exist, use bus_set_resource() to
1387 	 * add the resource before allocating it.  Note that these
1388 	 * resources will not be reserved.
1389 	 */
1390 	if (!isdefault && resource_list_find(rl, type, *rid) == NULL)
1391 		resource_list_add(rl, type, *rid, start, end, count);
1392 	res = resource_list_alloc(rl, bus, child, type, rid, start, end, count,
1393 	    flags);
1394 #ifndef INTRNG
1395 	if (res != NULL && type == SYS_RES_IRQ) {
1396 	    /*
1397 	     * Since bus_config_intr() takes immediate effect, we cannot
1398 	     * configure the interrupt associated with a device when we
1399 	     * parse the resources but have to defer it until a driver
1400 	     * actually allocates the interrupt via bus_alloc_resource().
1401 	     *
1402 	     * XXX: Should we handle the lookup failing?
1403 	     */
1404 	    if (ACPI_SUCCESS(acpi_lookup_irq_resource(child, *rid, res, &ares)))
1405 		acpi_config_intr(child, &ares);
1406 	}
1407 #endif
1408 
1409 	/*
1410 	 * If this is an allocation of the "default" range for a given
1411 	 * RID, fetch the exact bounds for this resource from the
1412 	 * resource list entry to try to allocate the range from the
1413 	 * system resource regions.
1414 	 */
1415 	if (res == NULL && isdefault) {
1416 	    rle = resource_list_find(rl, type, *rid);
1417 	    if (rle != NULL) {
1418 		start = rle->start;
1419 		end = rle->end;
1420 		count = rle->count;
1421 	    }
1422 	}
1423     } else
1424 	res = BUS_ALLOC_RESOURCE(device_get_parent(bus), child, type, rid,
1425 	    start, end, count, flags);
1426 
1427     /*
1428      * If the first attempt failed and this is an allocation of a
1429      * specific range, try to satisfy the request via a suballocation
1430      * from our system resource regions.
1431      */
1432     if (res == NULL && start + count - 1 == end)
1433 	res = acpi_alloc_sysres(child, type, rid, start, end, count, flags);
1434     return (res);
1435 }
1436 
1437 /*
1438  * Attempt to allocate a specific resource range from the system
1439  * resource ranges.  Note that we only handle memory and I/O port
1440  * system resources.
1441  */
1442 struct resource *
1443 acpi_alloc_sysres(device_t child, int type, int *rid, rman_res_t start,
1444     rman_res_t end, rman_res_t count, u_int flags)
1445 {
1446     struct rman *rm;
1447     struct resource *res;
1448 
1449     switch (type) {
1450     case SYS_RES_IOPORT:
1451 	rm = &acpi_rman_io;
1452 	break;
1453     case SYS_RES_MEMORY:
1454 	rm = &acpi_rman_mem;
1455 	break;
1456     default:
1457 	return (NULL);
1458     }
1459 
1460     KASSERT(start + count - 1 == end, ("wildcard resource range"));
1461     res = rman_reserve_resource(rm, start, end, count, flags & ~RF_ACTIVE,
1462 	child);
1463     if (res == NULL)
1464 	return (NULL);
1465 
1466     rman_set_rid(res, *rid);
1467 
1468     /* If requested, activate the resource using the parent's method. */
1469     if (flags & RF_ACTIVE)
1470 	if (bus_activate_resource(child, type, *rid, res) != 0) {
1471 	    rman_release_resource(res);
1472 	    return (NULL);
1473 	}
1474 
1475     return (res);
1476 }
1477 
1478 static int
1479 acpi_is_resource_managed(int type, struct resource *r)
1480 {
1481 
1482     /* We only handle memory and IO resources through rman. */
1483     switch (type) {
1484     case SYS_RES_IOPORT:
1485 	return (rman_is_region_manager(r, &acpi_rman_io));
1486     case SYS_RES_MEMORY:
1487 	return (rman_is_region_manager(r, &acpi_rman_mem));
1488     }
1489     return (0);
1490 }
1491 
1492 static int
1493 acpi_adjust_resource(device_t bus, device_t child, int type, struct resource *r,
1494     rman_res_t start, rman_res_t end)
1495 {
1496 
1497     if (acpi_is_resource_managed(type, r))
1498 	return (rman_adjust_resource(r, start, end));
1499     return (bus_generic_adjust_resource(bus, child, type, r, start, end));
1500 }
1501 
1502 static int
1503 acpi_release_resource(device_t bus, device_t child, int type, int rid,
1504     struct resource *r)
1505 {
1506     int ret;
1507 
1508     /*
1509      * If this resource belongs to one of our internal managers,
1510      * deactivate it and release it to the local pool.
1511      */
1512     if (acpi_is_resource_managed(type, r)) {
1513 	if (rman_get_flags(r) & RF_ACTIVE) {
1514 	    ret = bus_deactivate_resource(child, type, rid, r);
1515 	    if (ret != 0)
1516 		return (ret);
1517 	}
1518 	return (rman_release_resource(r));
1519     }
1520 
1521     return (bus_generic_rl_release_resource(bus, child, type, rid, r));
1522 }
1523 
1524 static void
1525 acpi_delete_resource(device_t bus, device_t child, int type, int rid)
1526 {
1527     struct resource_list *rl;
1528 
1529     rl = acpi_get_rlist(bus, child);
1530     if (resource_list_busy(rl, type, rid)) {
1531 	device_printf(bus, "delete_resource: Resource still owned by child"
1532 	    " (type=%d, rid=%d)\n", type, rid);
1533 	return;
1534     }
1535     resource_list_unreserve(rl, bus, child, type, rid);
1536     resource_list_delete(rl, type, rid);
1537 }
1538 
1539 /* Allocate an IO port or memory resource, given its GAS. */
1540 int
1541 acpi_bus_alloc_gas(device_t dev, int *type, int *rid, ACPI_GENERIC_ADDRESS *gas,
1542     struct resource **res, u_int flags)
1543 {
1544     int error, res_type;
1545 
1546     error = ENOMEM;
1547     if (type == NULL || rid == NULL || gas == NULL || res == NULL)
1548 	return (EINVAL);
1549 
1550     /* We only support memory and IO spaces. */
1551     switch (gas->SpaceId) {
1552     case ACPI_ADR_SPACE_SYSTEM_MEMORY:
1553 	res_type = SYS_RES_MEMORY;
1554 	break;
1555     case ACPI_ADR_SPACE_SYSTEM_IO:
1556 	res_type = SYS_RES_IOPORT;
1557 	break;
1558     default:
1559 	return (EOPNOTSUPP);
1560     }
1561 
1562     /*
1563      * If the register width is less than 8, assume the BIOS author means
1564      * it is a bit field and just allocate a byte.
1565      */
1566     if (gas->BitWidth && gas->BitWidth < 8)
1567 	gas->BitWidth = 8;
1568 
1569     /* Validate the address after we're sure we support the space. */
1570     if (gas->Address == 0 || gas->BitWidth == 0)
1571 	return (EINVAL);
1572 
1573     bus_set_resource(dev, res_type, *rid, gas->Address,
1574 	gas->BitWidth / 8);
1575     *res = bus_alloc_resource_any(dev, res_type, rid, RF_ACTIVE | flags);
1576     if (*res != NULL) {
1577 	*type = res_type;
1578 	error = 0;
1579     } else
1580 	bus_delete_resource(dev, res_type, *rid);
1581 
1582     return (error);
1583 }
1584 
1585 /* Probe _HID and _CID for compatible ISA PNP ids. */
1586 static uint32_t
1587 acpi_isa_get_logicalid(device_t dev)
1588 {
1589     ACPI_DEVICE_INFO	*devinfo;
1590     ACPI_HANDLE		h;
1591     uint32_t		pnpid;
1592 
1593     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
1594 
1595     /* Fetch and validate the HID. */
1596     if ((h = acpi_get_handle(dev)) == NULL ||
1597 	ACPI_FAILURE(AcpiGetObjectInfo(h, &devinfo)))
1598 	return_VALUE (0);
1599 
1600     pnpid = (devinfo->Valid & ACPI_VALID_HID) != 0 &&
1601 	devinfo->HardwareId.Length >= ACPI_EISAID_STRING_SIZE ?
1602 	PNP_EISAID(devinfo->HardwareId.String) : 0;
1603     AcpiOsFree(devinfo);
1604 
1605     return_VALUE (pnpid);
1606 }
1607 
1608 static int
1609 acpi_isa_get_compatid(device_t dev, uint32_t *cids, int count)
1610 {
1611     ACPI_DEVICE_INFO	*devinfo;
1612     ACPI_PNP_DEVICE_ID	*ids;
1613     ACPI_HANDLE		h;
1614     uint32_t		*pnpid;
1615     int			i, valid;
1616 
1617     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
1618 
1619     pnpid = cids;
1620 
1621     /* Fetch and validate the CID */
1622     if ((h = acpi_get_handle(dev)) == NULL ||
1623 	ACPI_FAILURE(AcpiGetObjectInfo(h, &devinfo)))
1624 	return_VALUE (0);
1625 
1626     if ((devinfo->Valid & ACPI_VALID_CID) == 0) {
1627 	AcpiOsFree(devinfo);
1628 	return_VALUE (0);
1629     }
1630 
1631     if (devinfo->CompatibleIdList.Count < count)
1632 	count = devinfo->CompatibleIdList.Count;
1633     ids = devinfo->CompatibleIdList.Ids;
1634     for (i = 0, valid = 0; i < count; i++)
1635 	if (ids[i].Length >= ACPI_EISAID_STRING_SIZE &&
1636 	    strncmp(ids[i].String, "PNP", 3) == 0) {
1637 	    *pnpid++ = PNP_EISAID(ids[i].String);
1638 	    valid++;
1639 	}
1640     AcpiOsFree(devinfo);
1641 
1642     return_VALUE (valid);
1643 }
1644 
1645 static char *
1646 acpi_device_id_probe(device_t bus, device_t dev, char **ids)
1647 {
1648     ACPI_HANDLE h;
1649     ACPI_OBJECT_TYPE t;
1650     int i;
1651 
1652     h = acpi_get_handle(dev);
1653     if (ids == NULL || h == NULL)
1654 	return (NULL);
1655     t = acpi_get_type(dev);
1656     if (t != ACPI_TYPE_DEVICE && t != ACPI_TYPE_PROCESSOR)
1657 	return (NULL);
1658 
1659     /* Try to match one of the array of IDs with a HID or CID. */
1660     for (i = 0; ids[i] != NULL; i++) {
1661 	if (acpi_MatchHid(h, ids[i]))
1662 	    return (ids[i]);
1663     }
1664     return (NULL);
1665 }
1666 
1667 static ACPI_STATUS
1668 acpi_device_eval_obj(device_t bus, device_t dev, ACPI_STRING pathname,
1669     ACPI_OBJECT_LIST *parameters, ACPI_BUFFER *ret)
1670 {
1671     ACPI_HANDLE h;
1672 
1673     if (dev == NULL)
1674 	h = ACPI_ROOT_OBJECT;
1675     else if ((h = acpi_get_handle(dev)) == NULL)
1676 	return (AE_BAD_PARAMETER);
1677     return (AcpiEvaluateObject(h, pathname, parameters, ret));
1678 }
1679 
1680 int
1681 acpi_device_pwr_for_sleep(device_t bus, device_t dev, int *dstate)
1682 {
1683     struct acpi_softc *sc;
1684     ACPI_HANDLE handle;
1685     ACPI_STATUS status;
1686     char sxd[8];
1687 
1688     handle = acpi_get_handle(dev);
1689 
1690     /*
1691      * XXX If we find these devices, don't try to power them down.
1692      * The serial and IRDA ports on my T23 hang the system when
1693      * set to D3 and it appears that such legacy devices may
1694      * need special handling in their drivers.
1695      */
1696     if (dstate == NULL || handle == NULL ||
1697 	acpi_MatchHid(handle, "PNP0500") ||
1698 	acpi_MatchHid(handle, "PNP0501") ||
1699 	acpi_MatchHid(handle, "PNP0502") ||
1700 	acpi_MatchHid(handle, "PNP0510") ||
1701 	acpi_MatchHid(handle, "PNP0511"))
1702 	return (ENXIO);
1703 
1704     /*
1705      * Override next state with the value from _SxD, if present.
1706      * Note illegal _S0D is evaluated because some systems expect this.
1707      */
1708     sc = device_get_softc(bus);
1709     snprintf(sxd, sizeof(sxd), "_S%dD", sc->acpi_sstate);
1710     status = acpi_GetInteger(handle, sxd, dstate);
1711     if (ACPI_FAILURE(status) && status != AE_NOT_FOUND) {
1712 	    device_printf(dev, "failed to get %s on %s: %s\n", sxd,
1713 		acpi_name(handle), AcpiFormatException(status));
1714 	    return (ENXIO);
1715     }
1716 
1717     return (0);
1718 }
1719 
1720 /* Callback arg for our implementation of walking the namespace. */
1721 struct acpi_device_scan_ctx {
1722     acpi_scan_cb_t	user_fn;
1723     void		*arg;
1724     ACPI_HANDLE		parent;
1725 };
1726 
1727 static ACPI_STATUS
1728 acpi_device_scan_cb(ACPI_HANDLE h, UINT32 level, void *arg, void **retval)
1729 {
1730     struct acpi_device_scan_ctx *ctx;
1731     device_t dev, old_dev;
1732     ACPI_STATUS status;
1733     ACPI_OBJECT_TYPE type;
1734 
1735     /*
1736      * Skip this device if we think we'll have trouble with it or it is
1737      * the parent where the scan began.
1738      */
1739     ctx = (struct acpi_device_scan_ctx *)arg;
1740     if (acpi_avoid(h) || h == ctx->parent)
1741 	return (AE_OK);
1742 
1743     /* If this is not a valid device type (e.g., a method), skip it. */
1744     if (ACPI_FAILURE(AcpiGetType(h, &type)))
1745 	return (AE_OK);
1746     if (type != ACPI_TYPE_DEVICE && type != ACPI_TYPE_PROCESSOR &&
1747 	type != ACPI_TYPE_THERMAL && type != ACPI_TYPE_POWER)
1748 	return (AE_OK);
1749 
1750     /*
1751      * Call the user function with the current device.  If it is unchanged
1752      * afterwards, return.  Otherwise, we update the handle to the new dev.
1753      */
1754     old_dev = acpi_get_device(h);
1755     dev = old_dev;
1756     status = ctx->user_fn(h, &dev, level, ctx->arg);
1757     if (ACPI_FAILURE(status) || old_dev == dev)
1758 	return (status);
1759 
1760     /* Remove the old child and its connection to the handle. */
1761     if (old_dev != NULL) {
1762 	device_delete_child(device_get_parent(old_dev), old_dev);
1763 	AcpiDetachData(h, acpi_fake_objhandler);
1764     }
1765 
1766     /* Recreate the handle association if the user created a device. */
1767     if (dev != NULL)
1768 	AcpiAttachData(h, acpi_fake_objhandler, dev);
1769 
1770     return (AE_OK);
1771 }
1772 
1773 static ACPI_STATUS
1774 acpi_device_scan_children(device_t bus, device_t dev, int max_depth,
1775     acpi_scan_cb_t user_fn, void *arg)
1776 {
1777     ACPI_HANDLE h;
1778     struct acpi_device_scan_ctx ctx;
1779 
1780     if (acpi_disabled("children"))
1781 	return (AE_OK);
1782 
1783     if (dev == NULL)
1784 	h = ACPI_ROOT_OBJECT;
1785     else if ((h = acpi_get_handle(dev)) == NULL)
1786 	return (AE_BAD_PARAMETER);
1787     ctx.user_fn = user_fn;
1788     ctx.arg = arg;
1789     ctx.parent = h;
1790     return (AcpiWalkNamespace(ACPI_TYPE_ANY, h, max_depth,
1791 	acpi_device_scan_cb, NULL, &ctx, NULL));
1792 }
1793 
1794 /*
1795  * Even though ACPI devices are not PCI, we use the PCI approach for setting
1796  * device power states since it's close enough to ACPI.
1797  */
1798 static int
1799 acpi_set_powerstate(device_t child, int state)
1800 {
1801     ACPI_HANDLE h;
1802     ACPI_STATUS status;
1803 
1804     h = acpi_get_handle(child);
1805     if (state < ACPI_STATE_D0 || state > ACPI_D_STATES_MAX)
1806 	return (EINVAL);
1807     if (h == NULL)
1808 	return (0);
1809 
1810     /* Ignore errors if the power methods aren't present. */
1811     status = acpi_pwr_switch_consumer(h, state);
1812     if (ACPI_SUCCESS(status)) {
1813 	if (bootverbose)
1814 	    device_printf(child, "set ACPI power state D%d on %s\n",
1815 		state, acpi_name(h));
1816     } else if (status != AE_NOT_FOUND)
1817 	device_printf(child,
1818 	    "failed to set ACPI power state D%d on %s: %s\n", state,
1819 	    acpi_name(h), AcpiFormatException(status));
1820 
1821     return (0);
1822 }
1823 
1824 static int
1825 acpi_isa_pnp_probe(device_t bus, device_t child, struct isa_pnp_id *ids)
1826 {
1827     int			result, cid_count, i;
1828     uint32_t		lid, cids[8];
1829 
1830     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
1831 
1832     /*
1833      * ISA-style drivers attached to ACPI may persist and
1834      * probe manually if we return ENOENT.  We never want
1835      * that to happen, so don't ever return it.
1836      */
1837     result = ENXIO;
1838 
1839     /* Scan the supplied IDs for a match */
1840     lid = acpi_isa_get_logicalid(child);
1841     cid_count = acpi_isa_get_compatid(child, cids, 8);
1842     while (ids && ids->ip_id) {
1843 	if (lid == ids->ip_id) {
1844 	    result = 0;
1845 	    goto out;
1846 	}
1847 	for (i = 0; i < cid_count; i++) {
1848 	    if (cids[i] == ids->ip_id) {
1849 		result = 0;
1850 		goto out;
1851 	    }
1852 	}
1853 	ids++;
1854     }
1855 
1856  out:
1857     if (result == 0 && ids->ip_desc)
1858 	device_set_desc(child, ids->ip_desc);
1859 
1860     return_VALUE (result);
1861 }
1862 
1863 #if defined(__i386__) || defined(__amd64__)
1864 /*
1865  * Look for a MCFG table.  If it is present, use the settings for
1866  * domain (segment) 0 to setup PCI config space access via the memory
1867  * map.
1868  */
1869 static void
1870 acpi_enable_pcie(void)
1871 {
1872 	ACPI_TABLE_HEADER *hdr;
1873 	ACPI_MCFG_ALLOCATION *alloc, *end;
1874 	ACPI_STATUS status;
1875 
1876 	status = AcpiGetTable(ACPI_SIG_MCFG, 1, &hdr);
1877 	if (ACPI_FAILURE(status))
1878 		return;
1879 
1880 	end = (ACPI_MCFG_ALLOCATION *)((char *)hdr + hdr->Length);
1881 	alloc = (ACPI_MCFG_ALLOCATION *)((ACPI_TABLE_MCFG *)hdr + 1);
1882 	while (alloc < end) {
1883 		if (alloc->PciSegment == 0) {
1884 			pcie_cfgregopen(alloc->Address, alloc->StartBusNumber,
1885 			    alloc->EndBusNumber);
1886 			return;
1887 		}
1888 		alloc++;
1889 	}
1890 }
1891 #elif defined(__aarch64__)
1892 static void
1893 acpi_enable_pcie(device_t child, int segment)
1894 {
1895 	ACPI_TABLE_HEADER *hdr;
1896 	ACPI_MCFG_ALLOCATION *alloc, *end;
1897 	ACPI_STATUS status;
1898 
1899 	status = AcpiGetTable(ACPI_SIG_MCFG, 1, &hdr);
1900 	if (ACPI_FAILURE(status))
1901 		return;
1902 
1903 	end = (ACPI_MCFG_ALLOCATION *)((char *)hdr + hdr->Length);
1904 	alloc = (ACPI_MCFG_ALLOCATION *)((ACPI_TABLE_MCFG *)hdr + 1);
1905 	while (alloc < end) {
1906 		if (alloc->PciSegment == segment) {
1907 			bus_set_resource(child, SYS_RES_MEMORY, 0,
1908 			    alloc->Address, 0x10000000);
1909 			return;
1910 		}
1911 		alloc++;
1912 	}
1913 }
1914 #endif
1915 
1916 /*
1917  * Scan all of the ACPI namespace and attach child devices.
1918  *
1919  * We should only expect to find devices in the \_PR, \_TZ, \_SI, and
1920  * \_SB scopes, and \_PR and \_TZ became obsolete in the ACPI 2.0 spec.
1921  * However, in violation of the spec, some systems place their PCI link
1922  * devices in \, so we have to walk the whole namespace.  We check the
1923  * type of namespace nodes, so this should be ok.
1924  */
1925 static void
1926 acpi_probe_children(device_t bus)
1927 {
1928 
1929     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
1930 
1931     /*
1932      * Scan the namespace and insert placeholders for all the devices that
1933      * we find.  We also probe/attach any early devices.
1934      *
1935      * Note that we use AcpiWalkNamespace rather than AcpiGetDevices because
1936      * we want to create nodes for all devices, not just those that are
1937      * currently present. (This assumes that we don't want to create/remove
1938      * devices as they appear, which might be smarter.)
1939      */
1940     ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "namespace scan\n"));
1941     AcpiWalkNamespace(ACPI_TYPE_ANY, ACPI_ROOT_OBJECT, 100, acpi_probe_child,
1942 	NULL, bus, NULL);
1943 
1944     /* Pre-allocate resources for our rman from any sysresource devices. */
1945     acpi_sysres_alloc(bus);
1946 
1947     /* Reserve resources already allocated to children. */
1948     acpi_reserve_resources(bus);
1949 
1950     /* Create any static children by calling device identify methods. */
1951     ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "device identify routines\n"));
1952     bus_generic_probe(bus);
1953 
1954     /* Probe/attach all children, created statically and from the namespace. */
1955     ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "acpi bus_generic_attach\n"));
1956     bus_generic_attach(bus);
1957 
1958     /* Attach wake sysctls. */
1959     acpi_wake_sysctl_walk(bus);
1960 
1961     ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "done attaching children\n"));
1962     return_VOID;
1963 }
1964 
1965 /*
1966  * Determine the probe order for a given device.
1967  */
1968 static void
1969 acpi_probe_order(ACPI_HANDLE handle, int *order)
1970 {
1971 	ACPI_OBJECT_TYPE type;
1972 
1973 	/*
1974 	 * 0. CPUs
1975 	 * 1. I/O port and memory system resource holders
1976 	 * 2. Clocks and timers (to handle early accesses)
1977 	 * 3. Embedded controllers (to handle early accesses)
1978 	 * 4. PCI Link Devices
1979 	 */
1980 	AcpiGetType(handle, &type);
1981 	if (type == ACPI_TYPE_PROCESSOR)
1982 		*order = 0;
1983 	else if (acpi_MatchHid(handle, "PNP0C01") ||
1984 	    acpi_MatchHid(handle, "PNP0C02"))
1985 		*order = 1;
1986 	else if (acpi_MatchHid(handle, "PNP0100") ||
1987 	    acpi_MatchHid(handle, "PNP0103") ||
1988 	    acpi_MatchHid(handle, "PNP0B00"))
1989 		*order = 2;
1990 	else if (acpi_MatchHid(handle, "PNP0C09"))
1991 		*order = 3;
1992 	else if (acpi_MatchHid(handle, "PNP0C0F"))
1993 		*order = 4;
1994 }
1995 
1996 /*
1997  * Evaluate a child device and determine whether we might attach a device to
1998  * it.
1999  */
2000 static ACPI_STATUS
2001 acpi_probe_child(ACPI_HANDLE handle, UINT32 level, void *context, void **status)
2002 {
2003     ACPI_DEVICE_INFO *devinfo;
2004     struct acpi_device	*ad;
2005 #ifdef __aarch64__
2006     int segment;
2007 #endif
2008     struct acpi_prw_data prw;
2009     ACPI_OBJECT_TYPE type;
2010     ACPI_HANDLE h;
2011     device_t bus, child;
2012     char *handle_str;
2013     int order;
2014 
2015     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
2016 
2017     if (acpi_disabled("children"))
2018 	return_ACPI_STATUS (AE_OK);
2019 
2020     /* Skip this device if we think we'll have trouble with it. */
2021     if (acpi_avoid(handle))
2022 	return_ACPI_STATUS (AE_OK);
2023 
2024     bus = (device_t)context;
2025     if (ACPI_SUCCESS(AcpiGetType(handle, &type))) {
2026 	handle_str = acpi_name(handle);
2027 	switch (type) {
2028 	case ACPI_TYPE_DEVICE:
2029 	    /*
2030 	     * Since we scan from \, be sure to skip system scope objects.
2031 	     * \_SB_ and \_TZ_ are defined in ACPICA as devices to work around
2032 	     * BIOS bugs.  For example, \_SB_ is to allow \_SB_._INI to be run
2033 	     * during the initialization and \_TZ_ is to support Notify() on it.
2034 	     */
2035 	    if (strcmp(handle_str, "\\_SB_") == 0 ||
2036 		strcmp(handle_str, "\\_TZ_") == 0)
2037 		break;
2038 	    if (acpi_parse_prw(handle, &prw) == 0)
2039 		AcpiSetupGpeForWake(handle, prw.gpe_handle, prw.gpe_bit);
2040 
2041 	    /*
2042 	     * Ignore devices that do not have a _HID or _CID.  They should
2043 	     * be discovered by other buses (e.g. the PCI bus driver).
2044 	     */
2045 	    if (!acpi_has_hid(handle))
2046 		break;
2047 	    /* FALLTHROUGH */
2048 	case ACPI_TYPE_PROCESSOR:
2049 	case ACPI_TYPE_THERMAL:
2050 	case ACPI_TYPE_POWER:
2051 	    /*
2052 	     * Create a placeholder device for this node.  Sort the
2053 	     * placeholder so that the probe/attach passes will run
2054 	     * breadth-first.  Orders less than ACPI_DEV_BASE_ORDER
2055 	     * are reserved for special objects (i.e., system
2056 	     * resources).
2057 	     */
2058 	    ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "scanning '%s'\n", handle_str));
2059 	    order = level * 10 + ACPI_DEV_BASE_ORDER;
2060 	    acpi_probe_order(handle, &order);
2061 	    child = BUS_ADD_CHILD(bus, order, NULL, -1);
2062 	    if (child == NULL)
2063 		break;
2064 
2065 	    /* Associate the handle with the device_t and vice versa. */
2066 	    acpi_set_handle(child, handle);
2067 	    AcpiAttachData(handle, acpi_fake_objhandler, child);
2068 
2069 	    /*
2070 	     * Check that the device is present.  If it's not present,
2071 	     * leave it disabled (so that we have a device_t attached to
2072 	     * the handle, but we don't probe it).
2073 	     *
2074 	     * XXX PCI link devices sometimes report "present" but not
2075 	     * "functional" (i.e. if disabled).  Go ahead and probe them
2076 	     * anyway since we may enable them later.
2077 	     */
2078 	    if (type == ACPI_TYPE_DEVICE && !acpi_DeviceIsPresent(child)) {
2079 		/* Never disable PCI link devices. */
2080 		if (acpi_MatchHid(handle, "PNP0C0F"))
2081 		    break;
2082 		/*
2083 		 * Docking stations should remain enabled since the system
2084 		 * may be undocked at boot.
2085 		 */
2086 		if (ACPI_SUCCESS(AcpiGetHandle(handle, "_DCK", &h)))
2087 		    break;
2088 
2089 		device_disable(child);
2090 		break;
2091 	    }
2092 
2093 	    /*
2094 	     * Get the device's resource settings and attach them.
2095 	     * Note that if the device has _PRS but no _CRS, we need
2096 	     * to decide when it's appropriate to try to configure the
2097 	     * device.  Ignore the return value here; it's OK for the
2098 	     * device not to have any resources.
2099 	     */
2100 	    acpi_parse_resources(child, handle, &acpi_res_parse_set, NULL);
2101 
2102 	    ad = device_get_ivars(child);
2103 	    ad->ad_cls_class = 0xffffff;
2104 	    if (ACPI_SUCCESS(AcpiGetObjectInfo(handle, &devinfo))) {
2105 		if ((devinfo->Valid & ACPI_VALID_CLS) != 0 &&
2106 		    devinfo->ClassCode.Length >= ACPI_PCICLS_STRING_SIZE) {
2107 		    ad->ad_cls_class = strtoul(devinfo->ClassCode.String,
2108 			NULL, 16);
2109 		}
2110 #ifdef __aarch64__
2111 		if ((devinfo->Flags & ACPI_PCI_ROOT_BRIDGE) != 0) {
2112 		    if (ACPI_SUCCESS(acpi_GetInteger(handle, "_SEG", &segment))) {
2113 			acpi_enable_pcie(child, segment);
2114 		    }
2115 		}
2116 #endif
2117 		AcpiOsFree(devinfo);
2118 	    }
2119 	    break;
2120 	}
2121     }
2122 
2123     return_ACPI_STATUS (AE_OK);
2124 }
2125 
2126 /*
2127  * AcpiAttachData() requires an object handler but never uses it.  This is a
2128  * placeholder object handler so we can store a device_t in an ACPI_HANDLE.
2129  */
2130 void
2131 acpi_fake_objhandler(ACPI_HANDLE h, void *data)
2132 {
2133 }
2134 
2135 static void
2136 acpi_shutdown_final(void *arg, int howto)
2137 {
2138     struct acpi_softc *sc = (struct acpi_softc *)arg;
2139     register_t intr;
2140     ACPI_STATUS status;
2141 
2142     /*
2143      * XXX Shutdown code should only run on the BSP (cpuid 0).
2144      * Some chipsets do not power off the system correctly if called from
2145      * an AP.
2146      */
2147     if ((howto & RB_POWEROFF) != 0) {
2148 	status = AcpiEnterSleepStatePrep(ACPI_STATE_S5);
2149 	if (ACPI_FAILURE(status)) {
2150 	    device_printf(sc->acpi_dev, "AcpiEnterSleepStatePrep failed - %s\n",
2151 		AcpiFormatException(status));
2152 	    return;
2153 	}
2154 	device_printf(sc->acpi_dev, "Powering system off\n");
2155 	intr = intr_disable();
2156 	status = AcpiEnterSleepState(ACPI_STATE_S5);
2157 	if (ACPI_FAILURE(status)) {
2158 	    intr_restore(intr);
2159 	    device_printf(sc->acpi_dev, "power-off failed - %s\n",
2160 		AcpiFormatException(status));
2161 	} else {
2162 	    DELAY(1000000);
2163 	    intr_restore(intr);
2164 	    device_printf(sc->acpi_dev, "power-off failed - timeout\n");
2165 	}
2166     } else if ((howto & RB_HALT) == 0 && sc->acpi_handle_reboot) {
2167 	/* Reboot using the reset register. */
2168 	status = AcpiReset();
2169 	if (ACPI_SUCCESS(status)) {
2170 	    DELAY(1000000);
2171 	    device_printf(sc->acpi_dev, "reset failed - timeout\n");
2172 	} else if (status != AE_NOT_EXIST)
2173 	    device_printf(sc->acpi_dev, "reset failed - %s\n",
2174 		AcpiFormatException(status));
2175     } else if (sc->acpi_do_disable && panicstr == NULL) {
2176 	/*
2177 	 * Only disable ACPI if the user requested.  On some systems, writing
2178 	 * the disable value to SMI_CMD hangs the system.
2179 	 */
2180 	device_printf(sc->acpi_dev, "Shutting down\n");
2181 	AcpiTerminate();
2182     }
2183 }
2184 
2185 static void
2186 acpi_enable_fixed_events(struct acpi_softc *sc)
2187 {
2188     static int	first_time = 1;
2189 
2190     /* Enable and clear fixed events and install handlers. */
2191     if ((AcpiGbl_FADT.Flags & ACPI_FADT_POWER_BUTTON) == 0) {
2192 	AcpiClearEvent(ACPI_EVENT_POWER_BUTTON);
2193 	AcpiInstallFixedEventHandler(ACPI_EVENT_POWER_BUTTON,
2194 				     acpi_event_power_button_sleep, sc);
2195 	if (first_time)
2196 	    device_printf(sc->acpi_dev, "Power Button (fixed)\n");
2197     }
2198     if ((AcpiGbl_FADT.Flags & ACPI_FADT_SLEEP_BUTTON) == 0) {
2199 	AcpiClearEvent(ACPI_EVENT_SLEEP_BUTTON);
2200 	AcpiInstallFixedEventHandler(ACPI_EVENT_SLEEP_BUTTON,
2201 				     acpi_event_sleep_button_sleep, sc);
2202 	if (first_time)
2203 	    device_printf(sc->acpi_dev, "Sleep Button (fixed)\n");
2204     }
2205 
2206     first_time = 0;
2207 }
2208 
2209 /*
2210  * Returns true if the device is actually present and should
2211  * be attached to.  This requires the present, enabled, UI-visible
2212  * and diagnostics-passed bits to be set.
2213  */
2214 BOOLEAN
2215 acpi_DeviceIsPresent(device_t dev)
2216 {
2217 	ACPI_HANDLE h;
2218 	UINT32 s;
2219 	ACPI_STATUS status;
2220 
2221 	h = acpi_get_handle(dev);
2222 	if (h == NULL)
2223 		return (FALSE);
2224 	status = acpi_GetInteger(h, "_STA", &s);
2225 
2226 	/* If no _STA method, must be present */
2227 	if (ACPI_FAILURE(status))
2228 		return (status == AE_NOT_FOUND ? TRUE : FALSE);
2229 
2230 	return (ACPI_DEVICE_PRESENT(s) ? TRUE : FALSE);
2231 }
2232 
2233 /*
2234  * Returns true if the battery is actually present and inserted.
2235  */
2236 BOOLEAN
2237 acpi_BatteryIsPresent(device_t dev)
2238 {
2239 	ACPI_HANDLE h;
2240 	UINT32 s;
2241 	ACPI_STATUS status;
2242 
2243 	h = acpi_get_handle(dev);
2244 	if (h == NULL)
2245 		return (FALSE);
2246 	status = acpi_GetInteger(h, "_STA", &s);
2247 
2248 	/* If no _STA method, must be present */
2249 	if (ACPI_FAILURE(status))
2250 		return (status == AE_NOT_FOUND ? TRUE : FALSE);
2251 
2252 	return (ACPI_BATTERY_PRESENT(s) ? TRUE : FALSE);
2253 }
2254 
2255 /*
2256  * Returns true if a device has at least one valid device ID.
2257  */
2258 static BOOLEAN
2259 acpi_has_hid(ACPI_HANDLE h)
2260 {
2261     ACPI_DEVICE_INFO	*devinfo;
2262     BOOLEAN		ret;
2263 
2264     if (h == NULL ||
2265 	ACPI_FAILURE(AcpiGetObjectInfo(h, &devinfo)))
2266 	return (FALSE);
2267 
2268     ret = FALSE;
2269     if ((devinfo->Valid & ACPI_VALID_HID) != 0)
2270 	ret = TRUE;
2271     else if ((devinfo->Valid & ACPI_VALID_CID) != 0)
2272 	if (devinfo->CompatibleIdList.Count > 0)
2273 	    ret = TRUE;
2274 
2275     AcpiOsFree(devinfo);
2276     return (ret);
2277 }
2278 
2279 /*
2280  * Match a HID string against a handle
2281  */
2282 BOOLEAN
2283 acpi_MatchHid(ACPI_HANDLE h, const char *hid)
2284 {
2285     ACPI_DEVICE_INFO	*devinfo;
2286     BOOLEAN		ret;
2287     int			i;
2288 
2289     if (hid == NULL || h == NULL ||
2290 	ACPI_FAILURE(AcpiGetObjectInfo(h, &devinfo)))
2291 	return (FALSE);
2292 
2293     ret = FALSE;
2294     if ((devinfo->Valid & ACPI_VALID_HID) != 0 &&
2295 	strcmp(hid, devinfo->HardwareId.String) == 0)
2296 	    ret = TRUE;
2297     else if ((devinfo->Valid & ACPI_VALID_CID) != 0)
2298 	for (i = 0; i < devinfo->CompatibleIdList.Count; i++) {
2299 	    if (strcmp(hid, devinfo->CompatibleIdList.Ids[i].String) == 0) {
2300 		ret = TRUE;
2301 		break;
2302 	    }
2303 	}
2304 
2305     AcpiOsFree(devinfo);
2306     return (ret);
2307 }
2308 
2309 /*
2310  * Return the handle of a named object within our scope, ie. that of (parent)
2311  * or one if its parents.
2312  */
2313 ACPI_STATUS
2314 acpi_GetHandleInScope(ACPI_HANDLE parent, char *path, ACPI_HANDLE *result)
2315 {
2316     ACPI_HANDLE		r;
2317     ACPI_STATUS		status;
2318 
2319     /* Walk back up the tree to the root */
2320     for (;;) {
2321 	status = AcpiGetHandle(parent, path, &r);
2322 	if (ACPI_SUCCESS(status)) {
2323 	    *result = r;
2324 	    return (AE_OK);
2325 	}
2326 	/* XXX Return error here? */
2327 	if (status != AE_NOT_FOUND)
2328 	    return (AE_OK);
2329 	if (ACPI_FAILURE(AcpiGetParent(parent, &r)))
2330 	    return (AE_NOT_FOUND);
2331 	parent = r;
2332     }
2333 }
2334 
2335 /*
2336  * Allocate a buffer with a preset data size.
2337  */
2338 ACPI_BUFFER *
2339 acpi_AllocBuffer(int size)
2340 {
2341     ACPI_BUFFER	*buf;
2342 
2343     if ((buf = malloc(size + sizeof(*buf), M_ACPIDEV, M_NOWAIT)) == NULL)
2344 	return (NULL);
2345     buf->Length = size;
2346     buf->Pointer = (void *)(buf + 1);
2347     return (buf);
2348 }
2349 
2350 ACPI_STATUS
2351 acpi_SetInteger(ACPI_HANDLE handle, char *path, UINT32 number)
2352 {
2353     ACPI_OBJECT arg1;
2354     ACPI_OBJECT_LIST args;
2355 
2356     arg1.Type = ACPI_TYPE_INTEGER;
2357     arg1.Integer.Value = number;
2358     args.Count = 1;
2359     args.Pointer = &arg1;
2360 
2361     return (AcpiEvaluateObject(handle, path, &args, NULL));
2362 }
2363 
2364 /*
2365  * Evaluate a path that should return an integer.
2366  */
2367 ACPI_STATUS
2368 acpi_GetInteger(ACPI_HANDLE handle, char *path, UINT32 *number)
2369 {
2370     ACPI_STATUS	status;
2371     ACPI_BUFFER	buf;
2372     ACPI_OBJECT	param;
2373 
2374     if (handle == NULL)
2375 	handle = ACPI_ROOT_OBJECT;
2376 
2377     /*
2378      * Assume that what we've been pointed at is an Integer object, or
2379      * a method that will return an Integer.
2380      */
2381     buf.Pointer = &param;
2382     buf.Length = sizeof(param);
2383     status = AcpiEvaluateObject(handle, path, NULL, &buf);
2384     if (ACPI_SUCCESS(status)) {
2385 	if (param.Type == ACPI_TYPE_INTEGER)
2386 	    *number = param.Integer.Value;
2387 	else
2388 	    status = AE_TYPE;
2389     }
2390 
2391     /*
2392      * In some applications, a method that's expected to return an Integer
2393      * may instead return a Buffer (probably to simplify some internal
2394      * arithmetic).  We'll try to fetch whatever it is, and if it's a Buffer,
2395      * convert it into an Integer as best we can.
2396      *
2397      * This is a hack.
2398      */
2399     if (status == AE_BUFFER_OVERFLOW) {
2400 	if ((buf.Pointer = AcpiOsAllocate(buf.Length)) == NULL) {
2401 	    status = AE_NO_MEMORY;
2402 	} else {
2403 	    status = AcpiEvaluateObject(handle, path, NULL, &buf);
2404 	    if (ACPI_SUCCESS(status))
2405 		status = acpi_ConvertBufferToInteger(&buf, number);
2406 	    AcpiOsFree(buf.Pointer);
2407 	}
2408     }
2409     return (status);
2410 }
2411 
2412 ACPI_STATUS
2413 acpi_ConvertBufferToInteger(ACPI_BUFFER *bufp, UINT32 *number)
2414 {
2415     ACPI_OBJECT	*p;
2416     UINT8	*val;
2417     int		i;
2418 
2419     p = (ACPI_OBJECT *)bufp->Pointer;
2420     if (p->Type == ACPI_TYPE_INTEGER) {
2421 	*number = p->Integer.Value;
2422 	return (AE_OK);
2423     }
2424     if (p->Type != ACPI_TYPE_BUFFER)
2425 	return (AE_TYPE);
2426     if (p->Buffer.Length > sizeof(int))
2427 	return (AE_BAD_DATA);
2428 
2429     *number = 0;
2430     val = p->Buffer.Pointer;
2431     for (i = 0; i < p->Buffer.Length; i++)
2432 	*number += val[i] << (i * 8);
2433     return (AE_OK);
2434 }
2435 
2436 /*
2437  * Iterate over the elements of an a package object, calling the supplied
2438  * function for each element.
2439  *
2440  * XXX possible enhancement might be to abort traversal on error.
2441  */
2442 ACPI_STATUS
2443 acpi_ForeachPackageObject(ACPI_OBJECT *pkg,
2444 	void (*func)(ACPI_OBJECT *comp, void *arg), void *arg)
2445 {
2446     ACPI_OBJECT	*comp;
2447     int		i;
2448 
2449     if (pkg == NULL || pkg->Type != ACPI_TYPE_PACKAGE)
2450 	return (AE_BAD_PARAMETER);
2451 
2452     /* Iterate over components */
2453     i = 0;
2454     comp = pkg->Package.Elements;
2455     for (; i < pkg->Package.Count; i++, comp++)
2456 	func(comp, arg);
2457 
2458     return (AE_OK);
2459 }
2460 
2461 /*
2462  * Find the (index)th resource object in a set.
2463  */
2464 ACPI_STATUS
2465 acpi_FindIndexedResource(ACPI_BUFFER *buf, int index, ACPI_RESOURCE **resp)
2466 {
2467     ACPI_RESOURCE	*rp;
2468     int			i;
2469 
2470     rp = (ACPI_RESOURCE *)buf->Pointer;
2471     i = index;
2472     while (i-- > 0) {
2473 	/* Range check */
2474 	if (rp > (ACPI_RESOURCE *)((u_int8_t *)buf->Pointer + buf->Length))
2475 	    return (AE_BAD_PARAMETER);
2476 
2477 	/* Check for terminator */
2478 	if (rp->Type == ACPI_RESOURCE_TYPE_END_TAG || rp->Length == 0)
2479 	    return (AE_NOT_FOUND);
2480 	rp = ACPI_NEXT_RESOURCE(rp);
2481     }
2482     if (resp != NULL)
2483 	*resp = rp;
2484 
2485     return (AE_OK);
2486 }
2487 
2488 /*
2489  * Append an ACPI_RESOURCE to an ACPI_BUFFER.
2490  *
2491  * Given a pointer to an ACPI_RESOURCE structure, expand the ACPI_BUFFER
2492  * provided to contain it.  If the ACPI_BUFFER is empty, allocate a sensible
2493  * backing block.  If the ACPI_RESOURCE is NULL, return an empty set of
2494  * resources.
2495  */
2496 #define ACPI_INITIAL_RESOURCE_BUFFER_SIZE	512
2497 
2498 ACPI_STATUS
2499 acpi_AppendBufferResource(ACPI_BUFFER *buf, ACPI_RESOURCE *res)
2500 {
2501     ACPI_RESOURCE	*rp;
2502     void		*newp;
2503 
2504     /* Initialise the buffer if necessary. */
2505     if (buf->Pointer == NULL) {
2506 	buf->Length = ACPI_INITIAL_RESOURCE_BUFFER_SIZE;
2507 	if ((buf->Pointer = AcpiOsAllocate(buf->Length)) == NULL)
2508 	    return (AE_NO_MEMORY);
2509 	rp = (ACPI_RESOURCE *)buf->Pointer;
2510 	rp->Type = ACPI_RESOURCE_TYPE_END_TAG;
2511 	rp->Length = ACPI_RS_SIZE_MIN;
2512     }
2513     if (res == NULL)
2514 	return (AE_OK);
2515 
2516     /*
2517      * Scan the current buffer looking for the terminator.
2518      * This will either find the terminator or hit the end
2519      * of the buffer and return an error.
2520      */
2521     rp = (ACPI_RESOURCE *)buf->Pointer;
2522     for (;;) {
2523 	/* Range check, don't go outside the buffer */
2524 	if (rp >= (ACPI_RESOURCE *)((u_int8_t *)buf->Pointer + buf->Length))
2525 	    return (AE_BAD_PARAMETER);
2526 	if (rp->Type == ACPI_RESOURCE_TYPE_END_TAG || rp->Length == 0)
2527 	    break;
2528 	rp = ACPI_NEXT_RESOURCE(rp);
2529     }
2530 
2531     /*
2532      * Check the size of the buffer and expand if required.
2533      *
2534      * Required size is:
2535      *	size of existing resources before terminator +
2536      *	size of new resource and header +
2537      * 	size of terminator.
2538      *
2539      * Note that this loop should really only run once, unless
2540      * for some reason we are stuffing a *really* huge resource.
2541      */
2542     while ((((u_int8_t *)rp - (u_int8_t *)buf->Pointer) +
2543 	    res->Length + ACPI_RS_SIZE_NO_DATA +
2544 	    ACPI_RS_SIZE_MIN) >= buf->Length) {
2545 	if ((newp = AcpiOsAllocate(buf->Length * 2)) == NULL)
2546 	    return (AE_NO_MEMORY);
2547 	bcopy(buf->Pointer, newp, buf->Length);
2548 	rp = (ACPI_RESOURCE *)((u_int8_t *)newp +
2549 			       ((u_int8_t *)rp - (u_int8_t *)buf->Pointer));
2550 	AcpiOsFree(buf->Pointer);
2551 	buf->Pointer = newp;
2552 	buf->Length += buf->Length;
2553     }
2554 
2555     /* Insert the new resource. */
2556     bcopy(res, rp, res->Length + ACPI_RS_SIZE_NO_DATA);
2557 
2558     /* And add the terminator. */
2559     rp = ACPI_NEXT_RESOURCE(rp);
2560     rp->Type = ACPI_RESOURCE_TYPE_END_TAG;
2561     rp->Length = ACPI_RS_SIZE_MIN;
2562 
2563     return (AE_OK);
2564 }
2565 
2566 ACPI_STATUS
2567 acpi_EvaluateOSC(ACPI_HANDLE handle, uint8_t *uuid, int revision, int count,
2568     uint32_t *caps_in, uint32_t *caps_out, bool query)
2569 {
2570 	ACPI_OBJECT arg[4], *ret;
2571 	ACPI_OBJECT_LIST arglist;
2572 	ACPI_BUFFER buf;
2573 	ACPI_STATUS status;
2574 
2575 	arglist.Pointer = arg;
2576 	arglist.Count = 4;
2577 	arg[0].Type = ACPI_TYPE_BUFFER;
2578 	arg[0].Buffer.Length = ACPI_UUID_LENGTH;
2579 	arg[0].Buffer.Pointer = uuid;
2580 	arg[1].Type = ACPI_TYPE_INTEGER;
2581 	arg[1].Integer.Value = revision;
2582 	arg[2].Type = ACPI_TYPE_INTEGER;
2583 	arg[2].Integer.Value = count;
2584 	arg[3].Type = ACPI_TYPE_BUFFER;
2585 	arg[3].Buffer.Length = count * sizeof(*caps_in);
2586 	arg[3].Buffer.Pointer = (uint8_t *)caps_in;
2587 	caps_in[0] = query ? 1 : 0;
2588 	buf.Pointer = NULL;
2589 	buf.Length = ACPI_ALLOCATE_BUFFER;
2590 	status = AcpiEvaluateObjectTyped(handle, "_OSC", &arglist, &buf,
2591 	    ACPI_TYPE_BUFFER);
2592 	if (ACPI_FAILURE(status))
2593 		return (status);
2594 	if (caps_out != NULL) {
2595 		ret = buf.Pointer;
2596 		if (ret->Buffer.Length != count * sizeof(*caps_out)) {
2597 			AcpiOsFree(buf.Pointer);
2598 			return (AE_BUFFER_OVERFLOW);
2599 		}
2600 		bcopy(ret->Buffer.Pointer, caps_out, ret->Buffer.Length);
2601 	}
2602 	AcpiOsFree(buf.Pointer);
2603 	return (status);
2604 }
2605 
2606 /*
2607  * Set interrupt model.
2608  */
2609 ACPI_STATUS
2610 acpi_SetIntrModel(int model)
2611 {
2612 
2613     return (acpi_SetInteger(ACPI_ROOT_OBJECT, "_PIC", model));
2614 }
2615 
2616 /*
2617  * Walk subtables of a table and call a callback routine for each
2618  * subtable.  The caller should provide the first subtable and a
2619  * pointer to the end of the table.  This can be used to walk tables
2620  * such as MADT and SRAT that use subtable entries.
2621  */
2622 void
2623 acpi_walk_subtables(void *first, void *end, acpi_subtable_handler *handler,
2624     void *arg)
2625 {
2626     ACPI_SUBTABLE_HEADER *entry;
2627 
2628     for (entry = first; (void *)entry < end; ) {
2629 	/* Avoid an infinite loop if we hit a bogus entry. */
2630 	if (entry->Length < sizeof(ACPI_SUBTABLE_HEADER))
2631 	    return;
2632 
2633 	handler(entry, arg);
2634 	entry = ACPI_ADD_PTR(ACPI_SUBTABLE_HEADER, entry, entry->Length);
2635     }
2636 }
2637 
2638 /*
2639  * DEPRECATED.  This interface has serious deficiencies and will be
2640  * removed.
2641  *
2642  * Immediately enter the sleep state.  In the old model, acpiconf(8) ran
2643  * rc.suspend and rc.resume so we don't have to notify devd(8) to do this.
2644  */
2645 ACPI_STATUS
2646 acpi_SetSleepState(struct acpi_softc *sc, int state)
2647 {
2648     static int once;
2649 
2650     if (!once) {
2651 	device_printf(sc->acpi_dev,
2652 "warning: acpi_SetSleepState() deprecated, need to update your software\n");
2653 	once = 1;
2654     }
2655     return (acpi_EnterSleepState(sc, state));
2656 }
2657 
2658 #if defined(__amd64__) || defined(__i386__)
2659 static void
2660 acpi_sleep_force_task(void *context)
2661 {
2662     struct acpi_softc *sc = (struct acpi_softc *)context;
2663 
2664     if (ACPI_FAILURE(acpi_EnterSleepState(sc, sc->acpi_next_sstate)))
2665 	device_printf(sc->acpi_dev, "force sleep state S%d failed\n",
2666 	    sc->acpi_next_sstate);
2667 }
2668 
2669 static void
2670 acpi_sleep_force(void *arg)
2671 {
2672     struct acpi_softc *sc = (struct acpi_softc *)arg;
2673 
2674     device_printf(sc->acpi_dev,
2675 	"suspend request timed out, forcing sleep now\n");
2676     /*
2677      * XXX Suspending from callout causes freezes in DEVICE_SUSPEND().
2678      * Suspend from acpi_task thread instead.
2679      */
2680     if (ACPI_FAILURE(AcpiOsExecute(OSL_NOTIFY_HANDLER,
2681 	acpi_sleep_force_task, sc)))
2682 	device_printf(sc->acpi_dev, "AcpiOsExecute() for sleeping failed\n");
2683 }
2684 #endif
2685 
2686 /*
2687  * Request that the system enter the given suspend state.  All /dev/apm
2688  * devices and devd(8) will be notified.  Userland then has a chance to
2689  * save state and acknowledge the request.  The system sleeps once all
2690  * acks are in.
2691  */
2692 int
2693 acpi_ReqSleepState(struct acpi_softc *sc, int state)
2694 {
2695 #if defined(__amd64__) || defined(__i386__)
2696     struct apm_clone_data *clone;
2697     ACPI_STATUS status;
2698 
2699     if (state < ACPI_STATE_S1 || state > ACPI_S_STATES_MAX)
2700 	return (EINVAL);
2701     if (!acpi_sleep_states[state])
2702 	return (EOPNOTSUPP);
2703 
2704     /*
2705      * If a reboot/shutdown/suspend request is already in progress or
2706      * suspend is blocked due to an upcoming shutdown, just return.
2707      */
2708     if (rebooting || sc->acpi_next_sstate != 0 || suspend_blocked) {
2709 	return (0);
2710     }
2711 
2712     /* Wait until sleep is enabled. */
2713     while (sc->acpi_sleep_disabled) {
2714 	AcpiOsSleep(1000);
2715     }
2716 
2717     ACPI_LOCK(acpi);
2718 
2719     sc->acpi_next_sstate = state;
2720 
2721     /* S5 (soft-off) should be entered directly with no waiting. */
2722     if (state == ACPI_STATE_S5) {
2723     	ACPI_UNLOCK(acpi);
2724 	status = acpi_EnterSleepState(sc, state);
2725 	return (ACPI_SUCCESS(status) ? 0 : ENXIO);
2726     }
2727 
2728     /* Record the pending state and notify all apm devices. */
2729     STAILQ_FOREACH(clone, &sc->apm_cdevs, entries) {
2730 	clone->notify_status = APM_EV_NONE;
2731 	if ((clone->flags & ACPI_EVF_DEVD) == 0) {
2732 	    selwakeuppri(&clone->sel_read, PZERO);
2733 	    KNOTE_LOCKED(&clone->sel_read.si_note, 0);
2734 	}
2735     }
2736 
2737     /* If devd(8) is not running, immediately enter the sleep state. */
2738     if (!devctl_process_running()) {
2739 	ACPI_UNLOCK(acpi);
2740 	status = acpi_EnterSleepState(sc, state);
2741 	return (ACPI_SUCCESS(status) ? 0 : ENXIO);
2742     }
2743 
2744     /*
2745      * Set a timeout to fire if userland doesn't ack the suspend request
2746      * in time.  This way we still eventually go to sleep if we were
2747      * overheating or running low on battery, even if userland is hung.
2748      * We cancel this timeout once all userland acks are in or the
2749      * suspend request is aborted.
2750      */
2751     callout_reset(&sc->susp_force_to, 10 * hz, acpi_sleep_force, sc);
2752     ACPI_UNLOCK(acpi);
2753 
2754     /* Now notify devd(8) also. */
2755     acpi_UserNotify("Suspend", ACPI_ROOT_OBJECT, state);
2756 
2757     return (0);
2758 #else
2759     /* This platform does not support acpi suspend/resume. */
2760     return (EOPNOTSUPP);
2761 #endif
2762 }
2763 
2764 /*
2765  * Acknowledge (or reject) a pending sleep state.  The caller has
2766  * prepared for suspend and is now ready for it to proceed.  If the
2767  * error argument is non-zero, it indicates suspend should be cancelled
2768  * and gives an errno value describing why.  Once all votes are in,
2769  * we suspend the system.
2770  */
2771 int
2772 acpi_AckSleepState(struct apm_clone_data *clone, int error)
2773 {
2774 #if defined(__amd64__) || defined(__i386__)
2775     struct acpi_softc *sc;
2776     int ret, sleeping;
2777 
2778     /* If no pending sleep state, return an error. */
2779     ACPI_LOCK(acpi);
2780     sc = clone->acpi_sc;
2781     if (sc->acpi_next_sstate == 0) {
2782     	ACPI_UNLOCK(acpi);
2783 	return (ENXIO);
2784     }
2785 
2786     /* Caller wants to abort suspend process. */
2787     if (error) {
2788 	sc->acpi_next_sstate = 0;
2789 	callout_stop(&sc->susp_force_to);
2790 	device_printf(sc->acpi_dev,
2791 	    "listener on %s cancelled the pending suspend\n",
2792 	    devtoname(clone->cdev));
2793     	ACPI_UNLOCK(acpi);
2794 	return (0);
2795     }
2796 
2797     /*
2798      * Mark this device as acking the suspend request.  Then, walk through
2799      * all devices, seeing if they agree yet.  We only count devices that
2800      * are writable since read-only devices couldn't ack the request.
2801      */
2802     sleeping = TRUE;
2803     clone->notify_status = APM_EV_ACKED;
2804     STAILQ_FOREACH(clone, &sc->apm_cdevs, entries) {
2805 	if ((clone->flags & ACPI_EVF_WRITE) != 0 &&
2806 	    clone->notify_status != APM_EV_ACKED) {
2807 	    sleeping = FALSE;
2808 	    break;
2809 	}
2810     }
2811 
2812     /* If all devices have voted "yes", we will suspend now. */
2813     if (sleeping)
2814 	callout_stop(&sc->susp_force_to);
2815     ACPI_UNLOCK(acpi);
2816     ret = 0;
2817     if (sleeping) {
2818 	if (ACPI_FAILURE(acpi_EnterSleepState(sc, sc->acpi_next_sstate)))
2819 		ret = ENODEV;
2820     }
2821     return (ret);
2822 #else
2823     /* This platform does not support acpi suspend/resume. */
2824     return (EOPNOTSUPP);
2825 #endif
2826 }
2827 
2828 static void
2829 acpi_sleep_enable(void *arg)
2830 {
2831     struct acpi_softc	*sc = (struct acpi_softc *)arg;
2832 
2833     ACPI_LOCK_ASSERT(acpi);
2834 
2835     /* Reschedule if the system is not fully up and running. */
2836     if (!AcpiGbl_SystemAwakeAndRunning) {
2837 	callout_schedule(&acpi_sleep_timer, hz * ACPI_MINIMUM_AWAKETIME);
2838 	return;
2839     }
2840 
2841     sc->acpi_sleep_disabled = FALSE;
2842 }
2843 
2844 static ACPI_STATUS
2845 acpi_sleep_disable(struct acpi_softc *sc)
2846 {
2847     ACPI_STATUS		status;
2848 
2849     /* Fail if the system is not fully up and running. */
2850     if (!AcpiGbl_SystemAwakeAndRunning)
2851 	return (AE_ERROR);
2852 
2853     ACPI_LOCK(acpi);
2854     status = sc->acpi_sleep_disabled ? AE_ERROR : AE_OK;
2855     sc->acpi_sleep_disabled = TRUE;
2856     ACPI_UNLOCK(acpi);
2857 
2858     return (status);
2859 }
2860 
2861 enum acpi_sleep_state {
2862     ACPI_SS_NONE,
2863     ACPI_SS_GPE_SET,
2864     ACPI_SS_DEV_SUSPEND,
2865     ACPI_SS_SLP_PREP,
2866     ACPI_SS_SLEPT,
2867 };
2868 
2869 /*
2870  * Enter the desired system sleep state.
2871  *
2872  * Currently we support S1-S5 but S4 is only S4BIOS
2873  */
2874 static ACPI_STATUS
2875 acpi_EnterSleepState(struct acpi_softc *sc, int state)
2876 {
2877     register_t intr;
2878     ACPI_STATUS status;
2879     ACPI_EVENT_STATUS power_button_status;
2880     enum acpi_sleep_state slp_state;
2881     int sleep_result;
2882 
2883     ACPI_FUNCTION_TRACE_U32((char *)(uintptr_t)__func__, state);
2884 
2885     if (state < ACPI_STATE_S1 || state > ACPI_S_STATES_MAX)
2886 	return_ACPI_STATUS (AE_BAD_PARAMETER);
2887     if (!acpi_sleep_states[state]) {
2888 	device_printf(sc->acpi_dev, "Sleep state S%d not supported by BIOS\n",
2889 	    state);
2890 	return (AE_SUPPORT);
2891     }
2892 
2893     /* Re-entry once we're suspending is not allowed. */
2894     status = acpi_sleep_disable(sc);
2895     if (ACPI_FAILURE(status)) {
2896 	device_printf(sc->acpi_dev,
2897 	    "suspend request ignored (not ready yet)\n");
2898 	return (status);
2899     }
2900 
2901     if (state == ACPI_STATE_S5) {
2902 	/*
2903 	 * Shut down cleanly and power off.  This will call us back through the
2904 	 * shutdown handlers.
2905 	 */
2906 	shutdown_nice(RB_POWEROFF);
2907 	return_ACPI_STATUS (AE_OK);
2908     }
2909 
2910     EVENTHANDLER_INVOKE(power_suspend_early);
2911     stop_all_proc();
2912     EVENTHANDLER_INVOKE(power_suspend);
2913 
2914 #ifdef EARLY_AP_STARTUP
2915     MPASS(mp_ncpus == 1 || smp_started);
2916     thread_lock(curthread);
2917     sched_bind(curthread, 0);
2918     thread_unlock(curthread);
2919 #else
2920     if (smp_started) {
2921 	thread_lock(curthread);
2922 	sched_bind(curthread, 0);
2923 	thread_unlock(curthread);
2924     }
2925 #endif
2926 
2927     /*
2928      * Be sure to hold Giant across DEVICE_SUSPEND/RESUME since non-MPSAFE
2929      * drivers need this.
2930      */
2931     mtx_lock(&Giant);
2932 
2933     slp_state = ACPI_SS_NONE;
2934 
2935     sc->acpi_sstate = state;
2936 
2937     /* Enable any GPEs as appropriate and requested by the user. */
2938     acpi_wake_prep_walk(state);
2939     slp_state = ACPI_SS_GPE_SET;
2940 
2941     /*
2942      * Inform all devices that we are going to sleep.  If at least one
2943      * device fails, DEVICE_SUSPEND() automatically resumes the tree.
2944      *
2945      * XXX Note that a better two-pass approach with a 'veto' pass
2946      * followed by a "real thing" pass would be better, but the current
2947      * bus interface does not provide for this.
2948      */
2949     if (DEVICE_SUSPEND(root_bus) != 0) {
2950 	device_printf(sc->acpi_dev, "device_suspend failed\n");
2951 	goto backout;
2952     }
2953     slp_state = ACPI_SS_DEV_SUSPEND;
2954 
2955     /* If testing device suspend only, back out of everything here. */
2956     if (acpi_susp_bounce)
2957 	goto backout;
2958 
2959     status = AcpiEnterSleepStatePrep(state);
2960     if (ACPI_FAILURE(status)) {
2961 	device_printf(sc->acpi_dev, "AcpiEnterSleepStatePrep failed - %s\n",
2962 		      AcpiFormatException(status));
2963 	goto backout;
2964     }
2965     slp_state = ACPI_SS_SLP_PREP;
2966 
2967     if (sc->acpi_sleep_delay > 0)
2968 	DELAY(sc->acpi_sleep_delay * 1000000);
2969 
2970     intr = intr_disable();
2971     if (state != ACPI_STATE_S1) {
2972 	sleep_result = acpi_sleep_machdep(sc, state);
2973 	acpi_wakeup_machdep(sc, state, sleep_result, 0);
2974 
2975 	/*
2976 	 * XXX According to ACPI specification SCI_EN bit should be restored
2977 	 * by ACPI platform (BIOS, firmware) to its pre-sleep state.
2978 	 * Unfortunately some BIOSes fail to do that and that leads to
2979 	 * unexpected and serious consequences during wake up like a system
2980 	 * getting stuck in SMI handlers.
2981 	 * This hack is picked up from Linux, which claims that it follows
2982 	 * Windows behavior.
2983 	 */
2984 	if (sleep_result == 1 && state != ACPI_STATE_S4)
2985 	    AcpiWriteBitRegister(ACPI_BITREG_SCI_ENABLE, ACPI_ENABLE_EVENT);
2986 
2987 	AcpiLeaveSleepStatePrep(state);
2988 
2989 	if (sleep_result == 1 && state == ACPI_STATE_S3) {
2990 	    /*
2991 	     * Prevent mis-interpretation of the wakeup by power button
2992 	     * as a request for power off.
2993 	     * Ideally we should post an appropriate wakeup event,
2994 	     * perhaps using acpi_event_power_button_wake or alike.
2995 	     *
2996 	     * Clearing of power button status after wakeup is mandated
2997 	     * by ACPI specification in section "Fixed Power Button".
2998 	     *
2999 	     * XXX As of ACPICA 20121114 AcpiGetEventStatus provides
3000 	     * status as 0/1 corressponding to inactive/active despite
3001 	     * its type being ACPI_EVENT_STATUS.  In other words,
3002 	     * we should not test for ACPI_EVENT_FLAG_SET for time being.
3003 	     */
3004 	    if (ACPI_SUCCESS(AcpiGetEventStatus(ACPI_EVENT_POWER_BUTTON,
3005 		&power_button_status)) && power_button_status != 0) {
3006 		AcpiClearEvent(ACPI_EVENT_POWER_BUTTON);
3007 		device_printf(sc->acpi_dev,
3008 		    "cleared fixed power button status\n");
3009 	    }
3010 	}
3011 
3012 	intr_restore(intr);
3013 
3014 	/* call acpi_wakeup_machdep() again with interrupt enabled */
3015 	acpi_wakeup_machdep(sc, state, sleep_result, 1);
3016 
3017 	if (sleep_result == -1)
3018 		goto backout;
3019 
3020 	/* Re-enable ACPI hardware on wakeup from sleep state 4. */
3021 	if (state == ACPI_STATE_S4)
3022 	    AcpiEnable();
3023     } else {
3024 	status = AcpiEnterSleepState(state);
3025 	AcpiLeaveSleepStatePrep(state);
3026 	intr_restore(intr);
3027 	if (ACPI_FAILURE(status)) {
3028 	    device_printf(sc->acpi_dev, "AcpiEnterSleepState failed - %s\n",
3029 			  AcpiFormatException(status));
3030 	    goto backout;
3031 	}
3032     }
3033     slp_state = ACPI_SS_SLEPT;
3034 
3035     /*
3036      * Back out state according to how far along we got in the suspend
3037      * process.  This handles both the error and success cases.
3038      */
3039 backout:
3040     if (slp_state >= ACPI_SS_GPE_SET) {
3041 	acpi_wake_prep_walk(state);
3042 	sc->acpi_sstate = ACPI_STATE_S0;
3043     }
3044     if (slp_state >= ACPI_SS_DEV_SUSPEND)
3045 	DEVICE_RESUME(root_bus);
3046     if (slp_state >= ACPI_SS_SLP_PREP)
3047 	AcpiLeaveSleepState(state);
3048     if (slp_state >= ACPI_SS_SLEPT) {
3049 	acpi_resync_clock(sc);
3050 	acpi_enable_fixed_events(sc);
3051     }
3052     sc->acpi_next_sstate = 0;
3053 
3054     mtx_unlock(&Giant);
3055 
3056 #ifdef EARLY_AP_STARTUP
3057     thread_lock(curthread);
3058     sched_unbind(curthread);
3059     thread_unlock(curthread);
3060 #else
3061     if (smp_started) {
3062 	thread_lock(curthread);
3063 	sched_unbind(curthread);
3064 	thread_unlock(curthread);
3065     }
3066 #endif
3067 
3068     resume_all_proc();
3069 
3070     EVENTHANDLER_INVOKE(power_resume);
3071 
3072     /* Allow another sleep request after a while. */
3073     callout_schedule(&acpi_sleep_timer, hz * ACPI_MINIMUM_AWAKETIME);
3074 
3075     /* Run /etc/rc.resume after we are back. */
3076     if (devctl_process_running())
3077 	acpi_UserNotify("Resume", ACPI_ROOT_OBJECT, state);
3078 
3079     return_ACPI_STATUS (status);
3080 }
3081 
3082 static void
3083 acpi_resync_clock(struct acpi_softc *sc)
3084 {
3085 
3086     /*
3087      * Warm up timecounter again and reset system clock.
3088      */
3089     (void)timecounter->tc_get_timecount(timecounter);
3090     (void)timecounter->tc_get_timecount(timecounter);
3091     inittodr(time_second + sc->acpi_sleep_delay);
3092 }
3093 
3094 /* Enable or disable the device's wake GPE. */
3095 int
3096 acpi_wake_set_enable(device_t dev, int enable)
3097 {
3098     struct acpi_prw_data prw;
3099     ACPI_STATUS status;
3100     int flags;
3101 
3102     /* Make sure the device supports waking the system and get the GPE. */
3103     if (acpi_parse_prw(acpi_get_handle(dev), &prw) != 0)
3104 	return (ENXIO);
3105 
3106     flags = acpi_get_flags(dev);
3107     if (enable) {
3108 	status = AcpiSetGpeWakeMask(prw.gpe_handle, prw.gpe_bit,
3109 	    ACPI_GPE_ENABLE);
3110 	if (ACPI_FAILURE(status)) {
3111 	    device_printf(dev, "enable wake failed\n");
3112 	    return (ENXIO);
3113 	}
3114 	acpi_set_flags(dev, flags | ACPI_FLAG_WAKE_ENABLED);
3115     } else {
3116 	status = AcpiSetGpeWakeMask(prw.gpe_handle, prw.gpe_bit,
3117 	    ACPI_GPE_DISABLE);
3118 	if (ACPI_FAILURE(status)) {
3119 	    device_printf(dev, "disable wake failed\n");
3120 	    return (ENXIO);
3121 	}
3122 	acpi_set_flags(dev, flags & ~ACPI_FLAG_WAKE_ENABLED);
3123     }
3124 
3125     return (0);
3126 }
3127 
3128 static int
3129 acpi_wake_sleep_prep(ACPI_HANDLE handle, int sstate)
3130 {
3131     struct acpi_prw_data prw;
3132     device_t dev;
3133 
3134     /* Check that this is a wake-capable device and get its GPE. */
3135     if (acpi_parse_prw(handle, &prw) != 0)
3136 	return (ENXIO);
3137     dev = acpi_get_device(handle);
3138 
3139     /*
3140      * The destination sleep state must be less than (i.e., higher power)
3141      * or equal to the value specified by _PRW.  If this GPE cannot be
3142      * enabled for the next sleep state, then disable it.  If it can and
3143      * the user requested it be enabled, turn on any required power resources
3144      * and set _PSW.
3145      */
3146     if (sstate > prw.lowest_wake) {
3147 	AcpiSetGpeWakeMask(prw.gpe_handle, prw.gpe_bit, ACPI_GPE_DISABLE);
3148 	if (bootverbose)
3149 	    device_printf(dev, "wake_prep disabled wake for %s (S%d)\n",
3150 		acpi_name(handle), sstate);
3151     } else if (dev && (acpi_get_flags(dev) & ACPI_FLAG_WAKE_ENABLED) != 0) {
3152 	acpi_pwr_wake_enable(handle, 1);
3153 	acpi_SetInteger(handle, "_PSW", 1);
3154 	if (bootverbose)
3155 	    device_printf(dev, "wake_prep enabled for %s (S%d)\n",
3156 		acpi_name(handle), sstate);
3157     }
3158 
3159     return (0);
3160 }
3161 
3162 static int
3163 acpi_wake_run_prep(ACPI_HANDLE handle, int sstate)
3164 {
3165     struct acpi_prw_data prw;
3166     device_t dev;
3167 
3168     /*
3169      * Check that this is a wake-capable device and get its GPE.  Return
3170      * now if the user didn't enable this device for wake.
3171      */
3172     if (acpi_parse_prw(handle, &prw) != 0)
3173 	return (ENXIO);
3174     dev = acpi_get_device(handle);
3175     if (dev == NULL || (acpi_get_flags(dev) & ACPI_FLAG_WAKE_ENABLED) == 0)
3176 	return (0);
3177 
3178     /*
3179      * If this GPE couldn't be enabled for the previous sleep state, it was
3180      * disabled before going to sleep so re-enable it.  If it was enabled,
3181      * clear _PSW and turn off any power resources it used.
3182      */
3183     if (sstate > prw.lowest_wake) {
3184 	AcpiSetGpeWakeMask(prw.gpe_handle, prw.gpe_bit, ACPI_GPE_ENABLE);
3185 	if (bootverbose)
3186 	    device_printf(dev, "run_prep re-enabled %s\n", acpi_name(handle));
3187     } else {
3188 	acpi_SetInteger(handle, "_PSW", 0);
3189 	acpi_pwr_wake_enable(handle, 0);
3190 	if (bootverbose)
3191 	    device_printf(dev, "run_prep cleaned up for %s\n",
3192 		acpi_name(handle));
3193     }
3194 
3195     return (0);
3196 }
3197 
3198 static ACPI_STATUS
3199 acpi_wake_prep(ACPI_HANDLE handle, UINT32 level, void *context, void **status)
3200 {
3201     int sstate;
3202 
3203     /* If suspending, run the sleep prep function, otherwise wake. */
3204     sstate = *(int *)context;
3205     if (AcpiGbl_SystemAwakeAndRunning)
3206 	acpi_wake_sleep_prep(handle, sstate);
3207     else
3208 	acpi_wake_run_prep(handle, sstate);
3209     return (AE_OK);
3210 }
3211 
3212 /* Walk the tree rooted at acpi0 to prep devices for suspend/resume. */
3213 static int
3214 acpi_wake_prep_walk(int sstate)
3215 {
3216     ACPI_HANDLE sb_handle;
3217 
3218     if (ACPI_SUCCESS(AcpiGetHandle(ACPI_ROOT_OBJECT, "\\_SB_", &sb_handle)))
3219 	AcpiWalkNamespace(ACPI_TYPE_DEVICE, sb_handle, 100,
3220 	    acpi_wake_prep, NULL, &sstate, NULL);
3221     return (0);
3222 }
3223 
3224 /* Walk the tree rooted at acpi0 to attach per-device wake sysctls. */
3225 static int
3226 acpi_wake_sysctl_walk(device_t dev)
3227 {
3228     int error, i, numdevs;
3229     device_t *devlist;
3230     device_t child;
3231     ACPI_STATUS status;
3232 
3233     error = device_get_children(dev, &devlist, &numdevs);
3234     if (error != 0 || numdevs == 0) {
3235 	if (numdevs == 0)
3236 	    free(devlist, M_TEMP);
3237 	return (error);
3238     }
3239     for (i = 0; i < numdevs; i++) {
3240 	child = devlist[i];
3241 	acpi_wake_sysctl_walk(child);
3242 	if (!device_is_attached(child))
3243 	    continue;
3244 	status = AcpiEvaluateObject(acpi_get_handle(child), "_PRW", NULL, NULL);
3245 	if (ACPI_SUCCESS(status)) {
3246 	    SYSCTL_ADD_PROC(device_get_sysctl_ctx(child),
3247 		SYSCTL_CHILDREN(device_get_sysctl_tree(child)), OID_AUTO,
3248 		"wake", CTLTYPE_INT | CTLFLAG_RW, child, 0,
3249 		acpi_wake_set_sysctl, "I", "Device set to wake the system");
3250 	}
3251     }
3252     free(devlist, M_TEMP);
3253 
3254     return (0);
3255 }
3256 
3257 /* Enable or disable wake from userland. */
3258 static int
3259 acpi_wake_set_sysctl(SYSCTL_HANDLER_ARGS)
3260 {
3261     int enable, error;
3262     device_t dev;
3263 
3264     dev = (device_t)arg1;
3265     enable = (acpi_get_flags(dev) & ACPI_FLAG_WAKE_ENABLED) ? 1 : 0;
3266 
3267     error = sysctl_handle_int(oidp, &enable, 0, req);
3268     if (error != 0 || req->newptr == NULL)
3269 	return (error);
3270     if (enable != 0 && enable != 1)
3271 	return (EINVAL);
3272 
3273     return (acpi_wake_set_enable(dev, enable));
3274 }
3275 
3276 /* Parse a device's _PRW into a structure. */
3277 int
3278 acpi_parse_prw(ACPI_HANDLE h, struct acpi_prw_data *prw)
3279 {
3280     ACPI_STATUS			status;
3281     ACPI_BUFFER			prw_buffer;
3282     ACPI_OBJECT			*res, *res2;
3283     int				error, i, power_count;
3284 
3285     if (h == NULL || prw == NULL)
3286 	return (EINVAL);
3287 
3288     /*
3289      * The _PRW object (7.2.9) is only required for devices that have the
3290      * ability to wake the system from a sleeping state.
3291      */
3292     error = EINVAL;
3293     prw_buffer.Pointer = NULL;
3294     prw_buffer.Length = ACPI_ALLOCATE_BUFFER;
3295     status = AcpiEvaluateObject(h, "_PRW", NULL, &prw_buffer);
3296     if (ACPI_FAILURE(status))
3297 	return (ENOENT);
3298     res = (ACPI_OBJECT *)prw_buffer.Pointer;
3299     if (res == NULL)
3300 	return (ENOENT);
3301     if (!ACPI_PKG_VALID(res, 2))
3302 	goto out;
3303 
3304     /*
3305      * Element 1 of the _PRW object:
3306      * The lowest power system sleeping state that can be entered while still
3307      * providing wake functionality.  The sleeping state being entered must
3308      * be less than (i.e., higher power) or equal to this value.
3309      */
3310     if (acpi_PkgInt32(res, 1, &prw->lowest_wake) != 0)
3311 	goto out;
3312 
3313     /*
3314      * Element 0 of the _PRW object:
3315      */
3316     switch (res->Package.Elements[0].Type) {
3317     case ACPI_TYPE_INTEGER:
3318 	/*
3319 	 * If the data type of this package element is numeric, then this
3320 	 * _PRW package element is the bit index in the GPEx_EN, in the
3321 	 * GPE blocks described in the FADT, of the enable bit that is
3322 	 * enabled for the wake event.
3323 	 */
3324 	prw->gpe_handle = NULL;
3325 	prw->gpe_bit = res->Package.Elements[0].Integer.Value;
3326 	error = 0;
3327 	break;
3328     case ACPI_TYPE_PACKAGE:
3329 	/*
3330 	 * If the data type of this package element is a package, then this
3331 	 * _PRW package element is itself a package containing two
3332 	 * elements.  The first is an object reference to the GPE Block
3333 	 * device that contains the GPE that will be triggered by the wake
3334 	 * event.  The second element is numeric and it contains the bit
3335 	 * index in the GPEx_EN, in the GPE Block referenced by the
3336 	 * first element in the package, of the enable bit that is enabled for
3337 	 * the wake event.
3338 	 *
3339 	 * For example, if this field is a package then it is of the form:
3340 	 * Package() {\_SB.PCI0.ISA.GPE, 2}
3341 	 */
3342 	res2 = &res->Package.Elements[0];
3343 	if (!ACPI_PKG_VALID(res2, 2))
3344 	    goto out;
3345 	prw->gpe_handle = acpi_GetReference(NULL, &res2->Package.Elements[0]);
3346 	if (prw->gpe_handle == NULL)
3347 	    goto out;
3348 	if (acpi_PkgInt32(res2, 1, &prw->gpe_bit) != 0)
3349 	    goto out;
3350 	error = 0;
3351 	break;
3352     default:
3353 	goto out;
3354     }
3355 
3356     /* Elements 2 to N of the _PRW object are power resources. */
3357     power_count = res->Package.Count - 2;
3358     if (power_count > ACPI_PRW_MAX_POWERRES) {
3359 	printf("ACPI device %s has too many power resources\n", acpi_name(h));
3360 	power_count = 0;
3361     }
3362     prw->power_res_count = power_count;
3363     for (i = 0; i < power_count; i++)
3364 	prw->power_res[i] = res->Package.Elements[i];
3365 
3366 out:
3367     if (prw_buffer.Pointer != NULL)
3368 	AcpiOsFree(prw_buffer.Pointer);
3369     return (error);
3370 }
3371 
3372 /*
3373  * ACPI Event Handlers
3374  */
3375 
3376 /* System Event Handlers (registered by EVENTHANDLER_REGISTER) */
3377 
3378 static void
3379 acpi_system_eventhandler_sleep(void *arg, int state)
3380 {
3381     struct acpi_softc *sc = (struct acpi_softc *)arg;
3382     int ret;
3383 
3384     ACPI_FUNCTION_TRACE_U32((char *)(uintptr_t)__func__, state);
3385 
3386     /* Check if button action is disabled or unknown. */
3387     if (state == ACPI_STATE_UNKNOWN)
3388 	return;
3389 
3390     /* Request that the system prepare to enter the given suspend state. */
3391     ret = acpi_ReqSleepState(sc, state);
3392     if (ret != 0)
3393 	device_printf(sc->acpi_dev,
3394 	    "request to enter state S%d failed (err %d)\n", state, ret);
3395 
3396     return_VOID;
3397 }
3398 
3399 static void
3400 acpi_system_eventhandler_wakeup(void *arg, int state)
3401 {
3402 
3403     ACPI_FUNCTION_TRACE_U32((char *)(uintptr_t)__func__, state);
3404 
3405     /* Currently, nothing to do for wakeup. */
3406 
3407     return_VOID;
3408 }
3409 
3410 /*
3411  * ACPICA Event Handlers (FixedEvent, also called from button notify handler)
3412  */
3413 static void
3414 acpi_invoke_sleep_eventhandler(void *context)
3415 {
3416 
3417     EVENTHANDLER_INVOKE(acpi_sleep_event, *(int *)context);
3418 }
3419 
3420 static void
3421 acpi_invoke_wake_eventhandler(void *context)
3422 {
3423 
3424     EVENTHANDLER_INVOKE(acpi_wakeup_event, *(int *)context);
3425 }
3426 
3427 UINT32
3428 acpi_event_power_button_sleep(void *context)
3429 {
3430     struct acpi_softc	*sc = (struct acpi_softc *)context;
3431 
3432     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
3433 
3434     if (ACPI_FAILURE(AcpiOsExecute(OSL_NOTIFY_HANDLER,
3435 	acpi_invoke_sleep_eventhandler, &sc->acpi_power_button_sx)))
3436 	return_VALUE (ACPI_INTERRUPT_NOT_HANDLED);
3437     return_VALUE (ACPI_INTERRUPT_HANDLED);
3438 }
3439 
3440 UINT32
3441 acpi_event_power_button_wake(void *context)
3442 {
3443     struct acpi_softc	*sc = (struct acpi_softc *)context;
3444 
3445     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
3446 
3447     if (ACPI_FAILURE(AcpiOsExecute(OSL_NOTIFY_HANDLER,
3448 	acpi_invoke_wake_eventhandler, &sc->acpi_power_button_sx)))
3449 	return_VALUE (ACPI_INTERRUPT_NOT_HANDLED);
3450     return_VALUE (ACPI_INTERRUPT_HANDLED);
3451 }
3452 
3453 UINT32
3454 acpi_event_sleep_button_sleep(void *context)
3455 {
3456     struct acpi_softc	*sc = (struct acpi_softc *)context;
3457 
3458     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
3459 
3460     if (ACPI_FAILURE(AcpiOsExecute(OSL_NOTIFY_HANDLER,
3461 	acpi_invoke_sleep_eventhandler, &sc->acpi_sleep_button_sx)))
3462 	return_VALUE (ACPI_INTERRUPT_NOT_HANDLED);
3463     return_VALUE (ACPI_INTERRUPT_HANDLED);
3464 }
3465 
3466 UINT32
3467 acpi_event_sleep_button_wake(void *context)
3468 {
3469     struct acpi_softc	*sc = (struct acpi_softc *)context;
3470 
3471     ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
3472 
3473     if (ACPI_FAILURE(AcpiOsExecute(OSL_NOTIFY_HANDLER,
3474 	acpi_invoke_wake_eventhandler, &sc->acpi_sleep_button_sx)))
3475 	return_VALUE (ACPI_INTERRUPT_NOT_HANDLED);
3476     return_VALUE (ACPI_INTERRUPT_HANDLED);
3477 }
3478 
3479 /*
3480  * XXX This static buffer is suboptimal.  There is no locking so only
3481  * use this for single-threaded callers.
3482  */
3483 char *
3484 acpi_name(ACPI_HANDLE handle)
3485 {
3486     ACPI_BUFFER buf;
3487     static char data[256];
3488 
3489     buf.Length = sizeof(data);
3490     buf.Pointer = data;
3491 
3492     if (handle && ACPI_SUCCESS(AcpiGetName(handle, ACPI_FULL_PATHNAME, &buf)))
3493 	return (data);
3494     return ("(unknown)");
3495 }
3496 
3497 /*
3498  * Debugging/bug-avoidance.  Avoid trying to fetch info on various
3499  * parts of the namespace.
3500  */
3501 int
3502 acpi_avoid(ACPI_HANDLE handle)
3503 {
3504     char	*cp, *env, *np;
3505     int		len;
3506 
3507     np = acpi_name(handle);
3508     if (*np == '\\')
3509 	np++;
3510     if ((env = kern_getenv("debug.acpi.avoid")) == NULL)
3511 	return (0);
3512 
3513     /* Scan the avoid list checking for a match */
3514     cp = env;
3515     for (;;) {
3516 	while (*cp != 0 && isspace(*cp))
3517 	    cp++;
3518 	if (*cp == 0)
3519 	    break;
3520 	len = 0;
3521 	while (cp[len] != 0 && !isspace(cp[len]))
3522 	    len++;
3523 	if (!strncmp(cp, np, len)) {
3524 	    freeenv(env);
3525 	    return(1);
3526 	}
3527 	cp += len;
3528     }
3529     freeenv(env);
3530 
3531     return (0);
3532 }
3533 
3534 /*
3535  * Debugging/bug-avoidance.  Disable ACPI subsystem components.
3536  */
3537 int
3538 acpi_disabled(char *subsys)
3539 {
3540     char	*cp, *env;
3541     int		len;
3542 
3543     if ((env = kern_getenv("debug.acpi.disabled")) == NULL)
3544 	return (0);
3545     if (strcmp(env, "all") == 0) {
3546 	freeenv(env);
3547 	return (1);
3548     }
3549 
3550     /* Scan the disable list, checking for a match. */
3551     cp = env;
3552     for (;;) {
3553 	while (*cp != '\0' && isspace(*cp))
3554 	    cp++;
3555 	if (*cp == '\0')
3556 	    break;
3557 	len = 0;
3558 	while (cp[len] != '\0' && !isspace(cp[len]))
3559 	    len++;
3560 	if (strncmp(cp, subsys, len) == 0) {
3561 	    freeenv(env);
3562 	    return (1);
3563 	}
3564 	cp += len;
3565     }
3566     freeenv(env);
3567 
3568     return (0);
3569 }
3570 
3571 static void
3572 acpi_lookup(void *arg, const char *name, device_t *dev)
3573 {
3574     ACPI_HANDLE handle;
3575 
3576     if (*dev != NULL)
3577 	return;
3578 
3579     /*
3580      * Allow any handle name that is specified as an absolute path and
3581      * starts with '\'.  We could restrict this to \_SB and friends,
3582      * but see acpi_probe_children() for notes on why we scan the entire
3583      * namespace for devices.
3584      *
3585      * XXX: The pathname argument to AcpiGetHandle() should be fixed to
3586      * be const.
3587      */
3588     if (name[0] != '\\')
3589 	return;
3590     if (ACPI_FAILURE(AcpiGetHandle(ACPI_ROOT_OBJECT, __DECONST(char *, name),
3591 	&handle)))
3592 	return;
3593     *dev = acpi_get_device(handle);
3594 }
3595 
3596 /*
3597  * Control interface.
3598  *
3599  * We multiplex ioctls for all participating ACPI devices here.  Individual
3600  * drivers wanting to be accessible via /dev/acpi should use the
3601  * register/deregister interface to make their handlers visible.
3602  */
3603 struct acpi_ioctl_hook
3604 {
3605     TAILQ_ENTRY(acpi_ioctl_hook) link;
3606     u_long			 cmd;
3607     acpi_ioctl_fn		 fn;
3608     void			 *arg;
3609 };
3610 
3611 static TAILQ_HEAD(,acpi_ioctl_hook)	acpi_ioctl_hooks;
3612 static int				acpi_ioctl_hooks_initted;
3613 
3614 int
3615 acpi_register_ioctl(u_long cmd, acpi_ioctl_fn fn, void *arg)
3616 {
3617     struct acpi_ioctl_hook	*hp;
3618 
3619     if ((hp = malloc(sizeof(*hp), M_ACPIDEV, M_NOWAIT)) == NULL)
3620 	return (ENOMEM);
3621     hp->cmd = cmd;
3622     hp->fn = fn;
3623     hp->arg = arg;
3624 
3625     ACPI_LOCK(acpi);
3626     if (acpi_ioctl_hooks_initted == 0) {
3627 	TAILQ_INIT(&acpi_ioctl_hooks);
3628 	acpi_ioctl_hooks_initted = 1;
3629     }
3630     TAILQ_INSERT_TAIL(&acpi_ioctl_hooks, hp, link);
3631     ACPI_UNLOCK(acpi);
3632 
3633     return (0);
3634 }
3635 
3636 void
3637 acpi_deregister_ioctl(u_long cmd, acpi_ioctl_fn fn)
3638 {
3639     struct acpi_ioctl_hook	*hp;
3640 
3641     ACPI_LOCK(acpi);
3642     TAILQ_FOREACH(hp, &acpi_ioctl_hooks, link)
3643 	if (hp->cmd == cmd && hp->fn == fn)
3644 	    break;
3645 
3646     if (hp != NULL) {
3647 	TAILQ_REMOVE(&acpi_ioctl_hooks, hp, link);
3648 	free(hp, M_ACPIDEV);
3649     }
3650     ACPI_UNLOCK(acpi);
3651 }
3652 
3653 static int
3654 acpiopen(struct cdev *dev, int flag, int fmt, struct thread *td)
3655 {
3656     return (0);
3657 }
3658 
3659 static int
3660 acpiclose(struct cdev *dev, int flag, int fmt, struct thread *td)
3661 {
3662     return (0);
3663 }
3664 
3665 static int
3666 acpiioctl(struct cdev *dev, u_long cmd, caddr_t addr, int flag, struct thread *td)
3667 {
3668     struct acpi_softc		*sc;
3669     struct acpi_ioctl_hook	*hp;
3670     int				error, state;
3671 
3672     error = 0;
3673     hp = NULL;
3674     sc = dev->si_drv1;
3675 
3676     /*
3677      * Scan the list of registered ioctls, looking for handlers.
3678      */
3679     ACPI_LOCK(acpi);
3680     if (acpi_ioctl_hooks_initted)
3681 	TAILQ_FOREACH(hp, &acpi_ioctl_hooks, link) {
3682 	    if (hp->cmd == cmd)
3683 		break;
3684 	}
3685     ACPI_UNLOCK(acpi);
3686     if (hp)
3687 	return (hp->fn(cmd, addr, hp->arg));
3688 
3689     /*
3690      * Core ioctls are not permitted for non-writable user.
3691      * Currently, other ioctls just fetch information.
3692      * Not changing system behavior.
3693      */
3694     if ((flag & FWRITE) == 0)
3695 	return (EPERM);
3696 
3697     /* Core system ioctls. */
3698     switch (cmd) {
3699     case ACPIIO_REQSLPSTATE:
3700 	state = *(int *)addr;
3701 	if (state != ACPI_STATE_S5)
3702 	    return (acpi_ReqSleepState(sc, state));
3703 	device_printf(sc->acpi_dev, "power off via acpi ioctl not supported\n");
3704 	error = EOPNOTSUPP;
3705 	break;
3706     case ACPIIO_ACKSLPSTATE:
3707 	error = *(int *)addr;
3708 	error = acpi_AckSleepState(sc->acpi_clone, error);
3709 	break;
3710     case ACPIIO_SETSLPSTATE:	/* DEPRECATED */
3711 	state = *(int *)addr;
3712 	if (state < ACPI_STATE_S0 || state > ACPI_S_STATES_MAX)
3713 	    return (EINVAL);
3714 	if (!acpi_sleep_states[state])
3715 	    return (EOPNOTSUPP);
3716 	if (ACPI_FAILURE(acpi_SetSleepState(sc, state)))
3717 	    error = ENXIO;
3718 	break;
3719     default:
3720 	error = ENXIO;
3721 	break;
3722     }
3723 
3724     return (error);
3725 }
3726 
3727 static int
3728 acpi_sname2sstate(const char *sname)
3729 {
3730     int sstate;
3731 
3732     if (toupper(sname[0]) == 'S') {
3733 	sstate = sname[1] - '0';
3734 	if (sstate >= ACPI_STATE_S0 && sstate <= ACPI_STATE_S5 &&
3735 	    sname[2] == '\0')
3736 	    return (sstate);
3737     } else if (strcasecmp(sname, "NONE") == 0)
3738 	return (ACPI_STATE_UNKNOWN);
3739     return (-1);
3740 }
3741 
3742 static const char *
3743 acpi_sstate2sname(int sstate)
3744 {
3745     static const char *snames[] = { "S0", "S1", "S2", "S3", "S4", "S5" };
3746 
3747     if (sstate >= ACPI_STATE_S0 && sstate <= ACPI_STATE_S5)
3748 	return (snames[sstate]);
3749     else if (sstate == ACPI_STATE_UNKNOWN)
3750 	return ("NONE");
3751     return (NULL);
3752 }
3753 
3754 static int
3755 acpi_supported_sleep_state_sysctl(SYSCTL_HANDLER_ARGS)
3756 {
3757     int error;
3758     struct sbuf sb;
3759     UINT8 state;
3760 
3761     sbuf_new(&sb, NULL, 32, SBUF_AUTOEXTEND);
3762     for (state = ACPI_STATE_S1; state < ACPI_S_STATE_COUNT; state++)
3763 	if (acpi_sleep_states[state])
3764 	    sbuf_printf(&sb, "%s ", acpi_sstate2sname(state));
3765     sbuf_trim(&sb);
3766     sbuf_finish(&sb);
3767     error = sysctl_handle_string(oidp, sbuf_data(&sb), sbuf_len(&sb), req);
3768     sbuf_delete(&sb);
3769     return (error);
3770 }
3771 
3772 static int
3773 acpi_sleep_state_sysctl(SYSCTL_HANDLER_ARGS)
3774 {
3775     char sleep_state[10];
3776     int error, new_state, old_state;
3777 
3778     old_state = *(int *)oidp->oid_arg1;
3779     strlcpy(sleep_state, acpi_sstate2sname(old_state), sizeof(sleep_state));
3780     error = sysctl_handle_string(oidp, sleep_state, sizeof(sleep_state), req);
3781     if (error == 0 && req->newptr != NULL) {
3782 	new_state = acpi_sname2sstate(sleep_state);
3783 	if (new_state < ACPI_STATE_S1)
3784 	    return (EINVAL);
3785 	if (new_state < ACPI_S_STATE_COUNT && !acpi_sleep_states[new_state])
3786 	    return (EOPNOTSUPP);
3787 	if (new_state != old_state)
3788 	    *(int *)oidp->oid_arg1 = new_state;
3789     }
3790     return (error);
3791 }
3792 
3793 /* Inform devctl(4) when we receive a Notify. */
3794 void
3795 acpi_UserNotify(const char *subsystem, ACPI_HANDLE h, uint8_t notify)
3796 {
3797     char		notify_buf[16];
3798     ACPI_BUFFER		handle_buf;
3799     ACPI_STATUS		status;
3800 
3801     if (subsystem == NULL)
3802 	return;
3803 
3804     handle_buf.Pointer = NULL;
3805     handle_buf.Length = ACPI_ALLOCATE_BUFFER;
3806     status = AcpiNsHandleToPathname(h, &handle_buf, FALSE);
3807     if (ACPI_FAILURE(status))
3808 	return;
3809     snprintf(notify_buf, sizeof(notify_buf), "notify=0x%02x", notify);
3810     devctl_notify("ACPI", subsystem, handle_buf.Pointer, notify_buf);
3811     AcpiOsFree(handle_buf.Pointer);
3812 }
3813 
3814 #ifdef ACPI_DEBUG
3815 /*
3816  * Support for parsing debug options from the kernel environment.
3817  *
3818  * Bits may be set in the AcpiDbgLayer and AcpiDbgLevel debug registers
3819  * by specifying the names of the bits in the debug.acpi.layer and
3820  * debug.acpi.level environment variables.  Bits may be unset by
3821  * prefixing the bit name with !.
3822  */
3823 struct debugtag
3824 {
3825     char	*name;
3826     UINT32	value;
3827 };
3828 
3829 static struct debugtag	dbg_layer[] = {
3830     {"ACPI_UTILITIES",		ACPI_UTILITIES},
3831     {"ACPI_HARDWARE",		ACPI_HARDWARE},
3832     {"ACPI_EVENTS",		ACPI_EVENTS},
3833     {"ACPI_TABLES",		ACPI_TABLES},
3834     {"ACPI_NAMESPACE",		ACPI_NAMESPACE},
3835     {"ACPI_PARSER",		ACPI_PARSER},
3836     {"ACPI_DISPATCHER",		ACPI_DISPATCHER},
3837     {"ACPI_EXECUTER",		ACPI_EXECUTER},
3838     {"ACPI_RESOURCES",		ACPI_RESOURCES},
3839     {"ACPI_CA_DEBUGGER",	ACPI_CA_DEBUGGER},
3840     {"ACPI_OS_SERVICES",	ACPI_OS_SERVICES},
3841     {"ACPI_CA_DISASSEMBLER",	ACPI_CA_DISASSEMBLER},
3842     {"ACPI_ALL_COMPONENTS",	ACPI_ALL_COMPONENTS},
3843 
3844     {"ACPI_AC_ADAPTER",		ACPI_AC_ADAPTER},
3845     {"ACPI_BATTERY",		ACPI_BATTERY},
3846     {"ACPI_BUS",		ACPI_BUS},
3847     {"ACPI_BUTTON",		ACPI_BUTTON},
3848     {"ACPI_EC", 		ACPI_EC},
3849     {"ACPI_FAN",		ACPI_FAN},
3850     {"ACPI_POWERRES",		ACPI_POWERRES},
3851     {"ACPI_PROCESSOR",		ACPI_PROCESSOR},
3852     {"ACPI_THERMAL",		ACPI_THERMAL},
3853     {"ACPI_TIMER",		ACPI_TIMER},
3854     {"ACPI_ALL_DRIVERS",	ACPI_ALL_DRIVERS},
3855     {NULL, 0}
3856 };
3857 
3858 static struct debugtag dbg_level[] = {
3859     {"ACPI_LV_INIT",		ACPI_LV_INIT},
3860     {"ACPI_LV_DEBUG_OBJECT",	ACPI_LV_DEBUG_OBJECT},
3861     {"ACPI_LV_INFO",		ACPI_LV_INFO},
3862     {"ACPI_LV_REPAIR",		ACPI_LV_REPAIR},
3863     {"ACPI_LV_ALL_EXCEPTIONS",	ACPI_LV_ALL_EXCEPTIONS},
3864 
3865     /* Trace verbosity level 1 [Standard Trace Level] */
3866     {"ACPI_LV_INIT_NAMES",	ACPI_LV_INIT_NAMES},
3867     {"ACPI_LV_PARSE",		ACPI_LV_PARSE},
3868     {"ACPI_LV_LOAD",		ACPI_LV_LOAD},
3869     {"ACPI_LV_DISPATCH",	ACPI_LV_DISPATCH},
3870     {"ACPI_LV_EXEC",		ACPI_LV_EXEC},
3871     {"ACPI_LV_NAMES",		ACPI_LV_NAMES},
3872     {"ACPI_LV_OPREGION",	ACPI_LV_OPREGION},
3873     {"ACPI_LV_BFIELD",		ACPI_LV_BFIELD},
3874     {"ACPI_LV_TABLES",		ACPI_LV_TABLES},
3875     {"ACPI_LV_VALUES",		ACPI_LV_VALUES},
3876     {"ACPI_LV_OBJECTS",		ACPI_LV_OBJECTS},
3877     {"ACPI_LV_RESOURCES",	ACPI_LV_RESOURCES},
3878     {"ACPI_LV_USER_REQUESTS",	ACPI_LV_USER_REQUESTS},
3879     {"ACPI_LV_PACKAGE",		ACPI_LV_PACKAGE},
3880     {"ACPI_LV_VERBOSITY1",	ACPI_LV_VERBOSITY1},
3881 
3882     /* Trace verbosity level 2 [Function tracing and memory allocation] */
3883     {"ACPI_LV_ALLOCATIONS",	ACPI_LV_ALLOCATIONS},
3884     {"ACPI_LV_FUNCTIONS",	ACPI_LV_FUNCTIONS},
3885     {"ACPI_LV_OPTIMIZATIONS",	ACPI_LV_OPTIMIZATIONS},
3886     {"ACPI_LV_VERBOSITY2",	ACPI_LV_VERBOSITY2},
3887     {"ACPI_LV_ALL",		ACPI_LV_ALL},
3888 
3889     /* Trace verbosity level 3 [Threading, I/O, and Interrupts] */
3890     {"ACPI_LV_MUTEX",		ACPI_LV_MUTEX},
3891     {"ACPI_LV_THREADS",		ACPI_LV_THREADS},
3892     {"ACPI_LV_IO",		ACPI_LV_IO},
3893     {"ACPI_LV_INTERRUPTS",	ACPI_LV_INTERRUPTS},
3894     {"ACPI_LV_VERBOSITY3",	ACPI_LV_VERBOSITY3},
3895 
3896     /* Exceptionally verbose output -- also used in the global "DebugLevel"  */
3897     {"ACPI_LV_AML_DISASSEMBLE",	ACPI_LV_AML_DISASSEMBLE},
3898     {"ACPI_LV_VERBOSE_INFO",	ACPI_LV_VERBOSE_INFO},
3899     {"ACPI_LV_FULL_TABLES",	ACPI_LV_FULL_TABLES},
3900     {"ACPI_LV_EVENTS",		ACPI_LV_EVENTS},
3901     {"ACPI_LV_VERBOSE",		ACPI_LV_VERBOSE},
3902     {NULL, 0}
3903 };
3904 
3905 static void
3906 acpi_parse_debug(char *cp, struct debugtag *tag, UINT32 *flag)
3907 {
3908     char	*ep;
3909     int		i, l;
3910     int		set;
3911 
3912     while (*cp) {
3913 	if (isspace(*cp)) {
3914 	    cp++;
3915 	    continue;
3916 	}
3917 	ep = cp;
3918 	while (*ep && !isspace(*ep))
3919 	    ep++;
3920 	if (*cp == '!') {
3921 	    set = 0;
3922 	    cp++;
3923 	    if (cp == ep)
3924 		continue;
3925 	} else {
3926 	    set = 1;
3927 	}
3928 	l = ep - cp;
3929 	for (i = 0; tag[i].name != NULL; i++) {
3930 	    if (!strncmp(cp, tag[i].name, l)) {
3931 		if (set)
3932 		    *flag |= tag[i].value;
3933 		else
3934 		    *flag &= ~tag[i].value;
3935 	    }
3936 	}
3937 	cp = ep;
3938     }
3939 }
3940 
3941 static void
3942 acpi_set_debugging(void *junk)
3943 {
3944     char	*layer, *level;
3945 
3946     if (cold) {
3947 	AcpiDbgLayer = 0;
3948 	AcpiDbgLevel = 0;
3949     }
3950 
3951     layer = kern_getenv("debug.acpi.layer");
3952     level = kern_getenv("debug.acpi.level");
3953     if (layer == NULL && level == NULL)
3954 	return;
3955 
3956     printf("ACPI set debug");
3957     if (layer != NULL) {
3958 	if (strcmp("NONE", layer) != 0)
3959 	    printf(" layer '%s'", layer);
3960 	acpi_parse_debug(layer, &dbg_layer[0], &AcpiDbgLayer);
3961 	freeenv(layer);
3962     }
3963     if (level != NULL) {
3964 	if (strcmp("NONE", level) != 0)
3965 	    printf(" level '%s'", level);
3966 	acpi_parse_debug(level, &dbg_level[0], &AcpiDbgLevel);
3967 	freeenv(level);
3968     }
3969     printf("\n");
3970 }
3971 
3972 SYSINIT(acpi_debugging, SI_SUB_TUNABLES, SI_ORDER_ANY, acpi_set_debugging,
3973 	NULL);
3974 
3975 static int
3976 acpi_debug_sysctl(SYSCTL_HANDLER_ARGS)
3977 {
3978     int		 error, *dbg;
3979     struct	 debugtag *tag;
3980     struct	 sbuf sb;
3981     char	 temp[128];
3982 
3983     if (sbuf_new(&sb, NULL, 128, SBUF_AUTOEXTEND) == NULL)
3984 	return (ENOMEM);
3985     if (strcmp(oidp->oid_arg1, "debug.acpi.layer") == 0) {
3986 	tag = &dbg_layer[0];
3987 	dbg = &AcpiDbgLayer;
3988     } else {
3989 	tag = &dbg_level[0];
3990 	dbg = &AcpiDbgLevel;
3991     }
3992 
3993     /* Get old values if this is a get request. */
3994     ACPI_SERIAL_BEGIN(acpi);
3995     if (*dbg == 0) {
3996 	sbuf_cpy(&sb, "NONE");
3997     } else if (req->newptr == NULL) {
3998 	for (; tag->name != NULL; tag++) {
3999 	    if ((*dbg & tag->value) == tag->value)
4000 		sbuf_printf(&sb, "%s ", tag->name);
4001 	}
4002     }
4003     sbuf_trim(&sb);
4004     sbuf_finish(&sb);
4005     strlcpy(temp, sbuf_data(&sb), sizeof(temp));
4006     sbuf_delete(&sb);
4007 
4008     error = sysctl_handle_string(oidp, temp, sizeof(temp), req);
4009 
4010     /* Check for error or no change */
4011     if (error == 0 && req->newptr != NULL) {
4012 	*dbg = 0;
4013 	kern_setenv((char *)oidp->oid_arg1, temp);
4014 	acpi_set_debugging(NULL);
4015     }
4016     ACPI_SERIAL_END(acpi);
4017 
4018     return (error);
4019 }
4020 
4021 SYSCTL_PROC(_debug_acpi, OID_AUTO, layer, CTLFLAG_RW | CTLTYPE_STRING,
4022 	    "debug.acpi.layer", 0, acpi_debug_sysctl, "A", "");
4023 SYSCTL_PROC(_debug_acpi, OID_AUTO, level, CTLFLAG_RW | CTLTYPE_STRING,
4024 	    "debug.acpi.level", 0, acpi_debug_sysctl, "A", "");
4025 #endif /* ACPI_DEBUG */
4026 
4027 static int
4028 acpi_debug_objects_sysctl(SYSCTL_HANDLER_ARGS)
4029 {
4030 	int	error;
4031 	int	old;
4032 
4033 	old = acpi_debug_objects;
4034 	error = sysctl_handle_int(oidp, &acpi_debug_objects, 0, req);
4035 	if (error != 0 || req->newptr == NULL)
4036 		return (error);
4037 	if (old == acpi_debug_objects || (old && acpi_debug_objects))
4038 		return (0);
4039 
4040 	ACPI_SERIAL_BEGIN(acpi);
4041 	AcpiGbl_EnableAmlDebugObject = acpi_debug_objects ? TRUE : FALSE;
4042 	ACPI_SERIAL_END(acpi);
4043 
4044 	return (0);
4045 }
4046 
4047 static int
4048 acpi_parse_interfaces(char *str, struct acpi_interface *iface)
4049 {
4050 	char *p;
4051 	size_t len;
4052 	int i, j;
4053 
4054 	p = str;
4055 	while (isspace(*p) || *p == ',')
4056 		p++;
4057 	len = strlen(p);
4058 	if (len == 0)
4059 		return (0);
4060 	p = strdup(p, M_TEMP);
4061 	for (i = 0; i < len; i++)
4062 		if (p[i] == ',')
4063 			p[i] = '\0';
4064 	i = j = 0;
4065 	while (i < len)
4066 		if (isspace(p[i]) || p[i] == '\0')
4067 			i++;
4068 		else {
4069 			i += strlen(p + i) + 1;
4070 			j++;
4071 		}
4072 	if (j == 0) {
4073 		free(p, M_TEMP);
4074 		return (0);
4075 	}
4076 	iface->data = malloc(sizeof(*iface->data) * j, M_TEMP, M_WAITOK);
4077 	iface->num = j;
4078 	i = j = 0;
4079 	while (i < len)
4080 		if (isspace(p[i]) || p[i] == '\0')
4081 			i++;
4082 		else {
4083 			iface->data[j] = p + i;
4084 			i += strlen(p + i) + 1;
4085 			j++;
4086 		}
4087 
4088 	return (j);
4089 }
4090 
4091 static void
4092 acpi_free_interfaces(struct acpi_interface *iface)
4093 {
4094 
4095 	free(iface->data[0], M_TEMP);
4096 	free(iface->data, M_TEMP);
4097 }
4098 
4099 static void
4100 acpi_reset_interfaces(device_t dev)
4101 {
4102 	struct acpi_interface list;
4103 	ACPI_STATUS status;
4104 	int i;
4105 
4106 	if (acpi_parse_interfaces(acpi_install_interface, &list) > 0) {
4107 		for (i = 0; i < list.num; i++) {
4108 			status = AcpiInstallInterface(list.data[i]);
4109 			if (ACPI_FAILURE(status))
4110 				device_printf(dev,
4111 				    "failed to install _OSI(\"%s\"): %s\n",
4112 				    list.data[i], AcpiFormatException(status));
4113 			else if (bootverbose)
4114 				device_printf(dev, "installed _OSI(\"%s\")\n",
4115 				    list.data[i]);
4116 		}
4117 		acpi_free_interfaces(&list);
4118 	}
4119 	if (acpi_parse_interfaces(acpi_remove_interface, &list) > 0) {
4120 		for (i = 0; i < list.num; i++) {
4121 			status = AcpiRemoveInterface(list.data[i]);
4122 			if (ACPI_FAILURE(status))
4123 				device_printf(dev,
4124 				    "failed to remove _OSI(\"%s\"): %s\n",
4125 				    list.data[i], AcpiFormatException(status));
4126 			else if (bootverbose)
4127 				device_printf(dev, "removed _OSI(\"%s\")\n",
4128 				    list.data[i]);
4129 		}
4130 		acpi_free_interfaces(&list);
4131 	}
4132 }
4133 
4134 static int
4135 acpi_pm_func(u_long cmd, void *arg, ...)
4136 {
4137 	int	state, acpi_state;
4138 	int	error;
4139 	struct	acpi_softc *sc;
4140 	va_list	ap;
4141 
4142 	error = 0;
4143 	switch (cmd) {
4144 	case POWER_CMD_SUSPEND:
4145 		sc = (struct acpi_softc *)arg;
4146 		if (sc == NULL) {
4147 			error = EINVAL;
4148 			goto out;
4149 		}
4150 
4151 		va_start(ap, arg);
4152 		state = va_arg(ap, int);
4153 		va_end(ap);
4154 
4155 		switch (state) {
4156 		case POWER_SLEEP_STATE_STANDBY:
4157 			acpi_state = sc->acpi_standby_sx;
4158 			break;
4159 		case POWER_SLEEP_STATE_SUSPEND:
4160 			acpi_state = sc->acpi_suspend_sx;
4161 			break;
4162 		case POWER_SLEEP_STATE_HIBERNATE:
4163 			acpi_state = ACPI_STATE_S4;
4164 			break;
4165 		default:
4166 			error = EINVAL;
4167 			goto out;
4168 		}
4169 
4170 		if (ACPI_FAILURE(acpi_EnterSleepState(sc, acpi_state)))
4171 			error = ENXIO;
4172 		break;
4173 	default:
4174 		error = EINVAL;
4175 		goto out;
4176 	}
4177 
4178 out:
4179 	return (error);
4180 }
4181 
4182 static void
4183 acpi_pm_register(void *arg)
4184 {
4185     if (!cold || resource_disabled("acpi", 0))
4186 	return;
4187 
4188     power_pm_register(POWER_PM_TYPE_ACPI, acpi_pm_func, NULL);
4189 }
4190 
4191 SYSINIT(power, SI_SUB_KLD, SI_ORDER_ANY, acpi_pm_register, 0);
4192