Some more text noone but jmc@ will ever read

7 files changed, 127 insertions, 14 deletions

diff --git a/share/man/man4/man4.mvme88k/Makefile b/share/man/man4/man4.mvme88k/Makefile
index 178aa7d7d41..c7134a1c90d 100644
--- a/share/man/man4/man4.mvme88k/Makefile
+++ b/share/man/man4/man4.mvme88k/Makefile
@@ -1,8 +1,7 @@
-#	$OpenBSD: Makefile,v 1.10 2013/05/18 17:20:45 miod Exp $
+#	$OpenBSD: Makefile,v 1.11 2013/05/23 21:20:48 miod Exp $
 
-# TODO: nvram vx
-MAN=	angelfire.4 autoconf.4 bussw.4 cl.4 dart.4 ie.4 intro.4 le.4 \
-	mem.4 memc.4 pcctwo.4 syscon.4 vme.4 vs.4 vsbic.4
+MAN=	angelfire.4 autoconf.4 bussw.4 cl.4 dart.4 dsrtc.4 ie.4 intro.4 le.4 \
+	mem.4 memc.4 nvram.4 pcctwo.4 syscon.4 vme.4 vs.4 vsbic.4
 MANSUBDIR=mvme88k
 
 MLINKS+= mem.4 kmem.4
diff --git a/share/man/man4/man4.mvme88k/angelfire.4 b/share/man/man4/man4.mvme88k/angelfire.4
index e6af2192577..6255b405bbd 100644
--- a/share/man/man4/man4.mvme88k/angelfire.4
+++ b/share/man/man4/man4.mvme88k/angelfire.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: angelfire.4,v 1.2 2013/05/18 11:26:01 miod Exp $
+.\"	$OpenBSD: angelfire.4,v 1.3 2013/05/23 21:20:48 miod Exp $
 .\"
 .\" Copyright (c) 2013 Miodrag Vallat.
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: May 18 2013 $
+.Dd $Mdocdate: May 23 2013 $
 .Dt ANGELFIRE 4 mvme88k
 .Os
 .Sh NAME
@@ -23,6 +23,7 @@
 .Sh SYNOPSIS
 .Cd "angelfire0 at mainbus0 addr 0xff800000"
 .Cd "dart0      at angelfire0 offset 0x640000 ipl 5"
+.Cd "dsrtc0     at angelfire0 offset 0x10000"
 .Cd "vme0       at angelfire0 offset 0x680000"
 .Sh DESCRIPTION
 The
@@ -37,6 +38,8 @@ are:
 .Bl -tag -compact -width 8n -offset indent
 .It Xr dart 4
 MC68681 or MC68692 dual UART
+.It Xr dsrtc 4
+DS1216 SmartWatch ROM
 .It Xr vme 4
 VMEbus interface
 .El
diff --git a/share/man/man4/man4.mvme88k/dsrtc.4 b/share/man/man4/man4.mvme88k/dsrtc.4
new file mode 100644
index 00000000000..6348a958417
--- /dev/null
+++ b/share/man/man4/man4.mvme88k/dsrtc.4
@@ -0,0 +1,33 @@
+.\"	$OpenBSD: dsrtc.4,v 1.1 2013/05/23 21:20:48 miod Exp $
+.\"
+.\" Copyright (c) 2013 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.
+.\"
+.\" 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: May 23 2013 $
+.Dt DSRTC 4 mvme88k
+.Os
+.Sh NAME
+.Nm dsrtc
+.Nd DS1216 SmartWatch ROM
+.Sh SYNOPSIS
+.Cd "dsrtc0 at angelfire0 offset 0x10000"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the
+.Dq SmartWatch
+battery-backed clock found on MVME180 and MVME181 systems.
+.Sh SEE ALSO
+.Xr angelfire 4 ,
+.Xr intro 4
diff --git a/share/man/man4/man4.mvme88k/intro.4 b/share/man/man4/man4.mvme88k/intro.4
index fcd5c8ed401..77c07430b7a 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.13 2013/05/18 17:20:45 miod Exp $
+.\"	$OpenBSD: intro.4,v 1.14 2013/05/23 21:20:48 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: May 18 2013 $
+.Dd $Mdocdate: May 23 2013 $
 .Dt INTRO 4 mvme88k
 .Os
 .Sh NAME
@@ -105,12 +105,16 @@ BusSwitch local peripheral bus interface
 Cirrus Logic CD2401 serial controller
 .It Xr dart 4
 MC68681 or MC68692 dual UART
+.It Xr dsrtc 4
+DS1216 SmartWatch ROM
 .It Xr ie 4
 Intel i82596 Ethernet device
 .It Xr le 4
 MVME376 AMD LANCE Ethernet device
 .It Xr memc 4
 MVME187 memory controller
+.It Xr nvram 4
+Mostek MK48T0x battery-backed realtime clock
 .It Xr osiop 4
 Symbios/NCR 53C710 SCSI driver
 .It Xr pcctwo 4
