On Tue, Nov 06, 2007 at 02:33:53AM -0800, akpm@linux-foundation.org wrote:
[mmotm.git] / drivers / acpi / pci_root.c
blob18908cef94a7ff7b58c749d9b37199ed962e4e83
1 /*
2 * pci_root.c - ACPI PCI Root Bridge Driver ($Revision: 40 $)
4 * Copyright (C) 2001, 2002 Andy Grover <andrew.grover@intel.com>
5 * Copyright (C) 2001, 2002 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com>
7 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or (at
12 * your option) any later version.
14 * This program is distributed in the hope that it will be useful, but
15 * WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * General Public License for more details.
19 * You should have received a copy of the GNU General Public License along
20 * with this program; if not, write to the Free Software Foundation, Inc.,
21 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
23 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
26 #include <linux/kernel.h>
27 #include <linux/module.h>
28 #include <linux/init.h>
29 #include <linux/types.h>
30 #include <linux/proc_fs.h>
31 #include <linux/spinlock.h>
32 #include <linux/pm.h>
33 #include <linux/pci.h>
34 #include <linux/pci-acpi.h>
35 #include <linux/acpi.h>
36 #include <acpi/acpi_bus.h>
37 #include <acpi/acpi_drivers.h>
39 #define PREFIX "ACPI: "
41 #define _COMPONENT ACPI_PCI_COMPONENT
42 ACPI_MODULE_NAME("pci_root");
43 #define ACPI_PCI_ROOT_CLASS "pci_bridge"
44 #define ACPI_PCI_ROOT_DEVICE_NAME "PCI Root Bridge"
45 static int acpi_pci_root_add(struct acpi_device *device);
46 static int acpi_pci_root_remove(struct acpi_device *device, int type);
47 static int acpi_pci_root_start(struct acpi_device *device);
49 static struct acpi_device_id root_device_ids[] = {
50 {"PNP0A03", 0},
51 {"", 0},
53 MODULE_DEVICE_TABLE(acpi, root_device_ids);
55 static struct acpi_driver acpi_pci_root_driver = {
56 .name = "pci_root",
57 .class = ACPI_PCI_ROOT_CLASS,
58 .ids = root_device_ids,
59 .ops = {
60 .add = acpi_pci_root_add,
61 .remove = acpi_pci_root_remove,
62 .start = acpi_pci_root_start,
66 static LIST_HEAD(acpi_pci_roots);
68 static struct acpi_pci_driver *sub_driver;
69 static DEFINE_MUTEX(osc_lock);
71 int acpi_pci_register_driver(struct acpi_pci_driver *driver)
73 int n = 0;
74 struct acpi_pci_root *root;
76 struct acpi_pci_driver **pptr = &sub_driver;
77 while (*pptr)
78 pptr = &(*pptr)->next;
79 *pptr = driver;
81 if (!driver->add)
82 return 0;
84 list_for_each_entry(root, &acpi_pci_roots, node) {
85 driver->add(root->device->handle);
86 n++;
89 return n;
92 EXPORT_SYMBOL(acpi_pci_register_driver);
94 void acpi_pci_unregister_driver(struct acpi_pci_driver *driver)
96 struct acpi_pci_root *root;
98 struct acpi_pci_driver **pptr = &sub_driver;
99 while (*pptr) {
100 if (*pptr == driver)
101 break;
102 pptr = &(*pptr)->next;
104 BUG_ON(!*pptr);
105 *pptr = (*pptr)->next;
107 if (!driver->remove)
108 return;
110 list_for_each_entry(root, &acpi_pci_roots, node)
111 driver->remove(root->device->handle);
114 EXPORT_SYMBOL(acpi_pci_unregister_driver);
116 acpi_handle acpi_get_pci_rootbridge_handle(unsigned int seg, unsigned int bus)
118 struct acpi_pci_root *root;
120 list_for_each_entry(root, &acpi_pci_roots, node)
121 if ((root->segment == (u16) seg) && (root->bus_nr == (u16) bus))
122 return root->device->handle;
123 return NULL;
126 EXPORT_SYMBOL_GPL(acpi_get_pci_rootbridge_handle);
129 * acpi_is_root_bridge - determine whether an ACPI CA node is a PCI root bridge
130 * @handle - the ACPI CA node in question.
132 * Note: we could make this API take a struct acpi_device * instead, but
133 * for now, it's more convenient to operate on an acpi_handle.
135 int acpi_is_root_bridge(acpi_handle handle)
137 int ret;
138 struct acpi_device *device;
140 ret = acpi_bus_get_device(handle, &device);
141 if (ret)
142 return 0;
144 ret = acpi_match_device_ids(device, root_device_ids);
145 if (ret)
146 return 0;
147 else
148 return 1;
150 EXPORT_SYMBOL_GPL(acpi_is_root_bridge);
152 static acpi_status
153 get_root_bridge_busnr_callback(struct acpi_resource *resource, void *data)
155 int *busnr = data;
156 struct acpi_resource_address64 address;
158 if (resource->type != ACPI_RESOURCE_TYPE_ADDRESS16 &&
159 resource->type != ACPI_RESOURCE_TYPE_ADDRESS32 &&
160 resource->type != ACPI_RESOURCE_TYPE_ADDRESS64)
161 return AE_OK;
163 acpi_resource_to_address64(resource, &address);
164 if ((address.address_length > 0) &&
165 (address.resource_type == ACPI_BUS_NUMBER_RANGE))
166 *busnr = address.minimum;
168 return AE_OK;
171 static acpi_status try_get_root_bridge_busnr(acpi_handle handle,
172 unsigned long long *bus)
174 acpi_status status;
175 int busnum;
177 busnum = -1;
178 status =
179 acpi_walk_resources(handle, METHOD_NAME__CRS,
180 get_root_bridge_busnr_callback, &busnum);
181 if (ACPI_FAILURE(status))
182 return status;
183 /* Check if we really get a bus number from _CRS */
184 if (busnum == -1)
185 return AE_ERROR;
186 *bus = busnum;
187 return AE_OK;
190 static void acpi_pci_bridge_scan(struct acpi_device *device)
192 int status;
193 struct acpi_device *child = NULL;
195 if (device->flags.bus_address)
196 if (device->parent && device->parent->ops.bind) {
197 status = device->parent->ops.bind(device);
198 if (!status) {
199 list_for_each_entry(child, &device->children, node)
200 acpi_pci_bridge_scan(child);
205 static u8 OSC_UUID[16] = {0x5B, 0x4D, 0xDB, 0x33, 0xF7, 0x1F, 0x1C, 0x40,
206 0x96, 0x57, 0x74, 0x41, 0xC0, 0x3D, 0xD7, 0x66};
208 static acpi_status acpi_pci_run_osc(acpi_handle handle,
209 const u32 *capbuf, u32 *retval)
211 acpi_status status;
212 struct acpi_object_list input;
213 union acpi_object in_params[4];
214 struct acpi_buffer output = {ACPI_ALLOCATE_BUFFER, NULL};
215 union acpi_object *out_obj;
216 u32 errors;
218 /* Setting up input parameters */
219 input.count = 4;
220 input.pointer = in_params;
221 in_params[0].type = ACPI_TYPE_BUFFER;
222 in_params[0].buffer.length = 16;
223 in_params[0].buffer.pointer = OSC_UUID;
224 in_params[1].type = ACPI_TYPE_INTEGER;
225 in_params[1].integer.value = 1;
226 in_params[2].type = ACPI_TYPE_INTEGER;
227 in_params[2].integer.value = 3;
228 in_params[3].type = ACPI_TYPE_BUFFER;
229 in_params[3].buffer.length = 12;
230 in_params[3].buffer.pointer = (u8 *)capbuf;
232 status = acpi_evaluate_object(handle, "_OSC", &input, &output);
233 if (ACPI_FAILURE(status))
234 return status;
236 if (!output.length)
237 return AE_NULL_OBJECT;
239 out_obj = output.pointer;
240 if (out_obj->type != ACPI_TYPE_BUFFER) {
241 printk(KERN_DEBUG "_OSC evaluation returned wrong type\n");
242 status = AE_TYPE;
243 goto out_kfree;
245 /* Need to ignore the bit0 in result code */
246 errors = *((u32 *)out_obj->buffer.pointer) & ~(1 << 0);
247 if (errors) {
248 if (errors & OSC_REQUEST_ERROR)
249 printk(KERN_DEBUG "_OSC request failed\n");
250 if (errors & OSC_INVALID_UUID_ERROR)
251 printk(KERN_DEBUG "_OSC invalid UUID\n");
252 if (errors & OSC_INVALID_REVISION_ERROR)
253 printk(KERN_DEBUG "_OSC invalid revision\n");
254 if (errors & OSC_CAPABILITIES_MASK_ERROR) {
255 if (capbuf[OSC_QUERY_TYPE] & OSC_QUERY_ENABLE)
256 goto out_success;
257 printk(KERN_DEBUG
258 "Firmware did not grant requested _OSC control\n");
259 status = AE_SUPPORT;
260 goto out_kfree;
262 status = AE_ERROR;
263 goto out_kfree;
265 out_success:
266 *retval = *((u32 *)(out_obj->buffer.pointer + 8));
267 status = AE_OK;
269 out_kfree:
270 kfree(output.pointer);
271 return status;
274 static acpi_status acpi_pci_query_osc(struct acpi_pci_root *root, u32 flags)
276 acpi_status status;
277 u32 support_set, result, capbuf[3];
279 /* do _OSC query for all possible controls */
280 support_set = root->osc_support_set | (flags & OSC_SUPPORT_MASKS);
281 capbuf[OSC_QUERY_TYPE] = OSC_QUERY_ENABLE;
282 capbuf[OSC_SUPPORT_TYPE] = support_set;
283 capbuf[OSC_CONTROL_TYPE] = OSC_CONTROL_MASKS;
285 status = acpi_pci_run_osc(root->device->handle, capbuf, &result);
286 if (ACPI_SUCCESS(status)) {
287 root->osc_support_set = support_set;
288 root->osc_control_qry = result;
289 root->osc_queried = 1;
291 return status;
294 static acpi_status acpi_pci_osc_support(struct acpi_pci_root *root, u32 flags)
296 acpi_status status;
297 acpi_handle tmp;
299 status = acpi_get_handle(root->device->handle, "_OSC", &tmp);
300 if (ACPI_FAILURE(status))
301 return status;
302 mutex_lock(&osc_lock);
303 status = acpi_pci_query_osc(root, flags);
304 mutex_unlock(&osc_lock);
305 return status;
308 struct acpi_pci_root *acpi_pci_find_root(acpi_handle handle)
310 struct acpi_pci_root *root;
312 list_for_each_entry(root, &acpi_pci_roots, node) {
313 if (root->device->handle == handle)
314 return root;
316 return NULL;
318 EXPORT_SYMBOL_GPL(acpi_pci_find_root);
320 struct acpi_handle_node {
321 struct list_head node;
322 acpi_handle handle;
326 * acpi_get_pci_dev - convert ACPI CA handle to struct pci_dev
327 * @handle: the handle in question
329 * Given an ACPI CA handle, the desired PCI device is located in the
330 * list of PCI devices.
332 * If the device is found, its reference count is increased and this
333 * function returns a pointer to its data structure. The caller must
334 * decrement the reference count by calling pci_dev_put().
335 * If no device is found, %NULL is returned.
337 struct pci_dev *acpi_get_pci_dev(acpi_handle handle)
339 int dev, fn;
340 unsigned long long adr;
341 acpi_status status;
342 acpi_handle phandle;
343 struct pci_bus *pbus;
344 struct pci_dev *pdev = NULL;
345 struct acpi_handle_node *node, *tmp;
346 struct acpi_pci_root *root;
347 LIST_HEAD(device_list);
350 * Walk up the ACPI CA namespace until we reach a PCI root bridge.
352 phandle = handle;
353 while (!acpi_is_root_bridge(phandle)) {
354 node = kzalloc(sizeof(struct acpi_handle_node), GFP_KERNEL);
355 if (!node)
356 goto out;
358 INIT_LIST_HEAD(&node->node);
359 node->handle = phandle;
360 list_add(&node->node, &device_list);
362 status = acpi_get_parent(phandle, &phandle);
363 if (ACPI_FAILURE(status))
364 goto out;
367 root = acpi_pci_find_root(phandle);
368 if (!root)
369 goto out;
371 pbus = root->bus;
374 * Now, walk back down the PCI device tree until we return to our
375 * original handle. Assumes that everything between the PCI root
376 * bridge and the device we're looking for must be a P2P bridge.
378 list_for_each_entry(node, &device_list, node) {
379 acpi_handle hnd = node->handle;
380 status = acpi_evaluate_integer(hnd, "_ADR", NULL, &adr);
381 if (ACPI_FAILURE(status))
382 goto out;
383 dev = (adr >> 16) & 0xffff;
384 fn = adr & 0xffff;
386 pdev = pci_get_slot(pbus, PCI_DEVFN(dev, fn));
387 if (!pdev || hnd == handle)
388 break;
390 pbus = pdev->subordinate;
391 pci_dev_put(pdev);
394 * During resume from a sleep state we can get a dock
395 * notification for a device that is present in ACPI tables,
396 * but not physically accessible at the moment, so tell the
397 * caller it's not present in that case.
399 if (!pbus) {
400 dev_info(&pdev->dev, "Secondary bus not present\n");
401 pdev = NULL;
402 break;
405 out:
406 list_for_each_entry_safe(node, tmp, &device_list, node)
407 kfree(node);
409 return pdev;
411 EXPORT_SYMBOL_GPL(acpi_get_pci_dev);
414 * acpi_pci_osc_control_set - commit requested control to Firmware
415 * @handle: acpi_handle for the target ACPI object
416 * @flags: driver's requested control bits
418 * Attempt to take control from Firmware on requested control bits.
420 acpi_status acpi_pci_osc_control_set(acpi_handle handle, u32 flags)
422 acpi_status status;
423 u32 control_req, result, capbuf[3];
424 acpi_handle tmp;
425 struct acpi_pci_root *root;
427 status = acpi_get_handle(handle, "_OSC", &tmp);
428 if (ACPI_FAILURE(status))
429 return status;
431 control_req = (flags & OSC_CONTROL_MASKS);
432 if (!control_req)
433 return AE_TYPE;
435 root = acpi_pci_find_root(handle);
436 if (!root)
437 return AE_NOT_EXIST;
439 mutex_lock(&osc_lock);
440 /* No need to evaluate _OSC if the control was already granted. */
441 if ((root->osc_control_set & control_req) == control_req)
442 goto out;
444 /* Need to query controls first before requesting them */
445 if (!root->osc_queried) {
446 status = acpi_pci_query_osc(root, root->osc_support_set);
447 if (ACPI_FAILURE(status))
448 goto out;
450 if ((root->osc_control_qry & control_req) != control_req) {
451 printk(KERN_DEBUG
452 "Firmware did not grant requested _OSC control\n");
453 status = AE_SUPPORT;
454 goto out;
457 capbuf[OSC_QUERY_TYPE] = 0;
458 capbuf[OSC_SUPPORT_TYPE] = root->osc_support_set;
459 capbuf[OSC_CONTROL_TYPE] = root->osc_control_set | control_req;
460 status = acpi_pci_run_osc(handle, capbuf, &result);
461 if (ACPI_SUCCESS(status))
462 root->osc_control_set = result;
463 out:
464 mutex_unlock(&osc_lock);
465 return status;
467 EXPORT_SYMBOL(acpi_pci_osc_control_set);
469 static int __devinit acpi_pci_root_add(struct acpi_device *device)
471 unsigned long long segment, bus;
472 acpi_status status;
473 int result;
474 struct acpi_pci_root *root;
475 acpi_handle handle;
476 struct acpi_device *child;
477 u32 flags, base_flags;
479 segment = 0;
480 status = acpi_evaluate_integer(device->handle, METHOD_NAME__SEG, NULL,
481 &segment);
482 if (ACPI_FAILURE(status) && status != AE_NOT_FOUND) {
483 printk(KERN_ERR PREFIX "can't evaluate _SEG\n");
484 return -ENODEV;
487 /* Check _CRS first, then _BBN. If no _BBN, default to zero. */
488 bus = 0;
489 status = try_get_root_bridge_busnr(device->handle, &bus);
490 if (ACPI_FAILURE(status)) {
491 status = acpi_evaluate_integer(device->handle, METHOD_NAME__BBN, NULL, &bus);
492 if (ACPI_FAILURE(status) && status != AE_NOT_FOUND) {
493 printk(KERN_ERR PREFIX
494 "no bus number in _CRS and can't evaluate _BBN\n");
495 return -ENODEV;
499 root = kzalloc(sizeof(struct acpi_pci_root), GFP_KERNEL);
500 if (!root)
501 return -ENOMEM;
503 INIT_LIST_HEAD(&root->node);
504 root->device = device;
505 root->segment = segment & 0xFFFF;
506 root->bus_nr = bus & 0xFF;
507 strcpy(acpi_device_name(device), ACPI_PCI_ROOT_DEVICE_NAME);
508 strcpy(acpi_device_class(device), ACPI_PCI_ROOT_CLASS);
509 device->driver_data = root;
512 * All supported architectures that use ACPI have support for
513 * PCI domains, so we indicate this in _OSC support capabilities.
515 flags = base_flags = OSC_PCI_SEGMENT_GROUPS_SUPPORT;
516 acpi_pci_osc_support(root, flags);
519 * TBD: Need PCI interface for enumeration/configuration of roots.
522 /* TBD: Locking */
523 list_add_tail(&root->node, &acpi_pci_roots);
525 printk(KERN_INFO PREFIX "%s [%s] (%04x:%02x)\n",
526 acpi_device_name(device), acpi_device_bid(device),
527 root->segment, root->bus_nr);
530 * Scan the Root Bridge
531 * --------------------
532 * Must do this prior to any attempt to bind the root device, as the
533 * PCI namespace does not get created until this call is made (and
534 * thus the root bridge's pci_dev does not exist).
536 root->bus = pci_acpi_scan_root(device, segment, bus);
537 if (!root->bus) {
538 printk(KERN_ERR PREFIX
539 "Bus %04x:%02x not present in PCI namespace\n",
540 root->segment, root->bus_nr);
541 result = -ENODEV;
542 goto end;
546 * Attach ACPI-PCI Context
547 * -----------------------
548 * Thus binding the ACPI and PCI devices.
550 result = acpi_pci_bind_root(device);
551 if (result)
552 goto end;
555 * PCI Routing Table
556 * -----------------
557 * Evaluate and parse _PRT, if exists.
559 status = acpi_get_handle(device->handle, METHOD_NAME__PRT, &handle);
560 if (ACPI_SUCCESS(status))
561 result = acpi_pci_irq_add_prt(device->handle, root->bus);
564 * Scan and bind all _ADR-Based Devices
566 list_for_each_entry(child, &device->children, node)
567 acpi_pci_bridge_scan(child);
569 /* Indicate support for various _OSC capabilities. */
570 if (pci_ext_cfg_avail(root->bus->self))
571 flags |= OSC_EXT_PCI_CONFIG_SUPPORT;
572 if (pcie_aspm_enabled())
573 flags |= OSC_ACTIVE_STATE_PWR_SUPPORT |
574 OSC_CLOCK_PWR_CAPABILITY_SUPPORT;
575 if (pci_msi_enabled())
576 flags |= OSC_MSI_SUPPORT;
577 if (flags != base_flags)
578 acpi_pci_osc_support(root, flags);
580 return 0;
582 end:
583 if (!list_empty(&root->node))
584 list_del(&root->node);
585 kfree(root);
586 return result;
589 static int acpi_pci_root_start(struct acpi_device *device)
591 struct acpi_pci_root *root = acpi_driver_data(device);
593 pci_bus_add_devices(root->bus);
594 return 0;
597 static int acpi_pci_root_remove(struct acpi_device *device, int type)
599 struct acpi_pci_root *root = acpi_driver_data(device);
601 kfree(root);
602 return 0;
605 static int __init acpi_pci_root_init(void)
607 if (acpi_pci_disabled)
608 return 0;
610 if (acpi_bus_register_driver(&acpi_pci_root_driver) < 0)
611 return -ENODEV;
613 return 0;
616 subsys_initcall(acpi_pci_root_init);