home *** CD-ROM | disk | FTP | other *** search
/ Enter 1999 April - Disc 1 / enter_04_1999_1.iso / OS2 / XFREE86 / XDOC.ZIP / XFree86 / lib / X11 / doc / README.SiS < prev    next >
Encoding:
Text File  |  1999-01-09  |  9.4 KB  |  397 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                            Information for SiS Users
  11.  
  12.                       Xavier Ducoin (xavier@rd.lectra.fr)
  13.  
  14.                                 27 February 1998
  15.  
  16.  
  17.  
  18. 1.  Introduction
  19.  
  20. This driver was primarily written for the SiS86c201.  It also works on the 202
  21. , 205 and 5597/5598 chips. Support for 6326 is currently enabled, but tested
  22. only on few cards.  Some support for SiS86c215 and 225 was added as well. This
  23. support consists simply in identify it as 205, so probably 86c215 won't work
  24. with acceleration (is a cheap 205 without some features).
  25.  
  26. The driver supports many advanced features.  These include:
  27.  
  28.    o Linear Addressing
  29.  
  30.    o 8/15/16/24 bits per pixel
  31.  
  32.    o Fully programmable clocks are supported
  33.  
  34.    o H/W cursor support
  35.  
  36.    o BitBLT acceleration of many operations
  37.  
  38.    o XAA support (XFree86 Acceleration Architecture)
  39.  
  40.  
  41. 2.  Supported chips
  42.  
  43.       SiS 86c201
  44.             (External hardware clock)
  45.  
  46.       SiS 86c202, SiS 86c2x5, SiS 5597/5598, SiS 6326
  47.             (Internal clock synthesizer)
  48.  
  49. Color expansion is not supported by the engine in 16M-color graphic mode.
  50.  
  51.  
  52. 3.  XF86Config Options
  53.  
  54. The following options are of particular interest for the SiS driver. Each of
  55. them must be specified in the `svga' driver section of the XF86Config file,
  56. within the Screen subsections of the depths to which they are applicable (you
  57. can enable options for all depths by specifying them in the Device section).
  58.  
  59.       Option "set_mclk"
  60.             This option lets you to modify the memory clocking of your card.
  61.             (only for 5597 and 6326) Modifying the memory timings can destroy
  62.  
  63.  
  64.  Information for SiS Users                                                    1
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  Information for SiS Users                                                    2
  71.  
  72.  
  73.  
  74.             the device, but usually the only ill effects of overclocking is to
  75.             have some noise an drawing errors, but BE CAREFUL. Usually a little
  76.             increment can improve the drawing speed, and allows also higher
  77.             dotclocks.  The server reports default memclock on starting mes-
  78.             sages, so take it as a base. Units are in MHZ.
  79.  
  80.       Option "dac_speed"
  81.             This option lets you to modify the maximum allowed dotclock (only
  82.             for 5597 and 6326).     Without it, the server makes a conservative
  83.             guess based on memory clock, speed and number of banks. If your
  84.             monitor supports higher dotclocks and you know that your card can
  85.             do it, give a try. If the speed is too high for your configuration
  86.             (but not for your monitor), the effects can vary from some noise on
  87.             screen to a black screen. Don't use speeds greater than 135 Mhz,
  88.             (175 for 6326), even if your monitor supports the dot-clock.
  89.  
  90.       Option "noaccel"
  91.             By default the XAA (XFree86 Acceleration Architecture) is used.
  92.             This option will disable the use of the XAA and will enable the old
  93.             BitBlt acceleration operations. (see below).
  94.  
  95.       Option "hw_clocks"
  96.             On chips 86c202 and later, the default is to use the programmable
  97.             clock for all clocks. It is possible to use the fixed clocks sup-
  98.             ported by the chip instead of using this option (manufacturer
  99.             dependent).
  100.  
  101.       Option "sw_cursor", "hw_cursor"
  102.             The default is for using the hardware cursor.
  103.  
  104.       Option "no_linear"
  105.             By default linear addressing is used on all chips.  However this
  106.             might be broken in some implementations. It is possible to turn the
  107.             linear addressing off with this option.  Note that H/W acceleration
  108.             and 16/24bpp are only supported with linear addressing.
  109.  
  110.       Option "no_bitblt"
  111.             This option will disable the use of all the BitBLT engine.  It is
  112.             useful for problems related to acceleration problems.  In general
  113.             this will result in a reduced performance.
  114.  
  115.       Option "no_imageblt"
  116.             It is useful for problems related to image writing, and possible
  117.             stipple acceleration problems. In general this will result in a
  118.             reduced performance.
  119.  
  120.       Option "ext_eng_queue"
  121.             5597/8 and 6326 have the option to extend the engine command queue
  122.             on VRAM. With extended queue length, the driver only checks queue
  123.             status on some color-expansion commands. This gives some perfor-
  124.             mance improvement, but is possible to lose some commands, corrupt-
  125.             ing screen output. As the size of extended command queue is 16-32K,
  126.             the probability is very low, but exists. The performance gain
  127.             observed is around 8-10%. Currently, using this option with
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  Information for SiS Users                                                    3
  137.  
  138.  
  139.  
  140.             xaa_benchmark freezes the acceleration engine, causing weird image
  141.             display.
  142.  
  143.       Option "pci_burst_on"
  144.             This set a bit on some registers. Although documented, the utility
  145.             of this option is unknown for me. I can't see any difference on
  146.             stability or performance.
  147.  
  148.       Option "fast_vram"
  149.             Enables 1 cycle memory access. Try it. Increased memory bandwidth
  150.             reduces the possibility of glitches and noise on high resolution
  151.             modes.
  152.  
  153.       Option "fifo_moderate","fifo_conservative","fifo_aggressive"
  154.             These options modify the arbitration thresholds on CRT FIFO.
  155.             Fifo_aggressive gives more time to CPU for accessing the VRAM.
  156.             Fifo_conservative reduces the possibility of noise caused when the
  157.             CRT tries to read memory when it is used by CPU, but reduces per-
  158.             formance. The default is between aggressive and moderate (more
  159.             aggressive than moderate).
  160.  
  161.  
  162. 4.  Modelines
  163.  
  164. When constructing a modeline for use with the Sis driver you'll need to con-
  165. sider several points:
  166.  
  167.    o H/W Acceleration.  The H/W cursor, and fill operations currently allocate
  168.      memory of the video ram for there own use.  If this is not available these
  169.      functions will automatically be disabled. Also, ext_eng_queue allocate 32k
  170.      of Vram.
  171.  
  172.    o Dot Clock. SiS documents the following video modes to work with 6326. The
  173.      max dot clock allowable for your 6326 based board depends also on the mem-
  174.      ory installed on it. Option fast_vram can be needed for high dot clocks to
  175.      work. Of course, the memory installed must allow 1 cycle R/W. The server
  176.      tries to avoid problems with high dotclocks, limiting the maximum based on
  177.      estimated memory bandwidth.  Overriding the limits with dac_speed and mod-
  178.      elines can damage the card if you exceed the card limits. Values between
  179.      driver guess and chipset limits are acceptable, but can cause bad image
  180.      quality, noise or no image displayed.
  181.  
  182.         o SiS recommended video modes for 6326:
  183.  
  184.         o    640x480  : 4, 8, 15, 16, 24 bpp at 85Hz Non-interlaced
  185.  
  186.         o    800x600  : 4, 8, 15, 16, 24 bpp at 85Hz Non-interlaced
  187.  
  188.         o   1024x768  : 4, 8, 15, 16, 24 bpp at 85Hz Non-interlaced
  189.  
  190.         o  1280x1024  : 4, 8, 15, 16, 24 bpp at 75Hz Non-interlaced
  191.  
  192.         o  1600x1200  : 4, 8  bpp at 65Hz Non-interlaced
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  Information for SiS Users                                                    4
  203.  
  204.  
  205.  
  206. 5.  Troubleshooting
  207.  
  208. The generic VGA driver doesn't work with 6326, so XF86Setup can't be used for
  209. this card. Please use xf86config instead.
  210.  
  211. With intensive generation there is a snow phenomenon on the screen.  Can't
  212. remove it even if I used the fifo low/high water mark dumped from W95.
  213.  
  214. The latter point is changed. Now we use calculated values for the fifo set-
  215. tings, and this appears to be stable until the bandwidth required for CRT is
  216. near the memory bandwidth (dotclock*depth/8 near Mclk*32 or Mclk*64 ).  In that
  217. case, you could try to use fifo_moderate, fifo_conservative or a lower dot-
  218. clock.
  219.  
  220. Some video modes with high dot-clocks don't work at all, resulting on black
  221. screen. We are tracing now this problem. Lowering dotclock in that case could
  222. solve the problem.
  223.  
  224.      Updated October 12, 1998 by Juanjo Santamarta, covering changes for 5597 and 6326.
  225.      Updated November 6, 1998 by Juanjo Santamarta, covering changes for 5597, 86c2x5 and 6326.
  226.  
  227.      Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/SiS.sgml,v 3.3.2.6 1998/12/29 07:54:30 hohndel Exp $
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  Information for SiS Users                                                    5
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.                                    CONTENTS
  339.  
  340.  
  341.  
  342. 1. Introduction  ............................................................ 1
  343.  
  344. 2. Supported chips  ......................................................... 1
  345.  
  346. 3. XF86Config Options  ...................................................... 1
  347.  
  348. 4. Modelines  ............................................................... 3
  349.  
  350. 5. Troubleshooting  ......................................................... 4
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                                        i
  395.  
  396.  
  397.