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 "Overlay" "value"
115 Enable 8+24 overlay mode. Only appropriate for depth 24. Rec‐
116 ognized values are: "8,24", "24,8". Default: off. (Note: the
117 G100 is unaccelerated in the 8+24 overlay mode due to a missing
118 hardware feature.)
119 Option "PciRetry" "boolean"
121 Enable or disable PCI retries. Default: off.
122 Option "Rotate" "CW"
124 Option "Rotate" "CCW"
126 Rotate the display clockwise or counterclockwise. This mode is
127 unaccelerated. Default: no rotation.
128 Option "ShadowFB" "boolean"
130 Enable or disable use of the shadow framebuffer layer. Default:
131 off.
132 Option "SyncOnGreen" "boolean"
134 Enable or disable combining the sync signals with the green sig‐
135 nal. Default: off.
136 Option "UseFBDev" "boolean"
138 Enable or disable use of on OS-specific fb interface (and is not
139 supported on all OSs). See fbdevhw(4) for further information.
140 Default: off.
141 Option "VideoKey" "integer"
143 This sets the default pixel value for the YUV video overlay key.
144 Default: undefined.
145 Option "TexturedVideo" "boolean"
147 This has XvImage support use the texture engine rather than the
148 video overlay. This option is only supported by G200 and later
149 chips, and only at 16 and 32 bits per pixel. Default: off.
150 Option "OldDmaInit" "boolean"
152 This forces the driver to use the old DMA initialization path
153 for DRI. Use this option only to support a older version of the
154 DRI driver with a newer DRM (version 3.2 or later). This option
155 also disables the use of direct rendering on PCI cards.
156 Default: off.
157 Option "ForcePciDma" "boolean"
159 This forces the use of PCI DMA even if AGP DMA could be used.
160 This option is primarily intended for testing purposes, but it
161 could also be used on systems with a buggy or poorly function
162 AGP implementation. Default: off.
163
165 Xorg(1), xorg.conf(5), xorgconfig(1), Xserver(1), X(7)
166
168 Authors include: Radoslaw Kapitan, Mark Vojkovich, and also David
169 Dawes, Guy Desbief, Dirk Hohndel, Doug Merritt, Andrew E. Mileski,
170 Andrew van der Stock, Leonard N. Zubkoff, Andrew C. Aitchison.
171X Version 11 xf86-video-mga 1.4.6.1 mga(4)