1.\" $NetBSD: tdvfb.4,v 1.8 2015/02/11 00:11:58 rkujawa Exp $ 2.\" 3.\" Copyright (c) 2012 Radoslaw Kujawa 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 WARRANTIES 17.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 18.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 19.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 20.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 21.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 22.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 23.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 24.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 25.\" SUCH DAMAGE. 26.\" 27.Dd August 3, 2012 28.Dt TDVFB 4 29.Os 30.Sh NAME 31.Nm tdvfb 32.Nd 3Dfx Voodoo Graphics / Voodoo 2 framebuffer driver 33.Sh SYNOPSIS 34.Cd "tdvfb* at pci?" 35.Cd "wsdisplay* at tdvfb?" 36.Cd "options TDVFB_CONSOLE" 37.Sh DESCRIPTION 38The 39.Nm 40driver provides support for the graphics cards based on 3Dfx Voodoo Graphics 41(SST-1) and 3Dfx Voodoo2 (CVG) chipsets and provides an interface for the 42machine independent 43.Xr wscons 4 44driver. 45.Pp 46Since both Voodoo Graphics and Voodoo2 were originally designed as a 3D-only 47solutions, most boards do not have any kind of firmware. 48The 49.Nm 50driver is able to do low level initialization (boot) of the board, which means 51that it can be used on all architectures and is truly machine independent. 52However, it also means that driver cannot detect automatically if the card 53is used as a console. 54The 55.Dv TDVFB_CONSOLE 56option is provided and should be set if the 57.Nm 58driver is intended to be used as a console. 59.Sh SEE ALSO 60.Xr genfb 4 , 61.Xr voodoofb 4 , 62.Xr wsdisplay 4 63.Rs 64.%A 3Dfx Interactive, Inc. 65.%T Voodoo2 Graphics Engine for 3D Game Acceleration 66.%N Revision 1.16 67.%D December 1, 1999 68.Re 69.Sh HISTORY 70The 71.Nm 72device first appeared in 73.Nx 7.0 . 74.Sh AUTHORS 75.An -nosplit 76The 77.Nm 78driver was written by 79.An Radoslaw Kujawa . 803Dfx Glide 2.x source code, Linux driver by 81.An Ghozlane Toumi 82were used as reference. 83The 84.Xr wscons 4 85attachment code is based mostly on the 86.Xr genfb 4 87driver by 88.An Michael Lorenz . 89.Sh BUGS 903Dfx Voodoo2 has a simple 2D graphics engine. 91The 92.Nm 93driver has minimal support 94for this engine. 95It is activated only when the card is running in a 16-bit mode 96(this is a hardware limitation). 97.Pp 98Video mode is hard-coded to 800x600 at 60Hz. 99Default bit depth for little 100endian machines is 16-bit, for big endian machines it is 32-bit. 101Resolution and 102depth should be selectable at least via kernel configuration file. 103It is not 104possible to detect what resolutions are supported by the monitor, since Voodoo 105Graphics and Voodoo2 have no DDC interface. 106.Pp 1078-bit depth is not supported by the hardware. 10816-bit depth is supported by the hardware and is the preferred depth, however it 109does not work correctly on big endian machines at the moment (this is a driver 110problem). 111