share/man/man4/man4.sparc64/machfb.4

   1 .\"-
   2 .\" Copyright (c) 2002 Jason L. Wright (jason@thought.net)
   3 .\" Copyright (c) 2005, 2006 Marius Strobl <marius@FreeBSD.org>
   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 .\"     from: OpenBSD: creator.4,v 1.20 2005/03/05 01:48:59 miod Exp
  28 .\" $FreeBSD$
  29 .\"
  30 .Dd September 2, 2006
  31 .Dt MACHFB 4 sparc64
  32 .Os
  33 .Sh NAME
  34 .Nm machfb
  35 .Nd "accelerated color frame buffer"
  36 .Sh SYNOPSIS
  37 .Cd "device machfb"
  38 .Sh DESCRIPTION
  39 The
  40 .Tn ATI Mach64
  41 family of chips are color frame buffers with graphics acceleration.
  42 The
  43 .Nm
  44 driver interfaces those frame buffers with the
  45 .Xr syscons 4
  46 console driver.
  47 .Pp
  48 .Tn ATI Mach64
  49 chips are very common as low-end graphics chips in
  50 .Tn PCI
  51 based
  52 .Tn UltraSPARC
  53 systems.
  54 They are found on-board in
  55 .Tn Sun Blade 100 ,
  56 .Tn Sun Blade 150 ,
  57 .Tn Sun Ultra 5
  58 and
  59 .Tn Sun Ultra 10
  60 as well as on
  61 .Tn Sun
  62 OEM mainboards like the
  63 .Tn Sun AXe .
  64 They are also used on add-on cards like the
  65 .Tn Sun PGX
  66 and
  67 .Tn Sun PGX64 .
  68 .Pp
  69 The
  70 .Nm
  71 driver requires the chip which it is supposed to drive to be also
  72 supported by the
  73 .Tn Open Firmware ,
  74 either by a built-in FCode driver package of the on-board firmware
  75 or by additional FCode on the add-on card.
  76 As a matter of course
  77 .Tn UltraSPARC
  78 systems with an on-board
  79 .Tn ATI Mach64 chip
  80 also have a built-in FCode driver package for this chip.
  81 There are also mainboards like the
  82 .Tn Sun AX1105
  83 and
  84 .Tn Sun AXi
  85 boards however,
  86 which have built-in FCode for certain
  87 .Tn ATI Mach64
  88 chips although they are not equipped with an on-board one.
  89 Mainboards with built-in FCode for certain
  90 .Tn ATI Mach64
  91 chips can be used with any add-on card which is based on one of those
  92 chips,
  93 including cards which are equipped with x86 firmware and intended for
  94 use in PCs.
  95 Otherwise an add-on card which comes with its own FCode like the
  96 .Tn Sun PGX
  97 or
  98 .Tn Sun PGX64
  99 has to be used.
 100 .Sh HARDWARE
 101 The
 102 .Nm
 103 driver provides support for the following chips:
 104 .Pp
 105 .Bl -bullet -compact
 106 .It
 107 .Tn ATI 3D Rage II+
 108 .It
 109 .Tn ATI 3D Rage IIC
 110 .It
 111 .Tn ATI 3D Rage I/II
 112 .It
 113 .Tn ATI 3D Rage LT
 114 .It
 115 .Tn ATI 3D Rage LT Pro
 116 .It
 117 .Tn ATI 3D Rage Pro
 118 .It
 119 .Tn ATI 3D Rage Pro Turbo
 120 .It
 121 .Tn ATI Mach64 CT
 122 .It
 123 .Tn ATI Mach64 VT
 124 .It
 125 .Tn ATI Mach64 VT4
 126 .It
 127 .Tn ATI Mach64 VTB
 128 .It
 129 .Tn ATI Rage L Mobility
 130 .It
 131 .Tn ATI Rage Mobility
 132 .It
 133 .Tn ATI Rage Mobility M1
 134 .It
 135 .Tn ATI Rage Mobility M3
 136 .It
 137 .Tn ATI Rage XC
 138 .It
 139 .Tn ATI Rage XL
 140 .El
 141 .Pp
 142 The
 143 following add-on cards are known to work with the
 144 .Nm
 145 driver at this time:
 146 .Pp
 147 .Bl -bullet -compact
 148 .It
 149 .Tn ATI 3D Charger PCI
 150 .It
 151 .Tn Sun PGX 8-Bit Color Frame Buffer
 152 (part no.\& 370-2256)
 153 .It
 154 .Tn Sun PGX64 8/24-Bit Color Frame Buffer
 155 (part no.\& 370-4362)
 156 .El
 157 .Sh SEE ALSO
 158 .Xr creator 4 ,
 159 .Xr syscons 4
 160 .Sh HISTORY
 161 The
 162 .Nm
 163 driver first appeared in
 164 .Nx 2.0 .
 165 The first
 166 .Fx
 167 version to include it was
 168 .Fx 6.0 .
 169 .Sh AUTHORS
 170 .An -nosplit
 171 The
 172 .Nm
 173 driver was written by
 174 .An "Marius Strobl" Aq marius@FreeBSD.org
 175 based on the
 176 .Nx
 177 driver written by
 178 .An "Bang Jun-Young" .
 179 .Sh CAVEATS
 180 Font loading and mode switching are not implemented.