Source-Changes-HG archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

[src/trunk]: src/share/man/man4/man4.amiga Update p5pb(4) and bppcsc(4) due t...



details:   https://anonhg.NetBSD.org/src/rev/f09cb91a846f
branches:  trunk
changeset: 772657:f09cb91a846f
user:      rkujawa <rkujawa%NetBSD.org@localhost>
date:      Tue Jan 10 20:41:45 2012 +0000

description:
Update p5pb(4) and bppcsc(4) due to recent changes to Phase5 drivers. Add p5membar(4) page.

diffstat:

 share/man/man4/man4.amiga/Makefile   |   4 +-
 share/man/man4/man4.amiga/bppcsc.4   |   4 +-
 share/man/man4/man4.amiga/p5membar.4 |  62 +++++++++++++++++++++++++++++++++
 share/man/man4/man4.amiga/p5pb.4     |  67 ++++++++++++++++++++---------------
 4 files changed, 104 insertions(+), 33 deletions(-)

diffs (210 lines):

diff -r 0d2b7d8faa54 -r f09cb91a846f share/man/man4/man4.amiga/Makefile
--- a/share/man/man4/man4.amiga/Makefile        Tue Jan 10 20:29:49 2012 +0000
+++ b/share/man/man4/man4.amiga/Makefile        Tue Jan 10 20:41:45 2012 +0000
@@ -1,10 +1,10 @@
 #      from: @(#)Makefile      8.2 (Berkeley) 2/16/94
-#      $NetBSD: Makefile,v 1.21 2011/10/27 22:12:24 rkujawa Exp $
+#      $NetBSD: Makefile,v 1.22 2012/01/10 20:41:45 rkujawa Exp $
 
 MAN=   afsc.4 ahsc.4 amidisplaycc.4 atzsc.4 autoconf.4 console.4 bah.4 \
        bppcsc.4 ed.4 efa.4 es.4 fdc.4 grf.4 \
        grfcl.4 grfcv.4 grfcv3d.4 grfet.4 grfrh.4 grfrt.4 grful.4 \
-       gtsc.4 intro.4 ite.4 mem.4 mfcs.4 mgnsc.4 mppb.4 p5pb.4 \
+       gtsc.4 intro.4 ite.4 mem.4 mfcs.4 mgnsc.4 mppb.4 p5membar.4 p5pb.4 \
        qn.4 ser.4 wesc.4 zssc.4
 MLINKS=        mem.4 kmem.4
 MANSUBDIR=/amiga
diff -r 0d2b7d8faa54 -r f09cb91a846f share/man/man4/man4.amiga/bppcsc.4
--- a/share/man/man4/man4.amiga/bppcsc.4        Tue Jan 10 20:29:49 2012 +0000
+++ b/share/man/man4/man4.amiga/bppcsc.4        Tue Jan 10 20:41:45 2012 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: bppcsc.4,v 1.4 2011/01/15 11:59:42 phx Exp $
+.\" $NetBSD: bppcsc.4,v 1.5 2012/01/10 20:41:45 rkujawa Exp $
 .\"
 .\" Copyright (c) 2011 Radoslaw Kujawa
 .\"
@@ -29,7 +29,7 @@
 .Nm bppcsc
 .Nd BlizzardPPC 603e+ SCSI host adapter device driver
 .Sh SYNOPSIS
-.Cd "bppcsc0 at zbus0"
+.Cd "bppcsc0 at p5bus0"
 .Cd "scsibus* at bppcsc?"
 .Sh DESCRIPTION
 The
diff -r 0d2b7d8faa54 -r f09cb91a846f share/man/man4/man4.amiga/p5membar.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/man4.amiga/p5membar.4      Tue Jan 10 20:41:45 2012 +0000
@@ -0,0 +1,62 @@
+.\" $NetBSD: p5membar.4,v 1.1 2012/01/10 20:41:45 rkujawa Exp $
+.\"
+.\" Copyright (c) 2012 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Radoslaw Kujawa.
+.\"
+.\" 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 January 10, 2012
+.Dt P5MEMBAR 4 amiga
+.Os
+.Sh NAME
+.Nm p5membar
+.Nd Phase5 PCI bridge memory space driver
+.Sh SYNOPSIS
+.Cd "p5membar* at zbus0"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for automatically configured Phase5 PCI bridge 
+resources.
+It is needed for proper operation of the
+.Xr p5pb 4
+when G-REX firmware is running on processor board, and Phase5 PCI hardware is
+present in the machine.
+Known firmware versions automatically allocationg these resources include 44.69
+and 44.71.
+.Sh SEE ALSO
+.Xr p5pb 4 ,
+.Xr pci 4
+.Sh HISTORY
+The
+.Nm
+device first appeared in
+.Nx 6.0 .
+.Sh AUTHORS
+.An -nosplit
+The
+.Nm
+driver was written by
+.An Radoslaw Kujawa Aq radoslaw.kujawa%gmail.com@localhost .
diff -r 0d2b7d8faa54 -r f09cb91a846f share/man/man4/man4.amiga/p5pb.4
--- a/share/man/man4/man4.amiga/p5pb.4  Tue Jan 10 20:29:49 2012 +0000
+++ b/share/man/man4/man4.amiga/p5pb.4  Tue Jan 10 20:41:45 2012 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: p5pb.4,v 1.4 2011/10/07 09:22:53 wiz Exp $
+.\" $NetBSD: p5pb.4,v 1.5 2012/01/10 20:41:45 rkujawa Exp $
 .\"
 .\" Copyright (c) 2011 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,38 +27,53 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd July 26, 2011
