


XF86_SVGA(1)					     XF86_SVGA(1)


NAME
       XF86_SVGA  -  non-accelerated SVGA X Window System servers
       for UNIX on x86 platforms

SYNOPSIS
       XF86_SVGA [:displaynumber] [ option ] ...

DESCRIPTION
       XF86_SVGA is an 8-bit PseudoColor,  16-bit  TrueColor  and
       24-bit  TrueColor  server  for  Super-VGA  cards.   It  is
       derived from the X386 server provided with  X11R5.   Note:
       16-bit  and  24-bit  TrueColor is currently only supported
       for some Cirrus chips.

CONFIGURATIONS
       The XF86_SVGA server supports the following popular Super-
       VGA chipsets in 256 color mode.	Virtual resolutions up to
       (approximately) 1152x900 are supported, using (up to)  1Mb
       of  display  memory.  The Western Digital WD90C33 and some
       of the Cirrus chipsets support up to 2Mb of display memory
       and  virtual resolutions of 1280x1024 and higher.  Some of
       the Cirrus chipsets also support 16bpp  and  32bpp  (true-
       color) modes on certain configurations.	Generic VGA cards
       are also supported at 8bpp 320x200 only.

	    ATI:
		18800,	18800-1,   28800-2,   28800-4,	 28800-5,
		28800-6,   68800-3,  68800-6,  68800AX,	 68800LX,
		88800

	    Tseng:
		ET3000, ET4000, ET4000/W32

	    Western Digital:
		PVGA1,	WD90C00,   WD90C10,   WD90C11,	 WD90C30,
		WD90C31, WD90C33

	    Genoa:
		GVGA

	    Trident:
		TVGA8800CS,   TVGA8900B,  TVGA8900C,  TVGA8900CL,
		TVGA9000

	    NCR:
		77C22, 77C22E

	    Cirrus Logic:
		CLGD5420, CLGD5422, CLGD5424, CLGD5426, CLGD5428,
		CLGD5429, CLGD5430, CLGD5434, CLGD6205, CLGD6215,
		CLGD6225,  CLGD6235,  CL6410,	CL6412,	  CL6420,
		CL6440





XFree86			  Version 3.1.1				1





XF86_SVGA(1)					     XF86_SVGA(1)


	    Compaq:
		AVGA

	    Oak:
		OTI067, OTI077, OTI087

	    Avance Logic:
		AL2101, ALI2301, ALI2302, ALI2308, ALI2401

	    Chips & Technology:
		65520, 65530, 65540, 65545

	    MX:
		MX68000, MX68010

	    Video7:
		HT216-32

       Accelerated  support  is	 included  for most of the Cirrus
       chipsets, and for the Western Digital WD90C31 and  WD90C33
       chipsets.   Accelerated	support	 for  the  ET4000/W32  is
       implemented in a separate server (see XF86_W32(1)).  Users
       of  boards based on ATI's Mach8 and Mach32 chipsets should
       refer  to  the  XF86_Mach8(1)  and  XF86_Mach32(1)  manual
       pages, respectively.

OPTIONS
       In  addition to the normal server options described in the
       Xserver(1) manual page, XF86_SVGA accepts some  more  com-
       mand  line  switches,  as described in the XFree86(1) man-
       page.

SETUP
       XFree86 uses a configuration file  called  XF86Config  for
       its  initial  setup.   See the XF86Config(4/5) manpage for
       general details. Here only the  XF86_SVGA  specific  parts
       are explained.

       This  server  requires  a Screen section in the XF86Config
       file with the Driver entry set to svga.

       Entries for the Device  section	in  the	 XF86Config  file
       include:














XFree86			  Version 3.1.1				2





