1 // SPDX-License-Identifier: GPL-2.0-only
3 * scan.c - support for transforming the ACPI namespace into individual objects
6 #include <linux/module.h>
7 #include <linux/init.h>
8 #include <linux/slab.h>
9 #include <linux/kernel.h>
10 #include <linux/acpi.h>
11 #include <linux/acpi_iort.h>
12 #include <linux/signal.h>
13 #include <linux/kthread.h>
14 #include <linux/dmi.h>
15 #include <linux/nls.h>
16 #include <linux/dma-map-ops.h>
17 #include <linux/platform_data/x86/apple.h>
18 #include <linux/pgtable.h>
22 #define _COMPONENT ACPI_BUS_COMPONENT
23 ACPI_MODULE_NAME("scan");
24 extern struct acpi_device *acpi_root;
26 #define ACPI_BUS_CLASS "system_bus"
27 #define ACPI_BUS_HID "LNXSYBUS"
28 #define ACPI_BUS_DEVICE_NAME "System Bus"
30 #define ACPI_IS_ROOT_DEVICE(device) (!(device)->parent)
32 #define INVALID_ACPI_HANDLE ((acpi_handle)empty_zero_page)
34 static const char *dummy_hid = "device";
36 static LIST_HEAD(acpi_dep_list);
37 static DEFINE_MUTEX(acpi_dep_list_lock);
38 LIST_HEAD(acpi_bus_id_list);
39 static DEFINE_MUTEX(acpi_scan_lock);
40 static LIST_HEAD(acpi_scan_handlers_list);
41 DEFINE_MUTEX(acpi_device_lock);
42 LIST_HEAD(acpi_wakeup_device_list);
43 static DEFINE_MUTEX(acpi_hp_context_lock);
46 * The UART device described by the SPCR table is the only object which needs
47 * special-casing. Everything else is covered by ACPI namespace paths in STAO
50 static u64 spcr_uart_addr;
52 struct acpi_dep_data {
53 struct list_head node;
58 void acpi_scan_lock_acquire(void)
60 mutex_lock(&acpi_scan_lock);
62 EXPORT_SYMBOL_GPL(acpi_scan_lock_acquire);
64 void acpi_scan_lock_release(void)
66 mutex_unlock(&acpi_scan_lock);
68 EXPORT_SYMBOL_GPL(acpi_scan_lock_release);
70 void acpi_lock_hp_context(void)
72 mutex_lock(&acpi_hp_context_lock);
75 void acpi_unlock_hp_context(void)
77 mutex_unlock(&acpi_hp_context_lock);
80 void acpi_initialize_hp_context(struct acpi_device *adev,
81 struct acpi_hotplug_context *hp,
82 int (*notify)(struct acpi_device *, u32),
83 void (*uevent)(struct acpi_device *, u32))
85 acpi_lock_hp_context();
88 acpi_set_hp_context(adev, hp);
89 acpi_unlock_hp_context();
91 EXPORT_SYMBOL_GPL(acpi_initialize_hp_context);
93 int acpi_scan_add_handler(struct acpi_scan_handler *handler)
98 list_add_tail(&handler->list_node, &acpi_scan_handlers_list);
102 int acpi_scan_add_handler_with_hotplug(struct acpi_scan_handler *handler,
103 const char *hotplug_profile_name)
107 error = acpi_scan_add_handler(handler);
111 acpi_sysfs_add_hotplug_profile(&handler->hotplug, hotplug_profile_name);
115 bool acpi_scan_is_offline(struct acpi_device *adev, bool uevent)
117 struct acpi_device_physical_node *pn;
119 char *envp[] = { "EVENT=offline", NULL };
122 * acpi_container_offline() calls this for all of the container's
123 * children under the container's physical_node_lock lock.
125 mutex_lock_nested(&adev->physical_node_lock, SINGLE_DEPTH_NESTING);
127 list_for_each_entry(pn, &adev->physical_node_list, node)
128 if (device_supports_offline(pn->dev) && !pn->dev->offline) {
130 kobject_uevent_env(&pn->dev->kobj, KOBJ_CHANGE, envp);
136 mutex_unlock(&adev->physical_node_lock);
140 static acpi_status acpi_bus_offline(acpi_handle handle, u32 lvl, void *data,
143 struct acpi_device *device = NULL;
144 struct acpi_device_physical_node *pn;
145 bool second_pass = (bool)data;
146 acpi_status status = AE_OK;
148 if (acpi_bus_get_device(handle, &device))
151 if (device->handler && !device->handler->hotplug.enabled) {
152 *ret_p = &device->dev;
156 mutex_lock(&device->physical_node_lock);
158 list_for_each_entry(pn, &device->physical_node_list, node) {
162 /* Skip devices offlined by the first pass. */
166 pn->put_online = false;
168 ret = device_offline(pn->dev);
170 pn->put_online = !ret;
180 mutex_unlock(&device->physical_node_lock);
185 static acpi_status acpi_bus_online(acpi_handle handle, u32 lvl, void *data,
188 struct acpi_device *device = NULL;
189 struct acpi_device_physical_node *pn;
191 if (acpi_bus_get_device(handle, &device))
194 mutex_lock(&device->physical_node_lock);
196 list_for_each_entry(pn, &device->physical_node_list, node)
197 if (pn->put_online) {
198 device_online(pn->dev);
199 pn->put_online = false;
202 mutex_unlock(&device->physical_node_lock);
207 static int acpi_scan_try_to_offline(struct acpi_device *device)
209 acpi_handle handle = device->handle;
210 struct device *errdev = NULL;
214 * Carry out two passes here and ignore errors in the first pass,
215 * because if the devices in question are memory blocks and
216 * CONFIG_MEMCG is set, one of the blocks may hold data structures
217 * that the other blocks depend on, but it is not known in advance which
220 * If the first pass is successful, the second one isn't needed, though.
222 status = acpi_walk_namespace(ACPI_TYPE_ANY, handle, ACPI_UINT32_MAX,
223 NULL, acpi_bus_offline, (void *)false,
225 if (status == AE_SUPPORT) {
226 dev_warn(errdev, "Offline disabled.\n");
227 acpi_walk_namespace(ACPI_TYPE_ANY, handle, ACPI_UINT32_MAX,
228 acpi_bus_online, NULL, NULL, NULL);
231 acpi_bus_offline(handle, 0, (void *)false, (void **)&errdev);
234 acpi_walk_namespace(ACPI_TYPE_ANY, handle, ACPI_UINT32_MAX,
235 NULL, acpi_bus_offline, (void *)true,
238 acpi_bus_offline(handle, 0, (void *)true,
242 dev_warn(errdev, "Offline failed.\n");
243 acpi_bus_online(handle, 0, NULL, NULL);
244 acpi_walk_namespace(ACPI_TYPE_ANY, handle,
245 ACPI_UINT32_MAX, acpi_bus_online,
253 static int acpi_scan_hot_remove(struct acpi_device *device)
255 acpi_handle handle = device->handle;
256 unsigned long long sta;
259 if (device->handler && device->handler->hotplug.demand_offline) {
260 if (!acpi_scan_is_offline(device, true))
263 int error = acpi_scan_try_to_offline(device);
268 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
269 "Hot-removing device %s...\n", dev_name(&device->dev)));
271 acpi_bus_trim(device);
273 acpi_evaluate_lck(handle, 0);
277 status = acpi_evaluate_ej0(handle);
278 if (status == AE_NOT_FOUND)
280 else if (ACPI_FAILURE(status))
284 * Verify if eject was indeed successful. If not, log an error
285 * message. No need to call _OST since _EJ0 call was made OK.
287 status = acpi_evaluate_integer(handle, "_STA", NULL, &sta);
288 if (ACPI_FAILURE(status)) {
289 acpi_handle_warn(handle,
290 "Status check after eject failed (0x%x)\n", status);
291 } else if (sta & ACPI_STA_DEVICE_ENABLED) {
292 acpi_handle_warn(handle,
293 "Eject incomplete - status 0x%llx\n", sta);
299 static int acpi_scan_device_not_present(struct acpi_device *adev)
301 if (!acpi_device_enumerated(adev)) {
302 dev_warn(&adev->dev, "Still not present\n");
309 static int acpi_scan_device_check(struct acpi_device *adev)
313 acpi_bus_get_status(adev);
314 if (adev->status.present || adev->status.functional) {
316 * This function is only called for device objects for which
317 * matching scan handlers exist. The only situation in which
318 * the scan handler is not attached to this device object yet
319 * is when the device has just appeared (either it wasn't
320 * present at all before or it was removed and then added
324 dev_dbg(&adev->dev, "Already enumerated\n");
327 error = acpi_bus_scan(adev->handle);
329 dev_warn(&adev->dev, "Namespace scan failure\n");
333 error = acpi_scan_device_not_present(adev);
338 static int acpi_scan_bus_check(struct acpi_device *adev)
340 struct acpi_scan_handler *handler = adev->handler;
341 struct acpi_device *child;
344 acpi_bus_get_status(adev);
345 if (!(adev->status.present || adev->status.functional)) {
346 acpi_scan_device_not_present(adev);
349 if (handler && handler->hotplug.scan_dependent)
350 return handler->hotplug.scan_dependent(adev);
352 error = acpi_bus_scan(adev->handle);
354 dev_warn(&adev->dev, "Namespace scan failure\n");
357 list_for_each_entry(child, &adev->children, node) {
358 error = acpi_scan_bus_check(child);
365 static int acpi_generic_hotplug_event(struct acpi_device *adev, u32 type)
368 case ACPI_NOTIFY_BUS_CHECK:
369 return acpi_scan_bus_check(adev);
370 case ACPI_NOTIFY_DEVICE_CHECK:
371 return acpi_scan_device_check(adev);
372 case ACPI_NOTIFY_EJECT_REQUEST:
373 case ACPI_OST_EC_OSPM_EJECT:
374 if (adev->handler && !adev->handler->hotplug.enabled) {
375 dev_info(&adev->dev, "Eject disabled\n");
378 acpi_evaluate_ost(adev->handle, ACPI_NOTIFY_EJECT_REQUEST,
379 ACPI_OST_SC_EJECT_IN_PROGRESS, NULL);
380 return acpi_scan_hot_remove(adev);
385 void acpi_device_hotplug(struct acpi_device *adev, u32 src)
387 u32 ost_code = ACPI_OST_SC_NON_SPECIFIC_FAILURE;
390 lock_device_hotplug();
391 mutex_lock(&acpi_scan_lock);
394 * The device object's ACPI handle cannot become invalid as long as we
395 * are holding acpi_scan_lock, but it might have become invalid before
396 * that lock was acquired.
398 if (adev->handle == INVALID_ACPI_HANDLE)
401 if (adev->flags.is_dock_station) {
402 error = dock_notify(adev, src);
403 } else if (adev->flags.hotplug_notify) {
404 error = acpi_generic_hotplug_event(adev, src);
406 int (*notify)(struct acpi_device *, u32);
408 acpi_lock_hp_context();
409 notify = adev->hp ? adev->hp->notify : NULL;
410 acpi_unlock_hp_context();
412 * There may be additional notify handlers for device objects
413 * without the .event() callback, so ignore them here.
416 error = notify(adev, src);
422 ost_code = ACPI_OST_SC_SUCCESS;
425 ost_code = ACPI_OST_SC_EJECT_NOT_SUPPORTED;
428 ost_code = ACPI_OST_SC_DEVICE_BUSY;
431 ost_code = ACPI_OST_SC_NON_SPECIFIC_FAILURE;
436 acpi_evaluate_ost(adev->handle, src, ost_code, NULL);
439 acpi_bus_put_acpi_device(adev);
440 mutex_unlock(&acpi_scan_lock);
441 unlock_device_hotplug();
444 static void acpi_free_power_resources_lists(struct acpi_device *device)
448 if (device->wakeup.flags.valid)
449 acpi_power_resources_list_free(&device->wakeup.resources);
451 if (!device->power.flags.power_resources)
454 for (i = ACPI_STATE_D0; i <= ACPI_STATE_D3_HOT; i++) {
455 struct acpi_device_power_state *ps = &device->power.states[i];
456 acpi_power_resources_list_free(&ps->resources);
460 static void acpi_device_release(struct device *dev)
462 struct acpi_device *acpi_dev = to_acpi_device(dev);
464 acpi_free_properties(acpi_dev);
465 acpi_free_pnp_ids(&acpi_dev->pnp);
466 acpi_free_power_resources_lists(acpi_dev);
470 static void acpi_device_del(struct acpi_device *device)
472 struct acpi_device_bus_id *acpi_device_bus_id;
474 mutex_lock(&acpi_device_lock);
476 list_del(&device->node);
478 list_for_each_entry(acpi_device_bus_id, &acpi_bus_id_list, node)
479 if (!strcmp(acpi_device_bus_id->bus_id,
480 acpi_device_hid(device))) {
481 ida_simple_remove(&acpi_device_bus_id->instance_ida, device->pnp.instance_no);
482 if (ida_is_empty(&acpi_device_bus_id->instance_ida)) {
483 list_del(&acpi_device_bus_id->node);
484 kfree_const(acpi_device_bus_id->bus_id);
485 kfree(acpi_device_bus_id);
490 list_del(&device->wakeup_list);
491 mutex_unlock(&acpi_device_lock);
493 acpi_power_add_remove_device(device, false);
494 acpi_device_remove_files(device);
496 device->remove(device);
498 device_del(&device->dev);
501 static BLOCKING_NOTIFIER_HEAD(acpi_reconfig_chain);
503 static LIST_HEAD(acpi_device_del_list);
504 static DEFINE_MUTEX(acpi_device_del_lock);
506 static void acpi_device_del_work_fn(struct work_struct *work_not_used)
509 struct acpi_device *adev;
511 mutex_lock(&acpi_device_del_lock);
513 if (list_empty(&acpi_device_del_list)) {
514 mutex_unlock(&acpi_device_del_lock);
517 adev = list_first_entry(&acpi_device_del_list,
518 struct acpi_device, del_list);
519 list_del(&adev->del_list);
521 mutex_unlock(&acpi_device_del_lock);
523 blocking_notifier_call_chain(&acpi_reconfig_chain,
524 ACPI_RECONFIG_DEVICE_REMOVE, adev);
526 acpi_device_del(adev);
528 * Drop references to all power resources that might have been
529 * used by the device.
531 acpi_power_transition(adev, ACPI_STATE_D3_COLD);
532 put_device(&adev->dev);
537 * acpi_scan_drop_device - Drop an ACPI device object.
538 * @handle: Handle of an ACPI namespace node, not used.
539 * @context: Address of the ACPI device object to drop.
541 * This is invoked by acpi_ns_delete_node() during the removal of the ACPI
542 * namespace node the device object pointed to by @context is attached to.
544 * The unregistration is carried out asynchronously to avoid running
545 * acpi_device_del() under the ACPICA's namespace mutex and the list is used to
546 * ensure the correct ordering (the device objects must be unregistered in the
547 * same order in which the corresponding namespace nodes are deleted).
549 static void acpi_scan_drop_device(acpi_handle handle, void *context)
551 static DECLARE_WORK(work, acpi_device_del_work_fn);
552 struct acpi_device *adev = context;
554 mutex_lock(&acpi_device_del_lock);
557 * Use the ACPI hotplug workqueue which is ordered, so this work item
558 * won't run after any hotplug work items submitted subsequently. That
559 * prevents attempts to register device objects identical to those being
560 * deleted from happening concurrently (such attempts result from
561 * hotplug events handled via the ACPI hotplug workqueue). It also will
562 * run after all of the work items submitted previosuly, which helps
563 * those work items to ensure that they are not accessing stale device
566 if (list_empty(&acpi_device_del_list))
567 acpi_queue_hotplug_work(&work);
569 list_add_tail(&adev->del_list, &acpi_device_del_list);
570 /* Make acpi_ns_validate_handle() return NULL for this handle. */
571 adev->handle = INVALID_ACPI_HANDLE;
573 mutex_unlock(&acpi_device_del_lock);
576 static int acpi_get_device_data(acpi_handle handle, struct acpi_device **device,
577 void (*callback)(void *))
586 status = acpi_get_data_full(handle, acpi_scan_drop_device,
587 (void **)device, callback);
588 if (ACPI_FAILURE(status) || !*device) {
589 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "No context for object [%p]\n",
596 int acpi_bus_get_device(acpi_handle handle, struct acpi_device **device)
598 return acpi_get_device_data(handle, device, NULL);
600 EXPORT_SYMBOL(acpi_bus_get_device);
602 static void get_acpi_device(void *dev)
605 get_device(&((struct acpi_device *)dev)->dev);
608 struct acpi_device *acpi_bus_get_acpi_device(acpi_handle handle)
610 struct acpi_device *adev = NULL;
612 acpi_get_device_data(handle, &adev, get_acpi_device);
616 void acpi_bus_put_acpi_device(struct acpi_device *adev)
618 put_device(&adev->dev);
621 static struct acpi_device_bus_id *acpi_device_bus_id_match(const char *dev_id)
623 struct acpi_device_bus_id *acpi_device_bus_id;
625 /* Find suitable bus_id and instance number in acpi_bus_id_list. */
626 list_for_each_entry(acpi_device_bus_id, &acpi_bus_id_list, node) {
627 if (!strcmp(acpi_device_bus_id->bus_id, dev_id))
628 return acpi_device_bus_id;
633 static int acpi_device_set_name(struct acpi_device *device,
634 struct acpi_device_bus_id *acpi_device_bus_id)
636 struct ida *instance_ida = &acpi_device_bus_id->instance_ida;
639 result = ida_simple_get(instance_ida, 0, ACPI_MAX_DEVICE_INSTANCES, GFP_KERNEL);
643 device->pnp.instance_no = result;
644 dev_set_name(&device->dev, "%s:%02x", acpi_device_bus_id->bus_id, result);
648 int acpi_device_add(struct acpi_device *device,
649 void (*release)(struct device *))
651 struct acpi_device_bus_id *acpi_device_bus_id;
654 if (device->handle) {
657 status = acpi_attach_data(device->handle, acpi_scan_drop_device,
659 if (ACPI_FAILURE(status)) {
660 acpi_handle_err(device->handle,
661 "Unable to attach device data\n");
669 * Link this device to its parent and siblings.
671 INIT_LIST_HEAD(&device->children);
672 INIT_LIST_HEAD(&device->node);
673 INIT_LIST_HEAD(&device->wakeup_list);
674 INIT_LIST_HEAD(&device->physical_node_list);
675 INIT_LIST_HEAD(&device->del_list);
676 mutex_init(&device->physical_node_lock);
678 mutex_lock(&acpi_device_lock);
680 acpi_device_bus_id = acpi_device_bus_id_match(acpi_device_hid(device));
681 if (acpi_device_bus_id) {
682 result = acpi_device_set_name(device, acpi_device_bus_id);
686 acpi_device_bus_id = kzalloc(sizeof(*acpi_device_bus_id),
688 if (!acpi_device_bus_id) {
692 acpi_device_bus_id->bus_id =
693 kstrdup_const(acpi_device_hid(device), GFP_KERNEL);
694 if (!acpi_device_bus_id->bus_id) {
695 kfree(acpi_device_bus_id);
700 ida_init(&acpi_device_bus_id->instance_ida);
702 result = acpi_device_set_name(device, acpi_device_bus_id);
704 kfree_const(acpi_device_bus_id->bus_id);
705 kfree(acpi_device_bus_id);
709 list_add_tail(&acpi_device_bus_id->node, &acpi_bus_id_list);
713 list_add_tail(&device->node, &device->parent->children);
715 if (device->wakeup.flags.valid)
716 list_add_tail(&device->wakeup_list, &acpi_wakeup_device_list);
717 mutex_unlock(&acpi_device_lock);
720 device->dev.parent = &device->parent->dev;
721 device->dev.bus = &acpi_bus_type;
722 device->dev.release = release;
723 result = device_add(&device->dev);
725 dev_err(&device->dev, "Error registering device\n");
729 result = acpi_device_setup_files(device);
731 printk(KERN_ERR PREFIX "Error creating sysfs interface for device %s\n",
732 dev_name(&device->dev));
737 mutex_lock(&acpi_device_lock);
739 list_del(&device->node);
740 list_del(&device->wakeup_list);
743 mutex_unlock(&acpi_device_lock);
745 acpi_detach_data(device->handle, acpi_scan_drop_device);
749 /* --------------------------------------------------------------------------
751 -------------------------------------------------------------------------- */
752 static struct acpi_device *acpi_bus_get_parent(acpi_handle handle)
754 struct acpi_device *device = NULL;
758 * Fixed hardware devices do not appear in the namespace and do not
759 * have handles, but we fabricate acpi_devices for them, so we have
760 * to deal with them specially.
766 status = acpi_get_parent(handle, &handle);
767 if (ACPI_FAILURE(status))
768 return status == AE_NULL_ENTRY ? NULL : acpi_root;
769 } while (acpi_bus_get_device(handle, &device));
774 acpi_bus_get_ejd(acpi_handle handle, acpi_handle *ejd)
778 struct acpi_buffer buffer = {ACPI_ALLOCATE_BUFFER, NULL};
779 union acpi_object *obj;
781 status = acpi_get_handle(handle, "_EJD", &tmp);
782 if (ACPI_FAILURE(status))
785 status = acpi_evaluate_object(handle, "_EJD", NULL, &buffer);
786 if (ACPI_SUCCESS(status)) {
787 obj = buffer.pointer;
788 status = acpi_get_handle(ACPI_ROOT_OBJECT, obj->string.pointer,
790 kfree(buffer.pointer);
794 EXPORT_SYMBOL_GPL(acpi_bus_get_ejd);
796 static int acpi_bus_extract_wakeup_device_power_package(struct acpi_device *dev)
798 acpi_handle handle = dev->handle;
799 struct acpi_device_wakeup *wakeup = &dev->wakeup;
800 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
801 union acpi_object *package = NULL;
802 union acpi_object *element = NULL;
806 INIT_LIST_HEAD(&wakeup->resources);
809 status = acpi_evaluate_object(handle, "_PRW", NULL, &buffer);
810 if (ACPI_FAILURE(status)) {
811 ACPI_EXCEPTION((AE_INFO, status, "Evaluating _PRW"));
815 package = (union acpi_object *)buffer.pointer;
817 if (!package || package->package.count < 2)
820 element = &(package->package.elements[0]);
824 if (element->type == ACPI_TYPE_PACKAGE) {
825 if ((element->package.count < 2) ||
826 (element->package.elements[0].type !=
827 ACPI_TYPE_LOCAL_REFERENCE)
828 || (element->package.elements[1].type != ACPI_TYPE_INTEGER))
832 element->package.elements[0].reference.handle;
834 (u32) element->package.elements[1].integer.value;
835 } else if (element->type == ACPI_TYPE_INTEGER) {
836 wakeup->gpe_device = NULL;
837 wakeup->gpe_number = element->integer.value;
842 element = &(package->package.elements[1]);
843 if (element->type != ACPI_TYPE_INTEGER)
846 wakeup->sleep_state = element->integer.value;
848 err = acpi_extract_power_resources(package, 2, &wakeup->resources);
852 if (!list_empty(&wakeup->resources)) {
855 err = acpi_power_wakeup_list_init(&wakeup->resources,
858 acpi_handle_warn(handle, "Retrieving current states "
859 "of wakeup power resources failed\n");
860 acpi_power_resources_list_free(&wakeup->resources);
863 if (sleep_state < wakeup->sleep_state) {
864 acpi_handle_warn(handle, "Overriding _PRW sleep state "
865 "(S%d) by S%d from power resources\n",
866 (int)wakeup->sleep_state, sleep_state);
867 wakeup->sleep_state = sleep_state;
872 kfree(buffer.pointer);
876 static bool acpi_wakeup_gpe_init(struct acpi_device *device)
878 static const struct acpi_device_id button_device_ids[] = {
879 {"PNP0C0C", 0}, /* Power button */
880 {"PNP0C0D", 0}, /* Lid */
881 {"PNP0C0E", 0}, /* Sleep button */
884 struct acpi_device_wakeup *wakeup = &device->wakeup;
887 wakeup->flags.notifier_present = 0;
889 /* Power button, Lid switch always enable wakeup */
890 if (!acpi_match_device_ids(device, button_device_ids)) {
891 if (!acpi_match_device_ids(device, &button_device_ids[1])) {
892 /* Do not use Lid/sleep button for S5 wakeup */
893 if (wakeup->sleep_state == ACPI_STATE_S5)
894 wakeup->sleep_state = ACPI_STATE_S4;
896 acpi_mark_gpe_for_wake(wakeup->gpe_device, wakeup->gpe_number);
897 device_set_wakeup_capable(&device->dev, true);
901 status = acpi_setup_gpe_for_wake(device->handle, wakeup->gpe_device,
903 return ACPI_SUCCESS(status);
906 static void acpi_bus_get_wakeup_device_flags(struct acpi_device *device)
910 /* Presence of _PRW indicates wake capable */
911 if (!acpi_has_method(device->handle, "_PRW"))
914 err = acpi_bus_extract_wakeup_device_power_package(device);
916 dev_err(&device->dev, "_PRW evaluation error: %d\n", err);
920 device->wakeup.flags.valid = acpi_wakeup_gpe_init(device);
921 device->wakeup.prepare_count = 0;
923 * Call _PSW/_DSW object to disable its ability to wake the sleeping
924 * system for the ACPI device with the _PRW object.
925 * The _PSW object is deprecated in ACPI 3.0 and is replaced by _DSW.
926 * So it is necessary to call _DSW object first. Only when it is not
927 * present will the _PSW object used.
929 err = acpi_device_sleep_wake(device, 0, 0, 0);
931 pr_debug("error in _DSW or _PSW evaluation\n");
934 static void acpi_bus_init_power_state(struct acpi_device *device, int state)
936 struct acpi_device_power_state *ps = &device->power.states[state];
937 char pathname[5] = { '_', 'P', 'R', '0' + state, '\0' };
938 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
941 INIT_LIST_HEAD(&ps->resources);
943 /* Evaluate "_PRx" to get referenced power resources */
944 status = acpi_evaluate_object(device->handle, pathname, NULL, &buffer);
945 if (ACPI_SUCCESS(status)) {
946 union acpi_object *package = buffer.pointer;
948 if (buffer.length && package
949 && package->type == ACPI_TYPE_PACKAGE
950 && package->package.count)
951 acpi_extract_power_resources(package, 0, &ps->resources);
953 ACPI_FREE(buffer.pointer);
956 /* Evaluate "_PSx" to see if we can do explicit sets */
958 if (acpi_has_method(device->handle, pathname))
959 ps->flags.explicit_set = 1;
961 /* State is valid if there are means to put the device into it. */
962 if (!list_empty(&ps->resources) || ps->flags.explicit_set)
965 ps->power = -1; /* Unknown - driver assigned */
966 ps->latency = -1; /* Unknown - driver assigned */
969 static void acpi_bus_get_power_flags(struct acpi_device *device)
973 /* Presence of _PS0|_PR0 indicates 'power manageable' */
974 if (!acpi_has_method(device->handle, "_PS0") &&
975 !acpi_has_method(device->handle, "_PR0"))
978 device->flags.power_manageable = 1;
981 * Power Management Flags
983 if (acpi_has_method(device->handle, "_PSC"))
984 device->power.flags.explicit_get = 1;
986 if (acpi_has_method(device->handle, "_IRC"))
987 device->power.flags.inrush_current = 1;
989 if (acpi_has_method(device->handle, "_DSW"))
990 device->power.flags.dsw_present = 1;
993 * Enumerate supported power management states
995 for (i = ACPI_STATE_D0; i <= ACPI_STATE_D3_HOT; i++)
996 acpi_bus_init_power_state(device, i);
998 INIT_LIST_HEAD(&device->power.states[ACPI_STATE_D3_COLD].resources);
1000 /* Set the defaults for D0 and D3hot (always supported). */
1001 device->power.states[ACPI_STATE_D0].flags.valid = 1;
1002 device->power.states[ACPI_STATE_D0].power = 100;
1003 device->power.states[ACPI_STATE_D3_HOT].flags.valid = 1;
1006 * Use power resources only if the D0 list of them is populated, because
1007 * some platforms may provide _PR3 only to indicate D3cold support and
1008 * in those cases the power resources list returned by it may be bogus.
1010 if (!list_empty(&device->power.states[ACPI_STATE_D0].resources)) {
1011 device->power.flags.power_resources = 1;
1013 * D3cold is supported if the D3hot list of power resources is
1016 if (!list_empty(&device->power.states[ACPI_STATE_D3_HOT].resources))
1017 device->power.states[ACPI_STATE_D3_COLD].flags.valid = 1;
1020 if (acpi_bus_init_power(device))
1021 device->flags.power_manageable = 0;
1024 static void acpi_bus_get_flags(struct acpi_device *device)
1026 /* Presence of _STA indicates 'dynamic_status' */
1027 if (acpi_has_method(device->handle, "_STA"))
1028 device->flags.dynamic_status = 1;
1030 /* Presence of _RMV indicates 'removable' */
1031 if (acpi_has_method(device->handle, "_RMV"))
1032 device->flags.removable = 1;
1034 /* Presence of _EJD|_EJ0 indicates 'ejectable' */
1035 if (acpi_has_method(device->handle, "_EJD") ||
1036 acpi_has_method(device->handle, "_EJ0"))
1037 device->flags.ejectable = 1;
1040 static void acpi_device_get_busid(struct acpi_device *device)
1042 char bus_id[5] = { '?', 0 };
1043 struct acpi_buffer buffer = { sizeof(bus_id), bus_id };
1049 * The device's Bus ID is simply the object name.
1050 * TBD: Shouldn't this value be unique (within the ACPI namespace)?
1052 if (ACPI_IS_ROOT_DEVICE(device)) {
1053 strcpy(device->pnp.bus_id, "ACPI");
1057 switch (device->device_type) {
1058 case ACPI_BUS_TYPE_POWER_BUTTON:
1059 strcpy(device->pnp.bus_id, "PWRF");
1061 case ACPI_BUS_TYPE_SLEEP_BUTTON:
1062 strcpy(device->pnp.bus_id, "SLPF");
1064 case ACPI_BUS_TYPE_ECDT_EC:
1065 strcpy(device->pnp.bus_id, "ECDT");
1068 acpi_get_name(device->handle, ACPI_SINGLE_NAME, &buffer);
1069 /* Clean up trailing underscores (if any) */
1070 for (i = 3; i > 1; i--) {
1071 if (bus_id[i] == '_')
1076 strcpy(device->pnp.bus_id, bus_id);
1082 * acpi_ata_match - see if an acpi object is an ATA device
1084 * If an acpi object has one of the ACPI ATA methods defined,
1085 * then we can safely call it an ATA device.
1087 bool acpi_ata_match(acpi_handle handle)
1089 return acpi_has_method(handle, "_GTF") ||
1090 acpi_has_method(handle, "_GTM") ||
1091 acpi_has_method(handle, "_STM") ||
1092 acpi_has_method(handle, "_SDD");
1096 * acpi_bay_match - see if an acpi object is an ejectable driver bay
1098 * If an acpi object is ejectable and has one of the ACPI ATA methods defined,
1099 * then we can safely call it an ejectable drive bay
1101 bool acpi_bay_match(acpi_handle handle)
1103 acpi_handle phandle;
1105 if (!acpi_has_method(handle, "_EJ0"))
1107 if (acpi_ata_match(handle))
1109 if (ACPI_FAILURE(acpi_get_parent(handle, &phandle)))
1112 return acpi_ata_match(phandle);
1115 bool acpi_device_is_battery(struct acpi_device *adev)
1117 struct acpi_hardware_id *hwid;
1119 list_for_each_entry(hwid, &adev->pnp.ids, list)
1120 if (!strcmp("PNP0C0A", hwid->id))
1126 static bool is_ejectable_bay(struct acpi_device *adev)
1128 acpi_handle handle = adev->handle;
1130 if (acpi_has_method(handle, "_EJ0") && acpi_device_is_battery(adev))
1133 return acpi_bay_match(handle);
1137 * acpi_dock_match - see if an acpi object has a _DCK method
1139 bool acpi_dock_match(acpi_handle handle)
1141 return acpi_has_method(handle, "_DCK");
1145 acpi_backlight_cap_match(acpi_handle handle, u32 level, void *context,
1146 void **return_value)
1148 long *cap = context;
1150 if (acpi_has_method(handle, "_BCM") &&
1151 acpi_has_method(handle, "_BCL")) {
1152 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Found generic backlight "
1154 *cap |= ACPI_VIDEO_BACKLIGHT;
1155 /* We have backlight support, no need to scan further */
1156 return AE_CTRL_TERMINATE;
1161 /* Returns true if the ACPI object is a video device which can be
1162 * handled by video.ko.
1163 * The device will get a Linux specific CID added in scan.c to
1164 * identify the device as an ACPI graphics device
1165 * Be aware that the graphics device may not be physically present
1166 * Use acpi_video_get_capabilities() to detect general ACPI video
1167 * capabilities of present cards
1169 long acpi_is_video_device(acpi_handle handle)
1171 long video_caps = 0;
1173 /* Is this device able to support video switching ? */
1174 if (acpi_has_method(handle, "_DOD") || acpi_has_method(handle, "_DOS"))
1175 video_caps |= ACPI_VIDEO_OUTPUT_SWITCHING;
1177 /* Is this device able to retrieve a video ROM ? */
1178 if (acpi_has_method(handle, "_ROM"))
1179 video_caps |= ACPI_VIDEO_ROM_AVAILABLE;
1181 /* Is this device able to configure which video head to be POSTed ? */
1182 if (acpi_has_method(handle, "_VPO") &&
1183 acpi_has_method(handle, "_GPD") &&
1184 acpi_has_method(handle, "_SPD"))
1185 video_caps |= ACPI_VIDEO_DEVICE_POSTING;
1187 /* Only check for backlight functionality if one of the above hit. */
1189 acpi_walk_namespace(ACPI_TYPE_DEVICE, handle,
1190 ACPI_UINT32_MAX, acpi_backlight_cap_match, NULL,
1195 EXPORT_SYMBOL(acpi_is_video_device);
1197 const char *acpi_device_hid(struct acpi_device *device)
1199 struct acpi_hardware_id *hid;
1201 if (list_empty(&device->pnp.ids))
1204 hid = list_first_entry(&device->pnp.ids, struct acpi_hardware_id, list);
1207 EXPORT_SYMBOL(acpi_device_hid);
1209 static void acpi_add_id(struct acpi_device_pnp *pnp, const char *dev_id)
1211 struct acpi_hardware_id *id;
1213 id = kmalloc(sizeof(*id), GFP_KERNEL);
1217 id->id = kstrdup_const(dev_id, GFP_KERNEL);
1223 list_add_tail(&id->list, &pnp->ids);
1224 pnp->type.hardware_id = 1;
1228 * Old IBM workstations have a DSDT bug wherein the SMBus object
1229 * lacks the SMBUS01 HID and the methods do not have the necessary "_"
1230 * prefix. Work around this.
1232 static bool acpi_ibm_smbus_match(acpi_handle handle)
1234 char node_name[ACPI_PATH_SEGMENT_LENGTH];
1235 struct acpi_buffer path = { sizeof(node_name), node_name };
1237 if (!dmi_name_in_vendors("IBM"))
1240 /* Look for SMBS object */
1241 if (ACPI_FAILURE(acpi_get_name(handle, ACPI_SINGLE_NAME, &path)) ||
1242 strcmp("SMBS", path.pointer))
1245 /* Does it have the necessary (but misnamed) methods? */
1246 if (acpi_has_method(handle, "SBI") &&
1247 acpi_has_method(handle, "SBR") &&
1248 acpi_has_method(handle, "SBW"))
1254 static bool acpi_object_is_system_bus(acpi_handle handle)
1258 if (ACPI_SUCCESS(acpi_get_handle(NULL, "\\_SB", &tmp)) &&
1261 if (ACPI_SUCCESS(acpi_get_handle(NULL, "\\_TZ", &tmp)) &&
1268 static void acpi_set_pnp_ids(acpi_handle handle, struct acpi_device_pnp *pnp,
1272 struct acpi_device_info *info;
1273 struct acpi_pnp_device_id_list *cid_list;
1276 switch (device_type) {
1277 case ACPI_BUS_TYPE_DEVICE:
1278 if (handle == ACPI_ROOT_OBJECT) {
1279 acpi_add_id(pnp, ACPI_SYSTEM_HID);
1283 status = acpi_get_object_info(handle, &info);
1284 if (ACPI_FAILURE(status)) {
1285 pr_err(PREFIX "%s: Error reading device info\n",
1290 if (info->valid & ACPI_VALID_HID) {
1291 acpi_add_id(pnp, info->hardware_id.string);
1292 pnp->type.platform_id = 1;
1294 if (info->valid & ACPI_VALID_CID) {
1295 cid_list = &info->compatible_id_list;
1296 for (i = 0; i < cid_list->count; i++)
1297 acpi_add_id(pnp, cid_list->ids[i].string);
1299 if (info->valid & ACPI_VALID_ADR) {
1300 pnp->bus_address = info->address;
1301 pnp->type.bus_address = 1;
1303 if (info->valid & ACPI_VALID_UID)
1304 pnp->unique_id = kstrdup(info->unique_id.string,
1306 if (info->valid & ACPI_VALID_CLS)
1307 acpi_add_id(pnp, info->class_code.string);
1312 * Some devices don't reliably have _HIDs & _CIDs, so add
1313 * synthetic HIDs to make sure drivers can find them.
1315 if (acpi_is_video_device(handle))
1316 acpi_add_id(pnp, ACPI_VIDEO_HID);
1317 else if (acpi_bay_match(handle))
1318 acpi_add_id(pnp, ACPI_BAY_HID);
1319 else if (acpi_dock_match(handle))
1320 acpi_add_id(pnp, ACPI_DOCK_HID);
1321 else if (acpi_ibm_smbus_match(handle))
1322 acpi_add_id(pnp, ACPI_SMBUS_IBM_HID);
1323 else if (list_empty(&pnp->ids) &&
1324 acpi_object_is_system_bus(handle)) {
1325 /* \_SB, \_TZ, LNXSYBUS */
1326 acpi_add_id(pnp, ACPI_BUS_HID);
1327 strcpy(pnp->device_name, ACPI_BUS_DEVICE_NAME);
1328 strcpy(pnp->device_class, ACPI_BUS_CLASS);
1332 case ACPI_BUS_TYPE_POWER:
1333 acpi_add_id(pnp, ACPI_POWER_HID);
1335 case ACPI_BUS_TYPE_PROCESSOR:
1336 acpi_add_id(pnp, ACPI_PROCESSOR_OBJECT_HID);
1338 case ACPI_BUS_TYPE_THERMAL:
1339 acpi_add_id(pnp, ACPI_THERMAL_HID);
1341 case ACPI_BUS_TYPE_POWER_BUTTON:
1342 acpi_add_id(pnp, ACPI_BUTTON_HID_POWERF);
1344 case ACPI_BUS_TYPE_SLEEP_BUTTON:
1345 acpi_add_id(pnp, ACPI_BUTTON_HID_SLEEPF);
1347 case ACPI_BUS_TYPE_ECDT_EC:
1348 acpi_add_id(pnp, ACPI_ECDT_HID);
1353 void acpi_free_pnp_ids(struct acpi_device_pnp *pnp)
1355 struct acpi_hardware_id *id, *tmp;
1357 list_for_each_entry_safe(id, tmp, &pnp->ids, list) {
1358 kfree_const(id->id);
1361 kfree(pnp->unique_id);
1365 * acpi_dma_supported - Check DMA support for the specified device.
1366 * @adev: The pointer to acpi device
1368 * Return false if DMA is not supported. Otherwise, return true
1370 bool acpi_dma_supported(struct acpi_device *adev)
1375 if (adev->flags.cca_seen)
1379 * Per ACPI 6.0 sec 6.2.17, assume devices can do cache-coherent
1380 * DMA on "Intel platforms". Presumably that includes all x86 and
1381 * ia64, and other arches will set CONFIG_ACPI_CCA_REQUIRED=y.
1383 if (!IS_ENABLED(CONFIG_ACPI_CCA_REQUIRED))
1390 * acpi_get_dma_attr - Check the supported DMA attr for the specified device.
1391 * @adev: The pointer to acpi device
1393 * Return enum dev_dma_attr.
1395 enum dev_dma_attr acpi_get_dma_attr(struct acpi_device *adev)
1397 if (!acpi_dma_supported(adev))
1398 return DEV_DMA_NOT_SUPPORTED;
1400 if (adev->flags.coherent_dma)
1401 return DEV_DMA_COHERENT;
1403 return DEV_DMA_NON_COHERENT;
1407 * acpi_dma_get_range() - Get device DMA parameters.
1409 * @dev: device to configure
1410 * @dma_addr: pointer device DMA address result
1411 * @offset: pointer to the DMA offset result
1412 * @size: pointer to DMA range size result
1414 * Evaluate DMA regions and return respectively DMA region start, offset
1415 * and size in dma_addr, offset and size on parsing success; it does not
1416 * update the passed in values on failure.
1418 * Return 0 on success, < 0 on failure.
1420 int acpi_dma_get_range(struct device *dev, u64 *dma_addr, u64 *offset,
1423 struct acpi_device *adev;
1425 struct resource_entry *rentry;
1427 struct device *dma_dev = dev;
1428 u64 len, dma_start = U64_MAX, dma_end = 0, dma_offset = 0;
1431 * Walk the device tree chasing an ACPI companion with a _DMA
1432 * object while we go. Stop if we find a device with an ACPI
1433 * companion containing a _DMA method.
1436 adev = ACPI_COMPANION(dma_dev);
1437 if (adev && acpi_has_method(adev->handle, METHOD_NAME__DMA))
1440 dma_dev = dma_dev->parent;
1446 if (!acpi_has_method(adev->handle, METHOD_NAME__CRS)) {
1447 acpi_handle_warn(adev->handle, "_DMA is valid only if _CRS is present\n");
1451 ret = acpi_dev_get_dma_resources(adev, &list);
1453 list_for_each_entry(rentry, &list, node) {
1454 if (dma_offset && rentry->offset != dma_offset) {
1456 dev_warn(dma_dev, "Can't handle multiple windows with different offsets\n");
1459 dma_offset = rentry->offset;
1461 /* Take lower and upper limits */
1462 if (rentry->res->start < dma_start)
1463 dma_start = rentry->res->start;
1464 if (rentry->res->end > dma_end)
1465 dma_end = rentry->res->end;
1468 if (dma_start >= dma_end) {
1470 dev_dbg(dma_dev, "Invalid DMA regions configuration\n");
1474 *dma_addr = dma_start - dma_offset;
1475 len = dma_end - dma_start;
1476 *size = max(len, len + 1);
1477 *offset = dma_offset;
1480 acpi_dev_free_resource_list(&list);
1482 return ret >= 0 ? 0 : ret;
1486 * acpi_dma_configure_id - Set-up DMA configuration for the device.
1487 * @dev: The pointer to the device
1488 * @attr: device dma attributes
1489 * @input_id: input device id const value pointer
1491 int acpi_dma_configure_id(struct device *dev, enum dev_dma_attr attr,
1492 const u32 *input_id)
1494 const struct iommu_ops *iommu;
1495 u64 dma_addr = 0, size = 0;
1497 if (attr == DEV_DMA_NOT_SUPPORTED) {
1498 set_dma_ops(dev, &dma_dummy_ops);
1502 iort_dma_setup(dev, &dma_addr, &size);
1504 iommu = iort_iommu_configure_id(dev, input_id);
1505 if (PTR_ERR(iommu) == -EPROBE_DEFER)
1506 return -EPROBE_DEFER;
1508 arch_setup_dma_ops(dev, dma_addr, size,
1509 iommu, attr == DEV_DMA_COHERENT);
1513 EXPORT_SYMBOL_GPL(acpi_dma_configure_id);
1515 static void acpi_init_coherency(struct acpi_device *adev)
1517 unsigned long long cca = 0;
1519 struct acpi_device *parent = adev->parent;
1521 if (parent && parent->flags.cca_seen) {
1523 * From ACPI spec, OSPM will ignore _CCA if an ancestor
1526 adev->flags.cca_seen = 1;
1527 cca = parent->flags.coherent_dma;
1529 status = acpi_evaluate_integer(adev->handle, "_CCA",
1531 if (ACPI_SUCCESS(status))
1532 adev->flags.cca_seen = 1;
1533 else if (!IS_ENABLED(CONFIG_ACPI_CCA_REQUIRED))
1535 * If architecture does not specify that _CCA is
1536 * required for DMA-able devices (e.g. x86),
1537 * we default to _CCA=1.
1541 acpi_handle_debug(adev->handle,
1542 "ACPI device is missing _CCA.\n");
1545 adev->flags.coherent_dma = cca;
1548 static int acpi_check_serial_bus_slave(struct acpi_resource *ares, void *data)
1550 bool *is_serial_bus_slave_p = data;
1552 if (ares->type != ACPI_RESOURCE_TYPE_SERIAL_BUS)
1555 *is_serial_bus_slave_p = true;
1557 /* no need to do more checking */
1561 static bool acpi_is_indirect_io_slave(struct acpi_device *device)
1563 struct acpi_device *parent = device->parent;
1564 static const struct acpi_device_id indirect_io_hosts[] = {
1569 return parent && !acpi_match_device_ids(parent, indirect_io_hosts);
1572 static bool acpi_device_enumeration_by_parent(struct acpi_device *device)
1574 struct list_head resource_list;
1575 bool is_serial_bus_slave = false;
1576 static const struct acpi_device_id ignore_serial_bus_ids[] = {
1578 * These devices have multiple I2cSerialBus resources and an i2c-client
1579 * must be instantiated for each, each with its own i2c_device_id.
1580 * Normally we only instantiate an i2c-client for the first resource,
1581 * using the ACPI HID as id. These special cases are handled by the
1582 * drivers/platform/x86/i2c-multi-instantiate.c driver, which knows
1583 * which i2c_device_id to use for each resource.
1590 * HIDs of device with an UartSerialBusV2 resource for which userspace
1591 * expects a regular tty cdev to be created (instead of the in kernel
1592 * serdev) and which have a kernel driver which expects a platform_dev
1593 * such as the rfkill-gpio driver.
1600 if (acpi_is_indirect_io_slave(device))
1603 /* Macs use device properties in lieu of _CRS resources */
1604 if (x86_apple_machine &&
1605 (fwnode_property_present(&device->fwnode, "spiSclkPeriod") ||
1606 fwnode_property_present(&device->fwnode, "i2cAddress") ||
1607 fwnode_property_present(&device->fwnode, "baud")))
1610 if (!acpi_match_device_ids(device, ignore_serial_bus_ids))
1613 INIT_LIST_HEAD(&resource_list);
1614 acpi_dev_get_resources(device, &resource_list,
1615 acpi_check_serial_bus_slave,
1616 &is_serial_bus_slave);
1617 acpi_dev_free_resource_list(&resource_list);
1619 return is_serial_bus_slave;
1622 void acpi_init_device_object(struct acpi_device *device, acpi_handle handle,
1623 int type, unsigned long long sta)
1625 INIT_LIST_HEAD(&device->pnp.ids);
1626 device->device_type = type;
1627 device->handle = handle;
1628 device->parent = acpi_bus_get_parent(handle);
1629 device->fwnode.ops = &acpi_device_fwnode_ops;
1630 acpi_set_device_status(device, sta);
1631 acpi_device_get_busid(device);
1632 acpi_set_pnp_ids(handle, &device->pnp, type);
1633 acpi_init_properties(device);
1634 acpi_bus_get_flags(device);
1635 device->flags.match_driver = false;
1636 device->flags.initialized = true;
1637 device->flags.enumeration_by_parent =
1638 acpi_device_enumeration_by_parent(device);
1639 acpi_device_clear_enumerated(device);
1640 device_initialize(&device->dev);
1641 dev_set_uevent_suppress(&device->dev, true);
1642 acpi_init_coherency(device);
1643 /* Assume there are unmet deps until acpi_device_dep_initialize() runs */
1644 device->dep_unmet = 1;
1647 void acpi_device_add_finalize(struct acpi_device *device)
1649 dev_set_uevent_suppress(&device->dev, false);
1650 kobject_uevent(&device->dev.kobj, KOBJ_ADD);
1653 static int acpi_add_single_object(struct acpi_device **child,
1654 acpi_handle handle, int type,
1655 unsigned long long sta)
1658 struct acpi_device *device;
1659 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
1661 device = kzalloc(sizeof(struct acpi_device), GFP_KERNEL);
1663 printk(KERN_ERR PREFIX "Memory allocation error\n");
1667 acpi_init_device_object(device, handle, type, sta);
1669 * For ACPI_BUS_TYPE_DEVICE getting the status is delayed till here so
1670 * that we can call acpi_bus_get_status() and use its quirk handling.
1671 * Note this must be done before the get power-/wakeup_dev-flags calls.
1673 if (type == ACPI_BUS_TYPE_DEVICE)
1674 if (acpi_bus_get_status(device) < 0)
1675 acpi_set_device_status(device, 0);
1677 acpi_bus_get_power_flags(device);
1678 acpi_bus_get_wakeup_device_flags(device);
1680 result = acpi_device_add(device, acpi_device_release);
1682 acpi_device_release(&device->dev);
1686 acpi_power_add_remove_device(device, true);
1687 acpi_device_add_finalize(device);
1688 acpi_get_name(handle, ACPI_FULL_PATHNAME, &buffer);
1689 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Added %s [%s] parent %s\n",
1690 dev_name(&device->dev), (char *) buffer.pointer,
1691 device->parent ? dev_name(&device->parent->dev) : "(null)"));
1692 kfree(buffer.pointer);
1697 static acpi_status acpi_get_resource_memory(struct acpi_resource *ares,
1700 struct resource *res = context;
1702 if (acpi_dev_resource_memory(ares, res))
1703 return AE_CTRL_TERMINATE;
1708 static bool acpi_device_should_be_hidden(acpi_handle handle)
1711 struct resource res;
1713 /* Check if it should ignore the UART device */
1714 if (!(spcr_uart_addr && acpi_has_method(handle, METHOD_NAME__CRS)))
1718 * The UART device described in SPCR table is assumed to have only one
1719 * memory resource present. So we only look for the first one here.
1721 status = acpi_walk_resources(handle, METHOD_NAME__CRS,
1722 acpi_get_resource_memory, &res);
1723 if (ACPI_FAILURE(status) || res.start != spcr_uart_addr)
1726 acpi_handle_info(handle, "The UART device @%pa in SPCR table will be hidden\n",
1732 static int acpi_bus_type_and_status(acpi_handle handle, int *type,
1733 unsigned long long *sta)
1736 acpi_object_type acpi_type;
1738 status = acpi_get_type(handle, &acpi_type);
1739 if (ACPI_FAILURE(status))
1742 switch (acpi_type) {
1743 case ACPI_TYPE_ANY: /* for ACPI_ROOT_OBJECT */
1744 case ACPI_TYPE_DEVICE:
1745 if (acpi_device_should_be_hidden(handle))
1748 *type = ACPI_BUS_TYPE_DEVICE;
1750 * acpi_add_single_object updates this once we've an acpi_device
1751 * so that acpi_bus_get_status' quirk handling can be used.
1753 *sta = ACPI_STA_DEFAULT;
1755 case ACPI_TYPE_PROCESSOR:
1756 *type = ACPI_BUS_TYPE_PROCESSOR;
1757 status = acpi_bus_get_status_handle(handle, sta);
1758 if (ACPI_FAILURE(status))
1761 case ACPI_TYPE_THERMAL:
1762 *type = ACPI_BUS_TYPE_THERMAL;
1763 *sta = ACPI_STA_DEFAULT;
1765 case ACPI_TYPE_POWER:
1766 *type = ACPI_BUS_TYPE_POWER;
1767 *sta = ACPI_STA_DEFAULT;
1776 bool acpi_device_is_present(const struct acpi_device *adev)
1778 return adev->status.present || adev->status.functional;
1781 static bool acpi_scan_handler_matching(struct acpi_scan_handler *handler,
1783 const struct acpi_device_id **matchid)
1785 const struct acpi_device_id *devid;
1788 return handler->match(idstr, matchid);
1790 for (devid = handler->ids; devid->id[0]; devid++)
1791 if (!strcmp((char *)devid->id, idstr)) {
1801 static struct acpi_scan_handler *acpi_scan_match_handler(const char *idstr,
1802 const struct acpi_device_id **matchid)
1804 struct acpi_scan_handler *handler;
1806 list_for_each_entry(handler, &acpi_scan_handlers_list, list_node)
1807 if (acpi_scan_handler_matching(handler, idstr, matchid))
1813 void acpi_scan_hotplug_enabled(struct acpi_hotplug_profile *hotplug, bool val)
1815 if (!!hotplug->enabled == !!val)
1818 mutex_lock(&acpi_scan_lock);
1820 hotplug->enabled = val;
1822 mutex_unlock(&acpi_scan_lock);
1825 static void acpi_scan_init_hotplug(struct acpi_device *adev)
1827 struct acpi_hardware_id *hwid;
1829 if (acpi_dock_match(adev->handle) || is_ejectable_bay(adev)) {
1830 acpi_dock_add(adev);
1833 list_for_each_entry(hwid, &adev->pnp.ids, list) {
1834 struct acpi_scan_handler *handler;
1836 handler = acpi_scan_match_handler(hwid->id, NULL);
1838 adev->flags.hotplug_notify = true;
1844 static void acpi_device_dep_initialize(struct acpi_device *adev)
1846 struct acpi_dep_data *dep;
1847 struct acpi_handle_list dep_devices;
1851 adev->dep_unmet = 0;
1853 if (!acpi_has_method(adev->handle, "_DEP"))
1856 status = acpi_evaluate_reference(adev->handle, "_DEP", NULL,
1858 if (ACPI_FAILURE(status)) {
1859 dev_dbg(&adev->dev, "Failed to evaluate _DEP.\n");
1863 for (i = 0; i < dep_devices.count; i++) {
1864 struct acpi_device_info *info;
1867 status = acpi_get_object_info(dep_devices.handles[i], &info);
1868 if (ACPI_FAILURE(status)) {
1869 dev_dbg(&adev->dev, "Error reading _DEP device info\n");
1874 * Skip the dependency of Windows System Power
1875 * Management Controller
1877 skip = info->valid & ACPI_VALID_HID &&
1878 !strcmp(info->hardware_id.string, "INT3396");
1885 dep = kzalloc(sizeof(struct acpi_dep_data), GFP_KERNEL);
1889 dep->master = dep_devices.handles[i];
1890 dep->slave = adev->handle;
1893 mutex_lock(&acpi_dep_list_lock);
1894 list_add_tail(&dep->node , &acpi_dep_list);
1895 mutex_unlock(&acpi_dep_list_lock);
1899 static acpi_status acpi_bus_check_add(acpi_handle handle, u32 lvl_not_used,
1900 void *not_used, void **return_value)
1902 struct acpi_device *device = NULL;
1904 unsigned long long sta;
1907 acpi_bus_get_device(handle, &device);
1911 result = acpi_bus_type_and_status(handle, &type, &sta);
1915 if (type == ACPI_BUS_TYPE_POWER) {
1916 acpi_add_power_resource(handle);
1920 acpi_add_single_object(&device, handle, type, sta);
1922 return AE_CTRL_DEPTH;
1924 acpi_scan_init_hotplug(device);
1925 acpi_device_dep_initialize(device);
1929 *return_value = device;
1934 static void acpi_default_enumeration(struct acpi_device *device)
1937 * Do not enumerate devices with enumeration_by_parent flag set as
1938 * they will be enumerated by their respective parents.
1940 if (!device->flags.enumeration_by_parent) {
1941 acpi_create_platform_device(device, NULL);
1942 acpi_device_set_enumerated(device);
1944 blocking_notifier_call_chain(&acpi_reconfig_chain,
1945 ACPI_RECONFIG_DEVICE_ADD, device);
1949 static const struct acpi_device_id generic_device_ids[] = {
1950 {ACPI_DT_NAMESPACE_HID, },
1954 static int acpi_generic_device_attach(struct acpi_device *adev,
1955 const struct acpi_device_id *not_used)
1958 * Since ACPI_DT_NAMESPACE_HID is the only ID handled here, the test
1959 * below can be unconditional.
1961 if (adev->data.of_compatible)
1962 acpi_default_enumeration(adev);
1967 static struct acpi_scan_handler generic_device_handler = {
1968 .ids = generic_device_ids,
1969 .attach = acpi_generic_device_attach,
1972 static int acpi_scan_attach_handler(struct acpi_device *device)
1974 struct acpi_hardware_id *hwid;
1977 list_for_each_entry(hwid, &device->pnp.ids, list) {
1978 const struct acpi_device_id *devid;
1979 struct acpi_scan_handler *handler;
1981 handler = acpi_scan_match_handler(hwid->id, &devid);
1983 if (!handler->attach) {
1984 device->pnp.type.platform_id = 0;
1987 device->handler = handler;
1988 ret = handler->attach(device, devid);
1992 device->handler = NULL;
2001 static void acpi_bus_attach(struct acpi_device *device)
2003 struct acpi_device *child;
2007 if (ACPI_SUCCESS(acpi_bus_get_ejd(device->handle, &ejd)))
2008 register_dock_dependent_device(device, ejd);
2010 acpi_bus_get_status(device);
2011 /* Skip devices that are not present. */
2012 if (!acpi_device_is_present(device)) {
2013 device->flags.initialized = false;
2014 acpi_device_clear_enumerated(device);
2015 device->flags.power_manageable = 0;
2018 if (device->handler)
2021 if (!device->flags.initialized) {
2022 device->flags.power_manageable =
2023 device->power.states[ACPI_STATE_D0].flags.valid;
2024 if (acpi_bus_init_power(device))
2025 device->flags.power_manageable = 0;
2027 device->flags.initialized = true;
2028 } else if (device->flags.visited) {
2032 ret = acpi_scan_attach_handler(device);
2036 device->flags.match_driver = true;
2037 if (ret > 0 && !device->flags.enumeration_by_parent) {
2038 acpi_device_set_enumerated(device);
2042 ret = device_attach(&device->dev);
2046 if (device->pnp.type.platform_id || device->flags.enumeration_by_parent)
2047 acpi_default_enumeration(device);
2049 acpi_device_set_enumerated(device);
2052 list_for_each_entry(child, &device->children, node)
2053 acpi_bus_attach(child);
2055 if (device->handler && device->handler->hotplug.notify_online)
2056 device->handler->hotplug.notify_online(device);
2059 void acpi_walk_dep_device_list(acpi_handle handle)
2061 struct acpi_dep_data *dep, *tmp;
2062 struct acpi_device *adev;
2064 mutex_lock(&acpi_dep_list_lock);
2065 list_for_each_entry_safe(dep, tmp, &acpi_dep_list, node) {
2066 if (dep->master == handle) {
2067 acpi_bus_get_device(dep->slave, &adev);
2072 if (!adev->dep_unmet)
2073 acpi_bus_attach(adev);
2074 list_del(&dep->node);
2078 mutex_unlock(&acpi_dep_list_lock);
2080 EXPORT_SYMBOL_GPL(acpi_walk_dep_device_list);
2083 * acpi_bus_scan - Add ACPI device node objects in a given namespace scope.
2084 * @handle: Root of the namespace scope to scan.
2086 * Scan a given ACPI tree (probably recently hot-plugged) and create and add
2089 * If no devices were found, -ENODEV is returned, but it does not mean that
2090 * there has been a real error. There just have been no suitable ACPI objects
2091 * in the table trunk from which the kernel could create a device and add an
2092 * appropriate driver.
2094 * Must be called under acpi_scan_lock.
2096 int acpi_bus_scan(acpi_handle handle)
2098 void *device = NULL;
2100 if (ACPI_SUCCESS(acpi_bus_check_add(handle, 0, NULL, &device)))
2101 acpi_walk_namespace(ACPI_TYPE_ANY, handle, ACPI_UINT32_MAX,
2102 acpi_bus_check_add, NULL, NULL, &device);
2105 acpi_bus_attach(device);
2110 EXPORT_SYMBOL(acpi_bus_scan);
2113 * acpi_bus_trim - Detach scan handlers and drivers from ACPI device objects.
2114 * @adev: Root of the ACPI namespace scope to walk.
2116 * Must be called under acpi_scan_lock.
2118 void acpi_bus_trim(struct acpi_device *adev)
2120 struct acpi_scan_handler *handler = adev->handler;
2121 struct acpi_device *child;
2123 list_for_each_entry_reverse(child, &adev->children, node)
2124 acpi_bus_trim(child);
2126 adev->flags.match_driver = false;
2128 if (handler->detach)
2129 handler->detach(adev);
2131 adev->handler = NULL;
2133 device_release_driver(&adev->dev);
2136 * Most likely, the device is going away, so put it into D3cold before
2139 acpi_device_set_power(adev, ACPI_STATE_D3_COLD);
2140 adev->flags.initialized = false;
2141 acpi_device_clear_enumerated(adev);
2143 EXPORT_SYMBOL_GPL(acpi_bus_trim);
2145 int acpi_bus_register_early_device(int type)
2147 struct acpi_device *device = NULL;
2150 result = acpi_add_single_object(&device, NULL,
2151 type, ACPI_STA_DEFAULT);
2155 device->flags.match_driver = true;
2156 return device_attach(&device->dev);
2158 EXPORT_SYMBOL_GPL(acpi_bus_register_early_device);
2160 static int acpi_bus_scan_fixed(void)
2165 * Enumerate all fixed-feature devices.
2167 if (!(acpi_gbl_FADT.flags & ACPI_FADT_POWER_BUTTON)) {
2168 struct acpi_device *device = NULL;
2170 result = acpi_add_single_object(&device, NULL,
2171 ACPI_BUS_TYPE_POWER_BUTTON,
2176 device->flags.match_driver = true;
2177 result = device_attach(&device->dev);
2181 device_init_wakeup(&device->dev, true);
2184 if (!(acpi_gbl_FADT.flags & ACPI_FADT_SLEEP_BUTTON)) {
2185 struct acpi_device *device = NULL;
2187 result = acpi_add_single_object(&device, NULL,
2188 ACPI_BUS_TYPE_SLEEP_BUTTON,
2193 device->flags.match_driver = true;
2194 result = device_attach(&device->dev);
2197 return result < 0 ? result : 0;
2200 static void __init acpi_get_spcr_uart_addr(void)
2203 struct acpi_table_spcr *spcr_ptr;
2205 status = acpi_get_table(ACPI_SIG_SPCR, 0,
2206 (struct acpi_table_header **)&spcr_ptr);
2207 if (ACPI_FAILURE(status)) {
2208 pr_warn(PREFIX "STAO table present, but SPCR is missing\n");
2212 spcr_uart_addr = spcr_ptr->serial_port.address;
2213 acpi_put_table((struct acpi_table_header *)spcr_ptr);
2216 static bool acpi_scan_initialized;
2218 int __init acpi_scan_init(void)
2222 struct acpi_table_stao *stao_ptr;
2224 acpi_pci_root_init();
2225 acpi_pci_link_init();
2226 acpi_processor_init();
2227 acpi_platform_init();
2230 acpi_cmos_rtc_init();
2231 acpi_container_init();
2232 acpi_memory_hotplug_init();
2233 acpi_watchdog_init();
2235 acpi_int340x_thermal_init();
2239 acpi_scan_add_handler(&generic_device_handler);
2242 * If there is STAO table, check whether it needs to ignore the UART
2243 * device in SPCR table.
2245 status = acpi_get_table(ACPI_SIG_STAO, 0,
2246 (struct acpi_table_header **)&stao_ptr);
2247 if (ACPI_SUCCESS(status)) {
2248 if (stao_ptr->header.length > sizeof(struct acpi_table_stao))
2249 pr_info(PREFIX "STAO Name List not yet supported.\n");
2251 if (stao_ptr->ignore_uart)
2252 acpi_get_spcr_uart_addr();
2254 acpi_put_table((struct acpi_table_header *)stao_ptr);
2257 acpi_gpe_apply_masked_gpes();
2258 acpi_update_all_gpes();
2261 * Although we call __add_memory() that is documented to require the
2262 * device_hotplug_lock, it is not necessary here because this is an
2263 * early code when userspace or any other code path cannot trigger
2264 * hotplug/hotunplug operations.
2266 mutex_lock(&acpi_scan_lock);
2268 * Enumerate devices in the ACPI namespace.
2270 result = acpi_bus_scan(ACPI_ROOT_OBJECT);
2274 result = acpi_bus_get_device(ACPI_ROOT_OBJECT, &acpi_root);
2278 /* Fixed feature devices do not exist on HW-reduced platform */
2279 if (!acpi_gbl_reduced_hardware) {
2280 result = acpi_bus_scan_fixed();
2282 acpi_detach_data(acpi_root->handle,
2283 acpi_scan_drop_device);
2284 acpi_device_del(acpi_root);
2285 put_device(&acpi_root->dev);
2290 acpi_scan_initialized = true;
2293 mutex_unlock(&acpi_scan_lock);
2297 static struct acpi_probe_entry *ape;
2298 static int acpi_probe_count;
2299 static DEFINE_MUTEX(acpi_probe_mutex);
2301 static int __init acpi_match_madt(union acpi_subtable_headers *header,
2302 const unsigned long end)
2304 if (!ape->subtable_valid || ape->subtable_valid(&header->common, ape))
2305 if (!ape->probe_subtbl(header, end))
2311 int __init __acpi_probe_device_table(struct acpi_probe_entry *ap_head, int nr)
2318 mutex_lock(&acpi_probe_mutex);
2319 for (ape = ap_head; nr; ape++, nr--) {
2320 if (ACPI_COMPARE_NAMESEG(ACPI_SIG_MADT, ape->id)) {
2321 acpi_probe_count = 0;
2322 acpi_table_parse_madt(ape->type, acpi_match_madt, 0);
2323 count += acpi_probe_count;
2326 res = acpi_table_parse(ape->id, ape->probe_table);
2331 mutex_unlock(&acpi_probe_mutex);
2336 struct acpi_table_events_work {
2337 struct work_struct work;
2342 static void acpi_table_events_fn(struct work_struct *work)
2344 struct acpi_table_events_work *tew;
2346 tew = container_of(work, struct acpi_table_events_work, work);
2348 if (tew->event == ACPI_TABLE_EVENT_LOAD) {
2349 acpi_scan_lock_acquire();
2350 acpi_bus_scan(ACPI_ROOT_OBJECT);
2351 acpi_scan_lock_release();
2357 void acpi_scan_table_handler(u32 event, void *table, void *context)
2359 struct acpi_table_events_work *tew;
2361 if (!acpi_scan_initialized)
2364 if (event != ACPI_TABLE_EVENT_LOAD)
2367 tew = kmalloc(sizeof(*tew), GFP_KERNEL);
2371 INIT_WORK(&tew->work, acpi_table_events_fn);
2375 schedule_work(&tew->work);
2378 int acpi_reconfig_notifier_register(struct notifier_block *nb)
2380 return blocking_notifier_chain_register(&acpi_reconfig_chain, nb);
2382 EXPORT_SYMBOL(acpi_reconfig_notifier_register);
2384 int acpi_reconfig_notifier_unregister(struct notifier_block *nb)
2386 return blocking_notifier_chain_unregister(&acpi_reconfig_chain, nb);
2388 EXPORT_SYMBOL(acpi_reconfig_notifier_unregister);