From 48186844689f2e674ba5d702d920598465a90995 Mon Sep 17 00:00:00 2001 From: Miod Vallat Date: Tue, 15 Oct 2013 18:13:55 +0000 Subject: steal manpages from mvme88k --- share/man/man4/man4.aviion/Makefile | 5 ++- share/man/man4/man4.aviion/dart.4 | 54 +++++++++++++++++++++++++++++++ share/man/man4/man4.aviion/intro.4 | 25 ++++++++++----- share/man/man4/man4.aviion/le.4 | 12 +++---- share/man/man4/man4.aviion/mem.4 | 6 ++-- share/man/man4/man4.aviion/nvram.4 | 52 ++++++++++++++++++++++++++++++ share/man/man4/man4.aviion/oaic.4 | 4 +-- share/man/man4/man4.aviion/syscon.4 | 63 +++++++++++++++++++++++++++++++++++++ share/man/man4/man4.aviion/vme.4 | 57 +++++++++++++++++++++++++++++++++ 9 files changed, 256 insertions(+), 22 deletions(-) create mode 100644 share/man/man4/man4.aviion/dart.4 create mode 100644 share/man/man4/man4.aviion/nvram.4 create mode 100644 share/man/man4/man4.aviion/syscon.4 create mode 100644 share/man/man4/man4.aviion/vme.4 diff --git a/share/man/man4/man4.aviion/Makefile b/share/man/man4/man4.aviion/Makefile index a7a1562b95f..e0387f10b69 100644 --- a/share/man/man4/man4.aviion/Makefile +++ b/share/man/man4/man4.aviion/Makefile @@ -1,7 +1,6 @@ -# $OpenBSD: Makefile,v 1.2 2013/10/15 01:41:44 miod Exp $ +# $OpenBSD: Makefile,v 1.3 2013/10/15 18:13:53 miod Exp $ -# TODO: clock dart nvram syscon vme -MAN= autoconf.4 intro.4 le.4 mem.4 oaic.4 +MAN= autoconf.4 dart.4 intro.4 le.4 mem.4 nvram.4 oaic.4 syscon.4 vme.4 MANSUBDIR=aviion MLINKS+= mem.4 kmem.4 diff --git a/share/man/man4/man4.aviion/dart.4 b/share/man/man4/man4.aviion/dart.4 new file mode 100644 index 00000000000..d8481ceda74 --- /dev/null +++ b/share/man/man4/man4.aviion/dart.4 @@ -0,0 +1,54 @@ +.\" $OpenBSD: dart.4,v 1.1 2013/10/15 18:13:53 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: October 15 2013 $ +.Dt DART 4 aviion +.Os +.Sh NAME +.Nm dart +.Nd MC68681 or MC68692 dual UART +.Sh SYNOPSIS +.Cd "dart0 at syscon0 offset 0x82000" +.Cd "dart1 at syscon0 offset 0x82c00" +.Sh DESCRIPTION +The MC68681 and MC68692 dual asynchronous receiver/transmitter +.Pq Tn DUART +component provides two serial ports, as well as a 16-bit programmable +counter/timer. +.Pp +The +.Nm +driver provides support for the two serial ports found onboard all +AViiON systems. +.Pp +The +.Nm +serial ports have a two character buffer on the transmit path, and a four +character buffer on the receive path. +.Pp +The following link speeds are supported by the +.Nm +driver: +50, 75, 110, 134.5, 150, 200, 300, 600, 1050, 1200, 1800, 200, 2400, 4800, +7200, 9600, 19200 and 38400 bps. +.Sh FILES +.Bl -tag -width Pa -compact +.It Pa /dev/tty[ab] dart0 serial ports +.It Pa /dev/tty[cd] dart1 serial ports +.El +.Sh SEE ALSO +.Xr intro 4 , +.Xr tty 4 diff --git a/share/man/man4/man4.aviion/intro.4 b/share/man/man4/man4.aviion/intro.4 index 97663abc0cd..bd92407e4c1 100644 --- a/share/man/man4/man4.aviion/intro.4 +++ b/share/man/man4/man4.aviion/intro.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: intro.4,v 1.6 2013/06/29 16:57:33 jmc Exp $ +.\" $OpenBSD: intro.4,v 1.7 2013/10/15 18:13:53 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 29 2013 $ +.Dd $Mdocdate: October 15 2013 $ .Dt INTRO 4 aviion .Os .Sh NAME @@ -58,7 +58,7 @@ The networking support is introduced in .Xr netintro 4 . .Sh DEVICE SUPPORT This section describes the hardware supported on the -aviion platform. +AViiON platform. Software support for these devices comes in two forms. A hardware device may be supported with a character or block .Em device driver , @@ -92,12 +92,21 @@ Pseudo-devices are not listed. Devices are indicated by their functional interface. Not all supported devices are listed. .Pp -.Bl -tag -compact -width "pcctwo(4)" -.\" dart +.Bl -tag -compact -width 9n +.It Xr dart 4 +MC68681 or MC68692 dual UART .It Xr le 4 -AMD LANCE Ethernet device -.\" syscon -.\" vme +AMD LANCE or ILACC Ethernet device +.It Xr nvram 4 +Mostek MK48T0x battery-backed realtime clock +.It Xr oaic 4 +Adaptec AIC-6250 SCSI interface +.It Xr oosiop 4 +Symbios/NCR 53C700 SCSI driver +.It Xr syscon 4 +VME system controller +.Ir Xr vme 4 +VMEbus interface .El .Sh SEE ALSO .Xr autoconf 4 , diff --git a/share/man/man4/man4.aviion/le.4 b/share/man/man4/man4.aviion/le.4 index 44100e79bb5..2e4e92dec5f 100644 --- a/share/man/man4/man4.aviion/le.4 +++ b/share/man/man4/man4.aviion/le.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: le.4,v 1.5 2013/09/24 20:14:36 miod Exp $ +.\" $OpenBSD: le.4,v 1.6 2013/10/15 18:13:53 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: September 24 2013 $ +.Dd $Mdocdate: October 15 2013 $ .Dt LE 4 aviion .Os .Sh NAME .Nm le -.Nd AMD LANCE Ethernet device +.Nd AMD LANCE or ILACC Ethernet device .Sh SYNOPSIS .Cd "le0 at syscon? offset 0x8c000 " Pq "on-board, AV4000 family" .Cd "le0 at syscon? offset 0xb0100 " Pq "on-board, AV530 family" @@ -43,8 +43,8 @@ .Sh DESCRIPTION The .Nm -driver provides access to the on-board AMD 7990/LANCE interface, -as well as the VME Interphase 3207 Hawk Ethernet boards. +driver provides access to the on-board AMD 7990/LANCE or AMD 79900/ILACC +interface, as well as the VME Interphase 3207 Hawk Ethernet boards. This in turn provides an interface to the .Tn Ethernet network. @@ -81,6 +81,6 @@ network. .Xr inet 4 , .Xr intro 4 , .Xr netintro 4 , -.\" .Xr vme 4 , +.Xr vme 4 , .Xr hostname.if 5 , .Xr ifconfig 8 diff --git a/share/man/man4/man4.aviion/mem.4 b/share/man/man4/man4.aviion/mem.4 index 673ac5079f4..9d4df8c67d4 100644 --- a/share/man/man4/man4.aviion/mem.4 +++ b/share/man/man4/man4.aviion/mem.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mem.4,v 1.2 2007/05/31 19:19:53 jmc Exp $ +.\" $OpenBSD: mem.4,v 1.3 2013/10/15 18:13:53 miod Exp $ .\" Copyright (c) 1992, 1993 .\" The Regents of the University of California. All rights reserved. .\" @@ -32,7 +32,7 @@ .\" .\" from: @(#)mem.4 8.1 (Berkeley) 6/5/93 .\" -.Dd $Mdocdate: May 31 2007 $ +.Dd $Mdocdate: October 15 2013 $ .Dt MEM 4 aviion .Os .Sh NAME @@ -57,7 +57,7 @@ in the same manner as .Pa /dev/mem . Only kernel virtual addresses that are currently mapped to memory are allowed. .Pp -On the aviion, physical memory is always contiguous; +On the AViiON, physical memory is always contiguous; kernel virtual memory begins at .Ad 0x00000000 . .Pp diff --git a/share/man/man4/man4.aviion/nvram.4 b/share/man/man4/man4.aviion/nvram.4 new file mode 100644 index 00000000000..cb6d959f68f --- /dev/null +++ b/share/man/man4/man4.aviion/nvram.4 @@ -0,0 +1,52 @@ +.\" $OpenBSD: nvram.4,v 1.1 2013/10/15 18:13:53 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: October 15 2013 $ +.Dt NVRAM 4 aviion +.Os +.Sh NAME +.Nm nvram +.Nd Mostek MK48T0x battery-backed realtime clock +.Sh SYNOPSIS +.Cd "nvram0 at syscon0 offset 0x80000" +.Sh DESCRIPTION +The +.Nm +driver provides support for the +Mostek MK48T02 realtime clocks chip. +.Pp +In addition to the clock itself, this chip embed 2KB +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 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 +Most, if not all, of the battery-backed memory is used by DG/UX to store +some of its configuration data, and may be reinitialized by the PROM +if it considers the memory contents as invalid. +The +.Nm +driver does not prevent access to this reserved part. diff --git a/share/man/man4/man4.aviion/oaic.4 b/share/man/man4/man4.aviion/oaic.4 index 363577cd4b2..c8fe2dbebbe 100644 --- a/share/man/man4/man4.aviion/oaic.4 +++ b/share/man/man4/man4.aviion/oaic.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: oaic.4,v 1.1 2013/10/15 01:41:45 miod Exp $ +.\" $OpenBSD: oaic.4,v 1.2 2013/10/15 18:13:53 miod Exp $ .\" OpenBSD: aic.4,v 1.8 2012/08/14 01:08:19 dlg Exp .\" $NetBSD: aic.4,v 1.5 1998/06/07 09:08:45 enami Exp $ .\" @@ -49,5 +49,5 @@ controller chips. .Xr scsi 4 , .Xr sd 4 , .Xr st 4 , -.\" .Xr syscon 4 , +.Xr syscon 4 , .Xr uk 4 diff --git a/share/man/man4/man4.aviion/syscon.4 b/share/man/man4/man4.aviion/syscon.4 new file mode 100644 index 00000000000..b4641f5ebf7 --- /dev/null +++ b/share/man/man4/man4.aviion/syscon.4 @@ -0,0 +1,63 @@ +.\" $OpenBSD: syscon.4,v 1.1 2013/10/15 18:13:53 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: October 15 2013 $ +.Dt SYSCON 4 aviion +.Os +.Sh NAME +.Nm syscon +.Nd VME system controller +.Sh SYNOPSIS +.Cd "syscon0 at mainbus0 addr 0xfff00000" +.Cd "nvram0 at syscon0 offset 0x80000" +.Cd "dart0 at syscon0 offset 0x82000" +.Cd "dart1 at syscon0 offset 0x82c00" +.Cd "vme0 at syscon0 offset 0x85000" +.Cd "oaic0 at syscon0 offset 0x8a000" +.Cd "le0 at syscon0 offset 0x8c000" +.Cd "oosiop0 at syscon0 offset 0xb0000" +.Cd "oosiop1 at syscon0 offset 0xb0080" +.Cd "le0 at syscon0 offset 0xb0100" +.Cd "le1 at syscon0 offset 0xb0140" +.Sh DESCRIPTION +The +.Nm +driver provides an interface to the different local bus-attached I/O +devices found on AViiON systems. +.Pp +The devices which may be connected to +.Nm +are: +.Pp +.Bl -tag -compact -width 9n -offset indent +.It Xr dart 4 +MC68681 or MC68692 dual UART +.It Xr le 4 +AMD LANCE or ILACC Ethernet device +.It Xr nvram 4 +Mostek MK48T0x battery-backed realtime clock +.It Xr oaic 4 +Adaptec AIC-6250 SCSI interface +.It Xr oosiop 4 +Symbios/NCR 53C700 SCSI driver +.It Xr syscon 4 +VME system controller +.Ir Xr vme 4 +VMEbus interface +.El +.Sh SEE ALSO +.Xr intro 4 diff --git a/share/man/man4/man4.aviion/vme.4 b/share/man/man4/man4.aviion/vme.4 new file mode 100644 index 00000000000..a3afb7a1931 --- /dev/null +++ b/share/man/man4/man4.aviion/vme.4 @@ -0,0 +1,57 @@ +.\" $OpenBSD: vme.4,v 1.1 2013/10/15 18:13:54 miod Exp $ +.\" +.\" Copyright (c) 2003 Paul Weissmann +.\" All rights reserved. +.\" +.\" +.\" 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 REGENTS 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 REGENTS 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: October 15 2013 $ +.Dt VME 4 aviion +.Os +.Sh NAME +.Nm vme +.Nd VMEbus interface +.Sh SYNOPSIS +.Cd "vme0 at syscon0 offset 0x85000" +.Sh DESCRIPTION +The +.Nm +driver provides access to the VMEbus, operating the VMEbus part of the +.Xr syscon 4 +device. +.Pp +The currently supported VMEbus drivers are: +.Pp +.Bl -tag -compact -width 10n -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 vsbic 4 +.\" MVME327A SCSI and floppy controller +.\" .It Xr vx 4 +.\" MVME332XT high performance serial I/O controller +.El +.Sh SEE ALSO +.Xr intro 4 , +.Xr syscon 4 -- cgit v1.2.3