add spif

3 files changed, 114 insertions, 3 deletions

diff --git a/share/man/man4/man4.sparc64/Makefile b/share/man/man4/man4.sparc64/Makefile
index ea1f91a5455..ddf2f1d04aa 100644
--- a/share/man/man4/man4.sparc64/Makefile
+++ b/share/man/man4/man4.sparc64/Makefile
@@ -1,9 +1,9 @@
-#	$OpenBSD: Makefile,v 1.11 2002/01/12 21:48:48 jason Exp $
+#	$OpenBSD: Makefile,v 1.12 2002/01/13 02:15:01 jason Exp $
 
 # TODO: auxio.4 beeper.4 clock.4 ebus.4 pcons.4 psycho.4 sbus.4 timer.4
 MAN=	audioce.4 audiocs.4 autoconf.4 be.4 cgsix.4 cgthree.4 esp.4 gem.4 \
 	hme.4 intro.4 le.4 magma.4 mem.4 openprom.4 pcons.4 qe.4 qec.4 \
-	sab.4 zs.4
+	sab.4 spif.4 zs.4
 MLINKS=	mem.4 kmem.4 \
 	sab.4 sabtty.4
 MANSUBDIR=sparc64
diff --git a/share/man/man4/man4.sparc64/intro.4 b/share/man/man4/man4.sparc64/intro.4
index 538d48266a3..f06d5ba0e3f 100644
--- a/share/man/man4/man4.sparc64/intro.4
+++ b/share/man/man4/man4.sparc64/intro.4
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: intro.4,v 1.5 2002/01/12 21:51:39 jason Exp $
+.\"     $OpenBSD: intro.4,v 1.6 2002/01/13 02:15:01 jason Exp $
 .\"
 .\" Copyright (c) 2001 The OpenBSD Project
 .\" All Rights Reserved.
@@ -105,6 +105,8 @@ or
 Ethernet controllers.
 .It sab
 Infineon SAB82532 serial controller.
+.It spif
+Sun SUNW,spif serial/parallel communication boards.
 .It zs
 Zilog 8530 serial controller.
 .El
diff --git a/share/man/man4/man4.sparc64/spif.4 b/share/man/man4/man4.sparc64/spif.4
new file mode 100644
index 00000000000..5c15d7ac2dd
--- /dev/null
+++ b/share/man/man4/man4.sparc64/spif.4
@@ -0,0 +1,109 @@
+.\"     $OpenBSD: spif.4,v 1.1 2002/01/13 02:15:01 jason Exp $
+.\"
+.\" Copyright (c) 1999-2002 Jason L. Wright (jason@thought.net)
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 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 product includes software developed by Jason L. Wright
+.\" 4. The name of the author may not be used to endorse or promote products
+.\"    derived from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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 SUCH DAMAGE.
+.\"
+.Dd January 12, 2002
+.Dt SPIF 4 sparc64
+.Os
+.Sh NAME
+.Nm spif
+.Nd SBus (spiffy) Serial/Parallel Interface
+.Sh SYNOPSIS
+.Cd "spif* at sbus? slot ? offset ?"
+.Cd "stty* at spif?"
+.Cd "sbpp* at spif?"
+.Sh DESCRIPTION
+The
+.Nm spif
+driver provides support for the Sun Serial/Parallel Interface card
+(Sun part number 501-1931)
+based around the
+Cirrus Logic CD180 octal serial controller
+and the
+Cirrus Logic PPC2 parallel port controller.
+.Pp
+The device minor numbers for this driver are encoded as follows:
+.Pp
+.Bd -literal
+    +---+---+---+---+---+---+---+---+
+    | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 |
+    +---+---+---+---+---+---+---+---+
+      |   |   |   |   |   |   |   |
+      |   |   |   |   |   +---+---+---> port number
+      |   |   |   |   |
+      |   |   |   |   +---------------> unused
+      |   |   |   |
+      |   |   |   +-------------------> dialout (on tty ports)
+      |   |   |
+      |   |   +-----------------------> unused
+      |   |
+      +---+---------------------------> card number
+.Ed
+.Pp
+Up to four cards are supported in the system.
+.Pp
+Each of the serial ports has an 8 byte FIFO for receive and transmit as
+well as automatic hardware (RTS/CTS) flow control.
+.Sh DIAGNOSTICS
+.Bl -diag
+.It "spif%d: ccr timeout"
+A timeout occurred while writing to one of the CD180 registers.
+.It "stty%d-%d: fifo overflow"
+Incoming characters were discarded because the driver's interrupt
+routine could not read them fast enough from the card.
+.It "stty%d-%d: ring overflow"
+Incoming characters were discarded because the application
+in control of the device did not read the input fast enough.
+.El
+.Sh FILES
+.Bl -tag -width /dev/tty[jkl][0-7] -compact
+.It /dev/tty[jkl][0-7]
+Serial ports
+.It /dev/sbpp[0-3]
+Parallel ports
+.El
+.Sh SEE ALSO
+.Xr read 2 ,
+.Xr termios 4 ,
+.Xr tty 4
+.Sh AUTHORS
+The driver was written by Jason Wright <jason@thought.net>, and is
+heavily based on the
+.Xr magma 4
+driver written by Iain Hibbert <plunky@skate.demon.co.uk>.
+.Sh HISTORY
+The
+.Nm spif
+driver was first supported in
+.Ox 3.1 .
+.Sh TODO
+The parallel port is not supported yet.
+.Pp
+Dialout (cua) devices are not yet supported.