home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 August - Disc 2 / chip_20018102_hu.iso / linux / X-4.1.0 / doc / readme.ati < prev    next >
Text File  |  2001-06-27  |  34KB  |  696 lines
  1.                           ATI Adapters README file
  2.  
  3.                             Marc Aurele La France
  4.  
  5.                                 2001 April 10
  6.  
  7.                                   Abstract
  8.  
  9.      This is the README for the XFree86 ATI driver included in this
  10.      release.
  11.  
  12. 1.  Statement of intent
  13.  
  14. Generally speaking, the driver is intended for all ATI video adapters, pro-
  15. viding maximum video function within hardware limitations.  The driver is
  16. also intended to optionally provide the same level of support for generic VGA
  17. or 8514/A adapters.  This driver is still being actively developed, meaning
  18. that it currently does not yet fully meet these goals.
  19.  
  20. The driver will provide
  21.  
  22.    o accelerated support if an ATI accelerator is detected and the user has
  23.      not requested that this support be disabled;  otherwise
  24.  
  25.    o accelerated support if a non-ATI 8514/A-capable adapter is detected and
  26.      the user has requested such support;  otherwise
  27.  
  28.    o unaccelerated SuperVGA support if an ATI VGA-capable adapter is
  29.      detected; otherwise
  30.  
  31.    o generic VGA support if a non-ATI VGA-capable adapter is detected and the
  32.      user has requested such support.
  33.  
  34. Thus, the level of support provided not only depends on what the driver
  35. detects in the system, but also, on what the user specifies in the XF86Config
  36. file.  See the ``XF86Config specifications'' section below for details.
  37.  
  38. If none of the above conditions are met, the ATI driver will essentially dis-
  39. able itself to allow other drivers to examine the system.
  40.  
  41. 2.  A note on acceleration
  42.  
  43. The meaning of ``acceleration'', as used in this document, needs to be clari-
  44. fied.  Two of the many components in an accelerator are the CRT controller
  45. (CRTC) and the Draw Engine.  This is in addition to another CRTC that, gener-
  46. ally, is also present in the system (often in the same chip) and typically
  47. provides EGA, VGA or SuperVGA functionality.
  48.  
  49. A CRTC is the component of a graphics controller that is responsible for
  50. reading video memory for output to the screen.  A Draw Engine is an accelera-
  51. tor component that can be programmed to manipulate video memory contents,
  52. thus freeing the CPU for other tasks.
  53.  
  54. When the VGA CRTC is used, all drawing operations into video memory are the
  55. responsibility of the system's CPU, i.e. no Draw Engine can be used.  On the
  56. other hand, if the accelerator's CRTC is chosen to drive the screen, the Draw
  57. Engine can also be used for drawing operations, although the CPU can still be
  58. used for this purpose if it can access the accelerator's video memory.
  59.  
  60. Video acceleration refers to the programming of an accelerator's Draw Engine
  61. to offload drawing operations from the CPU, and thus also implies the use of
  62. the accelerator's CRTC.
  63.  
  64. 3.  Current implementation for ATI adapters
  65.  
  66. The driver currently supports the SuperVGA capabilities of all ATI adapters
  67. except some early Mach8 and Mach32 adapters that do not provide the required
  68. functionality.  This support works for monochrome, 16-colour and 256-colour
  69. video modes, if one of the following ATI graphics controller chips is pre-
  70. sent:
  71.  
  72.      VGAWonder series:  18800, 18800-1, 28800-2, 28800-4, 28800-5, 28800-6
  73.         Mach32 series:  68800-3, 68800-6, 68800AX, 68800LX
  74.         Mach64 series:  88800GX-C, 88800GX-D, 88800GX-E, 88800GX-F, 88800CX,
  75.                         264CT, 264ET, 264VT, 264GT (3D Rage), 264VT-B, 264VT3,
  76.                         264VT4, 264GT-B (3D Rage II), 3D Rage IIc, 3D Rage Pro,
  77.                         3D Rage LT, 3D Rage LT Pro, 3D Rage XL, 3D Rage XC,
  78.                         3D Rage Mobility (including the -M and -P variants)
  79.  
  80. The driver also supports 32K, 64K and 16M-colour modes on the 264xT and 3D
  81. Rage series of adapters using the accelerator CRTC (but not the VGA CRTC).
  82.  
  83. The newer Rage 128 and Radeon chips are not yet supported by this driver.
  84. Rage 128's and Radeon's are, however, supported by separate drivers, and own-
  85. ers of such adapters should consult the documentation provided with these
  86. drivers.  This driver will also invoke the appropriate driver if it finds
  87. Rage 128 and/or Radeon adapter(s) in the system.
  88.  
  89. Adapters based on the above chips have been marketed under a rather large
  90. number of names over the years.  Among them are:
  91.  
  92.      VGAWonder series:  VGAWonder V3, VGAWonder V4, VGAWonder V5, VGAWonder+,
  93.                         VGAWonder XL, VGAWonder XL24, VGAWonder VLB, VGA Basic,
  94.                         VGA Basic 16, VGA Edge, VGA Edge 16, VGA Integra,
  95.                         VGA Charger, VGAStereo F/X, VGA 640, VGA 800, VGA 1024,
  96.                         VGA 1024D, VGA 1024 XL, VGA 1024 DXL, VGA 1024 VLB
  97.          Mach8 series:  Graphics Ultra, Graphics Vantage, VGAWonder GT
  98.                         (None of the 8514/Ultra and 8514 Vantage series is
  99.                          supported at this time)
  100.         Mach32 series:  Graphics Ultra+, Graphics Ultra Pro, Graphics Wonder,
  101.                         Graphics Ultra XLR, Graphics Ultra AXO, VLB mach32-D,
  102.                         PCI mach32-D, ISA mach32
  103.         Mach64 series:  Graphics Xpression, Graphics Pro Turbo, WinBoost,
  104.                         WinTurbo, Graphics Pro Turbo 1600, Video Xpression,
  105.                         3D Xpression, Video Xpression+, 3D Xpression+,
  106.                         3D Charger, Video Charger, WinCharger, All-In-Wonder,
  107.                         All-In-Wonder PRO, 3D Pro Turbo, XPERT@Play,
  108.                         XPERT@Play 98, XPERT@Work, XPERT 98, XPERT LCD,
  109.                         XPERT XL
  110.  
  111. Also, a number of mainboards, laptops and notebooks harbour a Mach32 or
  112. Mach64 controller.
  113.  
  114. VGAWonder, Mach8 and Mach32 ISA adapters are available with or without a
  115. mouse.
  116.  
  117. These adapters are available with a variety of clock generators and RAMDACs.
  118. The 264xT and 3D Rage series of chips are integrated controllers, meaning
  119. that they include a programmable clock generator and a RAMDAC.
  120.  
  121. For all but Mach64 adapters, this driver still does not provide support for
  122. accelerated drawing to the screen.  This means that all drawing is done by
  123. the CPU, rather than by any accelerator present in the system.  This can make
  124. opaque moves, for example, quite ``jerky''.  Also, given that IBM 8514/A and
  125. ATI Mach8 do not allow CPU access to their frame buffer, the driver will cur-
  126. rently ignore these accelerators.  Most Mach32 adapters provide both acceler-
  127. ated function and SuperVGA functionality, but the driver currently only uses
  128. the VGA.
  129.  
  130. The driver does however support the accelerator CRTC present in all ATI
  131. Mach64 adapters.  For 256-colour, and higher depth modes, this support will
  132. be used by default, although an XF86Config option can be specified to use the
  133. SuperVGA CRTC instead.  A linear video memory aperture is also available in
  134. 256-colour and higher depth modes and enabled by default if a 264xT or 3D
  135. Rage controller is detected or, on 88800 controllers, if the accelerator CRTC
  136. is used.  XF86Config options are available to disable this aperture, or (for
  137. non-PCI adapters) enable it or move it to some other address.
  138.  
  139. By default, the driver provides some acceleration for Mach64 if the accelera-
  140. tor CRTC is used, and modes whose colour depth greater than or equal to 8 are
  141. to be used.  This support is as yet incomplete and can be disabled entirely
  142. with an XF86Config option.
  143.  
  144. On non-Intel platforms, the driver can, currently, only support PCI Mach64
  145. adapters.
  146.  
  147. 4.  Current implementation of generic VGA support for non-ATI adapters
  148.  
  149. Support for generic VGA with non-ATI adapters is also implemented, but has
  150. undergone only limited testing.  The driver will intentionally disallow the
  151. use of this support with ATI adapters.  This support must be explicitly
  152. requested through an XF86Config ChipSet specification.  This prevents the
  153. current VGA generic driver from being disabled.
  154.  
  155. This driver's generic VGA support is intended as an extension of that pro-
  156. vided by the current generic driver.  Specifically, within the architectural
  157. bounds defined by IBM's VGA standard, this driver will allow the use of any
  158. 256-colour mode, and any dot clock frequencies both of which allow for many
  159. more mode possibilities.
  160.  
  161. The driver will enforce the following limitations derived from IBM's original
  162. VGA implementation:
  163.  
  164.    o There can only be a set of four (non-programmable) clocks to choose
  165.      from.
  166.  
  167.    o Video memory is limited to 256kB in monochrome and 16-colour modes.
  168.  
  169.    o Video memory is limited to 64kB in 256-colour modes.
  170.  
  171.    o Interlaced modes are not available.
  172.  
  173.    o Colour depths higher than 8 are not available.
  174.  
  175. 5.  XF86Config specifications
  176.  
  177. The driver recognises a number of XF86Config options.  In general, all such
  178. options should be specified in a ``Device'' section, and affect only that
  179. ``Device'' section.
  180.  
  181. Those options that affect how the driver associates adapters with ``Device''
  182. sections are described first.  The driver will ignore (with a message) a
  183. ``Device'' section if the section cannot be associated with exactly one
  184. adapter in the system.  Similarly, the driver will ignore, or disable, (with
  185. a message) any adapter that cannot be associated with exactly one ``Device''
  186. section.  Thus, these options will be required in those uncommon cases where
  187. such unique associations cannot automatically be made by the driver.
  188.  
  189. Other options affect the driver's operation once an adapter has been assigned
  190. to the ``Device'' section which contains them.
  191.  
  192. 5.1  Driver ``ati''
  193.  
  194. The use of this specification is highly recommended if the ``Device'' section
  195. is to be recognised by the driver.  In fact, it is almost (but not quite)
  196. mandatory, particularly when using the loader server as it indicates what
  197. driver is to be loaded and associated with the ``Device'' section.
  198.  
  199. 5.2  ChipSet ``name''
  200.  
  201. The default ChipSet name for this driver is ``ati''.  In this case, any ATI
  202. adapter can be associated with the ``Device'' section.  If an ATI accelerator
  203. is detected and the driver supports it, the accelerator's CRTC will be used
  204. to drive the screen.  Otherwise, the driver will programme the adapter's
  205. SuperVGA CRTC.
  206.  
  207. If ``ativga'' is specified instead, the driver will ignore any ATI accelera-
  208. tor it detects, but otherwise operate as if ``ati'' had been specified.  This
  209. specification ensures the VGA CRTC is used.
  210.  
  211. A ChipSet name of ``ibmvga'' causes any VGA-capable adapter in the system to
  212. be associated with the ``Device'' section.  It enables the driver's generic
  213. VGA support, but only for non-ATI adapters.  If an ATI adapter is associated
  214. with the ``Device'' section, the driver will operate as if ``ativga'' had
  215. been specified instead.
  216.  
  217. A ChipSet name of ``vgawonder'' is equivalent to ``ativga'', except that only
  218. VGAWonder-capable adapters can be assigned to the ``Device'' section.  This
  219. specifically excludes the newer integrated Mach64 controllers.
  220.  
  221. In some PCI or AGP systems, the driver will not, by default, probe for non-
  222. PCI Mach32's or Mach64's.  This is because, before doing any such probe, the
  223. driver attempts to determine if the probe can cause a lockup.  If the driver
  224. has enough information to determine that a lockup would occur, it will skip
  225. the probe.  In some situations, this determination cannot be accurate, and
  226. the driver will err on the side of caution, skipping the probe.  Specifying a
  227. ChipSet name of ``mach32'' or ``mach64'', as appropriate, will force the
  228. driver to probe for the non-PCI adapter.  These ChipSet names should, there-
  229. fore, only be used when there is in fact such an adapter in the system.  They
  230. are otherwise equivalent to ``ati''.
  231.  
  232. On non-Intel platforms, only ``ati'' and ``mach64'' ChipSet values are opera-
  233. tive.
  234.  
  235. 5.3  ChipID & ChipRev specifications
  236.  
  237. These specifications will cause the driver to associate the ``Device'' sec-
  238. tion only with an adapter having the same attributes, or an adapter whose PCI
  239. device ID the driver does not recognise.  In the second case, these options
  240. cause the driver to treat the adapter as if it was one with the specified PCI
  241. device ID or revision.  ChipID can only be used with Mach32 or Mach64
  242. adapters, and, thus, specifically excludes any other adapter from matching
  243. the ``Device'' section.  ChipRev is meaningful only with Mach64 adapters, and
  244. then only if ChipID is also specified in the same ``Device'' section.
  245.  
  246. 5.4  IOBase
  247.  
  248. This option limits the adapters that can be associated with the ``Device''
  249. section to the one with the specified I/O base.  This option only applies to
  250. Mach64 adapters and specifically excludes other adapters.
  251.  
  252. 5.5  BusID
  253.  
  254. This option limits the adapters that can be associated with the ``Device''
  255. section to the one with the specified PCI Bus ID.  This specification
  256. excludes non-PCI adapters.
  257.  
  258. 5.6  Clocks
  259.  
  260. For the purpose of specifying a clock line in your XF86Config, one of four
  261. different situations can occur, as follows.
  262.  
  263. Those configuring the driver's generic VGA support for a non-ATI adapter, can
  264. skip ahead to the ``Clocks for non-ATI adapters'' section below.  Those not
  265. trying to configure the driver for a Mach64 adapter, can skip ahead to the
  266. ``Clocks for fixed clock generators on ATI adapters'' section below.
  267.  
  268. The very earliest Mach64 adapters use fixed (i.e. non-programmable) clock
  269. generators.  Very few of these (mostly prototypes) are known to exist, but if
  270. you have one of these, you can also skip ahead to the ``Clocks for fixed
  271. clock generators on ATI adapters'' section below.
  272.  
  273. The two cases that are left deal with programmable clock generators, which
  274. are used on the great majority of Mach64 adapters.
  275.  
  276. If you are uncertain which situation applies to your adapter, you can run a
  277. clock probe with the command ``X -probeonly''.
  278.  
  279. 5.6.1  Clocks for supported programmable clock generators
  280.  
  281. At bootup, video BIOS initialisation programmes an initial set of frequen-
  282. cies.  Two of these are reserved to allow the setting of modes that do not
  283. use a frequency from this initial set.  One of these reserved slots is used
  284. by the BIOS mode set routine, the other by the particular driver used (e.g.
  285. MS-Windows, AutoCAD, X, etc.).  The clock numbers reserved in this way are
  286. dependent on the particular clock generator used by the adapter.
  287.  
  288. The driver currently supports all programmable clock generators known to
  289. exist on Mach64 adapters.  In this case, the driver will completely ignore
  290. any XF86Config clock specification, and programme the clock generator as
  291. needed by the modes used during the X session.
  292.  
  293. 5.6.2  Clocks for unsupported programmable clock generators
  294.  
  295. This case is unlikely to occur, but is documented for the sake of complete-
  296. ness.
  297.  
  298. In this situation, the driver will probe the adapter for clock frequencies
  299. unless XF86Config clocks are already specified.  In either case, the driver
  300. will then attempt to normalise the clocks to one of the following specifica-
  301. tions:
  302.  
  303.      BIOS setting 1:
  304.  
  305.        Clocks   0.000 110.000 126.000 135.000  50.350  56.640  63.000  72.000
  306.                 0.000  80.000  75.000  65.000  40.000  44.900  49.500  50.000
  307.                 0.000  55.000  63.000  67.500  25.180  28.320  31.500  36.000
  308.                 0.000  40.000  37.500  32.500  20.000  22.450  24.750  25.000
  309.  
  310.      BIOS setting 2:
  311.  
  312.        Clocks   0.000 110.000 126.000 135.000  25.180  28.320  31.500  36.000
  313.                 0.000  80.000  75.000  65.000  40.000  44.900  49.500  50.000
  314.                 0.000  55.000  63.000  67.500  12.590  14.160  15.750  18.000
  315.                 0.000  40.000  37.500  32.500  20.000  22.450  24.750  25.000
  316.  
  317.      BIOS setting 3:
  318.  
  319.        Clocks   0.000   0.000   0.000   0.000  25.180  28.320   0.000   0.000
  320.                 0.000   0.000   0.000   0.000   0.000   0.000   0.000   0.000
  321.                 0.000   0.000   0.000   0.000  12.590  14.160   0.000   0.000
  322.                 0.000   0.000   0.000   0.000   0.000   0.000   0.000   0.000
  323.  
  324. If the driver matches the clocks to the third setting above, functionality
  325. will be extremely limited (assuming the driver works at all).
  326.  
  327. 5.6.3  Clocks for fixed clock generators on ATI adapters
  328.  
  329. This section applies to all VGAWonder and Mach32 adapters, and to early
  330. Mach64 prototypes.
  331.  
  332. One of the following clocks specifications (or an initial subset thereof) can
  333. be used depending on what the adapter uses to generate dot clocks:
  334.  
  335.      Crystals (VGA Wonder V3 and V4 adapters only):
  336.  
  337.        Clocks  50.000  56.644   0.000  44.900  44.900  50.000   0.000  36.000
  338.                25.000  28.322   0.000  22.450  22.450  25.000   0.000  18.000
  339.                16.667  18.881   0.000  14.967  14.967  16.667   0.000  12.000
  340.                12.500  14.161   0.000  11.225  11.225  12.500   0.000   9.000
  341.  
  342.      ATI 18810 clock generator:
  343.  
  344.        Clocks  30.240  32.000  37.500  39.000  42.954  48.771   0.000  36.000
  345.                40.000   0.000  75.000  65.000  50.350  56.640   0.000  44.900
  346.                15.120  16.000  18.750  19.500  21.477  24.386   0.000  18.000
  347.                20.000   0.000  37.500  32.500  25.175  28.320   0.000  22.450
  348.                10.080  10.667  12.500  13.000  14.318  16.257   0.000  12.000
  349.                13.333   0.000  25.000  21.667  16.783  18.880   0.000  14.967
  350.                 7.560   8.000   9.375   9.750  10.739  12.193   0.000   9.000
  351.                10.000   0.000  18.750  16.250  12.586  14.160   0.000  11.225
  352.  
  353.      ATI 18811-0 and ATI 18812-0 clock generators:
  354.  
  355.        Clocks  30.240  32.000 110.000  80.000  42.954  48.771  92.400  36.000
  356.                39.910  44.900  75.000  65.000  50.350  56.640   0.000  44.900
  357.                15.120  16.000  55.000  40.000  21.477  24.386  46.200  18.000
  358.                19.955  22.450  37.500  32.500  25.175  28.320   0.000  22.450
  359.                10.080  10.667  36.667  26.667  14.318  16.257  30.800  12.000
  360.                13.303  14.967  25.000  21.667  16.783  18.880   0.000  14.967
  361.                 7.560   8.000  27.500  20.000  10.739  12.193  23.100   9.000
  362.                 9.978  11.225  18.750  16.250  12.588  14.160   0.000  11.225
  363.  
  364.      ATI 18811-1 and ATI 18811-2 clock generators:
  365.  
  366.        Clocks 135.000  32.000 110.000  80.000 100.000 126.000  92.400  36.000
  367.                39.910  44.900  75.000  65.000  50.350  56.640   0.000  44.900
  368.                67.500  16.000  55.000  40.000  50.000  63.000  46.200  18.000
  369.                19.955  22.450  37.500  32.500  25.175  28.320   0.000  22.450
  370.                45.000  10.667  36.667  26.667  33.333  42.000  30.800  12.000
  371.                13.303  14.967  25.000  21.667  16.783  18.880   0.000  14.967
  372.                33.750   8.000  27.500  20.000  25.000  31.500  23.100   9.000
  373.                 9.978  11.225  18.750  16.250  12.588  14.160   0.000  11.225
  374.  
  375.      ICS 2494-AM clock generators (found on some Dell motherboards):
  376.  
  377.        Clocks  75.000  77.500  80.000  90.000  25.175  28.322  31.500  36.000
  378.               100.000 110.000 126.000 135.000  40.000  44.900  50.000  65.000
  379.                37.500  38.750  40.000  45.000  12.588  14.161  15.750  18.000
  380.                50.000  55.000  63.000  67.500  20.000  22.450  25.000  32.500
  381.                25.000  25.833  26.667  30.000   8.392   9.441  10.500  12.000
  382.                33.333  36.667  42.000  45.000  13.333  14.767  16.667  21.667
  383.                18.750  19.375  20.000  22.500   6.294   7.081   7.875   9.000
  384.                25.000  27.500  31.500  33.750  10.000  11.225  12.500  16.250
  385.  
  386. VGAWonder VLB, VGA 1024 VLB, Mach32 and Mach64 owners should only specify up
  387. to the first 32 frequencies.  Any more will be ignored.
  388.  
  389. Other clock generators that have been used on ATI adapters (which can all be
  390. said to be clones of one of the above) might generate non-zero frequencies
  391. for those that are zero above, or vice-versa.
  392.  
  393. The order of the clocks is very important, although the driver will reorder
  394. the clocks if it deems it appropriate to do so.  Mach32 and Mach64 owners
  395. should note that this order is different than what they would use for previ-
  396. ous XFree86 accelerated servers.
  397.  
  398. 5.6.4  Clocks for non-ATI adapters
  399.  
  400. If no clocks are specified in the XF86Config, the driver will probe for four
  401. clocks, the second of which will be assumed to be 28.322 MHz.  The first
  402. clock will typically be 25.175 MHz, but there are exceptions.  You can
  403. include up to four clock frequencies in your XF86Config to specify the actual
  404. values used by the adapter.  Any more will be ignored.
  405.  
  406. 5.7  Option ``crt_screen''
  407.  
  408. This specification is only effective when the driver detects that the
  409. adapter's BIOS has initialised both the digital flat panel and CRT inter-
  410. faces.  In such a situation, the driver will normally drive both the panel
  411. and the CRT.  This specification causes the driver to disable the digital
  412. flat panel and display the screen image on the CRT instead.
  413.  
  414. 5.8  Option ``noaccel''
  415.  
  416. By default, the driver will accelerate draw operations if a Mach64 CRTC is
  417. used to drive the display.  As implemented in this driver, acceleration does
  418. not require a linear video memory aperture.  This option disables this accel-
  419. eration.
  420.  
  421. 5.9  Option ``nolinear''
  422.  
  423. By default, the driver will enable a linear video memory aperture for
  424. 256-colour and higher depth modes if it is also using a Mach64 accelerator
  425. CRTC or an integrated Mach64 graphics chip.  This option disables this linear
  426. aperture.
  427.  
  428. On non-Intel platforms, the driver requires a linear aperture and, so, this
  429. option is ignored.
  430.  
  431. 5.10  Option ``HWCursor'' and Option ``SWCursor''
  432.  
  433. Option ``HWCursor'', which is the default, specifies that hardware facilities
  434. are to be used to paint the mouse pointer on the screen.  Option ``SWCursor''
  435. specifies that the mouse pointer is to by drawn by software, which is much
  436. slower.  If both options are specified, option ``SWCursor'' prevails.  Cur-
  437. rently, these options are only acted upon for 256-colour or higher depth
  438. modes, if a Mach64 accelerator CRTC, or a Mach64 integrated controller is
  439. being used.  In all other situations, a software cursor will be used.
  440.  
  441. 5.11  Option ``SilkenMouse''
  442.  
  443. This option is only acted upon when a hardware cursor is being used.  It
  444. specifies that the cursor's position on the screen is to be updated as
  445. quickly as possible when the mouse is moved.  This is the default behaviour.
  446. If this option is negated, the cursor may lag the mouse when the X server is
  447. very busy.
  448.  
  449. 5.12  Option ``shadowfb''
  450.  
  451. If this option is enabled, the driver will cause the CPU to do each drawing
  452. operation first into a shadow frame buffer in system virtual memory and then
  453. copy the result into video memory.  If this option is not active, the CPU
  454. will draw directly into video memory.  Enabling this option is beneficial for
  455. those systems where reading from video memory is, on average, slower than the
  456. corresponding read/modify/write operation in system virtual memory.  This is
  457. normally the case for PCI or AGP adapters, and, so, this option is enabled by
  458. default.  For other bus types, the default behaviour is to disable this
  459. option.
  460.  
  461. Note that, due to various limitations, this option is forcibly disabled when
  462. a linear video memory aperture is not enabled, when the frame buffer depth is
  463. less than 8, or when acceleration is used.
  464.  
  465. 5.13  Option ``dpms''
  466.  
  467. This option enables the driver's support for VESA's Display Power Management
  468. Specification.
  469.  
  470. 5.14  Option ``backingstore''
  471.  
  472. This is not specifically a driver option.  It is used to enable the server's
  473. support for backing store, a mechanism by which pixel data for occluded win-
  474. dow regions is remembered by the server thereby alleviating the need to send
  475. expose events to X clients when the data needs to be redisplayed.
  476.  
  477. 5.15  MemBase address
  478.  
  479. This specification is only effective for non-PCI Mach64 adapters, and is used
  480. to override the CPU address at which the adapter will map its video memory.
  481. Normally, for non-PCI adapters, this address is set by a DOS install utility
  482. provided with the adapter.  The MemBase option can also be used to enable the
  483. linear aperture in those cases where ATI's utility was not, or can not be,
  484. used.
  485.  
  486. For PCI and AGP adapters, this address is determined at system bootup accord-
  487. ing to the PCI Plug'n'Play specification which arbitrates the resource
  488. requirements of most devices in the system.  This means the driver can not
  489. easily change the linear aperture address.
  490.  
  491. 5.16  Option ``ReferenceClock'' ``frequency''
  492.  
  493. This option is only applicable to non-Intel platforms, where an adapter BIOS
  494. is not available to the driver.  The option specifies the reference frequency
  495. used by the adapter's clock generator.  The default is 14.318 MHz, and other
  496. typical values are 28.636, or 29.5 MHz.
  497.  
  498. 5.17  ClockChip ``name''
  499.  
  500. This option is only applicable to non-Intel platforms, where an adapter BIOS
  501. is not available to the driver, and the driver cannot reliably determine
  502. whether the clock generator the adapter uses is a variant of an ATI 18818
  503. (a.k.a.  ICS 2595) or an unsupported clock generator.  The only values that
  504. are acted upon are ``ATI 18818-0'' or ``ATI 18818-1''.  From this specifica-
  505. tion, the driver derives a reference divider of 43 or 46 (respectively) for
  506. use in clock programming calculations.  The driver's default behaviour, in
  507. this case, is to assume an unsupported clock generator, which means it will
  508. treat it as a fixed-frequency clock generator, as described under the heading
  509. ``Clocks for unsupported programmable clock generators'' above.
  510.  
  511. 6.  Video modes
  512.  
  513. Mode timings can be derived from the information in XFree86's doc subdirec-
  514. tory.  However, it is no longer required to specify such timings in an
  515. XF86Config's ``Monitor'' section(s), if only standard mode timings are to be
  516. used.  The server automatically inserts VESA standard mode timings in every
  517. ``Monitor'' section, and these modes will be checked first for mode con-
  518. straints (monitor sync tolerances, video memory size, etc.).
  519.  
  520. Furthermore, it is also no longer required to specify mode names in ``Dis-
  521. play'' subsections.  Should no mode names be specified (or those specified do
  522. not yield a usable mode), the server will automatically select as a default
  523. resolution the largest usable mode, whether or not the chosen mode is speci-
  524. fied in the corresponding ``Monitor'' section.
  525.  
  526. For a CRT monitor, you should still specify horizontal sync and vertical
  527. refresh rates in the corresponding ``Monitor'' section.  Otherwise, the
  528. server will default these to those of a VGA monitor, which will limit resolu-
  529. tions to not much more than 640x480 at 72 Hz.  For a digital flat panel, any
  530. sync tolerances should be removed from the corresponding ``Monitor'' section.
  531. The driver will automatically calculate these from the mode that is active on
  532. server entry.  The driver also inserts timings for a mode called "Native
  533. panel mode" that represents the panel's native resolution.
  534.  
  535. 7.  Known problems and limitations
  536.  
  537. There are several known problems or limitations related to the XFree86 ATI
  538. driver.  They include:
  539.  
  540.    o A number of system lockups and blank screens have been reported when
  541.      using PCI Mach64 adapters.  The great majority of these problems have
  542.      been found to be due to system aspects that are unrelated to this
  543.      driver.  As of this writing, these problems can be divided into two gen-
  544.      eral areas:
  545.  
  546.      Improper mouse protocol specification with some recent mice.  Try dif-
  547.      ferent protocol specifications or another mouse.
  548.  
  549.      A system conflict with APM.  This problem is Linux-specific.  There is a
  550.      bug in kernels 2.0.31 or earlier that prevents proper APM operation.
  551.      Upgrade to a more recent kernel or disable APM support in the kernel.
  552.  
  553.    o When using a Mach64's accelerator CRTC, the virtual resolution must be
  554.      less than 8192 pixels wide.  The VGA CRTC further limits the virtual
  555.      resolution width to less than 4096 pixels, or to less than 2048 pixels
  556.      for adapters based on 18800-x's (with 256kB of memory) and on Mach64
  557.      integrated controllers.  These are hardware limits that cannot be cir-
  558.      cumvented.
  559.  
  560.    o Virtual resolutions requiring more than 1MB of video memory (256kB in
  561.      the monochrome case) are not supported by the VGA CRTC on 88800GX and
  562.      88800CX adapters.  This is a hardware limit that cannot be circumvented.
  563.  
  564.    o Due to hardware limitations, doublescanned modes are not supported by
  565.      the accelerator CRTC in 88800GX, 88800CX, 264CT and 264ET adapters.
  566.  
  567.    o The ``VScan'' modeline parameter is only supported when using the VGA
  568.      CRTC.
  569.  
  570.    o Interlaced modes are not supported on 18800-x and 28800-x adapters when
  571.      using a virtual resolution that is 2048 pixels or wider.  When using a
  572.      18800-x with 256kB of video memory in 256-colour modes, this limit is
  573.      reduced to 1024.  This is yet another hardware limitation that cannot be
  574.      circumvented.
  575.  
  576.    o Video memory banking does not work in monochrome and 16-colour modes on
  577.      18800-x adapters.  This appears to be another hardware limit, but this
  578.      conclusion cannot be confirmed at this time.  The driver's default
  579.      behaviour in this case is to limit video memory to 256kB.
  580.  
  581.    o Video memory corruption can still occur during mode switches on 18800-x
  582.      adapters.  Symptoms of this problem include garbled fonts on return to
  583.      text mode, and various effects (snow, dashed lines, etc) on initial
  584.      entry into a graphics mode.  In the first case, the workaround is to use
  585.      some other means of restoring the text font.  On Linux, this can be
  586.      accomplished with the kbd or svgalib packages.  In the second case, xre-
  587.      fresh(1) will usually clean up the image.  No complete solution to this
  588.      problem is currently known.  It appears this corruption occurs due to
  589.      either video memory bandwidth or RAMDAC limitations, and so the driver
  590.      will limit mode clocks to 40MHz.
  591.  
  592.    o There is some controversy over what the maximum allowed clock frequency
  593.      should be on 264xT and 3D Rage adapters.  For now, clocks will, by
  594.      default, be limited to 80MHz, 135MHz, 170MHz, 200MHz or 230MHz, depend-
  595.      ing on the specific controller.  This limit can only be increased (up to
  596.      a driver-calculated absolute maximum) through the DACSpeed specification
  597.      in XF86Config.  Be aware however that doing so is untested and might
  598.      damage the adapter.
  599.  
  600.    o Except as in the previous items, clocks are limited to 80MHz on most
  601.      adapters, although many are capable of higher frequencies.  This will be
  602.      fixed in a future release.
  603.  
  604. Support for the following will be added in a future release:
  605.  
  606.    o Mach32's accelerator CRTC.  This support is the first step towards
  607.      accelerated support for Mach32's, Mach8's, 8514/A's and other clones.
  608.  
  609.    o Colour depth greater than 8 on non-integrated controllers, where permit-
  610.      ted by the hardware.
  611.  
  612.    o Mach32, Mach8 and 8514/A Draw Engines.
  613.  
  614.    o Hardware cursors.
  615.  
  616.    o TVOut, i.e. the ability to use a television screen as a monitor.
  617.  
  618.    o Motion Video, i.e. displaying an asynchronous data stream (TV signal,
  619.      DVD, etc.) in a window or full-screen.
  620.  
  621.    o 3D operations.
  622.  
  623. 8.  Reporting problems
  624.  
  625. If you are experiencing problems that are not already recorded in this docu-
  626. ment, first ensure that you have the latest current release of this driver
  627. and XFree86.  Check the server's log (usually found in
  628. /var/log/XFree86.0.log) and ftp://ftp.xfree86.org/pub/XFree86 if you are
  629. uncertain.
  630.  
  631. Secondly, please check XFree86's doc directory for additional information.
  632.  
  633. Thirdly, do not forget to read http://www.xfree86.org/FAQ.
  634.  
  635. Fourth, a scan through the comp.windows.x.i386unix and comp.os.linux.x news-
  636. groups using your favourite archiving service can also prove useful in
  637. resolving problems.
  638.  
  639. If you are still experiencing problems, you can send me non-HTMLised e-mail
  640. at <tsi@xfree86.org>.  Please be as specific as possible when describing the
  641. problem(s), and include an unedited copy of the server's log and the XF86Con-
  642. fig file used.
  643.  
  644. 9.  Driver history
  645.  
  646. The complete history of the driver is rather cloudy.  The following is more
  647. than likely to be incomplete and inaccurate.
  648.  
  649. Apparently, Per Lindqvist first got a driver working with an early ATI
  650. adapter under X386 1.1a.  This original driver might have actually been based
  651. on a non-functional ATI driver written by Thomas Roell (currently of Xi
  652. Graphics).
  653.  
  654. Then Doug Evans (dje@cygnus.com) added support for the ATI VGA Wonder XL,
  655. trying in the process to make the driver work with all other ATI adapters
  656. available at the time.
  657.  
  658. Rik Faith (faith@precisioninsight.com) obtained the X11R4 driver from Doug
  659. Evans in the summer of 1992 and ported the code to the X386 part of X11R5.
  660. This subsequently became part of XFree86.
  661.  
  662. I (Marc Aurele La France) took over development and maintenance of the driver
  663. in the fall of 1993 after Rik got rid of his VGA Wonder adapter.
  664.  
  665. 10.  Driver versions
  666.  
  667. Due to the introduction of loadable drivers in XFree86 4.0, it has become
  668. necessary to track driver versions separately.  Driver releases use the fol-
  669. lowing version numbering scheme.
  670.  
  671. Version 1 of this driver is the one I inherited from Rik Faith.  This is the
  672. version found in XFree86 2.0 and 2.1.
  673.  
  674. Version 2 is my first rewrite of this code which only ended up being a par-
  675. tially unsuccessful attempt at generalising the driver for all VGA Wonder,
  676. Mach32, and early Mach64 adapters.  Various releases of this version of the
  677. driver can be found in XFree86 2.1.1, 3.1, 3.1.1 and 3.1.2.
  678.  
  679. Version 3 represents my second rewrite (although a rather lame one as
  680. rewrites go).  Into version 3, I introduced clock programming for Mach64
  681. adapters and merged in the old ati_test debugging tool.  This is the version
  682. found in XFree86 3.2, 3.3 and 3.3.1.
  683.  
  684. Version 4 is a rather major restructuring of version 3, which became larger
  685. than I could comfortably handle in one source file.  This is the version
  686. found in XFree86 3.3.2, 3.3.3, 3.3.3.1, 3.3.3.2, 3.3.4, 3.3.5 and 3.3.6.
  687.  
  688. Version 5 is an almost complete restructuring of version 4 to fit in the
  689. newer driver API of XFree86 4.0 and later.
  690.  
  691. The introduction of version 6 is a first swipe at porting the driver to non-
  692. Intel architectures.
  693.  
  694.      Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/ati.sgml,v 3.37 2001/04/16 15:02:08 tsi Exp $
  695.  
  696.