objtool: Allow AR to be overridden with HOSTAR
[linux/fpc-iii.git] / drivers / acpi / bus.c
blobeec263c9019e4bd9d200cf6903857f620da962fb
1 /*
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>
27 #include <linux/pm.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>
36 #ifdef CONFIG_X86
37 #include <asm/mpspec.h>
38 #include <linux/dmi.h>
39 #endif
40 #include <linux/acpi_iort.h>
41 #include <linux/pci.h>
42 #include <acpi/apei.h>
43 #include <linux/suspend.h>
45 #include "internal.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);
54 #ifdef CONFIG_X86
55 #ifdef CONFIG_ACPI_CUSTOM_DSDT
56 static inline int set_copy_dsdt(const struct dmi_system_id *id)
58 return 0;
60 #else
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;
66 return 0;
68 #endif
70 static const struct dmi_system_id dsdt_dmi_table[] __initconst = {
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",
78 .matches = {
79 DMI_MATCH(DMI_SYS_VENDOR, "TOSHIBA"),
80 DMI_MATCH(DMI_PRODUCT_NAME, "Satellite"),
85 #endif
87 /* --------------------------------------------------------------------------
88 Device Management
89 -------------------------------------------------------------------------- */
91 acpi_status acpi_bus_get_status_handle(acpi_handle handle,
92 unsigned long long *sta)
94 acpi_status status;
96 status = acpi_evaluate_integer(handle, "_STA", NULL, sta);
97 if (ACPI_SUCCESS(status))
98 return AE_OK;
100 if (status == AE_NOT_FOUND) {
101 *sta = ACPI_STA_DEVICE_PRESENT | ACPI_STA_DEVICE_ENABLED |
102 ACPI_STA_DEVICE_UI | ACPI_STA_DEVICE_FUNCTIONING;
103 return AE_OK;
105 return status;
107 EXPORT_SYMBOL_GPL(acpi_bus_get_status_handle);
109 int acpi_bus_get_status(struct acpi_device *device)
111 acpi_status status;
112 unsigned long long sta;
114 if (acpi_device_always_present(device)) {
115 acpi_set_device_status(device, ACPI_STA_DEFAULT);
116 return 0;
119 /* Battery devices must have their deps met before calling _STA */
120 if (acpi_device_is_battery(device) && device->dep_unmet) {
121 acpi_set_device_status(device, 0);
122 return 0;
125 status = acpi_bus_get_status_handle(device->handle, &sta);
126 if (ACPI_FAILURE(status))
127 return -ENODEV;
129 acpi_set_device_status(device, sta);
131 if (device->status.functional && !device->status.present) {
132 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Device [%s] status [%08x]: "
133 "functional but not present;\n",
134 device->pnp.bus_id, (u32)sta));
137 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Device [%s] status [%08x]\n",
138 device->pnp.bus_id, (u32)sta));
139 return 0;
141 EXPORT_SYMBOL(acpi_bus_get_status);
143 void acpi_bus_private_data_handler(acpi_handle handle,
144 void *context)
146 return;
148 EXPORT_SYMBOL(acpi_bus_private_data_handler);
150 int acpi_bus_attach_private_data(acpi_handle handle, void *data)
152 acpi_status status;
154 status = acpi_attach_data(handle,
155 acpi_bus_private_data_handler, data);
156 if (ACPI_FAILURE(status)) {
157 acpi_handle_debug(handle, "Error attaching device data\n");
158 return -ENODEV;
161 return 0;
163 EXPORT_SYMBOL_GPL(acpi_bus_attach_private_data);
165 int acpi_bus_get_private_data(acpi_handle handle, void **data)
167 acpi_status status;
169 if (!*data)
170 return -EINVAL;
172 status = acpi_get_data(handle, acpi_bus_private_data_handler, data);
173 if (ACPI_FAILURE(status)) {
174 acpi_handle_debug(handle, "No context for object\n");
175 return -ENODEV;
178 return 0;
180 EXPORT_SYMBOL_GPL(acpi_bus_get_private_data);
182 void acpi_bus_detach_private_data(acpi_handle handle)
184 acpi_detach_data(handle, acpi_bus_private_data_handler);
186 EXPORT_SYMBOL_GPL(acpi_bus_detach_private_data);
188 static void acpi_print_osc_error(acpi_handle handle,
189 struct acpi_osc_context *context, char *error)
191 int i;
193 acpi_handle_debug(handle, "(%s): %s\n", context->uuid_str, error);
195 pr_debug("_OSC request data:");
196 for (i = 0; i < context->cap.length; i += sizeof(u32))
197 pr_debug(" %x", *((u32 *)(context->cap.pointer + i)));
199 pr_debug("\n");
202 acpi_status acpi_run_osc(acpi_handle handle, struct acpi_osc_context *context)
204 acpi_status status;
205 struct acpi_object_list input;
206 union acpi_object in_params[4];
207 union acpi_object *out_obj;
208 guid_t guid;
209 u32 errors;
210 struct acpi_buffer output = {ACPI_ALLOCATE_BUFFER, NULL};
212 if (!context)
213 return AE_ERROR;
214 if (guid_parse(context->uuid_str, &guid))
215 return AE_ERROR;
216 context->ret.length = ACPI_ALLOCATE_BUFFER;
217 context->ret.pointer = NULL;
219 /* Setting up input parameters */
220 input.count = 4;
221 input.pointer = in_params;
222 in_params[0].type = ACPI_TYPE_BUFFER;
223 in_params[0].buffer.length = 16;
224 in_params[0].buffer.pointer = (u8 *)&guid;
225 in_params[1].type = ACPI_TYPE_INTEGER;
226 in_params[1].integer.value = context->rev;
227 in_params[2].type = ACPI_TYPE_INTEGER;
228 in_params[2].integer.value = context->cap.length/sizeof(u32);
229 in_params[3].type = ACPI_TYPE_BUFFER;
230 in_params[3].buffer.length = context->cap.length;
231 in_params[3].buffer.pointer = context->cap.pointer;
233 status = acpi_evaluate_object(handle, "_OSC", &input, &output);
234 if (ACPI_FAILURE(status))
235 return status;
237 if (!output.length)
238 return AE_NULL_OBJECT;
240 out_obj = output.pointer;
241 if (out_obj->type != ACPI_TYPE_BUFFER
242 || out_obj->buffer.length != context->cap.length) {
243 acpi_print_osc_error(handle, context,
244 "_OSC evaluation returned wrong type");
245 status = AE_TYPE;
246 goto out_kfree;
248 /* Need to ignore the bit0 in result code */
249 errors = *((u32 *)out_obj->buffer.pointer) & ~(1 << 0);
250 if (errors) {
251 if (errors & OSC_REQUEST_ERROR)
252 acpi_print_osc_error(handle, context,
253 "_OSC request failed");
254 if (errors & OSC_INVALID_UUID_ERROR)
255 acpi_print_osc_error(handle, context,
256 "_OSC invalid UUID");
257 if (errors & OSC_INVALID_REVISION_ERROR)
258 acpi_print_osc_error(handle, context,
259 "_OSC invalid revision");
260 if (errors & OSC_CAPABILITIES_MASK_ERROR) {
261 if (((u32 *)context->cap.pointer)[OSC_QUERY_DWORD]
262 & OSC_QUERY_ENABLE)
263 goto out_success;
264 status = AE_SUPPORT;
265 goto out_kfree;
267 status = AE_ERROR;
268 goto out_kfree;
270 out_success:
271 context->ret.length = out_obj->buffer.length;
272 context->ret.pointer = kmemdup(out_obj->buffer.pointer,
273 context->ret.length, GFP_KERNEL);
274 if (!context->ret.pointer) {
275 status = AE_NO_MEMORY;
276 goto out_kfree;
278 status = AE_OK;
280 out_kfree:
281 kfree(output.pointer);
282 if (status != AE_OK)
283 context->ret.pointer = NULL;
284 return status;
286 EXPORT_SYMBOL(acpi_run_osc);
288 bool osc_sb_apei_support_acked;
291 * ACPI 6.0 Section 8.4.4.2 Idle State Coordination
292 * OSPM supports platform coordinated low power idle(LPI) states
294 bool osc_pc_lpi_support_confirmed;
295 EXPORT_SYMBOL_GPL(osc_pc_lpi_support_confirmed);
297 static u8 sb_uuid_str[] = "0811B06E-4A27-44F9-8D60-3CBBC22E7B48";
298 static void acpi_bus_osc_support(void)
300 u32 capbuf[2];
301 struct acpi_osc_context context = {
302 .uuid_str = sb_uuid_str,
303 .rev = 1,
304 .cap.length = 8,
305 .cap.pointer = capbuf,
307 acpi_handle handle;
309 capbuf[OSC_QUERY_DWORD] = OSC_QUERY_ENABLE;
310 capbuf[OSC_SUPPORT_DWORD] = OSC_SB_PR3_SUPPORT; /* _PR3 is in use */
311 if (IS_ENABLED(CONFIG_ACPI_PROCESSOR_AGGREGATOR))
312 capbuf[OSC_SUPPORT_DWORD] |= OSC_SB_PAD_SUPPORT;
313 if (IS_ENABLED(CONFIG_ACPI_PROCESSOR))
314 capbuf[OSC_SUPPORT_DWORD] |= OSC_SB_PPC_OST_SUPPORT;
316 capbuf[OSC_SUPPORT_DWORD] |= OSC_SB_HOTPLUG_OST_SUPPORT;
317 capbuf[OSC_SUPPORT_DWORD] |= OSC_SB_PCLPI_SUPPORT;
319 #ifdef CONFIG_X86
320 if (boot_cpu_has(X86_FEATURE_HWP)) {
321 capbuf[OSC_SUPPORT_DWORD] |= OSC_SB_CPC_SUPPORT;
322 capbuf[OSC_SUPPORT_DWORD] |= OSC_SB_CPCV2_SUPPORT;
324 #endif
326 if (IS_ENABLED(CONFIG_SCHED_MC_PRIO))
327 capbuf[OSC_SUPPORT_DWORD] |= OSC_SB_CPC_DIVERSE_HIGH_SUPPORT;
329 if (!ghes_disable)
330 capbuf[OSC_SUPPORT_DWORD] |= OSC_SB_APEI_SUPPORT;
331 if (ACPI_FAILURE(acpi_get_handle(NULL, "\\_SB", &handle)))
332 return;
333 if (ACPI_SUCCESS(acpi_run_osc(handle, &context))) {
334 u32 *capbuf_ret = context.ret.pointer;
335 if (context.ret.length > OSC_SUPPORT_DWORD) {
336 osc_sb_apei_support_acked =
337 capbuf_ret[OSC_SUPPORT_DWORD] & OSC_SB_APEI_SUPPORT;
338 osc_pc_lpi_support_confirmed =
339 capbuf_ret[OSC_SUPPORT_DWORD] & OSC_SB_PCLPI_SUPPORT;
341 kfree(context.ret.pointer);
343 /* do we need to check other returned cap? Sounds no */
346 /* --------------------------------------------------------------------------
347 Notification Handling
348 -------------------------------------------------------------------------- */
351 * acpi_bus_notify
352 * ---------------
353 * Callback for all 'system-level' device notifications (values 0x00-0x7F).
355 static void acpi_bus_notify(acpi_handle handle, u32 type, void *data)
357 struct acpi_device *adev;
358 struct acpi_driver *driver;
359 u32 ost_code = ACPI_OST_SC_NON_SPECIFIC_FAILURE;
360 bool hotplug_event = false;
362 switch (type) {
363 case ACPI_NOTIFY_BUS_CHECK:
364 acpi_handle_debug(handle, "ACPI_NOTIFY_BUS_CHECK event\n");
365 hotplug_event = true;
366 break;
368 case ACPI_NOTIFY_DEVICE_CHECK:
369 acpi_handle_debug(handle, "ACPI_NOTIFY_DEVICE_CHECK event\n");
370 hotplug_event = true;
371 break;
373 case ACPI_NOTIFY_DEVICE_WAKE:
374 acpi_handle_debug(handle, "ACPI_NOTIFY_DEVICE_WAKE event\n");
375 break;
377 case ACPI_NOTIFY_EJECT_REQUEST:
378 acpi_handle_debug(handle, "ACPI_NOTIFY_EJECT_REQUEST event\n");
379 hotplug_event = true;
380 break;
382 case ACPI_NOTIFY_DEVICE_CHECK_LIGHT:
383 acpi_handle_debug(handle, "ACPI_NOTIFY_DEVICE_CHECK_LIGHT event\n");
384 /* TBD: Exactly what does 'light' mean? */
385 break;
387 case ACPI_NOTIFY_FREQUENCY_MISMATCH:
388 acpi_handle_err(handle, "Device cannot be configured due "
389 "to a frequency mismatch\n");
390 break;
392 case ACPI_NOTIFY_BUS_MODE_MISMATCH:
393 acpi_handle_err(handle, "Device cannot be configured due "
394 "to a bus mode mismatch\n");
395 break;
397 case ACPI_NOTIFY_POWER_FAULT:
398 acpi_handle_err(handle, "Device has suffered a power fault\n");
399 break;
401 default:
402 acpi_handle_debug(handle, "Unknown event type 0x%x\n", type);
403 break;
406 adev = acpi_bus_get_acpi_device(handle);
407 if (!adev)
408 goto err;
410 driver = adev->driver;
411 if (driver && driver->ops.notify &&
412 (driver->flags & ACPI_DRIVER_ALL_NOTIFY_EVENTS))
413 driver->ops.notify(adev, type);
415 if (!hotplug_event) {
416 acpi_bus_put_acpi_device(adev);
417 return;
420 if (ACPI_SUCCESS(acpi_hotplug_schedule(adev, type)))
421 return;
423 acpi_bus_put_acpi_device(adev);
425 err:
426 acpi_evaluate_ost(handle, type, ost_code, NULL);
429 static void acpi_device_notify(acpi_handle handle, u32 event, void *data)
431 struct acpi_device *device = data;
433 device->driver->ops.notify(device, event);
436 static void acpi_device_notify_fixed(void *data)
438 struct acpi_device *device = data;
440 /* Fixed hardware devices have no handles */
441 acpi_device_notify(NULL, ACPI_FIXED_HARDWARE_EVENT, device);
444 static u32 acpi_device_fixed_event(void *data)
446 acpi_os_execute(OSL_NOTIFY_HANDLER, acpi_device_notify_fixed, data);
447 return ACPI_INTERRUPT_HANDLED;
450 static int acpi_device_install_notify_handler(struct acpi_device *device)
452 acpi_status status;
454 if (device->device_type == ACPI_BUS_TYPE_POWER_BUTTON)
455 status =
456 acpi_install_fixed_event_handler(ACPI_EVENT_POWER_BUTTON,
457 acpi_device_fixed_event,
458 device);
459 else if (device->device_type == ACPI_BUS_TYPE_SLEEP_BUTTON)
460 status =
461 acpi_install_fixed_event_handler(ACPI_EVENT_SLEEP_BUTTON,
462 acpi_device_fixed_event,
463 device);
464 else
465 status = acpi_install_notify_handler(device->handle,
466 ACPI_DEVICE_NOTIFY,
467 acpi_device_notify,
468 device);
470 if (ACPI_FAILURE(status))
471 return -EINVAL;
472 return 0;
475 static void acpi_device_remove_notify_handler(struct acpi_device *device)
477 if (device->device_type == ACPI_BUS_TYPE_POWER_BUTTON)
478 acpi_remove_fixed_event_handler(ACPI_EVENT_POWER_BUTTON,
479 acpi_device_fixed_event);
480 else if (device->device_type == ACPI_BUS_TYPE_SLEEP_BUTTON)
481 acpi_remove_fixed_event_handler(ACPI_EVENT_SLEEP_BUTTON,
482 acpi_device_fixed_event);
483 else
484 acpi_remove_notify_handler(device->handle, ACPI_DEVICE_NOTIFY,
485 acpi_device_notify);
488 /* Handle events targeting \_SB device (at present only graceful shutdown) */
490 #define ACPI_SB_NOTIFY_SHUTDOWN_REQUEST 0x81
491 #define ACPI_SB_INDICATE_INTERVAL 10000
493 static void sb_notify_work(struct work_struct *dummy)
495 acpi_handle sb_handle;
497 orderly_poweroff(true);
500 * After initiating graceful shutdown, the ACPI spec requires OSPM
501 * to evaluate _OST method once every 10seconds to indicate that
502 * the shutdown is in progress
504 acpi_get_handle(NULL, "\\_SB", &sb_handle);
505 while (1) {
506 pr_info("Graceful shutdown in progress.\n");
507 acpi_evaluate_ost(sb_handle, ACPI_OST_EC_OSPM_SHUTDOWN,
508 ACPI_OST_SC_OS_SHUTDOWN_IN_PROGRESS, NULL);
509 msleep(ACPI_SB_INDICATE_INTERVAL);
513 static void acpi_sb_notify(acpi_handle handle, u32 event, void *data)
515 static DECLARE_WORK(acpi_sb_work, sb_notify_work);
517 if (event == ACPI_SB_NOTIFY_SHUTDOWN_REQUEST) {
518 if (!work_busy(&acpi_sb_work))
519 schedule_work(&acpi_sb_work);
520 } else
521 pr_warn("event %x is not supported by \\_SB device\n", event);
524 static int __init acpi_setup_sb_notify_handler(void)
526 acpi_handle sb_handle;
528 if (ACPI_FAILURE(acpi_get_handle(NULL, "\\_SB", &sb_handle)))
529 return -ENXIO;
531 if (ACPI_FAILURE(acpi_install_notify_handler(sb_handle, ACPI_DEVICE_NOTIFY,
532 acpi_sb_notify, NULL)))
533 return -EINVAL;
535 return 0;
538 /* --------------------------------------------------------------------------
539 Device Matching
540 -------------------------------------------------------------------------- */
543 * acpi_get_first_physical_node - Get first physical node of an ACPI device
544 * @adev: ACPI device in question
546 * Return: First physical node of ACPI device @adev
548 struct device *acpi_get_first_physical_node(struct acpi_device *adev)
550 struct mutex *physical_node_lock = &adev->physical_node_lock;
551 struct device *phys_dev;
553 mutex_lock(physical_node_lock);
554 if (list_empty(&adev->physical_node_list)) {
555 phys_dev = NULL;
556 } else {
557 const struct acpi_device_physical_node *node;
559 node = list_first_entry(&adev->physical_node_list,
560 struct acpi_device_physical_node, node);
562 phys_dev = node->dev;
564 mutex_unlock(physical_node_lock);
565 return phys_dev;
568 static struct acpi_device *acpi_primary_dev_companion(struct acpi_device *adev,
569 const struct device *dev)
571 const struct device *phys_dev = acpi_get_first_physical_node(adev);
573 return phys_dev && phys_dev == dev ? adev : NULL;
577 * acpi_device_is_first_physical_node - Is given dev first physical node
578 * @adev: ACPI companion device
579 * @dev: Physical device to check
581 * Function checks if given @dev is the first physical devices attached to
582 * the ACPI companion device. This distinction is needed in some cases
583 * where the same companion device is shared between many physical devices.
585 * Note that the caller have to provide valid @adev pointer.
587 bool acpi_device_is_first_physical_node(struct acpi_device *adev,
588 const struct device *dev)
590 return !!acpi_primary_dev_companion(adev, dev);
594 * acpi_companion_match() - Can we match via ACPI companion device
595 * @dev: Device in question
597 * Check if the given device has an ACPI companion and if that companion has
598 * a valid list of PNP IDs, and if the device is the first (primary) physical
599 * device associated with it. Return the companion pointer if that's the case
600 * or NULL otherwise.
602 * If multiple physical devices are attached to a single ACPI companion, we need
603 * to be careful. The usage scenario for this kind of relationship is that all
604 * of the physical devices in question use resources provided by the ACPI
605 * companion. A typical case is an MFD device where all the sub-devices share
606 * the parent's ACPI companion. In such cases we can only allow the primary
607 * (first) physical device to be matched with the help of the companion's PNP
608 * IDs.
610 * Additional physical devices sharing the ACPI companion can still use
611 * resources available from it but they will be matched normally using functions
612 * provided by their bus types (and analogously for their modalias).
614 struct acpi_device *acpi_companion_match(const struct device *dev)
616 struct acpi_device *adev;
618 adev = ACPI_COMPANION(dev);
619 if (!adev)
620 return NULL;
622 if (list_empty(&adev->pnp.ids))
623 return NULL;
625 return acpi_primary_dev_companion(adev, dev);
629 * acpi_of_match_device - Match device object using the "compatible" property.
630 * @adev: ACPI device object to match.
631 * @of_match_table: List of device IDs to match against.
632 * @of_id: OF ID if matched
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,
640 const struct of_device_id **of_id)
642 const union acpi_object *of_compatible, *obj;
643 int i, nval;
645 if (!adev)
646 return false;
648 of_compatible = adev->data.of_compatible;
649 if (!of_match_table || !of_compatible)
650 return false;
652 if (of_compatible->type == ACPI_TYPE_PACKAGE) {
653 nval = of_compatible->package.count;
654 obj = of_compatible->package.elements;
655 } else { /* Must be ACPI_TYPE_STRING. */
656 nval = 1;
657 obj = of_compatible;
659 /* Now we can look for the driver DT compatible strings */
660 for (i = 0; i < nval; i++, obj++) {
661 const struct of_device_id *id;
663 for (id = of_match_table; id->compatible[0]; id++)
664 if (!strcasecmp(obj->string.pointer, id->compatible)) {
665 if (of_id)
666 *of_id = id;
667 return true;
671 return false;
674 static bool acpi_of_modalias(struct acpi_device *adev,
675 char *modalias, size_t len)
677 const union acpi_object *of_compatible;
678 const union acpi_object *obj;
679 const char *str, *chr;
681 of_compatible = adev->data.of_compatible;
682 if (!of_compatible)
683 return false;
685 if (of_compatible->type == ACPI_TYPE_PACKAGE)
686 obj = of_compatible->package.elements;
687 else /* Must be ACPI_TYPE_STRING. */
688 obj = of_compatible;
690 str = obj->string.pointer;
691 chr = strchr(str, ',');
692 strlcpy(modalias, chr ? chr + 1 : str, len);
694 return true;
698 * acpi_set_modalias - Set modalias using "compatible" property or supplied ID
699 * @adev: ACPI device object to match
700 * @default_id: ID string to use as default if no compatible string found
701 * @modalias: Pointer to buffer that modalias value will be copied into
702 * @len: Length of modalias buffer
704 * This is a counterpart of of_modalias_node() for struct acpi_device objects.
705 * If there is a compatible string for @adev, it will be copied to @modalias
706 * with the vendor prefix stripped; otherwise, @default_id will be used.
708 void acpi_set_modalias(struct acpi_device *adev, const char *default_id,
709 char *modalias, size_t len)
711 if (!acpi_of_modalias(adev, modalias, len))
712 strlcpy(modalias, default_id, len);
714 EXPORT_SYMBOL_GPL(acpi_set_modalias);
716 static bool __acpi_match_device_cls(const struct acpi_device_id *id,
717 struct acpi_hardware_id *hwid)
719 int i, msk, byte_shift;
720 char buf[3];
722 if (!id->cls)
723 return false;
725 /* Apply class-code bitmask, before checking each class-code byte */
726 for (i = 1; i <= 3; i++) {
727 byte_shift = 8 * (3 - i);
728 msk = (id->cls_msk >> byte_shift) & 0xFF;
729 if (!msk)
730 continue;
732 sprintf(buf, "%02x", (id->cls >> byte_shift) & msk);
733 if (strncmp(buf, &hwid->id[(i - 1) * 2], 2))
734 return false;
736 return true;
739 static bool __acpi_match_device(struct acpi_device *device,
740 const struct acpi_device_id *acpi_ids,
741 const struct of_device_id *of_ids,
742 const struct acpi_device_id **acpi_id,
743 const struct of_device_id **of_id)
745 const struct acpi_device_id *id;
746 struct acpi_hardware_id *hwid;
749 * If the device is not present, it is unnecessary to load device
750 * driver for it.
752 if (!device || !device->status.present)
753 return false;
755 list_for_each_entry(hwid, &device->pnp.ids, list) {
756 /* First, check the ACPI/PNP IDs provided by the caller. */
757 if (acpi_ids) {
758 for (id = acpi_ids; id->id[0] || id->cls; id++) {
759 if (id->id[0] && !strcmp((char *)id->id, hwid->id))
760 goto out_acpi_match;
761 if (id->cls && __acpi_match_device_cls(id, hwid))
762 goto out_acpi_match;
767 * Next, check ACPI_DT_NAMESPACE_HID and try to match the
768 * "compatible" property if found.
770 if (!strcmp(ACPI_DT_NAMESPACE_HID, hwid->id))
771 return acpi_of_match_device(device, of_ids, of_id);
773 return false;
775 out_acpi_match:
776 if (acpi_id)
777 *acpi_id = id;
778 return true;
782 * acpi_match_device - Match a struct device against a given list of ACPI IDs
783 * @ids: Array of struct acpi_device_id object to match against.
784 * @dev: The device structure to match.
786 * Check if @dev has a valid ACPI handle and if there is a struct acpi_device
787 * object for that handle and use that object to match against a given list of
788 * device IDs.
790 * Return a pointer to the first matching ID on success or %NULL on failure.
792 const struct acpi_device_id *acpi_match_device(const struct acpi_device_id *ids,
793 const struct device *dev)
795 const struct acpi_device_id *id = NULL;
797 __acpi_match_device(acpi_companion_match(dev), ids, NULL, &id, NULL);
798 return id;
800 EXPORT_SYMBOL_GPL(acpi_match_device);
802 static const void *acpi_of_device_get_match_data(const struct device *dev)
804 struct acpi_device *adev = ACPI_COMPANION(dev);
805 const struct of_device_id *match = NULL;
807 if (!acpi_of_match_device(adev, dev->driver->of_match_table, &match))
808 return NULL;
810 return match->data;
813 const void *acpi_device_get_match_data(const struct device *dev)
815 const struct acpi_device_id *match;
817 if (!dev->driver->acpi_match_table)
818 return acpi_of_device_get_match_data(dev);
820 match = acpi_match_device(dev->driver->acpi_match_table, dev);
821 if (!match)
822 return NULL;
824 return (const void *)match->driver_data;
826 EXPORT_SYMBOL_GPL(acpi_device_get_match_data);
828 int acpi_match_device_ids(struct acpi_device *device,
829 const struct acpi_device_id *ids)
831 return __acpi_match_device(device, ids, NULL, NULL, NULL) ? 0 : -ENOENT;
833 EXPORT_SYMBOL(acpi_match_device_ids);
835 bool acpi_driver_match_device(struct device *dev,
836 const struct device_driver *drv)
838 if (!drv->acpi_match_table)
839 return acpi_of_match_device(ACPI_COMPANION(dev),
840 drv->of_match_table,
841 NULL);
843 return __acpi_match_device(acpi_companion_match(dev),
844 drv->acpi_match_table, drv->of_match_table,
845 NULL, NULL);
847 EXPORT_SYMBOL_GPL(acpi_driver_match_device);
849 /* --------------------------------------------------------------------------
850 ACPI Driver Management
851 -------------------------------------------------------------------------- */
854 * acpi_bus_register_driver - register a driver with the ACPI bus
855 * @driver: driver being registered
857 * Registers a driver with the ACPI bus. Searches the namespace for all
858 * devices that match the driver's criteria and binds. Returns zero for
859 * success or a negative error status for failure.
861 int acpi_bus_register_driver(struct acpi_driver *driver)
863 int ret;
865 if (acpi_disabled)
866 return -ENODEV;
867 driver->drv.name = driver->name;
868 driver->drv.bus = &acpi_bus_type;
869 driver->drv.owner = driver->owner;
871 ret = driver_register(&driver->drv);
872 return ret;
875 EXPORT_SYMBOL(acpi_bus_register_driver);
878 * acpi_bus_unregister_driver - unregisters a driver with the ACPI bus
879 * @driver: driver to unregister
881 * Unregisters a driver with the ACPI bus. Searches the namespace for all
882 * devices that match the driver's criteria and unbinds.
884 void acpi_bus_unregister_driver(struct acpi_driver *driver)
886 driver_unregister(&driver->drv);
889 EXPORT_SYMBOL(acpi_bus_unregister_driver);
891 /* --------------------------------------------------------------------------
892 ACPI Bus operations
893 -------------------------------------------------------------------------- */
895 static int acpi_bus_match(struct device *dev, struct device_driver *drv)
897 struct acpi_device *acpi_dev = to_acpi_device(dev);
898 struct acpi_driver *acpi_drv = to_acpi_driver(drv);
900 return acpi_dev->flags.match_driver
901 && !acpi_match_device_ids(acpi_dev, acpi_drv->ids);
904 static int acpi_device_uevent(struct device *dev, struct kobj_uevent_env *env)
906 return __acpi_device_uevent_modalias(to_acpi_device(dev), env);
909 static int acpi_device_probe(struct device *dev)
911 struct acpi_device *acpi_dev = to_acpi_device(dev);
912 struct acpi_driver *acpi_drv = to_acpi_driver(dev->driver);
913 int ret;
915 if (acpi_dev->handler && !acpi_is_pnp_device(acpi_dev))
916 return -EINVAL;
918 if (!acpi_drv->ops.add)
919 return -ENOSYS;
921 ret = acpi_drv->ops.add(acpi_dev);
922 if (ret)
923 return ret;
925 acpi_dev->driver = acpi_drv;
926 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
927 "Driver [%s] successfully bound to device [%s]\n",
928 acpi_drv->name, acpi_dev->pnp.bus_id));
930 if (acpi_drv->ops.notify) {
931 ret = acpi_device_install_notify_handler(acpi_dev);
932 if (ret) {
933 if (acpi_drv->ops.remove)
934 acpi_drv->ops.remove(acpi_dev);
936 acpi_dev->driver = NULL;
937 acpi_dev->driver_data = NULL;
938 return ret;
942 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Found driver [%s] for device [%s]\n",
943 acpi_drv->name, acpi_dev->pnp.bus_id));
944 get_device(dev);
945 return 0;
948 static int acpi_device_remove(struct device *dev)
950 struct acpi_device *acpi_dev = to_acpi_device(dev);
951 struct acpi_driver *acpi_drv = acpi_dev->driver;
953 if (acpi_drv) {
954 if (acpi_drv->ops.notify)
955 acpi_device_remove_notify_handler(acpi_dev);
956 if (acpi_drv->ops.remove)
957 acpi_drv->ops.remove(acpi_dev);
959 acpi_dev->driver = NULL;
960 acpi_dev->driver_data = NULL;
962 put_device(dev);
963 return 0;
966 struct bus_type acpi_bus_type = {
967 .name = "acpi",
968 .match = acpi_bus_match,
969 .probe = acpi_device_probe,
970 .remove = acpi_device_remove,
971 .uevent = acpi_device_uevent,
974 /* --------------------------------------------------------------------------
975 Initialization/Cleanup
976 -------------------------------------------------------------------------- */
978 static int __init acpi_bus_init_irq(void)
980 acpi_status status;
981 char *message = NULL;
985 * Let the system know what interrupt model we are using by
986 * evaluating the \_PIC object, if exists.
989 switch (acpi_irq_model) {
990 case ACPI_IRQ_MODEL_PIC:
991 message = "PIC";
992 break;
993 case ACPI_IRQ_MODEL_IOAPIC:
994 message = "IOAPIC";
995 break;
996 case ACPI_IRQ_MODEL_IOSAPIC:
997 message = "IOSAPIC";
998 break;
999 case ACPI_IRQ_MODEL_GIC:
1000 message = "GIC";
1001 break;
1002 case ACPI_IRQ_MODEL_PLATFORM:
1003 message = "platform specific model";
1004 break;
1005 default:
1006 printk(KERN_WARNING PREFIX "Unknown interrupt routing model\n");
1007 return -ENODEV;
1010 printk(KERN_INFO PREFIX "Using %s for interrupt routing\n", message);
1012 status = acpi_execute_simple_method(NULL, "\\_PIC", acpi_irq_model);
1013 if (ACPI_FAILURE(status) && (status != AE_NOT_FOUND)) {
1014 ACPI_EXCEPTION((AE_INFO, status, "Evaluating _PIC"));
1015 return -ENODEV;
1018 return 0;
1022 * acpi_early_init - Initialize ACPICA and populate the ACPI namespace.
1024 * The ACPI tables are accessible after this, but the handling of events has not
1025 * been initialized and the global lock is not available yet, so AML should not
1026 * be executed at this point.
1028 * Doing this before switching the EFI runtime services to virtual mode allows
1029 * the EfiBootServices memory to be freed slightly earlier on boot.
1031 void __init acpi_early_init(void)
1033 acpi_status status;
1035 if (acpi_disabled)
1036 return;
1038 printk(KERN_INFO PREFIX "Core revision %08x\n", ACPI_CA_VERSION);
1040 /* enable workarounds, unless strict ACPI spec. compliance */
1041 if (!acpi_strict)
1042 acpi_gbl_enable_interpreter_slack = TRUE;
1044 acpi_permanent_mmap = true;
1046 #ifdef CONFIG_X86
1048 * If the machine falls into the DMI check table,
1049 * DSDT will be copied to memory.
1050 * Note that calling dmi_check_system() here on other architectures
1051 * would not be OK because only x86 initializes dmi early enough.
1052 * Thankfully only x86 systems need such quirks for now.
1054 dmi_check_system(dsdt_dmi_table);
1055 #endif
1057 status = acpi_reallocate_root_table();
1058 if (ACPI_FAILURE(status)) {
1059 printk(KERN_ERR PREFIX
1060 "Unable to reallocate ACPI tables\n");
1061 goto error0;
1064 status = acpi_initialize_subsystem();
1065 if (ACPI_FAILURE(status)) {
1066 printk(KERN_ERR PREFIX
1067 "Unable to initialize the ACPI Interpreter\n");
1068 goto error0;
1071 #ifdef CONFIG_X86
1072 if (!acpi_ioapic) {
1073 /* compatible (0) means level (3) */
1074 if (!(acpi_sci_flags & ACPI_MADT_TRIGGER_MASK)) {
1075 acpi_sci_flags &= ~ACPI_MADT_TRIGGER_MASK;
1076 acpi_sci_flags |= ACPI_MADT_TRIGGER_LEVEL;
1078 /* Set PIC-mode SCI trigger type */
1079 acpi_pic_sci_set_trigger(acpi_gbl_FADT.sci_interrupt,
1080 (acpi_sci_flags & ACPI_MADT_TRIGGER_MASK) >> 2);
1081 } else {
1083 * now that acpi_gbl_FADT is initialized,
1084 * update it with result from INT_SRC_OVR parsing
1086 acpi_gbl_FADT.sci_interrupt = acpi_sci_override_gsi;
1088 #endif
1089 return;
1091 error0:
1092 disable_acpi();
1096 * acpi_subsystem_init - Finalize the early initialization of ACPI.
1098 * Switch over the platform to the ACPI mode (if possible).
1100 * Doing this too early is generally unsafe, but at the same time it needs to be
1101 * done before all things that really depend on ACPI. The right spot appears to
1102 * be before finalizing the EFI initialization.
1104 void __init acpi_subsystem_init(void)
1106 acpi_status status;
1108 if (acpi_disabled)
1109 return;
1111 status = acpi_enable_subsystem(~ACPI_NO_ACPI_ENABLE);
1112 if (ACPI_FAILURE(status)) {
1113 printk(KERN_ERR PREFIX "Unable to enable ACPI\n");
1114 disable_acpi();
1115 } else {
1117 * If the system is using ACPI then we can be reasonably
1118 * confident that any regulators are managed by the firmware
1119 * so tell the regulator core it has everything it needs to
1120 * know.
1122 regulator_has_full_constraints();
1126 static acpi_status acpi_bus_table_handler(u32 event, void *table, void *context)
1128 acpi_scan_table_handler(event, table, context);
1130 return acpi_sysfs_table_handler(event, table, context);
1133 static int __init acpi_bus_init(void)
1135 int result;
1136 acpi_status status;
1138 acpi_os_initialize1();
1140 status = acpi_load_tables();
1141 if (ACPI_FAILURE(status)) {
1142 printk(KERN_ERR PREFIX
1143 "Unable to load the System Description Tables\n");
1144 goto error1;
1148 * ACPI 2.0 requires the EC driver to be loaded and work before the EC
1149 * device is found in the namespace.
1151 * This is accomplished by looking for the ECDT table and getting the EC
1152 * parameters out of that.
1154 * Do that before calling acpi_initialize_objects() which may trigger EC
1155 * address space accesses.
1157 acpi_ec_ecdt_probe();
1159 status = acpi_enable_subsystem(ACPI_NO_ACPI_ENABLE);
1160 if (ACPI_FAILURE(status)) {
1161 printk(KERN_ERR PREFIX
1162 "Unable to start the ACPI Interpreter\n");
1163 goto error1;
1166 status = acpi_initialize_objects(ACPI_FULL_INITIALIZATION);
1167 if (ACPI_FAILURE(status)) {
1168 printk(KERN_ERR PREFIX "Unable to initialize ACPI objects\n");
1169 goto error1;
1172 /* Set capability bits for _OSC under processor scope */
1173 acpi_early_processor_osc();
1176 * _OSC method may exist in module level code,
1177 * so it must be run after ACPI_FULL_INITIALIZATION
1179 acpi_bus_osc_support();
1182 * _PDC control method may load dynamic SSDT tables,
1183 * and we need to install the table handler before that.
1185 status = acpi_install_table_handler(acpi_bus_table_handler, NULL);
1187 acpi_sysfs_init();
1189 acpi_early_processor_set_pdc();
1192 * Maybe EC region is required at bus_scan/acpi_get_devices. So it
1193 * is necessary to enable it as early as possible.
1195 acpi_ec_dsdt_probe();
1197 printk(KERN_INFO PREFIX "Interpreter enabled\n");
1199 /* Initialize sleep structures */
1200 acpi_sleep_init();
1203 * Get the system interrupt model and evaluate \_PIC.
1205 result = acpi_bus_init_irq();
1206 if (result)
1207 goto error1;
1210 * Register the for all standard device notifications.
1212 status =
1213 acpi_install_notify_handler(ACPI_ROOT_OBJECT, ACPI_SYSTEM_NOTIFY,
1214 &acpi_bus_notify, NULL);
1215 if (ACPI_FAILURE(status)) {
1216 printk(KERN_ERR PREFIX
1217 "Unable to register for device notifications\n");
1218 goto error1;
1222 * Create the top ACPI proc directory
1224 acpi_root_dir = proc_mkdir(ACPI_BUS_FILE_ROOT, NULL);
1226 result = bus_register(&acpi_bus_type);
1227 if (!result)
1228 return 0;
1230 /* Mimic structured exception handling */
1231 error1:
1232 acpi_terminate();
1233 return -ENODEV;
1236 struct kobject *acpi_kobj;
1237 EXPORT_SYMBOL_GPL(acpi_kobj);
1239 static int __init acpi_init(void)
1241 int result;
1243 if (acpi_disabled) {
1244 printk(KERN_INFO PREFIX "Interpreter disabled.\n");
1245 return -ENODEV;
1248 acpi_kobj = kobject_create_and_add("acpi", firmware_kobj);
1249 if (!acpi_kobj) {
1250 printk(KERN_WARNING "%s: kset create error\n", __func__);
1251 acpi_kobj = NULL;
1254 result = acpi_bus_init();
1255 if (result) {
1256 disable_acpi();
1257 return result;
1260 pci_mmcfg_late_init();
1261 acpi_iort_init();
1262 acpi_scan_init();
1263 acpi_ec_init();
1264 acpi_debugfs_init();
1265 acpi_sleep_proc_init();
1266 acpi_wakeup_device_init();
1267 acpi_debugger_init();
1268 acpi_setup_sb_notify_handler();
1269 return 0;
1272 subsys_initcall(acpi_init);