2 * scan.c - support for transforming the ACPI namespace into individual objects
5 #include <linux/module.h>
6 #include <linux/init.h>
7 #include <linux/slab.h>
8 #include <linux/kernel.h>
9 #include <linux/acpi.h>
10 #include <linux/signal.h>
11 #include <linux/kthread.h>
12 #include <linux/dmi.h>
13 #include <linux/nls.h>
15 #include <asm/pgtable.h>
19 #define _COMPONENT ACPI_BUS_COMPONENT
20 ACPI_MODULE_NAME("scan");
21 extern struct acpi_device
*acpi_root
;
23 #define ACPI_BUS_CLASS "system_bus"
24 #define ACPI_BUS_HID "LNXSYBUS"
25 #define ACPI_BUS_DEVICE_NAME "System Bus"
27 #define ACPI_IS_ROOT_DEVICE(device) (!(device)->parent)
29 #define INVALID_ACPI_HANDLE ((acpi_handle)empty_zero_page)
32 * If set, devices will be hot-removed even if they cannot be put offline
33 * gracefully (from the kernel's standpoint).
35 bool acpi_force_hot_remove
;
37 static const char *dummy_hid
= "device";
39 static LIST_HEAD(acpi_bus_id_list
);
40 static DEFINE_MUTEX(acpi_scan_lock
);
41 static LIST_HEAD(acpi_scan_handlers_list
);
42 DEFINE_MUTEX(acpi_device_lock
);
43 LIST_HEAD(acpi_wakeup_device_list
);
44 static DEFINE_MUTEX(acpi_hp_context_lock
);
46 struct acpi_device_bus_id
{
48 unsigned int instance_no
;
49 struct list_head node
;
52 void acpi_scan_lock_acquire(void)
54 mutex_lock(&acpi_scan_lock
);
56 EXPORT_SYMBOL_GPL(acpi_scan_lock_acquire
);
58 void acpi_scan_lock_release(void)
60 mutex_unlock(&acpi_scan_lock
);
62 EXPORT_SYMBOL_GPL(acpi_scan_lock_release
);
64 void acpi_lock_hp_context(void)
66 mutex_lock(&acpi_hp_context_lock
);
69 void acpi_unlock_hp_context(void)
71 mutex_unlock(&acpi_hp_context_lock
);
74 void acpi_initialize_hp_context(struct acpi_device
*adev
,
75 struct acpi_hotplug_context
*hp
,
76 int (*notify
)(struct acpi_device
*, u32
),
77 void (*uevent
)(struct acpi_device
*, u32
))
79 acpi_lock_hp_context();
82 acpi_set_hp_context(adev
, hp
);
83 acpi_unlock_hp_context();
85 EXPORT_SYMBOL_GPL(acpi_initialize_hp_context
);
87 int acpi_scan_add_handler(struct acpi_scan_handler
*handler
)
92 list_add_tail(&handler
->list_node
, &acpi_scan_handlers_list
);
96 int acpi_scan_add_handler_with_hotplug(struct acpi_scan_handler
*handler
,
97 const char *hotplug_profile_name
)
101 error
= acpi_scan_add_handler(handler
);
105 acpi_sysfs_add_hotplug_profile(&handler
->hotplug
, hotplug_profile_name
);
110 * Creates hid/cid(s) string needed for modalias and uevent
111 * e.g. on a device with hid:IBM0001 and cid:ACPI0001 you get:
112 * char *modalias: "acpi:IBM0001:ACPI0001"
113 * Return: 0: no _HID and no _CID
114 * -EINVAL: output error
115 * -ENOMEM: output is truncated
117 static int create_modalias(struct acpi_device
*acpi_dev
, char *modalias
,
122 struct acpi_hardware_id
*id
;
124 if (list_empty(&acpi_dev
->pnp
.ids
))
127 len
= snprintf(modalias
, size
, "acpi:");
130 list_for_each_entry(id
, &acpi_dev
->pnp
.ids
, list
) {
131 count
= snprintf(&modalias
[len
], size
, "%s:", id
->id
);
140 modalias
[len
] = '\0';
145 * Creates uevent modalias field for ACPI enumerated devices.
146 * Because the other buses does not support ACPI HIDs & CIDs.
147 * e.g. for a device with hid:IBM0001 and cid:ACPI0001 you get:
148 * "acpi:IBM0001:ACPI0001"
150 int acpi_device_uevent_modalias(struct device
*dev
, struct kobj_uevent_env
*env
)
152 struct acpi_device
*acpi_dev
;
155 acpi_dev
= ACPI_COMPANION(dev
);
159 /* Fall back to bus specific way of modalias exporting */
160 if (list_empty(&acpi_dev
->pnp
.ids
))
163 if (add_uevent_var(env
, "MODALIAS="))
165 len
= create_modalias(acpi_dev
, &env
->buf
[env
->buflen
- 1],
166 sizeof(env
->buf
) - env
->buflen
);
172 EXPORT_SYMBOL_GPL(acpi_device_uevent_modalias
);
175 * Creates modalias sysfs attribute for ACPI enumerated devices.
176 * Because the other buses does not support ACPI HIDs & CIDs.
177 * e.g. for a device with hid:IBM0001 and cid:ACPI0001 you get:
178 * "acpi:IBM0001:ACPI0001"
180 int acpi_device_modalias(struct device
*dev
, char *buf
, int size
)
182 struct acpi_device
*acpi_dev
;
185 acpi_dev
= ACPI_COMPANION(dev
);
189 /* Fall back to bus specific way of modalias exporting */
190 if (list_empty(&acpi_dev
->pnp
.ids
))
193 len
= create_modalias(acpi_dev
, buf
, size
-1);
199 EXPORT_SYMBOL_GPL(acpi_device_modalias
);
202 acpi_device_modalias_show(struct device
*dev
, struct device_attribute
*attr
, char *buf
) {
203 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
206 len
= create_modalias(acpi_dev
, buf
, 1024);
212 static DEVICE_ATTR(modalias
, 0444, acpi_device_modalias_show
, NULL
);
214 bool acpi_scan_is_offline(struct acpi_device
*adev
, bool uevent
)
216 struct acpi_device_physical_node
*pn
;
219 mutex_lock(&adev
->physical_node_lock
);
221 list_for_each_entry(pn
, &adev
->physical_node_list
, node
)
222 if (device_supports_offline(pn
->dev
) && !pn
->dev
->offline
) {
224 kobject_uevent(&pn
->dev
->kobj
, KOBJ_CHANGE
);
230 mutex_unlock(&adev
->physical_node_lock
);
234 static acpi_status
acpi_bus_offline(acpi_handle handle
, u32 lvl
, void *data
,
237 struct acpi_device
*device
= NULL
;
238 struct acpi_device_physical_node
*pn
;
239 bool second_pass
= (bool)data
;
240 acpi_status status
= AE_OK
;
242 if (acpi_bus_get_device(handle
, &device
))
245 if (device
->handler
&& !device
->handler
->hotplug
.enabled
) {
246 *ret_p
= &device
->dev
;
250 mutex_lock(&device
->physical_node_lock
);
252 list_for_each_entry(pn
, &device
->physical_node_list
, node
) {
256 /* Skip devices offlined by the first pass. */
260 pn
->put_online
= false;
262 ret
= device_offline(pn
->dev
);
263 if (acpi_force_hot_remove
)
267 pn
->put_online
= !ret
;
277 mutex_unlock(&device
->physical_node_lock
);
282 static acpi_status
acpi_bus_online(acpi_handle handle
, u32 lvl
, void *data
,
285 struct acpi_device
*device
= NULL
;
286 struct acpi_device_physical_node
*pn
;
288 if (acpi_bus_get_device(handle
, &device
))
291 mutex_lock(&device
->physical_node_lock
);
293 list_for_each_entry(pn
, &device
->physical_node_list
, node
)
294 if (pn
->put_online
) {
295 device_online(pn
->dev
);
296 pn
->put_online
= false;
299 mutex_unlock(&device
->physical_node_lock
);
304 static int acpi_scan_try_to_offline(struct acpi_device
*device
)
306 acpi_handle handle
= device
->handle
;
307 struct device
*errdev
= NULL
;
311 * Carry out two passes here and ignore errors in the first pass,
312 * because if the devices in question are memory blocks and
313 * CONFIG_MEMCG is set, one of the blocks may hold data structures
314 * that the other blocks depend on, but it is not known in advance which
317 * If the first pass is successful, the second one isn't needed, though.
319 status
= acpi_walk_namespace(ACPI_TYPE_ANY
, handle
, ACPI_UINT32_MAX
,
320 NULL
, acpi_bus_offline
, (void *)false,
322 if (status
== AE_SUPPORT
) {
323 dev_warn(errdev
, "Offline disabled.\n");
324 acpi_walk_namespace(ACPI_TYPE_ANY
, handle
, ACPI_UINT32_MAX
,
325 acpi_bus_online
, NULL
, NULL
, NULL
);
328 acpi_bus_offline(handle
, 0, (void *)false, (void **)&errdev
);
331 acpi_walk_namespace(ACPI_TYPE_ANY
, handle
, ACPI_UINT32_MAX
,
332 NULL
, acpi_bus_offline
, (void *)true,
334 if (!errdev
|| acpi_force_hot_remove
)
335 acpi_bus_offline(handle
, 0, (void *)true,
338 if (errdev
&& !acpi_force_hot_remove
) {
339 dev_warn(errdev
, "Offline failed.\n");
340 acpi_bus_online(handle
, 0, NULL
, NULL
);
341 acpi_walk_namespace(ACPI_TYPE_ANY
, handle
,
342 ACPI_UINT32_MAX
, acpi_bus_online
,
350 static int acpi_scan_hot_remove(struct acpi_device
*device
)
352 acpi_handle handle
= device
->handle
;
353 unsigned long long sta
;
356 if (device
->handler
&& device
->handler
->hotplug
.demand_offline
357 && !acpi_force_hot_remove
) {
358 if (!acpi_scan_is_offline(device
, true))
361 int error
= acpi_scan_try_to_offline(device
);
366 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
367 "Hot-removing device %s...\n", dev_name(&device
->dev
)));
369 acpi_bus_trim(device
);
371 acpi_evaluate_lck(handle
, 0);
375 status
= acpi_evaluate_ej0(handle
);
376 if (status
== AE_NOT_FOUND
)
378 else if (ACPI_FAILURE(status
))
382 * Verify if eject was indeed successful. If not, log an error
383 * message. No need to call _OST since _EJ0 call was made OK.
385 status
= acpi_evaluate_integer(handle
, "_STA", NULL
, &sta
);
386 if (ACPI_FAILURE(status
)) {
387 acpi_handle_warn(handle
,
388 "Status check after eject failed (0x%x)\n", status
);
389 } else if (sta
& ACPI_STA_DEVICE_ENABLED
) {
390 acpi_handle_warn(handle
,
391 "Eject incomplete - status 0x%llx\n", sta
);
397 static int acpi_scan_device_not_present(struct acpi_device
*adev
)
399 if (!acpi_device_enumerated(adev
)) {
400 dev_warn(&adev
->dev
, "Still not present\n");
407 static int acpi_scan_device_check(struct acpi_device
*adev
)
411 acpi_bus_get_status(adev
);
412 if (adev
->status
.present
|| adev
->status
.functional
) {
414 * This function is only called for device objects for which
415 * matching scan handlers exist. The only situation in which
416 * the scan handler is not attached to this device object yet
417 * is when the device has just appeared (either it wasn't
418 * present at all before or it was removed and then added
422 dev_warn(&adev
->dev
, "Already enumerated\n");
425 error
= acpi_bus_scan(adev
->handle
);
427 dev_warn(&adev
->dev
, "Namespace scan failure\n");
430 if (!adev
->handler
) {
431 dev_warn(&adev
->dev
, "Enumeration failure\n");
435 error
= acpi_scan_device_not_present(adev
);
440 static int acpi_scan_bus_check(struct acpi_device
*adev
)
442 struct acpi_scan_handler
*handler
= adev
->handler
;
443 struct acpi_device
*child
;
446 acpi_bus_get_status(adev
);
447 if (!(adev
->status
.present
|| adev
->status
.functional
)) {
448 acpi_scan_device_not_present(adev
);
451 if (handler
&& handler
->hotplug
.scan_dependent
)
452 return handler
->hotplug
.scan_dependent(adev
);
454 error
= acpi_bus_scan(adev
->handle
);
456 dev_warn(&adev
->dev
, "Namespace scan failure\n");
459 list_for_each_entry(child
, &adev
->children
, node
) {
460 error
= acpi_scan_bus_check(child
);
467 static int acpi_generic_hotplug_event(struct acpi_device
*adev
, u32 type
)
470 case ACPI_NOTIFY_BUS_CHECK
:
471 return acpi_scan_bus_check(adev
);
472 case ACPI_NOTIFY_DEVICE_CHECK
:
473 return acpi_scan_device_check(adev
);
474 case ACPI_NOTIFY_EJECT_REQUEST
:
475 case ACPI_OST_EC_OSPM_EJECT
:
476 if (adev
->handler
&& !adev
->handler
->hotplug
.enabled
) {
477 dev_info(&adev
->dev
, "Eject disabled\n");
480 acpi_evaluate_ost(adev
->handle
, ACPI_NOTIFY_EJECT_REQUEST
,
481 ACPI_OST_SC_EJECT_IN_PROGRESS
, NULL
);
482 return acpi_scan_hot_remove(adev
);
487 void acpi_device_hotplug(struct acpi_device
*adev
, u32 src
)
489 u32 ost_code
= ACPI_OST_SC_NON_SPECIFIC_FAILURE
;
492 lock_device_hotplug();
493 mutex_lock(&acpi_scan_lock
);
496 * The device object's ACPI handle cannot become invalid as long as we
497 * are holding acpi_scan_lock, but it might have become invalid before
498 * that lock was acquired.
500 if (adev
->handle
== INVALID_ACPI_HANDLE
)
503 if (adev
->flags
.is_dock_station
) {
504 error
= dock_notify(adev
, src
);
505 } else if (adev
->flags
.hotplug_notify
) {
506 error
= acpi_generic_hotplug_event(adev
, src
);
507 if (error
== -EPERM
) {
508 ost_code
= ACPI_OST_SC_EJECT_NOT_SUPPORTED
;
512 int (*notify
)(struct acpi_device
*, u32
);
514 acpi_lock_hp_context();
515 notify
= adev
->hp
? adev
->hp
->notify
: NULL
;
516 acpi_unlock_hp_context();
518 * There may be additional notify handlers for device objects
519 * without the .event() callback, so ignore them here.
522 error
= notify(adev
, src
);
527 ost_code
= ACPI_OST_SC_SUCCESS
;
530 acpi_evaluate_ost(adev
->handle
, src
, ost_code
, NULL
);
533 acpi_bus_put_acpi_device(adev
);
534 mutex_unlock(&acpi_scan_lock
);
535 unlock_device_hotplug();
538 static ssize_t
real_power_state_show(struct device
*dev
,
539 struct device_attribute
*attr
, char *buf
)
541 struct acpi_device
*adev
= to_acpi_device(dev
);
545 ret
= acpi_device_get_power(adev
, &state
);
549 return sprintf(buf
, "%s\n", acpi_power_state_string(state
));
552 static DEVICE_ATTR(real_power_state
, 0444, real_power_state_show
, NULL
);
554 static ssize_t
power_state_show(struct device
*dev
,
555 struct device_attribute
*attr
, char *buf
)
557 struct acpi_device
*adev
= to_acpi_device(dev
);
559 return sprintf(buf
, "%s\n", acpi_power_state_string(adev
->power
.state
));
562 static DEVICE_ATTR(power_state
, 0444, power_state_show
, NULL
);
565 acpi_eject_store(struct device
*d
, struct device_attribute
*attr
,
566 const char *buf
, size_t count
)
568 struct acpi_device
*acpi_device
= to_acpi_device(d
);
569 acpi_object_type not_used
;
572 if (!count
|| buf
[0] != '1')
575 if ((!acpi_device
->handler
|| !acpi_device
->handler
->hotplug
.enabled
)
576 && !acpi_device
->driver
)
579 status
= acpi_get_type(acpi_device
->handle
, ¬_used
);
580 if (ACPI_FAILURE(status
) || !acpi_device
->flags
.ejectable
)
583 get_device(&acpi_device
->dev
);
584 status
= acpi_hotplug_schedule(acpi_device
, ACPI_OST_EC_OSPM_EJECT
);
585 if (ACPI_SUCCESS(status
))
588 put_device(&acpi_device
->dev
);
589 acpi_evaluate_ost(acpi_device
->handle
, ACPI_OST_EC_OSPM_EJECT
,
590 ACPI_OST_SC_NON_SPECIFIC_FAILURE
, NULL
);
591 return status
== AE_NO_MEMORY
? -ENOMEM
: -EAGAIN
;
594 static DEVICE_ATTR(eject
, 0200, NULL
, acpi_eject_store
);
597 acpi_device_hid_show(struct device
*dev
, struct device_attribute
*attr
, char *buf
) {
598 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
600 return sprintf(buf
, "%s\n", acpi_device_hid(acpi_dev
));
602 static DEVICE_ATTR(hid
, 0444, acpi_device_hid_show
, NULL
);
604 static ssize_t
acpi_device_uid_show(struct device
*dev
,
605 struct device_attribute
*attr
, char *buf
)
607 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
609 return sprintf(buf
, "%s\n", acpi_dev
->pnp
.unique_id
);
611 static DEVICE_ATTR(uid
, 0444, acpi_device_uid_show
, NULL
);
613 static ssize_t
acpi_device_adr_show(struct device
*dev
,
614 struct device_attribute
*attr
, char *buf
)
616 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
618 return sprintf(buf
, "0x%08x\n",
619 (unsigned int)(acpi_dev
->pnp
.bus_address
));
621 static DEVICE_ATTR(adr
, 0444, acpi_device_adr_show
, NULL
);
624 acpi_device_path_show(struct device
*dev
, struct device_attribute
*attr
, char *buf
) {
625 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
626 struct acpi_buffer path
= {ACPI_ALLOCATE_BUFFER
, NULL
};
629 result
= acpi_get_name(acpi_dev
->handle
, ACPI_FULL_PATHNAME
, &path
);
633 result
= sprintf(buf
, "%s\n", (char*)path
.pointer
);
638 static DEVICE_ATTR(path
, 0444, acpi_device_path_show
, NULL
);
640 /* sysfs file that shows description text from the ACPI _STR method */
641 static ssize_t
description_show(struct device
*dev
,
642 struct device_attribute
*attr
,
644 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
647 if (acpi_dev
->pnp
.str_obj
== NULL
)
651 * The _STR object contains a Unicode identifier for a device.
652 * We need to convert to utf-8 so it can be displayed.
654 result
= utf16s_to_utf8s(
655 (wchar_t *)acpi_dev
->pnp
.str_obj
->buffer
.pointer
,
656 acpi_dev
->pnp
.str_obj
->buffer
.length
,
657 UTF16_LITTLE_ENDIAN
, buf
,
660 buf
[result
++] = '\n';
664 static DEVICE_ATTR(description
, 0444, description_show
, NULL
);
667 acpi_device_sun_show(struct device
*dev
, struct device_attribute
*attr
,
669 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
671 return sprintf(buf
, "%lu\n", acpi_dev
->pnp
.sun
);
673 static DEVICE_ATTR(sun
, 0444, acpi_device_sun_show
, NULL
);
675 static ssize_t
status_show(struct device
*dev
, struct device_attribute
*attr
,
677 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
679 unsigned long long sta
;
681 status
= acpi_evaluate_integer(acpi_dev
->handle
, "_STA", NULL
, &sta
);
682 if (ACPI_FAILURE(status
))
685 return sprintf(buf
, "%llu\n", sta
);
687 static DEVICE_ATTR_RO(status
);
689 static int acpi_device_setup_files(struct acpi_device
*dev
)
691 struct acpi_buffer buffer
= {ACPI_ALLOCATE_BUFFER
, NULL
};
693 unsigned long long sun
;
697 * Devices gotten from FADT don't have a "path" attribute
700 result
= device_create_file(&dev
->dev
, &dev_attr_path
);
705 if (!list_empty(&dev
->pnp
.ids
)) {
706 result
= device_create_file(&dev
->dev
, &dev_attr_hid
);
710 result
= device_create_file(&dev
->dev
, &dev_attr_modalias
);
716 * If device has _STR, 'description' file is created
718 if (acpi_has_method(dev
->handle
, "_STR")) {
719 status
= acpi_evaluate_object(dev
->handle
, "_STR",
721 if (ACPI_FAILURE(status
))
722 buffer
.pointer
= NULL
;
723 dev
->pnp
.str_obj
= buffer
.pointer
;
724 result
= device_create_file(&dev
->dev
, &dev_attr_description
);
729 if (dev
->pnp
.type
.bus_address
)
730 result
= device_create_file(&dev
->dev
, &dev_attr_adr
);
731 if (dev
->pnp
.unique_id
)
732 result
= device_create_file(&dev
->dev
, &dev_attr_uid
);
734 status
= acpi_evaluate_integer(dev
->handle
, "_SUN", NULL
, &sun
);
735 if (ACPI_SUCCESS(status
)) {
736 dev
->pnp
.sun
= (unsigned long)sun
;
737 result
= device_create_file(&dev
->dev
, &dev_attr_sun
);
741 dev
->pnp
.sun
= (unsigned long)-1;
744 if (acpi_has_method(dev
->handle
, "_STA")) {
745 result
= device_create_file(&dev
->dev
, &dev_attr_status
);
751 * If device has _EJ0, 'eject' file is created that is used to trigger
752 * hot-removal function from userland.
754 if (acpi_has_method(dev
->handle
, "_EJ0")) {
755 result
= device_create_file(&dev
->dev
, &dev_attr_eject
);
760 if (dev
->flags
.power_manageable
) {
761 result
= device_create_file(&dev
->dev
, &dev_attr_power_state
);
765 if (dev
->power
.flags
.power_resources
)
766 result
= device_create_file(&dev
->dev
,
767 &dev_attr_real_power_state
);
774 static void acpi_device_remove_files(struct acpi_device
*dev
)
776 if (dev
->flags
.power_manageable
) {
777 device_remove_file(&dev
->dev
, &dev_attr_power_state
);
778 if (dev
->power
.flags
.power_resources
)
779 device_remove_file(&dev
->dev
,
780 &dev_attr_real_power_state
);
784 * If device has _STR, remove 'description' file
786 if (acpi_has_method(dev
->handle
, "_STR")) {
787 kfree(dev
->pnp
.str_obj
);
788 device_remove_file(&dev
->dev
, &dev_attr_description
);
791 * If device has _EJ0, remove 'eject' file.
793 if (acpi_has_method(dev
->handle
, "_EJ0"))
794 device_remove_file(&dev
->dev
, &dev_attr_eject
);
796 if (acpi_has_method(dev
->handle
, "_SUN"))
797 device_remove_file(&dev
->dev
, &dev_attr_sun
);
799 if (dev
->pnp
.unique_id
)
800 device_remove_file(&dev
->dev
, &dev_attr_uid
);
801 if (dev
->pnp
.type
.bus_address
)
802 device_remove_file(&dev
->dev
, &dev_attr_adr
);
803 device_remove_file(&dev
->dev
, &dev_attr_modalias
);
804 device_remove_file(&dev
->dev
, &dev_attr_hid
);
805 if (acpi_has_method(dev
->handle
, "_STA"))
806 device_remove_file(&dev
->dev
, &dev_attr_status
);
808 device_remove_file(&dev
->dev
, &dev_attr_path
);
810 /* --------------------------------------------------------------------------
812 -------------------------------------------------------------------------- */
814 static const struct acpi_device_id
*__acpi_match_device(
815 struct acpi_device
*device
, const struct acpi_device_id
*ids
)
817 const struct acpi_device_id
*id
;
818 struct acpi_hardware_id
*hwid
;
821 * If the device is not present, it is unnecessary to load device
824 if (!device
->status
.present
)
827 for (id
= ids
; id
->id
[0]; id
++)
828 list_for_each_entry(hwid
, &device
->pnp
.ids
, list
)
829 if (!strcmp((char *) id
->id
, hwid
->id
))
836 * acpi_match_device - Match a struct device against a given list of ACPI IDs
837 * @ids: Array of struct acpi_device_id object to match against.
838 * @dev: The device structure to match.
840 * Check if @dev has a valid ACPI handle and if there is a struct acpi_device
841 * object for that handle and use that object to match against a given list of
844 * Return a pointer to the first matching ID on success or %NULL on failure.
846 const struct acpi_device_id
*acpi_match_device(const struct acpi_device_id
*ids
,
847 const struct device
*dev
)
849 struct acpi_device
*adev
;
850 acpi_handle handle
= ACPI_HANDLE(dev
);
852 if (!ids
|| !handle
|| acpi_bus_get_device(handle
, &adev
))
855 return __acpi_match_device(adev
, ids
);
857 EXPORT_SYMBOL_GPL(acpi_match_device
);
859 int acpi_match_device_ids(struct acpi_device
*device
,
860 const struct acpi_device_id
*ids
)
862 return __acpi_match_device(device
, ids
) ? 0 : -ENOENT
;
864 EXPORT_SYMBOL(acpi_match_device_ids
);
866 static void acpi_free_power_resources_lists(struct acpi_device
*device
)
870 if (device
->wakeup
.flags
.valid
)
871 acpi_power_resources_list_free(&device
->wakeup
.resources
);
873 if (!device
->flags
.power_manageable
)
876 for (i
= ACPI_STATE_D0
; i
<= ACPI_STATE_D3_HOT
; i
++) {
877 struct acpi_device_power_state
*ps
= &device
->power
.states
[i
];
878 acpi_power_resources_list_free(&ps
->resources
);
882 static void acpi_device_release(struct device
*dev
)
884 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
886 acpi_free_pnp_ids(&acpi_dev
->pnp
);
887 acpi_free_power_resources_lists(acpi_dev
);
891 static int acpi_bus_match(struct device
*dev
, struct device_driver
*drv
)
893 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
894 struct acpi_driver
*acpi_drv
= to_acpi_driver(drv
);
896 return acpi_dev
->flags
.match_driver
897 && !acpi_match_device_ids(acpi_dev
, acpi_drv
->ids
);
900 static int acpi_device_uevent(struct device
*dev
, struct kobj_uevent_env
*env
)
902 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
905 if (list_empty(&acpi_dev
->pnp
.ids
))
908 if (add_uevent_var(env
, "MODALIAS="))
910 len
= create_modalias(acpi_dev
, &env
->buf
[env
->buflen
- 1],
911 sizeof(env
->buf
) - env
->buflen
);
918 static void acpi_device_notify(acpi_handle handle
, u32 event
, void *data
)
920 struct acpi_device
*device
= data
;
922 device
->driver
->ops
.notify(device
, event
);
925 static acpi_status
acpi_device_notify_fixed(void *data
)
927 struct acpi_device
*device
= data
;
929 /* Fixed hardware devices have no handles */
930 acpi_device_notify(NULL
, ACPI_FIXED_HARDWARE_EVENT
, device
);
934 static int acpi_device_install_notify_handler(struct acpi_device
*device
)
938 if (device
->device_type
== ACPI_BUS_TYPE_POWER_BUTTON
)
940 acpi_install_fixed_event_handler(ACPI_EVENT_POWER_BUTTON
,
941 acpi_device_notify_fixed
,
943 else if (device
->device_type
== ACPI_BUS_TYPE_SLEEP_BUTTON
)
945 acpi_install_fixed_event_handler(ACPI_EVENT_SLEEP_BUTTON
,
946 acpi_device_notify_fixed
,
949 status
= acpi_install_notify_handler(device
->handle
,
954 if (ACPI_FAILURE(status
))
959 static void acpi_device_remove_notify_handler(struct acpi_device
*device
)
961 if (device
->device_type
== ACPI_BUS_TYPE_POWER_BUTTON
)
962 acpi_remove_fixed_event_handler(ACPI_EVENT_POWER_BUTTON
,
963 acpi_device_notify_fixed
);
964 else if (device
->device_type
== ACPI_BUS_TYPE_SLEEP_BUTTON
)
965 acpi_remove_fixed_event_handler(ACPI_EVENT_SLEEP_BUTTON
,
966 acpi_device_notify_fixed
);
968 acpi_remove_notify_handler(device
->handle
, ACPI_DEVICE_NOTIFY
,
972 static int acpi_device_probe(struct device
*dev
)
974 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
975 struct acpi_driver
*acpi_drv
= to_acpi_driver(dev
->driver
);
978 if (acpi_dev
->handler
&& !acpi_is_pnp_device(acpi_dev
))
981 if (!acpi_drv
->ops
.add
)
984 ret
= acpi_drv
->ops
.add(acpi_dev
);
988 acpi_dev
->driver
= acpi_drv
;
989 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
990 "Driver [%s] successfully bound to device [%s]\n",
991 acpi_drv
->name
, acpi_dev
->pnp
.bus_id
));
993 if (acpi_drv
->ops
.notify
) {
994 ret
= acpi_device_install_notify_handler(acpi_dev
);
996 if (acpi_drv
->ops
.remove
)
997 acpi_drv
->ops
.remove(acpi_dev
);
999 acpi_dev
->driver
= NULL
;
1000 acpi_dev
->driver_data
= NULL
;
1005 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Found driver [%s] for device [%s]\n",
1006 acpi_drv
->name
, acpi_dev
->pnp
.bus_id
));
1011 static int acpi_device_remove(struct device
* dev
)
1013 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
1014 struct acpi_driver
*acpi_drv
= acpi_dev
->driver
;
1017 if (acpi_drv
->ops
.notify
)
1018 acpi_device_remove_notify_handler(acpi_dev
);
1019 if (acpi_drv
->ops
.remove
)
1020 acpi_drv
->ops
.remove(acpi_dev
);
1022 acpi_dev
->driver
= NULL
;
1023 acpi_dev
->driver_data
= NULL
;
1029 struct bus_type acpi_bus_type
= {
1031 .match
= acpi_bus_match
,
1032 .probe
= acpi_device_probe
,
1033 .remove
= acpi_device_remove
,
1034 .uevent
= acpi_device_uevent
,
1037 static void acpi_device_del(struct acpi_device
*device
)
1039 mutex_lock(&acpi_device_lock
);
1041 list_del(&device
->node
);
1043 list_del(&device
->wakeup_list
);
1044 mutex_unlock(&acpi_device_lock
);
1046 acpi_power_add_remove_device(device
, false);
1047 acpi_device_remove_files(device
);
1049 device
->remove(device
);
1051 device_del(&device
->dev
);
1054 static LIST_HEAD(acpi_device_del_list
);
1055 static DEFINE_MUTEX(acpi_device_del_lock
);
1057 static void acpi_device_del_work_fn(struct work_struct
*work_not_used
)
1060 struct acpi_device
*adev
;
1062 mutex_lock(&acpi_device_del_lock
);
1064 if (list_empty(&acpi_device_del_list
)) {
1065 mutex_unlock(&acpi_device_del_lock
);
1068 adev
= list_first_entry(&acpi_device_del_list
,
1069 struct acpi_device
, del_list
);
1070 list_del(&adev
->del_list
);
1072 mutex_unlock(&acpi_device_del_lock
);
1074 acpi_device_del(adev
);
1076 * Drop references to all power resources that might have been
1077 * used by the device.
1079 acpi_power_transition(adev
, ACPI_STATE_D3_COLD
);
1080 put_device(&adev
->dev
);
1085 * acpi_scan_drop_device - Drop an ACPI device object.
1086 * @handle: Handle of an ACPI namespace node, not used.
1087 * @context: Address of the ACPI device object to drop.
1089 * This is invoked by acpi_ns_delete_node() during the removal of the ACPI
1090 * namespace node the device object pointed to by @context is attached to.
1092 * The unregistration is carried out asynchronously to avoid running
1093 * acpi_device_del() under the ACPICA's namespace mutex and the list is used to
1094 * ensure the correct ordering (the device objects must be unregistered in the
1095 * same order in which the corresponding namespace nodes are deleted).
1097 static void acpi_scan_drop_device(acpi_handle handle
, void *context
)
1099 static DECLARE_WORK(work
, acpi_device_del_work_fn
);
1100 struct acpi_device
*adev
= context
;
1102 mutex_lock(&acpi_device_del_lock
);
1105 * Use the ACPI hotplug workqueue which is ordered, so this work item
1106 * won't run after any hotplug work items submitted subsequently. That
1107 * prevents attempts to register device objects identical to those being
1108 * deleted from happening concurrently (such attempts result from
1109 * hotplug events handled via the ACPI hotplug workqueue). It also will
1110 * run after all of the work items submitted previosuly, which helps
1111 * those work items to ensure that they are not accessing stale device
1114 if (list_empty(&acpi_device_del_list
))
1115 acpi_queue_hotplug_work(&work
);
1117 list_add_tail(&adev
->del_list
, &acpi_device_del_list
);
1118 /* Make acpi_ns_validate_handle() return NULL for this handle. */
1119 adev
->handle
= INVALID_ACPI_HANDLE
;
1121 mutex_unlock(&acpi_device_del_lock
);
1124 static int acpi_get_device_data(acpi_handle handle
, struct acpi_device
**device
,
1125 void (*callback
)(void *))
1132 status
= acpi_get_data_full(handle
, acpi_scan_drop_device
,
1133 (void **)device
, callback
);
1134 if (ACPI_FAILURE(status
) || !*device
) {
1135 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "No context for object [%p]\n",
1142 int acpi_bus_get_device(acpi_handle handle
, struct acpi_device
**device
)
1144 return acpi_get_device_data(handle
, device
, NULL
);
1146 EXPORT_SYMBOL(acpi_bus_get_device
);
1148 static void get_acpi_device(void *dev
)
1151 get_device(&((struct acpi_device
*)dev
)->dev
);
1154 struct acpi_device
*acpi_bus_get_acpi_device(acpi_handle handle
)
1156 struct acpi_device
*adev
= NULL
;
1158 acpi_get_device_data(handle
, &adev
, get_acpi_device
);
1162 void acpi_bus_put_acpi_device(struct acpi_device
*adev
)
1164 put_device(&adev
->dev
);
1167 int acpi_device_add(struct acpi_device
*device
,
1168 void (*release
)(struct device
*))
1171 struct acpi_device_bus_id
*acpi_device_bus_id
, *new_bus_id
;
1174 if (device
->handle
) {
1177 status
= acpi_attach_data(device
->handle
, acpi_scan_drop_device
,
1179 if (ACPI_FAILURE(status
)) {
1180 acpi_handle_err(device
->handle
,
1181 "Unable to attach device data\n");
1189 * Link this device to its parent and siblings.
1191 INIT_LIST_HEAD(&device
->children
);
1192 INIT_LIST_HEAD(&device
->node
);
1193 INIT_LIST_HEAD(&device
->wakeup_list
);
1194 INIT_LIST_HEAD(&device
->physical_node_list
);
1195 INIT_LIST_HEAD(&device
->del_list
);
1196 mutex_init(&device
->physical_node_lock
);
1198 new_bus_id
= kzalloc(sizeof(struct acpi_device_bus_id
), GFP_KERNEL
);
1200 pr_err(PREFIX
"Memory allocation error\n");
1205 mutex_lock(&acpi_device_lock
);
1207 * Find suitable bus_id and instance number in acpi_bus_id_list
1208 * If failed, create one and link it into acpi_bus_id_list
1210 list_for_each_entry(acpi_device_bus_id
, &acpi_bus_id_list
, node
) {
1211 if (!strcmp(acpi_device_bus_id
->bus_id
,
1212 acpi_device_hid(device
))) {
1213 acpi_device_bus_id
->instance_no
++;
1220 acpi_device_bus_id
= new_bus_id
;
1221 strcpy(acpi_device_bus_id
->bus_id
, acpi_device_hid(device
));
1222 acpi_device_bus_id
->instance_no
= 0;
1223 list_add_tail(&acpi_device_bus_id
->node
, &acpi_bus_id_list
);
1225 dev_set_name(&device
->dev
, "%s:%02x", acpi_device_bus_id
->bus_id
, acpi_device_bus_id
->instance_no
);
1228 list_add_tail(&device
->node
, &device
->parent
->children
);
1230 if (device
->wakeup
.flags
.valid
)
1231 list_add_tail(&device
->wakeup_list
, &acpi_wakeup_device_list
);
1232 mutex_unlock(&acpi_device_lock
);
1235 device
->dev
.parent
= &device
->parent
->dev
;
1236 device
->dev
.bus
= &acpi_bus_type
;
1237 device
->dev
.release
= release
;
1238 result
= device_add(&device
->dev
);
1240 dev_err(&device
->dev
, "Error registering device\n");
1244 result
= acpi_device_setup_files(device
);
1246 printk(KERN_ERR PREFIX
"Error creating sysfs interface for device %s\n",
1247 dev_name(&device
->dev
));
1252 mutex_lock(&acpi_device_lock
);
1254 list_del(&device
->node
);
1255 list_del(&device
->wakeup_list
);
1256 mutex_unlock(&acpi_device_lock
);
1259 acpi_detach_data(device
->handle
, acpi_scan_drop_device
);
1263 /* --------------------------------------------------------------------------
1265 -------------------------------------------------------------------------- */
1267 * acpi_bus_register_driver - register a driver with the ACPI bus
1268 * @driver: driver being registered
1270 * Registers a driver with the ACPI bus. Searches the namespace for all
1271 * devices that match the driver's criteria and binds. Returns zero for
1272 * success or a negative error status for failure.
1274 int acpi_bus_register_driver(struct acpi_driver
*driver
)
1280 driver
->drv
.name
= driver
->name
;
1281 driver
->drv
.bus
= &acpi_bus_type
;
1282 driver
->drv
.owner
= driver
->owner
;
1284 ret
= driver_register(&driver
->drv
);
1288 EXPORT_SYMBOL(acpi_bus_register_driver
);
1291 * acpi_bus_unregister_driver - unregisters a driver with the ACPI bus
1292 * @driver: driver to unregister
1294 * Unregisters a driver with the ACPI bus. Searches the namespace for all
1295 * devices that match the driver's criteria and unbinds.
1297 void acpi_bus_unregister_driver(struct acpi_driver
*driver
)
1299 driver_unregister(&driver
->drv
);
1302 EXPORT_SYMBOL(acpi_bus_unregister_driver
);
1304 /* --------------------------------------------------------------------------
1306 -------------------------------------------------------------------------- */
1307 static struct acpi_device
*acpi_bus_get_parent(acpi_handle handle
)
1309 struct acpi_device
*device
= NULL
;
1313 * Fixed hardware devices do not appear in the namespace and do not
1314 * have handles, but we fabricate acpi_devices for them, so we have
1315 * to deal with them specially.
1321 status
= acpi_get_parent(handle
, &handle
);
1322 if (ACPI_FAILURE(status
))
1323 return status
== AE_NULL_ENTRY
? NULL
: acpi_root
;
1324 } while (acpi_bus_get_device(handle
, &device
));
1329 acpi_bus_get_ejd(acpi_handle handle
, acpi_handle
*ejd
)
1333 struct acpi_buffer buffer
= {ACPI_ALLOCATE_BUFFER
, NULL
};
1334 union acpi_object
*obj
;
1336 status
= acpi_get_handle(handle
, "_EJD", &tmp
);
1337 if (ACPI_FAILURE(status
))
1340 status
= acpi_evaluate_object(handle
, "_EJD", NULL
, &buffer
);
1341 if (ACPI_SUCCESS(status
)) {
1342 obj
= buffer
.pointer
;
1343 status
= acpi_get_handle(ACPI_ROOT_OBJECT
, obj
->string
.pointer
,
1345 kfree(buffer
.pointer
);
1349 EXPORT_SYMBOL_GPL(acpi_bus_get_ejd
);
1351 static int acpi_bus_extract_wakeup_device_power_package(acpi_handle handle
,
1352 struct acpi_device_wakeup
*wakeup
)
1354 struct acpi_buffer buffer
= { ACPI_ALLOCATE_BUFFER
, NULL
};
1355 union acpi_object
*package
= NULL
;
1356 union acpi_object
*element
= NULL
;
1363 INIT_LIST_HEAD(&wakeup
->resources
);
1366 status
= acpi_evaluate_object(handle
, "_PRW", NULL
, &buffer
);
1367 if (ACPI_FAILURE(status
)) {
1368 ACPI_EXCEPTION((AE_INFO
, status
, "Evaluating _PRW"));
1372 package
= (union acpi_object
*)buffer
.pointer
;
1374 if (!package
|| package
->package
.count
< 2)
1377 element
= &(package
->package
.elements
[0]);
1381 if (element
->type
== ACPI_TYPE_PACKAGE
) {
1382 if ((element
->package
.count
< 2) ||
1383 (element
->package
.elements
[0].type
!=
1384 ACPI_TYPE_LOCAL_REFERENCE
)
1385 || (element
->package
.elements
[1].type
!= ACPI_TYPE_INTEGER
))
1388 wakeup
->gpe_device
=
1389 element
->package
.elements
[0].reference
.handle
;
1390 wakeup
->gpe_number
=
1391 (u32
) element
->package
.elements
[1].integer
.value
;
1392 } else if (element
->type
== ACPI_TYPE_INTEGER
) {
1393 wakeup
->gpe_device
= NULL
;
1394 wakeup
->gpe_number
= element
->integer
.value
;
1399 element
= &(package
->package
.elements
[1]);
1400 if (element
->type
!= ACPI_TYPE_INTEGER
)
1403 wakeup
->sleep_state
= element
->integer
.value
;
1405 err
= acpi_extract_power_resources(package
, 2, &wakeup
->resources
);
1409 if (!list_empty(&wakeup
->resources
)) {
1412 err
= acpi_power_wakeup_list_init(&wakeup
->resources
,
1415 acpi_handle_warn(handle
, "Retrieving current states "
1416 "of wakeup power resources failed\n");
1417 acpi_power_resources_list_free(&wakeup
->resources
);
1420 if (sleep_state
< wakeup
->sleep_state
) {
1421 acpi_handle_warn(handle
, "Overriding _PRW sleep state "
1422 "(S%d) by S%d from power resources\n",
1423 (int)wakeup
->sleep_state
, sleep_state
);
1424 wakeup
->sleep_state
= sleep_state
;
1429 kfree(buffer
.pointer
);
1433 static void acpi_wakeup_gpe_init(struct acpi_device
*device
)
1435 struct acpi_device_id button_device_ids
[] = {
1441 struct acpi_device_wakeup
*wakeup
= &device
->wakeup
;
1443 acpi_event_status event_status
;
1445 wakeup
->flags
.notifier_present
= 0;
1447 /* Power button, Lid switch always enable wakeup */
1448 if (!acpi_match_device_ids(device
, button_device_ids
)) {
1449 wakeup
->flags
.run_wake
= 1;
1450 if (!acpi_match_device_ids(device
, &button_device_ids
[1])) {
1451 /* Do not use Lid/sleep button for S5 wakeup */
1452 if (wakeup
->sleep_state
== ACPI_STATE_S5
)
1453 wakeup
->sleep_state
= ACPI_STATE_S4
;
1455 acpi_mark_gpe_for_wake(wakeup
->gpe_device
, wakeup
->gpe_number
);
1456 device_set_wakeup_capable(&device
->dev
, true);
1460 acpi_setup_gpe_for_wake(device
->handle
, wakeup
->gpe_device
,
1461 wakeup
->gpe_number
);
1462 status
= acpi_get_gpe_status(wakeup
->gpe_device
, wakeup
->gpe_number
,
1464 if (ACPI_FAILURE(status
))
1467 wakeup
->flags
.run_wake
= !!(event_status
& ACPI_EVENT_FLAG_HANDLE
);
1470 static void acpi_bus_get_wakeup_device_flags(struct acpi_device
*device
)
1474 /* Presence of _PRW indicates wake capable */
1475 if (!acpi_has_method(device
->handle
, "_PRW"))
1478 err
= acpi_bus_extract_wakeup_device_power_package(device
->handle
,
1481 dev_err(&device
->dev
, "_PRW evaluation error: %d\n", err
);
1485 device
->wakeup
.flags
.valid
= 1;
1486 device
->wakeup
.prepare_count
= 0;
1487 acpi_wakeup_gpe_init(device
);
1488 /* Call _PSW/_DSW object to disable its ability to wake the sleeping
1489 * system for the ACPI device with the _PRW object.
1490 * The _PSW object is depreciated in ACPI 3.0 and is replaced by _DSW.
1491 * So it is necessary to call _DSW object first. Only when it is not
1492 * present will the _PSW object used.
1494 err
= acpi_device_sleep_wake(device
, 0, 0, 0);
1496 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
1497 "error in _DSW or _PSW evaluation\n"));
1500 static void acpi_bus_init_power_state(struct acpi_device
*device
, int state
)
1502 struct acpi_device_power_state
*ps
= &device
->power
.states
[state
];
1503 char pathname
[5] = { '_', 'P', 'R', '0' + state
, '\0' };
1504 struct acpi_buffer buffer
= { ACPI_ALLOCATE_BUFFER
, NULL
};
1507 INIT_LIST_HEAD(&ps
->resources
);
1509 /* Evaluate "_PRx" to get referenced power resources */
1510 status
= acpi_evaluate_object(device
->handle
, pathname
, NULL
, &buffer
);
1511 if (ACPI_SUCCESS(status
)) {
1512 union acpi_object
*package
= buffer
.pointer
;
1514 if (buffer
.length
&& package
1515 && package
->type
== ACPI_TYPE_PACKAGE
1516 && package
->package
.count
) {
1517 int err
= acpi_extract_power_resources(package
, 0,
1520 device
->power
.flags
.power_resources
= 1;
1522 ACPI_FREE(buffer
.pointer
);
1525 /* Evaluate "_PSx" to see if we can do explicit sets */
1527 if (acpi_has_method(device
->handle
, pathname
))
1528 ps
->flags
.explicit_set
= 1;
1531 * State is valid if there are means to put the device into it.
1532 * D3hot is only valid if _PR3 present.
1534 if (!list_empty(&ps
->resources
)
1535 || (ps
->flags
.explicit_set
&& state
< ACPI_STATE_D3_HOT
)) {
1536 ps
->flags
.valid
= 1;
1537 ps
->flags
.os_accessible
= 1;
1540 ps
->power
= -1; /* Unknown - driver assigned */
1541 ps
->latency
= -1; /* Unknown - driver assigned */
1544 static void acpi_bus_get_power_flags(struct acpi_device
*device
)
1548 /* Presence of _PS0|_PR0 indicates 'power manageable' */
1549 if (!acpi_has_method(device
->handle
, "_PS0") &&
1550 !acpi_has_method(device
->handle
, "_PR0"))
1553 device
->flags
.power_manageable
= 1;
1556 * Power Management Flags
1558 if (acpi_has_method(device
->handle
, "_PSC"))
1559 device
->power
.flags
.explicit_get
= 1;
1561 if (acpi_has_method(device
->handle
, "_IRC"))
1562 device
->power
.flags
.inrush_current
= 1;
1564 if (acpi_has_method(device
->handle
, "_DSW"))
1565 device
->power
.flags
.dsw_present
= 1;
1568 * Enumerate supported power management states
1570 for (i
= ACPI_STATE_D0
; i
<= ACPI_STATE_D3_HOT
; i
++)
1571 acpi_bus_init_power_state(device
, i
);
1573 INIT_LIST_HEAD(&device
->power
.states
[ACPI_STATE_D3_COLD
].resources
);
1575 /* Set defaults for D0 and D3 states (always valid) */
1576 device
->power
.states
[ACPI_STATE_D0
].flags
.valid
= 1;
1577 device
->power
.states
[ACPI_STATE_D0
].power
= 100;
1578 device
->power
.states
[ACPI_STATE_D3_COLD
].flags
.valid
= 1;
1579 device
->power
.states
[ACPI_STATE_D3_COLD
].power
= 0;
1581 /* Set D3cold's explicit_set flag if _PS3 exists. */
1582 if (device
->power
.states
[ACPI_STATE_D3_HOT
].flags
.explicit_set
)
1583 device
->power
.states
[ACPI_STATE_D3_COLD
].flags
.explicit_set
= 1;
1585 /* Presence of _PS3 or _PRx means we can put the device into D3 cold */
1586 if (device
->power
.states
[ACPI_STATE_D3_HOT
].flags
.explicit_set
||
1587 device
->power
.flags
.power_resources
)
1588 device
->power
.states
[ACPI_STATE_D3_COLD
].flags
.os_accessible
= 1;
1590 if (acpi_bus_init_power(device
)) {
1591 acpi_free_power_resources_lists(device
);
1592 device
->flags
.power_manageable
= 0;
1596 static void acpi_bus_get_flags(struct acpi_device
*device
)
1598 /* Presence of _STA indicates 'dynamic_status' */
1599 if (acpi_has_method(device
->handle
, "_STA"))
1600 device
->flags
.dynamic_status
= 1;
1602 /* Presence of _RMV indicates 'removable' */
1603 if (acpi_has_method(device
->handle
, "_RMV"))
1604 device
->flags
.removable
= 1;
1606 /* Presence of _EJD|_EJ0 indicates 'ejectable' */
1607 if (acpi_has_method(device
->handle
, "_EJD") ||
1608 acpi_has_method(device
->handle
, "_EJ0"))
1609 device
->flags
.ejectable
= 1;
1612 static void acpi_device_get_busid(struct acpi_device
*device
)
1614 char bus_id
[5] = { '?', 0 };
1615 struct acpi_buffer buffer
= { sizeof(bus_id
), bus_id
};
1621 * The device's Bus ID is simply the object name.
1622 * TBD: Shouldn't this value be unique (within the ACPI namespace)?
1624 if (ACPI_IS_ROOT_DEVICE(device
)) {
1625 strcpy(device
->pnp
.bus_id
, "ACPI");
1629 switch (device
->device_type
) {
1630 case ACPI_BUS_TYPE_POWER_BUTTON
:
1631 strcpy(device
->pnp
.bus_id
, "PWRF");
1633 case ACPI_BUS_TYPE_SLEEP_BUTTON
:
1634 strcpy(device
->pnp
.bus_id
, "SLPF");
1637 acpi_get_name(device
->handle
, ACPI_SINGLE_NAME
, &buffer
);
1638 /* Clean up trailing underscores (if any) */
1639 for (i
= 3; i
> 1; i
--) {
1640 if (bus_id
[i
] == '_')
1645 strcpy(device
->pnp
.bus_id
, bus_id
);
1651 * acpi_ata_match - see if an acpi object is an ATA device
1653 * If an acpi object has one of the ACPI ATA methods defined,
1654 * then we can safely call it an ATA device.
1656 bool acpi_ata_match(acpi_handle handle
)
1658 return acpi_has_method(handle
, "_GTF") ||
1659 acpi_has_method(handle
, "_GTM") ||
1660 acpi_has_method(handle
, "_STM") ||
1661 acpi_has_method(handle
, "_SDD");
1665 * acpi_bay_match - see if an acpi object is an ejectable driver bay
1667 * If an acpi object is ejectable and has one of the ACPI ATA methods defined,
1668 * then we can safely call it an ejectable drive bay
1670 bool acpi_bay_match(acpi_handle handle
)
1672 acpi_handle phandle
;
1674 if (!acpi_has_method(handle
, "_EJ0"))
1676 if (acpi_ata_match(handle
))
1678 if (ACPI_FAILURE(acpi_get_parent(handle
, &phandle
)))
1681 return acpi_ata_match(phandle
);
1684 bool acpi_device_is_battery(struct acpi_device
*adev
)
1686 struct acpi_hardware_id
*hwid
;
1688 list_for_each_entry(hwid
, &adev
->pnp
.ids
, list
)
1689 if (!strcmp("PNP0C0A", hwid
->id
))
1695 static bool is_ejectable_bay(struct acpi_device
*adev
)
1697 acpi_handle handle
= adev
->handle
;
1699 if (acpi_has_method(handle
, "_EJ0") && acpi_device_is_battery(adev
))
1702 return acpi_bay_match(handle
);
1706 * acpi_dock_match - see if an acpi object has a _DCK method
1708 bool acpi_dock_match(acpi_handle handle
)
1710 return acpi_has_method(handle
, "_DCK");
1713 const char *acpi_device_hid(struct acpi_device
*device
)
1715 struct acpi_hardware_id
*hid
;
1717 if (list_empty(&device
->pnp
.ids
))
1720 hid
= list_first_entry(&device
->pnp
.ids
, struct acpi_hardware_id
, list
);
1723 EXPORT_SYMBOL(acpi_device_hid
);
1725 static void acpi_add_id(struct acpi_device_pnp
*pnp
, const char *dev_id
)
1727 struct acpi_hardware_id
*id
;
1729 id
= kmalloc(sizeof(*id
), GFP_KERNEL
);
1733 id
->id
= kstrdup(dev_id
, GFP_KERNEL
);
1739 list_add_tail(&id
->list
, &pnp
->ids
);
1740 pnp
->type
.hardware_id
= 1;
1744 * Old IBM workstations have a DSDT bug wherein the SMBus object
1745 * lacks the SMBUS01 HID and the methods do not have the necessary "_"
1746 * prefix. Work around this.
1748 static bool acpi_ibm_smbus_match(acpi_handle handle
)
1750 char node_name
[ACPI_PATH_SEGMENT_LENGTH
];
1751 struct acpi_buffer path
= { sizeof(node_name
), node_name
};
1753 if (!dmi_name_in_vendors("IBM"))
1756 /* Look for SMBS object */
1757 if (ACPI_FAILURE(acpi_get_name(handle
, ACPI_SINGLE_NAME
, &path
)) ||
1758 strcmp("SMBS", path
.pointer
))
1761 /* Does it have the necessary (but misnamed) methods? */
1762 if (acpi_has_method(handle
, "SBI") &&
1763 acpi_has_method(handle
, "SBR") &&
1764 acpi_has_method(handle
, "SBW"))
1770 static bool acpi_object_is_system_bus(acpi_handle handle
)
1774 if (ACPI_SUCCESS(acpi_get_handle(NULL
, "\\_SB", &tmp
)) &&
1777 if (ACPI_SUCCESS(acpi_get_handle(NULL
, "\\_TZ", &tmp
)) &&
1784 static void acpi_set_pnp_ids(acpi_handle handle
, struct acpi_device_pnp
*pnp
,
1788 struct acpi_device_info
*info
;
1789 struct acpi_pnp_device_id_list
*cid_list
;
1792 switch (device_type
) {
1793 case ACPI_BUS_TYPE_DEVICE
:
1794 if (handle
== ACPI_ROOT_OBJECT
) {
1795 acpi_add_id(pnp
, ACPI_SYSTEM_HID
);
1799 status
= acpi_get_object_info(handle
, &info
);
1800 if (ACPI_FAILURE(status
)) {
1801 pr_err(PREFIX
"%s: Error reading device info\n",
1806 if (info
->valid
& ACPI_VALID_HID
) {
1807 acpi_add_id(pnp
, info
->hardware_id
.string
);
1808 pnp
->type
.platform_id
= 1;
1810 if (info
->valid
& ACPI_VALID_CID
) {
1811 cid_list
= &info
->compatible_id_list
;
1812 for (i
= 0; i
< cid_list
->count
; i
++)
1813 acpi_add_id(pnp
, cid_list
->ids
[i
].string
);
1815 if (info
->valid
& ACPI_VALID_ADR
) {
1816 pnp
->bus_address
= info
->address
;
1817 pnp
->type
.bus_address
= 1;
1819 if (info
->valid
& ACPI_VALID_UID
)
1820 pnp
->unique_id
= kstrdup(info
->unique_id
.string
,
1826 * Some devices don't reliably have _HIDs & _CIDs, so add
1827 * synthetic HIDs to make sure drivers can find them.
1829 if (acpi_is_video_device(handle
))
1830 acpi_add_id(pnp
, ACPI_VIDEO_HID
);
1831 else if (acpi_bay_match(handle
))
1832 acpi_add_id(pnp
, ACPI_BAY_HID
);
1833 else if (acpi_dock_match(handle
))
1834 acpi_add_id(pnp
, ACPI_DOCK_HID
);
1835 else if (acpi_ibm_smbus_match(handle
))
1836 acpi_add_id(pnp
, ACPI_SMBUS_IBM_HID
);
1837 else if (list_empty(&pnp
->ids
) &&
1838 acpi_object_is_system_bus(handle
)) {
1839 /* \_SB, \_TZ, LNXSYBUS */
1840 acpi_add_id(pnp
, ACPI_BUS_HID
);
1841 strcpy(pnp
->device_name
, ACPI_BUS_DEVICE_NAME
);
1842 strcpy(pnp
->device_class
, ACPI_BUS_CLASS
);
1846 case ACPI_BUS_TYPE_POWER
:
1847 acpi_add_id(pnp
, ACPI_POWER_HID
);
1849 case ACPI_BUS_TYPE_PROCESSOR
:
1850 acpi_add_id(pnp
, ACPI_PROCESSOR_OBJECT_HID
);
1852 case ACPI_BUS_TYPE_THERMAL
:
1853 acpi_add_id(pnp
, ACPI_THERMAL_HID
);
1855 case ACPI_BUS_TYPE_POWER_BUTTON
:
1856 acpi_add_id(pnp
, ACPI_BUTTON_HID_POWERF
);
1858 case ACPI_BUS_TYPE_SLEEP_BUTTON
:
1859 acpi_add_id(pnp
, ACPI_BUTTON_HID_SLEEPF
);
1864 void acpi_free_pnp_ids(struct acpi_device_pnp
*pnp
)
1866 struct acpi_hardware_id
*id
, *tmp
;
1868 list_for_each_entry_safe(id
, tmp
, &pnp
->ids
, list
) {
1872 kfree(pnp
->unique_id
);
1875 void acpi_init_device_object(struct acpi_device
*device
, acpi_handle handle
,
1876 int type
, unsigned long long sta
)
1878 INIT_LIST_HEAD(&device
->pnp
.ids
);
1879 device
->device_type
= type
;
1880 device
->handle
= handle
;
1881 device
->parent
= acpi_bus_get_parent(handle
);
1882 acpi_set_device_status(device
, sta
);
1883 acpi_device_get_busid(device
);
1884 acpi_set_pnp_ids(handle
, &device
->pnp
, type
);
1885 acpi_bus_get_flags(device
);
1886 device
->flags
.match_driver
= false;
1887 device
->flags
.initialized
= true;
1888 device
->flags
.visited
= false;
1889 device_initialize(&device
->dev
);
1890 dev_set_uevent_suppress(&device
->dev
, true);
1893 void acpi_device_add_finalize(struct acpi_device
*device
)
1895 dev_set_uevent_suppress(&device
->dev
, false);
1896 kobject_uevent(&device
->dev
.kobj
, KOBJ_ADD
);
1899 static int acpi_add_single_object(struct acpi_device
**child
,
1900 acpi_handle handle
, int type
,
1901 unsigned long long sta
)
1904 struct acpi_device
*device
;
1905 struct acpi_buffer buffer
= { ACPI_ALLOCATE_BUFFER
, NULL
};
1907 device
= kzalloc(sizeof(struct acpi_device
), GFP_KERNEL
);
1909 printk(KERN_ERR PREFIX
"Memory allocation error\n");
1913 acpi_init_device_object(device
, handle
, type
, sta
);
1914 acpi_bus_get_power_flags(device
);
1915 acpi_bus_get_wakeup_device_flags(device
);
1917 result
= acpi_device_add(device
, acpi_device_release
);
1919 acpi_device_release(&device
->dev
);
1923 acpi_power_add_remove_device(device
, true);
1924 acpi_device_add_finalize(device
);
1925 acpi_get_name(handle
, ACPI_FULL_PATHNAME
, &buffer
);
1926 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Added %s [%s] parent %s\n",
1927 dev_name(&device
->dev
), (char *) buffer
.pointer
,
1928 device
->parent
? dev_name(&device
->parent
->dev
) : "(null)"));
1929 kfree(buffer
.pointer
);
1934 static int acpi_bus_type_and_status(acpi_handle handle
, int *type
,
1935 unsigned long long *sta
)
1938 acpi_object_type acpi_type
;
1940 status
= acpi_get_type(handle
, &acpi_type
);
1941 if (ACPI_FAILURE(status
))
1944 switch (acpi_type
) {
1945 case ACPI_TYPE_ANY
: /* for ACPI_ROOT_OBJECT */
1946 case ACPI_TYPE_DEVICE
:
1947 *type
= ACPI_BUS_TYPE_DEVICE
;
1948 status
= acpi_bus_get_status_handle(handle
, sta
);
1949 if (ACPI_FAILURE(status
))
1952 case ACPI_TYPE_PROCESSOR
:
1953 *type
= ACPI_BUS_TYPE_PROCESSOR
;
1954 status
= acpi_bus_get_status_handle(handle
, sta
);
1955 if (ACPI_FAILURE(status
))
1958 case ACPI_TYPE_THERMAL
:
1959 *type
= ACPI_BUS_TYPE_THERMAL
;
1960 *sta
= ACPI_STA_DEFAULT
;
1962 case ACPI_TYPE_POWER
:
1963 *type
= ACPI_BUS_TYPE_POWER
;
1964 *sta
= ACPI_STA_DEFAULT
;
1973 bool acpi_device_is_present(struct acpi_device
*adev
)
1975 if (adev
->status
.present
|| adev
->status
.functional
)
1978 adev
->flags
.initialized
= false;
1982 static bool acpi_scan_handler_matching(struct acpi_scan_handler
*handler
,
1984 const struct acpi_device_id
**matchid
)
1986 const struct acpi_device_id
*devid
;
1989 return handler
->match(idstr
, matchid
);
1991 for (devid
= handler
->ids
; devid
->id
[0]; devid
++)
1992 if (!strcmp((char *)devid
->id
, idstr
)) {
2002 static struct acpi_scan_handler
*acpi_scan_match_handler(char *idstr
,
2003 const struct acpi_device_id
**matchid
)
2005 struct acpi_scan_handler
*handler
;
2007 list_for_each_entry(handler
, &acpi_scan_handlers_list
, list_node
)
2008 if (acpi_scan_handler_matching(handler
, idstr
, matchid
))
2014 void acpi_scan_hotplug_enabled(struct acpi_hotplug_profile
*hotplug
, bool val
)
2016 if (!!hotplug
->enabled
== !!val
)
2019 mutex_lock(&acpi_scan_lock
);
2021 hotplug
->enabled
= val
;
2023 mutex_unlock(&acpi_scan_lock
);
2026 static void acpi_scan_init_hotplug(struct acpi_device
*adev
)
2028 struct acpi_hardware_id
*hwid
;
2030 if (acpi_dock_match(adev
->handle
) || is_ejectable_bay(adev
)) {
2031 acpi_dock_add(adev
);
2034 list_for_each_entry(hwid
, &adev
->pnp
.ids
, list
) {
2035 struct acpi_scan_handler
*handler
;
2037 handler
= acpi_scan_match_handler(hwid
->id
, NULL
);
2039 adev
->flags
.hotplug_notify
= true;
2045 static acpi_status
acpi_bus_check_add(acpi_handle handle
, u32 lvl_not_used
,
2046 void *not_used
, void **return_value
)
2048 struct acpi_device
*device
= NULL
;
2050 unsigned long long sta
;
2053 acpi_bus_get_device(handle
, &device
);
2057 result
= acpi_bus_type_and_status(handle
, &type
, &sta
);
2061 if (type
== ACPI_BUS_TYPE_POWER
) {
2062 acpi_add_power_resource(handle
);
2066 acpi_add_single_object(&device
, handle
, type
, sta
);
2068 return AE_CTRL_DEPTH
;
2070 acpi_scan_init_hotplug(device
);
2074 *return_value
= device
;
2079 static int acpi_check_spi_i2c_slave(struct acpi_resource
*ares
, void *data
)
2081 bool *is_spi_i2c_slave_p
= data
;
2083 if (ares
->type
!= ACPI_RESOURCE_TYPE_SERIAL_BUS
)
2087 * devices that are connected to UART still need to be enumerated to
2090 if (ares
->data
.common_serial_bus
.type
!= ACPI_RESOURCE_SERIAL_TYPE_UART
)
2091 *is_spi_i2c_slave_p
= true;
2093 /* no need to do more checking */
2097 static void acpi_default_enumeration(struct acpi_device
*device
)
2099 struct list_head resource_list
;
2100 bool is_spi_i2c_slave
= false;
2102 if (!device
->pnp
.type
.platform_id
|| device
->handler
)
2106 * Do not enemerate SPI/I2C slaves as they will be enuerated by their
2107 * respective parents.
2109 INIT_LIST_HEAD(&resource_list
);
2110 acpi_dev_get_resources(device
, &resource_list
, acpi_check_spi_i2c_slave
,
2112 acpi_dev_free_resource_list(&resource_list
);
2113 if (!is_spi_i2c_slave
)
2114 acpi_create_platform_device(device
);
2117 static int acpi_scan_attach_handler(struct acpi_device
*device
)
2119 struct acpi_hardware_id
*hwid
;
2122 list_for_each_entry(hwid
, &device
->pnp
.ids
, list
) {
2123 const struct acpi_device_id
*devid
;
2124 struct acpi_scan_handler
*handler
;
2126 handler
= acpi_scan_match_handler(hwid
->id
, &devid
);
2128 if (!handler
->attach
) {
2129 device
->pnp
.type
.platform_id
= 0;
2132 device
->handler
= handler
;
2133 ret
= handler
->attach(device
, devid
);
2137 device
->handler
= NULL
;
2143 acpi_default_enumeration(device
);
2148 static void acpi_bus_attach(struct acpi_device
*device
)
2150 struct acpi_device
*child
;
2154 if (ACPI_SUCCESS(acpi_bus_get_ejd(device
->handle
, &ejd
)))
2155 register_dock_dependent_device(device
, ejd
);
2157 acpi_bus_get_status(device
);
2158 /* Skip devices that are not present. */
2159 if (!acpi_device_is_present(device
)) {
2160 device
->flags
.visited
= false;
2163 if (device
->handler
)
2166 if (!device
->flags
.initialized
) {
2167 acpi_bus_update_power(device
, NULL
);
2168 device
->flags
.initialized
= true;
2170 device
->flags
.visited
= false;
2171 ret
= acpi_scan_attach_handler(device
);
2175 device
->flags
.match_driver
= true;
2177 ret
= device_attach(&device
->dev
);
2181 device
->flags
.visited
= true;
2184 list_for_each_entry(child
, &device
->children
, node
)
2185 acpi_bus_attach(child
);
2189 * acpi_bus_scan - Add ACPI device node objects in a given namespace scope.
2190 * @handle: Root of the namespace scope to scan.
2192 * Scan a given ACPI tree (probably recently hot-plugged) and create and add
2195 * If no devices were found, -ENODEV is returned, but it does not mean that
2196 * there has been a real error. There just have been no suitable ACPI objects
2197 * in the table trunk from which the kernel could create a device and add an
2198 * appropriate driver.
2200 * Must be called under acpi_scan_lock.
2202 int acpi_bus_scan(acpi_handle handle
)
2204 void *device
= NULL
;
2206 if (ACPI_SUCCESS(acpi_bus_check_add(handle
, 0, NULL
, &device
)))
2207 acpi_walk_namespace(ACPI_TYPE_ANY
, handle
, ACPI_UINT32_MAX
,
2208 acpi_bus_check_add
, NULL
, NULL
, &device
);
2211 acpi_bus_attach(device
);
2216 EXPORT_SYMBOL(acpi_bus_scan
);
2219 * acpi_bus_trim - Detach scan handlers and drivers from ACPI device objects.
2220 * @adev: Root of the ACPI namespace scope to walk.
2222 * Must be called under acpi_scan_lock.
2224 void acpi_bus_trim(struct acpi_device
*adev
)
2226 struct acpi_scan_handler
*handler
= adev
->handler
;
2227 struct acpi_device
*child
;
2229 list_for_each_entry_reverse(child
, &adev
->children
, node
)
2230 acpi_bus_trim(child
);
2232 adev
->flags
.match_driver
= false;
2234 if (handler
->detach
)
2235 handler
->detach(adev
);
2237 adev
->handler
= NULL
;
2239 device_release_driver(&adev
->dev
);
2242 * Most likely, the device is going away, so put it into D3cold before
2245 acpi_device_set_power(adev
, ACPI_STATE_D3_COLD
);
2246 adev
->flags
.initialized
= false;
2247 adev
->flags
.visited
= false;
2249 EXPORT_SYMBOL_GPL(acpi_bus_trim
);
2251 static int acpi_bus_scan_fixed(void)
2256 * Enumerate all fixed-feature devices.
2258 if (!(acpi_gbl_FADT
.flags
& ACPI_FADT_POWER_BUTTON
)) {
2259 struct acpi_device
*device
= NULL
;
2261 result
= acpi_add_single_object(&device
, NULL
,
2262 ACPI_BUS_TYPE_POWER_BUTTON
,
2267 device
->flags
.match_driver
= true;
2268 result
= device_attach(&device
->dev
);
2272 device_init_wakeup(&device
->dev
, true);
2275 if (!(acpi_gbl_FADT
.flags
& ACPI_FADT_SLEEP_BUTTON
)) {
2276 struct acpi_device
*device
= NULL
;
2278 result
= acpi_add_single_object(&device
, NULL
,
2279 ACPI_BUS_TYPE_SLEEP_BUTTON
,
2284 device
->flags
.match_driver
= true;
2285 result
= device_attach(&device
->dev
);
2288 return result
< 0 ? result
: 0;
2291 int __init
acpi_scan_init(void)
2295 result
= bus_register(&acpi_bus_type
);
2297 /* We don't want to quit even if we failed to add suspend/resume */
2298 printk(KERN_ERR PREFIX
"Could not register bus type\n");
2301 acpi_pci_root_init();
2302 acpi_pci_link_init();
2303 acpi_processor_init();
2305 acpi_cmos_rtc_init();
2306 acpi_container_init();
2307 acpi_memory_hotplug_init();
2310 mutex_lock(&acpi_scan_lock
);
2312 * Enumerate devices in the ACPI namespace.
2314 result
= acpi_bus_scan(ACPI_ROOT_OBJECT
);
2318 result
= acpi_bus_get_device(ACPI_ROOT_OBJECT
, &acpi_root
);
2322 /* Fixed feature devices do not exist on HW-reduced platform */
2323 if (!acpi_gbl_reduced_hardware
) {
2324 result
= acpi_bus_scan_fixed();
2326 acpi_detach_data(acpi_root
->handle
,
2327 acpi_scan_drop_device
);
2328 acpi_device_del(acpi_root
);
2329 put_device(&acpi_root
->dev
);
2334 acpi_update_all_gpes();
2337 mutex_unlock(&acpi_scan_lock
);