R6.6 is the Xorg base-line
[xf86-video-sis/mirage.git] / README.sgml
blob0fa0032f0ca2364c65fc0bb94b92923311aaae7c
1 <!DOCTYPE linuxdoc PUBLIC "-//XFree86//DTD linuxdoc//EN">
3 <article>
5 <!-- Title information -->
6 <title> Information for SiS Users
7 <author> Xavier Ducoin (<it>xavier@rd.lectra.fr</it>)
8 <date> 27 February 1998
10 <!-- Table of contents -->
11 <toc>
13 <sect> Introduction <p>
15 This driver was primarily written for the SiS86c201. It also works
16 on the 202 and the 205 chips. Support for other SiS products is
17 not available in XFree86 release 3.3.2. Drivers for the 5597/8 are
18 currently under development and should be available in the next release.
20 The driver supports many advanced features. These include:
21 <itemize>
22 <item>Linear Addressing
23 <item>8/15/16/24 bits per pixel
24 <item>Fully programmable clocks are supported
25 <item>H/W cursor support
26 <item>BitBLT acceleration of many operations
27 <item>XAA support (XFree86 Acceleration Architecture)
28 </itemize>
30 <sect> Supported chips <p>
32 <descrip>
33 <tag>SiS 86c201</tag>
34 (External hardware clock)
35 <tag>SiS 86c202, SiS 86c205</tag>
36 (Internal clock synthesizer)
37 </descrip>
39 Color expansion is not supported by the engine in 16M-color graphic mode.
41 <sect> XF86Config Options <p>
43 The following options are of particular interest for the SiS driver. Each of
44 them must be specified in the `svga' driver section of the XF86Config file,
45 within the Screen subsections of the depths to which they are applicable
46 (you can enable options for all depths by specifying them in the Device
47 section).
49 <descrip>
50 <tag>Option &dquot;noaccel&dquot;</tag>
51 By default the XAA (XFree86 Acceleration Architecture) is used.
52 This option will disable the use of the XAA and will enable the old
53 BitBlt acceleration operations. (see below).
54 <tag>Option &dquot;hw_clocks&dquot;</tag>
55 On chips 86c202 and later, the default is to use the programmable
56 clock for all clocks. It is possible to use the fixed clocks
57 supported by the chip instead of using this option (manufacturer
58 dependent).
59 <tag>Option &dquot;sw_cursor&dquot, &dquot;hw_cursor&dquot;</tag>
60 The default is for using the hardware cursor.
61 <tag>Option &dquot;no_linear&dquot;</tag>
62 By default linear addressing is used on all chips.
63 However this might be broken in some implementations. It is
64 possible to turn the linear addressing off with this option.
65 Note that H/W acceleration and 16/24bpp are only supported with
66 linear addressing.
67 <tag>Option &dquot;no_bitblt&dquot;</tag>
68 This option will disable the use of all the BitBLT engine.
69 It is useful for problems related to acceleration problems.
70 In general this will result in a reduced performance.
71 <tag>Option &dquot;no_imageblt&dquot;</tag>
72 It is useful for problems related to image writing, and possible
73 stipple acceleration problems. In general this will result in a reduced
74 performance.
75 </descrip>
78 <sect> Modelines <p>
80 When constructing a modeline for use with the Sis
81 driver you'll need to consider several points:
82 <itemize>
83 <item>H/W Acceleration. The H/W cursor, and fill operations
84 currently allocate memory of the video ram for there own use.
85 If this is not available these functions will automatically be
86 disabled.
87 <item>Dot Clock
88 </itemize>
90 <sect> Troubleshooting <p>
92 With intensive generation there is a snow phenomenon on the screen.
93 Can't remove it even if I used the fifo low/high water mark dumped
94 from W95.
97 With intensive generation in 1024x768 65 Mhz sometimes some points (rubbish,
98 fuzz... hard to explain) appear in memory, like memory
99 violations or memory corruption.
100 It looks like an electronic refresh not well done or VClk too near
101 the MClk.
102 I use the default Mclk set by BIOS.
103 It is hard to reproduce this problem (It can take one hour,
104 two or more).
105 I can't reproduce this problem in 1024x768 75 MHz or 1280x1024 110 MHz
106 or 1152x900 95 MHz.
108 <verb>
109 $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/SiS.sgml,v 3.3.2.1 1998/02/27 02:45:24 dawes Exp $
113 $Xorg: SiS.sgml,v 1.3 2000/08/17 19:51:05 cpqbld Exp $
114 </verb>
116 </article>