xref: /netbsd/share/man/man4/man4.sparc/cgsix.4 (revision 6550d01e)
1.\"	$NetBSD: cgsix.4,v 1.13 2007/01/23 20:33:38 wiz Exp $
2.\"
3.\" Copyright 1994
4.\"	The Regents of the University of California.  All rights reserved.
5.\"
6.\" This software was developed by the Computer Systems Engineering group
7.\" at Lawrence Berkeley Laboratory under DARPA contract BG 91-66 and
8.\" contributed to Berkeley.
9.\"
10.\" Redistribution and use in source and binary forms, with or without
11.\" modification, are permitted provided that the following conditions
12.\" are met:
13.\" 1. Redistributions of source code must retain the above copyright
14.\"    notice, this list of conditions and the following disclaimer.
15.\" 2. Redistributions in binary form must reproduce the above copyright
16.\"    notice, this list of conditions and the following disclaimer in the
17.\"    documentation and/or other materials provided with the distribution.
18.\" 3. Neither the name of the University nor the names of its contributors
19.\"    may be used to endorse or promote products derived from this software
20.\"    without specific prior written permission.
21.\"
22.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32.\" SUCH DAMAGE.
33.\"
34.\"	from: @(#)cgsix.4	8.1 (Berkeley) 2/16/94
35.\"
36.Dd January 17, 2007
37.Dt CGSIX 4 sparc
38.Os
39.Sh NAME
40.Nm cgsix
41.Nd Sun accelerated 8-bit color frame buffer
42.Sh SYNOPSIS
43.Cd "cgsix* at sbus? slot ? offset ?" Pq sun4c/sun4m
44.Cd "cgsix0 at obio0 addr 0xfb000000 level 4" Pq sun4/300
45.Cd "cgsix0 at obio0 addr 0x0b000000 level 4" Pq sun4/100
46.Sh DESCRIPTION
47The
48.Nm
49is a memory based color frame buffer.
50It supports the minimal ioctl's needed to run
51.Xr X 7 .
52.Pp
53There are several versions of the
54.Nm
55board.
56The Sun part numbers and board types are:
57.Pp
58.Bl -tag -width "501-1717, 501-2018, 501-2039" -compact
59.It "501-1374, 501-1532"
60P4 GX
61.It 501-1505
62P4 GX with 3/80 backpanel
63.It "501-1481, 501-1645"
64Sbus double-width GX
65.It "501-1672, 501-1996"
66Sbus GX
67.It "501-1717, 501-2018, 501-2039"
68Sbus GX+
69.It "501-2325, 501-2922"
70Sbus TGX
71.It "501-2253, 501-2955"
72Sbus TGX+
73.El
74.Pp
75There are also on-board
76.Sq GX
77cards in the
78.Sq SPARCstation IPX
79and
80.Sq SPARCstation LX
81machines.
82.Pp
83The
84.Sq GX
85and
86.Sq TGX
87cards have 1Mb of on-board memory and support a maximum graphics resolution
88of 1152x900.
89The
90.Sq GX+
91cards have 4Mb of on-board memory and support a maximum resolution of
921280x1024.
93The
94.Sq TGX+
95cards have 4Mb
96of on-board memory and support a maximum resolution of 1600x1280.
97The
98.Sq TGX
99(Turbo GX) cards are faster than the
100.Sq GX
101cards.
102.Pp
103The number of supported resolutions varies by card type.
104All cards support a resolution of 1152x900 at 66Hz.
105All but the P4 and double-width cards support a resolution of 1152x900
106at 76Hz.
107The cards default to a resolution dependent on the attached monitor
108(usually 1152x900).
109.Pp
110It is only possible to change the resolution of a
111.Nm
112card from the PROM before the operating system is loaded.
113For the primary card, this can be done using the
114.Sq output-device
115PROM field.
116For example, for a
117.Sq TGX+
118card, the following PROM command will set the resolution to 1280x1024 at
11976Hz:
120.Bd -literal -offset indent
121setenv output-device screen:r1280x1024x76
122.Ed
123.Pp
124For secondary cards, a different method must be used to set the resolution.
125For a machine with OpenBoot 2.x or 3.x, and assuming a
126.Sq TGX
127card at Sbus slot 1, the following PROM commands will set the resolution to
1281024x768 at 60Hz:
129.Bd -literal -offset indent
130nvedit
131probe-all
132" /iommu/sbus/cgsix@1" select-dev
133r1024x768x60
134" /iommu/sbus/cgsix@1" " set-resolution" execute-device-method
135device-end
136install-console
137banner
138^C
139nvstore
140setenv use-nvramrc? true
141reset
142.Ed
143.Pp
144For Sun4c machines, the device-path above would be:
145.Bd -literal -offset indent
146" /sbus/cgsix@1"
147.Ed
148.Pp
149For Sun-4 and Sun-3 systems, it is only possible to change PROM fields by
150altering byte values.
151For these systems, it is probably easier to use the
152.Xr eeprom 8
153command to set the
154.Va scrsize
155field to the desired resolution.
156.Sh EXAMPLES
157.Cd "cgsix0 at obio0 addr 0xfb000000 level 4: cgsix/p4, 1152 x 900, rev 1"
158.Cd "cgsix0 at sbus0 slot 0 offset 0x0 level 9: SUNW,501-2325, 1152 x 900, rev 11"
159.Cd "cgsix0 at sbus0 slot 0 offset 0x0 level 9: SUNW,501-2253, 1280 x 1024, rev 11"
160.Sh SEE ALSO
161.Xr bwtwo 4 ,
162.Xr cgeight 4 ,
163.Xr cgfour 4 ,
164.Xr cgfourteen 4 ,
165.Xr cgthree 4 ,
166.Xr cgtwo 4 ,
167.Xr tcx 4 ,
168.Xr eeprom 8
169.Sh BUGS
170The double-width
171.Sq GX
172and the
173.Sq GX+
174cards are not compatible with UltraSPARC machines.
175.Pp
176On Sun-4 systems using a P4 GX card as console, the
177.Va console
178field in the PROM must be set to
179.Va p4opt ,
180otherwise the card will not be recognised as the console output device.
181.Pp
182Several firmware revisions on
183.Nm
184boards have a terminal emulation bug that shows up when using the
185screen control sequences for inserting blank lines
186near the bottom end of the screen
187(i.e., the control sequences produced by the
188.So al Sc and So AL Sc
189capabilities found in the
190.Xr termcap 5
191database).
192The most likely occasion for triggering
193this bug is to use a full-screen editor such as
194.Xr vi 1
195on the workstation's console.
196.Pp
197To work around this you can set your
198.Ev TERM
199environment variable to the
200.Sq sun-cgsix
201terminal definition which is the same as the
202.Sq sun
203entry, except that the
204.Sq al
205and
206.Sq AL
207capabilities have been removed (at the cost of making the scrolling of
208the screen slower).
209