1mga(4) Kernel Interfaces Manual mga(4)
2
6 mga - Matrox video driver
7
9 Section "Device"
10 Identifier "devname"
11 Driver "mga"
12 ...
13 EndSection
14
16 mga is an Xorg driver for Matrox video cards. The driver is fully
17 accelerated, and provides support for the following framebuffer depths:
18 8, 15, 16, 24, and an 8+24 overlay mode. All visual types are sup‐
19 ported for depth 8, and both TrueColor and DirectColor visuals are sup‐
20 ported for the other depths except 8+24 mode which supports Pseudo‐
21 Color, GrayScale and TrueColor. Multi-card configurations are sup‐
22 ported. XVideo is supported on G200 and newer systems, with either
23 TexturedVideo or video overlay. The second head of dual-head cards is
24 supported for the G450 and G550. Support for the second head on G400
25 cards requires a binary-only "mga_hal" module that is available from
26 Matrox <http://www.matrox.com>, and may be on the CD supplied with the
27 card. That module also provides various other enhancements, and may be
28 necessary to use the DVI (digital) output on the G550 (and other
29 cards).
30
32 The mga driver supports PCI and AGP video cards based on the following
33 Matrox chips. They are listed in approximate chronological order of
34 production (with the most recent chipsets listed last), so consult this
35 list when you are unsure whether your card is meant when references are
36 made to ‘G200 and later’ chips, for example.
37 MGA2064W
39 MGA1064SG
41 Mystique
42 MGA2164W
44 Millennium II
45 G100 Productiva G100
47 G200 Millennium G200 and Mystique G200
49 G400 Millennium G400, Millennium G400 MAX, Millennium G450, and Mar‐
51 vel G450 eTV
52 G550 Millennium G550 and Millennium G550 Dual DVI
54
56 Please refer to xorg.conf(5) for general configuration details. This
57 section only covers configuration details specific to this driver.
58 The driver auto-detects the chipset type, but the following ChipSet
60 names may optionally be specified in the config file "Device" section,
61 and will override the auto-detection:
62 "mga2064w", "mga1064sg", "mga2164w", "mga2164w agp", "mgag100",
64 "mgag200", "mgag200 pci", "mgag400", "mgag550".
65 The G450 is Chipset "mgag400" with ChipRev 0x80.
67 The driver will auto-detect the amount of video memory present for all
69 chips except the Millennium II. In the Millennium II case it defaults
70 to 4096 kBytes. When using a Millennium II, the actual amount of video
71 memory should be specified with a VideoRam entry in the config file
72 "Device" section.
73 The following driver Options are supported:
75 Option "ColorKey" "integer"
77 Set the colormap index used for the transparency key for the
78 depth 8 plane when operating in 8+24 overlay mode. The value
79 must be in the range 2-255. Default: 255.
80 Option "HWCursor" "boolean"
82 Enable or disable the HW cursor. Default: on.
83 Option "MGASDRAM" "boolean"
85 Specify whether G100, G200 or G400 cards have SDRAM. The driver
86 attempts to auto-detect this based on the card's PCI subsystem
87 ID. This option may be used to override that auto-detection.
88 The mga driver is not able to auto-detect the presence of of
89 SDRAM on secondary heads in multihead configurations so this
90 option will often need to be specified in multihead configura‐
91 tions. Default: auto-detected.
92 Option "NoAccel" "boolean"
94 Disable or enable acceleration. Default: acceleration is
95 enabled.
96 Option "AccelMethod" "string"
98 Chooses between available acceleration architectures. Valid
99 options are XAA and EXA. XAA is the traditional acceleration
100 architecture and support for it is very stable. EXA is a newer
101 acceleration architecture with better performance for the Render
102 and Composite extensions, but the rendering code for it is newer
103 and possibly unstable. The default is XAA.
104 Option "NoHal" "boolean"
106 Disable or enable loading the "mga_hal" module. Default: the
107 module is loaded when available and when using hardware that it
108 supports.
109 Option "OverclockMem"
111 Set clocks to values used by some commercial X Servers (G100,
112 G200 and G400 only). Default: off.
113 Option "PciRetry" "boolean"
115 Enable or disable PCI retries. Default: off.
116 Option "Rotate" "CW"
118 Option "Rotate" "CCW"
120 Rotate the display clockwise or counterclockwise. This mode is
121 unaccelerated. Default: no rotation.
122 Option "ShadowFB" "boolean"
124 Enable or disable use of the shadow framebuffer layer. Default:
125 off.
126 Option "SyncOnGreen" "boolean"
128 Enable or disable combining the sync signals with the green sig‐
129 nal. Default: off.
130 Option "UseFBDev" "boolean"
132 Enable or disable use of on OS-specific fb interface (and is not
133 supported on all OSs). See fbdevhw(4) for further information.
134 Default: off.
135 Option "VideoKey" "integer"
137 This sets the default pixel value for the YUV video overlay key.
138 Default: undefined.
139 Option "TexturedVideo" "boolean"
141 This has XvImage support use the texture engine rather than the
142 video overlay. This option is only supported by G200 and later
143 chips, and only at 16 and 32 bits per pixel. Default: off.
144 Option "OldDmaInit" "boolean"
146 This forces the driver to use the old DMA initialization path
147 for DRI. Use this option only to support a older version of the
148 DRI driver with a newer DRM (version 3.2 or later). This option
149 also disables the use of direct rendering on PCI cards.
150 Default: off.
151 Option "ForcePciDma" "boolean"
153 This forces the use of PCI DMA even if AGP DMA could be used.
154 This option is primarily intended for testing purposes, but it
155 could also be used on systems with a buggy or poorly function
156 AGP implementation. Default: off.
157
159 Xorg(1), xorg.conf(5), Xserver(1), X(7)
160
162 Authors include: Radoslaw Kapitan, Mark Vojkovich, and also David
163 Dawes, Guy Desbief, Dirk Hohndel, Doug Merritt, Andrew E. Mileski,
164 Andrew van der Stock, Leonard N. Zubkoff, Andrew C. Aitchison.
165X Version 11 xf86-video-mga 1.6.3 mga(4)