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 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
21 #include <linux/module.h>
22 #include <linux/init.h>
23 #include <linux/ioport.h>
24 #include <linux/kernel.h>
25 #include <linux/list.h>
26 #include <linux/sched.h>
28 #include <linux/device.h>
29 #include <linux/proc_fs.h>
30 #include <linux/acpi.h>
31 #include <linux/slab.h>
32 #include <linux/regulator/machine.h>
33 #include <linux/workqueue.h>
34 #include <linux/reboot.h>
35 #include <linux/delay.h>
37 #include <asm/mpspec.h>
39 #include <linux/acpi_iort.h>
40 #include <linux/pci.h>
41 #include <acpi/apei.h>
42 #include <linux/dmi.h>
43 #include <linux/suspend.h>
47 #define _COMPONENT ACPI_BUS_COMPONENT
48 ACPI_MODULE_NAME("bus");
50 struct acpi_device
*acpi_root
;
51 struct proc_dir_entry
*acpi_root_dir
;
52 EXPORT_SYMBOL(acpi_root_dir
);
55 #ifdef CONFIG_ACPI_CUSTOM_DSDT
56 static inline int set_copy_dsdt(const struct dmi_system_id
*id
)
61 static int set_copy_dsdt(const struct dmi_system_id
*id
)
63 printk(KERN_NOTICE
"%s detected - "
64 "force copy of DSDT to local memory\n", id
->ident
);
65 acpi_gbl_copy_dsdt_locally
= 1;
70 static struct dmi_system_id dsdt_dmi_table
[] __initdata
= {
72 * Invoke DSDT corruption work-around on all Toshiba Satellite.
73 * https://bugzilla.kernel.org/show_bug.cgi?id=14679
76 .callback
= set_copy_dsdt
,
77 .ident
= "TOSHIBA Satellite",
79 DMI_MATCH(DMI_SYS_VENDOR
, "TOSHIBA"),
80 DMI_MATCH(DMI_PRODUCT_NAME
, "Satellite"),
86 static struct dmi_system_id dsdt_dmi_table
[] __initdata
= {
91 /* --------------------------------------------------------------------------
93 -------------------------------------------------------------------------- */
95 acpi_status
acpi_bus_get_status_handle(acpi_handle handle
,
96 unsigned long long *sta
)
100 status
= acpi_evaluate_integer(handle
, "_STA", NULL
, sta
);
101 if (ACPI_SUCCESS(status
))
104 if (status
== AE_NOT_FOUND
) {
105 *sta
= ACPI_STA_DEVICE_PRESENT
| ACPI_STA_DEVICE_ENABLED
|
106 ACPI_STA_DEVICE_UI
| ACPI_STA_DEVICE_FUNCTIONING
;
112 int acpi_bus_get_status(struct acpi_device
*device
)
115 unsigned long long sta
;
117 status
= acpi_bus_get_status_handle(device
->handle
, &sta
);
118 if (ACPI_FAILURE(status
))
121 acpi_set_device_status(device
, sta
);
123 if (device
->status
.functional
&& !device
->status
.present
) {
124 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Device [%s] status [%08x]: "
125 "functional but not present;\n",
126 device
->pnp
.bus_id
, (u32
)sta
));
129 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Device [%s] status [%08x]\n",
130 device
->pnp
.bus_id
, (u32
)sta
));
133 EXPORT_SYMBOL(acpi_bus_get_status
);
135 void acpi_bus_private_data_handler(acpi_handle handle
,
140 EXPORT_SYMBOL(acpi_bus_private_data_handler
);
142 int acpi_bus_attach_private_data(acpi_handle handle
, void *data
)
146 status
= acpi_attach_data(handle
,
147 acpi_bus_private_data_handler
, data
);
148 if (ACPI_FAILURE(status
)) {
149 acpi_handle_debug(handle
, "Error attaching device data\n");
155 EXPORT_SYMBOL_GPL(acpi_bus_attach_private_data
);
157 int acpi_bus_get_private_data(acpi_handle handle
, void **data
)
164 status
= acpi_get_data(handle
, acpi_bus_private_data_handler
, data
);
165 if (ACPI_FAILURE(status
)) {
166 acpi_handle_debug(handle
, "No context for object\n");
172 EXPORT_SYMBOL_GPL(acpi_bus_get_private_data
);
174 void acpi_bus_detach_private_data(acpi_handle handle
)
176 acpi_detach_data(handle
, acpi_bus_private_data_handler
);
178 EXPORT_SYMBOL_GPL(acpi_bus_detach_private_data
);
180 static void acpi_print_osc_error(acpi_handle handle
,
181 struct acpi_osc_context
*context
, char *error
)
185 acpi_handle_debug(handle
, "(%s): %s\n", context
->uuid_str
, error
);
187 pr_debug("_OSC request data:");
188 for (i
= 0; i
< context
->cap
.length
; i
+= sizeof(u32
))
189 pr_debug(" %x", *((u32
*)(context
->cap
.pointer
+ i
)));
194 acpi_status
acpi_str_to_uuid(char *str
, u8
*uuid
)
197 static int opc_map_to_uuid
[16] = {6, 4, 2, 0, 11, 9, 16, 14, 19, 21,
198 24, 26, 28, 30, 32, 34};
200 if (strlen(str
) != 36)
201 return AE_BAD_PARAMETER
;
202 for (i
= 0; i
< 36; i
++) {
203 if (i
== 8 || i
== 13 || i
== 18 || i
== 23) {
205 return AE_BAD_PARAMETER
;
206 } else if (!isxdigit(str
[i
]))
207 return AE_BAD_PARAMETER
;
209 for (i
= 0; i
< 16; i
++) {
210 uuid
[i
] = hex_to_bin(str
[opc_map_to_uuid
[i
]]) << 4;
211 uuid
[i
] |= hex_to_bin(str
[opc_map_to_uuid
[i
] + 1]);
215 EXPORT_SYMBOL_GPL(acpi_str_to_uuid
);
217 acpi_status
acpi_run_osc(acpi_handle handle
, struct acpi_osc_context
*context
)
220 struct acpi_object_list input
;
221 union acpi_object in_params
[4];
222 union acpi_object
*out_obj
;
225 struct acpi_buffer output
= {ACPI_ALLOCATE_BUFFER
, NULL
};
229 if (ACPI_FAILURE(acpi_str_to_uuid(context
->uuid_str
, uuid
)))
231 context
->ret
.length
= ACPI_ALLOCATE_BUFFER
;
232 context
->ret
.pointer
= NULL
;
234 /* Setting up input parameters */
236 input
.pointer
= in_params
;
237 in_params
[0].type
= ACPI_TYPE_BUFFER
;
238 in_params
[0].buffer
.length
= 16;
239 in_params
[0].buffer
.pointer
= uuid
;
240 in_params
[1].type
= ACPI_TYPE_INTEGER
;
241 in_params
[1].integer
.value
= context
->rev
;
242 in_params
[2].type
= ACPI_TYPE_INTEGER
;
243 in_params
[2].integer
.value
= context
->cap
.length
/sizeof(u32
);
244 in_params
[3].type
= ACPI_TYPE_BUFFER
;
245 in_params
[3].buffer
.length
= context
->cap
.length
;
246 in_params
[3].buffer
.pointer
= context
->cap
.pointer
;
248 status
= acpi_evaluate_object(handle
, "_OSC", &input
, &output
);
249 if (ACPI_FAILURE(status
))
253 return AE_NULL_OBJECT
;
255 out_obj
= output
.pointer
;
256 if (out_obj
->type
!= ACPI_TYPE_BUFFER
257 || out_obj
->buffer
.length
!= context
->cap
.length
) {
258 acpi_print_osc_error(handle
, context
,
259 "_OSC evaluation returned wrong type");
263 /* Need to ignore the bit0 in result code */
264 errors
= *((u32
*)out_obj
->buffer
.pointer
) & ~(1 << 0);
266 if (errors
& OSC_REQUEST_ERROR
)
267 acpi_print_osc_error(handle
, context
,
268 "_OSC request failed");
269 if (errors
& OSC_INVALID_UUID_ERROR
)
270 acpi_print_osc_error(handle
, context
,
271 "_OSC invalid UUID");
272 if (errors
& OSC_INVALID_REVISION_ERROR
)
273 acpi_print_osc_error(handle
, context
,
274 "_OSC invalid revision");
275 if (errors
& OSC_CAPABILITIES_MASK_ERROR
) {
276 if (((u32
*)context
->cap
.pointer
)[OSC_QUERY_DWORD
]
286 context
->ret
.length
= out_obj
->buffer
.length
;
287 context
->ret
.pointer
= kmemdup(out_obj
->buffer
.pointer
,
288 context
->ret
.length
, GFP_KERNEL
);
289 if (!context
->ret
.pointer
) {
290 status
= AE_NO_MEMORY
;
296 kfree(output
.pointer
);
298 context
->ret
.pointer
= NULL
;
301 EXPORT_SYMBOL(acpi_run_osc
);
303 bool osc_sb_apei_support_acked
;
306 * ACPI 6.0 Section 8.4.4.2 Idle State Coordination
307 * OSPM supports platform coordinated low power idle(LPI) states
309 bool osc_pc_lpi_support_confirmed
;
310 EXPORT_SYMBOL_GPL(osc_pc_lpi_support_confirmed
);
312 static u8 sb_uuid_str
[] = "0811B06E-4A27-44F9-8D60-3CBBC22E7B48";
313 static void acpi_bus_osc_support(void)
316 struct acpi_osc_context context
= {
317 .uuid_str
= sb_uuid_str
,
320 .cap
.pointer
= capbuf
,
324 capbuf
[OSC_QUERY_DWORD
] = OSC_QUERY_ENABLE
;
325 capbuf
[OSC_SUPPORT_DWORD
] = OSC_SB_PR3_SUPPORT
; /* _PR3 is in use */
326 if (IS_ENABLED(CONFIG_ACPI_PROCESSOR_AGGREGATOR
))
327 capbuf
[OSC_SUPPORT_DWORD
] |= OSC_SB_PAD_SUPPORT
;
328 if (IS_ENABLED(CONFIG_ACPI_PROCESSOR
))
329 capbuf
[OSC_SUPPORT_DWORD
] |= OSC_SB_PPC_OST_SUPPORT
;
331 capbuf
[OSC_SUPPORT_DWORD
] |= OSC_SB_HOTPLUG_OST_SUPPORT
;
332 capbuf
[OSC_SUPPORT_DWORD
] |= OSC_SB_PCLPI_SUPPORT
;
335 capbuf
[OSC_SUPPORT_DWORD
] |= OSC_SB_APEI_SUPPORT
;
336 if (ACPI_FAILURE(acpi_get_handle(NULL
, "\\_SB", &handle
)))
338 if (ACPI_SUCCESS(acpi_run_osc(handle
, &context
))) {
339 u32
*capbuf_ret
= context
.ret
.pointer
;
340 if (context
.ret
.length
> OSC_SUPPORT_DWORD
) {
341 osc_sb_apei_support_acked
=
342 capbuf_ret
[OSC_SUPPORT_DWORD
] & OSC_SB_APEI_SUPPORT
;
343 osc_pc_lpi_support_confirmed
=
344 capbuf_ret
[OSC_SUPPORT_DWORD
] & OSC_SB_PCLPI_SUPPORT
;
346 kfree(context
.ret
.pointer
);
348 /* do we need to check other returned cap? Sounds no */
351 /* --------------------------------------------------------------------------
352 Notification Handling
353 -------------------------------------------------------------------------- */
358 * Callback for all 'system-level' device notifications (values 0x00-0x7F).
360 static void acpi_bus_notify(acpi_handle handle
, u32 type
, void *data
)
362 struct acpi_device
*adev
;
363 struct acpi_driver
*driver
;
364 u32 ost_code
= ACPI_OST_SC_NON_SPECIFIC_FAILURE
;
365 bool hotplug_event
= false;
368 case ACPI_NOTIFY_BUS_CHECK
:
369 acpi_handle_debug(handle
, "ACPI_NOTIFY_BUS_CHECK event\n");
370 hotplug_event
= true;
373 case ACPI_NOTIFY_DEVICE_CHECK
:
374 acpi_handle_debug(handle
, "ACPI_NOTIFY_DEVICE_CHECK event\n");
375 hotplug_event
= true;
378 case ACPI_NOTIFY_DEVICE_WAKE
:
379 acpi_handle_debug(handle
, "ACPI_NOTIFY_DEVICE_WAKE event\n");
382 case ACPI_NOTIFY_EJECT_REQUEST
:
383 acpi_handle_debug(handle
, "ACPI_NOTIFY_EJECT_REQUEST event\n");
384 hotplug_event
= true;
387 case ACPI_NOTIFY_DEVICE_CHECK_LIGHT
:
388 acpi_handle_debug(handle
, "ACPI_NOTIFY_DEVICE_CHECK_LIGHT event\n");
389 /* TBD: Exactly what does 'light' mean? */
392 case ACPI_NOTIFY_FREQUENCY_MISMATCH
:
393 acpi_handle_err(handle
, "Device cannot be configured due "
394 "to a frequency mismatch\n");
397 case ACPI_NOTIFY_BUS_MODE_MISMATCH
:
398 acpi_handle_err(handle
, "Device cannot be configured due "
399 "to a bus mode mismatch\n");
402 case ACPI_NOTIFY_POWER_FAULT
:
403 acpi_handle_err(handle
, "Device has suffered a power fault\n");
407 acpi_handle_debug(handle
, "Unknown event type 0x%x\n", type
);
411 adev
= acpi_bus_get_acpi_device(handle
);
415 driver
= adev
->driver
;
416 if (driver
&& driver
->ops
.notify
&&
417 (driver
->flags
& ACPI_DRIVER_ALL_NOTIFY_EVENTS
))
418 driver
->ops
.notify(adev
, type
);
420 if (hotplug_event
&& ACPI_SUCCESS(acpi_hotplug_schedule(adev
, type
)))
423 acpi_bus_put_acpi_device(adev
);
427 acpi_evaluate_ost(handle
, type
, ost_code
, NULL
);
430 static void acpi_device_notify(acpi_handle handle
, u32 event
, void *data
)
432 struct acpi_device
*device
= data
;
434 device
->driver
->ops
.notify(device
, event
);
437 static void acpi_device_notify_fixed(void *data
)
439 struct acpi_device
*device
= data
;
441 /* Fixed hardware devices have no handles */
442 acpi_device_notify(NULL
, ACPI_FIXED_HARDWARE_EVENT
, device
);
445 static u32
acpi_device_fixed_event(void *data
)
447 acpi_os_execute(OSL_NOTIFY_HANDLER
, acpi_device_notify_fixed
, data
);
448 return ACPI_INTERRUPT_HANDLED
;
451 static int acpi_device_install_notify_handler(struct acpi_device
*device
)
455 if (device
->device_type
== ACPI_BUS_TYPE_POWER_BUTTON
)
457 acpi_install_fixed_event_handler(ACPI_EVENT_POWER_BUTTON
,
458 acpi_device_fixed_event
,
460 else if (device
->device_type
== ACPI_BUS_TYPE_SLEEP_BUTTON
)
462 acpi_install_fixed_event_handler(ACPI_EVENT_SLEEP_BUTTON
,
463 acpi_device_fixed_event
,
466 status
= acpi_install_notify_handler(device
->handle
,
471 if (ACPI_FAILURE(status
))
476 static void acpi_device_remove_notify_handler(struct acpi_device
*device
)
478 if (device
->device_type
== ACPI_BUS_TYPE_POWER_BUTTON
)
479 acpi_remove_fixed_event_handler(ACPI_EVENT_POWER_BUTTON
,
480 acpi_device_fixed_event
);
481 else if (device
->device_type
== ACPI_BUS_TYPE_SLEEP_BUTTON
)
482 acpi_remove_fixed_event_handler(ACPI_EVENT_SLEEP_BUTTON
,
483 acpi_device_fixed_event
);
485 acpi_remove_notify_handler(device
->handle
, ACPI_DEVICE_NOTIFY
,
489 /* Handle events targeting \_SB device (at present only graceful shutdown) */
491 #define ACPI_SB_NOTIFY_SHUTDOWN_REQUEST 0x81
492 #define ACPI_SB_INDICATE_INTERVAL 10000
494 static void sb_notify_work(struct work_struct
*dummy
)
496 acpi_handle sb_handle
;
498 orderly_poweroff(true);
501 * After initiating graceful shutdown, the ACPI spec requires OSPM
502 * to evaluate _OST method once every 10seconds to indicate that
503 * the shutdown is in progress
505 acpi_get_handle(NULL
, "\\_SB", &sb_handle
);
507 pr_info("Graceful shutdown in progress.\n");
508 acpi_evaluate_ost(sb_handle
, ACPI_OST_EC_OSPM_SHUTDOWN
,
509 ACPI_OST_SC_OS_SHUTDOWN_IN_PROGRESS
, NULL
);
510 msleep(ACPI_SB_INDICATE_INTERVAL
);
514 static void acpi_sb_notify(acpi_handle handle
, u32 event
, void *data
)
516 static DECLARE_WORK(acpi_sb_work
, sb_notify_work
);
518 if (event
== ACPI_SB_NOTIFY_SHUTDOWN_REQUEST
) {
519 if (!work_busy(&acpi_sb_work
))
520 schedule_work(&acpi_sb_work
);
522 pr_warn("event %x is not supported by \\_SB device\n", event
);
525 static int __init
acpi_setup_sb_notify_handler(void)
527 acpi_handle sb_handle
;
529 if (ACPI_FAILURE(acpi_get_handle(NULL
, "\\_SB", &sb_handle
)))
532 if (ACPI_FAILURE(acpi_install_notify_handler(sb_handle
, ACPI_DEVICE_NOTIFY
,
533 acpi_sb_notify
, NULL
)))
539 /* --------------------------------------------------------------------------
541 -------------------------------------------------------------------------- */
544 * acpi_get_first_physical_node - Get first physical node of an ACPI device
545 * @adev: ACPI device in question
547 * Return: First physical node of ACPI device @adev
549 struct device
*acpi_get_first_physical_node(struct acpi_device
*adev
)
551 struct mutex
*physical_node_lock
= &adev
->physical_node_lock
;
552 struct device
*phys_dev
;
554 mutex_lock(physical_node_lock
);
555 if (list_empty(&adev
->physical_node_list
)) {
558 const struct acpi_device_physical_node
*node
;
560 node
= list_first_entry(&adev
->physical_node_list
,
561 struct acpi_device_physical_node
, node
);
563 phys_dev
= node
->dev
;
565 mutex_unlock(physical_node_lock
);
569 static struct acpi_device
*acpi_primary_dev_companion(struct acpi_device
*adev
,
570 const struct device
*dev
)
572 const struct device
*phys_dev
= acpi_get_first_physical_node(adev
);
574 return phys_dev
&& phys_dev
== dev
? adev
: NULL
;
578 * acpi_device_is_first_physical_node - Is given dev first physical node
579 * @adev: ACPI companion device
580 * @dev: Physical device to check
582 * Function checks if given @dev is the first physical devices attached to
583 * the ACPI companion device. This distinction is needed in some cases
584 * where the same companion device is shared between many physical devices.
586 * Note that the caller have to provide valid @adev pointer.
588 bool acpi_device_is_first_physical_node(struct acpi_device
*adev
,
589 const struct device
*dev
)
591 return !!acpi_primary_dev_companion(adev
, dev
);
595 * acpi_companion_match() - Can we match via ACPI companion device
596 * @dev: Device in question
598 * Check if the given device has an ACPI companion and if that companion has
599 * a valid list of PNP IDs, and if the device is the first (primary) physical
600 * device associated with it. Return the companion pointer if that's the case
603 * If multiple physical devices are attached to a single ACPI companion, we need
604 * to be careful. The usage scenario for this kind of relationship is that all
605 * of the physical devices in question use resources provided by the ACPI
606 * companion. A typical case is an MFD device where all the sub-devices share
607 * the parent's ACPI companion. In such cases we can only allow the primary
608 * (first) physical device to be matched with the help of the companion's PNP
611 * Additional physical devices sharing the ACPI companion can still use
612 * resources available from it but they will be matched normally using functions
613 * provided by their bus types (and analogously for their modalias).
615 struct acpi_device
*acpi_companion_match(const struct device
*dev
)
617 struct acpi_device
*adev
;
619 adev
= ACPI_COMPANION(dev
);
623 if (list_empty(&adev
->pnp
.ids
))
626 return acpi_primary_dev_companion(adev
, dev
);
630 * acpi_of_match_device - Match device object using the "compatible" property.
631 * @adev: ACPI device object to match.
632 * @of_match_table: List of device IDs to match against.
634 * If @dev has an ACPI companion which has ACPI_DT_NAMESPACE_HID in its list of
635 * identifiers and a _DSD object with the "compatible" property, use that
636 * property to match against the given list of identifiers.
638 static bool acpi_of_match_device(struct acpi_device
*adev
,
639 const struct of_device_id
*of_match_table
)
641 const union acpi_object
*of_compatible
, *obj
;
647 of_compatible
= adev
->data
.of_compatible
;
648 if (!of_match_table
|| !of_compatible
)
651 if (of_compatible
->type
== ACPI_TYPE_PACKAGE
) {
652 nval
= of_compatible
->package
.count
;
653 obj
= of_compatible
->package
.elements
;
654 } else { /* Must be ACPI_TYPE_STRING. */
658 /* Now we can look for the driver DT compatible strings */
659 for (i
= 0; i
< nval
; i
++, obj
++) {
660 const struct of_device_id
*id
;
662 for (id
= of_match_table
; id
->compatible
[0]; id
++)
663 if (!strcasecmp(obj
->string
.pointer
, id
->compatible
))
670 static bool __acpi_match_device_cls(const struct acpi_device_id
*id
,
671 struct acpi_hardware_id
*hwid
)
673 int i
, msk
, byte_shift
;
679 /* Apply class-code bitmask, before checking each class-code byte */
680 for (i
= 1; i
<= 3; i
++) {
681 byte_shift
= 8 * (3 - i
);
682 msk
= (id
->cls_msk
>> byte_shift
) & 0xFF;
686 sprintf(buf
, "%02x", (id
->cls
>> byte_shift
) & msk
);
687 if (strncmp(buf
, &hwid
->id
[(i
- 1) * 2], 2))
693 static const struct acpi_device_id
*__acpi_match_device(
694 struct acpi_device
*device
,
695 const struct acpi_device_id
*ids
,
696 const struct of_device_id
*of_ids
)
698 const struct acpi_device_id
*id
;
699 struct acpi_hardware_id
*hwid
;
702 * If the device is not present, it is unnecessary to load device
705 if (!device
|| !device
->status
.present
)
708 list_for_each_entry(hwid
, &device
->pnp
.ids
, list
) {
709 /* First, check the ACPI/PNP IDs provided by the caller. */
710 for (id
= ids
; id
->id
[0] || id
->cls
; id
++) {
711 if (id
->id
[0] && !strcmp((char *) id
->id
, hwid
->id
))
713 else if (id
->cls
&& __acpi_match_device_cls(id
, hwid
))
718 * Next, check ACPI_DT_NAMESPACE_HID and try to match the
719 * "compatible" property if found.
721 * The id returned by the below is not valid, but the only
722 * caller passing non-NULL of_ids here is only interested in
723 * whether or not the return value is NULL.
725 if (!strcmp(ACPI_DT_NAMESPACE_HID
, hwid
->id
)
726 && acpi_of_match_device(device
, of_ids
))
733 * acpi_match_device - Match a struct device against a given list of ACPI IDs
734 * @ids: Array of struct acpi_device_id object to match against.
735 * @dev: The device structure to match.
737 * Check if @dev has a valid ACPI handle and if there is a struct acpi_device
738 * object for that handle and use that object to match against a given list of
741 * Return a pointer to the first matching ID on success or %NULL on failure.
743 const struct acpi_device_id
*acpi_match_device(const struct acpi_device_id
*ids
,
744 const struct device
*dev
)
746 return __acpi_match_device(acpi_companion_match(dev
), ids
, NULL
);
748 EXPORT_SYMBOL_GPL(acpi_match_device
);
750 int acpi_match_device_ids(struct acpi_device
*device
,
751 const struct acpi_device_id
*ids
)
753 return __acpi_match_device(device
, ids
, NULL
) ? 0 : -ENOENT
;
755 EXPORT_SYMBOL(acpi_match_device_ids
);
757 bool acpi_driver_match_device(struct device
*dev
,
758 const struct device_driver
*drv
)
760 if (!drv
->acpi_match_table
)
761 return acpi_of_match_device(ACPI_COMPANION(dev
),
762 drv
->of_match_table
);
764 return !!__acpi_match_device(acpi_companion_match(dev
),
765 drv
->acpi_match_table
, drv
->of_match_table
);
767 EXPORT_SYMBOL_GPL(acpi_driver_match_device
);
769 /* --------------------------------------------------------------------------
770 ACPI Driver Management
771 -------------------------------------------------------------------------- */
774 * acpi_bus_register_driver - register a driver with the ACPI bus
775 * @driver: driver being registered
777 * Registers a driver with the ACPI bus. Searches the namespace for all
778 * devices that match the driver's criteria and binds. Returns zero for
779 * success or a negative error status for failure.
781 int acpi_bus_register_driver(struct acpi_driver
*driver
)
787 driver
->drv
.name
= driver
->name
;
788 driver
->drv
.bus
= &acpi_bus_type
;
789 driver
->drv
.owner
= driver
->owner
;
791 ret
= driver_register(&driver
->drv
);
795 EXPORT_SYMBOL(acpi_bus_register_driver
);
798 * acpi_bus_unregister_driver - unregisters a driver with the ACPI bus
799 * @driver: driver to unregister
801 * Unregisters a driver with the ACPI bus. Searches the namespace for all
802 * devices that match the driver's criteria and unbinds.
804 void acpi_bus_unregister_driver(struct acpi_driver
*driver
)
806 driver_unregister(&driver
->drv
);
809 EXPORT_SYMBOL(acpi_bus_unregister_driver
);
811 /* --------------------------------------------------------------------------
813 -------------------------------------------------------------------------- */
815 static int acpi_bus_match(struct device
*dev
, struct device_driver
*drv
)
817 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
818 struct acpi_driver
*acpi_drv
= to_acpi_driver(drv
);
820 return acpi_dev
->flags
.match_driver
821 && !acpi_match_device_ids(acpi_dev
, acpi_drv
->ids
);
824 static int acpi_device_uevent(struct device
*dev
, struct kobj_uevent_env
*env
)
826 return __acpi_device_uevent_modalias(to_acpi_device(dev
), env
);
829 static int acpi_device_probe(struct device
*dev
)
831 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
832 struct acpi_driver
*acpi_drv
= to_acpi_driver(dev
->driver
);
835 if (acpi_dev
->handler
&& !acpi_is_pnp_device(acpi_dev
))
838 if (!acpi_drv
->ops
.add
)
841 ret
= acpi_drv
->ops
.add(acpi_dev
);
845 acpi_dev
->driver
= acpi_drv
;
846 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
847 "Driver [%s] successfully bound to device [%s]\n",
848 acpi_drv
->name
, acpi_dev
->pnp
.bus_id
));
850 if (acpi_drv
->ops
.notify
) {
851 ret
= acpi_device_install_notify_handler(acpi_dev
);
853 if (acpi_drv
->ops
.remove
)
854 acpi_drv
->ops
.remove(acpi_dev
);
856 acpi_dev
->driver
= NULL
;
857 acpi_dev
->driver_data
= NULL
;
862 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Found driver [%s] for device [%s]\n",
863 acpi_drv
->name
, acpi_dev
->pnp
.bus_id
));
868 static int acpi_device_remove(struct device
* dev
)
870 struct acpi_device
*acpi_dev
= to_acpi_device(dev
);
871 struct acpi_driver
*acpi_drv
= acpi_dev
->driver
;
874 if (acpi_drv
->ops
.notify
)
875 acpi_device_remove_notify_handler(acpi_dev
);
876 if (acpi_drv
->ops
.remove
)
877 acpi_drv
->ops
.remove(acpi_dev
);
879 acpi_dev
->driver
= NULL
;
880 acpi_dev
->driver_data
= NULL
;
886 struct bus_type acpi_bus_type
= {
888 .match
= acpi_bus_match
,
889 .probe
= acpi_device_probe
,
890 .remove
= acpi_device_remove
,
891 .uevent
= acpi_device_uevent
,
894 /* --------------------------------------------------------------------------
895 Initialization/Cleanup
896 -------------------------------------------------------------------------- */
898 static int __init
acpi_bus_init_irq(void)
901 char *message
= NULL
;
905 * Let the system know what interrupt model we are using by
906 * evaluating the \_PIC object, if exists.
909 switch (acpi_irq_model
) {
910 case ACPI_IRQ_MODEL_PIC
:
913 case ACPI_IRQ_MODEL_IOAPIC
:
916 case ACPI_IRQ_MODEL_IOSAPIC
:
919 case ACPI_IRQ_MODEL_GIC
:
922 case ACPI_IRQ_MODEL_PLATFORM
:
923 message
= "platform specific model";
926 printk(KERN_WARNING PREFIX
"Unknown interrupt routing model\n");
930 printk(KERN_INFO PREFIX
"Using %s for interrupt routing\n", message
);
932 status
= acpi_execute_simple_method(NULL
, "\\_PIC", acpi_irq_model
);
933 if (ACPI_FAILURE(status
) && (status
!= AE_NOT_FOUND
)) {
934 ACPI_EXCEPTION((AE_INFO
, status
, "Evaluating _PIC"));
942 * acpi_early_init - Initialize ACPICA and populate the ACPI namespace.
944 * The ACPI tables are accessible after this, but the handling of events has not
945 * been initialized and the global lock is not available yet, so AML should not
946 * be executed at this point.
948 * Doing this before switching the EFI runtime services to virtual mode allows
949 * the EfiBootServices memory to be freed slightly earlier on boot.
951 void __init
acpi_early_init(void)
958 printk(KERN_INFO PREFIX
"Core revision %08x\n", ACPI_CA_VERSION
);
960 /* It's safe to verify table checksums during late stage */
961 acpi_gbl_verify_table_checksum
= TRUE
;
963 /* enable workarounds, unless strict ACPI spec. compliance */
965 acpi_gbl_enable_interpreter_slack
= TRUE
;
967 acpi_gbl_permanent_mmap
= 1;
970 * If the machine falls into the DMI check table,
971 * DSDT will be copied to memory
973 dmi_check_system(dsdt_dmi_table
);
975 status
= acpi_reallocate_root_table();
976 if (ACPI_FAILURE(status
)) {
977 printk(KERN_ERR PREFIX
978 "Unable to reallocate ACPI tables\n");
982 status
= acpi_initialize_subsystem();
983 if (ACPI_FAILURE(status
)) {
984 printk(KERN_ERR PREFIX
985 "Unable to initialize the ACPI Interpreter\n");
989 if (!acpi_gbl_parse_table_as_term_list
&&
990 acpi_gbl_group_module_level_code
) {
991 status
= acpi_load_tables();
992 if (ACPI_FAILURE(status
)) {
993 printk(KERN_ERR PREFIX
994 "Unable to load the System Description Tables\n");
1001 /* compatible (0) means level (3) */
1002 if (!(acpi_sci_flags
& ACPI_MADT_TRIGGER_MASK
)) {
1003 acpi_sci_flags
&= ~ACPI_MADT_TRIGGER_MASK
;
1004 acpi_sci_flags
|= ACPI_MADT_TRIGGER_LEVEL
;
1006 /* Set PIC-mode SCI trigger type */
1007 acpi_pic_sci_set_trigger(acpi_gbl_FADT
.sci_interrupt
,
1008 (acpi_sci_flags
& ACPI_MADT_TRIGGER_MASK
) >> 2);
1011 * now that acpi_gbl_FADT is initialized,
1012 * update it with result from INT_SRC_OVR parsing
1014 acpi_gbl_FADT
.sci_interrupt
= acpi_sci_override_gsi
;
1024 * acpi_subsystem_init - Finalize the early initialization of ACPI.
1026 * Switch over the platform to the ACPI mode (if possible).
1028 * Doing this too early is generally unsafe, but at the same time it needs to be
1029 * done before all things that really depend on ACPI. The right spot appears to
1030 * be before finalizing the EFI initialization.
1032 void __init
acpi_subsystem_init(void)
1039 status
= acpi_enable_subsystem(~ACPI_NO_ACPI_ENABLE
);
1040 if (ACPI_FAILURE(status
)) {
1041 printk(KERN_ERR PREFIX
"Unable to enable ACPI\n");
1045 * If the system is using ACPI then we can be reasonably
1046 * confident that any regulators are managed by the firmware
1047 * so tell the regulator core it has everything it needs to
1050 regulator_has_full_constraints();
1054 static acpi_status
acpi_bus_table_handler(u32 event
, void *table
, void *context
)
1056 acpi_scan_table_handler(event
, table
, context
);
1058 return acpi_sysfs_table_handler(event
, table
, context
);
1061 static int __init
acpi_bus_init(void)
1066 acpi_os_initialize1();
1069 * ACPI 2.0 requires the EC driver to be loaded and work before
1070 * the EC device is found in the namespace (i.e. before
1071 * acpi_load_tables() is called).
1073 * This is accomplished by looking for the ECDT table, and getting
1074 * the EC parameters out of that.
1076 status
= acpi_ec_ecdt_probe();
1077 /* Ignore result. Not having an ECDT is not fatal. */
1079 if (acpi_gbl_parse_table_as_term_list
||
1080 !acpi_gbl_group_module_level_code
) {
1081 status
= acpi_load_tables();
1082 if (ACPI_FAILURE(status
)) {
1083 printk(KERN_ERR PREFIX
1084 "Unable to load the System Description Tables\n");
1089 status
= acpi_enable_subsystem(ACPI_NO_ACPI_ENABLE
);
1090 if (ACPI_FAILURE(status
)) {
1091 printk(KERN_ERR PREFIX
1092 "Unable to start the ACPI Interpreter\n");
1096 status
= acpi_initialize_objects(ACPI_FULL_INITIALIZATION
);
1097 if (ACPI_FAILURE(status
)) {
1098 printk(KERN_ERR PREFIX
"Unable to initialize ACPI objects\n");
1102 /* Set capability bits for _OSC under processor scope */
1103 acpi_early_processor_osc();
1106 * _OSC method may exist in module level code,
1107 * so it must be run after ACPI_FULL_INITIALIZATION
1109 acpi_bus_osc_support();
1112 * _PDC control method may load dynamic SSDT tables,
1113 * and we need to install the table handler before that.
1115 status
= acpi_install_table_handler(acpi_bus_table_handler
, NULL
);
1119 acpi_early_processor_set_pdc();
1122 * Maybe EC region is required at bus_scan/acpi_get_devices. So it
1123 * is necessary to enable it as early as possible.
1125 acpi_ec_dsdt_probe();
1127 printk(KERN_INFO PREFIX
"Interpreter enabled\n");
1129 /* Initialize sleep structures */
1133 * Get the system interrupt model and evaluate \_PIC.
1135 result
= acpi_bus_init_irq();
1140 * Register the for all standard device notifications.
1143 acpi_install_notify_handler(ACPI_ROOT_OBJECT
, ACPI_SYSTEM_NOTIFY
,
1144 &acpi_bus_notify
, NULL
);
1145 if (ACPI_FAILURE(status
)) {
1146 printk(KERN_ERR PREFIX
1147 "Unable to register for device notifications\n");
1152 * Create the top ACPI proc directory
1154 acpi_root_dir
= proc_mkdir(ACPI_BUS_FILE_ROOT
, NULL
);
1156 result
= bus_register(&acpi_bus_type
);
1160 /* Mimic structured exception handling */
1166 struct kobject
*acpi_kobj
;
1167 EXPORT_SYMBOL_GPL(acpi_kobj
);
1169 static int __init
acpi_init(void)
1173 if (acpi_disabled
) {
1174 printk(KERN_INFO PREFIX
"Interpreter disabled.\n");
1178 acpi_kobj
= kobject_create_and_add("acpi", firmware_kobj
);
1180 printk(KERN_WARNING
"%s: kset create error\n", __func__
);
1184 init_acpi_device_notify();
1185 result
= acpi_bus_init();
1191 pci_mmcfg_late_init();
1195 acpi_debugfs_init();
1196 acpi_sleep_proc_init();
1197 acpi_wakeup_device_init();
1198 acpi_debugger_init();
1199 acpi_setup_sb_notify_handler();
1200 acpi_set_processor_mapping();
1204 subsys_initcall(acpi_init
);