Add man page for recently introduced tdvfb(4).

This commit is contained in:
rkujawa 2012-07-19 08:57:09 +00:00
parent dd347cecb9
commit 49bcd77243
2 changed files with 97 additions and 2 deletions

View File

@ -1,4 +1,4 @@
# $NetBSD: Makefile,v 1.588 2012/07/13 22:58:45 abs Exp $
# $NetBSD: Makefile,v 1.589 2012/07/19 08:57:09 rkujawa Exp $
# @(#)Makefile 8.1 (Berkeley) 6/18/93
MAN= aac.4 ac97.4 acardide.4 aceride.4 acphy.4 \
@ -57,7 +57,7 @@ MAN= aac.4 ac97.4 acardide.4 aceride.4 acphy.4 \
sm.4 smsh.4 sn.4 sony.4 spc.4 speaker.4 spif.4 sqphy.4 ss.4 \
st.4 ste.4 stge.4 sti.4 stpcide.4 sv.4 strip.4 \
svwsata.4 swsensor.4 swwdog.4 sysmon.4 \
tap.4 tc.4 tcds.4 tcp.4 termios.4 tfb.4 thinkpad.4 \
tap.4 tc.4 tcds.4 tcp.4 tdvfb.4 termios.4 tfb.4 thinkpad.4 \
ti.4 tl.4 tlp.4 tlphy.4 tp.4 tpm.4 tprof.4 tr.4 tra.4 \
trm.4 tty.4 tun.4 tqphy.4 twa.4 twe.4 txp.4 \
uark.4 ubsec.4 udp.4 uep.4 ug.4 uha.4 uk.4 ukphy.4 unix.4 userconf.4 \

95
share/man/man4/tdvfb.4 Normal file
View File

@ -0,0 +1,95 @@
.\" $NetBSD: tdvfb.4,v 1.1 2012/07/19 08:57:09 rkujawa Exp $
.\"
.\" Copyright (c) 2012 Radoslaw Kujawa
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.Dd July 19, 2012
.Dt TDVFB 4
.Os
.Sh NAME
.Nm tdvfb
.Nd 3Dfx Voodoo 2 framebuffer driver
.Sh SYNOPSIS
.Cd "tdvfb* at pci?"
.Cd "wsdisplay* at tdvfb?"
.Cd "options TDVFB_CONSOLE"
.Sh DESCRIPTION
The
.Nm
driver provides support for the 3Dfx Voodoo 2 graphics card and provides an
interface for machine independent
.Xr wscons 4
driver.
.Pp
Since Voodoo2 was originally designed as a 3D-only solution, most boards do not
have any kind of firmware.
The
.Nm
driver is albe to do low level initialization (boot) of the board, which means
that it can be used on all architectures and is truly machine independent.
However, it also means that driver is can not detect automatically if Voodoo2
is used as a console.
.Dv TDVFB_CONSOLE
option is provided and should be set if the
.Nm
driver is intended to be used as a console.
.Sh SEE ALSO
.Xr genfb 4 ,
.Xr voodoofb 4 ,
.Xr wsdisplay 4
.Rs
.%A 3Dfx Interactive, Inc.
.%T Voodoo2 Graphics Engine for 3D Game Acceleration
.%N Revision 1.16
.%D December 1, 1999
.Re
.Sh AUTHORS
.An -nosplit
The
.Nm
driver was written by
.An Radoslaw Kujawa .
3Dfx Glide 2.x source code, Linux driver by
.An Ghozlane Toumi
were used as reference.
The
.Xr wscons 4
attachment code is based mostly on a
.Xr genfb 4
driver by
.An Michael Lorenz .
.Sh BUGS
The
.Nm
driver is unaccelerated. 3Dfx Voodoo2 has a simple 2D graphics engine but it is
unsupported yet.
.Pp
Video mode is hard coded to 800x600 at 60Hz in 32-bits, it should be selectable
at least via kernel configuration file.
It is not possibe to detect what resolutions are supported by the monitor,
since Voodoo2 has no DDC interface.
.Pp
8-bit depth is not supported by the hardware.
16-bit depth is supported by the hardware and is a prefered depth, however it
does not work corretly at the moment (this is a driver problem).