share/man/man4/scc.4

   1 .\"
   2 .\" Copyright (c) 1996 Jonathan Stone.
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\" 3. All advertising materials mentioning features or use of this software
  14 .\"    must display the following acknowledgement:
  15 .\"      This product includes software developed by Jonathan Stone.
  16 .\" 4. The name of the author may not be used to endorse or promote products
  17 .\"    derived from this software without specific prior written permission
  18 .\"
  19 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  20 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  21 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  22 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  23 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  24 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  25 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  26 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  27 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  28 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  29 .\"
  30 .\"     $NetBSD: scc.4,v 1.7 2003/05/01 19:31:54 fair Exp $
  31 .\"
  32 .Dd April 24, 2003
  33 .Dt SCC 4
  34 .Os
  35 .Sh NAME
  36 .Nm scc
  37 .Nd
  38 Zilog 8530 Serial Communications Controller interface
  39 .Sh SYNOPSIS
  40 .Cd "scc* at ioasic? offset ?"
  41 .Sh DESCRIPTION
  42 The
  43 .Nm
  44 driver provides support for the
  45 .Tn Zilog
  46 8530 Serial Communications
  47 Controller
  48 .Pq Tn SCC
  49 via the
  50 .Tn IOASIC
  51 found on
  52 .Tn DECstation
  53 5000 models in the /100, /20, and /240 series
  54 .Po
  55 supported by
  56 .Nx Ns /pmax
  57 .Pc .
  58 .Pp
  59 Each
  60 .Tn SCC
  61 device has two serial ports.
  62 The
  63 .Tn DECstation
  64 5000 model 20 provides one
  65 .Tn SCC
  66 device.
  67 Other models provide two, but one port of each device is dedicated to
  68 mouse and keyboard input, respectively.
  69 .Pp
  70 Input and output for each line may set to one of following baud rates:
  71 50, 75, 110, 134.5, 150, 300, 600, 1200, 1800, 2400, 4800, 9600,
  72 19200, 38400, or 57600.
  73 .Pp
  74 Speeds up to 230400 are supported by the chip and the motherboard,
  75 but speeds higher than 57600 do not work reliably without an external
  76 clock signal.
  77 .Sh FILES
  78 .Bl -tag -width Pa -compact
  79 .It Pa /dev/ttya
  80 .It Pa /dev/ttyb
  81 .It Pa /dev/ttyc
  82 .It Pa /dev/ttyd
  83 .El
  84 .Pp
  85 The mapping from units to serial-hardware outlets is idiosyncratic.
  86 The even ports are wired serial connectors and the odd-numbered ports
  87 are reserved for mouse and keyboard.
  88 .Pp
  89 On machines with one port like
  90 .Tn "Personal DECstations" ,
  91 the single device is
  92 .Pa ttya .
  93 .Pp
  94 On the
  95 .Tn "5000/1xx"
  96 and
  97 .Tn "5000/2xx" ,
  98 the first serial port (default serial console) is
  99 .Pa ttyc
 100 and the second port is
 101 .Pa ttya .
 102 .Sh SEE ALSO
 103 .Xr intro 4 ,
 104 .Xr ioasic 4 ,
 105 .Xr ttys 5 ,
 106 .Xr MAKEDEV 8
 107 .Sh HISTORY
 108 The
 109 .Nm
 110 driver first appeared in
 111 .Bx 4.4 .
 112 .Pp
 113 The
 114 .Nm
 115 driver was also used for the
 116 .Tn IOASIC
 117 .Tn SCC
 118 found in
 119 .Tn DEC
 120 .Tn Alpha
 121 model 3000
 122 .Tn TurboCHANNEL
 123 based systems;
 124 .Nx Ns /alpha
 125 has since been converted to use the machine-independent
 126 .Xr zstty 4 .
 127 .Sh BUGS
 128 The
 129 .Tn IOASIC
 130 provides internal
 131 .Tn DMA
 132 channels that can be programmed to transfer up to 4096 bytes of
 133 data into, or out, of an
 134 .Tn SCC
 135 without
 136 further software intervention.
 137 This feature of the
 138 .Tn IOASIC
 139 is not yet supported.
 140 .Pp
 141 The mapping from device-special files (major and minor number) to chip
 142 and port is arguably backwards.
 143 .Tn ULTRIX
 144 tries to hide the hardware mapping, but
 145 .Nx
 146 does not.
 147 Users wanting to use
 148 .Tn ULTRIX
 149 compatible tty names
 150 .Pa /dev/tty0
 151 and
 152 .Pa /dev/tty1
 153 for the
 154 .Nm
 155 comm-port lines should make links or device-special files which match
 156 their hardware setup.