1999-02-07 05:40:14 +00:00
|
|
|
.\"
|
|
|
|
.\" Copyright (c) 1999
|
|
|
|
.\" Kazutaka YOKOTA <yokota@zodiac.mech.utsunomiya-u.ac.jp>
|
|
|
|
.\" 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 as
|
|
|
|
.\" the first lines of this file unmodified.
|
|
|
|
.\" 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.
|
|
|
|
.\"
|
1999-08-28 00:22:10 +00:00
|
|
|
.\" $FreeBSD$
|
1999-02-07 05:40:14 +00:00
|
|
|
.\"
|
1999-07-05 10:03:05 +00:00
|
|
|
.Dd June 30, 1999
|
1999-11-15 23:14:32 +00:00
|
|
|
.Dt VGA 4
|
2001-07-10 15:31:11 +00:00
|
|
|
.Os
|
1999-02-07 05:40:14 +00:00
|
|
|
.Sh NAME
|
|
|
|
.Nm vga
|
2001-04-18 15:54:10 +00:00
|
|
|
.Nd generic video card interface
|
1999-02-07 05:40:14 +00:00
|
|
|
.Sh SYNOPSIS
|
1999-07-05 10:03:05 +00:00
|
|
|
.Cd "options VESA"
|
|
|
|
.Cd "options VESA_DEBUG=N"
|
|
|
|
.Cd "options VGA_ALT_SEQACCESS"
|
|
|
|
.Cd "options VGA_NO_FONT_LOADING"
|
|
|
|
.Cd "options VGA_NO_MODE_CHANGE"
|
|
|
|
.Cd "options VGA_SLOW_IOACCESS"
|
|
|
|
.Cd "options VGA_WIDTH90"
|
1999-02-07 05:40:14 +00:00
|
|
|
.Cd "device vga0 at isa? port ? conflicts"
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
driver is a generic video card driver which provides access to
|
|
|
|
video cards. This driver is required for the console driver
|
|
|
|
.Xr syscons 4 .
|
|
|
|
The console driver will call the
|
|
|
|
.Nm
|
|
|
|
driver to manipulate video hardware (changing video modes, loading font, etc).
|
|
|
|
.Pp
|
1999-02-10 14:25:03 +00:00
|
|
|
The keyword
|
2000-10-03 22:51:27 +00:00
|
|
|
.Dv conflicts
|
1999-02-10 14:25:03 +00:00
|
|
|
is required, as the video card may use I/O ports in the same range
|
|
|
|
as other drivers.
|
|
|
|
.Pp
|
1999-02-07 05:40:14 +00:00
|
|
|
The
|
|
|
|
.Nm
|
2000-03-01 14:50:24 +00:00
|
|
|
driver supports the standard video cards: MDA, CGA, EGA and VGA.
|
|
|
|
In
|
1999-02-10 14:25:03 +00:00
|
|
|
addition, the driver can utilize VESA BIOS extensions if the video card
|
2000-03-01 14:50:24 +00:00
|
|
|
supports them.
|
|
|
|
VESA support can either be statically included in the kernel
|
1999-02-10 14:25:03 +00:00
|
|
|
or can be loaded as a separate module.
|
1999-02-07 05:40:14 +00:00
|
|
|
.Pp
|
1999-07-05 10:03:05 +00:00
|
|
|
In order to statically link the VESA support to the kernel, the
|
2000-10-03 22:51:27 +00:00
|
|
|
.Dv VESA
|
1999-07-05 10:03:05 +00:00
|
|
|
option (see below) must be defined in the kernel configuration file.
|
1999-02-07 05:40:14 +00:00
|
|
|
.Pp
|
|
|
|
The
|
|
|
|
.Nm vesa
|
1999-02-10 14:25:03 +00:00
|
|
|
module can be dynamically loaded into the kernel using
|
1999-02-07 05:40:14 +00:00
|
|
|
.Xr kldload 8 .
|
|
|
|
.Sh DRIVER CONFIGURATION
|
|
|
|
.Ss Kernel Configuration Options
|
1999-02-10 14:25:03 +00:00
|
|
|
The following kernel configuration options
|
|
|
|
.Pq see Xr config 8
|
|
|
|
can be used to control the
|
1999-02-07 05:40:14 +00:00
|
|
|
.Nm
|
|
|
|
driver.
|
1999-02-10 14:25:03 +00:00
|
|
|
These options provide compatibility with certain VGA cards.
|
1999-02-07 05:40:14 +00:00
|
|
|
.Bl -tag -width MOUSE
|
2000-10-03 22:51:27 +00:00
|
|
|
.It Dv VGA_ALT_SEQACCESS
|
1999-02-07 05:40:14 +00:00
|
|
|
You may want to try this option if the mouse pointer is not drawn correctly
|
1999-02-10 14:25:03 +00:00
|
|
|
or the font does not seem to be loaded properly on the VGA card.
|
1999-02-07 05:40:14 +00:00
|
|
|
However, it may cause flicker on some systems.
|
2000-10-03 22:51:27 +00:00
|
|
|
.It Dv VGA_SLOW_IOACCESS
|
1999-02-07 05:40:14 +00:00
|
|
|
Older VGA cards may require this option for proper operation.
|
|
|
|
It makes the driver perform byte-wide I/O to VGA registers and
|
|
|
|
slow down a little.
|
2000-10-03 22:51:27 +00:00
|
|
|
.It Dv VGA_WIDTH90
|
1999-07-05 10:03:05 +00:00
|
|
|
This option enables 90 column modes: 90x25, 90x30, 90x43, 90x50, 90x60.
|
|
|
|
These modes are not always supported by the video card and the display.
|
|
|
|
It is highly likely that LCD display cannot work with these modes.
|
1999-02-07 05:40:14 +00:00
|
|
|
.El
|
|
|
|
.Pp
|
|
|
|
The following options add optional features to the driver.
|
|
|
|
.Bl -tag -width MOUSE
|
2000-10-03 22:51:27 +00:00
|
|
|
.It Dv VESA
|
1999-02-07 05:40:14 +00:00
|
|
|
Add VESA BIOS support to the driver.
|
|
|
|
If the VGA card has the VESA BIOS extension 1.2 or later,
|
|
|
|
this option will utilize the VESA BIOS service to switch to high
|
|
|
|
resolution modes.
|
2000-10-03 22:51:27 +00:00
|
|
|
.It Dv VESA_DEBUG=N
|
1999-02-10 14:25:03 +00:00
|
|
|
Set the VESA support debug level to
|
|
|
|
.Fa N .
|
|
|
|
The default value is zero, which suppresses all debugging output.
|
1999-02-07 05:40:14 +00:00
|
|
|
.El
|
|
|
|
.Pp
|
|
|
|
The following options will remove some features from the
|
|
|
|
.Nm
|
|
|
|
driver and save kernel memory.
|
|
|
|
.Bl -tag -width MOUSE
|
2000-10-03 22:51:27 +00:00
|
|
|
.It Dv VGA_NO_FONT_LOADING
|
1999-02-07 05:40:14 +00:00
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
driver can load software font to EGA and VGA cards.
|
2000-10-03 22:51:27 +00:00
|
|
|
This option removes this feature.
|
|
|
|
Note that if you use this option and
|
2000-09-30 16:25:28 +00:00
|
|
|
still wish to use the mouse on the console then you must also use the
|
2000-10-03 22:51:27 +00:00
|
|
|
.Dv SC_ALT_MOUSE_IMAGE
|
2000-09-30 16:25:28 +00:00
|
|
|
option. See
|
|
|
|
.Xr syscons 4 .
|
2000-10-03 22:51:27 +00:00
|
|
|
.It Dv VGA_NO_MODE_CHANGE
|
1999-02-10 14:25:03 +00:00
|
|
|
This option prevents the driver from changing video modes.
|
1999-02-07 05:40:14 +00:00
|
|
|
.El
|
|
|
|
.\".Sh FILES
|
2000-11-17 11:44:16 +00:00
|
|
|
.Sh EXAMPLES
|
1999-02-07 05:40:14 +00:00
|
|
|
Your kernel configuration should normally have:
|
|
|
|
.Pp
|
|
|
|
.Dl "device vga0 at isa? port ? conflicts"
|
|
|
|
.Pp
|
|
|
|
The following lines should be included in the kernel configuration file
|
|
|
|
in order to enable the VESA BIOS Extension support.
|
|
|
|
.Pp
|
1999-07-05 10:03:05 +00:00
|
|
|
.Dl "options VESA"
|
1999-02-07 05:40:14 +00:00
|
|
|
.Dl "device vga0 at isa? port ? conflicts"
|
|
|
|
.Pp
|
1999-02-10 14:25:03 +00:00
|
|
|
If you do not want VESA support included in the kernel, but
|
1999-07-05 10:03:05 +00:00
|
|
|
want to use occasionally, do not add the
|
2000-10-03 22:51:27 +00:00
|
|
|
.Dv VESA
|
1999-07-05 10:03:05 +00:00
|
|
|
option. And load the
|
1999-02-07 05:40:14 +00:00
|
|
|
.Nm vesa
|
1999-02-10 14:25:03 +00:00
|
|
|
module as desired:
|
1999-02-07 05:40:14 +00:00
|
|
|
.Pp
|
|
|
|
.Dl kldload vesa
|
|
|
|
.Pp
|
|
|
|
.\".Sh DIAGNOSTICS
|
|
|
|
.\".Sh CAVEATS
|
|
|
|
.\".Sh BUGS
|
|
|
|
.Sh SEE ALSO
|
2000-05-09 02:52:39 +00:00
|
|
|
.Xr vgl 3 ,
|
1999-02-10 14:25:03 +00:00
|
|
|
.Xr syscons 4 ,
|
|
|
|
.Xr config 8 ,
|
1999-02-07 05:40:14 +00:00
|
|
|
.Xr kldload 8 ,
|
2000-11-15 16:00:07 +00:00
|
|
|
.Xr kldunload 8
|
2000-11-17 11:44:16 +00:00
|
|
|
.Sh STANDARDS
|
1999-02-07 05:40:14 +00:00
|
|
|
.Rs
|
|
|
|
.%T "VESA BIOS Extension (VBE)"
|
|
|
|
.%A Video Electronics Standards Association
|
|
|
|
.Re
|
|
|
|
.Sh HISTORY
|
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
driver first appeared in
|
|
|
|
.Fx 3.1 .
|
|
|
|
.Sh AUTHORS
|
2000-11-22 09:35:58 +00:00
|
|
|
.An -nosplit
|
1999-02-07 05:40:14 +00:00
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
driver was written by
|
2000-11-14 13:09:12 +00:00
|
|
|
.An S\(/oren Schmidt Aq sos@FreeBSD.org
|
1999-02-07 05:40:14 +00:00
|
|
|
and
|
|
|
|
.An Kazutaka Yokota Aq yokota@FreeBSD.org .
|
|
|
|
This manual page was written by
|
|
|
|
.An Kazutaka Yokota .
|