share/man/man4/man4.i386/sio.4

   1 .\" Copyright (c) 1990, 1991 The Regents of the University of California.
   2 .\" All rights reserved.
   3 .\"
   4 .\" This code is derived from software contributed to Berkeley by
   5 .\" the Systems Programming Group of the University of Utah Computer
   6 .\" Science Department.
   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 .\" 3. All advertising materials mentioning features or use of this software
  16 .\"    must display the following acknowledgement:
  17 .\"     This product includes software developed by the University of
  18 .\"     California, Berkeley and its contributors.
  19 .\" 4. Neither the name of the University nor the names of its contributors
  20 .\"    may be used to endorse or promote products derived from this software
  21 .\"    without specific prior written permission.
  22 .\"
  23 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  24 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  25 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  26 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  27 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  28 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  29 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  30 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  31 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  32 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  33 .\" SUCH DAMAGE.
  34 .\"
  35 .\"     from: @(#)dca.4 5.2 (Berkeley) 3/27/91
  36 .\"     from: com.4,v 1.1 1993/08/06 11:19:07 cgd Exp
  37 .\"     $Id$
  38 .\"
  39 .Dd August 28, 1993
  40 .Dt SIO 4 i386
  41 .Os FreeBSD
  42 .Sh NAME
  43 .Nm sio
  44 .Nd
  45 fast interrupt serial communications interface
  46 .Sh SYNOPSIS
  47 .Cd "device sio0 at isa? port" \&"IO_COM1\&" tty irq 4 vector siointr
  48 .Cd "device sio1 at isa? port" \&"IO_COM2\&" tty irq 3 vector siointr
  49 .Cd "device sio2 at isa? port" \&"IO_COM3\&" tty irq 5 vector siointr
  50 .Cd "device sio3 at isa? port" \&"IO_COM4\&" tty irq 9 vector siointr
  51 .Sh DESCRIPTION
  52 The
  53 .Nm sio
  54 driver provides support for NS8250-, NS16450-, and NS16550-based
  55 .Tn EIA
  56 .Tn RS-232C
  57 .Pf ( Tn CCITT
  58 .Tn V.28 )
  59 communications interfaces.  The NS8250 and NS16450 have single character
  60 buffers, and the NS16550 has a 16 character buffer.
  61 .Pp
  62 Input and output for each line may set to one of following baud rates;
  63 50, 75, 110, 134.5, 150, 300, 600, 1200, 1800, 2400, 4800, 9600,
  64 19200, 38400, 57600, or 115200.
  65 .Sh FILES
  66 .Bl -tag -width Pa
  67 .It Pa /dev/tty00
  68 .It Pa /dev/tty01
  69 .El
  70 .Sh DIAGNOSTICS
  71 .Bl -diag
  72 .It sio%d: silo overflow.
  73 The single-character input
  74 .Dq silo
  75 has overflowed and incoming data has been lost.
  76 .\".It com%d: weird interrupt: %x.
  77 .\"The device has generated an unexpected interrupt
  78 .\"with the code listed.
  79 .El
  80 .Sh SEE ALSO
  81 .Xr tty 4
  82 .Xr com 4
  83 .Sh HISTORY
  84 The
  85 .Nm
  86 driver is derived from the
  87 .Nm HP9000/300
  88 .Nm dca
  89 driver and is
  90 .Ud
  91 .Sh BUGS
  92 Data loss is not near as likely on busy systems as they are with the
  93 .Xr com 4
  94 driver but they still can occur at very high baud rates on slow systems.
  95 .Pp
  96 The constants which define the locations
  97 of the various seiral ports are holdovers from
  98 .Nm DOS .
  99 .Pp
 100 As usual, you get what you pay for; cheap NS16550 clones
 101 generally don't work.