113 lines
4.1 KiB
Groff
113 lines
4.1 KiB
Groff
.\" $XFree86: xc/programs/Xserver/hw/xfree86/drivers/rendition/rendition.man,v 1.3 2003/06/18 16:17:39 eich Exp $
|
|
.\" shorthand for double quote that works everywhere.
|
|
.ds q \N'34'
|
|
.TH RENDITION __drivermansuffix__ __vendorversion__
|
|
.SH NAME
|
|
rendition \- Rendition video driver
|
|
.SH SYNOPSIS
|
|
.nf
|
|
.B "Section \*qDevice\*q"
|
|
.BI " Identifier \*q" devname \*q
|
|
.B " Driver \*qrendition\*q"
|
|
\ \ ...
|
|
.B EndSection
|
|
.fi
|
|
.SH DESCRIPTION
|
|
.B rendition
|
|
is an XFree86 driver for Rendition/Micron based video cards. The driver
|
|
supports following framebuffer depths: 8, 15 (Verite V1000 only), 16
|
|
and 24. Acceleration and multi-head configurations are
|
|
not supported yet, but are work in progress.
|
|
.SH SUPPORTED HARDWARE
|
|
The
|
|
.B rendition
|
|
driver supports PCI and AGP video cards based on the following Rendition/Micron chips:
|
|
.TP 12
|
|
.B V1000
|
|
Verite V1000 based cards.
|
|
.TP 12
|
|
.B V2100
|
|
Verite V2100 based cards. Diamond Stealth II S220 is the only known such card.
|
|
.TP 12
|
|
.B V2200
|
|
Verite V2200 based cards.
|
|
.SH CONFIGURATION DETAILS
|
|
Please refer to XF86Config(__filemansuffix__) for general configuration
|
|
details. This section only covers configuration details specific to this
|
|
driver.
|
|
.PP
|
|
The driver auto-detects the chipset type, but the following
|
|
.B ChipSet
|
|
names may optionally be specified in the config file
|
|
.B \*qDevice\*q
|
|
section, and will override the auto-detection:
|
|
.PP
|
|
.RS 4
|
|
"v1000", "v2x00".
|
|
.RE
|
|
.PP
|
|
The driver will auto-detect the amount of video memory present for all
|
|
chips. If the amount of memory is detected incorrectly, the actual amount
|
|
of video memory should be specified with a
|
|
.B VideoRam
|
|
entry in the config file
|
|
.B \*qDevice\*q
|
|
section.
|
|
.PP
|
|
The following driver
|
|
.B Options
|
|
are supported:
|
|
.TP
|
|
.BI "Option \*qSWCursor\*q \*q" boolean \*q
|
|
Disables use of the hardware cursor. Default: use HW-cursor.
|
|
.TP
|
|
.BI "Option \*qOverclockMem\*q \*q" boolean \*q
|
|
Increases the Mem/Sys clock to 125MHz/60MHz from standard 110MHz/50MHz.
|
|
Default: Not overclocked.
|
|
.TP
|
|
.BI "Option \*qDacSpeed\*q \*q" MHz \*q
|
|
Run the memory at a higher clock. Useful on some cards with display glitches
|
|
at higher resolutions. But adds the risk to damage the hardware. Use with
|
|
caution.
|
|
.TP
|
|
.BI "Option \*qFramebufferWC\*q \*q" boolean \*q
|
|
If writecombine is disabled in BIOS, and you add this option in configuration
|
|
file, then the driver will try to request writecombined access to the
|
|
framebuffer. This can drastically increase the performance on unaccelerated
|
|
server. Requires that "MTRR"-support is compiled into the OS-kernel.
|
|
Default: Disabled for V1000, enabled for V2100/V2200.
|
|
.TP
|
|
.BI "Option \*qNoDDC\*q \*q" boolean \*q
|
|
Disable probing of DDC-information from your monitor. This information is not
|
|
used yet and is only there for informational purposes. This might change
|
|
before final XFree86 4.0 release. Safe to disable if you experience problems
|
|
during startup of X-server.
|
|
Default: Probe DDC.
|
|
.TP
|
|
.BI "Option \*qShadowFB\*q \*q" boolean \*q
|
|
If this option is enabled, the driver will cause the CPU to do each drawing
|
|
operation first into a shadow frame buffer in system virtual memory and then
|
|
copy the result into video memory. If this option is not active, the CPU will
|
|
draw directly into video memory. Enabling this option is beneficial for those
|
|
systems where reading from video memory is, on average, slower than the
|
|
corresponding read/modify/write operation in system virtual memory. This is
|
|
normally the case for PCI or AGP adapters, and, so, this option is enabled by
|
|
default unless acceleration is enabled.
|
|
Default: Enabled unless acceleration is used.
|
|
.TP
|
|
.BI "Option \*qRotate\*q \*qCW\*q"
|
|
.TP
|
|
.BI "Option \*qRotate\*q \*qCCW\*q"
|
|
Rotate the display clockwise or counterclockwise. This mode is unaccelerated.
|
|
Default: no rotation.
|
|
.TP
|
|
.SH "Notes"
|
|
For the moment the driver defaults to not request write-combine for any chipset
|
|
as there has been indications of problems with it. Use
|
|
.B "Option \*qMTRR\*q"
|
|
to let the driver request write-combining of memory access on the video board.
|
|
.SH "SEE ALSO"
|
|
XFree86(1), XF86Config(__filemansuffix__), xf86config(1), Xserver(1), X(__miscmansuffix__)
|
|
.SH AUTHORS
|
|
Authors include: Marc Langenbach, Dejan Ilic
|