4 files changed, 168 insertions, 46 deletions

diff --git a/share/man/man4/man4.alpha/Makefile b/share/man/man4/man4.alpha/Makefile
index 835cda69f5c..12db411d85e 100644
--- a/share/man/man4/man4.alpha/Makefile
+++ b/share/man/man4/man4.alpha/Makefile
@@ -1,8 +1,7 @@
-#	$OpenBSD: Makefile,v 1.19 2016/03/30 06:38:44 jmc Exp $
+#	$OpenBSD: Makefile,v 1.20 2017/11/02 14:04:24 mpi Exp $
 
-MAN=	apecs.4 asc.4 autoconf.4 bba.4 cia.4 intro.4 irongate.4 \
-	lca.4 le.4 mem.4 mcbus.4 mcpcia.4 scc.4 tcasic.4 \
-	tga.4 tsc.4 tsciic.4
+MAN=	apecs.4 asc.4 autoconf.4 bba.4 cia.4 intro.4 ioasic.4 irongate.4 \
+	lca.4 le.4 mem.4 mcbus.4 mcpcia.4 tcasic.4 tga.4 tsc.4 tsciic.4 zs.4
 MANSUBDIR=alpha
 
 .include <bsd.prog.mk>
diff --git a/share/man/man4/man4.alpha/asc.4 b/share/man/man4/man4.alpha/asc.4
index 019e959b9e9..df2f26bc80a 100644
--- a/share/man/man4/man4.alpha/asc.4
+++ b/share/man/man4/man4.alpha/asc.4
@@ -1,19 +1,19 @@
-.\"	$OpenBSD: asc.4,v 1.6 2012/08/14 01:08:19 dlg Exp $
+.\"	$OpenBSD: asc.4,v 1.7 2017/11/02 14:04:24 mpi Exp $
 .\"
 .\" Copyright (c) 1998 The OpenBSD Project
 .\" All rights reserved.
 .\"
 .\"
-.Dd $Mdocdate: August 14 2012 $
+.Dd $Mdocdate: November 2 2017 $
 .Dt ASC 4 alpha
 .Os
 .Sh NAME
 .Nm asc
 .Nd NCR 53c[f]94 on-board or TURBOchannel SCSI controller
 .Sh SYNOPSIS
-.Cd "tcds* at tc?" Pq " TURBOchannel PMAZ cards"
+.Cd "tcds* at tc?"
 .Cd "asc* at tcds?"
-.Cd "asc* at tc?" Pq "on-board SCSI"
+.Cd "asc* at tc?"
 .Sh DESCRIPTION
 The
 .Nm
diff --git a/share/man/man4/man4.alpha/scc.4 b/share/man/man4/man4.alpha/ioasic.4
index 812f1cc794d..87a0ad4243b 100644
--- a/share/man/man4/man4.alpha/scc.4
+++ b/share/man/man4/man4.alpha/ioasic.4
@@ -1,5 +1,7 @@
+.\" $OpenBSD: ioasic.4,v 1.1 2017/11/02 14:04:24 mpi Exp $
+.\" $NetBSD: ioasic.4,v 1.4 2004/05/11 22:42:47 wiz Exp $
 .\"
-.\" Copyright (c) 1996 Jonathan Stone.
+.\" Copyright (c) 1996, 1997 Jonathan Stone.
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -13,7 +15,7 @@
 .\" 3. All advertising materials mentioning features or use of this software
 .\"    must display the following acknowledgement:
 .\"      This product includes software developed by Jonathan Stone.
-.\" 3. The name of the author may not be used to endorse or promote products
+.\" 4. The name of the author may not be used to endorse or promote products
 .\"    derived from this software without specific prior written permission
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
@@ -27,53 +29,61 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.\"	$OpenBSD: scc.4,v 1.8 2007/05/31 19:19:53 jmc Exp $
-.\"
-.Dd $Mdocdate: May 31 2007 $
-.Dt SCC 4 alpha
+.Dd $Mdocdate: November 2 2017 $
+.Dt IOASIC 4 alpha
 .Os
 .Sh NAME
-.Nm scc
-.Nd Zilog serial communications interface
+.Nm ioasic
+.Nd
+baseboard IO control ASIC for DEC TURBOchannel systems
 .Sh SYNOPSIS
-.Cd "scc0 at ioasic?"
-.Cd "scc1 at ioasic?"
+.Cd "ioasic0 at tc? slot ? offset ?"
 .Sh DESCRIPTION
 The
 .Nm
-driver provides support for the Zilog 8530 Serial Communications
-Controller (SCC) via the IOCTL asic on TURBOchannel-based alphas
-(the DEC 3000 series).
-Each
+driver provides support for the DEC proprietary IOCTL ASIC found on
+DEC 3000 TURBOchannel machines.
+.Pp
+The
 .Nm
-device has two serial ports.
+provides hardware DMA channels and interrupt support for several
+baseboard devices, including one
+.Nm asc
+SCSI device with a scatter/gather DMA channel, an mc146818-compatible
+.Nm mcclock ,
+an Am7930 audio device
+.Nm bba ,
+two
+.Nm zs
+dual-port serial devices, and a AMD 7990 LANCE
+.Nm le
+Ethernet interface.
 .Pp
