Add some information about syscon(4), eyeballed by jmc@

6 files changed, 106 insertions, 65 deletions

diff --git a/share/man/man4/man4.mvme88k/Makefile b/share/man/man4/man4.mvme88k/Makefile
index d2ead1be1bb..373e7118a95 100644
--- a/share/man/man4/man4.mvme88k/Makefile
+++ b/share/man/man4/man4.mvme88k/Makefile
@@ -1,7 +1,8 @@
-#	$OpenBSD: Makefile,v 1.5 2004/05/07 18:14:57 miod Exp $
+#	$OpenBSD: Makefile,v 1.6 2008/01/05 12:47:56 miod Exp $
 
-# TODO: cl clock dart memc nvram sclock syscon vx
-MAN=	autoconf.4 bussw.4 ie.4 intro.4 le.4 mem.4 pcctwo.4 vme.4 vs.4
+# TODO: cl dart memc nvram syscon vx
+MAN=	autoconf.4 bussw.4 ie.4 intro.4 le.4 mem.4 \
+	pcctwo.4 syscon.4 vme.4 vs.4
 MANSUBDIR=mvme88k
 
 MLINKS+= mem.4 kmem.4
diff --git a/share/man/man4/man4.mvme88k/bussw.4 b/share/man/man4/man4.mvme88k/bussw.4
index 2b7244ca72d..9c15ffb10f8 100644
--- a/share/man/man4/man4.mvme88k/bussw.4
+++ b/share/man/man4/man4.mvme88k/bussw.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: bussw.4,v 1.4 2007/05/31 19:19:55 jmc Exp $
+.\"	$OpenBSD: bussw.4,v 1.5 2008/01/05 12:47:56 miod Exp $
 .\"
 .\" Copyright (c) 2003 Paul Weissmann
 .\" All rights reserved.
@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: January 5 2008 $
 .Dt BUSSW 4 mvme88k
 .Os
 .Sh NAME
@@ -63,5 +63,5 @@ Four 32-bit general purpose registers
 .El
 .Sh SEE ALSO
 .Xr intro 4 ,
-.Xr pcctwo 4
-.\" .Xr syscon 4
+.Xr pcctwo 4 ,
+.Xr syscon 4
diff --git a/share/man/man4/man4.mvme88k/intro.4 b/share/man/man4/man4.mvme88k/intro.4
index e17e1a184d2..57ffc4d6537 100644
--- a/share/man/man4/man4.mvme88k/intro.4
+++ b/share/man/man4/man4.mvme88k/intro.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: intro.4,v 1.8 2007/06/21 10:18:27 jmc Exp $
+.\"	$OpenBSD: intro.4,v 1.9 2008/01/05 12:47:56 miod Exp $
 .\" Copyright (c) 1990, 1991 Regents of the University of California.
 .\" All rights reserved.
 .\"
@@ -28,7 +28,7 @@
 .\"
 .\"     from: @(#)intro.4	5.2 (Berkeley) 3/27/91
 .\"
-.Dd $Mdocdate: June 21 2007 $
+.Dd $Mdocdate: January 5 2008 $
 .Dt INTRO 4 mvme88k
 .Os
 .Sh NAME
@@ -99,26 +99,26 @@ Not all supported devices are listed.
 .Bl -tag -compact -width "pcctwo(4)" -offset 3n
 .It Xr bussw 4
 BusSwitch local peripheral bus interface
-.\" .It Xr cl 4
-.\" Cirrus Logic CL2400 serial controller.
+.It Xr cl 4
+Cirrus Logic CL2400 serial controller
 .It Xr ie 4
 Intel i82596 Ethernet device
 .It Xr le 4
-AMD LANCE Ethernet device
-.\" .It Xr memc 4
-.\" memory controller.
+MVME376 AMD LANCE Ethernet device
+.It Xr memc 4
+MVME1x7 memory controller
 .It Xr osiop 4
 Symbios/NCR 53C710 SCSI driver
 .It Xr pcctwo 4
 PCCchip2 local bus controller
-.\" .It Xr syscon 4
-.\" MVME188 system controller.
+.It Xr syscon 4
+MVME188 system controller
 .It Xr vme 4
-VMEchip2 VMEbus interface chip
+VMEbus interface
 .It Xr vs 4
-MVME328S High Performance SCSI Controller
+MVME328, MVME328S and MVME328XT high performance SCSI controller
 .\" .It Xr vx 4
-.\" MVME332XT High Performance Serial I/O Controller.
+.\" MVME332XT high performance serial I/O controller
 .El
 .Sh SEE ALSO
 .Xr autoconf 4 ,
diff --git a/share/man/man4/man4.mvme88k/le.4 b/share/man/man4/man4.mvme88k/le.4
index 721ee7c865f..5b07825924a 100644
--- a/share/man/man4/man4.mvme88k/le.4
+++ b/share/man/man4/man4.mvme88k/le.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: le.4,v 1.7 2007/05/31 19:19:55 jmc Exp $
+.\"	$OpenBSD: le.4,v 1.8 2008/01/05 12:47:56 miod Exp $
 .\"
 .\" Copyright (c) 2003 Paul Weissmann
 .\" All rights reserved.
@@ -25,12 +25,12 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: January 5 2008 $
 .Dt LE 4 mvme88k
 .Os
 .Sh NAME
 .Nm le
-.Nd AMD LANCE Ethernet device
+.Nd MVME376 AMD LANCE Ethernet device
 .Sh SYNOPSIS
 .Cd "le0 at vmes0 addr 0xffff1200 ipl 1"
 .Cd "le1 at vmes0 addr 0xffff1400 ipl 1"