diff --git a/share/man/man4/man4.mvme88k/nvram.4 b/share/man/man4/man4.mvme88k/nvram.4
new file mode 100644
index 00000000000..6ed2a83e833
--- /dev/null
+++ b/share/man/man4/man4.mvme88k/nvram.4
@@ -0,0 +1,61 @@
+.\"	$OpenBSD: nvram.4,v 1.1 2013/05/23 21:20:48 miod Exp $
+.\"
+.\" Copyright (c) 2013 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.
+.\"
+.\" 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: May 23 2013 $
+.Dt NVRAM 4 mvme88k
+.Os
+.Sh NAME
+.Nm nvram
+.Nd Mostek MK48T0x battery-backed realtime clock
+.Sh SYNOPSIS
+.Cd "nvram0  at pcctwo0 offset 0xc0000" Pq MVME1x7
+.Cd "nvram0  at syscon0 offset 0x80000" Pq MVME188
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the
+Mostek MK48T02
+.Pq on MVME188
+or MK48T08
+.Pq on MVME1x7
+realtime clocks chips.
+.Pp
+In addition to the clock itself, these chips embed 2KB
+.Pq MK48T02
+or 8KB
+.Pq MK48T08
+of battery-backed memory, which is accessible through the special
+.Pa /dev/nvram0
+file.
+.Sh FILES
+.Bl -tag -width Pa -compact
+.It Pa /dev/nvram0
+.El
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr pcctwo 4 ,
+.Xr syscon 4
+.Sh CAVEATS
+The last 8 bytes of the battery-backed memory contains the realtime clock
+registers.
+Writing to these locations will interfere with proper clock operation.
+.Pp
+The second half of the battery-backed memory (including the clock registers)
+is reserved by Motorola for use by the BUG firmware to store its configuration
+data.
+The
+.Nm
+driver does not prevent access to this reserved part.
diff --git a/share/man/man4/man4.mvme88k/pcctwo.4 b/share/man/man4/man4.mvme88k/pcctwo.4
index 48acb1bcb74..f061758aa5a 100644
--- a/share/man/man4/man4.mvme88k/pcctwo.4
+++ b/share/man/man4/man4.mvme88k/pcctwo.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: pcctwo.4,v 1.9 2013/05/18 17:20:45 miod Exp $
+.\"	$OpenBSD: pcctwo.4,v 1.10 2013/05/23 21:20:48 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 18 2013 $
+.Dd $Mdocdate: May 23 2013 $
 .Dt PCCTWO 4 mvme88k
 .Os
 .Sh NAME
@@ -34,6 +34,14 @@
 .Sh SYNOPSIS
 .Cd "pcctwo0 at mainbus0 addr 0xfff00000        " Pq "MVME187"
 .Cd "pcctwo0 at bussw0 offset 0x00000           " Pq "MVME197"
+.Cd "nvram0  at pcctwo0 offset 0xc0000"
+.Cd "vme0    at pcctwo0 offset 0x40000"
+.Cd "ie0     at pcctwo0 offset 0x46000 ipl 3"
+.Cd "osiop0  at pcctwo0 offset 0x47000 ipl 2"
+.Cd "cl0     at pcctwo0 offset 0x45000 ipl 3"
+.Cd "cl1     at pcctwo0 offset 0x45200 ipl 3    " Pq "M8120 only"
+.Cd "memc0   at pcctwo0 offset 0x43000"
+.Cd "memc1   at pcctwo0 offset 0x43100"
 .Sh DESCRIPTION
 The
 .Nm
@@ -67,6 +75,8 @@ Host interface to
 i82596CA LAN coprocessor
 .It
 Host interface to
+.Xr nvram 4
+Mostek MK48T0x battery-backed realtime clock
 .Xr osiop 4
 Symbios/NCR 53C710 SCSI controller
 .It
@@ -80,4 +90,5 @@ Memory controller ASIC
 .Xr ie 4 ,
 .Xr intro 4 ,
 .Xr memc 4 ,
+.Xr nvram 4 ,
 .Xr osiop 4
diff --git a/share/man/man4/man4.mvme88k/syscon.4 b/share/man/man4/man4.mvme88k/syscon.4
index d5fe1cdedb6..fe023434467 100644
--- a/share/man/man4/man4.mvme88k/syscon.4
+++ b/share/man/man4/man4.mvme88k/syscon.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: syscon.4,v 1.2 2013/05/18 11:26:01 miod Exp $
+.\"	$OpenBSD: syscon.4,v 1.3 2013/05/23 21:20:48 miod Exp $
 .\"
 .\" Copyright (c) 2008 Miodrag Vallat.
 .\"
@@ -15,7 +15,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: May 18 2013 $
+.Dd $Mdocdate: May 23 2013 $
 .Dt SYSCON 4 mvme88k
 .Os
 .Sh NAME
@@ -40,10 +40,12 @@ are:
 .It Xr dart 4
 MC68681 or MC68692 dual UART
 .It Xr nvram 4
-Non-volatile memory
+Mostek MK48T0x battery-backed realtime clock
 .It Xr vme 4
 VMEbus interface
 .El
 .Sh SEE ALSO
+.Xr dart 4 ,
 .Xr intro 4 ,
-.Xr config 8
+.Xr nvram 4 ,
+.Xr vme 4