-Input and output for each line may set to one of following baud rates;
-50, 75, 110, 134.5, 150, 300, 600, 1200, 1800, 2400, 4800, 9600,
-19200, 38400, or 57600.
-Speeds up to 230400 are supported by the chip and the motherboard,
-but speeds higher than 57600 do not work reliably without an external
-clock signal.
-.Sh FILES
-.Bl -tag -width Pa
-.It Pa /dev/ttyB0
-.It Pa /dev/ttyB1
-.El
+The
+.Nm
+is also used for the audio/ISDN hardware on
+audio-equipped TURBOchannel Alphas,
+where the
+.Nm
+hardware provides a scatter-gather DMA channel between the 16-bit
+device and the 32-bit
+.Nm tc
+DMA address space.
 .Pp
-The mapping from units to serial-hardware outlets is idiosyncratic.
+Support for scatter-gather DMA eliminates the need for additional copying.
 .Sh SEE ALSO
+.Xr asc 4 ,
+.Xr bba 4 ,
 .Xr intro 4 ,
-.Xr tty 4
+.Xr le 4 ,
+.Xr mcclock 4 ,
+.Xr tc 4 ,
+.Xr zs 4
 .Sh HISTORY
 The
 .Nm
-driver first appeared in
-.Bx 4.4 .
-.Sh BUGS
-The IOCTL asic provides internal DMA channels that can be programmed
-to transfer up to 4096 bytes of data into, or out, of an SCC without
-further software intervention.
-This feature of the ioctl asic is not yet supported.
-.Pp
-The mapping from device-special files (major and minor number) to chip
-and port is arguably backwards.
+driver
+first appeared in
+.Nx 1.1 ,
+derived from DECstation boot-time configuration code in
+.Bx 4.4  .
diff --git a/share/man/man4/man4.alpha/zs.4 b/share/man/man4/man4.alpha/zs.4
new file mode 100644
index 00000000000..0a20830ff54
--- /dev/null
+++ b/share/man/man4/man4.alpha/zs.4
@@ -0,0 +1,113 @@
+.\"	$OpenBSD: zs.4,v 1.1 2017/11/02 14:04:24 mpi Exp $
+.\"	$NetBSD: zstty.4,v 1.14 2011/06/07 20:22:56 wiz Exp $
+.\"
+.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Gordon W. Ross.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd $Mdocdate: November 2 2017 $
+.Dt ZS 4 alpha
+.Os
+.Sh NAME
+.Nm zs ,
+.\" .Nm zskbd ,
+.\" .Nm zsms ,
+.Nm zstty
+.Nd Zilog 8530 (ZSCC) Serial Communications Controller
+.Sh SYNOPSIS
+.Cd "zs*    at ioasic0"
+.\" .Cd "lskbd* at zs1"
+.\" .Cd "vsms*  at zs0"
+.Cd "zstty* at zs?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides TTY support for the two Zilog 8530 Dual UART chips found on
+DEC 3000 systems.
+On these systems, two of these serial interfaces are hardwired for use by the
+keyboard and mouse.
+Only the second interface of each
+.Nm
+controller can be used as a regular serial port.
+On alpha TURBOchannel systems, the first channel of
+On alpha systems, the first channel o
+.\" The
+.\" .Nm lskbd
+.\" devices connect keyboard devices to the generic keyboard driver
+.\" .Nm wskbd .
+.\" The
+.\" .Nm vsms
+.\" devices connect mice to the generic mouse driver
+.\" .Xr wsmouse 4 .
+.\" The remaining additional
+The
+.Nm zstty
+interfaces provide RS-423
+and RS-232 serial ports for general purpose use.
+.Pp
+The
+.Nm
+driver supports all of the standard
+.Xr tty 4
+ioctl calls.
+The status of the DTR, RTS, CTS, and DCD signals can be queried with
+TIOCMGET command, but, due to limitations in the hardware,
+only the DTR and RTS signals can be modified with TIOCMSET, TIOCMBIC,
+and TIOCMBIS
+.Xr ioctl 2
+commands.
+.Pp
+Input and output for each line may set to any baud rate in the
+range 50 to 38400.
+.Sh FILES
+.Bl -tag -width Pa -compact
+.It Pa /dev/ttyB[01]
+.It Pa /dev/cuaB[01]
+.El
+.Sh DIAGNOSTICS
+.Bl -tag -width indent
+.It zs*: fifo overflow
+.br
+The on-chip
+.Dq FIFO
+has overflowed and incoming data has been lost.
+This generally means the machine is not responding to
+interrupts from the ZS chip fast enough, which can be
+remedied only by using a lower baud rate.
+.It zs*: ring overflow
+.br
+The software input
+.Qq ring
+has overflowed.
+This usually means input flow-control is not configured correctly
+.Pq i.e. incorrect cable wiring .
+.El
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr ioasic 4 ,
+.Xr tty 4
+.\" .Xr wskbd 4 ,
+.\" .Xr wsmouse 4