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 void acpi_pci_data_handler(acpi_handle handle
, u32 function
,
50 ACPI_FUNCTION_TRACE("acpi_pci_data_handler");
52 /* TBD: Anything we need to do here? */
60 * This function is used by the ACPI Interpreter (a.k.a. Core Subsystem)
61 * to resolve PCI information for ACPI-PCI devices defined in the namespace.
62 * This typically occurs when resolving PCI operation region information.
64 acpi_status
acpi_get_pci_id(acpi_handle handle
, struct acpi_pci_id
*id
)
67 acpi_status status
= AE_OK
;
68 struct acpi_device
*device
= NULL
;
69 struct acpi_pci_data
*data
= NULL
;
71 ACPI_FUNCTION_TRACE("acpi_get_pci_id");
74 return_ACPI_STATUS(AE_BAD_PARAMETER
);
76 result
= acpi_bus_get_device(handle
, &device
);
78 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
79 "Invalid ACPI Bus context for device %s\n",
80 acpi_device_bid(device
)));
81 return_ACPI_STATUS(AE_NOT_EXIST
);
84 status
= acpi_get_data(handle
, acpi_pci_data_handler
, (void **)&data
);
85 if (ACPI_FAILURE(status
) || !data
) {
86 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
87 "Invalid ACPI-PCI context for device %s\n",
88 acpi_device_bid(device
)));
89 return_ACPI_STATUS(status
);
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
));
106 return_ACPI_STATUS(AE_OK
);
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
;
123 ACPI_FUNCTION_TRACE("acpi_pci_bind");
125 if (!device
|| !device
->parent
)
126 return_VALUE(-EINVAL
);
128 pathname
= kmalloc(ACPI_PATHNAME_MAX
, GFP_KERNEL
);
130 return_VALUE(-ENOMEM
);
131 memset(pathname
, 0, ACPI_PATHNAME_MAX
);
132 buffer
.length
= ACPI_PATHNAME_MAX
;
133 buffer
.pointer
= pathname
;
135 data
= kmalloc(sizeof(struct acpi_pci_data
), GFP_KERNEL
);
138 return_VALUE(-ENOMEM
);
140 memset(data
, 0, sizeof(struct acpi_pci_data
));
142 acpi_get_name(device
->handle
, ACPI_FULL_PATHNAME
, &buffer
);
143 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Binding PCI device [%s]...\n",
149 * These are obtained via the parent device's ACPI-PCI context.
151 status
= acpi_get_data(device
->parent
->handle
, acpi_pci_data_handler
,
153 if (ACPI_FAILURE(status
) || !pdata
|| !pdata
->bus
) {
154 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
155 "Invalid ACPI-PCI context for parent device %s\n",
156 acpi_device_bid(device
->parent
)));
160 data
->id
.segment
= pdata
->id
.segment
;
161 data
->id
.bus
= pdata
->bus
->number
;
166 * These are simply obtained from the device's _ADR method. Note
167 * that a value of zero is valid.
169 data
->id
.device
= device
->pnp
.bus_address
>> 16;
170 data
->id
.function
= device
->pnp
.bus_address
& 0xFFFF;
172 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "...to %02x:%02x:%02x.%02x\n",
173 data
->id
.segment
, data
->id
.bus
, data
->id
.device
,
177 * TBD: Support slot devices (e.g. function=0xFFFF).
183 * Locate matching device in PCI namespace. If it doesn't exist
184 * this typically means that the device isn't currently inserted
185 * (e.g. docking station, port replicator, etc.).
186 * We cannot simply search the global pci device list, since
187 * PCI devices are added to the global pci list when the root
188 * bridge start ops are run, which may not have happened yet.
190 bus
= pci_find_bus(data
->id
.segment
, data
->id
.bus
);
192 list_for_each_entry(dev
, &bus
->devices
, bus_list
) {
193 if (dev
->devfn
== PCI_DEVFN(data
->id
.device
,
194 data
->id
.function
)) {
201 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
202 "Device %02x:%02x:%02x.%02x not present in PCI namespace\n",
203 data
->id
.segment
, data
->id
.bus
,
204 data
->id
.device
, data
->id
.function
));
208 if (!data
->dev
->bus
) {
209 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
210 "Device %02x:%02x:%02x.%02x has invalid 'bus' field\n",
211 data
->id
.segment
, data
->id
.bus
,
212 data
->id
.device
, data
->id
.function
));
220 * If so, set the 'bus' field and install the 'bind' function to
221 * facilitate callbacks for all of its children.
223 if (data
->dev
->subordinate
) {
224 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
225 "Device %02x:%02x:%02x.%02x is a PCI bridge\n",
226 data
->id
.segment
, data
->id
.bus
,
227 data
->id
.device
, data
->id
.function
));
228 data
->bus
= data
->dev
->subordinate
;
229 device
->ops
.bind
= acpi_pci_bind
;
230 device
->ops
.unbind
= acpi_pci_unbind
;
234 * Attach ACPI-PCI Context
235 * -----------------------
236 * Thus binding the ACPI and PCI devices.
238 status
= acpi_attach_data(device
->handle
, acpi_pci_data_handler
, data
);
239 if (ACPI_FAILURE(status
)) {
240 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
241 "Unable to attach ACPI-PCI context to device %s\n",
242 acpi_device_bid(device
)));
250 * Evaluate and parse _PRT, if exists. This code is independent of
251 * PCI bridges (above) to allow parsing of _PRT objects within the
252 * scope of non-bridge devices. Note that _PRTs within the scope of
253 * a PCI bridge assume the bridge's subordinate bus number.
255 * TBD: Can _PRTs exist within the scope of non-bridge PCI devices?
257 status
= acpi_get_handle(device
->handle
, METHOD_NAME__PRT
, &handle
);
258 if (ACPI_SUCCESS(status
)) {
259 if (data
->bus
) /* PCI-PCI bridge */
260 acpi_pci_irq_add_prt(device
->handle
, data
->id
.segment
,
262 else /* non-bridge PCI device */
263 acpi_pci_irq_add_prt(device
->handle
, data
->id
.segment
,
272 return_VALUE(result
);
275 int acpi_pci_unbind(struct acpi_device
*device
)
278 acpi_status status
= AE_OK
;
279 struct acpi_pci_data
*data
= NULL
;
280 char *pathname
= NULL
;
281 struct acpi_buffer buffer
= { 0, NULL
};
283 ACPI_FUNCTION_TRACE("acpi_pci_unbind");
285 if (!device
|| !device
->parent
)
286 return_VALUE(-EINVAL
);
288 pathname
= (char *)kmalloc(ACPI_PATHNAME_MAX
, GFP_KERNEL
);
290 return_VALUE(-ENOMEM
);
291 memset(pathname
, 0, ACPI_PATHNAME_MAX
);
293 buffer
.length
= ACPI_PATHNAME_MAX
;
294 buffer
.pointer
= pathname
;
295 acpi_get_name(device
->handle
, ACPI_FULL_PATHNAME
, &buffer
);
296 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Unbinding PCI device [%s]...\n",
301 acpi_get_data(device
->handle
, acpi_pci_data_handler
,
303 if (ACPI_FAILURE(status
)) {
304 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
305 "Unable to get data from device %s\n",
306 acpi_device_bid(device
)));
311 status
= acpi_detach_data(device
->handle
, acpi_pci_data_handler
);
312 if (ACPI_FAILURE(status
)) {
313 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
314 "Unable to detach data from device %s\n",
315 acpi_device_bid(device
)));
319 if (data
->dev
->subordinate
) {
320 acpi_pci_irq_del_prt(data
->id
.segment
, data
->bus
->number
);
325 return_VALUE(result
);
329 acpi_pci_bind_root(struct acpi_device
*device
,
330 struct acpi_pci_id
*id
, struct pci_bus
*bus
)
333 acpi_status status
= AE_OK
;
334 struct acpi_pci_data
*data
= NULL
;
335 char *pathname
= NULL
;
336 struct acpi_buffer buffer
= { 0, NULL
};
338 ACPI_FUNCTION_TRACE("acpi_pci_bind_root");
340 pathname
= (char *)kmalloc(ACPI_PATHNAME_MAX
, GFP_KERNEL
);
342 return_VALUE(-ENOMEM
);
343 memset(pathname
, 0, ACPI_PATHNAME_MAX
);
345 buffer
.length
= ACPI_PATHNAME_MAX
;
346 buffer
.pointer
= pathname
;
348 if (!device
|| !id
|| !bus
) {
350 return_VALUE(-EINVAL
);
353 data
= kmalloc(sizeof(struct acpi_pci_data
), GFP_KERNEL
);
356 return_VALUE(-ENOMEM
);
358 memset(data
, 0, sizeof(struct acpi_pci_data
));
362 device
->ops
.bind
= acpi_pci_bind
;
363 device
->ops
.unbind
= acpi_pci_unbind
;
365 acpi_get_name(device
->handle
, ACPI_FULL_PATHNAME
, &buffer
);
367 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Binding PCI root bridge [%s] to "
368 "%02x:%02x\n", pathname
, id
->segment
, id
->bus
));
370 status
= acpi_attach_data(device
->handle
, acpi_pci_data_handler
, data
);
371 if (ACPI_FAILURE(status
)) {
372 ACPI_DEBUG_PRINT((ACPI_DB_ERROR
,
373 "Unable to attach ACPI-PCI context to device %s\n",
384 return_VALUE(result
);