share/man/man4/zstty.4

   1 .\"     $NetBSD: zstty.4,v 1.11 2007/05/12 20:46:33 pavel Exp $
   2 .\"
   3 .\" Copyright (c) 1997 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to The NetBSD Foundation
   7 .\" by Gordon W. Ross.
   8 .\"
   9 .\" Redistribution and use in source and binary forms, with or without
  10 .\" modification, are permitted provided that the following conditions
  11 .\" are met:
  12 .\" 1. Redistributions of source code must retain the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer.
  14 .\" 2. Redistributions in binary form must reproduce the above copyright
  15 .\"    notice, this list of conditions and the following disclaimer in the
  16 .\"    documentation and/or other materials provided with the distribution.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  19 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  20 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  21 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  22 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  23 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  24 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  25 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  26 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  27 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  28 .\" POSSIBILITY OF SUCH DAMAGE.
  29 .\"
  30 .Dd May 12, 2007
  31 .Dt ZSTTY 4
  32 .Os
  33 .Sh NAME
  34 .Nm zstty ,
  35 .Nm zsc ,
  36 .Nm zs
  37 .Nd
  38 .Tn Zilog
  39 8530 serial communications interface
  40 .Sh SYNOPSIS
  41 .Ss alpha ( DEC 3000 )
  42 .Cd "zsc0       at ioasic? offset 0x100000"
  43 .Cd "zsc1       at ioasic? offset 0x180000"
  44 .Cd "zstty0     at zsc0 channel ?       # serial ports on B channels"
  45 .Cd "zstty2     at zsc1 channel ?       # serial ports on B channels"
  46 .Cd "lkkbd0     at zsc1 channel ?       # keyboard port on A channels"
  47 .Cd "vsms0      at zsc0 channel ?       # mouse port on A channels"
  48 .Ss cesfic
  49 .Cd "zsc*       at mainbus0"
  50 .Cd "zstty*     at zsc? channel ?"
  51 .Ss mac68k and macppc
  52 .Cd "zsc0       at obio?"
  53 .Cd "zstty*     at zsc? channel ?"
  54 .Ss mipsco
  55 .Cd "zsc0       at obio0 addr 0xbb000000"
  56 .Cd "zstty0     at zsc0 channel 0"
  57 .Cd "zstty1     at zsc0 channel 1"
  58 .Ss mvme68k
  59 .Cd "zsc*       at pcc? ipl 4"
  60 .Cd "zsc*       at pcctwo? ipl 4"
  61 .Cd "zstty*     at zsc? channel ?"
  62 .Ss news68k
  63 .Cd "zsc0       at hb0 addr 0xe0d40000 ipl 5 vect 64 flags 0x0  # news1700"
  64 .Cd "zsc0       at hb1 addr 0xe1780000 ipl 5 vect 64 flags 0x1  # news1200"
  65 .Cd "zstty0     at zsc0 channel 0"
  66 .Cd "zstty1     at zsc0 channel 1"
  67 .Ss newsmips
  68 .Cd "zsc0       at hb0 addr 0xbfec0000 level 1 flags 0x0        # on-board"
  69 .Cd "zsc1       at hb0 addr 0xb8c40100 level 1 flags 0x1        # expansion board"
  70 .Cd "zsc2       at hb0 addr 0xb8c40104 level 1 flags 0x1"
  71 .Cd "zsc0       at ap?"
  72 .Cd "zstty0     at zsc0 channel 0"
  73 .Cd "zstty1     at zsc0 channel 1"
  74 .Cd "zstty2     at zsc1 channel 0"
  75 .Cd "zstty3     at zsc1 channel 1"
  76 .Cd "zstty4     at zsc2 channel 0"
  77 .Cd "zstty5     at zsc2 channel 1"
  78 .Ss next68k
  79 .Cd "zsc0       at intio? ipl 5"
  80 .Cd "#zsc1      at intio? ipl 5"
  81 .Cd "zstty0     at zsc0 channel 0       # ttya"
  82 .Cd "zstty1     at zsc0 channel 1       # ttyb"
  83 .Ss sgimips
  84 .Cd "zsc*       at hpc0 offset ?"
  85 .Cd "zstty*     at zsc? channel ?"
  86 .Ss sparc
  87 .Cd "zs0        at mainbus0                             # sun4c"
  88 .Cd "zs0        at obio0                                # sun4m"
  89 .Cd "zs0        at obio0 addr 0xf1000000 level 12       # sun4/200 and sun4/300"
  90 .Cd "zs0        at obio0 addr 0x01000000 level 12       # sun4/100"
  91 .Cd "zstty0     at zs0 channel 0                        # ttya"
  92 .Cd "zstty1     at zs0 channel 1                        # ttyb"
  93 .Cd "zs1        at mainbus0                             # sun4c"
  94 .Cd "zs1        at obio0                                # sun4m"
  95 .Cd "zs1        at obio0 addr 0xf0000000 level 12       # sun4/200 and sun4/300"
  96 .Cd "zs1        at obio0 addr 0x00000000 level 12       # sun4/100"
  97 .Cd "kbd0       at zs1 channel 0                        # keyboard"
  98 .Cd "ms0        at zs1 channel 1                        # mouse"
  99 .Cd "zs2        at obio0 addr 0xe0000000 level 12       # sun4/300"
 100 .Cd "zstty2     at zs2 channel 0                        # ttyc"
 101 .Cd "zstty3     at zs2 channel 1                        # ttyd"
 102 .Ss sun2
 103 .Cd "zs0        at obio0 addr 0x002000  # 2/120, 2/170"
 104 .Cd "zs1        at obmem0 addr 0x780000 # 2/120, 2/170"
 105 .Cd "zs0        at obio0 addr 0x7f2000  # 2/50"
 106 .Cd "zs1        at obio0 addr 0x7f1800  # 2/50"
 107 .Cd "zs2        at mbmem0 addr 0x080800 # 2/120, 2/170 (first sc SCSI)"
 108 .Cd "zs3        at mbmem0 addr 0x081000 # 2/120, 2/170 (first sc SCSI)"
 109 .Cd "zs4        at mbmem0 addr 0x084800 # 2/120, 2/170 (second sc SCSI)"
 110 .Cd "zs5        at mbmem0 addr 0x085000 # 2/120, 2/170 (second sc SCSI)"
 111 .Cd "zstty*     at zs? channel ?        # ttya"
 112 .Cd "kbd0       at zstty?               # keyboard"
 113 .Cd "ms0        at zstty?               # mouse"
 114 .Ss sun3
 115 .Cd "zstty0     at zsc1 channel 0       # ttya"
 116 .Cd "zstty1     at zsc1 channel 1       # ttyb"
 117 .Cd "kbd0       at zsc0 channel 0       # keyboard"
 118 .Cd "ms0        at zsc0 channel 1       # mouse"
 119 .Ss x68k
 120 .Cd "zsc0       at intio0 addr 0xe98000 intr 112"
 121 .Cd "zstty0     at zsc0 channel 0               # built-in RS-232C"
 122 .Cd "ms0        at zsc0 channel 1               # standard mouse"
 123 .Cd "#zsc1      at intio0 addr 0xeafc00 intr 113"
 124 .Cd "#zstty2    at zsc1 channel 0"
 125 .Cd "#zstty3    at zsc1 channel 1"
 126 .Cd "#zsc2      at intio0 addr 0xeafc10 intr 114"
 127 .Cd "#zstty4    at zsc2 channel 0"
 128 .Cd "#zstty5    at zsc2 channel 1"
 129 .Sh DESCRIPTION
 130 The
 131 .Nm
 132 driver provides
 133 .Tn TTY
 134 support for
 135 .Tn Zilog
 136 8530 Dual
 137 .Tn UART
 138 chips.
 139 .Pp
 140 Input and output for each line may set to any baud rate in the
 141 range 50 to 38400 (and higher on some machines).
 142 .Sh FILES
 143 .Ss alpha
 144 .Bl -tag -width Pa
 145 .It Pa /dev/ttyB0
 146 .It Pa /dev/ttyB1
 147 .El
 148 .Ss others
 149 .Bl -tag -width Pa
 150 .It Pa /dev/ttya
 151 .It Pa /dev/ttyb
 152 .El
 153 .Sh DIAGNOSTICS
 154 .Bl -tag -width indent
 155 .It zs0*: fifo overflow
 156 .br
 157 The on-chip
 158 .Dq FIFO
 159 has overflowed and incoming data has been lost.
 160 This generally means the machine is not responding to
 161 interrupts from the ZS chip fast enough, which can be
 162 remedied only by using a lower baud rate.
 163 .It zs0*: ring overflow
 164 .br
 165 The software input
 166 .Qq ring
 167 has overflowed.
 168 This usually means input flow-control is not configured correctly
 169 .Pq i.e. incorrect cable wiring .
 170 .El
 171 .Sh SEE ALSO
 172 .Xr kbd 4 ,
 173 .Xr ms 4 ,
 174 .Xr scc 4 ,
 175 .Xr tty 4
 176 .Sh HISTORY
 177 The
 178 .Nm
 179 driver was derived from the
 180 .Nm sparc
 181 .Nm zs
 182 driver supplied with
 183 .Bx 4.4
 184 .Ux .
 185 .Sh CAVEATS
 186 .Pa /dev/ttyB1
 187 on alpha is created by
 188 .Xr MAKEDEV 8
 189 with minor number 2, so the corresponding device should be zstty2, not zstty1.
 190 .Sh BUGS
 191 The old
 192 .Tn Zilog
 193 8530 chip has a very small FIFO (3 bytes?) and
 194 therefore has very strict latency requirements for the
 195 interrupt service routine.
 196 This limits the usable baud rates on many machines.