+.Dd January 10, 2012
 .Dt P5PB 4 amiga
 .Os
 .Sh NAME
 .Nm p5pb
 .Nd Phase5 PCI bridge driver
 .Sh SYNOPSIS
-.Cd "p5pb0 at zbus0"
+.Cd "p5pb0 at p5bus0"
 .Cd "pci* at p5pb?"
 .Cd "genfb* at pci?"
+.Cd "options P5PB_OLD_FIRMWARE"
+.Cd "options P5PB_GENFB"
+.Cd "options P5PB_DEBUG"
 .Sh DESCRIPTION
 The
 .Nm
-driver provides support for the PCI bus present on BlizzardVisionPPC,
-CyberVisionPPC and CybrerVision 64/3D graphics cards.
+driver provides support for the PCI bus present on various devices equipped with
+the Phase5 PCI bridge. 
+.Pp
+Processor boards running firmware revision older than 44.69 need a kernel 
+configured with P5PB_OLD_FIRMWARE option. 
+.Pp
+The
+.Nm 
+driver provides necessary support for CyberVisionPPC and BlizzardVisionPPC, 
+allowing attachment of 
+.Xr genfb 4
+driver. 
+Owners of these cards should enable the P5PB_GENFB option.
+.Pp
+Additional, excessive debugging output is enabled by P5PB_DEBUG option.
 .Sh HARDWARE
 The
 .Nm
 driver supports the following hardware:
-.Bl -tag -width "BLIZZARDVISIONPPC" -offset indent
-.It Em BLIZZARDVISIONPPC
-Phase5 BlizzardVisionPPC graphics card.
-.It Em CYBERVISIONPPC
-Phase5 CyberVisionPPC graphics card.
-.It Em CYBERVISION 64/3D
-Phase5 CyberVision 64/3D graphics card.
+.Bl -tag -offset indent
+.It Phase5 BlizzardVisionPPC graphics card.
+.It Phase5 CyberVisionPPC graphics card.
+.It DCE Computer G-REX 1200 (experimental, first slot only).
+.It DCE Computer G-REX 4000 (experimental, first slot only).
 .El
 .Sh SEE ALSO
 .Xr genfb 4 ,
-.Xr grfcv3d 4 ,
+.\" .Xr pm2fb 4
+.\" .Xr cv3dpb 4 ,
+.Xr p5membar 4 ,
 .Xr pci 4
-.\" .Xr pm2fb 4
 .Sh HISTORY
 The
 .Nm
@@ -71,24 +86,18 @@
 driver was written by
 .An Radoslaw Kujawa Aq radoslaw.kujawa%gmail.com@localhost .
 .Sh CAVEATS
-G-REX PCI bridge is currently not supported, however the driver
-will try to attach to it, because it has the same vendor and product
-ID as CVPPC/BVPPC cards.
-Due to similarities between these products, it may even detect the
-card inserted into first slot, but the driver will (most likely)
-not work properly.
+The
+.Nx developers don't have access to G-REX hardware or documentation.
+Support for this device is based on best wishes. 
 .Pp
-Support for CV64/3D is disabled by default, since the
-.Xr grfcv3d 4
-driver does attach directly to
-.Xr zbus 4 .
-Machine independent PCI driver for S3 ViRGE does not exist yet.
+Support for 
+.Xr genfb 4
+framebuffer on CVPPC/BVPPC needs more testing.
 .Sh BUGS
 Current version of this driver depends on PCI bus setup and enumeration
 done by the firmware.
 .Pp
-The driver will not attach at all, if there is no AutoConfig entry
-for CVPPC/BVPPC card (Zorro product ID 110).
-Some firmware revisions are known not to create this entry.
+DMA to host memory is not supported. This is a driver limitation.
 .Pp
-It is not (yet) possible to use the CVPPC/BVPPC as a console.
+The P5PB_OLD_FIRMWARE option should only be enabled if PCI hardware is 
+present. Otherwise kernel panic might occur due to bus error.



Home | Main Index | Thread Index | Old Index