XF86_SVGA(1)					     XF86_SVGA(1)


       chipset "name"
	       specifies  a  chipset so the correct driver can be
	       used.  Possible chipsets are:


		      ATI:
			  vgawonder

		      Tseng:
			  et3000, et4000, et4000w32,  et4000w32i,
			  et4000w32p

		      Western Digital:
			  pvga1,   wd90c00,   wd90c10,	 wd90c30,
			  wd90c31, wd90c33

		      Genoa:
			  gvga

		      Trident:
			  tvga8800cs,	 tvga8900b,    tvga8900c,
			  tvga8900cl, tvga9000

		      NCR:
			  ncr77c22, ncr77c22e

		      Cirrus Logic:
			  clgd5420, clgd5422, clgd5424, clgd5426,
			  clgd5428, clgd5429, clgd5430, clgd5434,
			  clgd6205, clgd6215, clgd6225, clgd6235,
			  cl6410, cl6412, cl6420, cl6440

		      Compaq:
			  cpq_avga

		      OAK:
			  oti067, oti077, oti087

		      Avance Logic:
			  al2101,  ali2301,   ali2302,	 ali2308,
			  ali2401

		      Chips & Technology:
			  ct65520, ct65530, ct65540, ct65545

		      MX:
			  mx

		      Video7:
			  video7

		      Generic:
			  generic




XFree86			  Version 3.1.1				3





XF86_SVGA(1)					     XF86_SVGA(1)


       Option "optionstring"
	       allows the user to select certain options provided
	       by the drivers.	Currently the  following  strings
	       are recognized:

	       legend  -  for  Sigma  Legend ET4000-based boards.
	       This  option  enables  a	 special  clock-selection
	       algorithm used on Legend boards, and MUST be spec-
	       ified for these boards to function correctly.

	       swap_hibit - for Western	 Digital/PVGA1	chipsets.
	       Some  Western  Digital  based  boards  require the
	       high-order clock-select lead to be  inverted.   It
	       is  not	possible for the server to determine this
	       information at run-time.	 If the 9th clock in  the
	       list of clocks detected by the server is less than
	       30Mhz, this option likely needs to be set.

	       hibit_low, hibit_high - for Tseng ET4000 chipsets.
	       With  some ET4000 cards, the server has difficulty
	       getting the state of the high-order clocks  select
	       bit right when started from a high-resolution text
	       mode.  These options  allow  the	 correct  initial
	       state  of  that	bit to be specified.  To find out
	       what the	 correct  initial  state  is,  start  the
	       server  from  an	 80x25 text mode.  This option is
	       only needed if the clocks reported by  the  server
	       when started from a high-resolution text mode dif-
	       fer from those reported when it is started from an
	       80x25 text mode.

	       8clocks	-  for the PVGA1 chipset the default is 4
	       clocks.	Some cards with this chipset may  support
	       8  clocks.   Specifying this option will allow the
	       driver to detect and use the extra clocks.

	       16clocks	 -  for	 Trident  TVGA8900B   and   8900C
	       chipsets.  Some newer boards using 8900B and 8900C
	       chipsets actually support 16  clocks  rather  than
	       the  standard  8	 clocks.  Such boards will have a
	       "TCK9002" or "TCK9004" chip on  them.   Specifying
	       this  option  will  allow the driver to detect and
	       use the extra 8 clocks.

	       probe_clocks - for Cirrus  chipsets.   The  Cirrus
	       driver has a fixed set of clocks that are normally
	       used.   Specifying  this	 option	 will  force  the
	       driver  to  probe  for clocks instead of reporting
	       the built-in defaults.  This option is for  debug-
	       ging purposes only.

	       power_saver  -  This  option enables the server to
	       use the power saving feature of	"green"	 monitors
	       instead	of  blanking  when  the	 screen	 saver is



XFree86			  Version 3.1.1				4