@@ -41,7 +41,10 @@
 .Sh DESCRIPTION
 The
 .Nm
-driver provides access to the AMD 7990/LANCE-based MVME376 VME board.
+driver provides access to the AMD 7990/LANCE-based Interphase 4207
+.Sq Hawk ,
+also sold as Motorola MVME376,
+VME boards.
 This in turn provides an interface to the
 .Tn Ethernet
 network.
@@ -62,7 +65,7 @@ VME connectors, and
 closer to the AM7990DC chip at the bottom edge.
 .Pp
 The only supported configurations are:
-.Bl -column "xxxxxxxx" "xxxxxxxx" "xxxxxxxx" "0xffffffff"
+.Bl -column "xxxxxxxx" "xxxxxxxx" "xxxxxxxx" "0xffffffff" -offset indent
 .It Li SW1 Ta SW2 Ta SW3 Ta Address
 .It " "
 .It Li "UUU_UU_U" Ta "U__U____" Ta "______U_" Ta "0xffff1200"
diff --git a/share/man/man4/man4.mvme88k/syscon.4 b/share/man/man4/man4.mvme88k/syscon.4
new file mode 100644
index 00000000000..d355ccd5608
--- /dev/null
+++ b/share/man/man4/man4.mvme88k/syscon.4
@@ -0,0 +1,52 @@
+.\"	$OpenBSD: syscon.4,v 1.1 2008/01/05 12:47:56 miod Exp $
+.\"
+.\" Copyright (c) 2008 Miodrag Vallat.
+.\"
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies. And
+.\" I won't mind if you keep the disclaimer below.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.\"
+.Dd $Mdocdate: January 5 2008 $
+.Dt SYSCON 4 mvme88k
+.Os
+.Sh NAME
+.Nm syscon
+.Nd MVME188 system controller
+.Sh SYNOPSIS
+.Cd "syscon0 at mainbus0 addr 0xfff00000"
+.Cd "nvram0  at syscon0 offset 0x80000"
+.Cd "dart0   at syscon0 offset 0x82000"
+.Cd "vme0    at syscon0 offset 0x85000"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides an interface to the different local bus-attached I/O
+devices found on MVME188 systems.
+It also provides internal interfaces to help handling interrupts produced by
+the on-board devices
+.Pq as opposed to the VME devices .
+.Pp
+The devices connected to
+.Nm
+are:
+.Pp
+.Bl -tag -compact -width 8n -offset indent
+.It Xr dart 4
+MC68681 dual UART
+.It Xr nvram 4
+Non-volatile memory
+.It Xr vme 4
+VMEbus interface
+.El
+.Sh SEE ALSO
+.Xr autoconf 4 ,
+.Xr config 8
diff --git a/share/man/man4/man4.mvme88k/vme.4 b/share/man/man4/man4.mvme88k/vme.4
index e195ea884df..0cf57608ed8 100644
--- a/share/man/man4/man4.mvme88k/vme.4
+++ b/share/man/man4/man4.mvme88k/vme.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: vme.4,v 1.4 2007/05/31 19:19:55 jmc Exp $
+.\"	$OpenBSD: vme.4,v 1.5 2008/01/05 12:47:56 miod Exp $
 .\"
 .\" Copyright (c) 2003 Paul Weissmann
 .\" All rights reserved.
@@ -25,12 +25,12 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: January 5 2008 $
 .Dt VME 4 mvme88k
 .Os
 .Sh NAME
 .Nm vme
-.Nd VMEchip2 VMEbus interface chip
+.Nd VMEbus interface
 .Sh SYNOPSIS
 .Cd "vme0   at pcctwo0 offset 0x40000"
 .Cd "vme0   at syscon0 offset 0x85000"
@@ -39,48 +39,33 @@
 .Sh DESCRIPTION
 The
 .Nm
-driver provides access to the VMEchip2 ASIC which interfaces from the
-MC68040-compatible local bus to the
-.Tn VMEbus .
-On
-.Tn MVME187
-and
-.Tn MVME197
-boards it is attached to the
+driver provides access to the VMEbus.
+On MVME187 and MVME197 boards, it operates the VMEchip2 ASIC connected to the
 .Xr pcctwo 4
-.Tn PCCchip2
-local bus controller.
-On
-.Tn MVME188
-boards it attaches to the
+PCCchip2 local bus controller.
+On MVME188 boards, it operates the VMEbus part of the
 .Xr syscon 4
-bus controller.
+device.
 .Pp
-Features Summary:
+The
+.Nm
+driver exposes the D16 and D32 access spaces through the
+.Nm vmes
+and
+.Nm vmel
+drivers, respectively.
 .Pp
-.Bl -bullet -compact
-.It
-Local Bus to VMEbus interface
-.It
-VMEbus to Local Bus interface
-.It
-32-bit Local Bus to VMEbus DMA controller
-.It
-VMEbus interrupter
-.It
-VMEbus system controller
-.It
-Global control status register set
-.It
-Interrupt handler
-.It
-Watchdog timer
-.It
-Two 32-bit tick timers
-.It
-Support for RESET and ABORT switches
+The currently VMEbus drivers supported are:
+.Pp
+.Bl -tag -compact -width 6n -offset indent
+.It Xr le 4
+MVME376 AMD LANCE Ethernet device
+.It Xr vs 4
+MVME328, MVME328S and MVME328XT high performance SCSI controller
+.\" .It Xr vx 4
+.\" MVME332XT high performance serial I/O controller
 .El
 .Sh SEE ALSO
 .Xr intro 4 ,
-.Xr pcctwo 4
-.\" .Xr syscon 4
+.Xr pcctwo 4 ,
+.Xr syscon 4