2 * pci_irq.c - ACPI PCI Interrupt Routing ($Revision: 11 $)
4 * Copyright (C) 2001, 2002 Andy Grover <andrew.grover@intel.com>
5 * Copyright (C) 2001, 2002 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com>
6 * Copyright (C) 2002 Dominik Brodowski <devel@brodo.de>
8 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or (at
13 * your option) any later version.
15 * This program is distributed in the hope that it will be useful, but
16 * WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 * General Public License for more details.
20 * You should have received a copy of the GNU General Public License along
21 * with this program; if not, write to the Free Software Foundation, Inc.,
22 * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
24 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
28 #include <linux/kernel.h>
29 #include <linux/module.h>
30 #include <linux/init.h>
31 #include <linux/types.h>
32 #include <linux/proc_fs.h>
33 #include <linux/spinlock.h>
35 #include <linux/pci.h>
36 #include <linux/acpi.h>
37 #include <acpi/acpi_bus.h>
38 #include <acpi/acpi_drivers.h>
40 #define _COMPONENT ACPI_PCI_COMPONENT
41 ACPI_MODULE_NAME("pci_irq");
43 static struct acpi_prt_list acpi_prt
;
44 static DEFINE_SPINLOCK(acpi_prt_lock
);
46 /* --------------------------------------------------------------------------
47 PCI IRQ Routing Table (PRT) Support
48 -------------------------------------------------------------------------- */
50 static struct acpi_prt_entry
*acpi_pci_irq_find_prt_entry(int segment
,
54 struct acpi_prt_entry
*entry
= NULL
;
60 * Parse through all PRT entries looking for a match on the specified
61 * PCI device's segment, bus, device, and pin (don't care about func).
64 spin_lock(&acpi_prt_lock
);
65 list_for_each_entry(entry
, &acpi_prt
.entries
, node
) {
66 if ((segment
== entry
->id
.segment
)
67 && (bus
== entry
->id
.bus
)
68 && (device
== entry
->id
.device
)
69 && (pin
== entry
->pin
)) {
70 spin_unlock(&acpi_prt_lock
);
75 spin_unlock(&acpi_prt_lock
);
80 acpi_pci_irq_add_entry(acpi_handle handle
,
81 int segment
, int bus
, struct acpi_pci_routing_table
*prt
)
83 struct acpi_prt_entry
*entry
= NULL
;
89 entry
= kzalloc(sizeof(struct acpi_prt_entry
), GFP_KERNEL
);
93 entry
->id
.segment
= segment
;
95 entry
->id
.device
= (prt
->address
>> 16) & 0xFFFF;
96 entry
->id
.function
= prt
->address
& 0xFFFF;
97 entry
->pin
= prt
->pin
;
102 * The 'source' field specifies the PCI interrupt link device used to
103 * configure the IRQ assigned to this slot|dev|pin. The 'source_index'
104 * indicates which resource descriptor in the resource template (of
105 * the link device) this interrupt is allocated from.
107 * NOTE: Don't query the Link Device for IRQ information at this time
108 * because Link Device enumeration may not have occurred yet
109 * (e.g. exists somewhere 'below' this _PRT entry in the ACPI
112 if (prt
->source
[0]) {
113 acpi_get_handle(handle
, prt
->source
, &entry
->link
.handle
);
114 entry
->link
.index
= prt
->source_index
;
119 * The 'source' field is NULL, and the 'source_index' field specifies
120 * the IRQ value, which is hardwired to specific interrupt inputs on
121 * the interrupt controller.
124 entry
->link
.index
= prt
->source_index
;
126 ACPI_DEBUG_PRINT_RAW((ACPI_DB_INFO
,
127 " %02X:%02X:%02X[%c] -> %s[%d]\n",
128 entry
->id
.segment
, entry
->id
.bus
,
129 entry
->id
.device
, ('A' + entry
->pin
), prt
->source
,
132 spin_lock(&acpi_prt_lock
);
133 list_add_tail(&entry
->node
, &acpi_prt
.entries
);
135 spin_unlock(&acpi_prt_lock
);
141 acpi_pci_irq_del_entry(int segment
, int bus
, struct acpi_prt_entry
*entry
)
143 if (segment
== entry
->id
.segment
&& bus
== entry
->id
.bus
) {
145 list_del(&entry
->node
);
150 int acpi_pci_irq_add_prt(acpi_handle handle
, int segment
, int bus
)
152 acpi_status status
= AE_OK
;
153 char *pathname
= NULL
;
154 struct acpi_buffer buffer
= { 0, NULL
};
155 struct acpi_pci_routing_table
*prt
= NULL
;
156 struct acpi_pci_routing_table
*entry
= NULL
;
157 static int first_time
= 1;
160 pathname
= kzalloc(ACPI_PATHNAME_MAX
, GFP_KERNEL
);
166 INIT_LIST_HEAD(&acpi_prt
.entries
);
171 * NOTE: We're given a 'handle' to the _PRT object's parent device
172 * (either a PCI root bridge or PCI-PCI bridge).
175 buffer
.length
= ACPI_PATHNAME_MAX
;
176 buffer
.pointer
= pathname
;
177 acpi_get_name(handle
, ACPI_FULL_PATHNAME
, &buffer
);
179 printk(KERN_DEBUG
"ACPI: PCI Interrupt Routing Table [%s._PRT]\n",
183 * Evaluate this _PRT and add its entries to our global list (acpi_prt).
187 buffer
.pointer
= NULL
;
189 status
= acpi_get_irq_routing_table(handle
, &buffer
);
190 if (status
!= AE_BUFFER_OVERFLOW
) {
191 ACPI_EXCEPTION((AE_INFO
, status
, "Evaluating _PRT [%s]",
192 acpi_format_exception(status
)));
196 prt
= kzalloc(buffer
.length
, GFP_KERNEL
);
200 buffer
.pointer
= prt
;
202 status
= acpi_get_irq_routing_table(handle
, &buffer
);
203 if (ACPI_FAILURE(status
)) {
204 ACPI_EXCEPTION((AE_INFO
, status
, "Evaluating _PRT [%s]",
205 acpi_format_exception(status
)));
206 kfree(buffer
.pointer
);
212 while (entry
&& (entry
->length
> 0)) {
213 acpi_pci_irq_add_entry(handle
, segment
, bus
, entry
);
214 entry
= (struct acpi_pci_routing_table
*)
215 ((unsigned long)entry
+ entry
->length
);
223 void acpi_pci_irq_del_prt(int segment
, int bus
)
225 struct list_head
*node
= NULL
, *n
= NULL
;
226 struct acpi_prt_entry
*entry
= NULL
;
228 if (!acpi_prt
.count
) {
233 "ACPI: Delete PCI Interrupt Routing Table for %x:%x\n", segment
,
235 spin_lock(&acpi_prt_lock
);
236 list_for_each_safe(node
, n
, &acpi_prt
.entries
) {
237 entry
= list_entry(node
, struct acpi_prt_entry
, node
);
239 acpi_pci_irq_del_entry(segment
, bus
, entry
);
241 spin_unlock(&acpi_prt_lock
);
244 /* --------------------------------------------------------------------------
245 PCI Interrupt Routing Support
246 -------------------------------------------------------------------------- */
247 typedef int (*irq_lookup_func
) (struct acpi_prt_entry
*, int *, int *, char **);
250 acpi_pci_allocate_irq(struct acpi_prt_entry
*entry
,
251 int *triggering
, int *polarity
, char **link
)
256 if (entry
->link
.handle
) {
257 irq
= acpi_pci_link_allocate_irq(entry
->link
.handle
,
258 entry
->link
.index
, triggering
,
261 printk(KERN_WARNING PREFIX
262 "Invalid IRQ link routing entry\n");
266 irq
= entry
->link
.index
;
267 *triggering
= ACPI_LEVEL_SENSITIVE
;
268 *polarity
= ACPI_ACTIVE_LOW
;
271 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Found IRQ %d\n", irq
));
276 acpi_pci_free_irq(struct acpi_prt_entry
*entry
,
277 int *triggering
, int *polarity
, char **link
)
281 if (entry
->link
.handle
) {
282 irq
= acpi_pci_link_free_irq(entry
->link
.handle
);
284 irq
= entry
->link
.index
;
290 * acpi_pci_irq_lookup
291 * success: return IRQ >= 0
295 acpi_pci_irq_lookup(struct pci_bus
*bus
,
299 int *polarity
, char **link
, irq_lookup_func func
)
301 struct acpi_prt_entry
*entry
= NULL
;
302 int segment
= pci_domain_nr(bus
);
303 int bus_nr
= bus
->number
;
307 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
308 "Searching for PRT entry for %02x:%02x:%02x[%c]\n",
309 segment
, bus_nr
, device
, ('A' + pin
)));
311 entry
= acpi_pci_irq_find_prt_entry(segment
, bus_nr
, device
, pin
);
313 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "PRT entry not found\n"));
317 ret
= func(entry
, triggering
, polarity
, link
);
322 * acpi_pci_irq_derive
323 * success: return IRQ >= 0
324 * failure: return < 0
327 acpi_pci_irq_derive(struct pci_dev
*dev
,
330 int *polarity
, char **link
, irq_lookup_func func
)
332 struct pci_dev
*bridge
= dev
;
341 * Attempt to derive an IRQ for this device from a parent bridge's
342 * PCI interrupt routing entry (eg. yenta bridge and add-in card bridge).
344 while (irq
< 0 && bridge
->bus
->self
) {
345 pin
= (pin
+ PCI_SLOT(bridge
->devfn
)) % 4;
346 bridge
= bridge
->bus
->self
;
348 if ((bridge
->class >> 8) == PCI_CLASS_BRIDGE_CARDBUS
) {
349 /* PC card has the same IRQ as its cardbridge */
350 bridge_pin
= bridge
->pin
;
352 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
353 "No interrupt pin configured for device %s\n",
357 /* Pin is from 0 to 3 */
362 irq
= acpi_pci_irq_lookup(bridge
->bus
, PCI_SLOT(bridge
->devfn
),
363 pin
, triggering
, polarity
,
368 printk(KERN_WARNING PREFIX
"Unable to derive IRQ for device %s\n",
373 ACPI_DEBUG_PRINT((ACPI_DB_INFO
, "Derive IRQ %d for device %s from %s\n",
374 irq
, pci_name(dev
), pci_name(bridge
)));
380 * acpi_pci_irq_enable
382 * failure: return < 0
385 int acpi_pci_irq_enable(struct pci_dev
*dev
)
389 int triggering
= ACPI_LEVEL_SENSITIVE
;
390 int polarity
= ACPI_ACTIVE_LOW
;
400 ACPI_DEBUG_PRINT((ACPI_DB_INFO
,
401 "No interrupt pin configured for device %s\n",
408 printk(KERN_ERR PREFIX
"Invalid (NULL) 'bus' field\n");
413 * First we check the PCI IRQ routing table (PRT) for an IRQ. PRT
414 * values override any BIOS-assigned IRQs set during boot.
416 irq
= acpi_pci_irq_lookup(dev
->bus
, PCI_SLOT(dev
->devfn
), pin
,
417 &triggering
, &polarity
, &link
,
418 acpi_pci_allocate_irq
);
421 * If no PRT entry was found, we'll try to derive an IRQ from the
422 * device's parent bridge.
425 irq
= acpi_pci_irq_derive(dev
, pin
, &triggering
,
427 acpi_pci_allocate_irq
);
431 * IDE legacy mode controller IRQs are magic. Why do compat
432 * extensions always make such a nasty mess.
434 if (dev
->class >> 8 == PCI_CLASS_STORAGE_IDE
&&
435 (dev
->class & 0x05) == 0)
439 * No IRQ known to the ACPI subsystem - maybe the BIOS /
440 * driver reported one, then use it. Exit in any case.
443 printk(KERN_WARNING PREFIX
"PCI Interrupt %s[%c]: no GSI",
444 pci_name(dev
), ('A' + pin
));
445 /* Interrupt Line values above 0xF are forbidden */
446 if (dev
->irq
> 0 && (dev
->irq
<= 0xF)) {
447 printk(" - using IRQ %d\n", dev
->irq
);
448 acpi_register_gsi(dev
->irq
, ACPI_LEVEL_SENSITIVE
,
457 rc
= acpi_register_gsi(irq
, triggering
, polarity
);
459 printk(KERN_WARNING PREFIX
"PCI Interrupt %s[%c]: failed "
460 "to register GSI\n", pci_name(dev
), ('A' + pin
));
465 printk(KERN_INFO PREFIX
"PCI Interrupt %s[%c] -> ",
466 pci_name(dev
), 'A' + pin
);
469 printk("Link [%s] -> ", link
);
471 printk("GSI %u (%s, %s) -> IRQ %d\n", irq
,
472 (triggering
== ACPI_LEVEL_SENSITIVE
) ? "level" : "edge",
473 (polarity
== ACPI_ACTIVE_LOW
) ? "low" : "high", dev
->irq
);
478 /* FIXME: implement x86/x86_64 version */
479 void __attribute__ ((weak
)) acpi_unregister_gsi(u32 i
)
483 void acpi_pci_irq_disable(struct pci_dev
*dev
)
487 int triggering
= ACPI_LEVEL_SENSITIVE
;
488 int polarity
= ACPI_ACTIVE_LOW
;
491 if (!dev
|| !dev
->bus
)
500 * First we check the PCI IRQ routing table (PRT) for an IRQ.
502 gsi
= acpi_pci_irq_lookup(dev
->bus
, PCI_SLOT(dev
->devfn
), pin
,
503 &triggering
, &polarity
, NULL
,
506 * If no PRT entry was found, we'll try to derive an IRQ from the
507 * device's parent bridge.
510 gsi
= acpi_pci_irq_derive(dev
, pin
,
511 &triggering
, &polarity
, NULL
,
517 * TBD: It might be worth clearing dev->irq by magic constant
518 * (e.g. PCI_UNDEFINED_IRQ).
521 printk(KERN_INFO PREFIX
"PCI interrupt for device %s disabled\n",
524 acpi_unregister_gsi(gsi
);