Sync usage with man page.
[netbsd-mini2440.git] / sys / arch / x86 / pci / pci_intr_machdep.c
blob93ffd66d6a22e5ce0503d01c6f48f51c9b420179
1 /* $NetBSD: pci_intr_machdep.c,v 1.13 2009/03/21 15:01:56 ad Exp $ */
3 /*-
4 * Copyright (c) 1997, 1998, 2009 The NetBSD Foundation, Inc.
5 * All rights reserved.
7 * This code is derived from software contributed to The NetBSD Foundation
8 * by Jason R. Thorpe of the Numerical Aerospace Simulation Facility,
9 * NASA Ames Research Center.
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
13 * are met:
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in the
18 * documentation and/or other materials provided with the distribution.
20 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
21 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
22 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
24 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30 * POSSIBILITY OF SUCH DAMAGE.
34 * Copyright (c) 1996 Christopher G. Demetriou. All rights reserved.
35 * Copyright (c) 1994 Charles M. Hannum. All rights reserved.
37 * Redistribution and use in source and binary forms, with or without
38 * modification, are permitted provided that the following conditions
39 * are met:
40 * 1. Redistributions of source code must retain the above copyright
41 * notice, this list of conditions and the following disclaimer.
42 * 2. Redistributions in binary form must reproduce the above copyright
43 * notice, this list of conditions and the following disclaimer in the
44 * documentation and/or other materials provided with the distribution.
45 * 3. All advertising materials mentioning features or use of this software
46 * must display the following acknowledgement:
47 * This product includes software developed by Charles M. Hannum.
48 * 4. The name of the author may not be used to endorse or promote products
49 * derived from this software without specific prior written permission.
51 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
52 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
53 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
54 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
55 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
56 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
57 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
58 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
59 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
60 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
64 * Machine-specific functions for PCI autoconfiguration.
66 * On PCs, there are two methods of generating PCI configuration cycles.
67 * We try to detect the appropriate mechanism for this machine and set
68 * up a few function pointers to access the correct method directly.
70 * The configuration method can be hard-coded in the config file by
71 * using `options PCI_CONF_MODE=N', where `N' is the configuration mode
72 * as defined section 3.6.4.1, `Generating Configuration Cycles'.
75 #include <sys/cdefs.h>
76 __KERNEL_RCSID(0, "$NetBSD: pci_intr_machdep.c,v 1.13 2009/03/21 15:01:56 ad Exp $");
78 #include <sys/types.h>
79 #include <sys/param.h>
80 #include <sys/time.h>
81 #include <sys/systm.h>
82 #include <sys/errno.h>
83 #include <sys/device.h>
84 #include <sys/intr.h>
86 #include <uvm/uvm_extern.h>
88 #include <dev/pci/pcivar.h>
90 #include "ioapic.h"
91 #include "eisa.h"
92 #include "acpica.h"
93 #include "opt_mpbios.h"
94 #include "opt_acpi.h"
96 #if NIOAPIC > 0 || NACPICA > 0
97 #include <machine/i82093var.h>
98 #include <machine/mpconfig.h>
99 #include <machine/mpbiosvar.h>
100 #include <machine/pic.h>
101 #endif
103 #ifdef MPBIOS
104 #include <machine/mpbiosvar.h>
105 #endif
107 #if NACPICA > 0
108 #include <machine/mpacpi.h>
109 #endif
111 #define MPSAFE_MASK 0x80000000
114 pci_intr_map(struct pci_attach_args *pa, pci_intr_handle_t *ihp)
116 int pin = pa->pa_intrpin;
117 int line = pa->pa_intrline;
118 #if NIOAPIC > 0 || NACPICA > 0
119 int rawpin = pa->pa_rawintrpin;
120 pci_chipset_tag_t pc = pa->pa_pc;
121 int bus, dev, func;
122 #endif
124 if (pin == 0) {
125 /* No IRQ used. */
126 goto bad;
129 *ihp = 0;
131 if (pin > PCI_INTERRUPT_PIN_MAX) {
132 aprint_normal("pci_intr_map: bad interrupt pin %d\n", pin);
133 goto bad;
136 #if NIOAPIC > 0 || NACPICA > 0
137 pci_decompose_tag(pc, pa->pa_tag, &bus, &dev, &func);
138 if (mp_busses != NULL) {
139 if (intr_find_mpmapping(bus, (dev<<2)|(rawpin-1), ihp) == 0) {
140 if ((*ihp & 0xff) == 0)
141 *ihp |= line;
142 return 0;
145 * No explicit PCI mapping found. This is not fatal,
146 * we'll try the ISA (or possibly EISA) mappings next.
149 #endif
152 * Section 6.2.4, `Miscellaneous Functions', says that 255 means
153 * `unknown' or `no connection' on a PC. We assume that a device with
154 * `no connection' either doesn't have an interrupt (in which case the
155 * pin number should be 0, and would have been noticed above), or
156 * wasn't configured by the BIOS (in which case we punt, since there's
157 * no real way we can know how the interrupt lines are mapped in the
158 * hardware).
160 * XXX
161 * Since IRQ 0 is only used by the clock, and we can't actually be sure
162 * that the BIOS did its job, we also recognize that as meaning that
163 * the BIOS has not configured the device.
165 if (line == 0 || line == X86_PCI_INTERRUPT_LINE_NO_CONNECTION) {
166 aprint_normal("pci_intr_map: no mapping for pin %c (line=%02x)\n",
167 '@' + pin, line);
168 goto bad;
169 } else {
170 if (line >= NUM_LEGACY_IRQS) {
171 aprint_normal("pci_intr_map: bad interrupt line %d\n", line);
172 goto bad;
174 if (line == 2) {
175 aprint_normal("pci_intr_map: changed line 2 to line 9\n");
176 line = 9;
179 #if NIOAPIC > 0 || NACPICA > 0
180 if (mp_busses != NULL) {
181 if (intr_find_mpmapping(mp_isa_bus, line, ihp) == 0) {
182 if ((*ihp & 0xff) == 0)
183 *ihp |= line;
184 return 0;
186 #if NEISA > 0
187 if (intr_find_mpmapping(mp_eisa_bus, line, ihp) == 0) {
188 if ((*ihp & 0xff) == 0)
189 *ihp |= line;
190 return 0;
192 #endif
193 aprint_normal("pci_intr_map: bus %d dev %d func %d pin %d; line %d\n",
194 bus, dev, func, pin, line);
195 aprint_normal("pci_intr_map: no MP mapping found\n");
197 #endif
199 *ihp = line;
200 return 0;
202 bad:
203 *ihp = -1;
204 return 1;
207 const char *
208 pci_intr_string(pci_chipset_tag_t pc, pci_intr_handle_t ih)
210 return intr_string(ih & ~MPSAFE_MASK);
214 const struct evcnt *
215 pci_intr_evcnt(pci_chipset_tag_t pc, pci_intr_handle_t ih)
218 /* XXX for now, no evcnt parent reported */
219 return NULL;
223 pci_intr_setattr(pci_chipset_tag_t pc, pci_intr_handle_t *ih,
224 int attr, uint64_t data)
227 switch (attr) {
228 case PCI_INTR_MPSAFE:
229 if (data) {
230 *ih |= MPSAFE_MASK;
231 } else {
232 *ih &= ~MPSAFE_MASK;
234 /* XXX Set live if already mapped. */
235 return 0;
236 default:
237 return ENODEV;
241 void *
242 pci_intr_establish(pci_chipset_tag_t pc, pci_intr_handle_t ih,
243 int level, int (*func)(void *), void *arg)
245 int pin, irq;
246 struct pic *pic;
247 #if NIOAPIC > 0
248 struct ioapic_softc *ioapic;
249 #endif
250 bool mpsafe;
252 pic = &i8259_pic;
253 pin = irq = (ih & ~MPSAFE_MASK);
254 mpsafe = ((ih & MPSAFE_MASK) != 0);
256 #if NIOAPIC > 0
257 if (ih & APIC_INT_VIA_APIC) {
258 ioapic = ioapic_find(APIC_IRQ_APIC(ih));
259 if (ioapic == NULL) {
260 aprint_normal("pci_intr_establish: bad ioapic %d\n",
261 APIC_IRQ_APIC(ih));
262 return NULL;
264 pic = &ioapic->sc_pic;
265 pin = APIC_IRQ_PIN(ih);
266 irq = APIC_IRQ_LEGACY_IRQ(ih);
267 if (irq < 0 || irq >= NUM_LEGACY_IRQS)
268 irq = -1;
270 #endif
272 return intr_establish(irq, pic, pin, IST_LEVEL, level, func, arg,
273 mpsafe);
276 void
277 pci_intr_disestablish(pci_chipset_tag_t pc, void *cookie)
280 intr_disestablish(cookie);