/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
 39The
 40.Tn ATI Mach64
 41family of chips are color frame buffers with graphics acceleration.
 42The
 43.Nm
 44driver interfaces those frame buffers with the
 45.Xr syscons 4
 46console driver.
 47.Pp
 48.Tn ATI Mach64
 49chips are very common as low-end graphics chips in
 50.Tn PCI
 51based
 52.Tn UltraSPARC
 53systems.
 54They are found on-board in
 55.Tn Sun Blade 100 ,
 56.Tn Sun Blade 150 ,
 57.Tn Sun Ultra 5
 58and
 59.Tn Sun Ultra 10
 60as well as on
 61.Tn Sun
 62OEM mainboards like the
 63.Tn Sun AXe .
 64They are also used on add-on cards like the
 65.Tn Sun PGX
 66and
 67.Tn Sun PGX64 .
 68.Pp
 69The
 70.Nm
 71driver requires the chip which it is supposed to drive to be also
 72supported by the
 73.Tn Open Firmware ,
 74either by a built-in FCode driver package of the on-board firmware
 75or by additional FCode on the add-on card.
 76As a matter of course
 77.Tn UltraSPARC
 78systems with an on-board
 79.Tn ATI Mach64 chip
 80also have a built-in FCode driver package for this chip.
 81There are also mainboards like the
 82.Tn Sun AX1105
 83and
 84.Tn Sun AXi
 85boards however,
 86which have built-in FCode for certain
 87.Tn ATI Mach64
 88chips although they are not equipped with an on-board one.
 89Mainboards with built-in FCode for certain
 90.Tn ATI Mach64
 91chips can be used with any add-on card which is based on one of those
 92chips,
 93including cards which are equipped with x86 firmware and intended for
 94use in PCs.
 95Otherwise an add-on card which comes with its own FCode like the
 96.Tn Sun PGX
 97or
 98.Tn Sun PGX64
 99has to be used.
100.Sh HARDWARE
101The
102.Nm
103driver 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
142The
143following add-on cards are known to work with the
144.Nm
145driver 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
161The
162.Nm
163driver first appeared in
164.Nx 2.0 .
165The first
166.Fx
167version to include it was
168.Fx 6.0 .
169.Sh AUTHORS
170.An -nosplit
171The
172.Nm
173driver was written by
174.An "Marius Strobl" Aq marius@FreeBSD.org
175based on the
176.Nx
177driver written by
178.An "Bang Jun-Young" .
179.Sh CAVEATS
180Font loading and mode switching are not implemented.