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/device.h>
32 #include <linux/proc_fs.h>
34 #include <asm/mpspec.h>
36 #include <acpi/acpi_bus.h>
37 #include <acpi/acpi_drivers.h>
40 #define _COMPONENT ACPI_BUS_COMPONENT
41 ACPI_MODULE_NAME ("acpi_bus")
44 extern void __init acpi_pic_sci_set_trigger(unsigned int irq, u16 trigger);
47 FADT_DESCRIPTOR acpi_fadt;
48 EXPORT_SYMBOL(acpi_fadt);
50 struct acpi_device *acpi_root;
51 struct proc_dir_entry *acpi_root_dir;
52 EXPORT_SYMBOL(acpi_root_dir);
54 #define STRUCT_TO_INT(s) (*((int*)&s))
56 /* --------------------------------------------------------------------------
58 -------------------------------------------------------------------------- */
63 struct acpi_device **device)
65 acpi_status status = AE_OK;
67 ACPI_FUNCTION_TRACE("acpi_bus_get_device");
70 return_VALUE(-EINVAL);
72 /* TBD: Support fixed-feature devices */
74 status = acpi_get_data(handle, acpi_bus_data_handler, (void**) device);
75 if (ACPI_FAILURE(status) || !*device) {
76 ACPI_DEBUG_PRINT((ACPI_DB_WARN, "No context for object [%p]\n",
78 return_VALUE(-ENODEV);
83 EXPORT_SYMBOL(acpi_bus_get_device);
87 struct acpi_device *device)
89 acpi_status status = AE_OK;
90 unsigned long sta = 0;
92 ACPI_FUNCTION_TRACE("acpi_bus_get_status");
95 return_VALUE(-EINVAL);
98 * Evaluate _STA if present.
100 if (device->flags.dynamic_status) {
101 status = acpi_evaluate_integer(device->handle, "_STA", NULL, &sta);
102 if (ACPI_FAILURE(status))
103 return_VALUE(-ENODEV);
104 STRUCT_TO_INT(device->status) = (int) sta;
108 * Otherwise we assume the status of our parent (unless we don't
109 * have one, in which case status is implied).
111 else if (device->parent)
112 device->status = device->parent->status;
114 STRUCT_TO_INT(device->status) = 0x0F;
116 if (device->status.functional && !device->status.present) {
117 printk(KERN_WARNING PREFIX "Device [%s] status [%08x]: "
118 "functional but not present; setting present\n",
120 (u32) STRUCT_TO_INT(device->status));
121 device->status.present = 1;
124 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Device [%s] status [%08x]\n",
125 device->pnp.bus_id, (u32) STRUCT_TO_INT(device->status)));
129 EXPORT_SYMBOL(acpi_bus_get_status);
132 /* --------------------------------------------------------------------------
134 -------------------------------------------------------------------------- */
142 acpi_status status = 0;
143 struct acpi_device *device = NULL;
144 unsigned long psc = 0;
146 ACPI_FUNCTION_TRACE("acpi_bus_get_power");
148 result = acpi_bus_get_device(handle, &device);
150 return_VALUE(result);
152 *state = ACPI_STATE_UNKNOWN;
154 if (!device->flags.power_manageable) {
155 /* TBD: Non-recursive algorithm for walking up hierarchy */
157 *state = device->parent->power.state;
159 *state = ACPI_STATE_D0;
163 * Get the device's power state either directly (via _PSC) or
164 * indirectly (via power resources).
166 if (device->power.flags.explicit_get) {
167 status = acpi_evaluate_integer(device->handle, "_PSC",
169 if (ACPI_FAILURE(status))
170 return_VALUE(-ENODEV);
171 device->power.state = (int) psc;
173 else if (device->power.flags.power_resources) {
174 result = acpi_power_get_inferred_state(device);
176 return_VALUE(result);
179 *state = device->power.state;
182 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Device [%s] power state is D%d\n",
183 device->pnp.bus_id, device->power.state));
187 EXPORT_SYMBOL(acpi_bus_get_power);
196 acpi_status status = AE_OK;
197 struct acpi_device *device = NULL;
198 char object_name[5] = {'_','P','S','0'+state,'\0'};
200 ACPI_FUNCTION_TRACE("acpi_bus_set_power");
202 result = acpi_bus_get_device(handle, &device);
204 return_VALUE(result);
206 if ((state < ACPI_STATE_D0) || (state > ACPI_STATE_D3))
207 return_VALUE(-EINVAL);
209 /* Make sure this is a valid target state */
211 if (!device->flags.power_manageable) {
212 ACPI_DEBUG_PRINT((ACPI_DB_WARN, "Device is not power manageable\n"));
213 return_VALUE(-ENODEV);
216 * Get device's current power state if it's unknown
217 * This means device power state isn't initialized or previous setting failed
219 if (device->power.state == ACPI_STATE_UNKNOWN)
220 acpi_bus_get_power(device->handle, &device->power.state);
221 if (state == device->power.state) {
222 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Device is already at D%d\n", state));
225 if (!device->power.states[state].flags.valid) {
226 ACPI_DEBUG_PRINT((ACPI_DB_WARN, "Device does not support D%d\n", state));
227 return_VALUE(-ENODEV);
229 if (device->parent && (state < device->parent->power.state)) {
230 ACPI_DEBUG_PRINT((ACPI_DB_WARN, "Cannot set device to a higher-powered state than parent\n"));
231 return_VALUE(-ENODEV);
237 * On transitions to a high-powered state we first apply power (via
238 * power resources) then evalute _PSx. Conversly for transitions to
239 * a lower-powered state.
241 if (state < device->power.state) {
242 if (device->power.flags.power_resources) {
243 result = acpi_power_transition(device, state);
247 if (device->power.states[state].flags.explicit_set) {
248 status = acpi_evaluate_object(device->handle,
249 object_name, NULL, NULL);
250 if (ACPI_FAILURE(status)) {
257 if (device->power.states[state].flags.explicit_set) {
258 status = acpi_evaluate_object(device->handle,
259 object_name, NULL, NULL);
260 if (ACPI_FAILURE(status)) {
265 if (device->power.flags.power_resources) {
266 result = acpi_power_transition(device, state);
274 ACPI_DEBUG_PRINT((ACPI_DB_WARN, "Error transitioning device [%s] to D%d\n",
275 device->pnp.bus_id, state));
277 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Device [%s] transitioned to D%d\n",
278 device->pnp.bus_id, state));
280 return_VALUE(result);
282 EXPORT_SYMBOL(acpi_bus_set_power);
286 /* --------------------------------------------------------------------------
288 -------------------------------------------------------------------------- */
290 static DEFINE_SPINLOCK(acpi_bus_event_lock);
292 LIST_HEAD(acpi_bus_event_list);
293 DECLARE_WAIT_QUEUE_HEAD(acpi_bus_event_queue);
295 extern int event_is_open;
298 acpi_bus_generate_event (
299 struct acpi_device *device,
303 struct acpi_bus_event *event = NULL;
304 unsigned long flags = 0;
306 ACPI_FUNCTION_TRACE("acpi_bus_generate_event");
309 return_VALUE(-EINVAL);
311 /* drop event on the floor if no one's listening */
315 event = kmalloc(sizeof(struct acpi_bus_event), GFP_ATOMIC);
317 return_VALUE(-ENOMEM);
319 strcpy(event->device_class, device->pnp.device_class);
320 strcpy(event->bus_id, device->pnp.bus_id);
324 spin_lock_irqsave(&acpi_bus_event_lock, flags);
325 list_add_tail(&event->node, &acpi_bus_event_list);
326 spin_unlock_irqrestore(&acpi_bus_event_lock, flags);
328 wake_up_interruptible(&acpi_bus_event_queue);
332 EXPORT_SYMBOL(acpi_bus_generate_event);
335 acpi_bus_receive_event (
336 struct acpi_bus_event *event)
338 unsigned long flags = 0;
339 struct acpi_bus_event *entry = NULL;
341 DECLARE_WAITQUEUE(wait, current);
343 ACPI_FUNCTION_TRACE("acpi_bus_receive_event");
346 return_VALUE(-EINVAL);
348 if (list_empty(&acpi_bus_event_list)) {
350 set_current_state(TASK_INTERRUPTIBLE);
351 add_wait_queue(&acpi_bus_event_queue, &wait);
353 if (list_empty(&acpi_bus_event_list))
356 remove_wait_queue(&acpi_bus_event_queue, &wait);
357 set_current_state(TASK_RUNNING);
359 if (signal_pending(current))
360 return_VALUE(-ERESTARTSYS);
363 spin_lock_irqsave(&acpi_bus_event_lock, flags);
364 entry = list_entry(acpi_bus_event_list.next, struct acpi_bus_event, node);
366 list_del(&entry->node);
367 spin_unlock_irqrestore(&acpi_bus_event_lock, flags);
370 return_VALUE(-ENODEV);
372 memcpy(event, entry, sizeof(struct acpi_bus_event));
378 EXPORT_SYMBOL(acpi_bus_receive_event);
381 /* --------------------------------------------------------------------------
382 Notification Handling
383 -------------------------------------------------------------------------- */
386 acpi_bus_check_device (
387 struct acpi_device *device,
390 acpi_status status = 0;
391 struct acpi_device_status old_status;
393 ACPI_FUNCTION_TRACE("acpi_bus_check_device");
396 return_VALUE(-EINVAL);
401 old_status = device->status;
404 * Make sure this device's parent is present before we go about
405 * messing with the device.
407 if (device->parent && !device->parent->status.present) {
408 device->status = device->parent->status;
409 if (STRUCT_TO_INT(old_status) != STRUCT_TO_INT(device->status)) {
416 status = acpi_bus_get_status(device);
417 if (ACPI_FAILURE(status))
418 return_VALUE(-ENODEV);
420 if (STRUCT_TO_INT(old_status) == STRUCT_TO_INT(device->status))
427 * Device Insertion/Removal
429 if ((device->status.present) && !(old_status.present)) {
430 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Device insertion detected\n"));
431 /* TBD: Handle device insertion */
433 else if (!(device->status.present) && (old_status.present)) {
434 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Device removal detected\n"));
435 /* TBD: Handle device removal */
443 acpi_bus_check_scope (
444 struct acpi_device *device)
447 int status_changed = 0;
449 ACPI_FUNCTION_TRACE("acpi_bus_check_scope");
452 return_VALUE(-EINVAL);
455 result = acpi_bus_check_device(device, &status_changed);
457 return_VALUE(result);
463 * TBD: Enumerate child devices within this device's scope and
464 * run acpi_bus_check_device()'s on them.
474 * Callback for all 'system-level' device notifications (values 0x00-0x7F).
483 struct acpi_device *device = NULL;
485 ACPI_FUNCTION_TRACE("acpi_bus_notify");
487 if (acpi_bus_get_device(handle, &device))
492 case ACPI_NOTIFY_BUS_CHECK:
493 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Received BUS CHECK notification for device [%s]\n",
494 device->pnp.bus_id));
495 result = acpi_bus_check_scope(device);
497 * TBD: We'll need to outsource certain events to non-ACPI
498 * drivers via the device manager (device.c).
502 case ACPI_NOTIFY_DEVICE_CHECK:
503 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Received DEVICE CHECK notification for device [%s]\n",
504 device->pnp.bus_id));
505 result = acpi_bus_check_device(device, NULL);
507 * TBD: We'll need to outsource certain events to non-ACPI
508 * drivers via the device manager (device.c).
512 case ACPI_NOTIFY_DEVICE_WAKE:
513 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Received DEVICE WAKE notification for device [%s]\n",
514 device->pnp.bus_id));
518 case ACPI_NOTIFY_EJECT_REQUEST:
519 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Received EJECT REQUEST notification for device [%s]\n",
520 device->pnp.bus_id));
524 case ACPI_NOTIFY_DEVICE_CHECK_LIGHT:
525 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Received DEVICE CHECK LIGHT notification for device [%s]\n",
526 device->pnp.bus_id));
527 /* TBD: Exactly what does 'light' mean? */
530 case ACPI_NOTIFY_FREQUENCY_MISMATCH:
531 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Received FREQUENCY MISMATCH notification for device [%s]\n",
532 device->pnp.bus_id));
536 case ACPI_NOTIFY_BUS_MODE_MISMATCH:
537 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Received BUS MODE MISMATCH notification for device [%s]\n",
538 device->pnp.bus_id));
542 case ACPI_NOTIFY_POWER_FAULT:
543 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Received POWER FAULT notification for device [%s]\n",
544 device->pnp.bus_id));
549 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Received unknown/unsupported notification [%08x]\n",
557 /* --------------------------------------------------------------------------
558 Initialization/Cleanup
559 -------------------------------------------------------------------------- */
562 acpi_bus_init_irq (void)
564 acpi_status status = AE_OK;
565 union acpi_object arg = {ACPI_TYPE_INTEGER};
566 struct acpi_object_list arg_list = {1, &arg};
567 char *message = NULL;
569 ACPI_FUNCTION_TRACE("acpi_bus_init_irq");
572 * Let the system know what interrupt model we are using by
573 * evaluating the \_PIC object, if exists.
576 switch (acpi_irq_model) {
577 case ACPI_IRQ_MODEL_PIC:
580 case ACPI_IRQ_MODEL_IOAPIC:
583 case ACPI_IRQ_MODEL_IOSAPIC:
587 printk(KERN_WARNING PREFIX "Unknown interrupt routing model\n");
588 return_VALUE(-ENODEV);
591 printk(KERN_INFO PREFIX "Using %s for interrupt routing\n", message);
593 arg.integer.value = acpi_irq_model;
595 status = acpi_evaluate_object(NULL, "\\_PIC", &arg_list, NULL);
596 if (ACPI_FAILURE(status) && (status != AE_NOT_FOUND)) {
597 ACPI_DEBUG_PRINT((ACPI_DB_ERROR, "Error evaluating _PIC\n"));
598 return_VALUE(-ENODEV);
606 acpi_early_init (void)
608 acpi_status status = AE_OK;
609 struct acpi_buffer buffer = {sizeof(acpi_fadt), &acpi_fadt};
611 ACPI_FUNCTION_TRACE("acpi_early_init");
616 /* enable workarounds, unless strict ACPI spec. compliance */
618 acpi_gbl_enable_interpreter_slack = TRUE;
620 status = acpi_initialize_subsystem();
621 if (ACPI_FAILURE(status)) {
622 printk(KERN_ERR PREFIX "Unable to initialize the ACPI Interpreter\n");
626 status = acpi_load_tables();
627 if (ACPI_FAILURE(status)) {
628 printk(KERN_ERR PREFIX "Unable to load the System Description Tables\n");
633 * Get a separate copy of the FADT for use by other drivers.
635 status = acpi_get_table(ACPI_TABLE_FADT, 1, &buffer);
636 if (ACPI_FAILURE(status)) {
637 printk(KERN_ERR PREFIX "Unable to get the FADT\n");
643 extern acpi_interrupt_flags acpi_sci_flags;
645 /* compatible (0) means level (3) */
646 if (acpi_sci_flags.trigger == 0)
647 acpi_sci_flags.trigger = 3;
649 /* Set PIC-mode SCI trigger type */
650 acpi_pic_sci_set_trigger(acpi_fadt.sci_int, acpi_sci_flags.trigger);
652 extern int acpi_sci_override_gsi;
654 * now that acpi_fadt is initialized,
655 * update it with result from INT_SRC_OVR parsing
657 acpi_fadt.sci_int = acpi_sci_override_gsi;
661 status = acpi_enable_subsystem(~(ACPI_NO_HARDWARE_INIT | ACPI_NO_ACPI_ENABLE));
662 if (ACPI_FAILURE(status)) {
663 printk(KERN_ERR PREFIX "Unable to enable ACPI\n");
678 acpi_status status = AE_OK;
679 extern acpi_status acpi_os_initialize1(void);
681 ACPI_FUNCTION_TRACE("acpi_bus_init");
683 status = acpi_os_initialize1();
685 status = acpi_enable_subsystem(ACPI_NO_HARDWARE_INIT | ACPI_NO_ACPI_ENABLE);
686 if (ACPI_FAILURE(status)) {
687 printk(KERN_ERR PREFIX "Unable to start the ACPI Interpreter\n");
691 if (ACPI_FAILURE(status)) {
692 printk(KERN_ERR PREFIX "Unable to initialize ACPI OS objects\n");
695 #ifdef CONFIG_ACPI_EC
697 * ACPI 2.0 requires the EC driver to be loaded and work before
698 * the EC device is found in the namespace (i.e. before acpi_initialize_objects()
701 * This is accomplished by looking for the ECDT table, and getting
702 * the EC parameters out of that.
704 status = acpi_ec_ecdt_probe();
705 /* Ignore result. Not having an ECDT is not fatal. */
708 status = acpi_initialize_objects(ACPI_FULL_INITIALIZATION);
709 if (ACPI_FAILURE(status)) {
710 printk(KERN_ERR PREFIX "Unable to initialize ACPI objects\n");
714 printk(KERN_INFO PREFIX "Interpreter enabled\n");
717 * Get the system interrupt model and evaluate \_PIC.
719 result = acpi_bus_init_irq();
724 * Register the for all standard device notifications.
726 status = acpi_install_notify_handler(ACPI_ROOT_OBJECT, ACPI_SYSTEM_NOTIFY, &acpi_bus_notify, NULL);
727 if (ACPI_FAILURE(status)) {
728 printk(KERN_ERR PREFIX "Unable to register for device notifications\n");
733 * Create the top ACPI proc directory
735 acpi_root_dir = proc_mkdir(ACPI_BUS_FILE_ROOT, NULL);
739 /* Mimic structured exception handling */
742 return_VALUE(-ENODEV);
745 decl_subsys(acpi,NULL,NULL);
747 static int __init acpi_init (void)
751 ACPI_FUNCTION_TRACE("acpi_init");
753 printk(KERN_INFO PREFIX "Subsystem revision %08x\n",
757 printk(KERN_INFO PREFIX "Interpreter disabled.\n");
758 return_VALUE(-ENODEV);
761 firmware_register(&acpi_subsys);
763 result = acpi_bus_init();
770 printk(KERN_INFO PREFIX "APM is already active, exiting\n");
778 return_VALUE(result);
781 subsys_initcall(acpi_init);