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.Oak < prev    next >
Encoding:
Text File  |  1999-01-09  |  9.1 KB  |  397 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.               Information for Oak Technologies Inc. Chipset Users
  11.  
  12.                   Jorge F. Delgado Mendoza (ernar@dit.upm.es)
  13.  
  14.                                27 February 1998
  15.  
  16.  
  17.  
  18. 1.  Supported chipsets
  19.  
  20. The driver is used in the 8-bit / 256-color SVGA server and the mono server.
  21. The following chipsets for Oak Tech. Inc. are supported:
  22.  
  23.       OTI037C
  24.             8-bit VGA chipset, with up to 256Kbytes of DRAM. All the boards I
  25.             have seen are only able to do standard VGA modes.  (ie. up to
  26.             320x200x256 and up to 640x480x16). Currently the probe for this
  27.             chip is disabled, so use the generic VGA driver instead.
  28.  
  29.       OTI067
  30.             ISA SVGA chipset, up to 512Kbytes of DRAM (usually 70/80 ns).
  31.  
  32.       OTI077
  33.             Enhanced version of the 067, with support for 1Mbyte and up to 65
  34.             Mhz dot-clock. This chipset is capable of resolutions up to
  35.             1024x768x256 colors in Non-Interlaced mode, and up to 1280x1024x16
  36.             colors Interlaced.
  37.  
  38.       OTI087
  39.             One of the first VLB chipsets available, it has a 16-bit external
  40.             data path, and a 32-bit internal memory-controller data path. It
  41.             features some acceleration hardware: register-based color expan-
  42.             sion, hardware cursor, a primitive BitBlt engine, a 64 bit graphic
  43.             latch and some other new (on its time) features.  Maximum BIOS res-
  44.             olutions are 1024x768x256 Non-Interlaced and 1280x1024x256 inter-
  45.             laced. Maximum Dot-Clock is 80Mhz, but is usually coupled with the
  46.             OTI068 clock generator capable of frequencies up to 78Mhz.  This
  47.             chipset supports up to 2MBytes of 70/70R ns DRAM.
  48.  
  49.       OTI107 and OTI111
  50.             These are new, PCI chipsets by Oak Tech. Inc. Support is not
  51.             included for them, as they are very rare and I haven't had the
  52.             chance to look at one of these boards.  We have been unable to
  53.             locate either 107's or 111's (also called "Spitfire 64111"). If
  54.             anybody has such a board and can donate it to XFree86, I would be
  55.             more than glad to add support for them.
  56.  
  57. All the chipsets up to the OTI087 are "Backwards compatible", in fact some
  58. early drivers for the OTI087 based chipsets were those made for the 077.
  59.  
  60. Accelerated support is included only for OTI087 chipsets, also Mono server is
  61. only included for 067/077 chipsets.
  62.  
  63.  
  64. Information for Oak Technologies Inc. Chipset Users                           1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. Information for Oak Technologies Inc. Chipset Users                           2
  71.  
  72.  
  73.  
  74. 2.  XF86Config options
  75.  
  76. The following options are of particular interest to the Oak driver. Each of
  77. them must be specified in the 'svga' driver section of the XF86Config file,
  78. within the Screen subsections to which they are applicable (you can enable
  79. options for all depths by specifying them in the Device section).
  80.  
  81.       Option "linear" (OTI087)
  82.             This option enables a linear framebuffer at 0xE00000 (14Mb) for
  83.             cards recognized as ISA by the probe.  Cards that are VLB will map
  84.             the framebuffer at 0x4E00000.  The aperture depends on the VideoRam
  85.             parameter in the XF86Config file or on the probed value for the
  86.             board. It will speed up performance by about 15% on a VLB-based
  87.             boards for a DX2-66 486.
  88.  
  89.             Sometimes a motherboard will not be able to map at 0x4E00000, and
  90.             then linear mode will not work with more than 14 Mbytes of main
  91.             RAM. I know this because mine doesn't.
  92.  
  93.       Option "fifo_aggressive" (OTI087)
  94.             This option will cause the command FIFO threshold of the chipset to
  95.             be set at 0 instructions, which should be optimal for 16-bit data
  96.             transfers, as empirical use of different thresholds, with xbench,
  97.             show. Expect a 5-10% of performance boost on a DX2-66 486.
  98.  
  99.       Option "fifo_conservative" (OTI087)
  100.             This option will set the FIFO to a safe value of 14, slowing the
  101.             board by a 50%, use this only if you experience streaks or anoma-
  102.             lies on the screen.
  103.  
  104.       Option "enable_bitblt" (OTI087)
  105.             This option will enable an internal cache on the board that will be
  106.             used as a rudimentary bitblt engine. Performance boost is more or
  107.             less 100%, (double BlitStones on xbench). Most OTI087 boards seem
  108.             to have this feature broken, corrupting text from xterms and leav-
  109.             ing mouse droppings throughout the screen. As a rule of thumb,
  110.             enable it, if it works badly, disable it.
  111.  
  112.       Option "clock_50" (OTI087)
  113.             This one will force the internal speed to 50 Mhz.
  114.  
  115.       Option "clock_66" (OTI087)
  116.             This one will force the internal speed to 66 Mhz, speeding up per-
  117.             formance of the chipset.
  118.  
  119.       Option "no_wait" (OTI087)
  120.             Sets the VLB interface to no wait states. On a medium VLB board
  121.             (mine is VLB/PCI, so its not a very fast one) in VLB transparent
  122.             mode, it manages up to 16 Mbytes/second transfer rate through the
  123.             bus.
  124.  
  125.       Option "first_wait" (OTI087)
  126.             Makes the VLB interface to add one wait state to the first read or
  127.             write of a given burst.
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. Information for Oak Technologies Inc. Chipset Users                           3
  137.  
  138.  
  139.  
  140.       Option "first_wwait" (OTI087)
  141.             Similar to the previous one, this only inserts a wait state in the
  142.             first 'write' of a given burst. reads are not affected. This is the
  143.             default behaviour of the server.
  144.  
  145.       Option "write_wait" (OTI087)
  146.             This configures the VLB interface to add one wait state to each
  147.             write cycle.
  148.  
  149.       Option "read_wait" (OTI087)
  150.             This configures the VLB interface to add one wait state to each
  151.             read cycle.
  152.  
  153.       Option "all_wait" (OTI087)
  154.             Enables the slowest VLB transfer adding wait states in all cases.
  155.             Hopefully, no board will need this enabled.
  156.  
  157.       Option "one_wait" (OTI087)
  158.             Sets the VLB interface to at least one wait state.
  159.  
  160.       Option "noaccel" (OTI087)
  161.             One accelerated routine has been lately added to the driver, allow-
  162.             ing it to draw solid fills quite faster. This routine only works
  163.             (up to date) on segmented addressing, and only if the virtual width
  164.             is 1024. This option is automatically enabled by the driver. Use
  165.             this option if you want to disable it.
  166.  
  167. As a rule of thumb, use the option "no_wait", and if it doesn't result in cor-
  168. rupting text, lucky you. If not, try "first_wwait", and downwards. ISA card
  169. owners should not use these options.
  170.  
  171.  
  172. 3.  Mode issues
  173.  
  174. The use of very high dot-clocks has a REAL negative effect on the performance
  175. of the boards, due to its limited 80Mbit/sec, higher dot clocks limit its abil-
  176. ity to draw data into the framebuffer. Thus expect better performance of a
  177. 72Mhz based mode than on a 78Mhz based one (for example) where more bandwidth
  178. is required for screen refresh.
  179.  
  180. It does not make much sense to use the highest clock (78 MHz) for 1024x768 at
  181. 76 Hz on a OTI087; the card will almost come to a standstill. A 72 MHz dot
  182. clock results in 70 Hz which should be acceptable. If you have a monitor that
  183. supports 1024x768 at 76 Hz with a 78 MHz dot clock, a standard OTI087 based
  184. card is a poor match anyway.
  185.  
  186.  
  187. 4.  Linear addressing
  188.  
  189. Linear addressing is hardwired to 14 Mbytes for ISA boards and 78 Mbytes for
  190. VLB boards, thus if you have more than that on your board you shouldn't enable
  191. it.  The aperture is selected from the VideoRam parameter of the XF86Config or
  192. from the amount of memory that is detected if VideoRam is not found.
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. Information for Oak Technologies Inc. Chipset Users                           4
  203.  
  204.  
  205.  
  206. I hope (because I have not tested it very thoroughly) that linear addressing
  207. will work on all ISA boards, VLB ones work flawlessly.
  208.  
  209.      Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/Oak.sgml,v 3.12.2.3 1998/11/07 13:37:48 dawes Exp $
  210.  
  211.  
  212.  
  213.  
  214.  
  215.      $XConsortium: Oak.sgml /main/8 1996/05/12 20:58:00 kaleb $
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  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 Oak Technologies Inc. Chipset 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. Supported chipsets  ...................................................... 1
  343.  
  344. 2. XF86Config options  ...................................................... 2
  345.  
  346. 3. Mode issues  ............................................................. 3
  347.  
  348. 4. Linear addressing ........................................................ 3
  349.  
  350.  
  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.