share/man/man4/man4.sparc/cgsix.4

   1 .\"     $NetBSD: cgsix.4,v 1.12 2007/01/22 18:11:56 jdc 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
  47 The
  48 .Nm
  49 is a memory based color frame buffer.
  50 It supports the minimal ioctl's needed to run
  51 .Xr X 7 .
  52 .Pp
  53 There are several versions of the
  54 .Nm
  55 board.
  56 The 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"
  60 P4 GX
  61 .It 501-1505
  62 P4 GX with 3/80 backpanel
  63 .It "501-1481, 501-1645"
  64 Sbus double-width GX
  65 .It "501-1672, 501-1996"
  66 Sbus GX
  67 .It "501-1717, 501-2018, 501-2039"
  68 Sbus GX+
  69 .It "501-2325, 501-2922"
  70 Sbus TGX
  71 .It "501-2253, 501-2955"
  72 Sbus TGX+
  73 .El
  74 .Pp
  75 There are also on-board
  76 .Sq GX
  77 cards in the
  78 .Sq SPARCstation IPX
  79 and
  80 .Sq SPARCstation LX
  81 machines.
  82 .Pp
  83 The
  84 .Sq GX
  85 and
  86 .Sq TGX
  87 cards have 1Mb of on-board memory and support a maximum graphics resolution
  88 of 1152x900.
  89 The
  90 .Sq GX+
  91 cards have 4Mb of on-board memory and support a maximum resolution of
  92 1280x1024.
  93 The
  94 .Sq TGX+
  95 cards have 4Mb
  96 of on-board memory and support a maximum resolution of 1600x1280.
  97 The
  98 .Sq TGX
  99 (Turbo GX) cards are faster than the
 100 .Sq GX
 101 cards.
 102 .Pp
 103 The number of supported resolutions varies by card type.
 104 All cards support a resolution of 1152x900 at 66Hz.
 105 All but the P4 and double-width cards support a resolution of 1152x900
 106 at 76Hz.
 107 The cards default to a resolution dependent on the attached monitor
 108 (usually 1152x900).
 109 .Pp
 110 It is only possible to change the resolution of a
 111 .Nm
 112 card from the PROM before the operating system is loaded.
 113 For the primary card, this can be done using the
 114 .Sq output-device
 115 PROM field.
 116 For example, for a
 117 .Sq TGX+
 118 card, the following PROM command will set the resolution to 1280x1024 at
 119 76Hz:
 120 .Bd -literal -offset indent
 121 setenv output-device screen:r1280x1024x76
 122 .Ed
 123 .Pp
 124 For secondary cards, a different method must be used to set the resolution.
 125 For a machine with OpenBoot 2.x or 3.x, and assuming a
 126 .Sq TGX
 127 card at Sbus slot 1, the following PROM commands will set the resolution to
 128 1024x768 at 60Hz:
 129 .Bd -literal -offset indent
 130 nvedit
 131 probe-all
 132 " /iommu/sbus/cgsix@1" select-dev
 133 r1024x768x60
 134 " /iommu/sbus/cgsix@1" " set-resolution" execute-device-method
 135 device-end
 136 install-console
 137 banner
 138 ^C
 139 nvstore
 140 setenv use-nvramrc? true
 141 reset
 142 .Ed
 143 .Pp
 144 For Sun4c machines, the device-path above would be:
 145 .Bd -literal -offset indent
 146 " /sbus/cgsix@1"
 147 .Ed
 148 .Pp
 149 For Sun-4 and Sun-3 systems, it is only possible to change PROM fields by
 150 altering byte values.
 151 For these systems, it is probably easier to use the
 152 .Xr eeprom 8
 153 command to set the
 154 .Va scrsize
 155 field 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
 170 The double-width
 171 .Sq GX
 172 and the
 173 .Sq GX+
 174 cards are not compatible with UltraSPARC machines.
 175 .Pp
 176 On Sun-4 systems using a P4 GX card as console, the
 177 .Va console
 178 field in the PROM must be set to
 179 .Va p4opt ,
 180 otherwise the card will not be recognised as the console output device.
 181 .Pp
 182 Several firmware revisions on
 183 .Nm
 184 boards have a terminal emulation bug that shows up when using the
 185 screen control sequences for inserting blank lines
 186 near the bottom end of the screen
 187 (i.e., the control sequences produced by the
 188 .So al Sc and So AL Sc
 189 capabilities found in the
 190 .Xr termcap 5
 191 database).
 192 The most likely occasion for triggering
 193 this bug is to use a full-screen editor such as
 194 .Xr vi 1
 195 on the workstation's console.
 196 .Pp
 197 To work around this you can set your
 198 .Ev TERM
 199 environment variable to the
 200 .Sq sun-cgsix
 201 terminal definition which is the same as the
 202 .Sq sun
 203 entry, except that the
 204 .Sq al
 205 and
 206 .Sq AL
 207 capabilities have been removed (at the cost of making the scrolling of
 208 the screen slower).