• NAME
  
  mga - Matrox video driver
• SYNOPSIS
  

  
   "Section qDeviceq"
     Identifier \*q  devname q
       Driver \*qmga\*q   ...
  
  
    EndSection 

• DESCRIPTION
  
  mga is an Xorg 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 PseudoColor, GrayScale and
  TrueColor.  Multi-card configurations 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>, and may be on the CD supplied with the card.  That
  module also provides various other enhancements, and may be necessary to
  use the DVI (digital) output on the G550 (and other cards).
  
• SUPPORTED HARDWARE
  
  The
  mga driver supports PCI and AGP video cards based on the following Matrox
  chips.  They are listed in approximate chronological order of production
  (with the most recent chipsets listed last), so consult this list when you
  are unsure whether your card is meant when references are made to (oqG200
  and later(cq chips, for example.
  

  MGA2064W

  MGA1064SG

  Mystique
  

  MGA2164W

  Millennium II
  

  G100

  Productiva G100
  

  G200

  Millennium G200 and Mystique G200
  

  G400

  Millennium G400, Millennium G400 MAX, Millennium G450, and Marvel G450 eTV
  

  G550

  Millennium G550 and Millennium G550 Dual DVI
  

• CONFIGURATION DETAILS
  
  Please refer to xorg.conf(5) for general configuration
  details.  This section only covers configuration details specific to this
  driver.
  
  
  
  The driver auto-detects the chipset type, but the following
  ChipSet names may optionally be specified in the config file
  qDeviceq section, and will override the auto-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
  qDeviceq section.
  
  
  
  The following driver
  Options are supported:
  

  Option \*qColorKey\*q \*q integer q

  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 \*qHWCursor\*q \*q boolean q

  Enable or disable the HW cursor.  Default: on.
  

  Option \*qMGASDRAM\*q \*q boolean q

  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 configurations so this option will often need to be
  specified in multihead configurations.  Default: auto-detected.
  

  Option \*qNoAccel\*q \*q boolean q

  Disable or enable acceleration.  Default: acceleration is enabled.
  

  Option \*qAccelMethod\*q \*q string q

  Chooses between available acceleration architectures.  Valid options are
  XAA and
  EXA. XAA is the traditional acceleration architecture and support for it is very
  stable.  EXA is a newer acceleration architecture with better performance for
  the Render and Composite extensions, but the rendering code for it is newer and
  possibly unstable.  The default is
  XAA.

  Option \*qNoHal\*q \*q boolean q

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

  Option \*qOverclockMem\*q

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

  Option \*qPciRetry\*q \*q boolean q

  Enable or disable PCI retries.  Default: off.
  

  Option \*qRotate\*q \*qCW\*q

  Option \*qRotate\*q \*qCCW\*q

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

  Option \*qShadowFB\*q \*q boolean q

  Enable or disable use of the shadow framebuffer layer.  Default: off.
  

  Option \*qSyncOnGreen\*q \*q boolean q

  Enable or disable combining the sync signals with the green signal.
  Default: off.
  

  Option \*qUseFBDev\*q \*q boolean q

  Enable or disable use of on OS-specific fb interface (and is not supported
  on all OSs).  See fbdevhw(4) for further information.
  Default: off.
  

  Option \*qVideoKey\*q \*q integer q

  This sets the default pixel value for the YUV video overlay key.
  Default: undefined.
  

  Option \*qTexturedVideo\*q \*q boolean q

  This has XvImage support use the texture engine rather than the video
  overlay.  This option is only supported by G200 and later chips, and only
  at 16 and 32 bits per pixel.
  Default: off.
  

  Option \*qOldDmaInit\*q \*q boolean q

  This forces the driver to use the old DMA initialization path for DRI.
  Use this option only to support a older version of the DRI driver with
  a newer DRM (version 3.2 or later).  This option also disables the use
  of direct rendering on PCI cards.
  Default: off.
  

  Option \*qForcePciDma\*q \*q boolean q

  This forces the use of PCI DMA even if AGP DMA could be used.  This
  option is primarily intended for testing purposes, but it could also
  be used on systems with a buggy or poorly function AGP implementation.
  Default: off.
  

• SEE ALSO
  
  Xorg(1) , xorg.conf(5) , 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, Andrew C. Aitchison.
  

Current Users: 102 © 1999-2009 PenguinSoft. All trademarks and copyrights on this page are owned by their respective companies. Linux is a trademark of Linus Torvalds.