1. MX86251linux.zip Driver
2. README File Contents

README Driver File Contents (MX86251linux.zip)

***********************************************************************
  XFree86 Server for Macronix MX86250 and MX86251+3Dfx Voodoo Rush

  Stephen H.L.Wang (¤ýÂE¨})
  Macronix International Co., Ltd.

				         		  Jan 9, 1998
***********************************************************************


1. Chips supported

    This driver support both "MX86250" and "MX86251+3Dfx Voodoo Rush" card.



2. How to install 

    There are two versions of XFree86 Server for MX8625x included 
in this package: source code version and ELF binary version.

    1. If you have XFree86 LinkKit installed, I suggest that you
       rebuild Server from source code, this is the best way to setup
       XFree86 Server to fit your environment.

       To rebuild XFree86 Server from source code with LinkKit, follows
       the following steps:

	a. Assume the root directory of the LinkKit is located at
           "/usr/X11R6/lib/Server/" and the 256 color Server source code
	   root is located at "/usr/X11R6/lib/Server/drivers/vga256/", 
	   create a directory "mxic" under "/usr/X11R6/lib/Server/drivers/vga256/".

	b. Change current directory to the created directory, i.e. type
           "cd /usr/X11R6/lib/Server/drivers/vga256/mxic" at shell prompt.

	c. Copy the following files (included in this package) to this directory:
		mxic_bank.s
		mxic_driver.c
		Imakefile

	d. Change current directory to "/usr/X11R6/lib/Server/" and edit file
	   xf86site.def.

	e. Search for string "XF86SvgaDrivers", this is a C style define macro to
	   specify which Servers are going to be linked to SVGA Server, every Server 
	   are sparated by blanks.

	f. Add "mxic" to be the first Server then save file and quit editor to shell prompt.

	g. Type 
		./mkmf; make clean; make; make install

	h. Wait until build process finished, if there is (should be) no error,
	   the SVGA Server is installed.  

	i. If you previously do not use a SVGA Server, you have to change default Server 
	   to be SVGA Server.  You better run "/usr/X11/bin/xf86config" again. 
	   On questioning about type of RAMDAC, choose Normal RAMDAC;  On questioning
	   about type of Clock Chip, do not choose any one of them, just skip. 


    2. If you do not have LinkKit installed or you would not like to go through the 
       rebuild process, you can try the ELF binary version (file "XF86_SVGA") 
       included in the package, just copy this file to directory "/usr/X11/bin/".
       I build this ELF binary version at XFree86 3.3 in Linux, so be sure you have 
       XFree86 3.3 installed in order to use this driver.
       However, I do not guarantee it will work at your environment, if this is the case,
       you may rebuild from source code following the steps described above.



3. Support Linux and FreeBSD?

    I have tested this driver for XFree86 which included in both Linux and FreeBSD,
the 8BPP mode works fine in these two environments. 



4. Known bugs

    This revision cannot run in 16BPP or higher BPPs mode of XFree86 3.3.



5. Package revisions

    0.1alpha:

       1. This version does not support hardware acceleration, the hardware accelerated
          version is under development.  But because I write this driver at my spare
          time, there will be no schedule for the next revision to come out.
       2. Use predefined values of programmable VCG to simluate indexed clock selection.
       3. Currently this version only support 8BPP for XFree86 3.3, 16BPP and higher BPPs
          fail to work.  But for XFree86 3.1, this version seems to work fine in all BPPs.



6. Customer support

    The XFree86 Server driver for MX8625x is not officially supported by Video Group of 
Macronix Co., Ltd.  I write this driver out of my PERSONAL interest in Linux and X Window.

    Anyway, if you have any trouble on using this XFree86 Server driver, you can visit our 
Web Site http://www.macronix.com and look for newer driver or ask support for MX86250 and 
MX86251.  I will try my best to revise this driver only if I have my spare time.