211 lines
6.3 KiB
Groff
211 lines
6.3 KiB
Groff
.\" Header: //Mercury/Projects/archives/XFree86/4.0/siliconmotion.cpp-arc 1.4 29 Nov 2000 14:12:56 Frido $
|
|
.\" $XFree86: xc/programs/Xserver/hw/xfree86/drivers/siliconmotion/siliconmotion.man,v 1.4 2001/12/20 21:35:38 eich Exp $
|
|
.\" shorthand for double quote that works everywhere.
|
|
.ds q \N'34'
|
|
.TH siliconmotion __drivermansuffix__ __vendorversion__
|
|
.SH NAME
|
|
siliconmotion \- Silicon Motion video driver
|
|
.SH SYNOPSIS
|
|
.B "Section \*qDevice\*q"
|
|
.br
|
|
.BI " Identifier \*q" devname \*q
|
|
.br
|
|
.B " Driver \*qsiliconmotion\*q"
|
|
.br
|
|
\ \ ...
|
|
.br
|
|
\ \ [
|
|
.B "Option"
|
|
"optionname" ["optionvalue"]]
|
|
.br
|
|
.B EndSection
|
|
.SH DESCRIPTION
|
|
.B siliconmotion
|
|
is an XFree86 driver for Silicon Motion based video cards. The driver is fully
|
|
accelerated, and provides support for the following framebuffer depths:
|
|
8, 16, and 24. All
|
|
visual types are supported for depth 8, and TrueColor
|
|
visuals are supported for the other depths.
|
|
.SH SUPPORTED HARDWARE
|
|
The
|
|
.B siliconmotion
|
|
driver supports PCI and AGP video cards based on the following Silicon Motion chips:
|
|
.TP 12
|
|
.B Lynx
|
|
SM910
|
|
.TP 12
|
|
.B LynxE
|
|
SM810
|
|
.TP 12
|
|
.B Lynx3D
|
|
SM820
|
|
.TP 12
|
|
.B LynxEM
|
|
SM710
|
|
.TP 12
|
|
.B LynxEM+
|
|
SM712
|
|
.TP 12
|
|
.B Lynx3DM
|
|
SM720
|
|
.SH CONFIGURATION DETAILS
|
|
Please refer to XF86Config(__filemansuffix__) for general configuration
|
|
details. This section only covers configuration details specific to this
|
|
driver. All options names are case and white space insensitive when
|
|
parsed by the server, for example, "lynxe" and "LynxE" are equivalent.
|
|
.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
|
|
"lynx", "lynxe", "lynx3d", "lynxem", "lynxem+", "lynx3dm".
|
|
.RE
|
|
|
|
.PP
|
|
The following Cursor
|
|
.B Options
|
|
are supported:
|
|
.TP
|
|
.BI "Option \*qHWCursor\*q \*q" boolean \*q
|
|
Enable or disable the HW cursor. Default: on.
|
|
.TP
|
|
.BI "Option \*qSWCursor\*q \*q" boolean \*q
|
|
Inverse of "HWCursor". Default: off.
|
|
|
|
.PP
|
|
The following display
|
|
.B Options
|
|
are supported:
|
|
.TP
|
|
.BI "Option \*qShadowFB\*q \*q" boolean \*q
|
|
Use shadow framebuffer. Default: off.
|
|
.TP
|
|
.BI "Option \*qRotate\*q \*qCW\*q"
|
|
.TP
|
|
.BI "Option \*qRotate\*q \*qCCW\*q"
|
|
Rotate the screen CW - clockwise or CCW - counter clockwise.
|
|
Uses ShadowFB. Default: no rotation.
|
|
.TP
|
|
.BI "Option \*qVideoKey\*q \*q" integer \*q
|
|
Set the video color key. Default: a little off full blue.
|
|
.TP
|
|
.BI "Option \*qByteSwap\*q \*q" boolean \*q
|
|
Turn on byte swapping for capturing using SMI demo board. Default: off.
|
|
.TP
|
|
.BI "Option \*qInterlaced\*q \*q" boolean \*q
|
|
Turn on interlaced video capturing. Default: off.
|
|
.TP
|
|
.BI "Option \*qUseBIOS\*q \*q" boolean \*q
|
|
Use the BIOS to set the modes. This is used for custom panel timings.
|
|
Default: on.
|
|
.TP
|
|
.BI "Option \*qZoomOnLCD\*q \*q" boolean \*q
|
|
Allow changing resolution on LCD (Ctrl-Alt-Plus and Ctrl-Alt-Minus).
|
|
Default: off.
|
|
.TP
|
|
.BI "Option \*qDualhead\*q \*q" boolean \*q
|
|
Enable dualhead mode. Due to hardware limitations, dualhead is limited
|
|
to depth 16 and to the panel size and timings on both the flat panel and
|
|
the CRT and the CRT must be to the right of the flat panel. Only lynx
|
|
chips are supported at the moment.
|
|
Default: off.
|
|
|
|
.PP
|
|
The following video memory
|
|
.B Options
|
|
are supported:
|
|
.TP
|
|
.BI "Option \*qset_mclk\*q \*q" integer \*q
|
|
sets the memory clock, where
|
|
.I integer
|
|
is in kHz, and
|
|
.I integer
|
|
<= 100000. Default: probe the memory clock value,
|
|
and use it at server start.
|
|
|
|
|
|
.PP
|
|
The following acceleration and graphics engine
|
|
.B Options
|
|
are supported:
|
|
.TP
|
|
.B "Option \*qNoAccel\*q"
|
|
Disable acceleration. Very useful for determining if the
|
|
driver has problems with drawing and acceleration routines. This is the first
|
|
option to try if your server runs but you see graphic corruption on the screen.
|
|
Using it decreases performance, as it uses software emulation for drawing
|
|
operations the video driver can accelerate with hardware.
|
|
Default: acceleration is enabled.
|
|
.TP
|
|
.B "Option \*qfifo_aggressive\*q"
|
|
.TP
|
|
.B "Option \*qfifo_moderate\*q"
|
|
.TP
|
|
.B "Option \*qfifo_conservative\*q"
|
|
alter the settings
|
|
for the threshold at which the pixel FIFO takes over the internal
|
|
memory bus to refill itself. The smaller this threshold, the better
|
|
the acceleration performance of the card. You may try the fastest
|
|
setting
|
|
.RB ( "fifo_aggressive" )
|
|
and move down if you encounter pixel corruption.
|
|
The optimal setting will probably depend on dot-clock and on color
|
|
depth. Note that specifying any of these options will also alter other
|
|
memory settings which may increase performance, so trying
|
|
.B "fifo_conservative"
|
|
will in most cases be a slight benefit (this uses the chip defaults).
|
|
If pixel corruption or transient streaking is observed during drawing
|
|
operations then removing any fifo options is recommended. Default: none.
|
|
|
|
.PP
|
|
The following PCI bus
|
|
.B Options
|
|
are supported:
|
|
.TP
|
|
.BI "Option \*qpci_burst\*q \*q" boolean \*q
|
|
will enable PCI burst mode. This should work on all but a
|
|
few broken PCI chipsets, and will increase performance. Default: off.
|
|
.TP
|
|
.BI "Option \*qpci_retry\*q \*q" boolean \*q
|
|
will allow the driver to rely on PCI Retry to program the
|
|
ViRGE registers.
|
|
.B "pci_burst"
|
|
must be enabled for this to work.
|
|
This will increase performance, especially for small fills/blits,
|
|
because the driver does not have to poll the ViRGE before sending it
|
|
commands to make sure it is ready. It should work on most
|
|
recent PCI chipsets. Default: off.
|
|
|
|
.PP
|
|
The following additional
|
|
.B Options
|
|
are supported:
|
|
.TP
|
|
.BI "Option \*qShowCache\*q \*q" boolean \*q
|
|
Enable or disable viewing offscreen cache memory. A
|
|
development debug option. Default: off.
|
|
|
|
.SH SEE ALSO
|
|
XFree86(1), XF86Config(__filemansuffix__), xf86config(1), Xserver(1), X(__miscmansuffix__)
|
|
|
|
.SH SUPPORT
|
|
For assistance with this driver, or XFree86 in general, check the XFree86 web
|
|
site at http://www.xfree86.org. A FAQ is available on the web site at
|
|
http://www.xfree86.org/FAQ/. If you find a problem with XFree86 or have a
|
|
question not answered in the FAQ please use our bug report form available on
|
|
the web site or send mail to XFree86@XFree86.org. When reporting problems
|
|
with the driver send as much detail as possible, including chipset type, a
|
|
server output log, and operating system specifics.
|
|
|
|
.SH AUTHORS
|
|
Kevin Brosius,
|
|
Matt Grossman,
|
|
Harald Koenig,
|
|
Sebastien Marineau,
|
|
Mark Vojkovich,
|
|
Frido Garritsen,
|
|
Corvin Zahn.
|