summaryrefslogtreecommitdiff
path: root/share/man/man4/man4.sparc64
diff options
context:
space:
mode:
authorJason Wright <jason@cvs.openbsd.org>2002-01-13 02:15:02 +0000
committerJason Wright <jason@cvs.openbsd.org>2002-01-13 02:15:02 +0000
commit252eee672f0dc49028a461e0ab65759cae6fba2d (patch)
treec155f6c7c7f1399db955229ed39ebc4c95c8902e /share/man/man4/man4.sparc64
parenta5696a78d4d112f0baa64ff89e7cde94622c31a0 (diff)
add spif
Diffstat (limited to 'share/man/man4/man4.sparc64')
-rw-r--r--share/man/man4/man4.sparc64/Makefile4
-rw-r--r--share/man/man4/man4.sparc64/intro.44
-rw-r--r--share/man/man4/man4.sparc64/spif.4109
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.