README.CID                                                          22-Nov-96

                   CID Installation of the MGA OS/2 Drivers
                   ========================================



Contents
--------

        1. Introduction

        2. Configuring the driver via CID

            a. Screen resolution and Pixel Depth.

            b. Monitor selection.

        3. Installation of the MGA OS/2 Drivers via CID




1. Introduction
---------------

This document discusses the issues concerning CID installation of the
MGA OS/2 Drivers.

The OS/2 utility DSPINSTL.EXE is used to perform CID installation of
display drivers.

Typically, CID installation is done by running a batch file.  The system
administrator customizes the batch file and then runs it on the system to be
upgraded.  The batch file attaches the network drive that contains the MGA
drivers to the local computer, and then runs dspinstl to install the drivers.

A script file (MGAX64.DSP) is used to tell DSPINSTL where to install the
various components of the MGA driver.

The script file included with the MGA OS/2 Drivers disk will install the
display driver.  Once the drivers are installed, the user can configure the
driver by launching the System object, or by running the MGA Settings utility.

If the system adminstrator wishes to configure the driver during CID
installation (choose monitor type, resolution, pixel depth) then he/she will
have to modify the script file (MGAX64.DSP).

Where to go from here:

   -To install the driver via CID using the default driver
    configuration, go to section 3.


   -To install the driver via CID using a custom configuration,
    go to section 2.



2. Configuring the driver via CID
---------------------------------

2.1 Screen resolution and pixel depth:

To configure the boot-up resolution and pixel depth of the driver, add the
following lines to the MGAX64.DSP script file:

        :SET_RESOLUTION
        WIDTH=wwww
        HEIGHT=hhhh
        COLORS=cccc
        PLANES=1

where wwww = display width
      hhhh = display height
      cccc = number of colours (256, 65536, or 16777216)

Valid width/height combinations are:  640x480, 800x600, 1024x768, 1152x864,
1280x1024, 1600x1200, 1600x1280, and 1800x1440.  Depending on the type of board
installed, and on how much VRAM is available, not all resolutions are
supported.  If an invalid resolution is specified, then the driver will boot
using the default 640x480 resolution.


2.2 Monitor selection

Monitor selection is necessary to tell the driver what resolutions and refresh
rates are supported by the monitor.

Certain monitors (DDC monitors) are able to communicate their capabilities to
the display driver.  When such monitors are being used, the monitor selection
step is not required.

When a non-DDC monitor is being used, the driver relies on the MGA.INF file to
know the monitor capabilities.  This file is generated by selecting a monitor
using the MGASET utility.  If no MGA.INF file exists (and the monitor is
non-DDC), the driver will use the default 60 Hz refresh rate for all
resolutions.

Once the system administrator has generated an MGA.INF file, the MGAX64.DSP
script can be modified to copy the MGA.INF file to the appropriate location on
the system being upgraded.  This line must be added to the :FILES section of
MGAX64.DSP

        MGA.INF          %BOOTDRIVE%:\MGA\OS2

This line assumes that the MGA.INF file can be found in the same
directory as the DSP script.



3. Installation of the MGA OS/2 Drivers via CID
-----------------------------------------------

Installation of the drivers via CID is done using OS/2's DSPINSTL utility.  The
INSTALL.CMD batch file included with the installation disk makes use of this
utility.

Before running INSTALL, the system being upgraded should be able to access the
network directory containing the new drivers.  Also, if the administrator has
made modifications to the MGAX64.DSP script or to MGA.INF (as described in
section 2), these files should be located in this network directory.

From an OS/2 session, type:

     X:\DSKIMAGE\INSTALL X:\DSKIMAGE D: /U

where X:\DSKIMAGE is the network drive and directory containing the
                  new drivers.

      D: is drive where the drivers are to be installed.


