Sync usage with man page.
[netbsd-mini2440.git] / sys / arch / alpha / pci / sio_pic.c
blob5d6bb1ee5e56ed3b6111ec529490725470f6faf5
1 /* $NetBSD: sio_pic.c,v 1.39 2009/03/14 21:04:02 dsl Exp $ */
3 /*-
4 * Copyright (c) 1998, 2000 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) 1995, 1996 Carnegie-Mellon University.
35 * All rights reserved.
37 * Author: Chris G. Demetriou
39 * Permission to use, copy, modify and distribute this software and
40 * its documentation is hereby granted, provided that both the copyright
41 * notice and this permission notice appear in all copies of the
42 * software, derivative works or modified versions, and any portions
43 * thereof, and that both notices appear in supporting documentation.
45 * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
46 * CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND
47 * FOR ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
49 * Carnegie Mellon requests users of this software to return to
51 * Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU
52 * School of Computer Science
53 * Carnegie Mellon University
54 * Pittsburgh PA 15213-3890
56 * any improvements or extensions that they make and grant Carnegie the
57 * rights to redistribute these changes.
60 #include <sys/cdefs.h> /* RCS ID & Copyright macro defns */
62 __KERNEL_RCSID(0, "$NetBSD: sio_pic.c,v 1.39 2009/03/14 21:04:02 dsl Exp $");
64 #include <sys/param.h>
65 #include <sys/systm.h>
66 #include <sys/device.h>
67 #include <sys/malloc.h>
68 #include <sys/syslog.h>
70 #include <machine/intr.h>
71 #include <machine/bus.h>
73 #include <dev/pci/pcireg.h>
74 #include <dev/pci/pcivar.h>
75 #include <dev/pci/pcidevs.h>
77 #include <dev/pci/cy82c693reg.h>
78 #include <dev/pci/cy82c693var.h>
80 #include <dev/isa/isareg.h>
81 #include <dev/isa/isavar.h>
82 #include <alpha/pci/siovar.h>
84 #include "sio.h"
87 * To add to the long history of wonderful PROM console traits,
88 * AlphaStation PROMs don't reset themselves completely on boot!
89 * Therefore, if an interrupt was turned on when the kernel was
90 * started, we're not going to EVER turn it off... I don't know
91 * what will happen if new interrupts (that the PROM console doesn't
92 * want) are turned on. I'll burn that bridge when I come to it.
94 #define BROKEN_PROM_CONSOLE
97 * Private functions and variables.
100 bus_space_tag_t sio_iot;
101 pci_chipset_tag_t sio_pc;
102 bus_space_handle_t sio_ioh_icu1, sio_ioh_icu2;
104 #define ICU_LEN 16 /* number of ISA IRQs */
106 static struct alpha_shared_intr *sio_intr;
108 #ifndef STRAY_MAX
109 #define STRAY_MAX 5
110 #endif
112 #ifdef BROKEN_PROM_CONSOLE
114 * If prom console is broken, must remember the initial interrupt
115 * settings and enforce them. WHEE!
117 u_int8_t initial_ocw1[2];
118 u_int8_t initial_elcr[2];
119 #endif
121 void sio_setirqstat(int, int, int);
123 u_int8_t (*sio_read_elcr)(int);
124 void (*sio_write_elcr)(int, u_int8_t);
125 static void specific_eoi(int);
126 #ifdef BROKEN_PROM_CONSOLE
127 void sio_intr_shutdown(void *);
128 #endif
130 /******************** i82378 SIO ELCR functions ********************/
132 int i82378_setup_elcr(void);
133 u_int8_t i82378_read_elcr(int);
134 void i82378_write_elcr(int, u_int8_t);
136 bus_space_handle_t sio_ioh_elcr;
139 i82378_setup_elcr()
141 int rv;
144 * We could probe configuration space to see that there's
145 * actually an SIO present, but we are using this as a
146 * fall-back in case nothing else matches.
149 rv = bus_space_map(sio_iot, 0x4d0, 2, 0, &sio_ioh_elcr);
151 if (rv == 0) {
152 sio_read_elcr = i82378_read_elcr;
153 sio_write_elcr = i82378_write_elcr;
156 return (rv);
159 u_int8_t
160 i82378_read_elcr(int elcr)
163 return (bus_space_read_1(sio_iot, sio_ioh_elcr, elcr));
166 void
167 i82378_write_elcr(int elcr, u_int8_t val)
170 bus_space_write_1(sio_iot, sio_ioh_elcr, elcr, val);
173 /******************** Cypress CY82C693 ELCR functions ********************/
175 int cy82c693_setup_elcr(void);
176 u_int8_t cy82c693_read_elcr(int);
177 void cy82c693_write_elcr(int, u_int8_t);
179 const struct cy82c693_handle *sio_cy82c693_handle;
182 cy82c693_setup_elcr()
184 int device, maxndevs;
185 pcitag_t tag;
186 pcireg_t id;
189 * Search PCI configuration space for a Cypress CY82C693.
191 * Note we can make some assumptions about our bus number
192 * here, because:
194 * (1) there can be at most one ISA/EISA bridge per PCI bus, and
196 * (2) any ISA/EISA bridges must be attached to primary PCI
197 * busses (i.e. bus zero).
200 maxndevs = pci_bus_maxdevs(sio_pc, 0);
202 for (device = 0; device < maxndevs; device++) {
203 tag = pci_make_tag(sio_pc, 0, device, 0);
204 id = pci_conf_read(sio_pc, tag, PCI_ID_REG);
206 /* Invalid vendor ID value? */
207 if (PCI_VENDOR(id) == PCI_VENDOR_INVALID)
208 continue;
209 /* XXX Not invalid, but we've done this ~forever. */
210 if (PCI_VENDOR(id) == 0)
211 continue;
213 if (PCI_VENDOR(id) != PCI_VENDOR_CONTAQ ||
214 PCI_PRODUCT(id) != PCI_PRODUCT_CONTAQ_82C693)
215 continue;
218 * Found one!
221 #if 0
222 printf("cy82c693_setup_elcr: found 82C693 at device %d\n",
223 device);
224 #endif
226 sio_cy82c693_handle = cy82c693_init(sio_iot);
227 sio_read_elcr = cy82c693_read_elcr;
228 sio_write_elcr = cy82c693_write_elcr;
230 return (0);
234 * Didn't find a CY82C693.
236 return (ENODEV);
239 u_int8_t
240 cy82c693_read_elcr(int elcr)
243 return (cy82c693_read(sio_cy82c693_handle, CONFIG_ELCR1 + elcr));
246 void
247 cy82c693_write_elcr(int elcr, u_int8_t val)
250 cy82c693_write(sio_cy82c693_handle, CONFIG_ELCR1 + elcr, val);
253 /******************** ELCR access function configuration ********************/
256 * Put the Intel SIO at the end, so we fall back on it if we don't
257 * find anything else. If any of the non-Intel functions find a
258 * matching device, but are unable to map it for whatever reason,
259 * they should panic.
262 int (*sio_elcr_setup_funcs[])(void) = {
263 cy82c693_setup_elcr,
264 i82378_setup_elcr,
265 NULL,
268 /******************** Shared SIO/Cypress functions ********************/
270 void
271 sio_setirqstat(int irq, int enabled, int type)
273 u_int8_t ocw1[2], elcr[2];
274 int icu, bit;
276 #if 0
277 printf("sio_setirqstat: irq %d: %s, %s\n", irq,
278 enabled ? "enabled" : "disabled", isa_intr_typename(type));
279 #endif
281 icu = irq / 8;
282 bit = irq % 8;
284 ocw1[0] = bus_space_read_1(sio_iot, sio_ioh_icu1, 1);
285 ocw1[1] = bus_space_read_1(sio_iot, sio_ioh_icu2, 1);
286 elcr[0] = (*sio_read_elcr)(0); /* XXX */
287 elcr[1] = (*sio_read_elcr)(1); /* XXX */
290 * interrupt enable: set bit to mask (disable) interrupt.
292 if (enabled)
293 ocw1[icu] &= ~(1 << bit);
294 else
295 ocw1[icu] |= 1 << bit;
298 * interrupt type select: set bit to get level-triggered.
300 if (type == IST_LEVEL)
301 elcr[icu] |= 1 << bit;
302 else
303 elcr[icu] &= ~(1 << bit);
305 #ifdef not_here
306 /* see the init function... */
307 ocw1[0] &= ~0x04; /* always enable IRQ2 on first PIC */
308 elcr[0] &= ~0x07; /* IRQ[0-2] must be edge-triggered */
309 elcr[1] &= ~0x21; /* IRQ[13,8] must be edge-triggered */
310 #endif
312 bus_space_write_1(sio_iot, sio_ioh_icu1, 1, ocw1[0]);
313 bus_space_write_1(sio_iot, sio_ioh_icu2, 1, ocw1[1]);
314 (*sio_write_elcr)(0, elcr[0]); /* XXX */
315 (*sio_write_elcr)(1, elcr[1]); /* XXX */
318 void
319 sio_intr_setup(pci_chipset_tag_t pc, bus_space_tag_t iot)
321 char *cp;
322 int i;
324 sio_iot = iot;
325 sio_pc = pc;
327 if (bus_space_map(sio_iot, IO_ICU1, 2, 0, &sio_ioh_icu1) ||
328 bus_space_map(sio_iot, IO_ICU2, 2, 0, &sio_ioh_icu2))
329 panic("sio_intr_setup: can't map ICU I/O ports");
331 for (i = 0; sio_elcr_setup_funcs[i] != NULL; i++)
332 if ((*sio_elcr_setup_funcs[i])() == 0)
333 break;
334 if (sio_elcr_setup_funcs[i] == NULL)
335 panic("sio_intr_setup: can't map ELCR");
337 #ifdef BROKEN_PROM_CONSOLE
339 * Remember the initial values, so we can restore them later.
341 initial_ocw1[0] = bus_space_read_1(sio_iot, sio_ioh_icu1, 1);
342 initial_ocw1[1] = bus_space_read_1(sio_iot, sio_ioh_icu2, 1);
343 initial_elcr[0] = (*sio_read_elcr)(0); /* XXX */
344 initial_elcr[1] = (*sio_read_elcr)(1); /* XXX */
345 shutdownhook_establish(sio_intr_shutdown, 0);
346 #endif
348 sio_intr = alpha_shared_intr_alloc(ICU_LEN, 8);
351 * set up initial values for interrupt enables.
353 for (i = 0; i < ICU_LEN; i++) {
354 alpha_shared_intr_set_maxstrays(sio_intr, i, STRAY_MAX);
356 cp = alpha_shared_intr_string(sio_intr, i);
357 sprintf(cp, "irq %d", i);
358 evcnt_attach_dynamic(alpha_shared_intr_evcnt(sio_intr, i),
359 EVCNT_TYPE_INTR, NULL, "isa", cp);
361 switch (i) {
362 case 0:
363 case 1:
364 case 8:
365 case 13:
367 * IRQs 0, 1, 8, and 13 must always be
368 * edge-triggered.
370 sio_setirqstat(i, 0, IST_EDGE);
371 alpha_shared_intr_set_dfltsharetype(sio_intr, i,
372 IST_EDGE);
373 specific_eoi(i);
374 break;
376 case 2:
378 * IRQ 2 must be edge-triggered, and should be
379 * enabled (otherwise IRQs 8-15 are ignored).
381 sio_setirqstat(i, 1, IST_EDGE);
382 alpha_shared_intr_set_dfltsharetype(sio_intr, i,
383 IST_UNUSABLE);
384 break;
386 default:
388 * Otherwise, disable the IRQ and set its
389 * type to (effectively) "unknown."
391 sio_setirqstat(i, 0, IST_NONE);
392 alpha_shared_intr_set_dfltsharetype(sio_intr, i,
393 IST_NONE);
394 specific_eoi(i);
395 break;
400 #ifdef BROKEN_PROM_CONSOLE
401 void
402 sio_intr_shutdown(void *arg)
405 * Restore the initial values, to make the PROM happy.
407 bus_space_write_1(sio_iot, sio_ioh_icu1, 1, initial_ocw1[0]);
408 bus_space_write_1(sio_iot, sio_ioh_icu2, 1, initial_ocw1[1]);
409 (*sio_write_elcr)(0, initial_elcr[0]); /* XXX */
410 (*sio_write_elcr)(1, initial_elcr[1]); /* XXX */
412 #endif
414 const char *
415 sio_intr_string(void *v, int irq)
417 static char irqstr[12]; /* 8 + 2 + NULL + sanity */
419 if (irq == 0 || irq >= ICU_LEN || irq == 2)
420 panic("sio_intr_string: bogus isa irq 0x%x", irq);
422 sprintf(irqstr, "isa irq %d", irq);
423 return (irqstr);
426 const struct evcnt *
427 sio_intr_evcnt(void *v, int irq)
430 if (irq == 0 || irq >= ICU_LEN || irq == 2)
431 panic("sio_intr_evcnt: bogus isa irq 0x%x", irq);
433 return (alpha_shared_intr_evcnt(sio_intr, irq));
436 void *
437 sio_intr_establish(void *v, int irq, int type, int level, int (*fn)(void *), void *arg)
439 void *cookie;
441 if (irq > ICU_LEN || type == IST_NONE)
442 panic("sio_intr_establish: bogus irq or type");
444 cookie = alpha_shared_intr_establish(sio_intr, irq, type, level, fn,
445 arg, "isa irq");
447 if (cookie != NULL &&
448 alpha_shared_intr_firstactive(sio_intr, irq)) {
449 scb_set(0x800 + SCB_IDXTOVEC(irq), sio_iointr, NULL,
450 level);
451 sio_setirqstat(irq, 1,
452 alpha_shared_intr_get_sharetype(sio_intr, irq));
455 return (cookie);
458 void
459 sio_intr_disestablish(void *v, void *cookie)
461 struct alpha_shared_intrhand *ih = cookie;
462 int s, ist, irq = ih->ih_num;
464 s = splhigh();
466 /* Remove it from the link. */
467 alpha_shared_intr_disestablish(sio_intr, cookie, "isa irq");
470 * Decide if we should disable the interrupt. We must ensure
471 * that:
473 * - An initially-enabled interrupt is never disabled.
474 * - An initially-LT interrupt is never untyped.
476 if (alpha_shared_intr_isactive(sio_intr, irq) == 0) {
478 * IRQs 0, 1, 8, and 13 must always be edge-triggered
479 * (see setup).
481 switch (irq) {
482 case 0:
483 case 1:
484 case 8:
485 case 13:
487 * If the interrupt was initially level-triggered
488 * a warning was printed in setup.
490 ist = IST_EDGE;
491 break;
493 default:
494 ist = IST_NONE;
495 break;
497 sio_setirqstat(irq, 0, ist);
498 alpha_shared_intr_set_dfltsharetype(sio_intr, irq, ist);
500 /* Release our SCB vector. */
501 scb_free(0x800 + SCB_IDXTOVEC(irq));
504 splx(s);
507 void
508 sio_iointr(void *arg, unsigned long vec)
510 int irq;
512 irq = SCB_VECTOIDX(vec - 0x800);
514 #ifdef DIAGNOSTIC
515 if (irq > ICU_LEN || irq < 0)
516 panic("sio_iointr: irq out of range (%d)", irq);
517 #endif
519 if (!alpha_shared_intr_dispatch(sio_intr, irq))
520 alpha_shared_intr_stray(sio_intr, irq, "isa irq");
521 else
522 alpha_shared_intr_reset_strays(sio_intr, irq);
525 * Some versions of the machines which use the SIO
526 * (or is it some PALcode revisions on those machines?)
527 * require the non-specific EOI to be fed to the PIC(s)
528 * by the interrupt handler.
530 specific_eoi(irq);
533 #define LEGAL_IRQ(x) ((x) >= 0 && (x) < ICU_LEN && (x) != 2)
536 sio_intr_alloc(void *v, int mask, int type, int *irq)
538 int i, tmp, bestirq, count;
539 struct alpha_shared_intrhand **p, *q;
541 if (type == IST_NONE)
542 panic("intr_alloc: bogus type");
544 bestirq = -1;
545 count = -1;
547 /* some interrupts should never be dynamically allocated */
548 mask &= 0xdef8;
551 * XXX some interrupts will be used later (6 for fdc, 12 for pms).
552 * the right answer is to do "breadth-first" searching of devices.
554 mask &= 0xefbf;
556 for (i = 0; i < ICU_LEN; i++) {
557 if (LEGAL_IRQ(i) == 0 || (mask & (1<<i)) == 0)
558 continue;
560 switch(sio_intr[i].intr_sharetype) {
561 case IST_NONE:
563 * if nothing's using the irq, just return it
565 *irq = i;
566 return (0);
568 case IST_EDGE:
569 case IST_LEVEL:
570 if (type != sio_intr[i].intr_sharetype)
571 continue;
573 * if the irq is shareable, count the number of other
574 * handlers, and if it's smaller than the last irq like
575 * this, remember it
577 * XXX We should probably also consider the
578 * interrupt level and stick IPL_TTY with other
579 * IPL_TTY, etc.
581 for (p = &TAILQ_FIRST(&sio_intr[i].intr_q), tmp = 0;
582 (q = *p) != NULL; p = &TAILQ_NEXT(q, ih_q), tmp++)
584 if ((bestirq == -1) || (count > tmp)) {
585 bestirq = i;
586 count = tmp;
588 break;
590 case IST_PULSE:
591 /* this just isn't shareable */
592 continue;
596 if (bestirq == -1)
597 return (1);
599 *irq = bestirq;
601 return (0);
604 static void
605 specific_eoi(int irq)
607 if (irq > 7)
608 bus_space_write_1(sio_iot,
609 sio_ioh_icu2, 0, 0x60 | (irq & 0x07)); /* XXX */
610 bus_space_write_1(sio_iot, sio_ioh_icu1, 0, 0x60 | (irq > 7 ? 2 : irq));