Document video modes, and how to change them (which is tricky on the SS4,

for no good reason).

1 files changed, 116 insertions, 3 deletions

diff --git a/share/man/man4/man4.sparc/tcx.4 b/share/man/man4/man4.sparc/tcx.4
index 46f538607a7..d6785b7d251 100644
--- a/share/man/man4/man4.sparc/tcx.4
+++ b/share/man/man4/man4.sparc/tcx.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: tcx.4,v 1.31 2008/06/26 05:42:07 ray Exp $
+.\"	$OpenBSD: tcx.4,v 1.32 2008/12/24 16:12:01 miod Exp $
 .\"	$NetBSD: tcx.4,v 1.3 1997/10/08 22:00:14 jtc Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
@@ -28,7 +28,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: June 26 2008 $
+.Dd $Mdocdate: December 24 2008 $
 .Dt TCX 4 sparc
 .Os
 .Sh NAME
@@ -42,7 +42,7 @@ The
 .Nm
 is an 8 bit color frame buffer, with graphics acceleration,
 found on-board the SPARCstation 4, and also available in a 24 bit version
-as an AFX board for the SPARCstation 5.
+as an AFX board for the SPARCstation 5, called the S24.
 .Pp
 The
 .Nm
@@ -53,6 +53,119 @@ 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
+.Nm
+frame buffer will by default select its resolution and refresh rate
+according to the monitor sense information obtained from the 13W3
+connector.
+If the
+.Nm
+frame buffer is used as the console display, a different resolution can
+be selected by changing the OpenPROM environment.
+.Pp
+If the
+.Nm
+frame buffer is a secondary display, or a serial console is used, the
+display resolution can not be changed without using an
+.Em nvramrc
+OpenPROM script.
+Refer to the
+.Em Sun Frame Buffer FAQ
+for details.
+.Pp
+The supported video modes depend on the particular frame buffer type.
+.\"
+.Ss TCX (8 bit) video modes
+The 8 bit frame buffer supports the following video modes:
+.Bl -column "Mode identifier" "Resolution" "Refresh Rate"
+.It Li Mode identifier Ta Resolution Ta Refresh Rate (MHz)
+.\" refresh rate not confirmed for the following mode
+.It Li r640x480x21 Ta 640x480 Ta 56Hz
+.It Li r640x480x25 Ta 640x480 Ta 60Hz
+.\"
+.\" refresh rate not confirmed for the following mode
+.It Li r744x1273x105 Ta 744x1273 Ta 76Hz
+.\"
+.It Li r1000x1022x105 Ta 1000x1022 Ta 76Hz
+.\"
+.\" refresh rate not confirmed for the following mode
+.It Li r1024x768x54 Ta 1024x768 Ta 50Hz
+.It Li r1024x768x64 Ta 1024x768 Ta 60Hz
+.It Li r1024x768x70 Ta 1024x768 Ta 66Hz
+.It Li r1024x768x74 Ta 1024x768 Ta 70Hz
+.It Li r1024x768x81 Ta 1024x768 Ta 75Hz
+.It Li r1024x768x84 Ta 1024x768 Ta 77Hz
+.\"
+.It Li r1024x800x81 Ta 1024x800 Ta 74Hz
+.It Li r1024x800x92 Ta 1024x800 Ta 84Hz
+.It Li r1024x800x94 Ta 1024x800 Ta 85Hz
+.\"
+.It Li r1024x1024x92 Ta 1024x1024 Ta 62Hz
+.\"
+.\" refresh rate not confirmed for the following mode
+.It Li r1152x900x54 Ta 1152x900 Ta 38Hz
+.It Li r1152x900x92 Ta 1152x900 Ta 66Hz
+.It Li r1152x900x94 Ta 1152x900 Ta 67Hz
+.It Li r1152x900x105 Ta 1152x900 Ta 76Hz
+.It Li r1152x900x108 Ta 1152x900 Ta 77Hz
+.El
+.Pp
+With the addition of a 1MB VSIMM, the following higher resolution models
+become available:
+.Bl -column "Mode identifier" "Resolution" "Refresh Rate"
+.It Li Mode identifier Ta Resolution Ta Refresh Rate (MHz)
+.It Li r1280x1024x117 Ta 1280x1024 Ta 66Hz
+.It Li r1280x1024x118 Ta 1280x1024 Ta 67Hz
+.It Li r1280x1024x135 Ta 1280x1024 Ta 76Hz
+.\"
+.\" refresh rate not confirmed for the following mode
+.It Li r1600x1280x76 Ta 1600x1280 Ta 66Hz
+.\"
+.\" refresh rate not confirmed for the following mode
+.It Li r1920x1080x71 Ta 1920x1080 Ta 72Hz
+.El
+.Pp
+To change the default resolution, type the following:
+.Pp
+.Bl -item -compact
+.It
+.Em \   ok
+setenv
+.Em fcode-debug?
+true
+.It
+.Em \   ok
+setenv
+.Em output-device
+screen:r1024x800x94
+.El
+.Pp
+to change to a 85Hz 1024x800 resolution.
+Note that setting
+.Em fcode-debug?
+is absolutely necessary for the resolution settings to be honoured.
+.\"
+.Ss S24 (24 bit) video modes
+The 24 bit frame buffer only supports the following video modes:
+.Bl -column "Mode identifier" "Resolution" "Refresh Rate"
+.It Li Mode identifier Ta Resolution Ta Refresh Rate (MHz)
+.It Li r1024x768x70 Ta 1024x768 Ta 70Hz
+.It Li r1152x900x66 Ta 1152x900 Ta 66Hz
+.It Li r1152x900x76 Ta 1152x900 Ta 76Hz
+.El
+.Pp
+To change the default resolution, type the following:
+.Pp
+.Em \   ok
+setenv
+.Em output-device
+screen:r1024x768x70
+.Pp
+to change to a 70Hz 1024x768 resolution.
+Unlike the TCX, it is not necessary to alter the value of
+.Em fcode-debug?
+for the resolution settings to be honoured.
 .Sh SEE ALSO
 .Xr intro 4 ,
 .Xr sbus 4 ,