Copyright 1994
The Regents of the University of California. All rights reserved.
This software was developed by the Computer Systems Engineering group
at Lawrence Berkeley Laboratory under DARPA contract BG 91-66 and
contributed to Berkeley.
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.
3. Neither the name of the University nor the names of its contributors
may be used to endorse or promote products derived from this software
without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``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 REGENTS OR CONTRIBUTORS 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.
from: @(#)cgsix.4 8.1 (Berkeley) 2/16/94
.Dd February 17, 2017 .Dt CGSIX 4 sparc .Os .Sh NAME .Nm cgsix .Nd Sun accelerated 8-bit color frame buffer .Sh SYNOPSIS .Cd "cgsix* at sbus? slot ? offset ?" Pq sun4c/sun4m .Cd "cgsix0 at obio0 addr 0xfb000000 level 4" Pq sun4/300 .Cd "cgsix0 at obio0 addr 0x0b000000 level 4" Pq sun4/100 .Sh DESCRIPTION The .Nm is a memory based color frame buffer. It supports the minimal ioctl's needed to run .Xr X 7 .
p There are several versions of the .Nm board. The Sun part numbers and board types are:
p l -tag -width "501-1717, 501-2018, 501-2039" -compact t "501-1374, 501-1532" P4 GX t 501-1505 P4 GX with 3/80 backpanel t "501-1481, 501-1645" Sbus double-width GX t "501-1672, 501-1996" Sbus GX t "501-1717, 501-2018, 501-2039" Sbus GX+ t "501-2325, 501-2922" Sbus TGX t "501-2253, 501-2955" Sbus TGX+ .El
p There are also on-board .Sq GX cards in the .Sq SPARCstation IPX and .Sq SPARCstation LX machines.
p The .Sq GX and .Sq TGX cards have 1Mb of on-board memory and support a maximum graphics resolution of 1152x900. The .Sq GX+ cards have 4Mb of on-board memory and support a maximum resolution of 1280x1024. The .Sq TGX+ cards have 4Mb of on-board memory and support a maximum resolution of 1600x1280. The .Sq TGX (Turbo GX) cards are faster than the .Sq GX cards.
p The number of supported resolutions varies by card type. All cards support a resolution of 1152x900 at 66Hz. All but the P4 and double-width cards support a resolution of 1152x900 at 76Hz. The cards default to a resolution dependent on the attached monitor (usually 1152x900).
p It is only possible to change the resolution of a .Nm card from the PROM before the operating system is loaded. For the primary card, this can be done using the .Sq output-device PROM field. For example, for a .Sq TGX+ card, the following PROM command will set the resolution to 1280x1024 at 76Hz: d -literal -offset indent setenv output-device screen:r1280x1024x76 .Ed
p For secondary cards, a different method must be used to set the resolution. For a machine with OpenBoot 2.x or 3.x, and assuming a .Sq TGX card at Sbus slot 1, the following PROM commands will set the resolution to 1024x768 at 60Hz: d -literal -offset indent nvedit probe-all " /iommu/sbus/cgsix@1" select-dev r1024x768x60 " /iommu/sbus/cgsix@1" " set-resolution" execute-device-method device-end install-console banner ^C nvstore setenv use-nvramrc? true reset .Ed
p For Sun4c machines, the device-path above would be: d -literal -offset indent " /sbus/cgsix@1" .Ed
p For Sun-4 and Sun-3 systems, it is only possible to change PROM fields by altering byte values. For these systems, it is probably easier to use the .Xr eeprom 8 command to set the .Va scrsize field to the desired resolution. .Sh EXAMPLES .Cd "cgsix0 at obio0 addr 0xfb000000 level 4: cgsix/p4, 1152 x 900, rev 1" .Cd "cgsix0 at sbus0 slot 0 offset 0x0 level 9: SUNW,501-2325, 1152 x 900, rev 11" .Cd "cgsix0 at sbus0 slot 0 offset 0x0 level 9: SUNW,501-2253, 1280 x 1024, rev 11" .Sh SEE ALSO .Xr sparc/bwtwo 4 , .Xr sparc/cgeight 4 , .Xr sparc/cgfour 4 , .Xr sparc/cgfourteen 4 , .Xr sparc/cgthree 4 , .Xr sparc/cgtwo 4 , .Xr sparc/tcx 4 , .Xr eeprom 8 .Sh BUGS The double-width .Sq GX and the .Sq GX+ cards are not compatible with UltraSPARC machines.
p On Sun-4 systems using a P4 GX card as console, the .Va console field in the PROM must be set to .Va p4opt , otherwise the card will not be recognised as the console output device.
p Several firmware revisions on .Nm boards have a terminal emulation bug that shows up when using the screen control sequences for inserting blank lines near the bottom end of the screen (i.e., the control sequences produced by the termcap .So al Sc and So AL Sc capabilities found in the .Xr terminfo 5 database). The most likely occasion for triggering this bug is to use a full-screen editor such as .Xr vi 1 on the workstation's console.
p To work around this you can set your .Ev TERM environment variable to the .Sq sun-cgsix terminal definition which is the same as the .Sq sun entry, except that the .Sq al and .Sq AL capabilities have been removed (at the cost of making the scrolling of the screen slower).
Indexes created Sat Sep 20 22:09:52 GMT 2025