XF86_SVGA(1)					     XF86_SVGA(1)


	       activated.  This option is experimental.

	       noaccel - for Cirrus and WD chipsets.  This option
	       disables	  the	accelerated   features	 for  the
	       clgd5426, clgd5428, wd90c31 and wd90c33	chipsets.

	       fifo_conservative  -  for  Cirrus  chipsets.  This
	       option sets the CRT FIFO threshold to a	conserva-
	       tive  value  for	 dot  clocks  above  65MHz.  This
	       reduces performance, but may help  in  eliminating
	       problems	 with  ``streaks''  on	the screen during
	       BitBLT operations

	       fifo_aggressive	-  for	Cirrus	chipsets.    This
	       option  sets  the CRT FIFO threshold to an aggres-
	       sive value for dot clocks above 65MHz.	This  may
	       increase performance.

	       slow_dram - for Cirrus chipsets.	 This option sets
	       the DRAM timings for slow DRAM chips.

	       fast_dram - for ET4000 and Cirrus chipsets.   This
	       option  sets the DRAM timings for fast DRAM chips.

	       no_2mb_banksel - for Cirrus chipsets.  This option
	       is  required for Cirrus cards with 2MB of videoram
	       which is in the form of	512kx8	DRAMs  (4  chips)
	       rather than 256kx4 DRAMs (16 chips).

	       no_bitblt - for Cirrus chipsets.	 This option dis-
	       ables use of hardware BitBLT.

	       linear - Attempt a linear mapping  of  the  frame-
	       buffer  into high memory. Currently only supported
	       for some Cirrus configurations.

	       med_dram, favour_bitblt, sw_cursor,  clgd6225_lcd,
	       mmio  -	more  Cirrus-specific  options.	 Refer to
	       /usr/X11R6/lib/X11/doc/README.cirrus	for	a
	       detailed description of Cirrus options.

       speedup "selection"
	       sets  the  selection  of	 SpeedUps  to  use.   The
	       optional selection string can take  the	following
	       values:

		    none
		    all

	       If  the	selection  string  is  omitted, or if the
	       speedup option is omitted, the selection	 defaults
	       to  "all".   Some of the SpeedUps can only be used
	       with the ET4000, WD90C31 and WD90C33 chipsets  and
	       others  requires	 a virtual resolution with a xdim



XFree86			  Version 3.1.1				5





XF86_SVGA(1)					     XF86_SVGA(1)


	       of 1024.	 SpeedUps that won't work  with	 a  given
	       configuration are automatically disabled.

       nospeedup
	       disables	 the SpeedUp code.  This is equivalent to
	       speedup "none".

       Note that XFree86 has some internal capabilities to deter-
       mine  what  hardware  it	 is running on. Thus normally the
       keywords chipset, clocks, and videoram don't  have  to  be
       specified.   But	 there may be occasions when this autode-
       tection mechanism fails, (for example, too high of load on
       the  machine  when  you start the server).  For cases like
       this, one  should  first	 run  XF86_SVGA	 on  an	 unloaded
       machine,	 look  at  the results of the autodetection (that
       are printed out during server startup) and then explicitly
       specify these parameters in the configuration file.  It is
       recommended that all parameters, especially Clock  values,
       be specified in the XF86Config file.

FILES
       <XRoot>/bin/XF86_SVGA	     The SVGA color X server

       /etc/XF86Config		     Server configuration file

       <XRoot>/lib/X11/XF86Config    Server configuration file

       <XRoot>/lib/X11/doc/README.ati
				     Extra  documentation for the
				     ATI vgawonder driver

       <XRoot>/lib/X11/doc/README.cirrus
				     Extra documentation for  the
				     Cirrus driver

       <XRoot>/lib/X11/doc/README.trident
				     Extra  documentation for the
				     Trident driver

       <XRoot>/lib/X11/doc/README.tseng
				     Extra documentation for  the
				     ET4000 and ET3000 drivers

       <XRoot>/lib/X11/doc/README.Oak
				     Extra  documentation for the
				     Oak driver

       <XRoot>/lib/X11/doc/README.Video7
				     Extra documentation for  the
				     Video7 driver

       <XRoot>/lib/X11/doc/README.WstDig
				     Extra  documentation for the
				     WD/PVGA driver



XFree86			  Version 3.1.1				6





XF86_SVGA(1)					     XF86_SVGA(1)


       Note: <XRoot> refers to the root of the X11 install  tree.

SEE ALSO
       X(1),	 Xserver(1),	 XFree86(1),	 XF86Config(4/5),
       xf86config(1), xdm(1), xinit(1)

BUGS
       There are no known bugs at this time, although we  welcome
       reports emailed to the address listed below.

CONTACT INFO
       XFree86	 source	  is   available  from	the  FTP  servers
       ftp.XFree86.org.	 Send email  to	 XFree86@XFree86.org  for
       details.

AUTHORS
       Refer to the XFree86(1) manual page.








































XFree86			  Version 3.1.1				7


