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