mga(4) - NetBSD Manual Pages

MGA(4)			     XFree86			   MGA(4)



NAME

       mga - Matrox video driver


SYNOPSIS

       Section "Device"
	 Identifier "devname"
	 Driver "mga"
	 ...
       EndSection


DESCRIPTION

       mga  is	an  XFree86  driver  for Matrox video cards.  The
       driver is fully accelerated, and provides support for  the
       following  framebuffer  depths: 8, 15, 16, 24, and an 8+24
       overlay mode.  All visual types are supported for depth 8,
       and  both  TrueColor and DirectColor visuals are supported
       for the other depths except 8+24 mode which supports Pseu
       doColor,	 GrayScale  and TrueColor.  Multi-card configura
       tions are supported.  XVideo  is	 supported  on	G200  and
       newer systems, with either TexturedVideo or video overlay.
       The second head of dual-head cards is  supported	 for  the
       G450  and G550.	Support for the second head on G400 cards
       requires a binary-only "mga_hal" module that is	available
       from  Matrox  <http://www.matrox.com>.	That  module also
       provides various other enhancements.


SUPPORTED HARDWARE

       The mga driver supports PCI and AGP video cards	based  on
       the following Matrox chips:

       MGA2064W	   Millennium (original)

       MGA1064SG   Mystique

       MGA2164W	   Millennium II

       G100

       G200	   Millennium G200 and Mystique G200

       G400

       G450

       G550


CONFIGURATION DETAILS

       Please  refer  to  XF86Config(5) for general configuration
       details.	 This section only covers  configuration  details
       specific to this driver.

       The  driver auto-detects the chipset type, but the follow
       ing ChipSet names may optionally be specified in the  con
       fig  file  "Device"  section,  and will override the auto-



4.2.1			     Version				1





MGA(4)			     XFree86			   MGA(4)


       detection:

	   "mga2064w", "mga1064sg", "mga2164w",	 "mga2164w  agp",
	   "mgag100",	"mgag200",   "mgag200	pci",  "mgag400",
	   "mgag550".

       The G450 is Chipset "mgag400" with ChipRev 0x80.

       The driver will auto-detect the	amount	of  video  memory
       present	for  all  chips except the Millennium II.  In the
       Millennium II case it defaults to 4096 kBytes.  When using
       a  Millennium II, the actual amount of video memory should
       be specified with a VideoRam  entry  in	the  config  file
       "Device" section.

       The following driver Options are supported:

       Option "ColorKey" "integer"
	      Set  the	colormap  index used for the transparency
	      key for the depth 8 plane when  operating	 in  8+24
	      overlay  mode.   The  value  must	 be  in the range
	      2-255.  Default: 255.

       Option "HWCursor" "boolean"
	      Enable or disable the HW cursor.	Default: on.

       Option "MGASDRAM" "boolean"
	      Specify whether  G100,  G200  or	G400  cards  have
	      SDRAM.   The  driver  attempts  to auto-detect this
	      based on the card's PCI subsystem ID.  This  option
	      may  be  used to override that auto-detection.  The
	      mga driver is not able to auto-detect the	 presence
	      of of SDRAM on secondary heads in multihead config
	      urations so this option will often need to be spec
	      ified  in multihead configurations.  Default: auto-
	      detected.

       Option "NoAccel" "boolean"
	      Disable or enable acceleration.  Default: accelera
	      tion is enabled.

       Option "NoHal" "boolean"
	      Disable  or  enable  loading  the "mga_hal" module.
	      Default: the module is loaded  when  available  and
	      when using hardware that it supports.

       Option "OverclockMem"
	      Set  clocks  to  values  used by some commercial X-
	      Servers (G100, G200 and G400 only).  Default:  off.

       Option "Overlay"
	      Enable  8+24  overlay  mode.   Only appropriate for
	      depth 24.	 (Note: the G100 is unaccelerated in  the
	      8+24   overlay  mode  due	 to  a	missing	 hardware



4.2.1			     Version				2





MGA(4)			     XFree86			   MGA(4)


	      feature.) Default: off.

       Option "PciRetry" "boolean"
	      Enable or disable PCI retries.  Default: off.

       Option "Rotate" "CW"

       Option "Rotate" "CCW"
	      Rotate the display clockwise  or	counterclockwise.
	      This  mode is unaccelerated.  Default: no rotation.

       Option "ShadowFB" "boolean"
	      Enable or disable use  of	 the  shadow  framebuffer
	      layer.  Default: off.

       Option "SyncOnGreen" "boolean"
	      Enable  or  disable combining the sync signals with
	      the green signal.	 Default: off.

       Option "UseFBDev" "boolean"
	      Enable or disable use of on OS-specific  fb  inter
	      face  (and is not supported on all OSs).	See fbde
	      vhw(4) for further information.  Default: off.

       Option "VideoKey" "integer"
	      This sets the default pixel value for the YUV video
	      overlay key.  Default: undefined.

       Option "TexturedVideo" "boolean"
	      This  has	 XvImage  support  use the texture engine
	      rather than the video overlay.  This option is only
	      supported	 by the G200 and G400, and only in 16 and
	      32 bits per pixel.  Default: off.


SEE ALSO

       XFree86(1), XF86Config(5), xf86config(1), Xserver(1), X(7)


AUTHORS

       Authors	include:  Radoslaw  Kapitan,  Mark Vojkovich, and
       also David Dawes, Guy Desbief, Dirk Hohndel, Doug Merritt,
       Andrew  E.  Mileski,  Andrew  van  der  Stock,  Leonard N.
       Zubkoff.















4.2.1			     Version				3