1.\" $OpenBSD: zs.4,v 1.2 2017/11/02 15:37:58 jmc Exp $ 2.\" $NetBSD: zstty.4,v 1.14 2011/06/07 20:22:56 wiz Exp $ 3.\" 4.\" Copyright (c) 1997 The NetBSD Foundation, Inc. 5.\" All rights reserved. 6.\" 7.\" This code is derived from software contributed to The NetBSD Foundation 8.\" by Gordon W. Ross. 9.\" 10.\" Redistribution and use in source and binary forms, with or without 11.\" modification, are permitted provided that the following conditions 12.\" are met: 13.\" 1. Redistributions of source code must retain the above copyright 14.\" notice, this list of conditions and the following disclaimer. 15.\" 2. Redistributions in binary form must reproduce the above copyright 16.\" notice, this list of conditions and the following disclaimer in the 17.\" documentation and/or other materials provided with the distribution. 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 20.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 21.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 22.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 23.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 24.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 25.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 26.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 27.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 28.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 29.\" POSSIBILITY OF SUCH DAMAGE. 30.\" 31.Dd $Mdocdate: November 2 2017 $ 32.Dt ZS 4 alpha 33.Os 34.Sh NAME 35.Nm zs , 36.\" .Nm zskbd , 37.\" .Nm zsms , 38.Nm zstty 39.Nd Zilog 8530 (ZSCC) Serial Communications Controller 40.Sh SYNOPSIS 41.Cd "zs* at ioasic0" 42.\" .Cd "lskbd* at zs1" 43.\" .Cd "vsms* at zs0" 44.Cd "zstty* at zs?" 45.Sh DESCRIPTION 46The 47.Nm 48driver provides TTY support for the two Zilog 8530 Dual UART chips found on 49DEC 3000 systems. 50On these systems, two of these serial interfaces are hardwired for use by the 51keyboard and mouse. 52Only the second interface of each 53.Nm 54controller can be used as a regular serial port. 55.\" The 56.\" .Nm lskbd 57.\" devices connect keyboard devices to the generic keyboard driver 58.\" .Nm wskbd . 59.\" The 60.\" .Nm vsms 61.\" devices connect mice to the generic mouse driver 62.\" .Xr wsmouse 4 . 63The 64.Nm zstty 65interfaces provide RS-423 66and RS-232 serial ports for general purpose use. 67.Pp 68The 69.Nm 70driver supports all of the standard 71.Xr tty 4 72ioctl calls. 73The status of the DTR, RTS, CTS, and DCD signals can be queried with 74the TIOCMGET command but, due to limitations in the hardware, 75only the DTR and RTS signals can be modified with the TIOCMSET, TIOCMBIC, 76and TIOCMBIS 77.Xr ioctl 2 78commands. 79.Pp 80Input and output for each line may be set to any baud rate in the 81range 50 to 38400. 82.Sh FILES 83.Bl -tag -width Pa -compact 84.It Pa /dev/ttyB[01] 85.It Pa /dev/cuaB[01] 86.El 87.Sh DIAGNOSTICS 88.Bl -tag -width indent 89.It zs*: fifo overflow 90The on-chip 91.Dq FIFO 92has overflowed and incoming data has been lost. 93This generally means the machine is not responding to 94interrupts from the ZS chip fast enough, which can be 95remedied only by using a lower baud rate. 96.It zs*: ring overflow 97The software input 98.Qq ring 99has overflowed. 100This usually means input flow-control is not configured correctly 101.Pq i.e. incorrect cable wiring . 102.El 103.Sh SEE ALSO 104.Xr intro 4 , 105.Xr ioasic 4 , 106.Xr tty 4 107.\" .Xr wskbd 4 , 108.\" .Xr wsmouse 4 109