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