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
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
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.
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
30 #include <sys/cdefs.h>
31 __FBSDID("$FreeBSD$");
34 #include <sys/param.h>
35 #include <sys/kernel.h>
37 #include <sys/fcntl.h>
38 #include <sys/malloc.h>
39 #include <sys/module.h>
42 #include <sys/ioccom.h>
43 #include <sys/reboot.h>
44 #include <sys/sysctl.h>
45 #include <sys/ctype.h>
46 #include <sys/linker.h>
47 #include <sys/power.h>
51 #include <machine/clock.h>
52 #include <machine/resource.h>
53 #include <machine/bus.h>
55 #include <isa/isavar.h>
56 #include <isa/pnpvar.h>
58 #include <contrib/dev/acpica/acpi.h>
59 #include <dev/acpica/acpivar.h>
60 #include <dev/acpica/acpiio.h>
61 #include <contrib/dev/acpica/acnamesp.h>
64 #include <dev/pci/pcivar.h>
65 #include <dev/pci/pci_private.h>
67 MALLOC_DEFINE(M_ACPIDEV, "acpidev", "ACPI devices");
69 /* Hooks for the ACPI CA debugging infrastructure */
70 #define _COMPONENT ACPI_BUS
71 ACPI_MODULE_NAME("ACPI")
73 static d_open_t acpiopen;
74 static d_close_t acpiclose;
75 static d_ioctl_t acpiioctl;
77 static struct cdevsw acpi_cdevsw = {
78 .d_version = D_VERSION,
85 /* Global mutex for locking access to the ACPI subsystem. */
86 struct mtx acpi_mutex;
88 /* Bitmap of device quirks. */
91 static int acpi_modevent(struct module *mod, int event, void *junk);
92 static void acpi_identify(driver_t *driver, device_t parent);
93 static int acpi_probe(device_t dev);
94 static int acpi_attach(device_t dev);
95 static int acpi_suspend(device_t dev);
96 static int acpi_resume(device_t dev);
97 static int acpi_shutdown(device_t dev);
98 static device_t acpi_add_child(device_t bus, int order, const char *name,
100 static int acpi_print_child(device_t bus, device_t child);
101 static void acpi_probe_nomatch(device_t bus, device_t child);
102 static void acpi_driver_added(device_t dev, driver_t *driver);
103 static int acpi_read_ivar(device_t dev, device_t child, int index,
105 static int acpi_write_ivar(device_t dev, device_t child, int index,
107 static struct resource_list *acpi_get_rlist(device_t dev, device_t child);
108 static int acpi_sysres_alloc(device_t dev);
109 static struct resource_list_entry *acpi_sysres_find(device_t dev, int type,
111 static struct resource *acpi_alloc_resource(device_t bus, device_t child,
112 int type, int *rid, u_long start, u_long end,
113 u_long count, u_int flags);
114 static int acpi_release_resource(device_t bus, device_t child, int type,
115 int rid, struct resource *r);
116 static void acpi_delete_resource(device_t bus, device_t child, int type,
118 static uint32_t acpi_isa_get_logicalid(device_t dev);
119 static int acpi_isa_get_compatid(device_t dev, uint32_t *cids, int count);
120 static char *acpi_device_id_probe(device_t bus, device_t dev, char **ids);
121 static ACPI_STATUS acpi_device_eval_obj(device_t bus, device_t dev,
122 ACPI_STRING pathname, ACPI_OBJECT_LIST *parameters,
124 static int acpi_device_pwr_for_sleep(device_t bus, device_t dev,
126 static ACPI_STATUS acpi_device_scan_cb(ACPI_HANDLE h, UINT32 level,
127 void *context, void **retval);
128 static ACPI_STATUS acpi_device_scan_children(device_t bus, device_t dev,
129 int max_depth, acpi_scan_cb_t user_fn, void *arg);
130 static int acpi_set_powerstate_method(device_t bus, device_t child,
132 static int acpi_isa_pnp_probe(device_t bus, device_t child,
133 struct isa_pnp_id *ids);
134 static void acpi_probe_children(device_t bus);
135 static int acpi_probe_order(ACPI_HANDLE handle, int *order);
136 static ACPI_STATUS acpi_probe_child(ACPI_HANDLE handle, UINT32 level,
137 void *context, void **status);
138 static BOOLEAN acpi_MatchHid(ACPI_HANDLE h, const char *hid);
139 static void acpi_shutdown_final(void *arg, int howto);
140 static void acpi_enable_fixed_events(struct acpi_softc *sc);
141 static int acpi_wake_sleep_prep(ACPI_HANDLE handle, int sstate);
142 static int acpi_wake_run_prep(ACPI_HANDLE handle, int sstate);
143 static int acpi_wake_prep_walk(int sstate);
144 static int acpi_wake_sysctl_walk(device_t dev);
145 static int acpi_wake_set_sysctl(SYSCTL_HANDLER_ARGS);
146 static void acpi_system_eventhandler_sleep(void *arg, int state);
147 static void acpi_system_eventhandler_wakeup(void *arg, int state);
148 static int acpi_supported_sleep_state_sysctl(SYSCTL_HANDLER_ARGS);
149 static int acpi_sleep_state_sysctl(SYSCTL_HANDLER_ARGS);
150 static int acpi_pm_func(u_long cmd, void *arg, ...);
151 static int acpi_child_location_str_method(device_t acdev, device_t child,
152 char *buf, size_t buflen);
153 static int acpi_child_pnpinfo_str_method(device_t acdev, device_t child,
154 char *buf, size_t buflen);
156 static device_method_t acpi_methods[] = {
157 /* Device interface */
158 DEVMETHOD(device_identify, acpi_identify),
159 DEVMETHOD(device_probe, acpi_probe),
160 DEVMETHOD(device_attach, acpi_attach),
161 DEVMETHOD(device_shutdown, acpi_shutdown),
162 DEVMETHOD(device_detach, bus_generic_detach),
163 DEVMETHOD(device_suspend, acpi_suspend),
164 DEVMETHOD(device_resume, acpi_resume),
167 DEVMETHOD(bus_add_child, acpi_add_child),
168 DEVMETHOD(bus_print_child, acpi_print_child),
169 DEVMETHOD(bus_probe_nomatch, acpi_probe_nomatch),
170 DEVMETHOD(bus_driver_added, acpi_driver_added),
171 DEVMETHOD(bus_read_ivar, acpi_read_ivar),
172 DEVMETHOD(bus_write_ivar, acpi_write_ivar),
173 DEVMETHOD(bus_get_resource_list, acpi_get_rlist),
174 DEVMETHOD(bus_set_resource, bus_generic_rl_set_resource),
175 DEVMETHOD(bus_get_resource, bus_generic_rl_get_resource),
176 DEVMETHOD(bus_alloc_resource, acpi_alloc_resource),
177 DEVMETHOD(bus_release_resource, acpi_release_resource),
178 DEVMETHOD(bus_delete_resource, acpi_delete_resource),
179 DEVMETHOD(bus_child_pnpinfo_str, acpi_child_pnpinfo_str_method),
180 DEVMETHOD(bus_child_location_str, acpi_child_location_str_method),
181 DEVMETHOD(bus_activate_resource, bus_generic_activate_resource),
182 DEVMETHOD(bus_deactivate_resource, bus_generic_deactivate_resource),
183 DEVMETHOD(bus_setup_intr, bus_generic_setup_intr),
184 DEVMETHOD(bus_teardown_intr, bus_generic_teardown_intr),
187 DEVMETHOD(acpi_id_probe, acpi_device_id_probe),
188 DEVMETHOD(acpi_evaluate_object, acpi_device_eval_obj),
189 DEVMETHOD(acpi_pwr_for_sleep, acpi_device_pwr_for_sleep),
190 DEVMETHOD(acpi_scan_children, acpi_device_scan_children),
193 DEVMETHOD(pci_set_powerstate, acpi_set_powerstate_method),
196 DEVMETHOD(isa_pnp_probe, acpi_isa_pnp_probe),
201 static driver_t acpi_driver = {
204 sizeof(struct acpi_softc),
207 static devclass_t acpi_devclass;
208 DRIVER_MODULE(acpi, nexus, acpi_driver, acpi_devclass, acpi_modevent, 0);
209 MODULE_VERSION(acpi, 1);
211 ACPI_SERIAL_DECL(acpi, "ACPI root bus");
213 /* Local pools for managing system resources for ACPI child devices. */
214 static struct rman acpi_rman_io, acpi_rman_mem;
216 #define ACPI_MINIMUM_AWAKETIME 5
218 static const char* sleep_state_names[] = {
219 "S0", "S1", "S2", "S3", "S4", "S5", "NONE"};
221 SYSCTL_NODE(_debug, OID_AUTO, acpi, CTLFLAG_RW, NULL, "ACPI debugging");
222 static char acpi_ca_version[12];
223 SYSCTL_STRING(_debug_acpi, OID_AUTO, acpi_ca_version, CTLFLAG_RD,
224 acpi_ca_version, 0, "Version of Intel ACPI-CA");
227 * Allow override of whether methods execute in parallel or not.
228 * Enable this for serial behavior, which fixes "AE_ALREADY_EXISTS"
229 * errors for AML that really can't handle parallel method execution.
230 * It is off by default since this breaks recursive methods and
231 * some IBMs use such code.
233 static int acpi_serialize_methods;
234 TUNABLE_INT("hw.acpi.serialize_methods", &acpi_serialize_methods);
236 /* Power devices off and on in suspend and resume. XXX Remove once tested. */
237 static int acpi_do_powerstate = 1;
238 TUNABLE_INT("debug.acpi.do_powerstate", &acpi_do_powerstate);
239 SYSCTL_INT(_debug_acpi, OID_AUTO, do_powerstate, CTLFLAG_RW,
240 &acpi_do_powerstate, 1, "Turn off devices when suspending.");
242 /* Allow users to override quirks. */
243 TUNABLE_INT("debug.acpi.quirks", &acpi_quirks);
246 * ACPI can only be loaded as a module by the loader; activating it after
247 * system bootstrap time is not useful, and can be fatal to the system.
248 * It also cannot be unloaded, since the entire system bus heirarchy hangs
252 acpi_modevent(struct module *mod, int event, void *junk)
257 printf("The ACPI driver cannot be loaded after boot.\n");
262 if (!cold && power_pm_get_type() == POWER_PM_TYPE_ACPI)
272 * Perform early initialization.
277 static int started = 0;
280 ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
282 /* Only run the startup code once. The MADT driver also calls this. */
287 /* Initialise the ACPI mutex */
288 mtx_init(&acpi_mutex, "ACPI global lock", NULL, MTX_DEF);
291 * Set the globals from our tunables. This is needed because ACPI-CA
292 * uses UINT8 for some values and we have no tunable_byte.
294 AcpiGbl_AllMethodsSerialized = acpi_serialize_methods;
295 AcpiGbl_EnableInterpreterSlack = TRUE;
297 /* Start up the ACPI CA subsystem. */
298 if (ACPI_FAILURE(error = AcpiInitializeSubsystem())) {
299 printf("ACPI: initialisation failed: %s\n", AcpiFormatException(error));
300 return_VALUE (error);
303 if (ACPI_FAILURE(error = AcpiLoadTables())) {
304 printf("ACPI: table load failed: %s\n", AcpiFormatException(error));
306 return_VALUE (error);
309 /* Set up any quirks we have for this system. */
310 if (acpi_quirks == 0)
311 acpi_table_quirks(&acpi_quirks);
313 /* If the user manually set the disabled hint to 0, force-enable ACPI. */
314 if (resource_int_value("acpi", 0, "disabled", &val) == 0 && val == 0)
315 acpi_quirks &= ~ACPI_Q_BROKEN;
316 if (acpi_quirks & ACPI_Q_BROKEN) {
317 printf("ACPI disabled by blacklist. Contact your BIOS vendor.\n");
319 return_VALUE (AE_ERROR);
322 return_VALUE (AE_OK);
326 * Detect ACPI, perform early initialisation
329 acpi_identify(driver_t *driver, device_t parent)
333 ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
338 /* Check that we haven't been disabled with a hint. */
339 if (resource_disabled("acpi", 0))
342 /* Make sure we're not being doubly invoked. */
343 if (device_find_child(parent, "acpi", 0) != NULL)
346 /* Initialize ACPI-CA. */
347 if (ACPI_FAILURE(acpi_Startup()))
350 snprintf(acpi_ca_version, sizeof(acpi_ca_version), "%#x", ACPI_CA_VERSION);
352 /* Attach the actual ACPI device. */
353 if ((child = BUS_ADD_CHILD(parent, 0, "acpi", 0)) == NULL) {
354 device_printf(parent, "device_identify failed\n");
360 * Fetch some descriptive data from ACPI to put in our attach message.
363 acpi_probe(device_t dev)
365 ACPI_TABLE_HEADER th;
371 ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
373 if (power_pm_get_type() != POWER_PM_TYPE_NONE &&
374 power_pm_get_type() != POWER_PM_TYPE_ACPI) {
375 device_printf(dev, "probe failed, other PM system enabled.\n");
376 return_VALUE (ENXIO);
379 if (ACPI_FAILURE(status = AcpiGetTableHeader(ACPI_TABLE_XSDT, 1, &th))) {
380 device_printf(dev, "couldn't get XSDT header: %s\n",
381 AcpiFormatException(status));
384 sbuf_new(&sb, buf, sizeof(buf), SBUF_FIXEDLEN);
385 sbuf_bcat(&sb, th.OemId, 6);
388 sbuf_bcat(&sb, th.OemTableId, 8);
391 device_set_desc_copy(dev, sbuf_data(&sb));
396 return_VALUE (error);
400 acpi_attach(device_t dev)
402 struct acpi_softc *sc;
409 ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
411 sc = device_get_softc(dev);
414 /* Initialize resource manager. */
415 acpi_rman_io.rm_type = RMAN_ARRAY;
416 acpi_rman_io.rm_start = 0;
417 acpi_rman_io.rm_end = 0xffff;
418 acpi_rman_io.rm_descr = "I/O ports";
419 if (rman_init(&acpi_rman_io) != 0)
420 panic("acpi rman_init IO ports failed");
421 acpi_rman_mem.rm_type = RMAN_ARRAY;
422 acpi_rman_mem.rm_start = 0;
423 acpi_rman_mem.rm_end = ~0ul;
424 acpi_rman_mem.rm_descr = "I/O memory addresses";
425 if (rman_init(&acpi_rman_mem) != 0)
426 panic("acpi rman_init memory failed");
428 /* Install the default address space handlers. */
430 status = AcpiInstallAddressSpaceHandler(ACPI_ROOT_OBJECT,
431 ACPI_ADR_SPACE_SYSTEM_MEMORY, ACPI_DEFAULT_HANDLER, NULL, NULL);
432 if (ACPI_FAILURE(status)) {
433 device_printf(dev, "Could not initialise SystemMemory handler: %s\n",
434 AcpiFormatException(status));
437 status = AcpiInstallAddressSpaceHandler(ACPI_ROOT_OBJECT,
438 ACPI_ADR_SPACE_SYSTEM_IO, ACPI_DEFAULT_HANDLER, NULL, NULL);
439 if (ACPI_FAILURE(status)) {
440 device_printf(dev, "Could not initialise SystemIO handler: %s\n",
441 AcpiFormatException(status));
444 status = AcpiInstallAddressSpaceHandler(ACPI_ROOT_OBJECT,
445 ACPI_ADR_SPACE_PCI_CONFIG, ACPI_DEFAULT_HANDLER, NULL, NULL);
446 if (ACPI_FAILURE(status)) {
447 device_printf(dev, "could not initialise PciConfig handler: %s\n",
448 AcpiFormatException(status));
453 * Note that some systems (specifically, those with namespace evaluation
454 * issues that require the avoidance of parts of the namespace) must
455 * avoid running _INI and _STA on everything, as well as dodging the final
458 * For these devices, we set ACPI_NO_DEVICE_INIT and ACPI_NO_OBJECT_INIT).
460 * XXX We should arrange for the object init pass after we have attached
461 * all our child devices, but on many systems it works here.
464 if (testenv("debug.acpi.avoid"))
465 flags = ACPI_NO_DEVICE_INIT | ACPI_NO_OBJECT_INIT;
467 /* Bring the hardware and basic handlers online. */
468 if (ACPI_FAILURE(status = AcpiEnableSubsystem(flags))) {
469 device_printf(dev, "Could not enable ACPI: %s\n",
470 AcpiFormatException(status));
475 * Call the ECDT probe function to provide EC functionality before
476 * the namespace has been evaluated.
478 acpi_ec_ecdt_probe(dev);
480 /* Bring device objects and regions online. */
481 if (ACPI_FAILURE(status = AcpiInitializeObjects(flags))) {
482 device_printf(dev, "Could not initialize ACPI objects: %s\n",
483 AcpiFormatException(status));
488 * Setup our sysctl tree.
490 * XXX: This doesn't check to make sure that none of these fail.
492 sysctl_ctx_init(&sc->acpi_sysctl_ctx);
493 sc->acpi_sysctl_tree = SYSCTL_ADD_NODE(&sc->acpi_sysctl_ctx,
494 SYSCTL_STATIC_CHILDREN(_hw), OID_AUTO,
495 device_get_name(dev), CTLFLAG_RD, 0, "");
496 SYSCTL_ADD_PROC(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
497 OID_AUTO, "supported_sleep_state", CTLTYPE_STRING | CTLFLAG_RD,
498 0, 0, acpi_supported_sleep_state_sysctl, "A", "");
499 SYSCTL_ADD_PROC(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
500 OID_AUTO, "power_button_state", CTLTYPE_STRING | CTLFLAG_RW,
501 &sc->acpi_power_button_sx, 0, acpi_sleep_state_sysctl, "A", "");
502 SYSCTL_ADD_PROC(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
503 OID_AUTO, "sleep_button_state", CTLTYPE_STRING | CTLFLAG_RW,
504 &sc->acpi_sleep_button_sx, 0, acpi_sleep_state_sysctl, "A", "");
505 SYSCTL_ADD_PROC(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
506 OID_AUTO, "lid_switch_state", CTLTYPE_STRING | CTLFLAG_RW,
507 &sc->acpi_lid_switch_sx, 0, acpi_sleep_state_sysctl, "A", "");
508 SYSCTL_ADD_PROC(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
509 OID_AUTO, "standby_state", CTLTYPE_STRING | CTLFLAG_RW,
510 &sc->acpi_standby_sx, 0, acpi_sleep_state_sysctl, "A", "");
511 SYSCTL_ADD_PROC(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
512 OID_AUTO, "suspend_state", CTLTYPE_STRING | CTLFLAG_RW,
513 &sc->acpi_suspend_sx, 0, acpi_sleep_state_sysctl, "A", "");
514 SYSCTL_ADD_INT(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
515 OID_AUTO, "sleep_delay", CTLFLAG_RD | CTLFLAG_RW,
516 &sc->acpi_sleep_delay, 0, "sleep delay");
517 SYSCTL_ADD_INT(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
518 OID_AUTO, "s4bios", CTLFLAG_RD | CTLFLAG_RW,
519 &sc->acpi_s4bios, 0, "S4BIOS mode");
520 SYSCTL_ADD_INT(&sc->acpi_sysctl_ctx, SYSCTL_CHILDREN(sc->acpi_sysctl_tree),
521 OID_AUTO, "verbose", CTLFLAG_RD | CTLFLAG_RW,
522 &sc->acpi_verbose, 0, "verbose mode");
525 * Default to 1 second before sleeping to give some machines time to
528 sc->acpi_sleep_delay = 1;
530 sc->acpi_verbose = 1;
531 if ((env = getenv("hw.acpi.verbose")) != NULL) {
532 if (strcmp(env, "0") != 0)
533 sc->acpi_verbose = 1;
537 /* Only enable S4BIOS by default if the FACS says it is available. */
538 if (AcpiGbl_FACS->S4Bios_f != 0)
542 * Dispatch the default sleep state to devices. The lid switch is set
543 * to NONE by default to avoid surprising users.
545 sc->acpi_power_button_sx = ACPI_STATE_S5;
546 sc->acpi_lid_switch_sx = ACPI_S_STATES_MAX + 1;
547 sc->acpi_standby_sx = ACPI_STATE_S1;
548 sc->acpi_suspend_sx = ACPI_STATE_S3;
550 /* Pick the first valid sleep state for the sleep button default. */
551 sc->acpi_sleep_button_sx = ACPI_S_STATES_MAX + 1;
552 for (state = ACPI_STATE_S1; state < ACPI_STATE_S5; state++)
553 if (ACPI_SUCCESS(AcpiGetSleepTypeData(state, &TypeA, &TypeB))) {
554 sc->acpi_sleep_button_sx = state;
558 acpi_enable_fixed_events(sc);
561 * Scan the namespace and attach/initialise children.
564 /* Register our shutdown handler. */
565 EVENTHANDLER_REGISTER(shutdown_final, acpi_shutdown_final, sc,
569 * Register our acpi event handlers.
570 * XXX should be configurable eg. via userland policy manager.
572 EVENTHANDLER_REGISTER(acpi_sleep_event, acpi_system_eventhandler_sleep,
573 sc, ACPI_EVENT_PRI_LAST);
574 EVENTHANDLER_REGISTER(acpi_wakeup_event, acpi_system_eventhandler_wakeup,
575 sc, ACPI_EVENT_PRI_LAST);
577 /* Flag our initial states. */
578 sc->acpi_enabled = 1;
579 sc->acpi_sstate = ACPI_STATE_S0;
580 sc->acpi_sleep_disabled = 0;
582 /* Create the control device */
583 sc->acpi_dev_t = make_dev(&acpi_cdevsw, 0, UID_ROOT, GID_WHEEL, 0644,
585 sc->acpi_dev_t->si_drv1 = sc;
587 if ((error = acpi_machdep_init(dev)))
590 /* Register ACPI again to pass the correct argument of pm_func. */
591 power_pm_register(POWER_PM_TYPE_ACPI, acpi_pm_func, sc);
593 if (!acpi_disabled("bus"))
594 acpi_probe_children(dev);
599 return_VALUE (error);
603 acpi_suspend(device_t dev)
605 device_t child, *devlist;
606 int error, i, numdevs, pstate;
610 /* First give child devices a chance to suspend. */
611 error = bus_generic_suspend(dev);
616 * Now, set them into the appropriate power state, usually D3. If the
617 * device has an _SxD method for the next sleep state, use that power
620 device_get_children(dev, &devlist, &numdevs);
621 for (i = 0; i < numdevs; i++) {
622 /* If the device is not attached, we've powered it down elsewhere. */
624 if (!device_is_attached(child))
628 * Default to D3 for all sleep states. The _SxD method is optional
629 * so set the powerstate even if it's absent.
631 pstate = PCI_POWERSTATE_D3;
632 error = acpi_device_pwr_for_sleep(device_get_parent(child),
634 if ((error == 0 || error == ESRCH) && acpi_do_powerstate)
635 pci_set_powerstate(child, pstate);
637 free(devlist, M_TEMP);
644 acpi_resume(device_t dev)
648 device_t child, *devlist;
653 * Put all devices in D0 before resuming them. Call _S0D on each one
654 * since some systems expect this.
656 device_get_children(dev, &devlist, &numdevs);
657 for (i = 0; i < numdevs; i++) {
659 handle = acpi_get_handle(child);
661 AcpiEvaluateObject(handle, "_S0D", NULL, NULL);
662 if (device_is_attached(child) && acpi_do_powerstate)
663 pci_set_powerstate(child, PCI_POWERSTATE_D0);
665 free(devlist, M_TEMP);
667 return (bus_generic_resume(dev));
671 acpi_shutdown(device_t dev)
676 /* Allow children to shutdown first. */
677 bus_generic_shutdown(dev);
680 * Enable any GPEs that are able to power-on the system (i.e., RTC).
681 * Also, disable any that are not valid for this state (most).
683 acpi_wake_prep_walk(ACPI_STATE_S5);
689 * Handle a new device being added
692 acpi_add_child(device_t bus, int order, const char *name, int unit)
694 struct acpi_device *ad;
697 if ((ad = malloc(sizeof(*ad), M_ACPIDEV, M_NOWAIT | M_ZERO)) == NULL)
700 resource_list_init(&ad->ad_rl);
702 child = device_add_child_ordered(bus, order, name, unit);
704 device_set_ivars(child, ad);
711 acpi_print_child(device_t bus, device_t child)
713 struct acpi_device *adev = device_get_ivars(child);
714 struct resource_list *rl = &adev->ad_rl;
717 retval += bus_print_child_header(bus, child);
718 retval += resource_list_print_type(rl, "port", SYS_RES_IOPORT, "%#lx");
719 retval += resource_list_print_type(rl, "iomem", SYS_RES_MEMORY, "%#lx");
720 retval += resource_list_print_type(rl, "irq", SYS_RES_IRQ, "%ld");
721 retval += resource_list_print_type(rl, "drq", SYS_RES_DRQ, "%ld");
722 if (device_get_flags(child))
723 retval += printf(" flags %#x", device_get_flags(child));
724 retval += bus_print_child_footer(bus, child);
730 * If this device is an ACPI child but no one claimed it, attempt
731 * to power it off. We'll power it back up when a driver is added.
733 * XXX Disabled for now since many necessary devices (like fdc and
734 * ATA) don't claim the devices we created for them but still expect
735 * them to be powered up.
738 acpi_probe_nomatch(device_t bus, device_t child)
741 /* pci_set_powerstate(child, PCI_POWERSTATE_D3); */
745 * If a new driver has a chance to probe a child, first power it up.
747 * XXX Disabled for now (see acpi_probe_nomatch for details).
750 acpi_driver_added(device_t dev, driver_t *driver)
752 device_t child, *devlist;
755 DEVICE_IDENTIFY(driver, dev);
756 device_get_children(dev, &devlist, &numdevs);
757 for (i = 0; i < numdevs; i++) {
759 if (device_get_state(child) == DS_NOTPRESENT) {
760 /* pci_set_powerstate(child, PCI_POWERSTATE_D0); */
761 if (device_probe_and_attach(child) != 0)
762 ; /* pci_set_powerstate(child, PCI_POWERSTATE_D3); */
765 free(devlist, M_TEMP);
768 /* Location hint for devctl(8) */
770 acpi_child_location_str_method(device_t cbdev, device_t child, char *buf,
773 struct acpi_device *dinfo = device_get_ivars(child);
775 if (dinfo->ad_handle)
776 snprintf(buf, buflen, "handle=%s", acpi_name(dinfo->ad_handle));
778 snprintf(buf, buflen, "unknown");
782 /* PnP information for devctl(8) */
784 acpi_child_pnpinfo_str_method(device_t cbdev, device_t child, char *buf,
787 ACPI_BUFFER adbuf = {ACPI_ALLOCATE_BUFFER, NULL};
788 ACPI_DEVICE_INFO *adinfo;
789 struct acpi_device *dinfo = device_get_ivars(child);
793 error = AcpiGetObjectInfo(dinfo->ad_handle, &adbuf);
794 adinfo = (ACPI_DEVICE_INFO *) adbuf.Pointer;
796 snprintf(buf, buflen, "unknown");
798 snprintf(buf, buflen, "_HID=%s _UID=%lu",
799 (adinfo->Valid & ACPI_VALID_HID) ?
800 adinfo->HardwareId.Value : "none",
801 (adinfo->Valid & ACPI_VALID_UID) ?
802 strtoul(adinfo->UniqueId.Value, &end, 10) : 0);
810 * Handle per-device ivars
813 acpi_read_ivar(device_t dev, device_t child, int index, uintptr_t *result)
815 struct acpi_device *ad;
817 if ((ad = device_get_ivars(child)) == NULL) {
818 printf("device has no ivars\n");
822 /* ACPI and ISA compatibility ivars */
824 case ACPI_IVAR_HANDLE:
825 *(ACPI_HANDLE *)result = ad->ad_handle;
827 case ACPI_IVAR_MAGIC:
828 *(int *)result = ad->ad_magic;
830 case ACPI_IVAR_PRIVATE:
831 *(void **)result = ad->ad_private;
833 case ACPI_IVAR_FLAGS:
834 *(int *)result = ad->ad_flags;
836 case ISA_IVAR_VENDORID:
837 case ISA_IVAR_SERIAL:
838 case ISA_IVAR_COMPATID:
841 case ISA_IVAR_LOGICALID:
842 *(int *)result = acpi_isa_get_logicalid(child);
852 acpi_write_ivar(device_t dev, device_t child, int index, uintptr_t value)
854 struct acpi_device *ad;
856 if ((ad = device_get_ivars(child)) == NULL) {
857 printf("device has no ivars\n");
862 case ACPI_IVAR_HANDLE:
863 ad->ad_handle = (ACPI_HANDLE)value;
865 case ACPI_IVAR_MAGIC:
866 ad->ad_magic = (int)value;
868 case ACPI_IVAR_PRIVATE:
869 ad->ad_private = (void *)value;
871 case ACPI_IVAR_FLAGS:
872 ad->ad_flags = (int)value;
875 panic("bad ivar write request (%d)", index);
883 * Handle child resource allocation/removal
885 static struct resource_list *
886 acpi_get_rlist(device_t dev, device_t child)
888 struct acpi_device *ad;
890 ad = device_get_ivars(child);
895 * Pre-allocate/manage all memory and IO resources. Since rman can't handle
896 * duplicates, we merge any in the sysresource attach routine.
899 acpi_sysres_alloc(device_t dev)
901 struct resource *res;
902 struct resource_list *rl;
903 struct resource_list_entry *rle;
906 rl = BUS_GET_RESOURCE_LIST(device_get_parent(dev), dev);
907 STAILQ_FOREACH(rle, rl, link) {
908 if (rle->res != NULL) {
909 device_printf(dev, "duplicate resource for %lx\n", rle->start);
913 /* Only memory and IO resources are valid here. */
925 /* Pre-allocate resource and add to our rman pool. */
926 res = BUS_ALLOC_RESOURCE(device_get_parent(dev), dev, rle->type,
927 &rle->rid, rle->start, rle->start + rle->count - 1, rle->count, 0);
929 rman_manage_region(rm, rman_get_start(res), rman_get_end(res));
932 device_printf(dev, "reservation of %lx, %lx (%d) failed\n",
933 rle->start, rle->count, rle->type);
938 /* Find if we manage a given resource. */
939 static struct resource_list_entry *
940 acpi_sysres_find(device_t dev, int type, u_long addr)
942 struct resource_list *rl;
943 struct resource_list_entry *rle;
945 ACPI_SERIAL_ASSERT(acpi);
947 /* We only consider IO and memory resources for our pool. */
949 if (type != SYS_RES_IOPORT && type != SYS_RES_MEMORY)
952 rl = BUS_GET_RESOURCE_LIST(device_get_parent(dev), dev);
953 STAILQ_FOREACH(rle, rl, link) {
954 if (type == rle->type && addr >= rle->start &&
955 addr < rle->start + rle->count)
963 static struct resource *
964 acpi_alloc_resource(device_t bus, device_t child, int type, int *rid,
965 u_long start, u_long end, u_long count, u_int flags)
968 struct acpi_device *ad = device_get_ivars(child);
969 struct resource_list *rl = &ad->ad_rl;
970 struct resource_list_entry *rle;
971 struct resource *res;
975 ACPI_SERIAL_BEGIN(acpi);
978 * If this is an allocation of the "default" range for a given RID, and
979 * we know what the resources for this device are (i.e., they're on the
980 * child's resource list), use those start/end values.
982 if (bus == device_get_parent(child) && start == 0UL && end == ~0UL) {
983 rle = resource_list_find(rl, type, *rid);
991 /* If we don't manage this address, pass the request up to the parent. */
992 rle = acpi_sysres_find(bus, type, start);
994 res = BUS_ALLOC_RESOURCE(device_get_parent(bus), child, type, rid,
995 start, end, count, flags);
998 /* We only handle memory and IO resources through rman. */
1000 case SYS_RES_IOPORT:
1003 case SYS_RES_MEMORY:
1004 rm = &acpi_rman_mem;
1007 panic("acpi_alloc_resource: invalid res type %d", type);
1010 /* If we do know it, allocate it from the local pool. */
1011 res = rman_reserve_resource(rm, start, end, count, flags & ~RF_ACTIVE,
1016 /* Copy the bus tag and handle from the pre-allocated resource. */
1017 rman_set_bustag(res, rman_get_bustag(rle->res));
1018 rman_set_bushandle(res, rman_get_start(res));
1020 /* If requested, activate the resource using the parent's method. */
1021 if (flags & RF_ACTIVE)
1022 if (bus_activate_resource(child, type, *rid, res) != 0) {
1023 rman_release_resource(res);
1029 if (res != NULL && device_get_parent(child) == bus)
1033 * Since bus_config_intr() takes immediate effect, we cannot
1034 * configure the interrupt associated with a device when we
1035 * parse the resources but have to defer it until a driver
1036 * actually allocates the interrupt via bus_alloc_resource().
1038 * XXX: Should we handle the lookup failing?
1040 if (ACPI_SUCCESS(acpi_lookup_irq_resource(child, *rid, res, &ares)))
1041 acpi_config_intr(child, &ares);
1046 ACPI_SERIAL_END(acpi);
1051 acpi_release_resource(device_t bus, device_t child, int type, int rid,
1056 ACPI_SERIAL_BEGIN(acpi);
1059 * If we know about this address, deactivate it and release it to the
1060 * local pool. If we don't, pass this request up to the parent.
1062 if (acpi_sysres_find(bus, type, rman_get_start(r)) == NULL) {
1063 if (rman_get_flags(r) & RF_ACTIVE) {
1064 ret = bus_deactivate_resource(child, type, rid, r);
1068 ret = rman_release_resource(r);
1070 ret = BUS_RELEASE_RESOURCE(device_get_parent(bus), child, type, rid, r);
1073 ACPI_SERIAL_END(acpi);
1078 acpi_delete_resource(device_t bus, device_t child, int type, int rid)
1080 struct resource_list *rl;
1082 rl = acpi_get_rlist(bus, child);
1083 resource_list_delete(rl, type, rid);
1086 /* Allocate an IO port or memory resource, given its GAS. */
1088 acpi_bus_alloc_gas(device_t dev, int *type, int *rid, ACPI_GENERIC_ADDRESS *gas,
1089 struct resource **res)
1091 int error, res_type;
1094 if (type == NULL || rid == NULL || gas == NULL || res == NULL)
1097 /* We only support memory and IO spaces. */
1098 switch (gas->AddressSpaceId) {
1099 case ACPI_ADR_SPACE_SYSTEM_MEMORY:
1100 res_type = SYS_RES_MEMORY;
1102 case ACPI_ADR_SPACE_SYSTEM_IO:
1103 res_type = SYS_RES_IOPORT;
1106 return (EOPNOTSUPP);
1110 * If the register width is less than 8, assume the BIOS author means
1111 * it is a bit field and just allocate a byte.
1113 if (gas->RegisterBitWidth && gas->RegisterBitWidth < 8)
1114 gas->RegisterBitWidth = 8;
1116 /* Validate the address after we're sure we support the space. */
1117 if (!ACPI_VALID_ADDRESS(gas->Address) || gas->RegisterBitWidth == 0)
1120 bus_set_resource(dev, res_type, *rid, gas->Address,
1121 gas->RegisterBitWidth / 8);
1122 *res = bus_alloc_resource_any(dev, res_type, rid, RF_ACTIVE);
1127 bus_delete_resource(dev, res_type, *rid);
1132 /* Probe _HID and _CID for compatible ISA PNP ids. */
1134 acpi_isa_get_logicalid(device_t dev)
1136 ACPI_DEVICE_INFO *devinfo;
1142 ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
1146 buf.Length = ACPI_ALLOCATE_BUFFER;
1148 /* Fetch and validate the HID. */
1149 if ((h = acpi_get_handle(dev)) == NULL)
1151 error = AcpiGetObjectInfo(h, &buf);
1152 if (ACPI_FAILURE(error))
1154 devinfo = (ACPI_DEVICE_INFO *)buf.Pointer;
1156 if ((devinfo->Valid & ACPI_VALID_HID) != 0)
1157 pnpid = PNP_EISAID(devinfo->HardwareId.Value);
1160 if (buf.Pointer != NULL)
1161 AcpiOsFree(buf.Pointer);
1162 return_VALUE (pnpid);
1166 acpi_isa_get_compatid(device_t dev, uint32_t *cids, int count)
1168 ACPI_DEVICE_INFO *devinfo;
1175 ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
1180 buf.Length = ACPI_ALLOCATE_BUFFER;
1182 /* Fetch and validate the CID */
1183 if ((h = acpi_get_handle(dev)) == NULL)
1185 error = AcpiGetObjectInfo(h, &buf);
1186 if (ACPI_FAILURE(error))
1188 devinfo = (ACPI_DEVICE_INFO *)buf.Pointer;
1189 if ((devinfo->Valid & ACPI_VALID_CID) == 0)
1192 if (devinfo->CompatibilityId.Count < count)
1193 count = devinfo->CompatibilityId.Count;
1194 for (i = 0; i < count; i++) {
1195 if (strncmp(devinfo->CompatibilityId.Id[i].Value, "PNP", 3) != 0)
1197 *pnpid++ = PNP_EISAID(devinfo->CompatibilityId.Id[i].Value);
1202 if (buf.Pointer != NULL)
1203 AcpiOsFree(buf.Pointer);
1204 return_VALUE (valid);
1208 acpi_device_id_probe(device_t bus, device_t dev, char **ids)
1213 h = acpi_get_handle(dev);
1214 if (ids == NULL || h == NULL || acpi_get_type(dev) != ACPI_TYPE_DEVICE)
1217 /* Try to match one of the array of IDs with a HID or CID. */
1218 for (i = 0; ids[i] != NULL; i++) {
1219 if (acpi_MatchHid(h, ids[i]))
1226 acpi_device_eval_obj(device_t bus, device_t dev, ACPI_STRING pathname,
1227 ACPI_OBJECT_LIST *parameters, ACPI_BUFFER *ret)
1232 h = ACPI_ROOT_OBJECT;
1233 else if ((h = acpi_get_handle(dev)) == NULL)
1234 return (AE_BAD_PARAMETER);
1235 return (AcpiEvaluateObject(h, pathname, parameters, ret));
1239 acpi_device_pwr_for_sleep(device_t bus, device_t dev, int *dstate)
1241 struct acpi_softc *sc;
1247 sc = device_get_softc(bus);
1248 handle = acpi_get_handle(dev);
1251 * XXX If we find these devices, don't try to power them down.
1252 * The serial and IRDA ports on my T23 hang the system when
1253 * set to D3 and it appears that such legacy devices may
1254 * need special handling in their drivers.
1256 if (handle == NULL ||
1257 acpi_MatchHid(handle, "PNP0500") ||
1258 acpi_MatchHid(handle, "PNP0501") ||
1259 acpi_MatchHid(handle, "PNP0502") ||
1260 acpi_MatchHid(handle, "PNP0510") ||
1261 acpi_MatchHid(handle, "PNP0511"))
1265 * Override next state with the value from _SxD, if present. If no
1266 * dstate argument was provided, don't fetch the return value.
1268 snprintf(sxd, sizeof(sxd), "_S%dD", sc->acpi_sstate);
1270 status = acpi_GetInteger(handle, sxd, dstate);
1272 status = AcpiEvaluateObject(handle, sxd, NULL, NULL);
1289 /* Callback arg for our implementation of walking the namespace. */
1290 struct acpi_device_scan_ctx {
1291 acpi_scan_cb_t user_fn;
1297 acpi_device_scan_cb(ACPI_HANDLE h, UINT32 level, void *arg, void **retval)
1299 struct acpi_device_scan_ctx *ctx;
1300 device_t dev, old_dev;
1302 ACPI_OBJECT_TYPE type;
1305 * Skip this device if we think we'll have trouble with it or it is
1306 * the parent where the scan began.
1308 ctx = (struct acpi_device_scan_ctx *)arg;
1309 if (acpi_avoid(h) || h == ctx->parent)
1312 /* If this is not a valid device type (e.g., a method), skip it. */
1313 if (ACPI_FAILURE(AcpiGetType(h, &type)))
1315 if (type != ACPI_TYPE_DEVICE && type != ACPI_TYPE_PROCESSOR &&
1316 type != ACPI_TYPE_THERMAL && type != ACPI_TYPE_POWER)
1320 * Call the user function with the current device. If it is unchanged
1321 * afterwards, return. Otherwise, we update the handle to the new dev.
1323 old_dev = acpi_get_device(h);
1325 status = ctx->user_fn(h, &dev, level, ctx->arg);
1326 if (ACPI_FAILURE(status) || old_dev == dev)
1329 /* Remove the old child and its connection to the handle. */
1330 if (old_dev != NULL) {
1331 device_delete_child(device_get_parent(old_dev), old_dev);
1332 AcpiDetachData(h, acpi_fake_objhandler);
1335 /* Recreate the handle association if the user created a device. */
1337 AcpiAttachData(h, acpi_fake_objhandler, dev);
1343 acpi_device_scan_children(device_t bus, device_t dev, int max_depth,
1344 acpi_scan_cb_t user_fn, void *arg)
1347 struct acpi_device_scan_ctx ctx;
1349 if (acpi_disabled("children"))
1353 h = ACPI_ROOT_OBJECT;
1354 else if ((h = acpi_get_handle(dev)) == NULL)
1355 return (AE_BAD_PARAMETER);
1356 ctx.user_fn = user_fn;
1359 return (AcpiWalkNamespace(ACPI_TYPE_ANY, h, max_depth,
1360 acpi_device_scan_cb, &ctx, NULL));
1364 * Even though ACPI devices are not PCI, we use the PCI approach for setting
1365 * device power states since it's close enough to ACPI.
1368 acpi_set_powerstate_method(device_t bus, device_t child, int state)
1375 h = acpi_get_handle(child);
1376 if (state < ACPI_STATE_D0 || state > ACPI_STATE_D3)
1381 /* Ignore errors if the power methods aren't present. */
1382 status = acpi_pwr_switch_consumer(h, state);
1383 if (ACPI_FAILURE(status) && status != AE_NOT_FOUND
1384 && status != AE_BAD_PARAMETER)
1385 device_printf(bus, "failed to set ACPI power state D%d on %s: %s\n",
1386 state, acpi_name(h), AcpiFormatException(status));
1392 acpi_isa_pnp_probe(device_t bus, device_t child, struct isa_pnp_id *ids)
1394 int result, cid_count, i;
1395 uint32_t lid, cids[8];
1397 ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
1400 * ISA-style drivers attached to ACPI may persist and
1401 * probe manually if we return ENOENT. We never want
1402 * that to happen, so don't ever return it.
1406 /* Scan the supplied IDs for a match */
1407 lid = acpi_isa_get_logicalid(child);
1408 cid_count = acpi_isa_get_compatid(child, cids, 8);
1409 while (ids && ids->ip_id) {
1410 if (lid == ids->ip_id) {
1414 for (i = 0; i < cid_count; i++) {
1415 if (cids[i] == ids->ip_id) {
1424 if (result == 0 && ids->ip_desc)
1425 device_set_desc(child, ids->ip_desc);
1427 return_VALUE (result);
1431 * Scan all of the ACPI namespace and attach child devices.
1433 * We should only expect to find devices in the \_PR, \_TZ, \_SI, and
1434 * \_SB scopes, and \_PR and \_TZ became obsolete in the ACPI 2.0 spec.
1435 * However, in violation of the spec, some systems place their PCI link
1436 * devices in \, so we have to walk the whole namespace. We check the
1437 * type of namespace nodes, so this should be ok.
1440 acpi_probe_children(device_t bus)
1443 ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
1446 * Scan the namespace and insert placeholders for all the devices that
1447 * we find. We also probe/attach any early devices.
1449 * Note that we use AcpiWalkNamespace rather than AcpiGetDevices because
1450 * we want to create nodes for all devices, not just those that are
1451 * currently present. (This assumes that we don't want to create/remove
1452 * devices as they appear, which might be smarter.)
1454 ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "namespace scan\n"));
1455 AcpiWalkNamespace(ACPI_TYPE_ANY, ACPI_ROOT_OBJECT, 100, acpi_probe_child,
1458 /* Pre-allocate resources for our rman from any sysresource devices. */
1459 acpi_sysres_alloc(bus);
1461 /* Create any static children by calling device identify methods. */
1462 ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "device identify routines\n"));
1463 bus_generic_probe(bus);
1465 /* Probe/attach all children, created staticly and from the namespace. */
1466 ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "first bus_generic_attach\n"));
1467 bus_generic_attach(bus);
1470 * Some of these children may have attached others as part of their attach
1471 * process (eg. the root PCI bus driver), so rescan.
1473 ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "second bus_generic_attach\n"));
1474 bus_generic_attach(bus);
1476 /* Attach wake sysctls. */
1477 acpi_wake_sysctl_walk(bus);
1479 ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "done attaching children\n"));
1484 * Determine the probe order for a given device and return non-zero if it
1485 * should be attached immediately.
1488 acpi_probe_order(ACPI_HANDLE handle, int *order)
1493 * 1. I/O port and memory system resource holders
1494 * 2. Embedded controllers (to handle early accesses)
1495 * 3. PCI Link Devices
1498 if (acpi_MatchHid(handle, "PNP0C01") || acpi_MatchHid(handle, "PNP0C02")) {
1501 } else if (acpi_MatchHid(handle, "PNP0C09")) {
1504 } else if (acpi_MatchHid(handle, "PNP0C0F")) {
1513 * Evaluate a child device and determine whether we might attach a device to
1517 acpi_probe_child(ACPI_HANDLE handle, UINT32 level, void *context, void **status)
1519 ACPI_OBJECT_TYPE type;
1520 device_t bus, child;
1521 int order, probe_now;
1522 char *handle_str, **search;
1523 static char *scopes[] = {"\\_PR_", "\\_TZ_", "\\_SI_", "\\_SB_", NULL};
1525 ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
1527 /* Skip this device if we think we'll have trouble with it. */
1528 if (acpi_avoid(handle))
1529 return_ACPI_STATUS (AE_OK);
1531 bus = (device_t)context;
1532 if (ACPI_SUCCESS(AcpiGetType(handle, &type))) {
1534 case ACPI_TYPE_DEVICE:
1535 case ACPI_TYPE_PROCESSOR:
1536 case ACPI_TYPE_THERMAL:
1537 case ACPI_TYPE_POWER:
1538 if (acpi_disabled("children"))
1542 * Since we scan from \, be sure to skip system scope objects.
1543 * At least \_SB and \_TZ are detected as devices (ACPI-CA bug?)
1545 handle_str = acpi_name(handle);
1546 for (search = scopes; *search != NULL; search++) {
1547 if (strcmp(handle_str, *search) == 0)
1550 if (*search != NULL)
1554 * Create a placeholder device for this node. Sort the placeholder
1555 * so that the probe/attach passes will run breadth-first. Orders
1556 * less than 10 are reserved for special objects (i.e., system
1557 * resources). Larger values are used for all other devices.
1559 ACPI_DEBUG_PRINT((ACPI_DB_OBJECTS, "scanning '%s'\n", handle_str));
1560 order = (level + 1) * 10;
1561 probe_now = acpi_probe_order(handle, &order);
1562 child = BUS_ADD_CHILD(bus, order, NULL, -1);
1566 /* Associate the handle with the device_t and vice versa. */
1567 acpi_set_handle(child, handle);
1568 AcpiAttachData(handle, acpi_fake_objhandler, child);
1571 * Check that the device is present. If it's not present,
1572 * leave it disabled (so that we have a device_t attached to
1573 * the handle, but we don't probe it).
1575 * XXX PCI link devices sometimes report "present" but not
1576 * "functional" (i.e. if disabled). Go ahead and probe them
1577 * anyway since we may enable them later.
1579 if (type == ACPI_TYPE_DEVICE && !acpi_DeviceIsPresent(child) &&
1580 !acpi_MatchHid(handle, "PNP0C0F")) {
1581 device_disable(child);
1586 * Get the device's resource settings and attach them.
1587 * Note that if the device has _PRS but no _CRS, we need
1588 * to decide when it's appropriate to try to configure the
1589 * device. Ignore the return value here; it's OK for the
1590 * device not to have any resources.
1592 acpi_parse_resources(child, handle, &acpi_res_parse_set, NULL);
1594 /* If order was overridden, probe/attach now rather than later. */
1596 device_probe_and_attach(child);
1601 return_ACPI_STATUS (AE_OK);
1605 * AcpiAttachData() requires an object handler but never uses it. This is a
1606 * placeholder object handler so we can store a device_t in an ACPI_HANDLE.
1609 acpi_fake_objhandler(ACPI_HANDLE h, UINT32 fn, void *data)
1614 acpi_shutdown_final(void *arg, int howto)
1619 * XXX Shutdown code should only run on the BSP (cpuid 0).
1620 * Some chipsets do not power off the system correctly if called from
1623 if ((howto & RB_POWEROFF) != 0) {
1624 status = AcpiEnterSleepStatePrep(ACPI_STATE_S5);
1625 if (ACPI_FAILURE(status)) {
1626 printf("AcpiEnterSleepStatePrep failed - %s\n",
1627 AcpiFormatException(status));
1630 printf("Powering system off using ACPI\n");
1631 ACPI_DISABLE_IRQS();
1632 status = AcpiEnterSleepState(ACPI_STATE_S5);
1633 if (ACPI_FAILURE(status)) {
1634 printf("ACPI power-off failed - %s\n", AcpiFormatException(status));
1637 printf("ACPI power-off failed - timeout\n");
1639 } else if (panicstr == NULL) {
1640 printf("Shutting down ACPI\n");
1646 acpi_enable_fixed_events(struct acpi_softc *sc)
1648 static int first_time = 1;
1650 /* Enable and clear fixed events and install handlers. */
1651 if (AcpiGbl_FADT != NULL && AcpiGbl_FADT->PwrButton == 0) {
1652 AcpiClearEvent(ACPI_EVENT_POWER_BUTTON);
1653 AcpiInstallFixedEventHandler(ACPI_EVENT_POWER_BUTTON,
1654 acpi_event_power_button_sleep, sc);
1656 device_printf(sc->acpi_dev, "Power Button (fixed)\n");
1658 if (AcpiGbl_FADT != NULL && AcpiGbl_FADT->SleepButton == 0) {
1659 AcpiClearEvent(ACPI_EVENT_SLEEP_BUTTON);
1660 AcpiInstallFixedEventHandler(ACPI_EVENT_SLEEP_BUTTON,
1661 acpi_event_sleep_button_sleep, sc);
1663 device_printf(sc->acpi_dev, "Sleep Button (fixed)\n");
1670 * Returns true if the device is actually present and should
1671 * be attached to. This requires the present, enabled, UI-visible
1672 * and diagnostics-passed bits to be set.
1675 acpi_DeviceIsPresent(device_t dev)
1677 ACPI_DEVICE_INFO *devinfo;
1684 if ((h = acpi_get_handle(dev)) == NULL)
1687 buf.Length = ACPI_ALLOCATE_BUFFER;
1688 error = AcpiGetObjectInfo(h, &buf);
1689 if (ACPI_FAILURE(error))
1691 devinfo = (ACPI_DEVICE_INFO *)buf.Pointer;
1693 /* If no _STA method, must be present */
1694 if ((devinfo->Valid & ACPI_VALID_STA) == 0)
1697 /* Return true for 'present' and 'functioning' */
1698 if (ACPI_DEVICE_PRESENT(devinfo->CurrentStatus))
1701 AcpiOsFree(buf.Pointer);
1706 * Returns true if the battery is actually present and inserted.
1709 acpi_BatteryIsPresent(device_t dev)
1711 ACPI_DEVICE_INFO *devinfo;
1718 if ((h = acpi_get_handle(dev)) == NULL)
1721 buf.Length = ACPI_ALLOCATE_BUFFER;
1722 error = AcpiGetObjectInfo(h, &buf);
1723 if (ACPI_FAILURE(error))
1725 devinfo = (ACPI_DEVICE_INFO *)buf.Pointer;
1727 /* If no _STA method, must be present */
1728 if ((devinfo->Valid & ACPI_VALID_STA) == 0)
1731 /* Return true for 'present', 'battery present', and 'functioning' */
1732 if (ACPI_BATTERY_PRESENT(devinfo->CurrentStatus))
1735 AcpiOsFree(buf.Pointer);
1740 * Match a HID string against a handle
1743 acpi_MatchHid(ACPI_HANDLE h, const char *hid)
1745 ACPI_DEVICE_INFO *devinfo;
1751 if (hid == NULL || h == NULL)
1754 buf.Length = ACPI_ALLOCATE_BUFFER;
1755 error = AcpiGetObjectInfo(h, &buf);
1756 if (ACPI_FAILURE(error))
1758 devinfo = (ACPI_DEVICE_INFO *)buf.Pointer;
1760 if ((devinfo->Valid & ACPI_VALID_HID) != 0 &&
1761 strcmp(hid, devinfo->HardwareId.Value) == 0)
1763 else if ((devinfo->Valid & ACPI_VALID_CID) != 0) {
1764 for (i = 0; i < devinfo->CompatibilityId.Count; i++) {
1765 if (strcmp(hid, devinfo->CompatibilityId.Id[i].Value) == 0) {
1772 AcpiOsFree(buf.Pointer);
1777 * Return the handle of a named object within our scope, ie. that of (parent)
1778 * or one if its parents.
1781 acpi_GetHandleInScope(ACPI_HANDLE parent, char *path, ACPI_HANDLE *result)
1786 /* Walk back up the tree to the root */
1788 status = AcpiGetHandle(parent, path, &r);
1789 if (ACPI_SUCCESS(status)) {
1793 /* XXX Return error here? */
1794 if (status != AE_NOT_FOUND)
1796 if (ACPI_FAILURE(AcpiGetParent(parent, &r)))
1797 return (AE_NOT_FOUND);
1802 /* Find the difference between two PM tick counts. */
1804 acpi_TimerDelta(uint32_t end, uint32_t start)
1809 delta = end - start;
1810 else if (AcpiGbl_FADT->TmrValExt == 0)
1811 delta = ((0x00FFFFFF - start) + end + 1) & 0x00FFFFFF;
1813 delta = ((0xFFFFFFFF - start) + end + 1);
1818 * Allocate a buffer with a preset data size.
1821 acpi_AllocBuffer(int size)
1825 if ((buf = malloc(size + sizeof(*buf), M_ACPIDEV, M_NOWAIT)) == NULL)
1828 buf->Pointer = (void *)(buf + 1);
1833 acpi_SetInteger(ACPI_HANDLE handle, char *path, UINT32 number)
1836 ACPI_OBJECT_LIST args;
1838 arg1.Type = ACPI_TYPE_INTEGER;
1839 arg1.Integer.Value = number;
1841 args.Pointer = &arg1;
1843 return (AcpiEvaluateObject(handle, path, &args, NULL));
1847 * Evaluate a path that should return an integer.
1850 acpi_GetInteger(ACPI_HANDLE handle, char *path, UINT32 *number)
1857 handle = ACPI_ROOT_OBJECT;
1860 * Assume that what we've been pointed at is an Integer object, or
1861 * a method that will return an Integer.
1863 buf.Pointer = ¶m;
1864 buf.Length = sizeof(param);
1865 status = AcpiEvaluateObject(handle, path, NULL, &buf);
1866 if (ACPI_SUCCESS(status)) {
1867 if (param.Type == ACPI_TYPE_INTEGER)
1868 *number = param.Integer.Value;
1874 * In some applications, a method that's expected to return an Integer
1875 * may instead return a Buffer (probably to simplify some internal
1876 * arithmetic). We'll try to fetch whatever it is, and if it's a Buffer,
1877 * convert it into an Integer as best we can.
1881 if (status == AE_BUFFER_OVERFLOW) {
1882 if ((buf.Pointer = AcpiOsAllocate(buf.Length)) == NULL) {
1883 status = AE_NO_MEMORY;
1885 status = AcpiEvaluateObject(handle, path, NULL, &buf);
1886 if (ACPI_SUCCESS(status))
1887 status = acpi_ConvertBufferToInteger(&buf, number);
1888 AcpiOsFree(buf.Pointer);
1895 acpi_ConvertBufferToInteger(ACPI_BUFFER *bufp, UINT32 *number)
1901 p = (ACPI_OBJECT *)bufp->Pointer;
1902 if (p->Type == ACPI_TYPE_INTEGER) {
1903 *number = p->Integer.Value;
1906 if (p->Type != ACPI_TYPE_BUFFER)
1908 if (p->Buffer.Length > sizeof(int))
1909 return (AE_BAD_DATA);
1912 val = p->Buffer.Pointer;
1913 for (i = 0; i < p->Buffer.Length; i++)
1914 *number += val[i] << (i * 8);
1919 * Iterate over the elements of an a package object, calling the supplied
1920 * function for each element.
1922 * XXX possible enhancement might be to abort traversal on error.
1925 acpi_ForeachPackageObject(ACPI_OBJECT *pkg,
1926 void (*func)(ACPI_OBJECT *comp, void *arg), void *arg)
1931 if (pkg == NULL || pkg->Type != ACPI_TYPE_PACKAGE)
1932 return (AE_BAD_PARAMETER);
1934 /* Iterate over components */
1936 comp = pkg->Package.Elements;
1937 for (; i < pkg->Package.Count; i++, comp++)
1944 * Find the (index)th resource object in a set.
1947 acpi_FindIndexedResource(ACPI_BUFFER *buf, int index, ACPI_RESOURCE **resp)
1952 rp = (ACPI_RESOURCE *)buf->Pointer;
1956 if (rp > (ACPI_RESOURCE *)((u_int8_t *)buf->Pointer + buf->Length))
1957 return (AE_BAD_PARAMETER);
1959 /* Check for terminator */
1960 if (rp->Type == ACPI_RESOURCE_TYPE_END_TAG || rp->Length == 0)
1961 return (AE_NOT_FOUND);
1962 rp = ACPI_NEXT_RESOURCE(rp);
1971 * Append an ACPI_RESOURCE to an ACPI_BUFFER.
1973 * Given a pointer to an ACPI_RESOURCE structure, expand the ACPI_BUFFER
1974 * provided to contain it. If the ACPI_BUFFER is empty, allocate a sensible
1975 * backing block. If the ACPI_RESOURCE is NULL, return an empty set of
1978 #define ACPI_INITIAL_RESOURCE_BUFFER_SIZE 512
1981 acpi_AppendBufferResource(ACPI_BUFFER *buf, ACPI_RESOURCE *res)
1986 /* Initialise the buffer if necessary. */
1987 if (buf->Pointer == NULL) {
1988 buf->Length = ACPI_INITIAL_RESOURCE_BUFFER_SIZE;
1989 if ((buf->Pointer = AcpiOsAllocate(buf->Length)) == NULL)
1990 return (AE_NO_MEMORY);
1991 rp = (ACPI_RESOURCE *)buf->Pointer;
1992 rp->Type = ACPI_RESOURCE_TYPE_END_TAG;
1999 * Scan the current buffer looking for the terminator.
2000 * This will either find the terminator or hit the end
2001 * of the buffer and return an error.
2003 rp = (ACPI_RESOURCE *)buf->Pointer;
2005 /* Range check, don't go outside the buffer */
2006 if (rp >= (ACPI_RESOURCE *)((u_int8_t *)buf->Pointer + buf->Length))
2007 return (AE_BAD_PARAMETER);
2008 if (rp->Type == ACPI_RESOURCE_TYPE_END_TAG || rp->Length == 0)
2010 rp = ACPI_NEXT_RESOURCE(rp);
2014 * Check the size of the buffer and expand if required.
2017 * size of existing resources before terminator +
2018 * size of new resource and header +
2019 * size of terminator.
2021 * Note that this loop should really only run once, unless
2022 * for some reason we are stuffing a *really* huge resource.
2024 while ((((u_int8_t *)rp - (u_int8_t *)buf->Pointer) +
2025 res->Length + ACPI_RS_SIZE_NO_DATA +
2026 ACPI_RS_SIZE_MIN) >= buf->Length) {
2027 if ((newp = AcpiOsAllocate(buf->Length * 2)) == NULL)
2028 return (AE_NO_MEMORY);
2029 bcopy(buf->Pointer, newp, buf->Length);
2030 rp = (ACPI_RESOURCE *)((u_int8_t *)newp +
2031 ((u_int8_t *)rp - (u_int8_t *)buf->Pointer));
2032 AcpiOsFree(buf->Pointer);
2033 buf->Pointer = newp;
2034 buf->Length += buf->Length;
2037 /* Insert the new resource. */
2038 bcopy(res, rp, res->Length + ACPI_RS_SIZE_NO_DATA);
2040 /* And add the terminator. */
2041 rp = ACPI_NEXT_RESOURCE(rp);
2042 rp->Type = ACPI_RESOURCE_TYPE_END_TAG;
2049 * Set interrupt model.
2052 acpi_SetIntrModel(int model)
2055 return (acpi_SetInteger(ACPI_ROOT_OBJECT, "_PIC", model));
2059 acpi_sleep_enable(void *arg)
2062 ((struct acpi_softc *)arg)->acpi_sleep_disabled = 0;
2065 enum acpi_sleep_state {
2068 ACPI_SS_DEV_SUSPEND,
2074 * Set the system sleep state
2076 * Currently we support S1-S5 but S4 is only S4BIOS
2079 acpi_SetSleepState(struct acpi_softc *sc, int state)
2084 enum acpi_sleep_state slp_state;
2086 ACPI_FUNCTION_TRACE_U32((char *)(uintptr_t)__func__, state);
2090 if (sc->acpi_sleep_disabled) {
2091 if (sc->acpi_sstate != ACPI_STATE_S0)
2094 printf("acpi: suspend request ignored (not ready yet)\n");
2097 sc->acpi_sleep_disabled = 1;
2101 * Be sure to hold Giant across DEVICE_SUSPEND/RESUME since non-MPSAFE
2102 * drivers need this.
2105 slp_state = ACPI_SS_NONE;
2111 status = AcpiGetSleepTypeData(state, &TypeA, &TypeB);
2112 if (status == AE_NOT_FOUND) {
2113 device_printf(sc->acpi_dev,
2114 "Sleep state S%d not supported by BIOS\n", state);
2116 } else if (ACPI_FAILURE(status)) {
2117 device_printf(sc->acpi_dev, "AcpiGetSleepTypeData failed - %s\n",
2118 AcpiFormatException(status));
2122 sc->acpi_sstate = state;
2124 /* Enable any GPEs as appropriate and requested by the user. */
2125 acpi_wake_prep_walk(state);
2126 slp_state = ACPI_SS_GPE_SET;
2129 * Inform all devices that we are going to sleep. If at least one
2130 * device fails, DEVICE_SUSPEND() automatically resumes the tree.
2132 * XXX Note that a better two-pass approach with a 'veto' pass
2133 * followed by a "real thing" pass would be better, but the current
2134 * bus interface does not provide for this.
2136 if (DEVICE_SUSPEND(root_bus) != 0) {
2137 device_printf(sc->acpi_dev, "device_suspend failed\n");
2140 slp_state = ACPI_SS_DEV_SUSPEND;
2142 status = AcpiEnterSleepStatePrep(state);
2143 if (ACPI_FAILURE(status)) {
2144 device_printf(sc->acpi_dev, "AcpiEnterSleepStatePrep failed - %s\n",
2145 AcpiFormatException(status));
2148 slp_state = ACPI_SS_SLP_PREP;
2150 if (sc->acpi_sleep_delay > 0)
2151 DELAY(sc->acpi_sleep_delay * 1000000);
2153 if (state != ACPI_STATE_S1) {
2154 acpi_sleep_machdep(sc, state);
2156 /* Re-enable ACPI hardware on wakeup from sleep state 4. */
2157 if (state == ACPI_STATE_S4)
2160 ACPI_DISABLE_IRQS();
2161 status = AcpiEnterSleepState(state);
2162 if (ACPI_FAILURE(status)) {
2163 device_printf(sc->acpi_dev, "AcpiEnterSleepState failed - %s\n",
2164 AcpiFormatException(status));
2168 slp_state = ACPI_SS_SLEPT;
2172 * Shut down cleanly and power off. This will call us back through the
2173 * shutdown handlers.
2175 shutdown_nice(RB_POWEROFF);
2179 status = AE_BAD_PARAMETER;
2184 * Back out state according to how far along we got in the suspend
2185 * process. This handles both the error and success cases.
2187 if (slp_state >= ACPI_SS_GPE_SET) {
2188 acpi_wake_prep_walk(state);
2189 sc->acpi_sstate = ACPI_STATE_S0;
2191 if (slp_state >= ACPI_SS_SLP_PREP)
2192 AcpiLeaveSleepState(state);
2193 if (slp_state >= ACPI_SS_DEV_SUSPEND)
2194 DEVICE_RESUME(root_bus);
2195 if (slp_state >= ACPI_SS_SLEPT)
2196 acpi_enable_fixed_events(sc);
2198 /* Allow another sleep request after a while. */
2199 if (state != ACPI_STATE_S5)
2200 timeout(acpi_sleep_enable, (caddr_t)sc, hz * ACPI_MINIMUM_AWAKETIME);
2203 return_ACPI_STATUS (status);
2206 /* Initialize a device's wake GPE. */
2208 acpi_wake_init(device_t dev, int type)
2210 struct acpi_prw_data prw;
2212 /* Evaluate _PRW to find the GPE. */
2213 if (acpi_parse_prw(acpi_get_handle(dev), &prw) != 0)
2216 /* Set the requested type for the GPE (runtime, wake, or both). */
2217 if (ACPI_FAILURE(AcpiSetGpeType(prw.gpe_handle, prw.gpe_bit, type))) {
2218 device_printf(dev, "set GPE type failed\n");
2225 /* Enable or disable the device's wake GPE. */
2227 acpi_wake_set_enable(device_t dev, int enable)
2229 struct acpi_prw_data prw;
2234 /* Make sure the device supports waking the system and get the GPE. */
2235 handle = acpi_get_handle(dev);
2236 if (acpi_parse_prw(handle, &prw) != 0)
2239 flags = acpi_get_flags(dev);
2241 status = AcpiEnableGpe(prw.gpe_handle, prw.gpe_bit, ACPI_NOT_ISR);
2242 if (ACPI_FAILURE(status)) {
2243 device_printf(dev, "enable wake failed\n");
2246 acpi_set_flags(dev, flags | ACPI_FLAG_WAKE_ENABLED);
2248 status = AcpiDisableGpe(prw.gpe_handle, prw.gpe_bit, ACPI_NOT_ISR);
2249 if (ACPI_FAILURE(status)) {
2250 device_printf(dev, "disable wake failed\n");
2253 acpi_set_flags(dev, flags & ~ACPI_FLAG_WAKE_ENABLED);
2260 acpi_wake_sleep_prep(ACPI_HANDLE handle, int sstate)
2262 struct acpi_prw_data prw;
2265 /* Check that this is a wake-capable device and get its GPE. */
2266 if (acpi_parse_prw(handle, &prw) != 0)
2268 dev = acpi_get_device(handle);
2271 * The destination sleep state must be less than (i.e., higher power)
2272 * or equal to the value specified by _PRW. If this GPE cannot be
2273 * enabled for the next sleep state, then disable it. If it can and
2274 * the user requested it be enabled, turn on any required power resources
2277 if (sstate > prw.lowest_wake) {
2278 AcpiDisableGpe(prw.gpe_handle, prw.gpe_bit, ACPI_NOT_ISR);
2280 device_printf(dev, "wake_prep disabled wake for %s (S%d)\n",
2281 acpi_name(handle), sstate);
2282 } else if (dev && (acpi_get_flags(dev) & ACPI_FLAG_WAKE_ENABLED) != 0) {
2283 acpi_pwr_wake_enable(handle, 1);
2284 acpi_SetInteger(handle, "_PSW", 1);
2286 device_printf(dev, "wake_prep enabled for %s (S%d)\n",
2287 acpi_name(handle), sstate);
2294 acpi_wake_run_prep(ACPI_HANDLE handle, int sstate)
2296 struct acpi_prw_data prw;
2300 * Check that this is a wake-capable device and get its GPE. Return
2301 * now if the user didn't enable this device for wake.
2303 if (acpi_parse_prw(handle, &prw) != 0)
2305 dev = acpi_get_device(handle);
2306 if (dev == NULL || (acpi_get_flags(dev) & ACPI_FLAG_WAKE_ENABLED) == 0)
2310 * If this GPE couldn't be enabled for the previous sleep state, it was
2311 * disabled before going to sleep so re-enable it. If it was enabled,
2312 * clear _PSW and turn off any power resources it used.
2314 if (sstate > prw.lowest_wake) {
2315 AcpiEnableGpe(prw.gpe_handle, prw.gpe_bit, ACPI_NOT_ISR);
2317 device_printf(dev, "run_prep re-enabled %s\n", acpi_name(handle));
2319 acpi_SetInteger(handle, "_PSW", 0);
2320 acpi_pwr_wake_enable(handle, 0);
2322 device_printf(dev, "run_prep cleaned up for %s\n",
2330 acpi_wake_prep(ACPI_HANDLE handle, UINT32 level, void *context, void **status)
2334 /* If suspending, run the sleep prep function, otherwise wake. */
2335 sstate = *(int *)context;
2336 if (AcpiGbl_SystemAwakeAndRunning)
2337 acpi_wake_sleep_prep(handle, sstate);
2339 acpi_wake_run_prep(handle, sstate);
2343 /* Walk the tree rooted at acpi0 to prep devices for suspend/resume. */
2345 acpi_wake_prep_walk(int sstate)
2347 ACPI_HANDLE sb_handle;
2349 if (ACPI_SUCCESS(AcpiGetHandle(ACPI_ROOT_OBJECT, "\\_SB_", &sb_handle)))
2350 AcpiWalkNamespace(ACPI_TYPE_DEVICE, sb_handle, 100,
2351 acpi_wake_prep, &sstate, NULL);
2355 /* Walk the tree rooted at acpi0 to attach per-device wake sysctls. */
2357 acpi_wake_sysctl_walk(device_t dev)
2359 int error, i, numdevs;
2364 error = device_get_children(dev, &devlist, &numdevs);
2365 if (error != 0 || numdevs == 0) {
2367 free(devlist, M_TEMP);
2370 for (i = 0; i < numdevs; i++) {
2372 acpi_wake_sysctl_walk(child);
2373 if (!device_is_attached(child))
2375 status = AcpiEvaluateObject(acpi_get_handle(child), "_PRW", NULL, NULL);
2376 if (ACPI_SUCCESS(status)) {
2377 SYSCTL_ADD_PROC(device_get_sysctl_ctx(child),
2378 SYSCTL_CHILDREN(device_get_sysctl_tree(child)), OID_AUTO,
2379 "wake", CTLTYPE_INT | CTLFLAG_RW, child, 0,
2380 acpi_wake_set_sysctl, "I", "Device set to wake the system");
2383 free(devlist, M_TEMP);
2388 /* Enable or disable wake from userland. */
2390 acpi_wake_set_sysctl(SYSCTL_HANDLER_ARGS)
2395 dev = (device_t)arg1;
2396 enable = (acpi_get_flags(dev) & ACPI_FLAG_WAKE_ENABLED) ? 1 : 0;
2398 error = sysctl_handle_int(oidp, &enable, 0, req);
2399 if (error != 0 || req->newptr == NULL)
2401 if (enable != 0 && enable != 1)
2404 return (acpi_wake_set_enable(dev, enable));
2407 /* Parse a device's _PRW into a structure. */
2409 acpi_parse_prw(ACPI_HANDLE h, struct acpi_prw_data *prw)
2412 ACPI_BUFFER prw_buffer;
2413 ACPI_OBJECT *res, *res2;
2414 int error, i, power_count;
2416 if (h == NULL || prw == NULL)
2420 * The _PRW object (7.2.9) is only required for devices that have the
2421 * ability to wake the system from a sleeping state.
2424 prw_buffer.Pointer = NULL;
2425 prw_buffer.Length = ACPI_ALLOCATE_BUFFER;
2426 status = AcpiEvaluateObject(h, "_PRW", NULL, &prw_buffer);
2427 if (ACPI_FAILURE(status))
2429 res = (ACPI_OBJECT *)prw_buffer.Pointer;
2432 if (!ACPI_PKG_VALID(res, 2))
2436 * Element 1 of the _PRW object:
2437 * The lowest power system sleeping state that can be entered while still
2438 * providing wake functionality. The sleeping state being entered must
2439 * be less than (i.e., higher power) or equal to this value.
2441 if (acpi_PkgInt32(res, 1, &prw->lowest_wake) != 0)
2445 * Element 0 of the _PRW object:
2447 switch (res->Package.Elements[0].Type) {
2448 case ACPI_TYPE_INTEGER:
2450 * If the data type of this package element is numeric, then this
2451 * _PRW package element is the bit index in the GPEx_EN, in the
2452 * GPE blocks described in the FADT, of the enable bit that is
2453 * enabled for the wake event.
2455 prw->gpe_handle = NULL;
2456 prw->gpe_bit = res->Package.Elements[0].Integer.Value;
2459 case ACPI_TYPE_PACKAGE:
2461 * If the data type of this package element is a package, then this
2462 * _PRW package element is itself a package containing two
2463 * elements. The first is an object reference to the GPE Block
2464 * device that contains the GPE that will be triggered by the wake
2465 * event. The second element is numeric and it contains the bit
2466 * index in the GPEx_EN, in the GPE Block referenced by the
2467 * first element in the package, of the enable bit that is enabled for
2470 * For example, if this field is a package then it is of the form:
2471 * Package() {\_SB.PCI0.ISA.GPE, 2}
2473 res2 = &res->Package.Elements[0];
2474 if (!ACPI_PKG_VALID(res2, 2))
2476 prw->gpe_handle = acpi_GetReference(NULL, &res2->Package.Elements[0]);
2477 if (prw->gpe_handle == NULL)
2479 if (acpi_PkgInt32(res2, 1, &prw->gpe_bit) != 0)
2487 /* Elements 2 to N of the _PRW object are power resources. */
2488 power_count = res->Package.Count - 2;
2489 if (power_count > ACPI_PRW_MAX_POWERRES) {
2490 printf("ACPI device %s has too many power resources\n", acpi_name(h));
2493 prw->power_res_count = power_count;
2494 for (i = 0; i < power_count; i++)
2495 prw->power_res[i] = res->Package.Elements[i];
2498 if (prw_buffer.Pointer != NULL)
2499 AcpiOsFree(prw_buffer.Pointer);
2504 * ACPI Event Handlers
2507 /* System Event Handlers (registered by EVENTHANDLER_REGISTER) */
2510 acpi_system_eventhandler_sleep(void *arg, int state)
2513 ACPI_FUNCTION_TRACE_U32((char *)(uintptr_t)__func__, state);
2515 if (state >= ACPI_STATE_S0 && state <= ACPI_S_STATES_MAX)
2516 acpi_SetSleepState((struct acpi_softc *)arg, state);
2522 acpi_system_eventhandler_wakeup(void *arg, int state)
2525 ACPI_FUNCTION_TRACE_U32((char *)(uintptr_t)__func__, state);
2527 /* Currently, nothing to do for wakeup. */
2533 * ACPICA Event Handlers (FixedEvent, also called from button notify handler)
2536 acpi_event_power_button_sleep(void *context)
2538 struct acpi_softc *sc = (struct acpi_softc *)context;
2540 ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
2542 EVENTHANDLER_INVOKE(acpi_sleep_event, sc->acpi_power_button_sx);
2544 return_VALUE (ACPI_INTERRUPT_HANDLED);
2548 acpi_event_power_button_wake(void *context)
2550 struct acpi_softc *sc = (struct acpi_softc *)context;
2552 ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
2554 EVENTHANDLER_INVOKE(acpi_wakeup_event, sc->acpi_power_button_sx);
2556 return_VALUE (ACPI_INTERRUPT_HANDLED);
2560 acpi_event_sleep_button_sleep(void *context)
2562 struct acpi_softc *sc = (struct acpi_softc *)context;
2564 ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
2566 EVENTHANDLER_INVOKE(acpi_sleep_event, sc->acpi_sleep_button_sx);
2568 return_VALUE (ACPI_INTERRUPT_HANDLED);
2572 acpi_event_sleep_button_wake(void *context)
2574 struct acpi_softc *sc = (struct acpi_softc *)context;
2576 ACPI_FUNCTION_TRACE((char *)(uintptr_t)__func__);
2578 EVENTHANDLER_INVOKE(acpi_wakeup_event, sc->acpi_sleep_button_sx);
2580 return_VALUE (ACPI_INTERRUPT_HANDLED);
2584 * XXX This static buffer is suboptimal. There is no locking so only
2585 * use this for single-threaded callers.
2588 acpi_name(ACPI_HANDLE handle)
2591 static char data[256];
2593 buf.Length = sizeof(data);
2596 if (handle && ACPI_SUCCESS(AcpiGetName(handle, ACPI_FULL_PATHNAME, &buf)))
2598 return ("(unknown)");
2602 * Debugging/bug-avoidance. Avoid trying to fetch info on various
2603 * parts of the namespace.
2606 acpi_avoid(ACPI_HANDLE handle)
2608 char *cp, *env, *np;
2611 np = acpi_name(handle);
2614 if ((env = getenv("debug.acpi.avoid")) == NULL)
2617 /* Scan the avoid list checking for a match */
2620 while (*cp != 0 && isspace(*cp))
2625 while (cp[len] != 0 && !isspace(cp[len]))
2627 if (!strncmp(cp, np, len)) {
2639 * Debugging/bug-avoidance. Disable ACPI subsystem components.
2642 acpi_disabled(char *subsys)
2647 if ((env = getenv("debug.acpi.disabled")) == NULL)
2649 if (strcmp(env, "all") == 0) {
2654 /* Scan the disable list, checking for a match. */
2657 while (*cp != '\0' && isspace(*cp))
2662 while (cp[len] != '\0' && !isspace(cp[len]))
2664 if (strncmp(cp, subsys, len) == 0) {
2676 * Control interface.
2678 * We multiplex ioctls for all participating ACPI devices here. Individual
2679 * drivers wanting to be accessible via /dev/acpi should use the
2680 * register/deregister interface to make their handlers visible.
2682 struct acpi_ioctl_hook
2684 TAILQ_ENTRY(acpi_ioctl_hook) link;
2690 static TAILQ_HEAD(,acpi_ioctl_hook) acpi_ioctl_hooks;
2691 static int acpi_ioctl_hooks_initted;
2694 acpi_register_ioctl(u_long cmd, acpi_ioctl_fn fn, void *arg)
2696 struct acpi_ioctl_hook *hp;
2698 if ((hp = malloc(sizeof(*hp), M_ACPIDEV, M_NOWAIT)) == NULL)
2705 if (acpi_ioctl_hooks_initted == 0) {
2706 TAILQ_INIT(&acpi_ioctl_hooks);
2707 acpi_ioctl_hooks_initted = 1;
2709 TAILQ_INSERT_TAIL(&acpi_ioctl_hooks, hp, link);
2716 acpi_deregister_ioctl(u_long cmd, acpi_ioctl_fn fn)
2718 struct acpi_ioctl_hook *hp;
2721 TAILQ_FOREACH(hp, &acpi_ioctl_hooks, link)
2722 if (hp->cmd == cmd && hp->fn == fn)
2726 TAILQ_REMOVE(&acpi_ioctl_hooks, hp, link);
2727 free(hp, M_ACPIDEV);
2733 acpiopen(struct cdev *dev, int flag, int fmt, d_thread_t *td)
2739 acpiclose(struct cdev *dev, int flag, int fmt, d_thread_t *td)
2745 acpiioctl(struct cdev *dev, u_long cmd, caddr_t addr, int flag, d_thread_t *td)
2747 struct acpi_softc *sc;
2748 struct acpi_ioctl_hook *hp;
2756 * Scan the list of registered ioctls, looking for handlers.
2759 if (acpi_ioctl_hooks_initted)
2760 TAILQ_FOREACH(hp, &acpi_ioctl_hooks, link) {
2766 return (hp->fn(cmd, addr, hp->arg));
2769 * Core ioctls are not permitted for non-writable user.
2770 * Currently, other ioctls just fetch information.
2771 * Not changing system behavior.
2773 if ((flag & FWRITE) == 0)
2776 /* Core system ioctls. */
2778 case ACPIIO_SETSLPSTATE:
2780 state = *(int *)addr;
2781 if (state >= ACPI_STATE_S0 && state <= ACPI_S_STATES_MAX)
2782 if (ACPI_SUCCESS(acpi_SetSleepState(sc, state)))
2794 acpi_supported_sleep_state_sysctl(SYSCTL_HANDLER_ARGS)
2798 UINT8 state, TypeA, TypeB;
2800 sbuf_new(&sb, NULL, 32, SBUF_AUTOEXTEND);
2801 for (state = ACPI_STATE_S1; state < ACPI_S_STATES_MAX + 1; state++)
2802 if (ACPI_SUCCESS(AcpiGetSleepTypeData(state, &TypeA, &TypeB)))
2803 sbuf_printf(&sb, "S%d ", state);
2806 error = sysctl_handle_string(oidp, sbuf_data(&sb), sbuf_len(&sb), req);
2812 acpi_sleep_state_sysctl(SYSCTL_HANDLER_ARGS)
2814 char sleep_state[10];
2816 u_int new_state, old_state;
2818 old_state = *(u_int *)oidp->oid_arg1;
2819 if (old_state > ACPI_S_STATES_MAX + 1)
2820 strlcpy(sleep_state, "unknown", sizeof(sleep_state));
2822 strlcpy(sleep_state, sleep_state_names[old_state], sizeof(sleep_state));
2823 error = sysctl_handle_string(oidp, sleep_state, sizeof(sleep_state), req);
2824 if (error == 0 && req->newptr != NULL) {
2825 new_state = ACPI_STATE_S0;
2826 for (; new_state <= ACPI_S_STATES_MAX + 1; new_state++)
2827 if (strcmp(sleep_state, sleep_state_names[new_state]) == 0)
2829 if (new_state <= ACPI_S_STATES_MAX + 1) {
2830 if (new_state != old_state)
2831 *(u_int *)oidp->oid_arg1 = new_state;
2839 /* Inform devctl(4) when we receive a Notify. */
2841 acpi_UserNotify(const char *subsystem, ACPI_HANDLE h, uint8_t notify)
2843 char notify_buf[16];
2844 ACPI_BUFFER handle_buf;
2847 if (subsystem == NULL)
2850 handle_buf.Pointer = NULL;
2851 handle_buf.Length = ACPI_ALLOCATE_BUFFER;
2852 status = AcpiNsHandleToPathname(h, &handle_buf);
2853 if (ACPI_FAILURE(status))
2855 snprintf(notify_buf, sizeof(notify_buf), "notify=0x%02x", notify);
2856 devctl_notify("ACPI", subsystem, handle_buf.Pointer, notify_buf);
2857 AcpiOsFree(handle_buf.Pointer);
2862 * Support for parsing debug options from the kernel environment.
2864 * Bits may be set in the AcpiDbgLayer and AcpiDbgLevel debug registers
2865 * by specifying the names of the bits in the debug.acpi.layer and
2866 * debug.acpi.level environment variables. Bits may be unset by
2867 * prefixing the bit name with !.
2875 static struct debugtag dbg_layer[] = {
2876 {"ACPI_UTILITIES", ACPI_UTILITIES},
2877 {"ACPI_HARDWARE", ACPI_HARDWARE},
2878 {"ACPI_EVENTS", ACPI_EVENTS},
2879 {"ACPI_TABLES", ACPI_TABLES},
2880 {"ACPI_NAMESPACE", ACPI_NAMESPACE},
2881 {"ACPI_PARSER", ACPI_PARSER},
2882 {"ACPI_DISPATCHER", ACPI_DISPATCHER},
2883 {"ACPI_EXECUTER", ACPI_EXECUTER},
2884 {"ACPI_RESOURCES", ACPI_RESOURCES},
2885 {"ACPI_CA_DEBUGGER", ACPI_CA_DEBUGGER},
2886 {"ACPI_OS_SERVICES", ACPI_OS_SERVICES},
2887 {"ACPI_CA_DISASSEMBLER", ACPI_CA_DISASSEMBLER},
2888 {"ACPI_ALL_COMPONENTS", ACPI_ALL_COMPONENTS},
2890 {"ACPI_AC_ADAPTER", ACPI_AC_ADAPTER},
2891 {"ACPI_BATTERY", ACPI_BATTERY},
2892 {"ACPI_BUS", ACPI_BUS},
2893 {"ACPI_BUTTON", ACPI_BUTTON},
2894 {"ACPI_EC", ACPI_EC},
2895 {"ACPI_FAN", ACPI_FAN},
2896 {"ACPI_POWERRES", ACPI_POWERRES},
2897 {"ACPI_PROCESSOR", ACPI_PROCESSOR},
2898 {"ACPI_THERMAL", ACPI_THERMAL},
2899 {"ACPI_TIMER", ACPI_TIMER},
2900 {"ACPI_ALL_DRIVERS", ACPI_ALL_DRIVERS},
2904 static struct debugtag dbg_level[] = {
2905 {"ACPI_LV_ERROR", ACPI_LV_ERROR},
2906 {"ACPI_LV_WARN", ACPI_LV_WARN},
2907 {"ACPI_LV_INIT", ACPI_LV_INIT},
2908 {"ACPI_LV_DEBUG_OBJECT", ACPI_LV_DEBUG_OBJECT},
2909 {"ACPI_LV_INFO", ACPI_LV_INFO},
2910 {"ACPI_LV_ALL_EXCEPTIONS", ACPI_LV_ALL_EXCEPTIONS},
2912 /* Trace verbosity level 1 [Standard Trace Level] */
2913 {"ACPI_LV_INIT_NAMES", ACPI_LV_INIT_NAMES},
2914 {"ACPI_LV_PARSE", ACPI_LV_PARSE},
2915 {"ACPI_LV_LOAD", ACPI_LV_LOAD},
2916 {"ACPI_LV_DISPATCH", ACPI_LV_DISPATCH},
2917 {"ACPI_LV_EXEC", ACPI_LV_EXEC},
2918 {"ACPI_LV_NAMES", ACPI_LV_NAMES},
2919 {"ACPI_LV_OPREGION", ACPI_LV_OPREGION},
2920 {"ACPI_LV_BFIELD", ACPI_LV_BFIELD},
2921 {"ACPI_LV_TABLES", ACPI_LV_TABLES},
2922 {"ACPI_LV_VALUES", ACPI_LV_VALUES},
2923 {"ACPI_LV_OBJECTS", ACPI_LV_OBJECTS},
2924 {"ACPI_LV_RESOURCES", ACPI_LV_RESOURCES},
2925 {"ACPI_LV_USER_REQUESTS", ACPI_LV_USER_REQUESTS},
2926 {"ACPI_LV_PACKAGE", ACPI_LV_PACKAGE},
2927 {"ACPI_LV_VERBOSITY1", ACPI_LV_VERBOSITY1},
2929 /* Trace verbosity level 2 [Function tracing and memory allocation] */
2930 {"ACPI_LV_ALLOCATIONS", ACPI_LV_ALLOCATIONS},
2931 {"ACPI_LV_FUNCTIONS", ACPI_LV_FUNCTIONS},
2932 {"ACPI_LV_OPTIMIZATIONS", ACPI_LV_OPTIMIZATIONS},
2933 {"ACPI_LV_VERBOSITY2", ACPI_LV_VERBOSITY2},
2934 {"ACPI_LV_ALL", ACPI_LV_ALL},
2936 /* Trace verbosity level 3 [Threading, I/O, and Interrupts] */
2937 {"ACPI_LV_MUTEX", ACPI_LV_MUTEX},
2938 {"ACPI_LV_THREADS", ACPI_LV_THREADS},
2939 {"ACPI_LV_IO", ACPI_LV_IO},
2940 {"ACPI_LV_INTERRUPTS", ACPI_LV_INTERRUPTS},
2941 {"ACPI_LV_VERBOSITY3", ACPI_LV_VERBOSITY3},
2943 /* Exceptionally verbose output -- also used in the global "DebugLevel" */
2944 {"ACPI_LV_AML_DISASSEMBLE", ACPI_LV_AML_DISASSEMBLE},
2945 {"ACPI_LV_VERBOSE_INFO", ACPI_LV_VERBOSE_INFO},
2946 {"ACPI_LV_FULL_TABLES", ACPI_LV_FULL_TABLES},
2947 {"ACPI_LV_EVENTS", ACPI_LV_EVENTS},
2948 {"ACPI_LV_VERBOSE", ACPI_LV_VERBOSE},
2953 acpi_parse_debug(char *cp, struct debugtag *tag, UINT32 *flag)
2965 while (*ep && !isspace(*ep))
2976 for (i = 0; tag[i].name != NULL; i++) {
2977 if (!strncmp(cp, tag[i].name, l)) {
2979 *flag |= tag[i].value;
2981 *flag &= ~tag[i].value;
2989 acpi_set_debugging(void *junk)
2991 char *layer, *level;
2998 layer = getenv("debug.acpi.layer");
2999 level = getenv("debug.acpi.level");
3000 if (layer == NULL && level == NULL)
3003 printf("ACPI set debug");
3004 if (layer != NULL) {
3005 if (strcmp("NONE", layer) != 0)
3006 printf(" layer '%s'", layer);
3007 acpi_parse_debug(layer, &dbg_layer[0], &AcpiDbgLayer);
3010 if (level != NULL) {
3011 if (strcmp("NONE", level) != 0)
3012 printf(" level '%s'", level);
3013 acpi_parse_debug(level, &dbg_level[0], &AcpiDbgLevel);
3019 SYSINIT(acpi_debugging, SI_SUB_TUNABLES, SI_ORDER_ANY, acpi_set_debugging,
3023 acpi_debug_sysctl(SYSCTL_HANDLER_ARGS)
3026 struct debugtag *tag;
3029 if (sbuf_new(&sb, NULL, 128, SBUF_AUTOEXTEND) == NULL)
3031 if (strcmp(oidp->oid_arg1, "debug.acpi.layer") == 0) {
3032 tag = &dbg_layer[0];
3033 dbg = &AcpiDbgLayer;
3035 tag = &dbg_level[0];
3036 dbg = &AcpiDbgLevel;
3039 /* Get old values if this is a get request. */
3040 ACPI_SERIAL_BEGIN(acpi);
3042 sbuf_cpy(&sb, "NONE");
3043 } else if (req->newptr == NULL) {
3044 for (; tag->name != NULL; tag++) {
3045 if ((*dbg & tag->value) == tag->value)
3046 sbuf_printf(&sb, "%s ", tag->name);
3052 /* Copy out the old values to the user. */
3053 error = SYSCTL_OUT(req, sbuf_data(&sb), sbuf_len(&sb));
3056 /* If the user is setting a string, parse it. */
3057 if (error == 0 && req->newptr != NULL) {
3059 setenv((char *)oidp->oid_arg1, (char *)req->newptr);
3060 acpi_set_debugging(NULL);
3062 ACPI_SERIAL_END(acpi);
3067 SYSCTL_PROC(_debug_acpi, OID_AUTO, layer, CTLFLAG_RW | CTLTYPE_STRING,
3068 "debug.acpi.layer", 0, acpi_debug_sysctl, "A", "");
3069 SYSCTL_PROC(_debug_acpi, OID_AUTO, level, CTLFLAG_RW | CTLTYPE_STRING,
3070 "debug.acpi.level", 0, acpi_debug_sysctl, "A", "");
3071 #endif /* ACPI_DEBUG */
3074 acpi_pm_func(u_long cmd, void *arg, ...)
3076 int state, acpi_state;
3078 struct acpi_softc *sc;
3083 case POWER_CMD_SUSPEND:
3084 sc = (struct acpi_softc *)arg;
3091 state = va_arg(ap, int);
3095 case POWER_SLEEP_STATE_STANDBY:
3096 acpi_state = sc->acpi_standby_sx;
3098 case POWER_SLEEP_STATE_SUSPEND:
3099 acpi_state = sc->acpi_suspend_sx;
3101 case POWER_SLEEP_STATE_HIBERNATE:
3102 acpi_state = ACPI_STATE_S4;
3109 acpi_SetSleepState(sc, acpi_state);
3121 acpi_pm_register(void *arg)
3123 if (!cold || resource_disabled("acpi", 0))
3126 power_pm_register(POWER_PM_TYPE_ACPI, acpi_pm_func, NULL);
3129 SYSINIT(power, SI_SUB_KLD, SI_ORDER_ANY, acpi_pm_register, 0);