[English]
README_020.TXT               MATROX GRAPHICS INC.           2002.10.17

                      Matrox Parhelia 512 README

Note: This document and the associated software are currently only
available in English. We apologize for the inconvenience.


Contents
========
- Description of this release
- Available configurations
- Using TripleHead
- Sample XF86Config Files
- Rotating a display
- Using digital monitors
- Using a hardware accelerated mouse-pointer
- Binary Installation
- Enabling bus mastering


Description of this release
===========================
This release of the Matrox display driver includes support for the Parhelia
512 graphics hardware. Bus mastering is available for a single display, two
displays in stretched mode, and three displays in stretched mode
(TripleHead). While using two displays in independent mode, bus mastering
isn't supported.

This driver package supports versions 4.1.0 and 4.2.0 of Xfree86.


Available configurations
========================
With this driver, you can choose among the following multi-display
configurations:
  (1) Single display: Only 1 display. This mode supports bus
      mastering.
  (2) 2 displays - independent mode: 2 displays with different
      display resolutions.
  (3) 2 displays - stretched mode: two displays with the same
      display resolution and refresh rate. These 2 displays use 1 big
      frame buffer. This mode supports bus mastering.
  (4) 3 displays - stretched mode (TripleHead): 3 displays with the
      same display resolution and refresh rate. These 3 displays
      use 1 big frame buffer. This mode supports bus mastering.


Using TripleHead
================
While using TripleHead, all 3 displays must have the same refresh rate and
resolution because all 3 displays are using the same frame buffer.

In order to enable Triple Head, add
    Option "TripleHead"
to the screen section of your XF86Config-4 file

Here's a sample Screen Section for Triple Head:

Section "Screen"
        Identifier "Screen 1"
        Device     "MGA CARD 1"
        Monitor    "My Monitor"
        DefaultDepth    24
    DefaultFbbpp 32
    Option "TripleHead"
        SubSection "Display"
                Depth    24
        Virtual 2400 600
                Modes    "800x600"
        EndSubSection
EndSection


Sample XF86Config Files
=======================
There are sample XF86Config files in the "Samples" directory. To use them,
you must either:

- Copy the file to your /etc/X11 directory and rename it to
  "XF86Config-4"
OR
- Type "startx -- -xf86config FILENAME" where FILENAME is the sample
  config file.

For
     Single display                 --> XF86Config.mtx
     2 displays - independent mode  --> XF86Config.dual
     2 displays - stretched mode    --> XF86Config.merged
     3 displays - stretched mode    --> XF86Config.triple


Rotating a display
==================
To rotate your screen, add:
  Option "Rotate" "CW"
  or
  Option "Rotate" "CCW"
to the Device Section of the XF86Config-4 file. CW and CCW correspond to a
clockwise rotation (CW) and a counter-clockwise rotation (CCW).

Note: While you are using display rotation, hardware acceleration is
disabled.


Using digital monitors
======================
If you are using a digital monitor, add the following line to the device
section:
  Option "DigitalScreen1" "on"
  or
  Option "DigitalScreen2" "on"
"DigitalScreen1" and "DigitalScreen2" correspond respectively  to the
digital monitor connected to the primary and secondary connector of your
graphics card.


Using a hardware accelerated mouse-pointer
==========================================
To enable a hardware-accelerated mouse pointer, add the following line to
the device section:
  Option "hw cursor" "on"


Binary Installation
===================
A working installation of XFree86 4.1.0 or 4.2.0 is required before the
binaries can be installed.

To extract the driver files, enter the following command where
<mtx_filename> is the name of the driver file you want to extract:
   tar xvzf <mtx_filename>.tgz[ENTER]
   cd mtxdrivers[ENTER]

To install the drivers, run the install script as "root":
   sh install.sh[ENTER]

The installation script makes a back-up copy of "mga_drv.o" and, if it
exists, of "mga_hal_drv.o". To restore your original drivers, simply run the
script with the "restore" option specified:
   sh install.sh restore[ENTER]


Enabling bus mastering
======================
In order to use bus mastering, the following modules must be loaded:
  (1) libparhl.so: Parhelia busmastering module
      The  X server will attempt to load the busmastering module by default.
      The installation script places this file in "/usr/lib"
      and creates a link to it in "/usr/X11R6/lib/modules/linux/"

  (2) mtx.o: Parhelia kernel module
      The kernel module must be compiled for your system. The script
      file "install.sh" will attempt to compile the module. If it does not
      succeed, you can compile it manually by entering the following:
         - cd kernel/src[ENTER]
         - make[ENTER]
         - make install[ENTER]
      Compiling the kernel module requires the kernel source to be
      installed on your system.

The "make install" command installs the kernel module in the proper
location. The X server should load the kernel module automatically. If not,
typing "insmod mtx" will load the module. 

Before loading the "mtx" kernel module, make sure that the "agpgart" module
has been loaded sucessfully. Enter the following command and look for
"agpgart" in the list of modules.
         - lsmod
If "agpgart" is not listed, it can be loaded by typing the following:
         - insmod agpgart
To enable or disable bus mastering, add the following to the XF86Config-4
file:
  Option "Busmastering" "on"
  or
  Option "Busmastering" "off"