README revision 17a48c7c 
1$XFree86: xc/programs/Xserver/hw/xfree86/drivers/apm/README,v 1.5 2000/02/11 22:35:55 dawes Exp $
2
3Note 1: This driver is work in progress. It might not work at all.
4Want to help? Docs are at 
5ftp://beta.xfree86.org/pub/xf86/devel/Documentation/apm
6
7This is the Alliance Promotion driver for XFree86 4.0+. It currently only
8supports the AT3D, AT25 chipsets (found on various Voodoo-Rush cards) and AT24.
9There is incomplete support for the 6422. The 6422 chips are supported in the
10XFree86 3.3.x series.
11
12What has worked on my computer :
13    - XAA for 8/16/24/32 bpp
14    - DGA and DGA2
15    - DPMS
16    - glide2x
17    - using as a module
18    - shadow framebuffer
19    - AT3D
20    - AT24
21    - AP6422 (although with problems, including locks)
22    - multi card setup (with and without Xinerama)
23    - Xv images, even with (slightly modified) glide2x ; note that there is
24      still a little problem with vertical offset.
25
26There is some support for PC-98 with the help of Isao Ohishi
27(ohishi@aero.rim.or.jp). It's still under development. I hope that 8bpp
28works correctly.
29
30What has not worked :
31    - I2C (I'm not sure my card, Hercules 128/3D, has proper cabling)
32
33What is untested :
34
35What should be done :
36    - overlays (with the video engine, everything should be overlayable
37      with everything)
38    - (why not) 3210 support
39
40
41       Loïc Grenié
42
43Authors:
44-----------------------------------------------------------------------
45Kent Hamilton    Initial creation.
46Henrik Harmsen   Lots of additions and fixes.  <hch@cd.chalmers.se>
47Loic Grenie      Conversion to 4.0.            <grenie@lami.univ-evry.fr>
48		 Additions and fixes.
49
50
51History:
52-----------------------------------------------------------------------
53Created by Kent Hamilton for Xfree86 from source from Alliance
54
55Modified 1997-06 by Henrik Harmsen
56  - Added support for AT3D
57  - Acceleration added for 8,16,32bpp: (for AT3D and AT24)
58    - Filled rectangles
59    - Screen-screen bitblts
60    - Host-screen color expansion bitblts for text
61  - DPMS support
62  - Enabled hardware cursor code (also in 8bpp)
63  - Set to programmable VCLK clock
64  - Set MCLK to 57.3 MHz on AT3D.
65  - Various bugfixes and cleanups
66
67Modified 1997-07-06 by Henrik Harmsen
68  - Fixed bug that made the HW cursor screw up on VT switches
69  - Probably fixed bug that screwed up the screen when using
70    screen-screen bitblts. This forced me to put an ApmSync() at 
71    the end of ApmSubsequentScreenToScreenCopy() which makes
72    me unhappy... But: Better it works than not...
73
74Modified 1997-10-19 by Henrik Harmsen
75  - HW line drawing.
76  - HW clipping.
77  - Added support for ROP's.
78  - Text acceleration now lots faster and support for accelerated
79    proportional text. (Uses SCANLINE_PAD_DWORD + clipping).
80  - Combined write for many register writes gives good 
81    general speedup. (write x+y as a single 32 bit entity, rather
82    obvious, really...:-)
83  - Now waits for correct number of free slots in FIFO before
84    issuing writes to the card.
85    This seems to have eliminated the last instances of dropped
86    interrupts from serial IO and no more lost packets in PPP :-)
87  - Converted cursor support to use XAA interface.
88  - Fixed ApmSync(). Finally removed call to ApmSync at end of
89    ApmSubsequentScreenToScreenCopy() :-)
90
91Modified 1998-03-29 by Henrik Harmsen
92  - Added DGA support.
93  - Added accel support for AP6422. Fixed AT24 accel support.
94  - Fixed clock register calculation for AP6422 and AT24.
95  - DPMS support for AT24 & AP6422.
96  - 2% faster text accel for AT24/AT3D :-)
97
98Modified 1998-12-18 by Loic Grenie
99  - Converted to Xfree86 4.0 driver interface. (Only support for 
100    AT25/AT3D chips).
101
102Modified 1999-03-14 by Henrik Harmsen
103  - Various fixes to bring it up to 3.9Pd.
104  - Added preliminary (completely untested) support for dynamic 
105    loading.
106
107Modified 1999-07-07 by Loïc Grenié
108  - Converted to new RAC. Support for DGA and DGA2, I2C, Rush extension.
109
110Modified 2000-02-10 by Loïc Grenié
111  - Bug fixes
112  - AP6422 (bugged !)
113  - Xv driver
114