Annotation of sys/dev/isa/lpt_isa.c, Revision 1.1
1.1 ! nbrk 1: /* $OpenBSD: lpt_isa.c,v 1.12 2002/03/14 01:26:56 millert Exp $ */
! 2:
! 3: /*
! 4: * Copyright (c) 1993, 1994 Charles Hannum.
! 5: * Copyright (c) 1990 William F. Jolitz, TeleMuse
! 6: * All rights reserved.
! 7: *
! 8: * Redistribution and use in source and binary forms, with or without
! 9: * modification, are permitted provided that the following conditions
! 10: * are met:
! 11: * 1. Redistributions of source code must retain the above copyright
! 12: * notice, this list of conditions and the following disclaimer.
! 13: * 2. Redistributions in binary form must reproduce the above copyright
! 14: * notice, this list of conditions and the following disclaimer in the
! 15: * documentation and/or other materials provided with the distribution.
! 16: * 3. All advertising materials mentioning features or use of this software
! 17: * must display the following acknowledgement:
! 18: * This software is a component of "386BSD" developed by
! 19: * William F. Jolitz, TeleMuse.
! 20: * 4. Neither the name of the developer nor the name "386BSD"
! 21: * may be used to endorse or promote products derived from this software
! 22: * without specific prior written permission.
! 23: *
! 24: * THIS SOFTWARE IS A COMPONENT OF 386BSD DEVELOPED BY WILLIAM F. JOLITZ
! 25: * AND IS INTENDED FOR RESEARCH AND EDUCATIONAL PURPOSES ONLY. THIS
! 26: * SOFTWARE SHOULD NOT BE CONSIDERED TO BE A COMMERCIAL PRODUCT.
! 27: * THE DEVELOPER URGES THAT USERS WHO REQUIRE A COMMERCIAL PRODUCT
! 28: * NOT MAKE USE OF THIS WORK.
! 29: *
! 30: * FOR USERS WHO WISH TO UNDERSTAND THE 386BSD SYSTEM DEVELOPED
! 31: * BY WILLIAM F. JOLITZ, WE RECOMMEND THE USER STUDY WRITTEN
! 32: * REFERENCES SUCH AS THE "PORTING UNIX TO THE 386" SERIES
! 33: * (BEGINNING JANUARY 1991 "DR. DOBBS JOURNAL", USA AND BEGINNING
! 34: * JUNE 1991 "UNIX MAGAZIN", GERMANY) BY WILLIAM F. JOLITZ AND
! 35: * LYNNE GREER JOLITZ, AS WELL AS OTHER BOOKS ON UNIX AND THE
! 36: * ON-LINE 386BSD USER MANUAL BEFORE USE. A BOOK DISCUSSING THE INTERNALS
! 37: * OF 386BSD ENTITLED "386BSD FROM THE INSIDE OUT" WILL BE AVAILABLE LATE 1992.
! 38: *
! 39: * THIS SOFTWARE IS PROVIDED BY THE DEVELOPER ``AS IS'' AND
! 40: * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
! 41: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
! 42: * ARE DISCLAIMED. IN NO EVENT SHALL THE DEVELOPER BE LIABLE
! 43: * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
! 44: * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
! 45: * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
! 46: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
! 47: * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
! 48: * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
! 49: * SUCH DAMAGE.
! 50: */
! 51:
! 52: /*
! 53: * Device Driver for AT parallel printer port
! 54: */
! 55:
! 56: #include <sys/param.h>
! 57: #include <sys/systm.h>
! 58: #include <sys/device.h>
! 59:
! 60: #include <machine/bus.h>
! 61: #include <machine/intr.h>
! 62:
! 63: #include <dev/isa/isavar.h>
! 64: #include <dev/ic/lptreg.h>
! 65: #include <dev/ic/lptvar.h>
! 66:
! 67: int lpt_isa_probe(struct device *, void *, void *);
! 68: void lpt_isa_attach(struct device *, struct device *, void *);
! 69:
! 70: struct cfattach lpt_isa_ca = {
! 71: sizeof(struct lpt_softc), lpt_isa_probe, lpt_isa_attach
! 72: };
! 73:
! 74: /*
! 75: * Logic:
! 76: * 1) You should be able to write to and read back the same value
! 77: * to the data port. Do an alternating zeros, alternating ones,
! 78: * walking zero, and walking one test to check for stuck bits.
! 79: *
! 80: * 2) You should be able to write to and read back the same value
! 81: * to the control port lower 5 bits, the upper 3 bits are reserved
! 82: * per the IBM PC technical reference manauls and different boards
! 83: * do different things with them. Do an alternating zeros, alternating
! 84: * ones, walking zero, and walking one test to check for stuck bits.
! 85: *
! 86: * Some printers drag the strobe line down when the are powered off
! 87: * so this bit has been masked out of the control port test.
! 88: *
! 89: * XXX Some printers may not like a fast pulse on init or strobe, I
! 90: * don't know at this point, if that becomes a problem these bits
! 91: * should be turned off in the mask byte for the control port test.
! 92: *
! 93: * 3) Set the data and control ports to a value of 0
! 94: */
! 95: int
! 96: lpt_isa_probe(parent, match, aux)
! 97: struct device *parent;
! 98: void *match, *aux;
! 99: {
! 100: #if !defined(__NO_ISA_INTR_CHECK)
! 101: struct isa_softc *sc = (struct isa_softc *)parent;
! 102: #endif
! 103: struct isa_attach_args *ia = aux;
! 104: bus_space_tag_t iot;
! 105: bus_space_handle_t ioh;
! 106: bus_addr_t base;
! 107: u_int8_t mask, data;
! 108: int i, rv, iosz;
! 109:
! 110: #ifdef DEBUG
! 111: #define ABORT \
! 112: do { \
! 113: printf("lpt_isa_probe: mask %x data %x failed\n", mask, \
! 114: data); \
! 115: goto out; \
! 116: } while (0)
! 117: #else
! 118: #define ABORT goto out
! 119: #endif
! 120:
! 121: iot = ia->ia_iot;
! 122: base = ia->ia_iobase;
! 123: iosz = (ia->ia_iosize == 0x666) ? LPT_NPORTS : ia->ia_iosize;
! 124: if (bus_space_map(iot, base, iosz, 0, &ioh))
! 125: return 0;
! 126:
! 127: rv = 0;
! 128: mask = 0xff;
! 129:
! 130: data = 0x55; /* Alternating zeros */
! 131: if (!lpt_port_test(iot, ioh, base, lpt_data, data, mask))
! 132: ABORT;
! 133:
! 134: data = 0xaa; /* Alternating ones */
! 135: if (!lpt_port_test(iot, ioh, base, lpt_data, data, mask))
! 136: ABORT;
! 137:
! 138: for (i = 0; i < CHAR_BIT; i++) { /* Walking zero */
! 139: data = ~(1 << i);
! 140: if (!lpt_port_test(iot, ioh, base, lpt_data, data, mask))
! 141: ABORT;
! 142: }
! 143:
! 144: for (i = 0; i < CHAR_BIT; i++) { /* Walking one */
! 145: data = (1 << i);
! 146: if (!lpt_port_test(iot, ioh, base, lpt_data, data, mask))
! 147: ABORT;
! 148: }
! 149:
! 150: bus_space_write_1(iot, ioh, lpt_data, 0);
! 151: bus_space_write_1(iot, ioh, lpt_control, 0);
! 152:
! 153: /*
! 154: * Check if the specified IRQ is available. If not revert to
! 155: * polled mode.
! 156: */
! 157: #if !defined(__NO_ISA_INTR_CHECK)
! 158: if (ia->ia_irq != IRQUNK &&
! 159: !isa_intr_check(sc->sc_ic, ia->ia_irq, IST_EDGE))
! 160: ia->ia_irq = IRQUNK;
! 161: #endif
! 162: ia->ia_msize = 0;
! 163: ia->ia_iosize = iosz;
! 164:
! 165: rv = 1;
! 166:
! 167: out:
! 168: bus_space_unmap(iot, ioh, iosz);
! 169: return rv;
! 170: }
! 171:
! 172: void
! 173: lpt_isa_attach(parent, self, aux)
! 174: struct device *parent, *self;
! 175: void *aux;
! 176: {
! 177: struct lpt_softc *sc = (void *)self;
! 178: struct isa_attach_args *ia = aux;
! 179:
! 180: sc->sc_state = 0;
! 181: sc->sc_iot = ia->ia_iot;
! 182: if (bus_space_map(sc->sc_iot, ia->ia_iobase, ia->ia_iosize, 0,
! 183: &sc->sc_ioh))
! 184: panic("lpt_isa_attach: couldn't map I/O ports");
! 185:
! 186: if (ia->ia_irq == IRQUNK) {
! 187: sc->sc_flags |= LPT_POLLED;
! 188: printf(": polled");
! 189: }
! 190:
! 191: lpt_attach_common(sc);
! 192:
! 193: if (ia->ia_irq != IRQUNK)
! 194: sc->sc_ih = isa_intr_establish(ia->ia_ic, ia->ia_irq, IST_EDGE,
! 195: IPL_TTY, lptintr, sc, sc->sc_dev.dv_xname);
! 196: }
CVSweb