README.CID                                                          21-June-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 Icon object, or by
running the MGASET 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 driver and directory containing the
                  new drivers.

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


