* Copyright (c) 1990 William F. Jolitz, TeleMuse
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* 3. All advertising materials mentioning features or use of this software
* must display the following acknowledgement:
* This software is a component of "386BSD" developed by
* William F. Jolitz, TeleMuse.
* 4. Neither the name of the developer nor the name "386BSD"
* may be used to endorse or promote products derived from this software
* without specific prior written permission.
* THIS SOFTWARE IS A COMPONENT OF 386BSD DEVELOPED BY WILLIAM F. JOLITZ
* AND IS INTENDED FOR RESEARCH AND EDUCATIONAL PURPOSES ONLY. THIS
* SOFTWARE SHOULD NOT BE CONSIDERED TO BE A COMMERCIAL PRODUCT.
* THE DEVELOPER URGES THAT USERS WHO REQUIRE A COMMERCIAL PRODUCT
* NOT MAKE USE OF THIS WORK.
* FOR USERS WHO WISH TO UNDERSTAND THE 386BSD SYSTEM DEVELOPED
* BY WILLIAM F. JOLITZ, WE RECOMMEND THE USER STUDY WRITTEN
* REFERENCES SUCH AS THE "PORTING UNIX TO THE 386" SERIES
* (BEGINNING JANUARY 1991 "DR. DOBBS JOURNAL", USA AND BEGINNING
* JUNE 1991 "UNIX MAGAZIN", GERMANY) BY WILLIAM F. JOLITZ AND
* LYNNE GREER JOLITZ, AS WELL AS OTHER BOOKS ON UNIX AND THE
* ON-LINE 386BSD USER MANUAL BEFORE USE. A BOOK DISCUSSING THE INTERNALS
* OF 386BSD ENTITLED "386BSD FROM THE INSIDE OUT" WILL BE AVAILABLE LATE 1992.
* THIS SOFTWARE IS PROVIDED BY THE DEVELOPER ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE DEVELOPER BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* from: unknown origin, 386BSD 0.1
* $Id: lpt.c,v 1.6 1993/11/25 01:31:41 wollman Exp $
* Device Driver for AT parallel printer port
* Written by William Jolitz 12/18/90
#include "i386/isa/isa.h"
#include "i386/isa/isa_device.h"
#include "i386/isa/lptreg.h"
#define LPINITRDY 4 /* wait up to 4 seconds for a ready */
#define LPTOUTTIME 4 /* wait up to 4 seconds for a ready */
/* BIOS printer list - used by BIOS probe*/
#define BIOS_LPT_PORTS 0x408
#define BIOS_PORTS (short *)(KERNBASE+BIOS_LPT_PORTS)
#define lprintf if (lptflag) printf
int lptprobe(), lptattach();
struct isa_driver lptdriver
= {
lptprobe
, lptattach
, "lpt"
#define LPTUNIT(s) ((s)&0x03)
#define LPTFLAGS(s) ((s)&0xfc)
/* default case: negative prime, negative ack, handshake strobe,
#define LP_POS_INIT 0x04 /* if we are a postive init signal */
#define LP_POS_ACK 0x08 /* if we are a positive going ack */
#define LP_NO_PRIME 0x10 /* don't prime the printer at all */
#define LP_PRIMEOPEN 0x20 /* prime on every open */
#define LP_AUTOLF 0x40 /* tell printer to do an automatic lf */
#define LP_BYPASS 0x80 /* bypass printer ready checks */
u_char sc_irq
; /* IRQ status of port */
#define LP_HAS_IRQ 0x01 /* we have an irq available */
#define LP_USE_IRQ 0x02 /* we are using our irq */
#define OPEN (1<<0) /* device is open */
#define ASLP (1<<1) /* awaiting draining of printer */
#define ERROR (1<<2) /* error was received from printer */
#define OBUSY (1<<3) /* printer is busy doing output */
#define LPTOUT (1<<4) /* timeout while not selected */
#define TOUT (1<<5) /* timeout while not selected */
#define INIT (1<<6) /* waiting to initialize for open */
#define INTERRUPTED (1<<7) /* write call was interrupted */
/* status masks to interrogate printer status */
#define RDY_MASK (LPS_SEL|LPS_OUT|LPS_NBSY|LPS_NERR) /* ready ? */
#define LP_READY (LPS_SEL|LPS_NBSY|LPS_NERR)
/* Printer Ready condition - from lpa.c */
/* Only used in polling code */
#define LPS_INVERT (LPS_NBSY | LPS_NACK | LPS_SEL | LPS_NERR)
#define LPS_MASK (LPS_NBSY | LPS_NACK | LPS_OUT | LPS_SEL | LPS_NERR)
#define NOT_READY(x) ((inb(x)^LPS_INVERT)&LPS_MASK)
#define MAX_SLEEP (hz*5) /* Timeout while waiting for device ready */
#define MAX_SPIN 20 /* Max delay for device ready in usecs */
* Internal routine to lptprobe to do port tests of one byte value
lpt_port_test(port
, data
, mask
)
while (temp
!= data
&& --timeout
);
lprintf("Port 0x%x\tout=%x\tin=%x\ttout=%d\n",
port
, data
, temp
, timeout
);
* New lpt port probe Geoff Rehmet - Rhodes University - 14/2/94
* Based partially on Rod Grimes' printer probe
* 1) If no port address was given, use the bios detected ports
* and autodetect what ports the printers are on.
* 2) Otherwise, probe the data port at the address given,
* using the method in Rod Grimes' port probe.
* (Much code ripped off directly from Rod's probe.)
* Comments from Rod's probe:
* 1) You should be able to write to and read back the same value
* to the data port. Do an alternating zeros, alternating ones,
* walking zero, and walking one test to check for stuck bits.
* 2) You should be able to write to and read back the same value
* to the control port lower 5 bits, the upper 3 bits are reserved
* per the IBM PC technical reference manauls and different boards
* do different things with them. Do an alternating zeros, alternating
* ones, walking zero, and walking one test to check for stuck bits.
* Some printers drag the strobe line down when the are powered off
* so this bit has been masked out of the control port test.
* XXX Some printers may not like a fast pulse on init or strobe, I
* don't know at this point, if that becomes a problem these bits
* should be turned off in the mask byte for the control port test.
* We are finally left with a mask of 0x14, due to some printers
* being adamant about holding other bits high ........
* Before probing the control port, we write a 0 to the data port -
* If not, some printers chuck out garbage when the strobe line
* 3) Set the data and control ports to a value of 0
* This probe routine has been tested on Epson Lx-800, HP LJ3P,
* Epson FX-1170 and C.Itoh 8510RM
* Quick exit on fail added.
static short next_bios_lpt
= 0;
* Make sure there is some way for lptopen to see that
* the port is not configured
* This 0 will remain if the port isn't attached
(lpt_sc
+ dvp
->id_unit
)->sc_port
= 0;
/* If port not specified, use bios list */
if(dvp
->id_iobase
< 0) { /* port? */
if((next_bios_lpt
< BIOS_MAX_LPT
) &&
(*(BIOS_PORTS
+next_bios_lpt
) != 0) ) {
dvp
->id_iobase
= *(BIOS_PORTS
+next_bios_lpt
++);
/* Port was explicitly specified */
/* This allows probing of ports unknown to the BIOS */
port
= dvp
->id_iobase
+ lpt_data
;
data
= 0x55; /* Alternating zeros */
if (!lpt_port_test(port
, data
, mask
))
{ status
= 0 ; goto end_probe
; }
data
= 0xaa; /* Alternating ones */
if (!lpt_port_test(port
, data
, mask
))
{ status
= 0 ; goto end_probe
; }
for (i
= 0; i
< 8; i
++) { /* Walking zero */
if (!lpt_port_test(port
, data
, mask
))
{ status
= 0 ; goto end_probe
; }
for (i
= 0; i
< 8; i
++) { /* Walking one */
if (!lpt_port_test(port
, data
, mask
))
{ status
= 0 ; goto end_probe
; }
/* write 0's to control and data ports */
outb(dvp
->id_iobase
+lpt_data
, 0);
outb(dvp
->id_iobase
+lpt_control
, 0);
/* XXX Todo - try and detect if interrupt is working */
sc
= lpt_sc
+ isdp
->id_unit
;
sc
->sc_port
= isdp
->id_iobase
;
sc
->sc_primed
= 0; /* not primed yet */
outb(sc
->sc_port
+lpt_control
, LPC_NINIT
);
/* check if we can use interrupt */
lprintf("oldirq %x\n", sc
->sc_irq
);
sc
->sc_irq
= LP_HAS_IRQ
| LP_USE_IRQ
;
printf("lpt%d: Interrupt-driven port\n", isdp
->id_unit
);
lprintf("lpt%d: Polled port\n", isdp
->id_unit
);
lprintf("irq %x\n", sc
->sc_irq
);
* lptopen -- reset the printer, then wait until it's selected and not busy.
u_int unit
= LPTUNIT(minor(dev
));
if ((unit
>= NLPT
) || (sc
->sc_port
== 0))
/* Only check open bit */
lprintf("lp: still open\n") ;
lprintf("still open %x\n", sc
->sc_state
);
} else sc
->sc_state
|= INIT
;
sc
->sc_flags
= LPTFLAGS(minor(dev
));
lprintf("lp flags 0x%x\n", sc
->sc_flags
);
if((sc
->sc_flags
& LP_NO_PRIME
) == 0) {
if((sc
->sc_flags
& LP_PRIMEOPEN
) || sc
->sc_primed
== 0) {
outb(port
+lpt_control
, 0);
outb(port
+lpt_control
, LPC_SEL
|LPC_NINIT
);
/* wait till ready (printer running diagnostics) */
/* ran out of waiting for the printer */
if (trys
++ >= LPINITRDY
*4) {
lprintf ("status %x\n", inb(port
+lpt_status
) );
/* wait 1/4 second, give up if we get a signal */
if (tsleep ((caddr_t
)sc
, LPPRI
|PCATCH
, "lptinit",
/* is printer online and ready for output */
} while ((inb(port
+lpt_status
) & (LPS_SEL
|LPS_OUT
|LPS_NBSY
|LPS_NERR
)) !=
(LPS_SEL
|LPS_NBSY
|LPS_NERR
));
sc
->sc_control
= LPC_SEL
|LPC_NINIT
;
if(sc
->sc_flags
&LP_AUTOLF
)
sc
->sc_control
|= LPC_AUTOL
;
/* enable interrupt if interrupt-driven */
if(sc
->sc_irq
& LP_USE_IRQ
)
sc
->sc_control
|= LPC_ENA
;
outb(port
+lpt_control
, sc
->sc_control
);
sc
->sc_inbuf
= geteblk(BUFSIZE
);
/* only use timeout if using interrupt */
lprintf("irq %x\n", sc
->sc_irq
);
if(sc
->sc_irq
& LP_USE_IRQ
) {
timeout (lptout
, (caddr_t
)sc
, hz
/2);
lprintf ("T %x ", inb(sc
->sc_port
+lpt_status
));
timeout (lptout
, (caddr_t
)sc
, hz
/2);
else sc
->sc_state
&= ~TOUT
;
if (sc
->sc_state
& ERROR
)
* Avoid possible hangs do to missed interrupts
* lptclose -- close the device, free the local line buffer.
* Check for interrupted write call added.
struct lpt_softc
*sc
= lpt_sc
+ LPTUNIT(minor(dev
));
/* if the last write was interrupted, don't complete it */
if((!(sc
->sc_state
& INTERRUPTED
)) && (sc
->sc_irq
& LP_USE_IRQ
))
while ((inb(port
+lpt_status
) & (LPS_SEL
|LPS_OUT
|LPS_NBSY
|LPS_NERR
)) !=
(LPS_SEL
|LPS_NBSY
|LPS_NERR
) || sc
->sc_xfercnt
)
/* wait 1/4 second, give up if we get a signal */
if (tsleep ((caddr_t
)sc
, LPPRI
|PCATCH
,
"lpclose", hz
) != EWOULDBLOCK
)
outb(sc
->sc_port
+lpt_control
, LPC_NINIT
);
* Workhorse for actually spinning and writing bytes to printer
* This code is only used when we are polling the port
/* loop for every character .. */
while (sc
->sc_xfercnt
> 0) {
* Wait for printer ready.
* Loop 20 usecs testing BUSY bit, then sleep
* for exponentially increasing timeout. (vak)
for (spin
=0; NOT_READY(port
+lpt_status
) && spin
<MAX_SPIN
; ++spin
)
DELAY(1); /* XXX delay is NOT this accurate! */
while (NOT_READY(port
+lpt_status
)) {
* Now sleep, every cycle a
* But no more than 10 seconds. (vak)
err
= tsleep((caddr_t
)sc
, LPPRI
,
if (err
!= EWOULDBLOCK
) {
outb(port
+lpt_control
, sc
->sc_control
|LPC_STB
);
outb(port
+lpt_control
, sc
->sc_control
);
* lptwrite --copy a line from user space to a local buffer, then call
* putc to get the chars moved to the output queue.
* Flagging of interrupted write added.
struct lpt_softc
*sc
= lpt_sc
+ LPTUNIT(minor(dev
));
sc
->sc_state
&= ~INTERRUPTED
;
while (n
= MIN(BUFSIZE
, uio
->uio_resid
)) {
sc
->sc_cp
= sc
->sc_inbuf
->b_un
.b_addr
;
uiomove(sc
->sc_cp
, n
, uio
);
if(sc
->sc_irq
& LP_USE_IRQ
)
while (sc
->sc_xfercnt
> 0) {
/* if the printer is ready for a char, */
if ((sc
->sc_state
& OBUSY
) == 0){
lprintf("\nC %d. ", sc
->sc_xfercnt
);
if (sc
->sc_state
& OBUSY
)
if (err
= tsleep ((caddr_t
)sc
,
LPPRI
|PCATCH
, "lpwrite", 0)) {
sc
->sc_state
|= INTERRUPTED
;
else { /* polled write */
if((err
= pushbytes(sc
)))
* lptintr -- handle printer interrupts which occur when the printer is
* ready to accept another char.
* do checking for interrupted write call.
struct lpt_softc
*sc
= lpt_sc
+ unit
;
int port
= sc
->sc_port
, sts
;
/* is printer online and ready for output */
if (((sts
=inb(port
+lpt_status
)) & RDY_MASK
) == LP_READY
) {
sc
->sc_state
= (sc
->sc_state
| OBUSY
) & ~ERROR
;
/*lprintf("%x ", *sc->sc_cp); */
outb(port
+lpt_data
, *sc
->sc_cp
++) ;
outb(port
+lpt_control
, sc
->sc_control
|LPC_STB
);
outb(port
+lpt_control
, sc
->sc_control
);
/* any more data for printer */
if(--(sc
->sc_xfercnt
) > 0) return;
* No more data waiting for printer.
* Wakeup is not done if write call was interrupted.
if(!(sc
->sc_state
& INTERRUPTED
))
} else { /* check for error */
if(((sts
& (LPS_NERR
| LPS_OUT
) ) != LPS_NERR
) &&
lptioctl(dev
, cmd
, data
, flag
)
dothis
; andthis
; andthat
;
#endif /* THISISASAMPLE */