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