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 unsigned long long sun
;
673 status
= acpi_evaluate_integer(acpi_dev
->handle
, "_SUN", NULL
, &sun
);
674 if (ACPI_FAILURE(status
))
677 return sprintf(buf
, "%llu\n", sun
);
679 static DEVICE_ATTR(sun
, 0444, acpi_device_sun_show
, NULL
);
681 static ssize_t
status_show(struct device
*dev
, struct device_attribute
*attr
,
683 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
685 unsigned long long sta
;
687 status
= acpi_evaluate_integer(acpi_dev
->handle
, "_STA", NULL
, &sta
);
688 if (ACPI_FAILURE(status
))
691 return sprintf(buf
, "%llu\n", sta
);
693 static DEVICE_ATTR_RO(status
);
695 static int acpi_device_setup_files(struct acpi_device
*dev
)
697 struct acpi_buffer buffer
= {ACPI_ALLOCATE_BUFFER
, NULL
};
702 * Devices gotten from FADT don't have a "path" attribute
705 result
= device_create_file(&dev
->dev
, &dev_attr_path
);
710 if (!list_empty(&dev
->pnp
.ids
)) {
711 result
= device_create_file(&dev
->dev
, &dev_attr_hid
);
715 result
= device_create_file(&dev
->dev
, &dev_attr_modalias
);
721 * If device has _STR, 'description' file is created
723 if (acpi_has_method(dev
->handle
, "_STR")) {
724 status
= acpi_evaluate_object(dev
->handle
, "_STR",
726 if (ACPI_FAILURE(status
))
727 buffer
.pointer
= NULL
;
728 dev
->pnp
.str_obj
= buffer
.pointer
;
729 result
= device_create_file(&dev
->dev
, &dev_attr_description
);
734 if (dev
->pnp
.type
.bus_address
)
735 result
= device_create_file(&dev
->dev
, &dev_attr_adr
);
736 if (dev
->pnp
.unique_id
)
737 result
= device_create_file(&dev
->dev
, &dev_attr_uid
);
739 if (acpi_has_method(dev
->handle
, "_SUN")) {
740 result
= device_create_file(&dev
->dev
, &dev_attr_sun
);
745 if (acpi_has_method(dev
->handle
, "_STA")) {
746 result
= device_create_file(&dev
->dev
, &dev_attr_status
);
752 * If device has _EJ0, 'eject' file is created that is used to trigger
753 * hot-removal function from userland.
755 if (acpi_has_method(dev
->handle
, "_EJ0")) {
756 result
= device_create_file(&dev
->dev
, &dev_attr_eject
);
761 if (dev
->flags
.power_manageable
) {
762 result
= device_create_file(&dev
->dev
, &dev_attr_power_state
);
766 if (dev
->power
.flags
.power_resources
)
767 result
= device_create_file(&dev
->dev
,
768 &dev_attr_real_power_state
);
775 static void acpi_device_remove_files(struct acpi_device
*dev
)
777 if (dev
->flags
.power_manageable
) {
778 device_remove_file(&dev
->dev
, &dev_attr_power_state
);
779 if (dev
->power
.flags
.power_resources
)
780 device_remove_file(&dev
->dev
,
781 &dev_attr_real_power_state
);
785 * If device has _STR, remove 'description' file
787 if (acpi_has_method(dev
->handle
, "_STR")) {
788 kfree(dev
->pnp
.str_obj
);
789 device_remove_file(&dev
->dev
, &dev_attr_description
);
792 * If device has _EJ0, remove 'eject' file.
794 if (acpi_has_method(dev
->handle
, "_EJ0"))
795 device_remove_file(&dev
->dev
, &dev_attr_eject
);
797 if (acpi_has_method(dev
->handle
, "_SUN"))
798 device_remove_file(&dev
->dev
, &dev_attr_sun
);
800 if (dev
->pnp
.unique_id
)
801 device_remove_file(&dev
->dev
, &dev_attr_uid
);
802 if (dev
->pnp
.type
.bus_address
)
803 device_remove_file(&dev
->dev
, &dev_attr_adr
);
804 device_remove_file(&dev
->dev
, &dev_attr_modalias
);
805 device_remove_file(&dev
->dev
, &dev_attr_hid
);
806 if (acpi_has_method(dev
->handle
, "_STA"))
807 device_remove_file(&dev
->dev
, &dev_attr_status
);
809 device_remove_file(&dev
->dev
, &dev_attr_path
);
811 /* --------------------------------------------------------------------------
813 -------------------------------------------------------------------------- */
815 static const struct acpi_device_id
*__acpi_match_device(
816 struct acpi_device
*device
, const struct acpi_device_id
*ids
)
818 const struct acpi_device_id
*id
;
819 struct acpi_hardware_id
*hwid
;
822 * If the device is not present, it is unnecessary to load device
825 if (!device
->status
.present
)
828 for (id
= ids
; id
->id
[0]; id
++)
829 list_for_each_entry(hwid
, &device
->pnp
.ids
, list
)
830 if (!strcmp((char *) id
->id
, hwid
->id
))
837 * acpi_match_device - Match a struct device against a given list of ACPI IDs
838 * @ids: Array of struct acpi_device_id object to match against.
839 * @dev: The device structure to match.
841 * Check if @dev has a valid ACPI handle and if there is a struct acpi_device
842 * object for that handle and use that object to match against a given list of
845 * Return a pointer to the first matching ID on success or %NULL on failure.
847 const struct acpi_device_id
*acpi_match_device(const struct acpi_device_id
*ids
,
848 const struct device
*dev
)
850 struct acpi_device
*adev
;
851 acpi_handle handle
= ACPI_HANDLE(dev
);
853 if (!ids
|| !handle
|| acpi_bus_get_device(handle
, &adev
))
856 return __acpi_match_device(adev
, ids
);
858 EXPORT_SYMBOL_GPL(acpi_match_device
);
860 int acpi_match_device_ids(struct acpi_device
*device
,
861 const struct acpi_device_id
*ids
)
863 return __acpi_match_device(device
, ids
) ? 0 : -ENOENT
;
865 EXPORT_SYMBOL(acpi_match_device_ids
);
867 static void acpi_free_power_resources_lists(struct acpi_device
*device
)
871 if (device
->wakeup
.flags
.valid
)
872 acpi_power_resources_list_free(&device
->wakeup
.resources
);
874 if (!device
->flags
.power_manageable
)
877 for (i
= ACPI_STATE_D0
; i
<= ACPI_STATE_D3_HOT
; i
++) {
878 struct acpi_device_power_state
*ps
= &device
->power
.states
[i
];
879 acpi_power_resources_list_free(&ps
->resources
);
883 static void acpi_device_release(struct device
*dev
)
885 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
887 acpi_free_pnp_ids(&acpi_dev
->pnp
);
888 acpi_free_power_resources_lists(acpi_dev
);
892 static int acpi_bus_match(struct device
*dev
, struct device_driver
*drv
)
894 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
895 struct acpi_driver
*acpi_drv
= to_acpi_driver(drv
);
897 return acpi_dev
->flags
.match_driver
898 && !acpi_match_device_ids(acpi_dev
, acpi_drv
->ids
);
901 static int acpi_device_uevent(struct device
*dev
, struct kobj_uevent_env
*env
)
903 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
906 if (list_empty(&acpi_dev
->pnp
.ids
))
909 if (add_uevent_var(env
, "MODALIAS="))
911 len
= create_modalias(acpi_dev
, &env
->buf
[env
->buflen
- 1],
912 sizeof(env
->buf
) - env
->buflen
);
919 static void acpi_device_notify(acpi_handle handle
, u32 event
, void *data
)
921 struct acpi_device
*device
= data
;
923 device
->driver
->ops
.notify(device
, event
);
926 static void acpi_device_notify_fixed(void *data
)
928 struct acpi_device
*device
= data
;
930 /* Fixed hardware devices have no handles */
931 acpi_device_notify(NULL
, ACPI_FIXED_HARDWARE_EVENT
, device
);
934 static acpi_status
acpi_device_fixed_event(void *data
)
936 acpi_os_execute(OSL_NOTIFY_HANDLER
, acpi_device_notify_fixed
, data
);
940 static int acpi_device_install_notify_handler(struct acpi_device
*device
)
944 if (device
->device_type
== ACPI_BUS_TYPE_POWER_BUTTON
)
946 acpi_install_fixed_event_handler(ACPI_EVENT_POWER_BUTTON
,
947 acpi_device_fixed_event
,
949 else if (device
->device_type
== ACPI_BUS_TYPE_SLEEP_BUTTON
)
951 acpi_install_fixed_event_handler(ACPI_EVENT_SLEEP_BUTTON
,
952 acpi_device_fixed_event
,
955 status
= acpi_install_notify_handler(device
->handle
,
960 if (ACPI_FAILURE(status
))
965 static void acpi_device_remove_notify_handler(struct acpi_device
*device
)
967 if (device
->device_type
== ACPI_BUS_TYPE_POWER_BUTTON
)
968 acpi_remove_fixed_event_handler(ACPI_EVENT_POWER_BUTTON
,
969 acpi_device_fixed_event
);
970 else if (device
->device_type
== ACPI_BUS_TYPE_SLEEP_BUTTON
)
971 acpi_remove_fixed_event_handler(ACPI_EVENT_SLEEP_BUTTON
,
972 acpi_device_fixed_event
);
974 acpi_remove_notify_handler(device
->handle
, ACPI_DEVICE_NOTIFY
,
978 static int acpi_device_probe(struct device
*dev
)
980 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
981 struct acpi_driver
*acpi_drv
= to_acpi_driver(dev
->driver
);
984 if (acpi_dev
->handler
&& !acpi_is_pnp_device(acpi_dev
))
987 if (!acpi_drv
->ops
.add
)
990 ret
= acpi_drv
->ops
.add(acpi_dev
);
994 acpi_dev
->driver
= acpi_drv
;
995 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
996 "Driver [%s] successfully bound to device [%s]\n",
997 acpi_drv
->name
, acpi_dev
->pnp
.bus_id
));
999 if (acpi_drv
->ops
.notify
) {
1000 ret
= acpi_device_install_notify_handler(acpi_dev
);
1002 if (acpi_drv
->ops
.remove
)
1003 acpi_drv
->ops
.remove(acpi_dev
);
1005 acpi_dev
->driver
= NULL
;
1006 acpi_dev
->driver_data
= NULL
;
1011 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Found driver [%s] for device [%s]\n",
1012 acpi_drv
->name
, acpi_dev
->pnp
.bus_id
));
1017 static int acpi_device_remove(struct device
* dev
)
1019 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
1020 struct acpi_driver
*acpi_drv
= acpi_dev
->driver
;
1023 if (acpi_drv
->ops
.notify
)
1024 acpi_device_remove_notify_handler(acpi_dev
);
1025 if (acpi_drv
->ops
.remove
)
1026 acpi_drv
->ops
.remove(acpi_dev
);
1028 acpi_dev
->driver
= NULL
;
1029 acpi_dev
->driver_data
= NULL
;
1035 struct bus_type acpi_bus_type
= {
1037 .match
= acpi_bus_match
,
1038 .probe
= acpi_device_probe
,
1039 .remove
= acpi_device_remove
,
1040 .uevent
= acpi_device_uevent
,
1043 static void acpi_device_del(struct acpi_device
*device
)
1045 mutex_lock(&acpi_device_lock
);
1047 list_del(&device
->node
);
1049 list_del(&device
->wakeup_list
);
1050 mutex_unlock(&acpi_device_lock
);
1052 acpi_power_add_remove_device(device
, false);
1053 acpi_device_remove_files(device
);
1055 device
->remove(device
);
1057 device_del(&device
->dev
);
1060 static LIST_HEAD(acpi_device_del_list
);
1061 static DEFINE_MUTEX(acpi_device_del_lock
);
1063 static void acpi_device_del_work_fn(struct work_struct
*work_not_used
)
1066 struct acpi_device
*adev
;
1068 mutex_lock(&acpi_device_del_lock
);
1070 if (list_empty(&acpi_device_del_list
)) {
1071 mutex_unlock(&acpi_device_del_lock
);
1074 adev
= list_first_entry(&acpi_device_del_list
,
1075 struct acpi_device
, del_list
);
1076 list_del(&adev
->del_list
);
1078 mutex_unlock(&acpi_device_del_lock
);
1080 acpi_device_del(adev
);
1082 * Drop references to all power resources that might have been
1083 * used by the device.
1085 acpi_power_transition(adev
, ACPI_STATE_D3_COLD
);
1086 put_device(&adev
->dev
);
1091 * acpi_scan_drop_device - Drop an ACPI device object.
1092 * @handle: Handle of an ACPI namespace node, not used.
1093 * @context: Address of the ACPI device object to drop.
1095 * This is invoked by acpi_ns_delete_node() during the removal of the ACPI
1096 * namespace node the device object pointed to by @context is attached to.
1098 * The unregistration is carried out asynchronously to avoid running
1099 * acpi_device_del() under the ACPICA's namespace mutex and the list is used to
1100 * ensure the correct ordering (the device objects must be unregistered in the
1101 * same order in which the corresponding namespace nodes are deleted).
1103 static void acpi_scan_drop_device(acpi_handle handle
, void *context
)
1105 static DECLARE_WORK(work
, acpi_device_del_work_fn
);
1106 struct acpi_device
*adev
= context
;
1108 mutex_lock(&acpi_device_del_lock
);
1111 * Use the ACPI hotplug workqueue which is ordered, so this work item
1112 * won't run after any hotplug work items submitted subsequently. That
1113 * prevents attempts to register device objects identical to those being
1114 * deleted from happening concurrently (such attempts result from
1115 * hotplug events handled via the ACPI hotplug workqueue). It also will
1116 * run after all of the work items submitted previosuly, which helps
1117 * those work items to ensure that they are not accessing stale device
1120 if (list_empty(&acpi_device_del_list
))
1121 acpi_queue_hotplug_work(&work
);
1123 list_add_tail(&adev
->del_list
, &acpi_device_del_list
);
1124 /* Make acpi_ns_validate_handle() return NULL for this handle. */
1125 adev
->handle
= INVALID_ACPI_HANDLE
;
1127 mutex_unlock(&acpi_device_del_lock
);
1130 static int acpi_get_device_data(acpi_handle handle
, struct acpi_device
**device
,
1131 void (*callback
)(void *))
1138 status
= acpi_get_data_full(handle
, acpi_scan_drop_device
,
1139 (void **)device
, callback
);
1140 if (ACPI_FAILURE(status
) || !*device
) {
1141 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "No context for object [%p]\n",
1148 int acpi_bus_get_device(acpi_handle handle
, struct acpi_device
**device
)
1150 return acpi_get_device_data(handle
, device
, NULL
);
1152 EXPORT_SYMBOL(acpi_bus_get_device
);
1154 static void get_acpi_device(void *dev
)
1157 get_device(&((struct acpi_device
*)dev
)->dev
);
1160 struct acpi_device
*acpi_bus_get_acpi_device(acpi_handle handle
)
1162 struct acpi_device
*adev
= NULL
;
1164 acpi_get_device_data(handle
, &adev
, get_acpi_device
);
1168 void acpi_bus_put_acpi_device(struct acpi_device
*adev
)
1170 put_device(&adev
->dev
);
1173 int acpi_device_add(struct acpi_device
*device
,
1174 void (*release
)(struct device
*))
1177 struct acpi_device_bus_id
*acpi_device_bus_id
, *new_bus_id
;
1180 if (device
->handle
) {
1183 status
= acpi_attach_data(device
->handle
, acpi_scan_drop_device
,
1185 if (ACPI_FAILURE(status
)) {
1186 acpi_handle_err(device
->handle
,
1187 "Unable to attach device data\n");
1195 * Link this device to its parent and siblings.
1197 INIT_LIST_HEAD(&device
->children
);
1198 INIT_LIST_HEAD(&device
->node
);
1199 INIT_LIST_HEAD(&device
->wakeup_list
);
1200 INIT_LIST_HEAD(&device
->physical_node_list
);
1201 INIT_LIST_HEAD(&device
->del_list
);
1202 mutex_init(&device
->physical_node_lock
);
1204 new_bus_id
= kzalloc(sizeof(struct acpi_device_bus_id
), GFP_KERNEL
);
1206 pr_err(PREFIX
"Memory allocation error\n");
1211 mutex_lock(&acpi_device_lock
);
1213 * Find suitable bus_id and instance number in acpi_bus_id_list
1214 * If failed, create one and link it into acpi_bus_id_list
1216 list_for_each_entry(acpi_device_bus_id
, &acpi_bus_id_list
, node
) {
1217 if (!strcmp(acpi_device_bus_id
->bus_id
,
1218 acpi_device_hid(device
))) {
1219 acpi_device_bus_id
->instance_no
++;
1226 acpi_device_bus_id
= new_bus_id
;
1227 strcpy(acpi_device_bus_id
->bus_id
, acpi_device_hid(device
));
1228 acpi_device_bus_id
->instance_no
= 0;
1229 list_add_tail(&acpi_device_bus_id
->node
, &acpi_bus_id_list
);
1231 dev_set_name(&device
->dev
, "%s:%02x", acpi_device_bus_id
->bus_id
, acpi_device_bus_id
->instance_no
);
1234 list_add_tail(&device
->node
, &device
->parent
->children
);
1236 if (device
->wakeup
.flags
.valid
)
1237 list_add_tail(&device
->wakeup_list
, &acpi_wakeup_device_list
);
1238 mutex_unlock(&acpi_device_lock
);
1241 device
->dev
.parent
= &device
->parent
->dev
;
1242 device
->dev
.bus
= &acpi_bus_type
;
1243 device
->dev
.release
= release
;
1244 result
= device_add(&device
->dev
);
1246 dev_err(&device
->dev
, "Error registering device\n");
1250 result
= acpi_device_setup_files(device
);
1252 printk(KERN_ERR PREFIX
"Error creating sysfs interface for device %s\n",
1253 dev_name(&device
->dev
));
1258 mutex_lock(&acpi_device_lock
);
1260 list_del(&device
->node
);
1261 list_del(&device
->wakeup_list
);
1262 mutex_unlock(&acpi_device_lock
);
1265 acpi_detach_data(device
->handle
, acpi_scan_drop_device
);
1269 /* --------------------------------------------------------------------------
1271 -------------------------------------------------------------------------- */
1273 * acpi_bus_register_driver - register a driver with the ACPI bus
1274 * @driver: driver being registered
1276 * Registers a driver with the ACPI bus. Searches the namespace for all
1277 * devices that match the driver's criteria and binds. Returns zero for
1278 * success or a negative error status for failure.
1280 int acpi_bus_register_driver(struct acpi_driver
*driver
)
1286 driver
->drv
.name
= driver
->name
;
1287 driver
->drv
.bus
= &acpi_bus_type
;
1288 driver
->drv
.owner
= driver
->owner
;
1290 ret
= driver_register(&driver
->drv
);
1294 EXPORT_SYMBOL(acpi_bus_register_driver
);
1297 * acpi_bus_unregister_driver - unregisters a driver with the ACPI bus
1298 * @driver: driver to unregister
1300 * Unregisters a driver with the ACPI bus. Searches the namespace for all
1301 * devices that match the driver's criteria and unbinds.
1303 void acpi_bus_unregister_driver(struct acpi_driver
*driver
)
1305 driver_unregister(&driver
->drv
);
1308 EXPORT_SYMBOL(acpi_bus_unregister_driver
);
1310 /* --------------------------------------------------------------------------
1312 -------------------------------------------------------------------------- */
1313 static struct acpi_device
*acpi_bus_get_parent(acpi_handle handle
)
1315 struct acpi_device
*device
= NULL
;
1319 * Fixed hardware devices do not appear in the namespace and do not
1320 * have handles, but we fabricate acpi_devices for them, so we have
1321 * to deal with them specially.
1327 status
= acpi_get_parent(handle
, &handle
);
1328 if (ACPI_FAILURE(status
))
1329 return status
== AE_NULL_ENTRY
? NULL
: acpi_root
;
1330 } while (acpi_bus_get_device(handle
, &device
));
1335 acpi_bus_get_ejd(acpi_handle handle
, acpi_handle
*ejd
)
1339 struct acpi_buffer buffer
= {ACPI_ALLOCATE_BUFFER
, NULL
};
1340 union acpi_object
*obj
;
1342 status
= acpi_get_handle(handle
, "_EJD", &tmp
);
1343 if (ACPI_FAILURE(status
))
1346 status
= acpi_evaluate_object(handle
, "_EJD", NULL
, &buffer
);
1347 if (ACPI_SUCCESS(status
)) {
1348 obj
= buffer
.pointer
;
1349 status
= acpi_get_handle(ACPI_ROOT_OBJECT
, obj
->string
.pointer
,
1351 kfree(buffer
.pointer
);
1355 EXPORT_SYMBOL_GPL(acpi_bus_get_ejd
);
1357 static int acpi_bus_extract_wakeup_device_power_package(acpi_handle handle
,
1358 struct acpi_device_wakeup
*wakeup
)
1360 struct acpi_buffer buffer
= { ACPI_ALLOCATE_BUFFER
, NULL
};
1361 union acpi_object
*package
= NULL
;
1362 union acpi_object
*element
= NULL
;
1369 INIT_LIST_HEAD(&wakeup
->resources
);
1372 status
= acpi_evaluate_object(handle
, "_PRW", NULL
, &buffer
);
1373 if (ACPI_FAILURE(status
)) {
1374 ACPI_EXCEPTION((AE_INFO
, status
, "Evaluating _PRW"));
1378 package
= (union acpi_object
*)buffer
.pointer
;
1380 if (!package
|| package
->package
.count
< 2)
1383 element
= &(package
->package
.elements
[0]);
1387 if (element
->type
== ACPI_TYPE_PACKAGE
) {
1388 if ((element
->package
.count
< 2) ||
1389 (element
->package
.elements
[0].type
!=
1390 ACPI_TYPE_LOCAL_REFERENCE
)
1391 || (element
->package
.elements
[1].type
!= ACPI_TYPE_INTEGER
))
1394 wakeup
->gpe_device
=
1395 element
->package
.elements
[0].reference
.handle
;
1396 wakeup
->gpe_number
=
1397 (u32
) element
->package
.elements
[1].integer
.value
;
1398 } else if (element
->type
== ACPI_TYPE_INTEGER
) {
1399 wakeup
->gpe_device
= NULL
;
1400 wakeup
->gpe_number
= element
->integer
.value
;
1405 element
= &(package
->package
.elements
[1]);
1406 if (element
->type
!= ACPI_TYPE_INTEGER
)
1409 wakeup
->sleep_state
= element
->integer
.value
;
1411 err
= acpi_extract_power_resources(package
, 2, &wakeup
->resources
);
1415 if (!list_empty(&wakeup
->resources
)) {
1418 err
= acpi_power_wakeup_list_init(&wakeup
->resources
,
1421 acpi_handle_warn(handle
, "Retrieving current states "
1422 "of wakeup power resources failed\n");
1423 acpi_power_resources_list_free(&wakeup
->resources
);
1426 if (sleep_state
< wakeup
->sleep_state
) {
1427 acpi_handle_warn(handle
, "Overriding _PRW sleep state "
1428 "(S%d) by S%d from power resources\n",
1429 (int)wakeup
->sleep_state
, sleep_state
);
1430 wakeup
->sleep_state
= sleep_state
;
1435 kfree(buffer
.pointer
);
1439 static void acpi_wakeup_gpe_init(struct acpi_device
*device
)
1441 struct acpi_device_id button_device_ids
[] = {
1447 struct acpi_device_wakeup
*wakeup
= &device
->wakeup
;
1449 acpi_event_status event_status
;
1451 wakeup
->flags
.notifier_present
= 0;
1453 /* Power button, Lid switch always enable wakeup */
1454 if (!acpi_match_device_ids(device
, button_device_ids
)) {
1455 wakeup
->flags
.run_wake
= 1;
1456 if (!acpi_match_device_ids(device
, &button_device_ids
[1])) {
1457 /* Do not use Lid/sleep button for S5 wakeup */
1458 if (wakeup
->sleep_state
== ACPI_STATE_S5
)
1459 wakeup
->sleep_state
= ACPI_STATE_S4
;
1461 acpi_mark_gpe_for_wake(wakeup
->gpe_device
, wakeup
->gpe_number
);
1462 device_set_wakeup_capable(&device
->dev
, true);
1466 acpi_setup_gpe_for_wake(device
->handle
, wakeup
->gpe_device
,
1467 wakeup
->gpe_number
);
1468 status
= acpi_get_gpe_status(wakeup
->gpe_device
, wakeup
->gpe_number
,
1470 if (ACPI_FAILURE(status
))
1473 wakeup
->flags
.run_wake
= !!(event_status
& ACPI_EVENT_FLAG_HANDLE
);
1476 static void acpi_bus_get_wakeup_device_flags(struct acpi_device
*device
)
1480 /* Presence of _PRW indicates wake capable */
1481 if (!acpi_has_method(device
->handle
, "_PRW"))
1484 err
= acpi_bus_extract_wakeup_device_power_package(device
->handle
,
1487 dev_err(&device
->dev
, "_PRW evaluation error: %d\n", err
);
1491 device
->wakeup
.flags
.valid
= 1;
1492 device
->wakeup
.prepare_count
= 0;
1493 acpi_wakeup_gpe_init(device
);
1494 /* Call _PSW/_DSW object to disable its ability to wake the sleeping
1495 * system for the ACPI device with the _PRW object.
1496 * The _PSW object is depreciated in ACPI 3.0 and is replaced by _DSW.
1497 * So it is necessary to call _DSW object first. Only when it is not
1498 * present will the _PSW object used.
1500 err
= acpi_device_sleep_wake(device
, 0, 0, 0);
1502 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
1503 "error in _DSW or _PSW evaluation\n"));
1506 static void acpi_bus_init_power_state(struct acpi_device
*device
, int state
)
1508 struct acpi_device_power_state
*ps
= &device
->power
.states
[state
];
1509 char pathname
[5] = { '_', 'P', 'R', '0' + state
, '\0' };
1510 struct acpi_buffer buffer
= { ACPI_ALLOCATE_BUFFER
, NULL
};
1513 INIT_LIST_HEAD(&ps
->resources
);
1515 /* Evaluate "_PRx" to get referenced power resources */
1516 status
= acpi_evaluate_object(device
->handle
, pathname
, NULL
, &buffer
);
1517 if (ACPI_SUCCESS(status
)) {
1518 union acpi_object
*package
= buffer
.pointer
;
1520 if (buffer
.length
&& package
1521 && package
->type
== ACPI_TYPE_PACKAGE
1522 && package
->package
.count
) {
1523 int err
= acpi_extract_power_resources(package
, 0,
1526 device
->power
.flags
.power_resources
= 1;
1528 ACPI_FREE(buffer
.pointer
);
1531 /* Evaluate "_PSx" to see if we can do explicit sets */
1533 if (acpi_has_method(device
->handle
, pathname
))
1534 ps
->flags
.explicit_set
= 1;
1537 * State is valid if there are means to put the device into it.
1538 * D3hot is only valid if _PR3 present.
1540 if (!list_empty(&ps
->resources
)
1541 || (ps
->flags
.explicit_set
&& state
< ACPI_STATE_D3_HOT
)) {
1542 ps
->flags
.valid
= 1;
1543 ps
->flags
.os_accessible
= 1;
1546 ps
->power
= -1; /* Unknown - driver assigned */
1547 ps
->latency
= -1; /* Unknown - driver assigned */
1550 static void acpi_bus_get_power_flags(struct acpi_device
*device
)
1554 /* Presence of _PS0|_PR0 indicates 'power manageable' */
1555 if (!acpi_has_method(device
->handle
, "_PS0") &&
1556 !acpi_has_method(device
->handle
, "_PR0"))
1559 device
->flags
.power_manageable
= 1;
1562 * Power Management Flags
1564 if (acpi_has_method(device
->handle
, "_PSC"))
1565 device
->power
.flags
.explicit_get
= 1;
1567 if (acpi_has_method(device
->handle
, "_IRC"))
1568 device
->power
.flags
.inrush_current
= 1;
1570 if (acpi_has_method(device
->handle
, "_DSW"))
1571 device
->power
.flags
.dsw_present
= 1;
1574 * Enumerate supported power management states
1576 for (i
= ACPI_STATE_D0
; i
<= ACPI_STATE_D3_HOT
; i
++)
1577 acpi_bus_init_power_state(device
, i
);
1579 INIT_LIST_HEAD(&device
->power
.states
[ACPI_STATE_D3_COLD
].resources
);
1581 /* Set defaults for D0 and D3 states (always valid) */
1582 device
->power
.states
[ACPI_STATE_D0
].flags
.valid
= 1;
1583 device
->power
.states
[ACPI_STATE_D0
].power
= 100;
1584 device
->power
.states
[ACPI_STATE_D3_COLD
].flags
.valid
= 1;
1585 device
->power
.states
[ACPI_STATE_D3_COLD
].power
= 0;
1587 /* Set D3cold's explicit_set flag if _PS3 exists. */
1588 if (device
->power
.states
[ACPI_STATE_D3_HOT
].flags
.explicit_set
)
1589 device
->power
.states
[ACPI_STATE_D3_COLD
].flags
.explicit_set
= 1;
1591 /* Presence of _PS3 or _PRx means we can put the device into D3 cold */
1592 if (device
->power
.states
[ACPI_STATE_D3_HOT
].flags
.explicit_set
||
1593 device
->power
.flags
.power_resources
)
1594 device
->power
.states
[ACPI_STATE_D3_COLD
].flags
.os_accessible
= 1;
1596 if (acpi_bus_init_power(device
)) {
1597 acpi_free_power_resources_lists(device
);
1598 device
->flags
.power_manageable
= 0;
1602 static void acpi_bus_get_flags(struct acpi_device
*device
)
1604 /* Presence of _STA indicates 'dynamic_status' */
1605 if (acpi_has_method(device
->handle
, "_STA"))
1606 device
->flags
.dynamic_status
= 1;
1608 /* Presence of _RMV indicates 'removable' */
1609 if (acpi_has_method(device
->handle
, "_RMV"))
1610 device
->flags
.removable
= 1;
1612 /* Presence of _EJD|_EJ0 indicates 'ejectable' */
1613 if (acpi_has_method(device
->handle
, "_EJD") ||
1614 acpi_has_method(device
->handle
, "_EJ0"))
1615 device
->flags
.ejectable
= 1;
1618 static void acpi_device_get_busid(struct acpi_device
*device
)
1620 char bus_id
[5] = { '?', 0 };
1621 struct acpi_buffer buffer
= { sizeof(bus_id
), bus_id
};
1627 * The device's Bus ID is simply the object name.
1628 * TBD: Shouldn't this value be unique (within the ACPI namespace)?
1630 if (ACPI_IS_ROOT_DEVICE(device
)) {
1631 strcpy(device
->pnp
.bus_id
, "ACPI");
1635 switch (device
->device_type
) {
1636 case ACPI_BUS_TYPE_POWER_BUTTON
:
1637 strcpy(device
->pnp
.bus_id
, "PWRF");
1639 case ACPI_BUS_TYPE_SLEEP_BUTTON
:
1640 strcpy(device
->pnp
.bus_id
, "SLPF");
1643 acpi_get_name(device
->handle
, ACPI_SINGLE_NAME
, &buffer
);
1644 /* Clean up trailing underscores (if any) */
1645 for (i
= 3; i
> 1; i
--) {
1646 if (bus_id
[i
] == '_')
1651 strcpy(device
->pnp
.bus_id
, bus_id
);
1657 * acpi_ata_match - see if an acpi object is an ATA device
1659 * If an acpi object has one of the ACPI ATA methods defined,
1660 * then we can safely call it an ATA device.
1662 bool acpi_ata_match(acpi_handle handle
)
1664 return acpi_has_method(handle
, "_GTF") ||
1665 acpi_has_method(handle
, "_GTM") ||
1666 acpi_has_method(handle
, "_STM") ||
1667 acpi_has_method(handle
, "_SDD");
1671 * acpi_bay_match - see if an acpi object is an ejectable driver bay
1673 * If an acpi object is ejectable and has one of the ACPI ATA methods defined,
1674 * then we can safely call it an ejectable drive bay
1676 bool acpi_bay_match(acpi_handle handle
)
1678 acpi_handle phandle
;
1680 if (!acpi_has_method(handle
, "_EJ0"))
1682 if (acpi_ata_match(handle
))
1684 if (ACPI_FAILURE(acpi_get_parent(handle
, &phandle
)))
1687 return acpi_ata_match(phandle
);
1690 bool acpi_device_is_battery(struct acpi_device
*adev
)
1692 struct acpi_hardware_id
*hwid
;
1694 list_for_each_entry(hwid
, &adev
->pnp
.ids
, list
)
1695 if (!strcmp("PNP0C0A", hwid
->id
))
1701 static bool is_ejectable_bay(struct acpi_device
*adev
)
1703 acpi_handle handle
= adev
->handle
;
1705 if (acpi_has_method(handle
, "_EJ0") && acpi_device_is_battery(adev
))
1708 return acpi_bay_match(handle
);
1712 * acpi_dock_match - see if an acpi object has a _DCK method
1714 bool acpi_dock_match(acpi_handle handle
)
1716 return acpi_has_method(handle
, "_DCK");
1719 const char *acpi_device_hid(struct acpi_device
*device
)
1721 struct acpi_hardware_id
*hid
;
1723 if (list_empty(&device
->pnp
.ids
))
1726 hid
= list_first_entry(&device
->pnp
.ids
, struct acpi_hardware_id
, list
);
1729 EXPORT_SYMBOL(acpi_device_hid
);
1731 static void acpi_add_id(struct acpi_device_pnp
*pnp
, const char *dev_id
)
1733 struct acpi_hardware_id
*id
;
1735 id
= kmalloc(sizeof(*id
), GFP_KERNEL
);
1739 id
->id
= kstrdup(dev_id
, GFP_KERNEL
);
1745 list_add_tail(&id
->list
, &pnp
->ids
);
1746 pnp
->type
.hardware_id
= 1;
1750 * Old IBM workstations have a DSDT bug wherein the SMBus object
1751 * lacks the SMBUS01 HID and the methods do not have the necessary "_"
1752 * prefix. Work around this.
1754 static bool acpi_ibm_smbus_match(acpi_handle handle
)
1756 char node_name
[ACPI_PATH_SEGMENT_LENGTH
];
1757 struct acpi_buffer path
= { sizeof(node_name
), node_name
};
1759 if (!dmi_name_in_vendors("IBM"))
1762 /* Look for SMBS object */
1763 if (ACPI_FAILURE(acpi_get_name(handle
, ACPI_SINGLE_NAME
, &path
)) ||
1764 strcmp("SMBS", path
.pointer
))
1767 /* Does it have the necessary (but misnamed) methods? */
1768 if (acpi_has_method(handle
, "SBI") &&
1769 acpi_has_method(handle
, "SBR") &&
1770 acpi_has_method(handle
, "SBW"))
1776 static bool acpi_object_is_system_bus(acpi_handle handle
)
1780 if (ACPI_SUCCESS(acpi_get_handle(NULL
, "\\_SB", &tmp
)) &&
1783 if (ACPI_SUCCESS(acpi_get_handle(NULL
, "\\_TZ", &tmp
)) &&
1790 static void acpi_set_pnp_ids(acpi_handle handle
, struct acpi_device_pnp
*pnp
,
1794 struct acpi_device_info
*info
;
1795 struct acpi_pnp_device_id_list
*cid_list
;
1798 switch (device_type
) {
1799 case ACPI_BUS_TYPE_DEVICE
:
1800 if (handle
== ACPI_ROOT_OBJECT
) {
1801 acpi_add_id(pnp
, ACPI_SYSTEM_HID
);
1805 status
= acpi_get_object_info(handle
, &info
);
1806 if (ACPI_FAILURE(status
)) {
1807 pr_err(PREFIX
"%s: Error reading device info\n",
1812 if (info
->valid
& ACPI_VALID_HID
) {
1813 acpi_add_id(pnp
, info
->hardware_id
.string
);
1814 pnp
->type
.platform_id
= 1;
1816 if (info
->valid
& ACPI_VALID_CID
) {
1817 cid_list
= &info
->compatible_id_list
;
1818 for (i
= 0; i
< cid_list
->count
; i
++)
1819 acpi_add_id(pnp
, cid_list
->ids
[i
].string
);
1821 if (info
->valid
& ACPI_VALID_ADR
) {
1822 pnp
->bus_address
= info
->address
;
1823 pnp
->type
.bus_address
= 1;
1825 if (info
->valid
& ACPI_VALID_UID
)
1826 pnp
->unique_id
= kstrdup(info
->unique_id
.string
,
1832 * Some devices don't reliably have _HIDs & _CIDs, so add
1833 * synthetic HIDs to make sure drivers can find them.
1835 if (acpi_is_video_device(handle
))
1836 acpi_add_id(pnp
, ACPI_VIDEO_HID
);
1837 else if (acpi_bay_match(handle
))
1838 acpi_add_id(pnp
, ACPI_BAY_HID
);
1839 else if (acpi_dock_match(handle
))
1840 acpi_add_id(pnp
, ACPI_DOCK_HID
);
1841 else if (acpi_ibm_smbus_match(handle
))
1842 acpi_add_id(pnp
, ACPI_SMBUS_IBM_HID
);
1843 else if (list_empty(&pnp
->ids
) &&
1844 acpi_object_is_system_bus(handle
)) {
1845 /* \_SB, \_TZ, LNXSYBUS */
1846 acpi_add_id(pnp
, ACPI_BUS_HID
);
1847 strcpy(pnp
->device_name
, ACPI_BUS_DEVICE_NAME
);
1848 strcpy(pnp
->device_class
, ACPI_BUS_CLASS
);
1852 case ACPI_BUS_TYPE_POWER
:
1853 acpi_add_id(pnp
, ACPI_POWER_HID
);
1855 case ACPI_BUS_TYPE_PROCESSOR
:
1856 acpi_add_id(pnp
, ACPI_PROCESSOR_OBJECT_HID
);
1858 case ACPI_BUS_TYPE_THERMAL
:
1859 acpi_add_id(pnp
, ACPI_THERMAL_HID
);
1861 case ACPI_BUS_TYPE_POWER_BUTTON
:
1862 acpi_add_id(pnp
, ACPI_BUTTON_HID_POWERF
);
1864 case ACPI_BUS_TYPE_SLEEP_BUTTON
:
1865 acpi_add_id(pnp
, ACPI_BUTTON_HID_SLEEPF
);
1870 void acpi_free_pnp_ids(struct acpi_device_pnp
*pnp
)
1872 struct acpi_hardware_id
*id
, *tmp
;
1874 list_for_each_entry_safe(id
, tmp
, &pnp
->ids
, list
) {
1878 kfree(pnp
->unique_id
);
1881 void acpi_init_device_object(struct acpi_device
*device
, acpi_handle handle
,
1882 int type
, unsigned long long sta
)
1884 INIT_LIST_HEAD(&device
->pnp
.ids
);
1885 device
->device_type
= type
;
1886 device
->handle
= handle
;
1887 device
->parent
= acpi_bus_get_parent(handle
);
1888 acpi_set_device_status(device
, sta
);
1889 acpi_device_get_busid(device
);
1890 acpi_set_pnp_ids(handle
, &device
->pnp
, type
);
1891 acpi_bus_get_flags(device
);
1892 device
->flags
.match_driver
= false;
1893 device
->flags
.initialized
= true;
1894 device
->flags
.visited
= false;
1895 device_initialize(&device
->dev
);
1896 dev_set_uevent_suppress(&device
->dev
, true);
1899 void acpi_device_add_finalize(struct acpi_device
*device
)
1901 dev_set_uevent_suppress(&device
->dev
, false);
1902 kobject_uevent(&device
->dev
.kobj
, KOBJ_ADD
);
1905 static int acpi_add_single_object(struct acpi_device
**child
,
1906 acpi_handle handle
, int type
,
1907 unsigned long long sta
)
1910 struct acpi_device
*device
;
1911 struct acpi_buffer buffer
= { ACPI_ALLOCATE_BUFFER
, NULL
};
1913 device
= kzalloc(sizeof(struct acpi_device
), GFP_KERNEL
);
1915 printk(KERN_ERR PREFIX
"Memory allocation error\n");
1919 acpi_init_device_object(device
, handle
, type
, sta
);
1920 acpi_bus_get_power_flags(device
);
1921 acpi_bus_get_wakeup_device_flags(device
);
1923 result
= acpi_device_add(device
, acpi_device_release
);
1925 acpi_device_release(&device
->dev
);
1929 acpi_power_add_remove_device(device
, true);
1930 acpi_device_add_finalize(device
);
1931 acpi_get_name(handle
, ACPI_FULL_PATHNAME
, &buffer
);
1932 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Added %s [%s] parent %s\n",
1933 dev_name(&device
->dev
), (char *) buffer
.pointer
,
1934 device
->parent
? dev_name(&device
->parent
->dev
) : "(null)"));
1935 kfree(buffer
.pointer
);
1940 static int acpi_bus_type_and_status(acpi_handle handle
, int *type
,
1941 unsigned long long *sta
)
1944 acpi_object_type acpi_type
;
1946 status
= acpi_get_type(handle
, &acpi_type
);
1947 if (ACPI_FAILURE(status
))
1950 switch (acpi_type
) {
1951 case ACPI_TYPE_ANY
: /* for ACPI_ROOT_OBJECT */
1952 case ACPI_TYPE_DEVICE
:
1953 *type
= ACPI_BUS_TYPE_DEVICE
;
1954 status
= acpi_bus_get_status_handle(handle
, sta
);
1955 if (ACPI_FAILURE(status
))
1958 case ACPI_TYPE_PROCESSOR
:
1959 *type
= ACPI_BUS_TYPE_PROCESSOR
;
1960 status
= acpi_bus_get_status_handle(handle
, sta
);
1961 if (ACPI_FAILURE(status
))
1964 case ACPI_TYPE_THERMAL
:
1965 *type
= ACPI_BUS_TYPE_THERMAL
;
1966 *sta
= ACPI_STA_DEFAULT
;
1968 case ACPI_TYPE_POWER
:
1969 *type
= ACPI_BUS_TYPE_POWER
;
1970 *sta
= ACPI_STA_DEFAULT
;
1979 bool acpi_device_is_present(struct acpi_device
*adev
)
1981 if (adev
->status
.present
|| adev
->status
.functional
)
1984 adev
->flags
.initialized
= false;
1988 static bool acpi_scan_handler_matching(struct acpi_scan_handler
*handler
,
1990 const struct acpi_device_id
**matchid
)
1992 const struct acpi_device_id
*devid
;
1995 return handler
->match(idstr
, matchid
);
1997 for (devid
= handler
->ids
; devid
->id
[0]; devid
++)
1998 if (!strcmp((char *)devid
->id
, idstr
)) {
2008 static struct acpi_scan_handler
*acpi_scan_match_handler(char *idstr
,
2009 const struct acpi_device_id
**matchid
)
2011 struct acpi_scan_handler
*handler
;
2013 list_for_each_entry(handler
, &acpi_scan_handlers_list
, list_node
)
2014 if (acpi_scan_handler_matching(handler
, idstr
, matchid
))
2020 void acpi_scan_hotplug_enabled(struct acpi_hotplug_profile
*hotplug
, bool val
)
2022 if (!!hotplug
->enabled
== !!val
)
2025 mutex_lock(&acpi_scan_lock
);
2027 hotplug
->enabled
= val
;
2029 mutex_unlock(&acpi_scan_lock
);
2032 static void acpi_scan_init_hotplug(struct acpi_device
*adev
)
2034 struct acpi_hardware_id
*hwid
;
2036 if (acpi_dock_match(adev
->handle
) || is_ejectable_bay(adev
)) {
2037 acpi_dock_add(adev
);
2040 list_for_each_entry(hwid
, &adev
->pnp
.ids
, list
) {
2041 struct acpi_scan_handler
*handler
;
2043 handler
= acpi_scan_match_handler(hwid
->id
, NULL
);
2045 adev
->flags
.hotplug_notify
= true;
2051 static acpi_status
acpi_bus_check_add(acpi_handle handle
, u32 lvl_not_used
,
2052 void *not_used
, void **return_value
)
2054 struct acpi_device
*device
= NULL
;
2056 unsigned long long sta
;
2059 acpi_bus_get_device(handle
, &device
);
2063 result
= acpi_bus_type_and_status(handle
, &type
, &sta
);
2067 if (type
== ACPI_BUS_TYPE_POWER
) {
2068 acpi_add_power_resource(handle
);
2072 acpi_add_single_object(&device
, handle
, type
, sta
);
2074 return AE_CTRL_DEPTH
;
2076 acpi_scan_init_hotplug(device
);
2080 *return_value
= device
;
2085 static int acpi_check_spi_i2c_slave(struct acpi_resource
*ares
, void *data
)
2087 bool *is_spi_i2c_slave_p
= data
;
2089 if (ares
->type
!= ACPI_RESOURCE_TYPE_SERIAL_BUS
)
2093 * devices that are connected to UART still need to be enumerated to
2096 if (ares
->data
.common_serial_bus
.type
!= ACPI_RESOURCE_SERIAL_TYPE_UART
)
2097 *is_spi_i2c_slave_p
= true;
2099 /* no need to do more checking */
2103 static void acpi_default_enumeration(struct acpi_device
*device
)
2105 struct list_head resource_list
;
2106 bool is_spi_i2c_slave
= false;
2108 if (!device
->pnp
.type
.platform_id
|| device
->handler
)
2112 * Do not enemerate SPI/I2C slaves as they will be enuerated by their
2113 * respective parents.
2115 INIT_LIST_HEAD(&resource_list
);
2116 acpi_dev_get_resources(device
, &resource_list
, acpi_check_spi_i2c_slave
,
2118 acpi_dev_free_resource_list(&resource_list
);
2119 if (!is_spi_i2c_slave
)
2120 acpi_create_platform_device(device
);
2123 static int acpi_scan_attach_handler(struct acpi_device
*device
)
2125 struct acpi_hardware_id
*hwid
;
2128 list_for_each_entry(hwid
, &device
->pnp
.ids
, list
) {
2129 const struct acpi_device_id
*devid
;
2130 struct acpi_scan_handler
*handler
;
2132 handler
= acpi_scan_match_handler(hwid
->id
, &devid
);
2134 if (!handler
->attach
) {
2135 device
->pnp
.type
.platform_id
= 0;
2138 device
->handler
= handler
;
2139 ret
= handler
->attach(device
, devid
);
2143 device
->handler
= NULL
;
2149 acpi_default_enumeration(device
);
2154 static void acpi_bus_attach(struct acpi_device
*device
)
2156 struct acpi_device
*child
;
2160 if (ACPI_SUCCESS(acpi_bus_get_ejd(device
->handle
, &ejd
)))
2161 register_dock_dependent_device(device
, ejd
);
2163 acpi_bus_get_status(device
);
2164 /* Skip devices that are not present. */
2165 if (!acpi_device_is_present(device
)) {
2166 device
->flags
.visited
= false;
2169 if (device
->handler
)
2172 if (!device
->flags
.initialized
) {
2173 acpi_bus_update_power(device
, NULL
);
2174 device
->flags
.initialized
= true;
2176 device
->flags
.visited
= false;
2177 ret
= acpi_scan_attach_handler(device
);
2181 device
->flags
.match_driver
= true;
2183 ret
= device_attach(&device
->dev
);
2187 device
->flags
.visited
= true;
2190 list_for_each_entry(child
, &device
->children
, node
)
2191 acpi_bus_attach(child
);
2193 if (device
->handler
&& device
->handler
->hotplug
.notify_online
)
2194 device
->handler
->hotplug
.notify_online(device
);
2198 * acpi_bus_scan - Add ACPI device node objects in a given namespace scope.
2199 * @handle: Root of the namespace scope to scan.
2201 * Scan a given ACPI tree (probably recently hot-plugged) and create and add
2204 * If no devices were found, -ENODEV is returned, but it does not mean that
2205 * there has been a real error. There just have been no suitable ACPI objects
2206 * in the table trunk from which the kernel could create a device and add an
2207 * appropriate driver.
2209 * Must be called under acpi_scan_lock.
2211 int acpi_bus_scan(acpi_handle handle
)
2213 void *device
= NULL
;
2215 if (ACPI_SUCCESS(acpi_bus_check_add(handle
, 0, NULL
, &device
)))
2216 acpi_walk_namespace(ACPI_TYPE_ANY
, handle
, ACPI_UINT32_MAX
,
2217 acpi_bus_check_add
, NULL
, NULL
, &device
);
2220 acpi_bus_attach(device
);
2225 EXPORT_SYMBOL(acpi_bus_scan
);
2228 * acpi_bus_trim - Detach scan handlers and drivers from ACPI device objects.
2229 * @adev: Root of the ACPI namespace scope to walk.
2231 * Must be called under acpi_scan_lock.
2233 void acpi_bus_trim(struct acpi_device
*adev
)
2235 struct acpi_scan_handler
*handler
= adev
->handler
;
2236 struct acpi_device
*child
;
2238 list_for_each_entry_reverse(child
, &adev
->children
, node
)
2239 acpi_bus_trim(child
);
2241 adev
->flags
.match_driver
= false;
2243 if (handler
->detach
)
2244 handler
->detach(adev
);
2246 adev
->handler
= NULL
;
2248 device_release_driver(&adev
->dev
);
2251 * Most likely, the device is going away, so put it into D3cold before
2254 acpi_device_set_power(adev
, ACPI_STATE_D3_COLD
);
2255 adev
->flags
.initialized
= false;
2256 adev
->flags
.visited
= false;
2258 EXPORT_SYMBOL_GPL(acpi_bus_trim
);
2260 static int acpi_bus_scan_fixed(void)
2265 * Enumerate all fixed-feature devices.
2267 if (!(acpi_gbl_FADT
.flags
& ACPI_FADT_POWER_BUTTON
)) {
2268 struct acpi_device
*device
= NULL
;
2270 result
= acpi_add_single_object(&device
, NULL
,
2271 ACPI_BUS_TYPE_POWER_BUTTON
,
2276 device
->flags
.match_driver
= true;
2277 result
= device_attach(&device
->dev
);
2281 device_init_wakeup(&device
->dev
, true);
2284 if (!(acpi_gbl_FADT
.flags
& ACPI_FADT_SLEEP_BUTTON
)) {
2285 struct acpi_device
*device
= NULL
;
2287 result
= acpi_add_single_object(&device
, NULL
,
2288 ACPI_BUS_TYPE_SLEEP_BUTTON
,
2293 device
->flags
.match_driver
= true;
2294 result
= device_attach(&device
->dev
);
2297 return result
< 0 ? result
: 0;
2300 int __init
acpi_scan_init(void)
2304 result
= bus_register(&acpi_bus_type
);
2306 /* We don't want to quit even if we failed to add suspend/resume */
2307 printk(KERN_ERR PREFIX
"Could not register bus type\n");
2310 acpi_pci_root_init();
2311 acpi_pci_link_init();
2312 acpi_processor_init();
2314 acpi_cmos_rtc_init();
2315 acpi_container_init();
2316 acpi_memory_hotplug_init();
2319 mutex_lock(&acpi_scan_lock
);
2321 * Enumerate devices in the ACPI namespace.
2323 result
= acpi_bus_scan(ACPI_ROOT_OBJECT
);
2327 result
= acpi_bus_get_device(ACPI_ROOT_OBJECT
, &acpi_root
);
2331 /* Fixed feature devices do not exist on HW-reduced platform */
2332 if (!acpi_gbl_reduced_hardware
) {
2333 result
= acpi_bus_scan_fixed();
2335 acpi_detach_data(acpi_root
->handle
,
2336 acpi_scan_drop_device
);
2337 acpi_device_del(acpi_root
);
2338 put_device(&acpi_root
->dev
);
2343 acpi_update_all_gpes();
2346 mutex_unlock(&acpi_scan_lock
);