2 * pci_bind.c - ACPI PCI Device Binding ($Revision: 2 $)
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>
33 #include <linux/pci.h>
34 #include <linux/acpi.h>
35 #include <acpi/acpi_bus.h>
36 #include <acpi/acpi_drivers.h>
38 #define _COMPONENT ACPI_PCI_COMPONENT
39 ACPI_MODULE_NAME("pci_bind");
41 struct acpi_pci_data {
42 struct acpi_pci_id id;
47 static int acpi_pci_unbind(struct acpi_device *device);
49 static void acpi_pci_data_handler(acpi_handle handle, u32 function,
53 /* TBD: Anything we need to do here? */
61 * This function is used by the ACPI Interpreter (a.k.a. Core Subsystem)
62 * to resolve PCI information for ACPI-PCI devices defined in the namespace.
63 * This typically occurs when resolving PCI operation region information.
65 acpi_status acpi_get_pci_id(acpi_handle handle, struct acpi_pci_id *id)
68 acpi_status status = AE_OK;
69 struct acpi_device *device = NULL;
70 struct acpi_pci_data *data = NULL;
74 return AE_BAD_PARAMETER;
76 result = acpi_bus_get_device(handle, &device);
78 printk(KERN_ERR PREFIX
79 "Invalid ACPI Bus context for device %s\n",
80 acpi_device_bid(device));
84 status = acpi_get_data(handle, acpi_pci_data_handler, (void **)&data);
85 if (ACPI_FAILURE(status) || !data) {
86 ACPI_EXCEPTION((AE_INFO, status,
87 "Invalid ACPI-PCI context for device %s",
88 acpi_device_bid(device)));
95 id->segment = data->id.segment;
96 id->bus = data->id.bus;
97 id->device = data->id.device;
98 id->function = data->id.function;
101 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
102 "Device %s has PCI address %02x:%02x:%02x.%02x\n",
103 acpi_device_bid(device), id->segment, id->bus,
104 id->device, id->function));
109 EXPORT_SYMBOL(acpi_get_pci_id);
111 int acpi_pci_bind(struct acpi_device *device)
114 acpi_status status = AE_OK;
115 struct acpi_pci_data *data = NULL;
116 struct acpi_pci_data *pdata = NULL;
117 char *pathname = NULL;
118 struct acpi_buffer buffer = { 0, NULL };
119 acpi_handle handle = NULL;
124 if (!device || !device->parent)
127 pathname = kzalloc(ACPI_PATHNAME_MAX, GFP_KERNEL);
130 buffer.length = ACPI_PATHNAME_MAX;
131 buffer.pointer = pathname;
133 data = kzalloc(sizeof(struct acpi_pci_data), GFP_KERNEL);
139 acpi_get_name(device->handle, ACPI_FULL_PATHNAME, &buffer);
140 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Binding PCI device [%s]...\n",
146 * These are obtained via the parent device's ACPI-PCI context.
148 status = acpi_get_data(device->parent->handle, acpi_pci_data_handler,
150 if (ACPI_FAILURE(status) || !pdata || !pdata->bus) {
151 ACPI_EXCEPTION((AE_INFO, status,
152 "Invalid ACPI-PCI context for parent device %s",
153 acpi_device_bid(device->parent)));
157 data->id.segment = pdata->id.segment;
158 data->id.bus = pdata->bus->number;
163 * These are simply obtained from the device's _ADR method. Note
164 * that a value of zero is valid.
166 data->id.device = device->pnp.bus_address >> 16;
167 data->id.function = device->pnp.bus_address & 0xFFFF;
169 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "...to %02x:%02x:%02x.%02x\n",
170 data->id.segment, data->id.bus, data->id.device,
174 * TBD: Support slot devices (e.g. function=0xFFFF).
180 * Locate matching device in PCI namespace. If it doesn't exist
181 * this typically means that the device isn't currently inserted
182 * (e.g. docking station, port replicator, etc.).
183 * We cannot simply search the global pci device list, since
184 * PCI devices are added to the global pci list when the root
185 * bridge start ops are run, which may not have happened yet.
187 bus = pci_find_bus(data->id.segment, data->id.bus);
189 list_for_each_entry(dev, &bus->devices, bus_list) {
190 if (dev->devfn == PCI_DEVFN(data->id.device,
191 data->id.function)) {
198 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
199 "Device %02x:%02x:%02x.%02x not present in PCI namespace\n",
200 data->id.segment, data->id.bus,
201 data->id.device, data->id.function));
205 if (!data->dev->bus) {
206 printk(KERN_ERR PREFIX
207 "Device %02x:%02x:%02x.%02x has invalid 'bus' field\n",
208 data->id.segment, data->id.bus,
209 data->id.device, data->id.function);
217 * If so, set the 'bus' field and install the 'bind' function to
218 * facilitate callbacks for all of its children.
220 if (data->dev->subordinate) {
221 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
222 "Device %02x:%02x:%02x.%02x is a PCI bridge\n",
223 data->id.segment, data->id.bus,
224 data->id.device, data->id.function));
225 data->bus = data->dev->subordinate;
226 device->ops.bind = acpi_pci_bind;
227 device->ops.unbind = acpi_pci_unbind;
231 * Attach ACPI-PCI Context
232 * -----------------------
233 * Thus binding the ACPI and PCI devices.
235 status = acpi_attach_data(device->handle, acpi_pci_data_handler, data);
236 if (ACPI_FAILURE(status)) {
237 ACPI_EXCEPTION((AE_INFO, status,
238 "Unable to attach ACPI-PCI context to device %s",
239 acpi_device_bid(device)));
247 * Evaluate and parse _PRT, if exists. This code is independent of
248 * PCI bridges (above) to allow parsing of _PRT objects within the
249 * scope of non-bridge devices. Note that _PRTs within the scope of
250 * a PCI bridge assume the bridge's subordinate bus number.
252 * TBD: Can _PRTs exist within the scope of non-bridge PCI devices?
254 status = acpi_get_handle(device->handle, METHOD_NAME__PRT, &handle);
255 if (ACPI_SUCCESS(status)) {
256 if (data->bus) /* PCI-PCI bridge */
257 acpi_pci_irq_add_prt(device->handle, data->id.segment,
259 else /* non-bridge PCI device */
260 acpi_pci_irq_add_prt(device->handle, data->id.segment,
272 static int acpi_pci_unbind(struct acpi_device *device)
275 acpi_status status = AE_OK;
276 struct acpi_pci_data *data = NULL;
277 char *pathname = NULL;
278 struct acpi_buffer buffer = { 0, NULL };
281 if (!device || !device->parent)
284 pathname = kzalloc(ACPI_PATHNAME_MAX, GFP_KERNEL);
288 buffer.length = ACPI_PATHNAME_MAX;
289 buffer.pointer = pathname;
290 acpi_get_name(device->handle, ACPI_FULL_PATHNAME, &buffer);
291 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Unbinding PCI device [%s]...\n",
296 acpi_get_data(device->handle, acpi_pci_data_handler,
298 if (ACPI_FAILURE(status)) {
303 status = acpi_detach_data(device->handle, acpi_pci_data_handler);
304 if (ACPI_FAILURE(status)) {
305 ACPI_EXCEPTION((AE_INFO, status,
306 "Unable to detach data from device %s",
307 acpi_device_bid(device)));
311 if (data->dev->subordinate) {
312 acpi_pci_irq_del_prt(data->id.segment, data->bus->number);
321 acpi_pci_bind_root(struct acpi_device *device,
322 struct acpi_pci_id *id, struct pci_bus *bus)
325 acpi_status status = AE_OK;
326 struct acpi_pci_data *data = NULL;
327 char *pathname = NULL;
328 struct acpi_buffer buffer = { 0, NULL };
330 pathname = kzalloc(ACPI_PATHNAME_MAX, GFP_KERNEL);
334 buffer.length = ACPI_PATHNAME_MAX;
335 buffer.pointer = pathname;
337 if (!device || !id || !bus) {
342 data = kzalloc(sizeof(struct acpi_pci_data), GFP_KERNEL);
350 device->ops.bind = acpi_pci_bind;
351 device->ops.unbind = acpi_pci_unbind;
353 acpi_get_name(device->handle, ACPI_FULL_PATHNAME, &buffer);
355 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Binding PCI root bridge [%s] to "
356 "%02x:%02x\n", pathname, id->segment, id->bus));
358 status = acpi_attach_data(device->handle, acpi_pci_data_handler, data);
359 if (ACPI_FAILURE(status)) {
360 ACPI_EXCEPTION((AE_INFO, status,
361 "Unable to attach ACPI-PCI context to device %s",