2 * acpi_bus.c - ACPI Bus Driver ($Revision: 80 $)
4 * Copyright (C) 2001, 2002 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com>
6 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or (at
11 * your option) any later version.
13 * This program is distributed in the hope that it will be useful, but
14 * WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * General Public License for more details.
18 * You should have received a copy of the GNU General Public License along
19 * with this program; if not, write to the Free Software Foundation, Inc.,
20 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
22 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
25 #include <linux/module.h>
26 #include <linux/init.h>
27 #include <linux/ioport.h>
28 #include <linux/list.h>
29 #include <linux/sched.h>
31 #include <linux/pm_legacy.h>
32 #include <linux/device.h>
33 #include <linux/proc_fs.h>
35 #include <asm/mpspec.h>
37 #include <acpi/acpi_bus.h>
38 #include <acpi/acpi_drivers.h>
40 #define _COMPONENT ACPI_BUS_COMPONENT
41 ACPI_MODULE_NAME("acpi_bus")
43 extern void __init acpi_pic_sci_set_trigger(unsigned int irq, u16 trigger);
46 struct fadt_descriptor acpi_fadt;
47 EXPORT_SYMBOL(acpi_fadt);
49 struct acpi_device *acpi_root;
50 struct proc_dir_entry *acpi_root_dir;
51 EXPORT_SYMBOL(acpi_root_dir);
53 #define STRUCT_TO_INT(s) (*((int*)&s))
55 /* --------------------------------------------------------------------------
57 -------------------------------------------------------------------------- */
59 int acpi_bus_get_device(acpi_handle handle, struct acpi_device **device)
61 acpi_status status = AE_OK;
63 ACPI_FUNCTION_TRACE("acpi_bus_get_device");
66 return_VALUE(-EINVAL);
68 /* TBD: Support fixed-feature devices */
70 status = acpi_get_data(handle, acpi_bus_data_handler, (void **)device);
71 if (ACPI_FAILURE(status) || !*device) {
72 ACPI_EXCEPTION((AE_INFO, status, "No context for object [%p]", handle));
73 return_VALUE(-ENODEV);
79 EXPORT_SYMBOL(acpi_bus_get_device);
81 int acpi_bus_get_status(struct acpi_device *device)
83 acpi_status status = AE_OK;
84 unsigned long sta = 0;
86 ACPI_FUNCTION_TRACE("acpi_bus_get_status");
89 return_VALUE(-EINVAL);
92 * Evaluate _STA if present.
94 if (device->flags.dynamic_status) {
96 acpi_evaluate_integer(device->handle, "_STA", NULL, &sta);
97 if (ACPI_FAILURE(status))
98 return_VALUE(-ENODEV);
99 STRUCT_TO_INT(device->status) = (int)sta;
103 * Otherwise we assume the status of our parent (unless we don't
104 * have one, in which case status is implied).
106 else if (device->parent)
107 device->status = device->parent->status;
109 STRUCT_TO_INT(device->status) = 0x0F;
111 if (device->status.functional && !device->status.present) {
112 printk(KERN_WARNING PREFIX "Device [%s] status [%08x]: "
113 "functional but not present; setting present\n",
114 device->pnp.bus_id, (u32) STRUCT_TO_INT(device->status));
115 device->status.present = 1;
118 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Device [%s] status [%08x]\n",
120 (u32) STRUCT_TO_INT(device->status)));
125 EXPORT_SYMBOL(acpi_bus_get_status);
127 /* --------------------------------------------------------------------------
129 -------------------------------------------------------------------------- */
131 int acpi_bus_get_power(acpi_handle handle, int *state)
134 acpi_status status = 0;
135 struct acpi_device *device = NULL;
136 unsigned long psc = 0;
138 ACPI_FUNCTION_TRACE("acpi_bus_get_power");
140 result = acpi_bus_get_device(handle, &device);
142 return_VALUE(result);
144 *state = ACPI_STATE_UNKNOWN;
146 if (!device->flags.power_manageable) {
147 /* TBD: Non-recursive algorithm for walking up hierarchy */
149 *state = device->parent->power.state;
151 *state = ACPI_STATE_D0;
154 * Get the device's power state either directly (via _PSC) or
155 * indirectly (via power resources).
157 if (device->power.flags.explicit_get) {
158 status = acpi_evaluate_integer(device->handle, "_PSC",
160 if (ACPI_FAILURE(status))
161 return_VALUE(-ENODEV);
162 device->power.state = (int)psc;
163 } else if (device->power.flags.power_resources) {
164 result = acpi_power_get_inferred_state(device);
166 return_VALUE(result);
169 *state = device->power.state;
172 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Device [%s] power state is D%d\n",
173 device->pnp.bus_id, device->power.state));
178 EXPORT_SYMBOL(acpi_bus_get_power);
180 int acpi_bus_set_power(acpi_handle handle, int state)
183 acpi_status status = AE_OK;
184 struct acpi_device *device = NULL;
185 char object_name[5] = { '_', 'P', 'S', '0' + state, '\0' };
187 ACPI_FUNCTION_TRACE("acpi_bus_set_power");
189 result = acpi_bus_get_device(handle, &device);
191 return_VALUE(result);
193 if ((state < ACPI_STATE_D0) || (state > ACPI_STATE_D3))
194 return_VALUE(-EINVAL);
196 /* Make sure this is a valid target state */
198 if (!device->flags.power_manageable) {
199 printk(KERN_DEBUG "Device `[%s]is not power manageable",
201 return_VALUE(-ENODEV);
204 * Get device's current power state if it's unknown
205 * This means device power state isn't initialized or previous setting failed
207 if (!device->flags.force_power_state) {
208 if (device->power.state == ACPI_STATE_UNKNOWN)
209 acpi_bus_get_power(device->handle, &device->power.state);
210 if (state == device->power.state) {
211 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Device is already at D%d\n",
216 if (!device->power.states[state].flags.valid) {
217 printk(KERN_WARNING PREFIX "Device does not support D%d\n", state);
218 return_VALUE(-ENODEV);
220 if (device->parent && (state < device->parent->power.state)) {
221 printk(KERN_WARNING PREFIX
222 "Cannot set device to a higher-powered"
223 " state than parent\n");
224 return_VALUE(-ENODEV);
230 * On transitions to a high-powered state we first apply power (via
231 * power resources) then evalute _PSx. Conversly for transitions to
232 * a lower-powered state.
234 if (state < device->power.state) {
235 if (device->power.flags.power_resources) {
236 result = acpi_power_transition(device, state);
240 if (device->power.states[state].flags.explicit_set) {
241 status = acpi_evaluate_object(device->handle,
242 object_name, NULL, NULL);
243 if (ACPI_FAILURE(status)) {
249 if (device->power.states[state].flags.explicit_set) {
250 status = acpi_evaluate_object(device->handle,
251 object_name, NULL, NULL);
252 if (ACPI_FAILURE(status)) {
257 if (device->power.flags.power_resources) {
258 result = acpi_power_transition(device, state);
266 printk(KERN_WARNING PREFIX
267 "Transitioning device [%s] to D%d\n",
268 device->pnp.bus_id, state);
270 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
271 "Device [%s] transitioned to D%d\n",
272 device->pnp.bus_id, state));
274 return_VALUE(result);
277 EXPORT_SYMBOL(acpi_bus_set_power);
279 /* --------------------------------------------------------------------------
281 -------------------------------------------------------------------------- */
283 static DEFINE_SPINLOCK(acpi_bus_event_lock);
285 LIST_HEAD(acpi_bus_event_list);
286 DECLARE_WAIT_QUEUE_HEAD(acpi_bus_event_queue);
288 extern int event_is_open;
290 int acpi_bus_generate_event(struct acpi_device *device, u8 type, int data)
292 struct acpi_bus_event *event = NULL;
293 unsigned long flags = 0;
295 ACPI_FUNCTION_TRACE("acpi_bus_generate_event");
298 return_VALUE(-EINVAL);
300 /* drop event on the floor if no one's listening */
304 event = kmalloc(sizeof(struct acpi_bus_event), GFP_ATOMIC);
306 return_VALUE(-ENOMEM);
308 strcpy(event->device_class, device->pnp.device_class);
309 strcpy(event->bus_id, device->pnp.bus_id);
313 spin_lock_irqsave(&acpi_bus_event_lock, flags);
314 list_add_tail(&event->node, &acpi_bus_event_list);
315 spin_unlock_irqrestore(&acpi_bus_event_lock, flags);
317 wake_up_interruptible(&acpi_bus_event_queue);
322 EXPORT_SYMBOL(acpi_bus_generate_event);
324 int acpi_bus_receive_event(struct acpi_bus_event *event)
326 unsigned long flags = 0;
327 struct acpi_bus_event *entry = NULL;
329 DECLARE_WAITQUEUE(wait, current);
331 ACPI_FUNCTION_TRACE("acpi_bus_receive_event");
334 return_VALUE(-EINVAL);
336 if (list_empty(&acpi_bus_event_list)) {
338 set_current_state(TASK_INTERRUPTIBLE);
339 add_wait_queue(&acpi_bus_event_queue, &wait);
341 if (list_empty(&acpi_bus_event_list))
344 remove_wait_queue(&acpi_bus_event_queue, &wait);
345 set_current_state(TASK_RUNNING);
347 if (signal_pending(current))
348 return_VALUE(-ERESTARTSYS);
351 spin_lock_irqsave(&acpi_bus_event_lock, flags);
353 list_entry(acpi_bus_event_list.next, struct acpi_bus_event, node);
355 list_del(&entry->node);
356 spin_unlock_irqrestore(&acpi_bus_event_lock, flags);
359 return_VALUE(-ENODEV);
361 memcpy(event, entry, sizeof(struct acpi_bus_event));
368 EXPORT_SYMBOL(acpi_bus_receive_event);
370 /* --------------------------------------------------------------------------
371 Notification Handling
372 -------------------------------------------------------------------------- */
375 acpi_bus_check_device(struct acpi_device *device, int *status_changed)
377 acpi_status status = 0;
378 struct acpi_device_status old_status;
380 ACPI_FUNCTION_TRACE("acpi_bus_check_device");
383 return_VALUE(-EINVAL);
388 old_status = device->status;
391 * Make sure this device's parent is present before we go about
392 * messing with the device.
394 if (device->parent && !device->parent->status.present) {
395 device->status = device->parent->status;
396 if (STRUCT_TO_INT(old_status) != STRUCT_TO_INT(device->status)) {
403 status = acpi_bus_get_status(device);
404 if (ACPI_FAILURE(status))
405 return_VALUE(-ENODEV);
407 if (STRUCT_TO_INT(old_status) == STRUCT_TO_INT(device->status))
414 * Device Insertion/Removal
416 if ((device->status.present) && !(old_status.present)) {
417 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Device insertion detected\n"));
418 /* TBD: Handle device insertion */
419 } else if (!(device->status.present) && (old_status.present)) {
420 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Device removal detected\n"));
421 /* TBD: Handle device removal */
427 static int acpi_bus_check_scope(struct acpi_device *device)
430 int status_changed = 0;
432 ACPI_FUNCTION_TRACE("acpi_bus_check_scope");
435 return_VALUE(-EINVAL);
438 result = acpi_bus_check_device(device, &status_changed);
440 return_VALUE(result);
446 * TBD: Enumerate child devices within this device's scope and
447 * run acpi_bus_check_device()'s on them.
456 * Callback for all 'system-level' device notifications (values 0x00-0x7F).
458 static void acpi_bus_notify(acpi_handle handle, u32 type, void *data)
461 struct acpi_device *device = NULL;
463 ACPI_FUNCTION_TRACE("acpi_bus_notify");
465 if (acpi_bus_get_device(handle, &device))
470 case ACPI_NOTIFY_BUS_CHECK:
471 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
472 "Received BUS CHECK notification for device [%s]\n",
473 device->pnp.bus_id));
474 result = acpi_bus_check_scope(device);
476 * TBD: We'll need to outsource certain events to non-ACPI
477 * drivers via the device manager (device.c).
481 case ACPI_NOTIFY_DEVICE_CHECK:
482 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
483 "Received DEVICE CHECK notification for device [%s]\n",
484 device->pnp.bus_id));
485 result = acpi_bus_check_device(device, NULL);
487 * TBD: We'll need to outsource certain events to non-ACPI
488 * drivers via the device manager (device.c).
492 case ACPI_NOTIFY_DEVICE_WAKE:
493 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
494 "Received DEVICE WAKE notification for device [%s]\n",
495 device->pnp.bus_id));
499 case ACPI_NOTIFY_EJECT_REQUEST:
500 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
501 "Received EJECT REQUEST notification for device [%s]\n",
502 device->pnp.bus_id));
506 case ACPI_NOTIFY_DEVICE_CHECK_LIGHT:
507 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
508 "Received DEVICE CHECK LIGHT notification for device [%s]\n",
509 device->pnp.bus_id));
510 /* TBD: Exactly what does 'light' mean? */
513 case ACPI_NOTIFY_FREQUENCY_MISMATCH:
514 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
515 "Received FREQUENCY MISMATCH notification for device [%s]\n",
516 device->pnp.bus_id));
520 case ACPI_NOTIFY_BUS_MODE_MISMATCH:
521 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
522 "Received BUS MODE MISMATCH notification for device [%s]\n",
523 device->pnp.bus_id));
527 case ACPI_NOTIFY_POWER_FAULT:
528 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
529 "Received POWER FAULT notification for device [%s]\n",
530 device->pnp.bus_id));
535 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
536 "Received unknown/unsupported notification [%08x]\n",
544 /* --------------------------------------------------------------------------
545 Initialization/Cleanup
546 -------------------------------------------------------------------------- */
548 static int __init acpi_bus_init_irq(void)
550 acpi_status status = AE_OK;
551 union acpi_object arg = { ACPI_TYPE_INTEGER };
552 struct acpi_object_list arg_list = { 1, &arg };
553 char *message = NULL;
555 ACPI_FUNCTION_TRACE("acpi_bus_init_irq");
558 * Let the system know what interrupt model we are using by
559 * evaluating the \_PIC object, if exists.
562 switch (acpi_irq_model) {
563 case ACPI_IRQ_MODEL_PIC:
566 case ACPI_IRQ_MODEL_IOAPIC:
569 case ACPI_IRQ_MODEL_IOSAPIC:
573 printk(KERN_WARNING PREFIX "Unknown interrupt routing model\n");
574 return_VALUE(-ENODEV);
577 printk(KERN_INFO PREFIX "Using %s for interrupt routing\n", message);
579 arg.integer.value = acpi_irq_model;
581 status = acpi_evaluate_object(NULL, "\\_PIC", &arg_list, NULL);
582 if (ACPI_FAILURE(status) && (status != AE_NOT_FOUND)) {
583 ACPI_EXCEPTION((AE_INFO, status, "Evaluating _PIC"));
584 return_VALUE(-ENODEV);
590 void __init acpi_early_init(void)
592 acpi_status status = AE_OK;
593 struct acpi_buffer buffer = { sizeof(acpi_fadt), &acpi_fadt };
595 ACPI_FUNCTION_TRACE("acpi_early_init");
600 printk(KERN_INFO PREFIX "Core revision %08x\n", ACPI_CA_VERSION);
602 /* enable workarounds, unless strict ACPI spec. compliance */
604 acpi_gbl_enable_interpreter_slack = TRUE;
606 status = acpi_initialize_subsystem();
607 if (ACPI_FAILURE(status)) {
608 printk(KERN_ERR PREFIX
609 "Unable to initialize the ACPI Interpreter\n");
613 status = acpi_load_tables();
614 if (ACPI_FAILURE(status)) {
615 printk(KERN_ERR PREFIX
616 "Unable to load the System Description Tables\n");
621 * Get a separate copy of the FADT for use by other drivers.
623 status = acpi_get_table(ACPI_TABLE_ID_FADT, 1, &buffer);
624 if (ACPI_FAILURE(status)) {
625 printk(KERN_ERR PREFIX "Unable to get the FADT\n");
630 extern acpi_interrupt_flags acpi_sci_flags;
632 /* compatible (0) means level (3) */
633 if (acpi_sci_flags.trigger == 0)
634 acpi_sci_flags.trigger = 3;
636 /* Set PIC-mode SCI trigger type */
637 acpi_pic_sci_set_trigger(acpi_fadt.sci_int,
638 acpi_sci_flags.trigger);
640 extern int acpi_sci_override_gsi;
642 * now that acpi_fadt is initialized,
643 * update it with result from INT_SRC_OVR parsing
645 acpi_fadt.sci_int = acpi_sci_override_gsi;
650 acpi_enable_subsystem(~
651 (ACPI_NO_HARDWARE_INIT |
652 ACPI_NO_ACPI_ENABLE));
653 if (ACPI_FAILURE(status)) {
654 printk(KERN_ERR PREFIX "Unable to enable ACPI\n");
665 static int __init acpi_bus_init(void)
668 acpi_status status = AE_OK;
669 extern acpi_status acpi_os_initialize1(void);
671 ACPI_FUNCTION_TRACE("acpi_bus_init");
673 status = acpi_os_initialize1();
676 acpi_enable_subsystem(ACPI_NO_HARDWARE_INIT | ACPI_NO_ACPI_ENABLE);
677 if (ACPI_FAILURE(status)) {
678 printk(KERN_ERR PREFIX
679 "Unable to start the ACPI Interpreter\n");
683 if (ACPI_FAILURE(status)) {
684 printk(KERN_ERR PREFIX
685 "Unable to initialize ACPI OS objects\n");
688 #ifdef CONFIG_ACPI_EC
690 * ACPI 2.0 requires the EC driver to be loaded and work before
691 * the EC device is found in the namespace (i.e. before acpi_initialize_objects()
694 * This is accomplished by looking for the ECDT table, and getting
695 * the EC parameters out of that.
697 status = acpi_ec_ecdt_probe();
698 /* Ignore result. Not having an ECDT is not fatal. */
701 status = acpi_initialize_objects(ACPI_FULL_INITIALIZATION);
702 if (ACPI_FAILURE(status)) {
703 printk(KERN_ERR PREFIX "Unable to initialize ACPI objects\n");
707 printk(KERN_INFO PREFIX "Interpreter enabled\n");
710 * Get the system interrupt model and evaluate \_PIC.
712 result = acpi_bus_init_irq();
717 * Register the for all standard device notifications.
720 acpi_install_notify_handler(ACPI_ROOT_OBJECT, ACPI_SYSTEM_NOTIFY,
721 &acpi_bus_notify, NULL);
722 if (ACPI_FAILURE(status)) {
723 printk(KERN_ERR PREFIX
724 "Unable to register for device notifications\n");
729 * Create the top ACPI proc directory
731 acpi_root_dir = proc_mkdir(ACPI_BUS_FILE_ROOT, NULL);
735 /* Mimic structured exception handling */
738 return_VALUE(-ENODEV);
741 decl_subsys(acpi, NULL, NULL);
743 static int __init acpi_init(void)
747 ACPI_FUNCTION_TRACE("acpi_init");
750 printk(KERN_INFO PREFIX "Interpreter disabled.\n");
751 return_VALUE(-ENODEV);
754 firmware_register(&acpi_subsys);
756 result = acpi_bus_init();
759 #ifdef CONFIG_PM_LEGACY
763 printk(KERN_INFO PREFIX
764 "APM is already active, exiting\n");
772 return_VALUE(result);
775 subsys_initcall(acpi_init);