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 <acpi/acpi_drivers.h>
19 #define _COMPONENT ACPI_BUS_COMPONENT
20 ACPI_MODULE_NAME("scan");
21 #define STRUCT_TO_INT(s) (*((int*)&s))
22 extern struct acpi_device *acpi_root;
24 #define ACPI_BUS_CLASS "system_bus"
25 #define ACPI_BUS_HID "LNXSYBUS"
26 #define ACPI_BUS_DEVICE_NAME "System Bus"
28 #define ACPI_IS_ROOT_DEVICE(device) (!(device)->parent)
30 static const char *dummy_hid = "device";
33 * The following ACPI IDs are known to be suitable for representing as
36 static const struct acpi_device_id acpi_platform_device_ids[] = {
40 /* Haswell LPSS devices */
53 static LIST_HEAD(acpi_device_list);
54 static LIST_HEAD(acpi_bus_id_list);
55 DEFINE_MUTEX(acpi_device_lock);
56 LIST_HEAD(acpi_wakeup_device_list);
58 struct acpi_device_bus_id{
60 unsigned int instance_no;
61 struct list_head node;
65 * Creates hid/cid(s) string needed for modalias and uevent
66 * e.g. on a device with hid:IBM0001 and cid:ACPI0001 you get:
67 * char *modalias: "acpi:IBM0001:ACPI0001"
69 static int create_modalias(struct acpi_device *acpi_dev, char *modalias,
74 struct acpi_hardware_id *id;
76 if (list_empty(&acpi_dev->pnp.ids))
79 len = snprintf(modalias, size, "acpi:");
82 list_for_each_entry(id, &acpi_dev->pnp.ids, list) {
83 count = snprintf(&modalias[len], size, "%s:", id->id);
84 if (count < 0 || count >= size)
95 acpi_device_modalias_show(struct device *dev, struct device_attribute *attr, char *buf) {
96 struct acpi_device *acpi_dev = to_acpi_device(dev);
99 /* Device has no HID and no CID or string is >1024 */
100 len = create_modalias(acpi_dev, buf, 1024);
106 static DEVICE_ATTR(modalias, 0444, acpi_device_modalias_show, NULL);
109 * acpi_bus_hot_remove_device: hot-remove a device and its children
110 * @context: struct acpi_eject_event pointer (freed in this func)
112 * Hot-remove a device and its children. This function frees up the
113 * memory space passed by arg context, so that the caller may call
114 * this function asynchronously through acpi_os_hotplug_execute().
116 void acpi_bus_hot_remove_device(void *context)
118 struct acpi_eject_event *ej_event = (struct acpi_eject_event *) context;
119 struct acpi_device *device = ej_event->device;
120 acpi_handle handle = device->handle;
122 struct acpi_object_list arg_list;
123 union acpi_object arg;
124 acpi_status status = AE_OK;
125 u32 ost_code = ACPI_OST_SC_NON_SPECIFIC_FAILURE; /* default */
127 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
128 "Hot-removing device %s...\n", dev_name(&device->dev)));
130 if (acpi_bus_trim(device)) {
131 printk(KERN_ERR PREFIX
132 "Removing device failed\n");
136 /* device has been freed */
139 /* power off device */
140 status = acpi_evaluate_object(handle, "_PS3", NULL, NULL);
141 if (ACPI_FAILURE(status) && status != AE_NOT_FOUND)
142 printk(KERN_WARNING PREFIX
143 "Power-off device failed\n");
145 if (ACPI_SUCCESS(acpi_get_handle(handle, "_LCK", &temp))) {
147 arg_list.pointer = &arg;
148 arg.type = ACPI_TYPE_INTEGER;
149 arg.integer.value = 0;
150 acpi_evaluate_object(handle, "_LCK", &arg_list, NULL);
154 arg_list.pointer = &arg;
155 arg.type = ACPI_TYPE_INTEGER;
156 arg.integer.value = 1;
161 status = acpi_evaluate_object(handle, "_EJ0", &arg_list, NULL);
162 if (ACPI_FAILURE(status)) {
163 if (status != AE_NOT_FOUND)
164 printk(KERN_WARNING PREFIX
165 "Eject device failed\n");
173 /* Inform firmware the hot-remove operation has completed w/ error */
174 (void) acpi_evaluate_hotplug_ost(handle,
175 ej_event->event, ost_code, NULL);
179 EXPORT_SYMBOL(acpi_bus_hot_remove_device);
182 acpi_eject_store(struct device *d, struct device_attribute *attr,
183 const char *buf, size_t count)
187 acpi_object_type type = 0;
188 struct acpi_device *acpi_device = to_acpi_device(d);
189 struct acpi_eject_event *ej_event;
191 if ((!count) || (buf[0] != '1')) {
195 if (acpi_device->driver == NULL) {
200 status = acpi_get_type(acpi_device->handle, &type);
201 if (ACPI_FAILURE(status) || (!acpi_device->flags.ejectable)) {
206 ej_event = kmalloc(sizeof(*ej_event), GFP_KERNEL);
212 ej_event->device = acpi_device;
213 if (acpi_device->flags.eject_pending) {
214 /* event originated from ACPI eject notification */
215 ej_event->event = ACPI_NOTIFY_EJECT_REQUEST;
216 acpi_device->flags.eject_pending = 0;
218 /* event originated from user */
219 ej_event->event = ACPI_OST_EC_OSPM_EJECT;
220 (void) acpi_evaluate_hotplug_ost(acpi_device->handle,
221 ej_event->event, ACPI_OST_SC_EJECT_IN_PROGRESS, NULL);
224 acpi_os_hotplug_execute(acpi_bus_hot_remove_device, (void *)ej_event);
229 static DEVICE_ATTR(eject, 0200, NULL, acpi_eject_store);
232 acpi_device_hid_show(struct device *dev, struct device_attribute *attr, char *buf) {
233 struct acpi_device *acpi_dev = to_acpi_device(dev);
235 return sprintf(buf, "%s\n", acpi_device_hid(acpi_dev));
237 static DEVICE_ATTR(hid, 0444, acpi_device_hid_show, NULL);
239 static ssize_t acpi_device_uid_show(struct device *dev,
240 struct device_attribute *attr, char *buf)
242 struct acpi_device *acpi_dev = to_acpi_device(dev);
244 return sprintf(buf, "%s\n", acpi_dev->pnp.unique_id);
246 static DEVICE_ATTR(uid, 0444, acpi_device_uid_show, NULL);
248 static ssize_t acpi_device_adr_show(struct device *dev,
249 struct device_attribute *attr, char *buf)
251 struct acpi_device *acpi_dev = to_acpi_device(dev);
253 return sprintf(buf, "0x%08x\n",
254 (unsigned int)(acpi_dev->pnp.bus_address));
256 static DEVICE_ATTR(adr, 0444, acpi_device_adr_show, NULL);
259 acpi_device_path_show(struct device *dev, struct device_attribute *attr, char *buf) {
260 struct acpi_device *acpi_dev = to_acpi_device(dev);
261 struct acpi_buffer path = {ACPI_ALLOCATE_BUFFER, NULL};
264 result = acpi_get_name(acpi_dev->handle, ACPI_FULL_PATHNAME, &path);
268 result = sprintf(buf, "%s\n", (char*)path.pointer);
273 static DEVICE_ATTR(path, 0444, acpi_device_path_show, NULL);
275 /* sysfs file that shows description text from the ACPI _STR method */
276 static ssize_t description_show(struct device *dev,
277 struct device_attribute *attr,
279 struct acpi_device *acpi_dev = to_acpi_device(dev);
282 if (acpi_dev->pnp.str_obj == NULL)
286 * The _STR object contains a Unicode identifier for a device.
287 * We need to convert to utf-8 so it can be displayed.
289 result = utf16s_to_utf8s(
290 (wchar_t *)acpi_dev->pnp.str_obj->buffer.pointer,
291 acpi_dev->pnp.str_obj->buffer.length,
292 UTF16_LITTLE_ENDIAN, buf,
295 buf[result++] = '\n';
299 static DEVICE_ATTR(description, 0444, description_show, NULL);
302 acpi_device_sun_show(struct device *dev, struct device_attribute *attr,
304 struct acpi_device *acpi_dev = to_acpi_device(dev);
306 return sprintf(buf, "%lu\n", acpi_dev->pnp.sun);
308 static DEVICE_ATTR(sun, 0444, acpi_device_sun_show, NULL);
310 static int acpi_device_setup_files(struct acpi_device *dev)
312 struct acpi_buffer buffer = {ACPI_ALLOCATE_BUFFER, NULL};
315 unsigned long long sun;
319 * Devices gotten from FADT don't have a "path" attribute
322 result = device_create_file(&dev->dev, &dev_attr_path);
327 if (!list_empty(&dev->pnp.ids)) {
328 result = device_create_file(&dev->dev, &dev_attr_hid);
332 result = device_create_file(&dev->dev, &dev_attr_modalias);
338 * If device has _STR, 'description' file is created
340 status = acpi_get_handle(dev->handle, "_STR", &temp);
341 if (ACPI_SUCCESS(status)) {
342 status = acpi_evaluate_object(dev->handle, "_STR",
344 if (ACPI_FAILURE(status))
345 buffer.pointer = NULL;
346 dev->pnp.str_obj = buffer.pointer;
347 result = device_create_file(&dev->dev, &dev_attr_description);
352 if (dev->flags.bus_address)
353 result = device_create_file(&dev->dev, &dev_attr_adr);
354 if (dev->pnp.unique_id)
355 result = device_create_file(&dev->dev, &dev_attr_uid);
357 status = acpi_evaluate_integer(dev->handle, "_SUN", NULL, &sun);
358 if (ACPI_SUCCESS(status)) {
359 dev->pnp.sun = (unsigned long)sun;
360 result = device_create_file(&dev->dev, &dev_attr_sun);
364 dev->pnp.sun = (unsigned long)-1;
368 * If device has _EJ0, 'eject' file is created that is used to trigger
369 * hot-removal function from userland.
371 status = acpi_get_handle(dev->handle, "_EJ0", &temp);
372 if (ACPI_SUCCESS(status))
373 result = device_create_file(&dev->dev, &dev_attr_eject);
378 static void acpi_device_remove_files(struct acpi_device *dev)
384 * If device has _STR, remove 'description' file
386 status = acpi_get_handle(dev->handle, "_STR", &temp);
387 if (ACPI_SUCCESS(status)) {
388 kfree(dev->pnp.str_obj);
389 device_remove_file(&dev->dev, &dev_attr_description);
392 * If device has _EJ0, remove 'eject' file.
394 status = acpi_get_handle(dev->handle, "_EJ0", &temp);
395 if (ACPI_SUCCESS(status))
396 device_remove_file(&dev->dev, &dev_attr_eject);
398 status = acpi_get_handle(dev->handle, "_SUN", &temp);
399 if (ACPI_SUCCESS(status))
400 device_remove_file(&dev->dev, &dev_attr_sun);
402 if (dev->pnp.unique_id)
403 device_remove_file(&dev->dev, &dev_attr_uid);
404 if (dev->flags.bus_address)
405 device_remove_file(&dev->dev, &dev_attr_adr);
406 device_remove_file(&dev->dev, &dev_attr_modalias);
407 device_remove_file(&dev->dev, &dev_attr_hid);
409 device_remove_file(&dev->dev, &dev_attr_path);
411 /* --------------------------------------------------------------------------
413 -------------------------------------------------------------------------- */
415 static const struct acpi_device_id *__acpi_match_device(
416 struct acpi_device *device, const struct acpi_device_id *ids)
418 const struct acpi_device_id *id;
419 struct acpi_hardware_id *hwid;
422 * If the device is not present, it is unnecessary to load device
425 if (!device->status.present)
428 for (id = ids; id->id[0]; id++)
429 list_for_each_entry(hwid, &device->pnp.ids, list)
430 if (!strcmp((char *) id->id, hwid->id))
437 * acpi_match_device - Match a struct device against a given list of ACPI IDs
438 * @ids: Array of struct acpi_device_id object to match against.
439 * @dev: The device structure to match.
441 * Check if @dev has a valid ACPI handle and if there is a struct acpi_device
442 * object for that handle and use that object to match against a given list of
445 * Return a pointer to the first matching ID on success or %NULL on failure.
447 const struct acpi_device_id *acpi_match_device(const struct acpi_device_id *ids,
448 const struct device *dev)
450 struct acpi_device *adev;
452 if (!ids || !ACPI_HANDLE(dev)
453 || ACPI_FAILURE(acpi_bus_get_device(ACPI_HANDLE(dev), &adev)))
456 return __acpi_match_device(adev, ids);
458 EXPORT_SYMBOL_GPL(acpi_match_device);
460 int acpi_match_device_ids(struct acpi_device *device,
461 const struct acpi_device_id *ids)
463 return __acpi_match_device(device, ids) ? 0 : -ENOENT;
465 EXPORT_SYMBOL(acpi_match_device_ids);
467 void acpi_free_ids(struct acpi_device *device)
469 struct acpi_hardware_id *id, *tmp;
471 list_for_each_entry_safe(id, tmp, &device->pnp.ids, list) {
475 kfree(device->pnp.unique_id);
478 static void acpi_free_power_resources_lists(struct acpi_device *device)
482 if (!device->flags.power_manageable)
485 for (i = ACPI_STATE_D0; i <= ACPI_STATE_D3_HOT; i++) {
486 struct acpi_device_power_state *ps = &device->power.states[i];
487 acpi_power_resources_list_free(&ps->resources);
491 static void acpi_device_release(struct device *dev)
493 struct acpi_device *acpi_dev = to_acpi_device(dev);
495 acpi_free_ids(acpi_dev);
496 acpi_free_power_resources_lists(acpi_dev);
500 static int acpi_bus_match(struct device *dev, struct device_driver *drv)
502 struct acpi_device *acpi_dev = to_acpi_device(dev);
503 struct acpi_driver *acpi_drv = to_acpi_driver(drv);
505 return acpi_dev->flags.match_driver
506 && !acpi_match_device_ids(acpi_dev, acpi_drv->ids);
509 static int acpi_device_uevent(struct device *dev, struct kobj_uevent_env *env)
511 struct acpi_device *acpi_dev = to_acpi_device(dev);
514 if (list_empty(&acpi_dev->pnp.ids))
517 if (add_uevent_var(env, "MODALIAS="))
519 len = create_modalias(acpi_dev, &env->buf[env->buflen - 1],
520 sizeof(env->buf) - env->buflen);
521 if (len >= (sizeof(env->buf) - env->buflen))
527 static void acpi_device_notify(acpi_handle handle, u32 event, void *data)
529 struct acpi_device *device = data;
531 device->driver->ops.notify(device, event);
534 static acpi_status acpi_device_notify_fixed(void *data)
536 struct acpi_device *device = data;
538 /* Fixed hardware devices have no handles */
539 acpi_device_notify(NULL, ACPI_FIXED_HARDWARE_EVENT, device);
543 static int acpi_device_install_notify_handler(struct acpi_device *device)
547 if (device->device_type == ACPI_BUS_TYPE_POWER_BUTTON)
549 acpi_install_fixed_event_handler(ACPI_EVENT_POWER_BUTTON,
550 acpi_device_notify_fixed,
552 else if (device->device_type == ACPI_BUS_TYPE_SLEEP_BUTTON)
554 acpi_install_fixed_event_handler(ACPI_EVENT_SLEEP_BUTTON,
555 acpi_device_notify_fixed,
558 status = acpi_install_notify_handler(device->handle,
563 if (ACPI_FAILURE(status))
568 static void acpi_device_remove_notify_handler(struct acpi_device *device)
570 if (device->device_type == ACPI_BUS_TYPE_POWER_BUTTON)
571 acpi_remove_fixed_event_handler(ACPI_EVENT_POWER_BUTTON,
572 acpi_device_notify_fixed);
573 else if (device->device_type == ACPI_BUS_TYPE_SLEEP_BUTTON)
574 acpi_remove_fixed_event_handler(ACPI_EVENT_SLEEP_BUTTON,
575 acpi_device_notify_fixed);
577 acpi_remove_notify_handler(device->handle, ACPI_DEVICE_NOTIFY,
581 static int acpi_bus_driver_init(struct acpi_device *, struct acpi_driver *);
582 static int acpi_device_probe(struct device * dev)
584 struct acpi_device *acpi_dev = to_acpi_device(dev);
585 struct acpi_driver *acpi_drv = to_acpi_driver(dev->driver);
588 ret = acpi_bus_driver_init(acpi_dev, acpi_drv);
590 if (acpi_drv->ops.notify) {
591 ret = acpi_device_install_notify_handler(acpi_dev);
593 if (acpi_drv->ops.remove)
594 acpi_drv->ops.remove(acpi_dev,
595 acpi_dev->removal_type);
600 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
601 "Found driver [%s] for device [%s]\n",
602 acpi_drv->name, acpi_dev->pnp.bus_id));
608 static int acpi_device_remove(struct device * dev)
610 struct acpi_device *acpi_dev = to_acpi_device(dev);
611 struct acpi_driver *acpi_drv = acpi_dev->driver;
614 if (acpi_drv->ops.notify)
615 acpi_device_remove_notify_handler(acpi_dev);
616 if (acpi_drv->ops.remove)
617 acpi_drv->ops.remove(acpi_dev, acpi_dev->removal_type);
619 acpi_dev->driver = NULL;
620 acpi_dev->driver_data = NULL;
626 struct bus_type acpi_bus_type = {
628 .match = acpi_bus_match,
629 .probe = acpi_device_probe,
630 .remove = acpi_device_remove,
631 .uevent = acpi_device_uevent,
634 int acpi_device_register(struct acpi_device *device,
635 void (*release)(struct device *))
638 struct acpi_device_bus_id *acpi_device_bus_id, *new_bus_id;
641 if (device->handle) {
644 status = acpi_attach_data(device->handle, acpi_bus_data_handler,
646 if (ACPI_FAILURE(status)) {
647 acpi_handle_err(device->handle,
648 "Unable to attach device data\n");
656 * Link this device to its parent and siblings.
658 INIT_LIST_HEAD(&device->children);
659 INIT_LIST_HEAD(&device->node);
660 INIT_LIST_HEAD(&device->wakeup_list);
661 INIT_LIST_HEAD(&device->physical_node_list);
662 mutex_init(&device->physical_node_lock);
663 INIT_LIST_HEAD(&device->power_dependent);
665 new_bus_id = kzalloc(sizeof(struct acpi_device_bus_id), GFP_KERNEL);
667 pr_err(PREFIX "Memory allocation error\n");
672 mutex_lock(&acpi_device_lock);
674 * Find suitable bus_id and instance number in acpi_bus_id_list
675 * If failed, create one and link it into acpi_bus_id_list
677 list_for_each_entry(acpi_device_bus_id, &acpi_bus_id_list, node) {
678 if (!strcmp(acpi_device_bus_id->bus_id,
679 acpi_device_hid(device))) {
680 acpi_device_bus_id->instance_no++;
687 acpi_device_bus_id = new_bus_id;
688 strcpy(acpi_device_bus_id->bus_id, acpi_device_hid(device));
689 acpi_device_bus_id->instance_no = 0;
690 list_add_tail(&acpi_device_bus_id->node, &acpi_bus_id_list);
692 dev_set_name(&device->dev, "%s:%02x", acpi_device_bus_id->bus_id, acpi_device_bus_id->instance_no);
695 list_add_tail(&device->node, &device->parent->children);
697 if (device->wakeup.flags.valid)
698 list_add_tail(&device->wakeup_list, &acpi_wakeup_device_list);
699 mutex_unlock(&acpi_device_lock);
702 device->dev.parent = &device->parent->dev;
703 device->dev.bus = &acpi_bus_type;
704 device->dev.release = release;
705 result = device_register(&device->dev);
707 dev_err(&device->dev, "Error registering device\n");
711 result = acpi_device_setup_files(device);
713 printk(KERN_ERR PREFIX "Error creating sysfs interface for device %s\n",
714 dev_name(&device->dev));
716 device->removal_type = ACPI_BUS_REMOVAL_NORMAL;
720 mutex_lock(&acpi_device_lock);
722 list_del(&device->node);
723 list_del(&device->wakeup_list);
724 mutex_unlock(&acpi_device_lock);
727 acpi_detach_data(device->handle, acpi_bus_data_handler);
731 static void acpi_device_unregister(struct acpi_device *device)
733 mutex_lock(&acpi_device_lock);
735 list_del(&device->node);
737 list_del(&device->wakeup_list);
738 mutex_unlock(&acpi_device_lock);
740 acpi_detach_data(device->handle, acpi_bus_data_handler);
742 acpi_power_add_remove_device(device, false);
743 acpi_device_remove_files(device);
744 device_unregister(&device->dev);
746 * Drop the reference counts of all power resources the device depends
747 * on and turn off the ones that have no more references.
749 acpi_power_transition(device, ACPI_STATE_D3_COLD);
752 /* --------------------------------------------------------------------------
754 -------------------------------------------------------------------------- */
756 * acpi_bus_driver_init - add a device to a driver
757 * @device: the device to add and initialize
758 * @driver: driver for the device
760 * Used to initialize a device via its device driver. Called whenever a
761 * driver is bound to a device. Invokes the driver's add() ops.
764 acpi_bus_driver_init(struct acpi_device *device, struct acpi_driver *driver)
768 if (!device || !driver)
771 if (!driver->ops.add)
774 result = driver->ops.add(device);
776 device->driver = NULL;
777 device->driver_data = NULL;
781 device->driver = driver;
784 * TBD - Configuration Management: Assign resources to device based
785 * upon possible configuration and currently allocated resources.
788 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
789 "Driver successfully bound to device\n"));
794 * acpi_bus_register_driver - register a driver with the ACPI bus
795 * @driver: driver being registered
797 * Registers a driver with the ACPI bus. Searches the namespace for all
798 * devices that match the driver's criteria and binds. Returns zero for
799 * success or a negative error status for failure.
801 int acpi_bus_register_driver(struct acpi_driver *driver)
807 driver->drv.name = driver->name;
808 driver->drv.bus = &acpi_bus_type;
809 driver->drv.owner = driver->owner;
811 ret = driver_register(&driver->drv);
815 EXPORT_SYMBOL(acpi_bus_register_driver);
818 * acpi_bus_unregister_driver - unregisters a driver with the APIC bus
819 * @driver: driver to unregister
821 * Unregisters a driver with the ACPI bus. Searches the namespace for all
822 * devices that match the driver's criteria and unbinds.
824 void acpi_bus_unregister_driver(struct acpi_driver *driver)
826 driver_unregister(&driver->drv);
829 EXPORT_SYMBOL(acpi_bus_unregister_driver);
831 /* --------------------------------------------------------------------------
833 -------------------------------------------------------------------------- */
834 static struct acpi_device *acpi_bus_get_parent(acpi_handle handle)
838 struct acpi_device *device;
841 * Fixed hardware devices do not appear in the namespace and do not
842 * have handles, but we fabricate acpi_devices for them, so we have
843 * to deal with them specially.
849 status = acpi_get_parent(handle, &handle);
850 if (status == AE_NULL_ENTRY)
852 if (ACPI_FAILURE(status))
855 ret = acpi_bus_get_device(handle, &device);
862 acpi_bus_get_ejd(acpi_handle handle, acpi_handle *ejd)
866 struct acpi_buffer buffer = {ACPI_ALLOCATE_BUFFER, NULL};
867 union acpi_object *obj;
869 status = acpi_get_handle(handle, "_EJD", &tmp);
870 if (ACPI_FAILURE(status))
873 status = acpi_evaluate_object(handle, "_EJD", NULL, &buffer);
874 if (ACPI_SUCCESS(status)) {
875 obj = buffer.pointer;
876 status = acpi_get_handle(ACPI_ROOT_OBJECT, obj->string.pointer,
878 kfree(buffer.pointer);
882 EXPORT_SYMBOL_GPL(acpi_bus_get_ejd);
884 void acpi_bus_data_handler(acpi_handle handle, void *context)
893 acpi_bus_extract_wakeup_device_power_package(acpi_handle handle,
894 struct acpi_device_wakeup *wakeup)
896 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
897 union acpi_object *package = NULL;
898 union acpi_object *element = NULL;
903 return AE_BAD_PARAMETER;
906 status = acpi_evaluate_object(handle, "_PRW", NULL, &buffer);
907 if (ACPI_FAILURE(status)) {
908 ACPI_EXCEPTION((AE_INFO, status, "Evaluating _PRW"));
912 package = (union acpi_object *)buffer.pointer;
914 if (!package || (package->package.count < 2)) {
915 status = AE_BAD_DATA;
919 element = &(package->package.elements[0]);
921 status = AE_BAD_DATA;
924 if (element->type == ACPI_TYPE_PACKAGE) {
925 if ((element->package.count < 2) ||
926 (element->package.elements[0].type !=
927 ACPI_TYPE_LOCAL_REFERENCE)
928 || (element->package.elements[1].type != ACPI_TYPE_INTEGER)) {
929 status = AE_BAD_DATA;
933 element->package.elements[0].reference.handle;
935 (u32) element->package.elements[1].integer.value;
936 } else if (element->type == ACPI_TYPE_INTEGER) {
937 wakeup->gpe_device = NULL;
938 wakeup->gpe_number = element->integer.value;
940 status = AE_BAD_DATA;
944 element = &(package->package.elements[1]);
945 if (element->type != ACPI_TYPE_INTEGER) {
946 status = AE_BAD_DATA;
949 wakeup->sleep_state = element->integer.value;
951 if ((package->package.count - 2) > ACPI_MAX_HANDLES) {
952 status = AE_NO_MEMORY;
955 wakeup->resources.count = package->package.count - 2;
956 for (i = 0; i < wakeup->resources.count; i++) {
957 element = &(package->package.elements[i + 2]);
958 if (element->type != ACPI_TYPE_LOCAL_REFERENCE) {
959 status = AE_BAD_DATA;
963 wakeup->resources.handles[i] = element->reference.handle;
966 acpi_setup_gpe_for_wake(handle, wakeup->gpe_device, wakeup->gpe_number);
969 kfree(buffer.pointer);
974 static void acpi_bus_set_run_wake_flags(struct acpi_device *device)
976 struct acpi_device_id button_device_ids[] = {
983 acpi_event_status event_status;
985 device->wakeup.flags.notifier_present = 0;
987 /* Power button, Lid switch always enable wakeup */
988 if (!acpi_match_device_ids(device, button_device_ids)) {
989 device->wakeup.flags.run_wake = 1;
990 if (!acpi_match_device_ids(device, &button_device_ids[1])) {
991 /* Do not use Lid/sleep button for S5 wakeup */
992 if (device->wakeup.sleep_state == ACPI_STATE_S5)
993 device->wakeup.sleep_state = ACPI_STATE_S4;
995 device_set_wakeup_capable(&device->dev, true);
999 status = acpi_get_gpe_status(device->wakeup.gpe_device,
1000 device->wakeup.gpe_number,
1002 if (status == AE_OK)
1003 device->wakeup.flags.run_wake =
1004 !!(event_status & ACPI_EVENT_FLAG_HANDLE);
1007 static void acpi_bus_get_wakeup_device_flags(struct acpi_device *device)
1010 acpi_status status = 0;
1013 /* Presence of _PRW indicates wake capable */
1014 status = acpi_get_handle(device->handle, "_PRW", &temp);
1015 if (ACPI_FAILURE(status))
1018 status = acpi_bus_extract_wakeup_device_power_package(device->handle,
1020 if (ACPI_FAILURE(status)) {
1021 ACPI_EXCEPTION((AE_INFO, status, "Extracting _PRW package"));
1025 device->wakeup.flags.valid = 1;
1026 device->wakeup.prepare_count = 0;
1027 acpi_bus_set_run_wake_flags(device);
1028 /* Call _PSW/_DSW object to disable its ability to wake the sleeping
1029 * system for the ACPI device with the _PRW object.
1030 * The _PSW object is depreciated in ACPI 3.0 and is replaced by _DSW.
1031 * So it is necessary to call _DSW object first. Only when it is not
1032 * present will the _PSW object used.
1034 psw_error = acpi_device_sleep_wake(device, 0, 0, 0);
1036 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
1037 "error in _DSW or _PSW evaluation\n"));
1040 static void acpi_bus_get_power_flags(struct acpi_device *device)
1042 acpi_status status = 0;
1043 acpi_handle handle = NULL;
1046 /* Presence of _PS0|_PR0 indicates 'power manageable' */
1047 status = acpi_get_handle(device->handle, "_PS0", &handle);
1048 if (ACPI_FAILURE(status)) {
1049 status = acpi_get_handle(device->handle, "_PR0", &handle);
1050 if (ACPI_FAILURE(status))
1054 device->flags.power_manageable = 1;
1057 * Power Management Flags
1059 status = acpi_get_handle(device->handle, "_PSC", &handle);
1060 if (ACPI_SUCCESS(status))
1061 device->power.flags.explicit_get = 1;
1062 status = acpi_get_handle(device->handle, "_IRC", &handle);
1063 if (ACPI_SUCCESS(status))
1064 device->power.flags.inrush_current = 1;
1067 * Enumerate supported power management states
1069 for (i = ACPI_STATE_D0; i <= ACPI_STATE_D3_HOT; i++) {
1070 struct acpi_device_power_state *ps = &device->power.states[i];
1071 char object_name[5] = { '_', 'P', 'R', '0' + i, '\0' };
1072 struct acpi_handle_list resources;
1074 INIT_LIST_HEAD(&ps->resources);
1075 /* Evaluate "_PRx" to se if power resources are referenced */
1076 acpi_evaluate_reference(device->handle, object_name, NULL,
1078 if (resources.count) {
1081 device->power.flags.power_resources = 1;
1082 for (j = 0; j < resources.count; j++) {
1083 acpi_handle rhandle = resources.handles[j];
1085 acpi_add_power_resource(rhandle);
1086 acpi_power_resources_list_add(rhandle,
1091 /* Evaluate "_PSx" to see if we can do explicit sets */
1092 object_name[2] = 'S';
1093 status = acpi_get_handle(device->handle, object_name, &handle);
1094 if (ACPI_SUCCESS(status))
1095 ps->flags.explicit_set = 1;
1098 * State is valid if there are means to put the device into it.
1099 * D3hot is only valid if _PR3 present.
1101 if (resources.count ||
1102 (ps->flags.explicit_set && i < ACPI_STATE_D3_HOT)) {
1103 ps->flags.valid = 1;
1104 ps->flags.os_accessible = 1;
1107 ps->power = -1; /* Unknown - driver assigned */
1108 ps->latency = -1; /* Unknown - driver assigned */
1111 INIT_LIST_HEAD(&device->power.states[ACPI_STATE_D3_COLD].resources);
1113 /* Set defaults for D0 and D3 states (always valid) */
1114 device->power.states[ACPI_STATE_D0].flags.valid = 1;
1115 device->power.states[ACPI_STATE_D0].power = 100;
1116 device->power.states[ACPI_STATE_D3].flags.valid = 1;
1117 device->power.states[ACPI_STATE_D3].power = 0;
1119 /* Set D3cold's explicit_set flag if _PS3 exists. */
1120 if (device->power.states[ACPI_STATE_D3_HOT].flags.explicit_set)
1121 device->power.states[ACPI_STATE_D3_COLD].flags.explicit_set = 1;
1123 /* Presence of _PS3 or _PRx means we can put the device into D3 cold */
1124 if (device->power.states[ACPI_STATE_D3_HOT].flags.explicit_set ||
1125 device->power.flags.power_resources)
1126 device->power.states[ACPI_STATE_D3_COLD].flags.os_accessible = 1;
1128 acpi_bus_init_power(device);
1131 static void acpi_bus_get_flags(struct acpi_device *device)
1133 acpi_status status = AE_OK;
1134 acpi_handle temp = NULL;
1136 /* Presence of _STA indicates 'dynamic_status' */
1137 status = acpi_get_handle(device->handle, "_STA", &temp);
1138 if (ACPI_SUCCESS(status))
1139 device->flags.dynamic_status = 1;
1141 /* Presence of _RMV indicates 'removable' */
1142 status = acpi_get_handle(device->handle, "_RMV", &temp);
1143 if (ACPI_SUCCESS(status))
1144 device->flags.removable = 1;
1146 /* Presence of _EJD|_EJ0 indicates 'ejectable' */
1147 status = acpi_get_handle(device->handle, "_EJD", &temp);
1148 if (ACPI_SUCCESS(status))
1149 device->flags.ejectable = 1;
1151 status = acpi_get_handle(device->handle, "_EJ0", &temp);
1152 if (ACPI_SUCCESS(status))
1153 device->flags.ejectable = 1;
1157 static void acpi_device_get_busid(struct acpi_device *device)
1159 char bus_id[5] = { '?', 0 };
1160 struct acpi_buffer buffer = { sizeof(bus_id), bus_id };
1166 * The device's Bus ID is simply the object name.
1167 * TBD: Shouldn't this value be unique (within the ACPI namespace)?
1169 if (ACPI_IS_ROOT_DEVICE(device)) {
1170 strcpy(device->pnp.bus_id, "ACPI");
1174 switch (device->device_type) {
1175 case ACPI_BUS_TYPE_POWER_BUTTON:
1176 strcpy(device->pnp.bus_id, "PWRF");
1178 case ACPI_BUS_TYPE_SLEEP_BUTTON:
1179 strcpy(device->pnp.bus_id, "SLPF");
1182 acpi_get_name(device->handle, ACPI_SINGLE_NAME, &buffer);
1183 /* Clean up trailing underscores (if any) */
1184 for (i = 3; i > 1; i--) {
1185 if (bus_id[i] == '_')
1190 strcpy(device->pnp.bus_id, bus_id);
1196 * acpi_bay_match - see if a device is an ejectable driver bay
1198 * If an acpi object is ejectable and has one of the ACPI ATA methods defined,
1199 * then we can safely call it an ejectable drive bay
1201 static int acpi_bay_match(struct acpi_device *device){
1205 acpi_handle phandle;
1207 handle = device->handle;
1209 status = acpi_get_handle(handle, "_EJ0", &tmp);
1210 if (ACPI_FAILURE(status))
1213 if ((ACPI_SUCCESS(acpi_get_handle(handle, "_GTF", &tmp))) ||
1214 (ACPI_SUCCESS(acpi_get_handle(handle, "_GTM", &tmp))) ||
1215 (ACPI_SUCCESS(acpi_get_handle(handle, "_STM", &tmp))) ||
1216 (ACPI_SUCCESS(acpi_get_handle(handle, "_SDD", &tmp))))
1219 if (acpi_get_parent(handle, &phandle))
1222 if ((ACPI_SUCCESS(acpi_get_handle(phandle, "_GTF", &tmp))) ||
1223 (ACPI_SUCCESS(acpi_get_handle(phandle, "_GTM", &tmp))) ||
1224 (ACPI_SUCCESS(acpi_get_handle(phandle, "_STM", &tmp))) ||
1225 (ACPI_SUCCESS(acpi_get_handle(phandle, "_SDD", &tmp))))
1232 * acpi_dock_match - see if a device has a _DCK method
1234 static int acpi_dock_match(struct acpi_device *device)
1237 return acpi_get_handle(device->handle, "_DCK", &tmp);
1240 const char *acpi_device_hid(struct acpi_device *device)
1242 struct acpi_hardware_id *hid;
1244 if (list_empty(&device->pnp.ids))
1247 hid = list_first_entry(&device->pnp.ids, struct acpi_hardware_id, list);
1250 EXPORT_SYMBOL(acpi_device_hid);
1252 static void acpi_add_id(struct acpi_device *device, const char *dev_id)
1254 struct acpi_hardware_id *id;
1256 id = kmalloc(sizeof(*id), GFP_KERNEL);
1260 id->id = kstrdup(dev_id, GFP_KERNEL);
1266 list_add_tail(&id->list, &device->pnp.ids);
1270 * Old IBM workstations have a DSDT bug wherein the SMBus object
1271 * lacks the SMBUS01 HID and the methods do not have the necessary "_"
1272 * prefix. Work around this.
1274 static int acpi_ibm_smbus_match(struct acpi_device *device)
1276 acpi_handle h_dummy;
1277 struct acpi_buffer path = {ACPI_ALLOCATE_BUFFER, NULL};
1280 if (!dmi_name_in_vendors("IBM"))
1283 /* Look for SMBS object */
1284 result = acpi_get_name(device->handle, ACPI_SINGLE_NAME, &path);
1288 if (strcmp("SMBS", path.pointer)) {
1293 /* Does it have the necessary (but misnamed) methods? */
1295 if (ACPI_SUCCESS(acpi_get_handle(device->handle, "SBI", &h_dummy)) &&
1296 ACPI_SUCCESS(acpi_get_handle(device->handle, "SBR", &h_dummy)) &&
1297 ACPI_SUCCESS(acpi_get_handle(device->handle, "SBW", &h_dummy)))
1300 kfree(path.pointer);
1304 static void acpi_device_set_id(struct acpi_device *device)
1307 struct acpi_device_info *info;
1308 struct acpi_pnp_device_id_list *cid_list;
1311 switch (device->device_type) {
1312 case ACPI_BUS_TYPE_DEVICE:
1313 if (ACPI_IS_ROOT_DEVICE(device)) {
1314 acpi_add_id(device, ACPI_SYSTEM_HID);
1318 status = acpi_get_object_info(device->handle, &info);
1319 if (ACPI_FAILURE(status)) {
1320 printk(KERN_ERR PREFIX "%s: Error reading device info\n", __func__);
1324 if (info->valid & ACPI_VALID_HID)
1325 acpi_add_id(device, info->hardware_id.string);
1326 if (info->valid & ACPI_VALID_CID) {
1327 cid_list = &info->compatible_id_list;
1328 for (i = 0; i < cid_list->count; i++)
1329 acpi_add_id(device, cid_list->ids[i].string);
1331 if (info->valid & ACPI_VALID_ADR) {
1332 device->pnp.bus_address = info->address;
1333 device->flags.bus_address = 1;
1335 if (info->valid & ACPI_VALID_UID)
1336 device->pnp.unique_id = kstrdup(info->unique_id.string,
1342 * Some devices don't reliably have _HIDs & _CIDs, so add
1343 * synthetic HIDs to make sure drivers can find them.
1345 if (acpi_is_video_device(device))
1346 acpi_add_id(device, ACPI_VIDEO_HID);
1347 else if (ACPI_SUCCESS(acpi_bay_match(device)))
1348 acpi_add_id(device, ACPI_BAY_HID);
1349 else if (ACPI_SUCCESS(acpi_dock_match(device)))
1350 acpi_add_id(device, ACPI_DOCK_HID);
1351 else if (!acpi_ibm_smbus_match(device))
1352 acpi_add_id(device, ACPI_SMBUS_IBM_HID);
1353 else if (list_empty(&device->pnp.ids) &&
1354 ACPI_IS_ROOT_DEVICE(device->parent)) {
1355 acpi_add_id(device, ACPI_BUS_HID); /* \_SB, LNXSYBUS */
1356 strcpy(device->pnp.device_name, ACPI_BUS_DEVICE_NAME);
1357 strcpy(device->pnp.device_class, ACPI_BUS_CLASS);
1361 case ACPI_BUS_TYPE_POWER:
1362 acpi_add_id(device, ACPI_POWER_HID);
1364 case ACPI_BUS_TYPE_PROCESSOR:
1365 acpi_add_id(device, ACPI_PROCESSOR_OBJECT_HID);
1367 case ACPI_BUS_TYPE_THERMAL:
1368 acpi_add_id(device, ACPI_THERMAL_HID);
1370 case ACPI_BUS_TYPE_POWER_BUTTON:
1371 acpi_add_id(device, ACPI_BUTTON_HID_POWERF);
1373 case ACPI_BUS_TYPE_SLEEP_BUTTON:
1374 acpi_add_id(device, ACPI_BUTTON_HID_SLEEPF);
1379 void acpi_init_device_object(struct acpi_device *device, acpi_handle handle,
1380 int type, unsigned long long sta)
1382 INIT_LIST_HEAD(&device->pnp.ids);
1383 device->device_type = type;
1384 device->handle = handle;
1385 device->parent = acpi_bus_get_parent(handle);
1386 STRUCT_TO_INT(device->status) = sta;
1387 acpi_device_get_busid(device);
1388 acpi_device_set_id(device);
1389 acpi_bus_get_flags(device);
1392 static int acpi_add_single_object(struct acpi_device **child,
1393 acpi_handle handle, int type,
1394 unsigned long long sta, bool match_driver)
1397 struct acpi_device *device;
1398 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
1400 device = kzalloc(sizeof(struct acpi_device), GFP_KERNEL);
1402 printk(KERN_ERR PREFIX "Memory allocation error\n");
1406 acpi_init_device_object(device, handle, type, sta);
1407 acpi_bus_get_power_flags(device);
1408 acpi_bus_get_wakeup_device_flags(device);
1410 device->flags.match_driver = match_driver;
1411 result = acpi_device_register(device, acpi_device_release);
1413 acpi_device_release(&device->dev);
1417 acpi_power_add_remove_device(device, true);
1418 acpi_get_name(handle, ACPI_FULL_PATHNAME, &buffer);
1419 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Added %s [%s] parent %s\n",
1420 dev_name(&device->dev), (char *) buffer.pointer,
1421 device->parent ? dev_name(&device->parent->dev) : "(null)"));
1422 kfree(buffer.pointer);
1427 static int acpi_bus_type_and_status(acpi_handle handle, int *type,
1428 unsigned long long *sta)
1431 acpi_object_type acpi_type;
1433 status = acpi_get_type(handle, &acpi_type);
1434 if (ACPI_FAILURE(status))
1437 switch (acpi_type) {
1438 case ACPI_TYPE_ANY: /* for ACPI_ROOT_OBJECT */
1439 case ACPI_TYPE_DEVICE:
1440 *type = ACPI_BUS_TYPE_DEVICE;
1441 status = acpi_bus_get_status_handle(handle, sta);
1442 if (ACPI_FAILURE(status))
1445 case ACPI_TYPE_PROCESSOR:
1446 *type = ACPI_BUS_TYPE_PROCESSOR;
1447 status = acpi_bus_get_status_handle(handle, sta);
1448 if (ACPI_FAILURE(status))
1451 case ACPI_TYPE_THERMAL:
1452 *type = ACPI_BUS_TYPE_THERMAL;
1453 *sta = ACPI_STA_DEFAULT;
1455 case ACPI_TYPE_POWER:
1456 *type = ACPI_BUS_TYPE_POWER;
1457 *sta = ACPI_STA_DEFAULT;
1466 static acpi_status acpi_bus_check_add(acpi_handle handle, u32 lvl_not_used,
1467 void *not_used, void **return_value)
1469 struct acpi_device *device = NULL;
1471 unsigned long long sta;
1475 acpi_bus_get_device(handle, &device);
1479 result = acpi_bus_type_and_status(handle, &type, &sta);
1483 if (type == ACPI_BUS_TYPE_POWER) {
1484 acpi_add_power_resource(handle);
1488 if (!(sta & ACPI_STA_DEVICE_PRESENT) &&
1489 !(sta & ACPI_STA_DEVICE_FUNCTIONING)) {
1490 struct acpi_device_wakeup wakeup;
1493 status = acpi_get_handle(handle, "_PRW", &temp);
1494 if (ACPI_SUCCESS(status))
1495 acpi_bus_extract_wakeup_device_power_package(handle,
1497 return AE_CTRL_DEPTH;
1500 acpi_add_single_object(&device, handle, type, sta, false);
1502 return AE_CTRL_DEPTH;
1504 device->flags.match_driver = true;
1508 *return_value = device;
1513 static acpi_status acpi_bus_device_attach(acpi_handle handle, u32 lvl_not_used,
1514 void *not_used, void **ret_not_used)
1516 acpi_status status = AE_OK;
1517 struct acpi_device *device;
1518 unsigned long long sta_not_used;
1522 * Ignore errors ignored by acpi_bus_check_add() to avoid terminating
1523 * namespace walks prematurely.
1525 if (acpi_bus_type_and_status(handle, &type_not_used, &sta_not_used))
1528 if (acpi_bus_get_device(handle, &device))
1529 return AE_CTRL_DEPTH;
1531 if (!acpi_match_device_ids(device, acpi_platform_device_ids)) {
1532 /* This is a known good platform device. */
1533 acpi_create_platform_device(device);
1534 } else if (device_attach(&device->dev) < 0) {
1535 status = AE_CTRL_DEPTH;
1540 static int acpi_bus_scan(acpi_handle handle)
1542 void *device = NULL;
1544 if (ACPI_SUCCESS(acpi_bus_check_add(handle, 0, NULL, &device)))
1545 acpi_walk_namespace(ACPI_TYPE_ANY, handle, ACPI_UINT32_MAX,
1546 acpi_bus_check_add, NULL, NULL, &device);
1551 if (ACPI_SUCCESS(acpi_bus_device_attach(handle, 0, NULL, NULL)))
1552 acpi_walk_namespace(ACPI_TYPE_ANY, handle, ACPI_UINT32_MAX,
1553 acpi_bus_device_attach, NULL, NULL, NULL);
1559 * acpi_bus_add - Add ACPI device node objects in a given namespace scope.
1560 * @handle: Root of the namespace scope to scan.
1562 * Scan a given ACPI tree (probably recently hot-plugged) and create and add
1565 * If no devices were found, -ENODEV is returned, but it does not mean that
1566 * there has been a real error. There just have been no suitable ACPI objects
1567 * in the table trunk from which the kernel could create a device and add an
1568 * appropriate driver.
1570 int acpi_bus_add(acpi_handle handle)
1574 err = acpi_bus_scan(handle);
1578 acpi_update_all_gpes();
1581 EXPORT_SYMBOL(acpi_bus_add);
1583 static acpi_status acpi_bus_device_detach(acpi_handle handle, u32 lvl_not_used,
1584 void *not_used, void **ret_not_used)
1586 struct acpi_device *device = NULL;
1588 if (!acpi_bus_get_device(handle, &device)) {
1589 device->removal_type = ACPI_BUS_REMOVAL_EJECT;
1590 device_release_driver(&device->dev);
1595 static acpi_status acpi_bus_remove(acpi_handle handle, u32 lvl_not_used,
1596 void *not_used, void **ret_not_used)
1598 struct acpi_device *device = NULL;
1600 if (!acpi_bus_get_device(handle, &device))
1601 acpi_device_unregister(device);
1606 int acpi_bus_trim(struct acpi_device *start)
1609 * Execute acpi_bus_device_detach() as a post-order callback to detach
1610 * all ACPI drivers from the device nodes being removed.
1612 acpi_walk_namespace(ACPI_TYPE_ANY, start->handle, ACPI_UINT32_MAX, NULL,
1613 acpi_bus_device_detach, NULL, NULL);
1614 acpi_bus_device_detach(start->handle, 0, NULL, NULL);
1616 * Execute acpi_bus_remove() as a post-order callback to remove device
1617 * nodes in the given namespace scope.
1619 acpi_walk_namespace(ACPI_TYPE_ANY, start->handle, ACPI_UINT32_MAX, NULL,
1620 acpi_bus_remove, NULL, NULL);
1621 acpi_bus_remove(start->handle, 0, NULL, NULL);
1624 EXPORT_SYMBOL_GPL(acpi_bus_trim);
1626 static int acpi_bus_scan_fixed(void)
1629 struct acpi_device *device = NULL;
1632 * Enumerate all fixed-feature devices.
1634 if ((acpi_gbl_FADT.flags & ACPI_FADT_POWER_BUTTON) == 0) {
1635 result = acpi_add_single_object(&device, NULL,
1636 ACPI_BUS_TYPE_POWER_BUTTON,
1637 ACPI_STA_DEFAULT, true);
1638 device_init_wakeup(&device->dev, true);
1641 if ((acpi_gbl_FADT.flags & ACPI_FADT_SLEEP_BUTTON) == 0) {
1642 result = acpi_add_single_object(&device, NULL,
1643 ACPI_BUS_TYPE_SLEEP_BUTTON,
1644 ACPI_STA_DEFAULT, true);
1650 int __init acpi_scan_init(void)
1654 result = bus_register(&acpi_bus_type);
1656 /* We don't want to quit even if we failed to add suspend/resume */
1657 printk(KERN_ERR PREFIX "Could not register bus type\n");
1660 acpi_pci_root_init();
1663 * Enumerate devices in the ACPI namespace.
1665 result = acpi_bus_scan(ACPI_ROOT_OBJECT);
1669 result = acpi_bus_get_device(ACPI_ROOT_OBJECT, &acpi_root);
1671 result = acpi_bus_scan_fixed();
1674 acpi_device_unregister(acpi_root);
1676 acpi_update_all_gpes();