1.\" $NetBSD: spif.4,v 1.7 2014/03/18 18:20:39 riastradh Exp $ 2.\" $OpenBSD: spif.4,v 1.12 2003/11/09 16:06:07 jmc Exp $ 3.\" 4.\" Copyright (c) 1999 Jason L. Wright (jason@thought.net) 5.\" All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\" 16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 17.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 18.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 19.\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, 20.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 21.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 22.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 24.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN 25.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 26.\" POSSIBILITY OF SUCH DAMAGE. 27.\" 28.Dd February 4, 1999 29.Dt SPIF 4 30.Os 31.Sh NAME 32.Nm spif 33.Nd SBus (spiffy) Serial/Parallel Interface 34.Sh SYNOPSIS 35.Cd "spif* at sbus? slot ? offset ? " Pq "sun4c/sun4m/sun4u" 36.Cd "stty* at spif? " Pq "sun4c/sun4m/sun4u" 37.Cd "sbpp* at spif? " Pq "sun4c/sun4m/sun4u" 38.Sh DESCRIPTION 39The 40.Nm spif 41driver provides support for the Sun Serial/Parallel Interface card 42(Sun part number 501-1931), which is based on the 43Cirrus Logic CD180 octal serial controller 44and the Cirrus Logic PPC2 parallel port controller. 45.Pp 46The device minor numbers for this driver are encoded as follows: 47.Bd -literal 48 +---+---+---+---+---+---+---+---+ 49 | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | 50 +---+---+---+---+---+---+---+---+ 51 | | | | | | | | 52 | | | | | +---+---+---> port number 53 | | | | | 54 | | | | +---------------> unused 55 | | | | 56 | | | +-------------------> dial-out (on tty ports) 57 | | | 58 | | +-----------------------> unused 59 | | 60 +---+---------------------------> card number 61.Ed 62.Pp 63Up to four cards are supported in the system. 64.Pp 65Each of the serial ports has an 8 byte FIFO for receive and transmit as 66well as automatic hardware (RTS/CTS) flow control. 67.Sh FILES 68.Bl -tag -width /dev/ttyS[0123][0-7] -compact 69.It /dev/ttyS[0123][0-7] 70Serial ports 71.It /dev/bppS[0-3] 72Parallel ports 73.El 74.Sh DIAGNOSTICS 75.Bl -diag 76.It "spif%d: ccr timeout" 77A timeout occurred while writing to one of the CD180 registers. 78.It "stty%d-%d: ring overflow" 79Incoming characters were discarded because the application 80in control of the device did not read the input fast enough. 81.El 82.Sh SEE ALSO 83.Xr intro 4 , 84.Xr sbus 4 , 85.Xr tty 4 86.Sh HISTORY 87The 88.Nm spif 89adapter was first supported in 90.Ox 2.5 . 91The driver was ported to 92.Nx 3.0 . 93.Sh AUTHORS 94.An -nosplit 95The driver was written by 96.An Jason Wright Aq Mt jason@thought.net , 97and is heavily based on the 98.Xr magma 4 99driver written by 100.An Iain Hibbert . 101.Sh TODO 102The parallel port is not supported yet. 103.Pp 104Dial-out (cua) devices are not yet supported. 105