1.\" $OpenBSD: cgsix.4,v 1.22 2015/11/01 21:26:48 jmc Exp $ 2.\" 3.\" Copyright (c) 2001 Jason L. Wright (jason@thought.net) 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 16.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 17.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 18.\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, 19.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 20.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 21.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 22.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 23.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN 24.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 25.\" POSSIBILITY OF SUCH DAMAGE. 26.\" 27.Dd $Mdocdate: November 1 2015 $ 28.Dt CGSIX 4 sparc64 29.Os 30.Sh NAME 31.Nm cgsix 32.Nd accelerated 8-bit color frame buffer 33.Sh SYNOPSIS 34.Cd "cgsix* at sbus? flags 0x0" 35.Cd "wsdisplay* at cgsix?" 36.Sh DESCRIPTION 37The 38.Nm 39is an SBus color frame buffer with graphics acceleration, 40commonly found in the non 41.Sq creator 42SBus UltraSPARC workstations. 43.Pp 44The 45.Nm 46driver interfaces the frame buffer with the 47.Xr wscons 4 48console framework. 49It does not provide direct device driver entry points 50but makes its functions available via the internal 51.Xr wsdisplay 4 52interface. 53.Pp 54Different models exist, with various memory sizes and capabilities. 55The 56.Nm 57driver supports the four flavours: 58.Bl -item -offset indent -compact 59.It 60GX 61.It 62GX+ 63.It 64Turbo GX (or TGX) 65.It 66Turbo GX+ (or TGX+) 67.El 68.Pp 69By default hardware acceleration is used to erase the screen and 70scroll text. 71By setting 72.Ar flags 73to 74.Ar 1 75(via 76.Xr config 8 77or 78.Xr boot_config 8 ) 79this acceleration can be disabled. 80.Sh DISPLAY RESOLUTION 81If the 82.Nm 83frame buffer is used as the console display, a different resolution than the 84default 1152x900 can be selected by changing the OpenPROM environment. 85To change the default resolution, type the following: 86.Pp 87.Em \ ok 88setenv 89.Em output-device 90screen:r1280x1024x76 91.Pp 92to change to a 76Hz 1280x1024 resolution. 93.Pp 94If the 95.Nm 96frame buffer is a secondary display, or a serial console is used, the 97display resolution cannot be changed without using an 98.Em nvramrc 99OpenPROM script. 100Refer to the 101.Em Sun Frame Buffer FAQ 102for details. 103.Pp 104The 105.Nm 106frame buffer accepts the following resolutions: 107.Pp 108.Bl -tag -width screen:r1280x1024x76 -compact 109.It screen:r1024x768x60 110Super VGA 1024x768, with a refresh rate of 60Hz. 111Only available on TGX and TGX+. 112.It screen:r1024x768x70 113Super VGA 1024x768, with a refresh rate of 70Hz. 114Only available on TGX and TGX+. 115.It screen:r1024x768x76 116Super VGA 1024x768, with a refresh rate of 76Hz. 117Only available on TGX and TGX+. 118.It screen:r1024x800x74 1191024x800, with a refresh rate of 74Hz. 120Only available on TGX and TGX+. 121.It screen:r1024x800x85 1221024x800, with a refresh rate of 85Hz. 123Only available on GX+, TGX and TGX+. 124.It screen:r1152x900x66 125Standard 1152x900, with a refresh rate of 66Hz. 126.It screen:r1152x900x76 127Standard 1152x900, with a refresh rate of 76Hz. 128This is the default setting on GX and TGX. 129.It screen:r1280x1024x67 130High res 1280x1024, with a refresh rate of 67Hz. 131Only available on GX+ and TGX+. 132This is the default on GX+. 133.It screen:r1280x1024x76 134High res 1280x1024, with a refresh rate of 76Hz. 135Only available on TGX+, where this is the default setting. 136.It screen:r1600x1280x76 137High res 1600x1280, with a refresh rate of 76Hz. 138Only available on GX+ and TGX+. 139.El 140.Pp 141The 1600x1280 resolution is not officially supported by 142.Tn Sun 143on the GX+. 144.Sh SEE ALSO 145.Xr intro 4 , 146.Xr sbus 4 , 147.Xr wscons 4 , 148.Xr wsdisplay 4 , 149.Xr boot_config 8 , 150.Xr config 8 151.Rs 152.%T Sun Frame Buffer FAQ 153.%U http://www.sunhelp.org/faq/FrameBuffer.html 154.Re 155