1siliconmotion(4)           Kernel Interfaces Manual           siliconmotion(4)
2
3
4

NAME

6       siliconmotion - Silicon Motion video driver
7

SYNOPSIS

9       Section "Device"
10         Identifier "devname"
11         Driver "siliconmotion"
12         ...
13         [ Option "optionname" ["optionvalue"]]
14       EndSection
15

DESCRIPTION

17       siliconmotion  is  an Xorg driver for Silicon Motion based video cards.
18       The driver is fully accelerated, and provides support for the following
19       framebuffer  depths: 8, 16, and 24.  All visual types are supported for
20       depth 8, and TrueColor visuals are supported for the other depths.
21

SUPPORTED HARDWARE

23       The siliconmotion driver supports PCI and AGP video cards based on  the
24       following Silicon Motion chips:
25
26       Lynx        SM910
27
28       LynxE       SM810
29
30       Lynx3D      SM820
31
32       LynxEM      SM710
33
34       LynxEM+     SM712
35
36       Lynx3DM     SM720
37

CONFIGURATION DETAILS

39       Please  refer  to xorg.conf(5) for general configuration details.  This
40       section only covers configuration details specific to this driver.  All
41       options  names  are case and white space insensitive when parsed by the
42       server, for example,  "lynxe" and "LynxE" are equivalent.
43
44       The driver auto-detects the chipset type,  but  the  following  ChipSet
45       names  may optionally be specified in the config file "Device" section,
46       and will override the auto-detection:
47
48           "lynx", "lynxe", "lynx3d", "lynxem", "lynxem+", "lynx3dm".
49
50
51       The following Cursor Options are supported:
52
53       Option "HWCursor" "boolean"
54              Enable or disable the HW cursor.  Default: on.
55
56       Option "SWCursor" "boolean"
57              Inverse of "HWCursor".  Default: off.
58
59
60       The following display Options are supported:
61
62       Option "ShadowFB" "boolean"
63              Use shadow framebuffer.  Default: off.
64
65       Option "Rotate" "CW"
66
67       Option "Rotate" "CCW"
68              Rotate the screen CW - clockwise or  CCW  -  counter  clockwise.
69              Uses ShadowFB.  Default: no rotation.
70
71       Option "VideoKey" "integer"
72              Set the video color key.  Default: a little off full blue.
73
74       Option "ByteSwap" "boolean"
75              Turn  on  byte  swapping  for  capturing  using  SMI demo board.
76              Default: off.
77
78       Option "Interlaced" "boolean"
79              Turn on interlaced video capturing.  Default: off.
80
81       Option "UseBIOS" "boolean"
82              Use the BIOS to set the modes. This is  used  for  custom  panel
83              timings.  Default: on.
84
85       Option "ZoomOnLCD" "boolean"
86              Allow  changing  resolution  on LCD (Ctrl-Alt-Plus and Ctrl-Alt-
87              Minus).  Default: off.
88
89       Option "Dualhead" "boolean"
90              Enable dualhead mode.  Due to hardware limitations, dualhead  is
91              limited  to  depth  16 and to the panel size and timings on both
92              the flat panel and the CRT and the CRT must be to the  right  of
93              the  flat  panel.   Only lynx chips are supported at the moment.
94              Default: off.
95
96
97       The following video memory Options are supported:
98
99       Option "set_mclk" "integer"
100              sets the memory clock, where integer is in kHz, and  integer  <=
101              100000.   Default:  probe  the memory clock value, and use it at
102              server start.
103
104
105
106       The following acceleration and graphics engine Options are supported:
107
108       Option "NoAccel"
109              Disable acceleration.  Very useful for determining if the driver
110              has  problems  with  drawing and acceleration routines.  This is
111              the first option to try if your server runs but you see  graphic
112              corruption on the screen.  Using it decreases performance, as it
113              uses software emulation for drawing operations the video  driver
114              can accelerate with hardware.  Default: acceleration is enabled.
115
116       Option "fifo_aggressive"
117
118       Option "fifo_moderate"
119
120       Option "fifo_conservative"
121              alter  the  settings  for  the threshold at which the pixel FIFO
122              takes over the internal memory bus to refill itself. The smaller
123              this  threshold,  the better the acceleration performance of the
124              card. You may try the fastest setting (fifo_aggressive) and move
125              down  if  you  encounter  pixel corruption.  The optimal setting
126              will probably depend on dot-clock and on color depth. Note  that
127              specifying  any  of  these  options will also alter other memory
128              settings which may increase performance, so trying  fifo_conser‐
129              vative  will  in  most  cases be a slight benefit (this uses the
130              chip defaults).  If pixel corruption or transient  streaking  is
131              observed  during  drawing  operations  then  removing  any  fifo
132              options is recommended.  Default: none.
133
134
135       The following PCI bus Options are supported:
136
137       Option "pci_burst" "boolean"
138              will enable PCI burst mode. This should work on all  but  a  few
139              broken  PCI  chipsets,  and will increase performance.  Default:
140              off.
141
142       Option "pci_retry" "boolean"
143              will allow the driver to rely on PCI Retry to program the  ViRGE
144              registers.   pci_burst  must  be enabled for this to work.  This
145              will increase performance,  especially  for  small  fills/blits,
146              because  the driver does not have to poll the ViRGE before send‐
147              ing it commands to make sure it is ready. It should work on most
148              recent PCI chipsets.  Default: off.
149
150       Option "AccelMethod" "string"
151              Chooses  between  available  acceleration  architectures.  Valid
152              options are XAA and EXA.  XAA is  the  traditional  acceleration
153              architecture  and support for it is very stable.  EXA is a newer
154              acceleration architecture with better performance for the Render
155              and Composite extensions, but the rendering code for it is newer
156              and possibly unstable.  The default is XAA.
157
158
159       The following additional Options are supported:
160
161       Option "ShowCache" "boolean"
162              Enable or disable viewing offscreen cache memory.  A development
163              debug option.  Default: off.
164
165

SEE ALSO

167       Xorg(1), xorg.conf(5), xorgconfig(1), Xserver(1), X(7)
168
169

SUPPORT

171       For assistance with this driver, or Xorg in general, check the web site
172       at http://www.x.org/.  If you find a problem with Xorg or have a  ques‐
173       tion  not  answered in the FAQ please use our bug report form available
174       on the web site  or  send  mail  to  xorg@lists.freedesktop.org.   When
175       reporting  problems  with  the  driver send as much detail as possible,
176       including chipset type, a  server  output  log,  and  operating  system
177       specifics.
178
179

AUTHORS

181       Kevin  Brosius,  Matt Grossman, Harald Koenig, Sebastien Marineau, Mark
182       Vojkovich, Frido Garritsen, Corvin Zahn.
183
184
185
186X Version 11            xf86-video-siliconmotion 1.5.1        siliconmotion(4)
Impressum