Documentation updates for zx(4) on sparc64.

7 files changed, 124 insertions, 10 deletions

diff --git a/share/man/man4/man4.sparc64/Makefile b/share/man/man4/man4.sparc64/Makefile
index 4722f9b11f3..0803ecac39f 100644
--- a/share/man/man4/man4.sparc64/Makefile
+++ b/share/man/man4/man4.sparc64/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.32 2003/06/20 03:26:19 jason Exp $
+#	$OpenBSD: Makefile,v 1.33 2004/06/20 18:20:51 miod Exp $
 
 # TODO: clock.4 timer.4
 MAN=	apio.4 asio.4 audioce.4 audiocs.4 autoconf.4 auxio.4 \
@@ -6,7 +6,7 @@ MAN=	apio.4 asio.4 audioce.4 audiocs.4 autoconf.4 auxio.4 \
 	cgsix.4 cgthree.4 comkbd.4 creator.4 \
 	ebus.4 esp.4 intro.4 le.4 magma.4 mem.4 openprom.4 \
 	pcons.4 psycho.4 qe.4 qec.4 sab.4 schizo.4 spif.4 \
-	upa.4 uperf.4 vgafb.4 zs.4
+	upa.4 uperf.4 vgafb.4 zs.4 zx.4
 MLINKS=	le.4 lebuffer.4 le.4 ledma.4 \
 	mem.4 kmem.4 \
 	sab.4 sabtty.4 \
diff --git a/share/man/man4/man4.sparc64/bwtwo.4 b/share/man/man4/man4.sparc64/bwtwo.4
index 8d9b333a3c8..9603e7b94fd 100644
--- a/share/man/man4/man4.sparc64/bwtwo.4
+++ b/share/man/man4/man4.sparc64/bwtwo.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: bwtwo.4,v 1.4 2003/06/02 18:51:34 jason Exp $
+.\"	$OpenBSD: bwtwo.4,v 1.5 2004/06/20 18:20:51 miod Exp $
 .\"
 .\" Copyright (c) 2002 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -55,4 +55,5 @@ interface.
 .Xr sbus 4 ,
 .Xr vgafb 4 ,
 .Xr wscons 4 ,
-.Xr wsdisplay 4
+.Xr wsdisplay 4 ,
+.Xr zx 4
diff --git a/share/man/man4/man4.sparc64/cgsix.4 b/share/man/man4/man4.sparc64/cgsix.4
index d5ba697cfe4..42d3f626660 100644
--- a/share/man/man4/man4.sparc64/cgsix.4
+++ b/share/man/man4/man4.sparc64/cgsix.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cgsix.4,v 1.10 2003/07/09 13:26:20 jmc Exp $
+.\"	$OpenBSD: cgsix.4,v 1.11 2004/06/20 18:20:51 miod Exp $
 .\"
 .\" Copyright (c) 2001 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -150,6 +150,7 @@ on the GX+.
 .Xr vgafb 4 ,
 .Xr wscons 4 ,
 .Xr wsdisplay 4 ,
+.Xr zx 4 ,
 .Xr boot_config 8 ,
 .Xr config 8
 .Rs
diff --git a/share/man/man4/man4.sparc64/cgthree.4 b/share/man/man4/man4.sparc64/cgthree.4
index f894cddfd2a..272b404479d 100644
--- a/share/man/man4/man4.sparc64/cgthree.4
+++ b/share/man/man4/man4.sparc64/cgthree.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cgthree.4,v 1.10 2003/07/09 13:26:20 jmc Exp $
+.\"	$OpenBSD: cgthree.4,v 1.11 2004/06/20 18:20:51 miod Exp $
 .\"
 .\" Copyright (c) 2001 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -97,7 +97,8 @@ Note that not all models support settings other than their default setting.
 .Xr sbus 4 ,
 .Xr vgafb 4 ,
 .Xr wscons 4 ,
-.Xr wsdisplay 4
+.Xr wsdisplay 4 ,
+.Xr zx 4
 .Rs
 .%T Sun Frame Buffer FAQ
 .%O http://www.sunhelp.org/faq/FrameBuffer.html
diff --git a/share/man/man4/man4.sparc64/creator.4 b/share/man/man4/man4.sparc64/creator.4
index 7fa96f7588e..1888f295c4e 100644
--- a/share/man/man4/man4.sparc64/creator.4
+++ b/share/man/man4/man4.sparc64/creator.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: creator.4,v 1.14 2003/06/06 10:29:42 jmc Exp $
+.\"	$OpenBSD: creator.4,v 1.15 2004/06/20 18:20:51 miod Exp $
 .\"
 .\" Copyright (c) 2002 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -69,5 +69,6 @@ this acceleration can be disabled.
 .Xr vgafb 4 ,
 .Xr wscons 4 ,
 .Xr wsdisplay 4 ,
+.Xr zx 4 ,
 .Xr boot_config 8 ,
 .Xr config 8
