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/kernel.h>
8 #include <linux/acpi.h>
9 #include <linux/signal.h>
10 #include <linux/kthread.h>
12 #include <acpi/acpi_drivers.h>
13 #include <acpi/acinterp.h> /* for acpi_ex_eisa_id_to_string() */
15 #define _COMPONENT ACPI_BUS_COMPONENT
16 ACPI_MODULE_NAME("scan");
17 #define STRUCT_TO_INT(s) (*((int*)&s))
18 extern struct acpi_device *acpi_root;
20 #define ACPI_BUS_CLASS "system_bus"
21 #define ACPI_BUS_HID "LNXSYBUS"
22 #define ACPI_BUS_DEVICE_NAME "System Bus"
24 static LIST_HEAD(acpi_device_list);
25 static LIST_HEAD(acpi_bus_id_list);
26 DEFINE_SPINLOCK(acpi_device_lock);
27 LIST_HEAD(acpi_wakeup_device_list);
29 struct acpi_device_bus_id{
31 unsigned int instance_no;
32 struct list_head node;
36 * Creates hid/cid(s) string needed for modalias and uevent
37 * e.g. on a device with hid:IBM0001 and cid:ACPI0001 you get:
38 * char *modalias: "acpi:IBM0001:ACPI0001"
40 static int create_modalias(struct acpi_device *acpi_dev, char *modalias,
46 if (!acpi_dev->flags.hardware_id && !acpi_dev->flags.compatible_ids)
49 len = snprintf(modalias, size, "acpi:");
52 if (acpi_dev->flags.hardware_id) {
53 count = snprintf(&modalias[len], size, "%s:",
54 acpi_dev->pnp.hardware_id);
55 if (count < 0 || count >= size)
61 if (acpi_dev->flags.compatible_ids) {
62 struct acpi_compatible_id_list *cid_list;
65 cid_list = acpi_dev->pnp.cid_list;
66 for (i = 0; i < cid_list->count; i++) {
67 count = snprintf(&modalias[len], size, "%s:",
68 cid_list->id[i].value);
69 if (count < 0 || count >= size) {
70 printk(KERN_ERR PREFIX "%s cid[%i] exceeds event buffer size",
71 acpi_dev->pnp.device_name, i);
84 acpi_device_modalias_show(struct device *dev, struct device_attribute *attr, char *buf) {
85 struct acpi_device *acpi_dev = to_acpi_device(dev);
88 /* Device has no HID and no CID or string is >1024 */
89 len = create_modalias(acpi_dev, buf, 1024);
95 static DEVICE_ATTR(modalias, 0444, acpi_device_modalias_show, NULL);
97 static int acpi_bus_hot_remove_device(void *context)
99 struct acpi_device *device;
100 acpi_handle handle = context;
101 struct acpi_object_list arg_list;
102 union acpi_object arg;
103 acpi_status status = AE_OK;
105 if (acpi_bus_get_device(handle, &device))
111 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
112 "Hot-removing device %s...\n", device->dev.bus_id));
115 if (acpi_bus_trim(device, 1)) {
116 printk(KERN_ERR PREFIX
117 "Removing device failed\n");
121 /* power off device */
122 status = acpi_evaluate_object(handle, "_PS3", NULL, NULL);
123 if (ACPI_FAILURE(status) && status != AE_NOT_FOUND)
124 printk(KERN_WARNING PREFIX
125 "Power-off device failed\n");
127 if (device->flags.lockable) {
129 arg_list.pointer = &arg;
130 arg.type = ACPI_TYPE_INTEGER;
131 arg.integer.value = 0;
132 acpi_evaluate_object(handle, "_LCK", &arg_list, NULL);
136 arg_list.pointer = &arg;
137 arg.type = ACPI_TYPE_INTEGER;
138 arg.integer.value = 1;
143 status = acpi_evaluate_object(handle, "_EJ0", &arg_list, NULL);
144 if (ACPI_FAILURE(status))
151 acpi_eject_store(struct device *d, struct device_attribute *attr,
152 const char *buf, size_t count)
156 acpi_object_type type = 0;
157 struct acpi_device *acpi_device = to_acpi_device(d);
158 struct task_struct *task;
160 if ((!count) || (buf[0] != '1')) {
164 if (acpi_device->driver == NULL) {
169 status = acpi_get_type(acpi_device->handle, &type);
170 if (ACPI_FAILURE(status) || (!acpi_device->flags.ejectable)) {
175 /* remove the device in another thread to fix the deadlock issue */
176 task = kthread_run(acpi_bus_hot_remove_device,
177 acpi_device->handle, "acpi_hot_remove_device");
184 static DEVICE_ATTR(eject, 0200, NULL, acpi_eject_store);
187 acpi_device_hid_show(struct device *dev, struct device_attribute *attr, char *buf) {
188 struct acpi_device *acpi_dev = to_acpi_device(dev);
190 return sprintf(buf, "%s\n", acpi_dev->pnp.hardware_id);
192 static DEVICE_ATTR(hid, 0444, acpi_device_hid_show, NULL);
195 acpi_device_path_show(struct device *dev, struct device_attribute *attr, char *buf) {
196 struct acpi_device *acpi_dev = to_acpi_device(dev);
197 struct acpi_buffer path = {ACPI_ALLOCATE_BUFFER, NULL};
200 result = acpi_get_name(acpi_dev->handle, ACPI_FULL_PATHNAME, &path);
204 result = sprintf(buf, "%s\n", (char*)path.pointer);
209 static DEVICE_ATTR(path, 0444, acpi_device_path_show, NULL);
211 static int acpi_device_setup_files(struct acpi_device *dev)
218 * Devices gotten from FADT don't have a "path" attribute
221 result = device_create_file(&dev->dev, &dev_attr_path);
226 if(dev->flags.hardware_id) {
227 result = device_create_file(&dev->dev, &dev_attr_hid);
232 if (dev->flags.hardware_id || dev->flags.compatible_ids){
233 result = device_create_file(&dev->dev, &dev_attr_modalias);
239 * If device has _EJ0, 'eject' file is created that is used to trigger
240 * hot-removal function from userland.
242 status = acpi_get_handle(dev->handle, "_EJ0", &temp);
243 if (ACPI_SUCCESS(status))
244 result = device_create_file(&dev->dev, &dev_attr_eject);
249 static void acpi_device_remove_files(struct acpi_device *dev)
255 * If device has _EJ0, 'eject' file is created that is used to trigger
256 * hot-removal function from userland.
258 status = acpi_get_handle(dev->handle, "_EJ0", &temp);
259 if (ACPI_SUCCESS(status))
260 device_remove_file(&dev->dev, &dev_attr_eject);
262 if (dev->flags.hardware_id || dev->flags.compatible_ids)
263 device_remove_file(&dev->dev, &dev_attr_modalias);
265 if(dev->flags.hardware_id)
266 device_remove_file(&dev->dev, &dev_attr_hid);
268 device_remove_file(&dev->dev, &dev_attr_path);
270 /* --------------------------------------------------------------------------
272 -------------------------------------------------------------------------- */
274 int acpi_match_device_ids(struct acpi_device *device,
275 const struct acpi_device_id *ids)
277 const struct acpi_device_id *id;
280 * If the device is not present, it is unnecessary to load device
283 if (!device->status.present)
286 if (device->flags.hardware_id) {
287 for (id = ids; id->id[0]; id++) {
288 if (!strcmp((char*)id->id, device->pnp.hardware_id))
293 if (device->flags.compatible_ids) {
294 struct acpi_compatible_id_list *cid_list = device->pnp.cid_list;
297 for (id = ids; id->id[0]; id++) {
298 /* compare multiple _CID entries against driver ids */
299 for (i = 0; i < cid_list->count; i++) {
300 if (!strcmp((char*)id->id,
301 cid_list->id[i].value))
309 EXPORT_SYMBOL(acpi_match_device_ids);
311 static void acpi_device_release(struct device *dev)
313 struct acpi_device *acpi_dev = to_acpi_device(dev);
315 kfree(acpi_dev->pnp.cid_list);
319 static int acpi_device_suspend(struct device *dev, pm_message_t state)
321 struct acpi_device *acpi_dev = to_acpi_device(dev);
322 struct acpi_driver *acpi_drv = acpi_dev->driver;
324 if (acpi_drv && acpi_drv->ops.suspend)
325 return acpi_drv->ops.suspend(acpi_dev, state);
329 static int acpi_device_resume(struct device *dev)
331 struct acpi_device *acpi_dev = to_acpi_device(dev);
332 struct acpi_driver *acpi_drv = acpi_dev->driver;
334 if (acpi_drv && acpi_drv->ops.resume)
335 return acpi_drv->ops.resume(acpi_dev);
339 static int acpi_bus_match(struct device *dev, struct device_driver *drv)
341 struct acpi_device *acpi_dev = to_acpi_device(dev);
342 struct acpi_driver *acpi_drv = to_acpi_driver(drv);
344 return !acpi_match_device_ids(acpi_dev, acpi_drv->ids);
347 static int acpi_device_uevent(struct device *dev, struct kobj_uevent_env *env)
349 struct acpi_device *acpi_dev = to_acpi_device(dev);
352 if (add_uevent_var(env, "MODALIAS="))
354 len = create_modalias(acpi_dev, &env->buf[env->buflen - 1],
355 sizeof(env->buf) - env->buflen);
356 if (len >= (sizeof(env->buf) - env->buflen))
362 static int acpi_bus_driver_init(struct acpi_device *, struct acpi_driver *);
363 static int acpi_start_single_object(struct acpi_device *);
364 static int acpi_device_probe(struct device * dev)
366 struct acpi_device *acpi_dev = to_acpi_device(dev);
367 struct acpi_driver *acpi_drv = to_acpi_driver(dev->driver);
370 ret = acpi_bus_driver_init(acpi_dev, acpi_drv);
372 if (acpi_dev->bus_ops.acpi_op_start)
373 acpi_start_single_object(acpi_dev);
374 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
375 "Found driver [%s] for device [%s]\n",
376 acpi_drv->name, acpi_dev->pnp.bus_id));
382 static int acpi_device_remove(struct device * dev)
384 struct acpi_device *acpi_dev = to_acpi_device(dev);
385 struct acpi_driver *acpi_drv = acpi_dev->driver;
388 if (acpi_drv->ops.stop)
389 acpi_drv->ops.stop(acpi_dev, acpi_dev->removal_type);
390 if (acpi_drv->ops.remove)
391 acpi_drv->ops.remove(acpi_dev, acpi_dev->removal_type);
393 acpi_dev->driver = NULL;
394 acpi_dev->driver_data = NULL;
400 static void acpi_device_shutdown(struct device *dev)
402 struct acpi_device *acpi_dev = to_acpi_device(dev);
403 struct acpi_driver *acpi_drv = acpi_dev->driver;
405 if (acpi_drv && acpi_drv->ops.shutdown)
406 acpi_drv->ops.shutdown(acpi_dev);
411 struct bus_type acpi_bus_type = {
413 .suspend = acpi_device_suspend,
414 .resume = acpi_device_resume,
415 .shutdown = acpi_device_shutdown,
416 .match = acpi_bus_match,
417 .probe = acpi_device_probe,
418 .remove = acpi_device_remove,
419 .uevent = acpi_device_uevent,
422 static int acpi_device_register(struct acpi_device *device,
423 struct acpi_device *parent)
426 struct acpi_device_bus_id *acpi_device_bus_id, *new_bus_id;
431 * Link this device to its parent and siblings.
433 INIT_LIST_HEAD(&device->children);
434 INIT_LIST_HEAD(&device->node);
435 INIT_LIST_HEAD(&device->g_list);
436 INIT_LIST_HEAD(&device->wakeup_list);
438 new_bus_id = kzalloc(sizeof(struct acpi_device_bus_id), GFP_KERNEL);
440 printk(KERN_ERR PREFIX "Memory allocation error\n");
444 spin_lock(&acpi_device_lock);
446 * Find suitable bus_id and instance number in acpi_bus_id_list
447 * If failed, create one and link it into acpi_bus_id_list
449 list_for_each_entry(acpi_device_bus_id, &acpi_bus_id_list, node) {
450 if(!strcmp(acpi_device_bus_id->bus_id, device->flags.hardware_id? device->pnp.hardware_id : "device")) {
451 acpi_device_bus_id->instance_no ++;
458 acpi_device_bus_id = new_bus_id;
459 strcpy(acpi_device_bus_id->bus_id, device->flags.hardware_id ? device->pnp.hardware_id : "device");
460 acpi_device_bus_id->instance_no = 0;
461 list_add_tail(&acpi_device_bus_id->node, &acpi_bus_id_list);
463 sprintf(device->dev.bus_id, "%s:%02x", acpi_device_bus_id->bus_id, acpi_device_bus_id->instance_no);
465 if (device->parent) {
466 list_add_tail(&device->node, &device->parent->children);
467 list_add_tail(&device->g_list, &device->parent->g_list);
469 list_add_tail(&device->g_list, &acpi_device_list);
470 if (device->wakeup.flags.valid)
471 list_add_tail(&device->wakeup_list, &acpi_wakeup_device_list);
472 spin_unlock(&acpi_device_lock);
475 device->dev.parent = &parent->dev;
476 device->dev.bus = &acpi_bus_type;
477 device_initialize(&device->dev);
478 device->dev.release = &acpi_device_release;
479 result = device_add(&device->dev);
481 dev_err(&device->dev, "Error adding device\n");
485 result = acpi_device_setup_files(device);
487 printk(KERN_ERR PREFIX "Error creating sysfs interface for device %s\n", device->dev.bus_id);
489 device->removal_type = ACPI_BUS_REMOVAL_NORMAL;
492 spin_lock(&acpi_device_lock);
493 if (device->parent) {
494 list_del(&device->node);
495 list_del(&device->g_list);
497 list_del(&device->g_list);
498 list_del(&device->wakeup_list);
499 spin_unlock(&acpi_device_lock);
503 static void acpi_device_unregister(struct acpi_device *device, int type)
505 spin_lock(&acpi_device_lock);
506 if (device->parent) {
507 list_del(&device->node);
508 list_del(&device->g_list);
510 list_del(&device->g_list);
512 list_del(&device->wakeup_list);
513 spin_unlock(&acpi_device_lock);
515 acpi_detach_data(device->handle, acpi_bus_data_handler);
517 acpi_device_remove_files(device);
518 device_unregister(&device->dev);
521 /* --------------------------------------------------------------------------
523 -------------------------------------------------------------------------- */
525 * acpi_bus_driver_init - add a device to a driver
526 * @device: the device to add and initialize
527 * @driver: driver for the device
529 * Used to initialize a device via its device driver. Called whenever a
530 * driver is bound to a device. Invokes the driver's add() ops.
533 acpi_bus_driver_init(struct acpi_device *device, struct acpi_driver *driver)
538 if (!device || !driver)
541 if (!driver->ops.add)
544 result = driver->ops.add(device);
546 device->driver = NULL;
547 device->driver_data = NULL;
551 device->driver = driver;
554 * TBD - Configuration Management: Assign resources to device based
555 * upon possible configuration and currently allocated resources.
558 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
559 "Driver successfully bound to device\n"));
563 static int acpi_start_single_object(struct acpi_device *device)
566 struct acpi_driver *driver;
569 if (!(driver = device->driver))
572 if (driver->ops.start) {
573 result = driver->ops.start(device);
574 if (result && driver->ops.remove)
575 driver->ops.remove(device, ACPI_BUS_REMOVAL_NORMAL);
582 * acpi_bus_register_driver - register a driver with the ACPI bus
583 * @driver: driver being registered
585 * Registers a driver with the ACPI bus. Searches the namespace for all
586 * devices that match the driver's criteria and binds. Returns zero for
587 * success or a negative error status for failure.
589 int acpi_bus_register_driver(struct acpi_driver *driver)
595 driver->drv.name = driver->name;
596 driver->drv.bus = &acpi_bus_type;
597 driver->drv.owner = driver->owner;
599 ret = driver_register(&driver->drv);
603 EXPORT_SYMBOL(acpi_bus_register_driver);
606 * acpi_bus_unregister_driver - unregisters a driver with the APIC bus
607 * @driver: driver to unregister
609 * Unregisters a driver with the ACPI bus. Searches the namespace for all
610 * devices that match the driver's criteria and unbinds.
612 void acpi_bus_unregister_driver(struct acpi_driver *driver)
614 driver_unregister(&driver->drv);
617 EXPORT_SYMBOL(acpi_bus_unregister_driver);
619 /* --------------------------------------------------------------------------
621 -------------------------------------------------------------------------- */
623 acpi_bus_get_ejd(acpi_handle handle, acpi_handle *ejd)
627 struct acpi_buffer buffer = {ACPI_ALLOCATE_BUFFER, NULL};
628 union acpi_object *obj;
630 status = acpi_get_handle(handle, "_EJD", &tmp);
631 if (ACPI_FAILURE(status))
634 status = acpi_evaluate_object(handle, "_EJD", NULL, &buffer);
635 if (ACPI_SUCCESS(status)) {
636 obj = buffer.pointer;
637 status = acpi_get_handle(ACPI_ROOT_OBJECT, obj->string.pointer,
639 kfree(buffer.pointer);
643 EXPORT_SYMBOL_GPL(acpi_bus_get_ejd);
645 void acpi_bus_data_handler(acpi_handle handle, u32 function, void *context)
653 static int acpi_bus_get_perf_flags(struct acpi_device *device)
655 device->performance.state = ACPI_STATE_UNKNOWN;
660 acpi_bus_extract_wakeup_device_power_package(struct acpi_device *device,
661 union acpi_object *package)
664 union acpi_object *element = NULL;
666 if (!device || !package || (package->package.count < 2))
667 return AE_BAD_PARAMETER;
669 element = &(package->package.elements[0]);
671 return AE_BAD_PARAMETER;
672 if (element->type == ACPI_TYPE_PACKAGE) {
673 if ((element->package.count < 2) ||
674 (element->package.elements[0].type !=
675 ACPI_TYPE_LOCAL_REFERENCE)
676 || (element->package.elements[1].type != ACPI_TYPE_INTEGER))
678 device->wakeup.gpe_device =
679 element->package.elements[0].reference.handle;
680 device->wakeup.gpe_number =
681 (u32) element->package.elements[1].integer.value;
682 } else if (element->type == ACPI_TYPE_INTEGER) {
683 device->wakeup.gpe_number = element->integer.value;
687 element = &(package->package.elements[1]);
688 if (element->type != ACPI_TYPE_INTEGER) {
691 device->wakeup.sleep_state = element->integer.value;
693 if ((package->package.count - 2) > ACPI_MAX_HANDLES) {
696 device->wakeup.resources.count = package->package.count - 2;
697 for (i = 0; i < device->wakeup.resources.count; i++) {
698 element = &(package->package.elements[i + 2]);
699 if (element->type != ACPI_TYPE_LOCAL_REFERENCE)
702 device->wakeup.resources.handles[i] = element->reference.handle;
708 static int acpi_bus_get_wakeup_device_flags(struct acpi_device *device)
710 acpi_status status = 0;
711 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
712 union acpi_object *package = NULL;
715 struct acpi_device_id button_device_ids[] = {
723 status = acpi_evaluate_object(device->handle, "_PRW", NULL, &buffer);
724 if (ACPI_FAILURE(status)) {
725 ACPI_EXCEPTION((AE_INFO, status, "Evaluating _PRW"));
729 package = (union acpi_object *)buffer.pointer;
730 status = acpi_bus_extract_wakeup_device_power_package(device, package);
731 if (ACPI_FAILURE(status)) {
732 ACPI_EXCEPTION((AE_INFO, status, "Extracting _PRW package"));
736 kfree(buffer.pointer);
738 device->wakeup.flags.valid = 1;
739 /* Call _PSW/_DSW object to disable its ability to wake the sleeping
740 * system for the ACPI device with the _PRW object.
741 * The _PSW object is depreciated in ACPI 3.0 and is replaced by _DSW.
742 * So it is necessary to call _DSW object first. Only when it is not
743 * present will the _PSW object used.
745 psw_error = acpi_device_sleep_wake(device, 0, 0, 0);
747 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
748 "error in _DSW or _PSW evaluation\n"));
750 /* Power button, Lid switch always enable wakeup */
751 if (!acpi_match_device_ids(device, button_device_ids))
752 device->wakeup.flags.run_wake = 1;
755 * Don't set Power button GPE as run_wake
756 * if Fixed Power button is used
758 if (!strcmp(device->pnp.hardware_id, "PNP0C0C") &&
759 !(acpi_gbl_FADT.flags & ACPI_FADT_POWER_BUTTON)) {
760 device->wakeup.flags.run_wake = 0;
761 device->wakeup.flags.valid = 0;
765 if (ACPI_FAILURE(status))
766 device->flags.wake_capable = 0;
770 static int acpi_bus_get_power_flags(struct acpi_device *device)
772 acpi_status status = 0;
773 acpi_handle handle = NULL;
778 * Power Management Flags
780 status = acpi_get_handle(device->handle, "_PSC", &handle);
781 if (ACPI_SUCCESS(status))
782 device->power.flags.explicit_get = 1;
783 status = acpi_get_handle(device->handle, "_IRC", &handle);
784 if (ACPI_SUCCESS(status))
785 device->power.flags.inrush_current = 1;
788 * Enumerate supported power management states
790 for (i = ACPI_STATE_D0; i <= ACPI_STATE_D3; i++) {
791 struct acpi_device_power_state *ps = &device->power.states[i];
792 char object_name[5] = { '_', 'P', 'R', '0' + i, '\0' };
794 /* Evaluate "_PRx" to se if power resources are referenced */
795 acpi_evaluate_reference(device->handle, object_name, NULL,
797 if (ps->resources.count) {
798 device->power.flags.power_resources = 1;
802 /* Evaluate "_PSx" to see if we can do explicit sets */
803 object_name[2] = 'S';
804 status = acpi_get_handle(device->handle, object_name, &handle);
805 if (ACPI_SUCCESS(status)) {
806 ps->flags.explicit_set = 1;
810 /* State is valid if we have some power control */
811 if (ps->resources.count || ps->flags.explicit_set)
814 ps->power = -1; /* Unknown - driver assigned */
815 ps->latency = -1; /* Unknown - driver assigned */
818 /* Set defaults for D0 and D3 states (always valid) */
819 device->power.states[ACPI_STATE_D0].flags.valid = 1;
820 device->power.states[ACPI_STATE_D0].power = 100;
821 device->power.states[ACPI_STATE_D3].flags.valid = 1;
822 device->power.states[ACPI_STATE_D3].power = 0;
824 /* TBD: System wake support and resource requirements. */
826 device->power.state = ACPI_STATE_UNKNOWN;
827 acpi_bus_get_power(device->handle, &(device->power.state));
832 static int acpi_bus_get_flags(struct acpi_device *device)
834 acpi_status status = AE_OK;
835 acpi_handle temp = NULL;
838 /* Presence of _STA indicates 'dynamic_status' */
839 status = acpi_get_handle(device->handle, "_STA", &temp);
840 if (ACPI_SUCCESS(status))
841 device->flags.dynamic_status = 1;
843 /* Presence of _CID indicates 'compatible_ids' */
844 status = acpi_get_handle(device->handle, "_CID", &temp);
845 if (ACPI_SUCCESS(status))
846 device->flags.compatible_ids = 1;
848 /* Presence of _RMV indicates 'removable' */
849 status = acpi_get_handle(device->handle, "_RMV", &temp);
850 if (ACPI_SUCCESS(status))
851 device->flags.removable = 1;
853 /* Presence of _EJD|_EJ0 indicates 'ejectable' */
854 status = acpi_get_handle(device->handle, "_EJD", &temp);
855 if (ACPI_SUCCESS(status))
856 device->flags.ejectable = 1;
858 status = acpi_get_handle(device->handle, "_EJ0", &temp);
859 if (ACPI_SUCCESS(status))
860 device->flags.ejectable = 1;
863 /* Presence of _LCK indicates 'lockable' */
864 status = acpi_get_handle(device->handle, "_LCK", &temp);
865 if (ACPI_SUCCESS(status))
866 device->flags.lockable = 1;
868 /* Presence of _PS0|_PR0 indicates 'power manageable' */
869 status = acpi_get_handle(device->handle, "_PS0", &temp);
870 if (ACPI_FAILURE(status))
871 status = acpi_get_handle(device->handle, "_PR0", &temp);
872 if (ACPI_SUCCESS(status))
873 device->flags.power_manageable = 1;
875 /* Presence of _PRW indicates wake capable */
876 status = acpi_get_handle(device->handle, "_PRW", &temp);
877 if (ACPI_SUCCESS(status))
878 device->flags.wake_capable = 1;
880 /* TBD: Performance management */
885 static void acpi_device_get_busid(struct acpi_device *device,
886 acpi_handle handle, int type)
888 char bus_id[5] = { '?', 0 };
889 struct acpi_buffer buffer = { sizeof(bus_id), bus_id };
895 * The device's Bus ID is simply the object name.
896 * TBD: Shouldn't this value be unique (within the ACPI namespace)?
899 case ACPI_BUS_TYPE_SYSTEM:
900 strcpy(device->pnp.bus_id, "ACPI");
902 case ACPI_BUS_TYPE_POWER_BUTTON:
903 strcpy(device->pnp.bus_id, "PWRF");
905 case ACPI_BUS_TYPE_SLEEP_BUTTON:
906 strcpy(device->pnp.bus_id, "SLPF");
909 acpi_get_name(handle, ACPI_SINGLE_NAME, &buffer);
910 /* Clean up trailing underscores (if any) */
911 for (i = 3; i > 1; i--) {
912 if (bus_id[i] == '_')
917 strcpy(device->pnp.bus_id, bus_id);
923 acpi_video_bus_match(struct acpi_device *device)
930 /* Since there is no HID, CID for ACPI Video drivers, we have
931 * to check well known required nodes for each feature we support.
934 /* Does this device able to support video switching ? */
935 if (ACPI_SUCCESS(acpi_get_handle(device->handle, "_DOD", &h_dummy)) &&
936 ACPI_SUCCESS(acpi_get_handle(device->handle, "_DOS", &h_dummy)))
939 /* Does this device able to retrieve a video ROM ? */
940 if (ACPI_SUCCESS(acpi_get_handle(device->handle, "_ROM", &h_dummy)))
943 /* Does this device able to configure which video head to be POSTed ? */
944 if (ACPI_SUCCESS(acpi_get_handle(device->handle, "_VPO", &h_dummy)) &&
945 ACPI_SUCCESS(acpi_get_handle(device->handle, "_GPD", &h_dummy)) &&
946 ACPI_SUCCESS(acpi_get_handle(device->handle, "_SPD", &h_dummy)))
953 * acpi_bay_match - see if a device is an ejectable driver bay
955 * If an acpi object is ejectable and has one of the ACPI ATA methods defined,
956 * then we can safely call it an ejectable drive bay
958 static int acpi_bay_match(struct acpi_device *device){
964 handle = device->handle;
966 status = acpi_get_handle(handle, "_EJ0", &tmp);
967 if (ACPI_FAILURE(status))
970 if ((ACPI_SUCCESS(acpi_get_handle(handle, "_GTF", &tmp))) ||
971 (ACPI_SUCCESS(acpi_get_handle(handle, "_GTM", &tmp))) ||
972 (ACPI_SUCCESS(acpi_get_handle(handle, "_STM", &tmp))) ||
973 (ACPI_SUCCESS(acpi_get_handle(handle, "_SDD", &tmp))))
976 if (acpi_get_parent(handle, &phandle))
979 if ((ACPI_SUCCESS(acpi_get_handle(phandle, "_GTF", &tmp))) ||
980 (ACPI_SUCCESS(acpi_get_handle(phandle, "_GTM", &tmp))) ||
981 (ACPI_SUCCESS(acpi_get_handle(phandle, "_STM", &tmp))) ||
982 (ACPI_SUCCESS(acpi_get_handle(phandle, "_SDD", &tmp))))
989 * acpi_dock_match - see if a device has a _DCK method
991 static int acpi_dock_match(struct acpi_device *device)
994 return acpi_get_handle(device->handle, "_DCK", &tmp);
997 static void acpi_device_set_id(struct acpi_device *device,
998 struct acpi_device *parent, acpi_handle handle,
1001 struct acpi_device_info *info;
1002 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
1005 struct acpi_compatible_id_list *cid_list = NULL;
1006 const char *cid_add = NULL;
1010 case ACPI_BUS_TYPE_DEVICE:
1011 status = acpi_get_object_info(handle, &buffer);
1012 if (ACPI_FAILURE(status)) {
1013 printk(KERN_ERR PREFIX "%s: Error reading device info\n", __func__);
1017 info = buffer.pointer;
1018 if (info->valid & ACPI_VALID_HID)
1019 hid = info->hardware_id.value;
1020 if (info->valid & ACPI_VALID_UID)
1021 uid = info->unique_id.value;
1022 if (info->valid & ACPI_VALID_CID)
1023 cid_list = &info->compatibility_id;
1024 if (info->valid & ACPI_VALID_ADR) {
1025 device->pnp.bus_address = info->address;
1026 device->flags.bus_address = 1;
1029 /* If we have a video/bay/dock device, add our selfdefined
1030 HID to the CID list. Like that the video/bay/dock drivers
1031 will get autoloaded and the device might still match
1032 against another driver.
1034 if (ACPI_SUCCESS(acpi_video_bus_match(device)))
1035 cid_add = ACPI_VIDEO_HID;
1036 else if (ACPI_SUCCESS(acpi_bay_match(device)))
1037 cid_add = ACPI_BAY_HID;
1038 else if (ACPI_SUCCESS(acpi_dock_match(device)))
1039 cid_add = ACPI_DOCK_HID;
1042 case ACPI_BUS_TYPE_POWER:
1043 hid = ACPI_POWER_HID;
1045 case ACPI_BUS_TYPE_PROCESSOR:
1046 hid = ACPI_PROCESSOR_HID;
1048 case ACPI_BUS_TYPE_SYSTEM:
1049 hid = ACPI_SYSTEM_HID;
1051 case ACPI_BUS_TYPE_THERMAL:
1052 hid = ACPI_THERMAL_HID;
1054 case ACPI_BUS_TYPE_POWER_BUTTON:
1055 hid = ACPI_BUTTON_HID_POWERF;
1057 case ACPI_BUS_TYPE_SLEEP_BUTTON:
1058 hid = ACPI_BUTTON_HID_SLEEPF;
1065 * Fix for the system root bus device -- the only root-level device.
1067 if (((acpi_handle)parent == ACPI_ROOT_OBJECT) && (type == ACPI_BUS_TYPE_DEVICE)) {
1069 strcpy(device->pnp.device_name, ACPI_BUS_DEVICE_NAME);
1070 strcpy(device->pnp.device_class, ACPI_BUS_CLASS);
1074 strcpy(device->pnp.hardware_id, hid);
1075 device->flags.hardware_id = 1;
1078 strcpy(device->pnp.unique_id, uid);
1079 device->flags.unique_id = 1;
1081 if (cid_list || cid_add) {
1082 struct acpi_compatible_id_list *list;
1087 size = cid_list->size;
1088 } else if (cid_add) {
1089 size = sizeof(struct acpi_compatible_id_list);
1090 cid_list = ACPI_ALLOCATE_ZEROED((acpi_size) size);
1092 printk(KERN_ERR "Memory allocation error\n");
1093 kfree(buffer.pointer);
1096 cid_list->count = 0;
1097 cid_list->size = size;
1101 size += sizeof(struct acpi_compatible_id);
1102 list = kmalloc(size, GFP_KERNEL);
1106 memcpy(list, cid_list, cid_list->size);
1107 count = cid_list->count;
1110 strncpy(list->id[count].value, cid_add,
1111 ACPI_MAX_CID_LENGTH);
1113 device->flags.compatible_ids = 1;
1116 list->count = count;
1117 device->pnp.cid_list = list;
1119 printk(KERN_ERR PREFIX "Memory allocation error\n");
1122 kfree(buffer.pointer);
1125 static int acpi_device_set_context(struct acpi_device *device, int type)
1127 acpi_status status = AE_OK;
1132 * Attach this 'struct acpi_device' to the ACPI object. This makes
1133 * resolutions from handle->device very efficient. Note that we need
1134 * to be careful with fixed-feature devices as they all attach to the
1137 if (type != ACPI_BUS_TYPE_POWER_BUTTON &&
1138 type != ACPI_BUS_TYPE_SLEEP_BUTTON) {
1139 status = acpi_attach_data(device->handle,
1140 acpi_bus_data_handler, device);
1142 if (ACPI_FAILURE(status)) {
1143 printk(KERN_ERR PREFIX "Error attaching device data\n");
1150 static int acpi_bus_remove(struct acpi_device *dev, int rmdevice)
1155 dev->removal_type = ACPI_BUS_REMOVAL_EJECT;
1156 device_release_driver(&dev->dev);
1162 * unbind _ADR-Based Devices when hot removal
1164 if (dev->flags.bus_address) {
1165 if ((dev->parent) && (dev->parent->ops.unbind))
1166 dev->parent->ops.unbind(dev);
1168 acpi_device_unregister(dev, ACPI_BUS_REMOVAL_EJECT);
1174 acpi_add_single_object(struct acpi_device **child,
1175 struct acpi_device *parent, acpi_handle handle, int type,
1176 struct acpi_bus_ops *ops)
1179 struct acpi_device *device = NULL;
1185 device = kzalloc(sizeof(struct acpi_device), GFP_KERNEL);
1187 printk(KERN_ERR PREFIX "Memory allocation error\n");
1191 device->handle = handle;
1192 device->parent = parent;
1193 device->bus_ops = *ops; /* workround for not call .start */
1196 acpi_device_get_busid(device, handle, type);
1201 * Get prior to calling acpi_bus_get_status() so we know whether
1202 * or not _STA is present. Note that we only look for object
1203 * handles -- cannot evaluate objects until we know the device is
1204 * present and properly initialized.
1206 result = acpi_bus_get_flags(device);
1213 * See if the device is present. We always assume that non-Device
1214 * and non-Processor objects (e.g. thermal zones, power resources,
1215 * etc.) are present, functioning, etc. (at least when parent object
1216 * is present). Note that _STA has a different meaning for some
1217 * objects (e.g. power resources) so we need to be careful how we use
1221 case ACPI_BUS_TYPE_PROCESSOR:
1222 case ACPI_BUS_TYPE_DEVICE:
1223 result = acpi_bus_get_status(device);
1224 if (ACPI_FAILURE(result)) {
1229 * When the device is neither present nor functional, the
1230 * device should not be added to Linux ACPI device tree.
1231 * When the status of the device is not present but functinal,
1232 * it should be added to Linux ACPI tree. For example : bay
1233 * device , dock device.
1234 * In such conditions it is unncessary to check whether it is
1235 * bay device or dock device.
1237 if (!device->status.present && !device->status.functional) {
1243 STRUCT_TO_INT(device->status) =
1244 ACPI_STA_DEVICE_PRESENT | ACPI_STA_DEVICE_ENABLED |
1245 ACPI_STA_DEVICE_UI | ACPI_STA_DEVICE_FUNCTIONING;
1252 * TBD: Synch with Core's enumeration/initialization process.
1256 * Hardware ID, Unique ID, & Bus Address
1257 * -------------------------------------
1259 acpi_device_set_id(device, parent, handle, type);
1262 * The ACPI device is attached to acpi handle before getting
1263 * the power/wakeup/peformance flags. Otherwise OS can't get
1264 * the corresponding ACPI device by the acpi handle in the course
1265 * of getting the power/wakeup/performance flags.
1267 result = acpi_device_set_context(device, type);
1275 if (device->flags.power_manageable) {
1276 result = acpi_bus_get_power_flags(device);
1282 * Wakeup device management
1283 *-----------------------
1285 if (device->flags.wake_capable) {
1286 result = acpi_bus_get_wakeup_device_flags(device);
1292 * Performance Management
1293 * ----------------------
1295 if (device->flags.performance_manageable) {
1296 result = acpi_bus_get_perf_flags(device);
1302 result = acpi_device_register(device, parent);
1305 * Bind _ADR-Based Devices when hot add
1307 if (device->flags.bus_address) {
1308 if (device->parent && device->parent->ops.bind)
1309 device->parent->ops.bind(device);
1316 kfree(device->pnp.cid_list);
1323 static int acpi_bus_scan(struct acpi_device *start, struct acpi_bus_ops *ops)
1325 acpi_status status = AE_OK;
1326 struct acpi_device *parent = NULL;
1327 struct acpi_device *child = NULL;
1328 acpi_handle phandle = NULL;
1329 acpi_handle chandle = NULL;
1330 acpi_object_type type = 0;
1338 phandle = start->handle;
1341 * Parse through the ACPI namespace, identify all 'devices', and
1342 * create a new 'struct acpi_device' for each.
1344 while ((level > 0) && parent) {
1346 status = acpi_get_next_object(ACPI_TYPE_ANY, phandle,
1350 * If this scope is exhausted then move our way back up.
1352 if (ACPI_FAILURE(status)) {
1355 acpi_get_parent(phandle, &phandle);
1357 parent = parent->parent;
1361 status = acpi_get_type(chandle, &type);
1362 if (ACPI_FAILURE(status))
1366 * If this is a scope object then parse it (depth-first).
1368 if (type == ACPI_TYPE_LOCAL_SCOPE) {
1376 * We're only interested in objects that we consider 'devices'.
1379 case ACPI_TYPE_DEVICE:
1380 type = ACPI_BUS_TYPE_DEVICE;
1382 case ACPI_TYPE_PROCESSOR:
1383 type = ACPI_BUS_TYPE_PROCESSOR;
1385 case ACPI_TYPE_THERMAL:
1386 type = ACPI_BUS_TYPE_THERMAL;
1388 case ACPI_TYPE_POWER:
1389 type = ACPI_BUS_TYPE_POWER;
1395 if (ops->acpi_op_add)
1396 status = acpi_add_single_object(&child, parent,
1397 chandle, type, ops);
1399 status = acpi_bus_get_device(chandle, &child);
1401 if (ACPI_FAILURE(status))
1404 if (ops->acpi_op_start && !(ops->acpi_op_add)) {
1405 status = acpi_start_single_object(child);
1406 if (ACPI_FAILURE(status))
1411 * If the device is present, enabled, and functioning then
1412 * parse its scope (depth-first). Note that we need to
1413 * represent absent devices to facilitate PnP notifications
1414 * -- but only the subtree head (not all of its children,
1415 * which will be enumerated when the parent is inserted).
1417 * TBD: Need notifications and other detection mechanisms
1418 * in place before we can fully implement this.
1421 * When the device is not present but functional, it is also
1422 * necessary to scan the children of this device.
1424 if (child->status.present || (!child->status.present &&
1425 child->status.functional)) {
1426 status = acpi_get_next_object(ACPI_TYPE_ANY, chandle,
1428 if (ACPI_SUCCESS(status)) {
1441 acpi_bus_add(struct acpi_device **child,
1442 struct acpi_device *parent, acpi_handle handle, int type)
1445 struct acpi_bus_ops ops;
1447 memset(&ops, 0, sizeof(ops));
1448 ops.acpi_op_add = 1;
1450 result = acpi_add_single_object(child, parent, handle, type, &ops);
1452 result = acpi_bus_scan(*child, &ops);
1457 EXPORT_SYMBOL(acpi_bus_add);
1459 int acpi_bus_start(struct acpi_device *device)
1462 struct acpi_bus_ops ops;
1468 result = acpi_start_single_object(device);
1470 memset(&ops, 0, sizeof(ops));
1471 ops.acpi_op_start = 1;
1472 result = acpi_bus_scan(device, &ops);
1477 EXPORT_SYMBOL(acpi_bus_start);
1479 int acpi_bus_trim(struct acpi_device *start, int rmdevice)
1482 struct acpi_device *parent, *child;
1483 acpi_handle phandle, chandle;
1484 acpi_object_type type;
1489 phandle = start->handle;
1490 child = chandle = NULL;
1492 while ((level > 0) && parent && (!err)) {
1493 status = acpi_get_next_object(ACPI_TYPE_ANY, phandle,
1497 * If this scope is exhausted then move our way back up.
1499 if (ACPI_FAILURE(status)) {
1502 acpi_get_parent(phandle, &phandle);
1504 parent = parent->parent;
1507 err = acpi_bus_remove(child, rmdevice);
1509 err = acpi_bus_remove(child, 1);
1514 status = acpi_get_type(chandle, &type);
1515 if (ACPI_FAILURE(status)) {
1519 * If there is a device corresponding to chandle then
1520 * parse it (depth-first).
1522 if (acpi_bus_get_device(chandle, &child) == 0) {
1532 EXPORT_SYMBOL_GPL(acpi_bus_trim);
1535 static int acpi_bus_scan_fixed(struct acpi_device *root)
1538 struct acpi_device *device = NULL;
1539 struct acpi_bus_ops ops;
1544 memset(&ops, 0, sizeof(ops));
1545 ops.acpi_op_add = 1;
1546 ops.acpi_op_start = 1;
1549 * Enumerate all fixed-feature devices.
1551 if ((acpi_gbl_FADT.flags & ACPI_FADT_POWER_BUTTON) == 0) {
1552 result = acpi_add_single_object(&device, acpi_root,
1554 ACPI_BUS_TYPE_POWER_BUTTON,
1558 if ((acpi_gbl_FADT.flags & ACPI_FADT_SLEEP_BUTTON) == 0) {
1559 result = acpi_add_single_object(&device, acpi_root,
1561 ACPI_BUS_TYPE_SLEEP_BUTTON,
1569 static int __init acpi_scan_init(void)
1572 struct acpi_bus_ops ops;
1578 memset(&ops, 0, sizeof(ops));
1579 ops.acpi_op_add = 1;
1580 ops.acpi_op_start = 1;
1582 result = bus_register(&acpi_bus_type);
1584 /* We don't want to quit even if we failed to add suspend/resume */
1585 printk(KERN_ERR PREFIX "Could not register bus type\n");
1589 * Create the root device in the bus's device tree
1591 result = acpi_add_single_object(&acpi_root, NULL, ACPI_ROOT_OBJECT,
1592 ACPI_BUS_TYPE_SYSTEM, &ops);
1597 * Enumerate devices in the ACPI namespace.
1599 result = acpi_bus_scan_fixed(acpi_root);
1602 result = acpi_bus_scan(acpi_root, &ops);
1605 acpi_device_unregister(acpi_root, ACPI_BUS_REMOVAL_NORMAL);
1611 subsys_initcall(acpi_scan_init);