X_W32 1.02, a 256-color X11R6 server for Linux, is a drop-in replacement
for XF86_SVGA.  It can be used for boards with graphics accelerators in
the ET4000/W32 series (currently w32, w32i, w32p_rev_a, w32p_rev_b, and
w32p_rev_c).

The X_W32 code is undergoing a cleanup process, so I'm not releasing the
source.  Please don't ask me for the source code at this moment.  I hope
it will become XF86_W32 in the future; if and when this happens, you'll
get the source.  The code is not specific to Linux.

X_W32 should be pretty stable.  If you have problems with it, direct
them to me and me only.  In all correspondence please follow the format
below:

	Name of board and chip type:
	Amount of memory on the board:
	Description of experience/problems:
	E-mail address:

I may not answer all your messages.  I may not be able to solve your problems
without access to the same hardware you have.


LEGAL STUFF:

You may freely give X_W32 away, but everyone uses X_W32 at his/her own risk, 


PERFORMANCE:

None of the SpeedUp assembly code in XF86_SVGA is present in X_W32; the
absence causes some performance degradation.  In some cases, using the
SpeedUp code is faster than using the w32 accelerator in non-interleaving
mode; in others, the degradation is purely caused by using C code instead
of the faster assembly code.  Furthermore, the accelerator is not currently
used to its fullest potential.  Try some x11perf tests to see this.

Using a 1-M Mirage ET4000/W32 VLB board at 80MHz with a physical of 1024x768
and a virtual of 1152x900 on a 486DX2/66 I got:

TOTAL    169256 lineStones
TOTAL     18529 fillStones
TOTAL     23001 blitStones
TOTAL   3934089 arcStones
TOTAL    205906 textStones
TOTAL     34640 complexStones
TOTAL     43530 xStones

If you perform your own tests with x11perf/xbench, be sure to turn off the
screen saver by doing "xset s off" to avoid overly optimistic results. 

In the Xconfig sample file below, I've provided timing parameters for the
14" Sampo AlphaScan+ in 65-MHz and 80-MHz modes.  You should compute your
own timing parameters if you're using a monitor very different from the
AlphaScan+.  If you use a small monitor (say 14" or maybe even 15"), you
might be able to get away with using 65MHz without noticing any flickers;
this will increase performance.  On larger monitors, you may like to use
an 80-MHz entry.


FILES TO GET:

I've uploaded x_w32.1.02.tar to sunsite.unc.edu.  It contains the following
files:

	readme.w32 (this file)
	w32.lsm
	w32.gz


NOTES:

1.  X_W32 now supports up to 4M.

2.  I'm grabbing 1K for internal use, so X_W32 says 1023K if you have 1M on
your board,

3.  Set X_W32 to suid to root.

4.  If you got a white screen in the past (e.g., with XF86_SVGA), X_W32 could
have fixed the problem. 

5.  The maximum dot clock is set to 80MHz.

6.  X_W32 does NOT support memory interleaving--which is supposed to greatly
improve performance--because I don't have anything to test it with.  If you
want the higher performance badly, DONATE a w32p board (I don't want any
hassles, so no Diamond boards, please) with at least 2M to me.  I'm no longer
interested in promises of loaner boards that have never materialized.


ACKNOWLEDGMENTS:

Jerry J. Shekhel (jerry@msi.com) provided the Mirage ET4000/W32 VLB board
for the development, and the XFree86 Project provided the base for the
code.  Glenn G. Lai did the modifications for the w32. 


Glenn G. Lai
glenn@cs.utexas.edu
7/31/94

-----Sample Xconfig for a 14" SAMPO AlphaScan plus -----

# $XConsortium: Xconfig,v 1.2 91/08/26 14:34:55 gildea Exp $
#
# Copyright 1990,91 by Thomas Roell, Dinkelscherben, Germany.
#
# Permission to use, copy, modify, distribute, and sell this software and its
# documentation for any purpose is hereby granted without fee, provided that
# the above copyright notice appear in all copies and that both that
# copyright notice and this permission notice appear in supporting
# documentation, and that the name of Thomas Roell not be used in
# advertising or publicity pertaining to distribution of the software without
# specific, written prior permission.  Thomas Roell makes no representations
# about the suitability of this software for any purpose.  It is provided
# "as is" without express or implied warranty.
#
# THOMAS ROELL DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
# INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
# EVENT SHALL THOMAS ROELL BE LIABLE FOR ANY SPECIAL, INDIRECT OR
# CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
# DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
# TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
# PERFORMANCE OF THIS SOFTWARE.
#
# Author:  Thomas Roell, roell@informatik.tu-muenchen.de

#
# some nice paths, to avoid conflicts with other X-servers
#
RGBPath		"/usr/X386/lib/X11/rgb"
FontPath	"/usr/X386/lib/X11/fonts/misc/,/usr/X386/lib/X11/fonts/75dpi/"

Keyboard
  AutoRepeat 500 5
#  Xleds      1 2 3
  ServerNumLock
#  DontZap

MouseSystems	"/dev/mouse"
#  BaudRate	9600
#  SampleRate	150
#  Emulate3Buttons

#
# The graphics drivers
#
vga256
# The following are the clocks on a Mirage ET4000/W32 VLB board
#clocks	25 28 32.5 36 40 45 32.5 37.50
#	50 56 65   72 80 90 65   75	
	
  Virtual	1152 900
  ViewPort      0 0
  Modes	"1024x768"

ModeDB
	
# For the 14" Sample AlphaScan+ 
"1024x768"	65	1024 1072 1136 1320	768  770  774  805
#"1024x768"	80	1024 1136 1340 1432	768  770  774  805