diff --git a/share/man/man4/man4.sparc64/vgafb.4 b/share/man/man4/man4.sparc64/vgafb.4
index e57e54d612a..ddb6e7f5cb7 100644
--- a/share/man/man4/man4.sparc64/vgafb.4
+++ b/share/man/man4/man4.sparc64/vgafb.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: vgafb.4,v 1.5 2003/06/02 18:51:34 jason Exp $
+.\"	$OpenBSD: vgafb.4,v 1.6 2004/06/20 18:20:51 miod Exp $
 .\"
 .\" Copyright (c) 2002 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -54,4 +54,5 @@ accelerated access methods are provided to
 .Xr intro 4 ,
 .Xr pci 4 ,
 .Xr wscons 4 ,
-.Xr wsdisplay 4
+.Xr wsdisplay 4 ,
+.Xr zx 4
diff --git a/share/man/man4/man4.sparc64/zx.4 b/share/man/man4/man4.sparc64/zx.4
new file mode 100644
index 00000000000..7017c8dea94
--- /dev/null
+++ b/share/man/man4/man4.sparc64/zx.4
@@ -0,0 +1,109 @@
+.\"	$OpenBSD: zx.4,v 1.1 2004/06/20 18:20:51 miod Exp $
+.\" Copyright (c) 2003 Miodrag Vallat.  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 AUTHOR ``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 AUTHOR 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 June 20, 2004
+.Dt ZX 4 sparc64
+.Os
+.Sh NAME
+.Nm zx
+.Nd accelerated 24-bit color frame buffer
+.Sh SYNOPSIS
+.Cd "zx* at sbus? slot ? offset ?"
+.Cd "wsdisplay* at zx?"
+.Sh DESCRIPTION
+The ZX and TurboZX
+are dual-slot SBus color frame buffers, with graphics acceleration
+and overlay capabilities.
+They are also known as the
+.Tn Sun
+.Dq Leo
+graphics card.
+.Pp
+The
+.Nm
+driver interfaces the frame buffer with the
+.Xr wscons 4
+console framework.
+It does not provide direct device driver entry points
+but makes its functions available via the internal
+.Xr wsdisplay 4
+interface.
+.Sh DISPLAY RESOLUTION
+The following resolutions are supported by the ZX frame buffer:
+.Bl -column "Resolution" "Refresh Rate"
+.It Li Resolution Ta "Refresh Rate"
+.It " "
+.It Li 1280x1024 Ta 76 Hz Ta Non-interlaced
+.It Li 1280x1024 Ta 67 Hz Ta Non-interlaced
+.It Li 1152x900 Ta 76 Hz Ta Non-interlaced
+.It Li 1152x900 Ta 66 Hz Ta Non-interlaced
+.It Li 1024x768 Ta 76 Hz Ta Non-interlaced
+.It Li 1024x768 Ta 60 Hz Ta Non-interlaced
+.\" Is it worth documenting the Stereo and TV modes?
+.It Li 960x680 Ta 112 Hz Ta "Stereo, non-interlaced"
+.It Li "" Ta "" Ta "56 Hz field rate per eye"
+.It Li 960x680 Ta 108 Hz Ta "Stereo, non-interlaced"
+.It Li "" Ta "" Ta "54 Hz field rate per eye"
+.It Li 770x575 Ta 50 Hz Ta "Interlaced - PAL"
+.It Li 640x480 Ta 59.94 Hz Ta "Interlaced - NTSC"
+.El
+.Pp
+If the ZX frame buffer is connected to a monitor at boot time, it will
+select its display resolution depending of the monitor
+.Sq select code
+provided by the 13W3 connector.
+If the frame buffer is not connected to a monitor, the default resolution
+of 1152x900, with a 66 Hz refresh rate, will be selected.
+The selected resolutions are:
+.Bl -column "sense code" "Resolution" "Refresh" "Monitor"
+.It Li Monitor Ta Resolution Ta Refresh Ta Monitor
+.It Li "sense code" Ta "" Ta Rate Ta Type
+.It " "
+.It Li 0 Ta 1024x768  Ta "76 Hz" Ta X449A
+.It Li 1 Ta 1152x900  Ta "66 Hz"
+.It Li 2 Ta 1280x1024 Ta "76 Hz" Ta X248A, GDM-205S
+.It Li 3 Ta 1152x900  Ta "66 Hz" Ta GDM-1955A15, GDM-1604A15, CPD-1790
+.It Li 4 Ta 1280x1024 Ta "67 Hz" Ta GDM-20D10, GDM-1962
+.It Li 5 Ta 1152x900  Ta "66 Hz"
+.It Li 6 Ta 1152x900  Ta "76 Hz" Ta GDM-1662B, 17SMM4
+.It Li 7 Ta 1152x900  Ta "66 Hz"
+.El
+.Sh SEE ALSO
+.Xr bwtwo 4 ,
+.Xr cgsix 4 ,
+.Xr cgthree 4 ,
+.Xr creator 4 ,
+.Xr intro 4 ,
+.Xr sbus 4 ,
+.Xr vgafb 4 ,
+.Xr wscons 4 ,
+.Xr wsdisplay 4 ,
+.Xr boot_config 8 ,
+.Xr config 8
+.Sh CAVEATS
+.\" The ZX and TurboZX cards will not function
+.\" in an SBus expansion box, due to PROM limitations.
+.\" .Pp
+There is currently no software interface to change the frame buffer
+resolution at runtime.