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>
39 #define _COMPONENT ACPI_PCI_COMPONENT
40 ACPI_MODULE_NAME ("pci_bind")
42 struct acpi_pci_data {
43 struct acpi_pci_id id;
50 acpi_pci_data_handler (
55 ACPI_FUNCTION_TRACE("acpi_pci_data_handler");
57 /* TBD: Anything we need to do here? */
66 * This function is used by the ACPI Interpreter (a.k.a. Core Subsystem)
67 * to resolve PCI information for ACPI-PCI devices defined in the namespace.
68 * This typically occurs when resolving PCI operation region information.
73 struct acpi_pci_id *id)
76 acpi_status status = AE_OK;
77 struct acpi_device *device = NULL;
78 struct acpi_pci_data *data = NULL;
80 ACPI_FUNCTION_TRACE("acpi_os_get_pci_id");
83 return_ACPI_STATUS(AE_BAD_PARAMETER);
85 result = acpi_bus_get_device(handle, &device);
87 ACPI_DEBUG_PRINT((ACPI_DB_ERROR,
88 "Invalid ACPI Bus context for device %s\n",
89 acpi_device_bid(device)));
90 return_ACPI_STATUS(AE_NOT_EXIST);
93 status = acpi_get_data(handle, acpi_pci_data_handler, (void**) &data);
94 if (ACPI_FAILURE(status) || !data || !data->dev) {
95 ACPI_DEBUG_PRINT((ACPI_DB_ERROR,
96 "Invalid ACPI-PCI context for device %s\n",
97 acpi_device_bid(device)));
98 return_ACPI_STATUS(status);
104 id->segment = data->id.segment;
105 id->bus = data->id.bus;
106 id->device = data->id.device;
107 id->function = data->id.function;
110 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
111 "Device %s has PCI address %02x:%02x:%02x.%02x\n",
112 acpi_device_bid(device), id->segment, id->bus,
113 id->device, id->function));
115 return_ACPI_STATUS(AE_OK);
121 struct acpi_device *device)
124 acpi_status status = AE_OK;
125 struct acpi_pci_data *data = NULL;
126 struct acpi_pci_data *pdata = NULL;
127 char pathname[ACPI_PATHNAME_MAX] = {0};
128 struct acpi_buffer buffer = {ACPI_PATHNAME_MAX, pathname};
129 acpi_handle handle = NULL;
131 ACPI_FUNCTION_TRACE("acpi_pci_bind");
133 if (!device || !device->parent)
134 return_VALUE(-EINVAL);
136 data = kmalloc(sizeof(struct acpi_pci_data), GFP_KERNEL);
138 return_VALUE(-ENOMEM);
139 memset(data, 0, sizeof(struct acpi_pci_data));
141 acpi_get_name(device->handle, ACPI_FULL_PATHNAME, &buffer);
142 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Binding PCI device [%s]...\n",
148 * These are obtained via the parent device's ACPI-PCI context.
150 status = acpi_get_data(device->parent->handle, acpi_pci_data_handler,
152 if (ACPI_FAILURE(status) || !pdata || !pdata->bus) {
153 ACPI_DEBUG_PRINT((ACPI_DB_ERROR,
154 "Invalid ACPI-PCI context for parent device %s\n",
155 acpi_device_bid(device->parent)));
159 data->id.segment = pdata->id.segment;
160 data->id.bus = pdata->bus->number;
165 * These are simply obtained from the device's _ADR method. Note
166 * that a value of zero is valid.
168 data->id.device = device->pnp.bus_address >> 16;
169 data->id.function = device->pnp.bus_address & 0xFFFF;
171 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "...to %02x:%02x:%02x.%02x\n",
172 data->id.segment, data->id.bus, data->id.device,
176 * TBD: Support slot devices (e.g. function=0xFFFF).
182 * Locate matching device in PCI namespace. If it doesn't exist
183 * this typically means that the device isn't currently inserted
184 * (e.g. docking station, port replicator, etc.).
186 data->dev = pci_find_slot(data->id.bus, PCI_DEVFN(data->id.device, data->id.function));
188 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
189 "Device %02x:%02x:%02x.%02x not present in PCI namespace\n",
190 data->id.segment, data->id.bus,
191 data->id.device, data->id.function));
195 if (!data->dev->bus) {
196 ACPI_DEBUG_PRINT((ACPI_DB_ERROR,
197 "Device %02x:%02x:%02x.%02x has invalid 'bus' field\n",
198 data->id.segment, data->id.bus,
199 data->id.device, data->id.function));
207 * If so, set the 'bus' field and install the 'bind' function to
208 * facilitate callbacks for all of its children.
210 if (data->dev->subordinate) {
211 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
212 "Device %02x:%02x:%02x.%02x is a PCI bridge\n",
213 data->id.segment, data->id.bus,
214 data->id.device, data->id.function));
215 data->bus = data->dev->subordinate;
216 device->ops.bind = acpi_pci_bind;
220 * Attach ACPI-PCI Context
221 * -----------------------
222 * Thus binding the ACPI and PCI devices.
224 status = acpi_attach_data(device->handle, acpi_pci_data_handler, data);
225 if (ACPI_FAILURE(status)) {
226 ACPI_DEBUG_PRINT((ACPI_DB_ERROR,
227 "Unable to attach ACPI-PCI context to device %s\n",
228 acpi_device_bid(device)));
236 * Evaluate and parse _PRT, if exists. This code is independent of
237 * PCI bridges (above) to allow parsing of _PRT objects within the
238 * scope of non-bridge devices. Note that _PRTs within the scope of
239 * a PCI bridge assume the bridge's subordinate bus number.
241 * TBD: Can _PRTs exist within the scope of non-bridge PCI devices?
243 status = acpi_get_handle(device->handle, METHOD_NAME__PRT, &handle);
244 if (ACPI_SUCCESS(status)) {
245 if (data->bus) /* PCI-PCI bridge */
246 acpi_pci_irq_add_prt(device->handle, data->id.segment,
248 else /* non-bridge PCI device */
249 acpi_pci_irq_add_prt(device->handle, data->id.segment,
257 return_VALUE(result);
263 struct acpi_device *device,
264 struct acpi_pci_id *id,
268 acpi_status status = AE_OK;
269 struct acpi_pci_data *data = NULL;
270 char pathname[ACPI_PATHNAME_MAX] = {0};
271 struct acpi_buffer buffer = {ACPI_PATHNAME_MAX, pathname};
273 ACPI_FUNCTION_TRACE("acpi_pci_bind_root");
275 if (!device || !id || !bus)
276 return_VALUE(-EINVAL);
278 data = kmalloc(sizeof(struct acpi_pci_data), GFP_KERNEL);
280 return_VALUE(-ENOMEM);
281 memset(data, 0, sizeof(struct acpi_pci_data));
285 device->ops.bind = acpi_pci_bind;
287 acpi_get_name(device->handle, ACPI_FULL_PATHNAME, &buffer);
289 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Binding PCI root bridge [%s] to "
290 "%02x:%02x\n", pathname, id->segment, id->bus));
292 status = acpi_attach_data(device->handle, acpi_pci_data_handler, data);
293 if (ACPI_FAILURE(status)) {
294 ACPI_DEBUG_PRINT((ACPI_DB_ERROR,
295 "Unable to attach ACPI-PCI context to device %s\n",
305 return_VALUE(result);