summaryrefslogtreecommitdiff
path: root/README
blob: 28727d7744b53b9d4553207fe743f46eb341d6c5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
xf86-video-siliconmotion - Silicon Motion video driver for the Xorg X server

Please submit bugs & patches to the Xorg bugzilla:

        https://bugs.freedesktop.org/enter_bug.cgi?product=xorg

All questions regarding this software should be directed at the
Xorg mailing list:

        http://lists.freedesktop.org/mailman/listinfo/xorg

The master development code repository can be found at:

        git://anongit.freedesktop.org/git/xorg/driver/xf86-video-siliconmotion

        http://cgit.freedesktop.org/xorg/driver/xf86-video-siliconmotion

For more information on the git code manager, see:

        http://wiki.x.org/wiki/GitPage

----------------------------------------------------------------------------

What works:
- Supports 8bpp, 16bpp and 24bpp. Heavy testing on SM720.

XCONFIG options:

The driver supports quite a few different XConfig options, which can
be used to tune the driver and improve performance. Without any options,
the driver will use conservative settings which should work on most
hardware. Large improvements in performance are possible by selecting
the proper options, which will probably work on most systems.

Cursor:

- "hwcursor" "off" behaves exactly like "swcursor".  Default: "on"
- "swcursor" will disable the HW Cursor.  HW Cursor is used by default and
	no option is needed to enable it.

Display:

- "ShadowFB"  Use shadow framebuffer.  Default: off.
- "Rotate" "cw" | "ccw"  Rotate the screen CW - clockwise or CCW - counter
    clockwise.  Uses ShadowFB.  Default: no rotation.
- "UseBIOS"  Use BIOS to set modes.  Default: on.
- "ZoomOnLCD"  Allow changing resolution on panel.  Default: off.

Overlays:

- "VideoKey"  Set chroma key for video.  Default:  Off blue.
- "ByteSwap"  Turn on YUV byte swapping.  Defaul: off.

Video memory:

- "set_mclk" sets the memory clock, format is:
	Option "set_mclk" "50000"
	in the XF86Config file.  Valid values are any
	integer <= 100000, where 100000 == 100 MHz.

Acceleration and graphic engine:

- "NoAccel" turns off all acceleration
- "fifo_aggressive", "fifo_moderate" and "fifo_conservative" 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 ("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 should increase performance, so you should at
        least use "fifo_conservative" (this uses the chip defaults).
- Common XAA acceleration options to disable primitives for test purposes:
	"XaaNoScreenToScreenCopy"
	"XaaNoSolidFillRect"
	"XaaNoColor8x8PatternFillRect"
	"XaaNoImageWriteRect"
	"XaaNoPixmapCache"

PCI bus:

- "pci_burst" will enable PCI burst mode. This should work on all but a
	few "broken" PCI chipsets, and will increase performance.  Option may
	take a parameter "on", "off", "yes", etc...
- "pci_retry" will allow the driver to rely on PCI Retry to program the
	ViRGE registers. "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.

Debug:

- "ShowCache"  Enable or disable viewing offscreen cache memory.  A
    development debug option.  Default: off.

Header:   //Mercury/Projects/archives/XFree86/4.0/README.-arc   1.2   14 Sep 2000 12:28:36   Frido  $

$XFree86: xc/programs/Xserver/hw/xfree86/drivers/siliconmotion/README,v 1.3 2001/02/15 18:20:33 dawes Exp $