==============================
miro driver for OS/2    V 2.01                             18.05.1995
==============================

THIS VIDEO ACCELERATOR DRIVER IS COMPATIBLE WITH OS/2 2.1, 2.11 AND WARP V3.
DO NOT INSTALL IT ON OTHER VERSIONS OF OS/2.



Table of contents:
------------------
1. Supported cards and resolutions
2. Installation notes
3. Installing the miro drivers for OS/2
4. Windows under OS/2
5. Re-installing VGA
6. Known problems



1. Supported cards and resolutions
----------------------------------

This driver supports the following miro graphics boards:

- miroCRYSTAL 10SD
- miroCRYSTAL 20SD
- miroCRYSTAL 20SV
- miroCRYSTAL 40SV
- miroMAGIC 20SV ergo
- miroMAGIC 40SV ergo


The following resolutions and color depths are supported with the
listed miro graphics boards:

      Resolution        10SD 1MB    10SD 2MB    20SD 1MB    20SD 2MB
  -----------------    ---------   ---------   ---------   ---------
   640 x  480 x 256        x           x           x           x
   800 x  600 x 256        x           x           x           x
  1024 x  768 x 256        x           x           x           x
  1152 x  864 x 256        -           x           -           x
  1280 x 1024 x 256        -           x           -           x
   640 x  480 x 64K        x           x           x           x
   800 x  600 x 64K        -           x           -           x
  1024 x  768 x 64K        -           x           -           x

      Resolution          20SV        40SV     20SV ergo   40SV ergo
  -----------------    ---------   ---------   ---------   ---------
   640 x  480 x 256        x           x           x           x
   800 x  600 x 256        x           x           x           x
  1024 x  768 x 256        x           x           x           x
  1152 x  864 x 256        x           x           x           x
  1280 x 1024 x 256        x           x           x           x
  1600 x 1200 x 256        -           -           x           x
  1600 x 1280 x 256        -           -           x           x
   640 x  480 x 64K        x           x           x           x
   800 x  600 x 64K        x           x           x           x
  1024 x  768 x 64K        x           x           x           x
  1152 x  864 x 64K        x           x           x           x
  1280 x 1024 x 64K        -           x           -           x
  1600 x 1200 x 64K        -           -           -           x
  1600 x 1280 x 64K        -           -           -           x

  The following resolutions do not support a color cursor:

  1600 x 1200 x 256
  1600 x 1280 x 256
  1152 x  864 x 64K
  1600 x 1200 x 64K
  1600 x 1280 x 64K

  The following resolutions do not support Seamless Windows:

  1152 x  864 x 256
  1600 x 1200 x 256
  1600 x 1280 x 256
  1152 x  864 x 64K
  1600 x 1200 x 64K
  1600 x 1280 x 64K



2. Installation notes
---------------------

- IMPORTANT: To install the miro drivers for OS/2 correctly,
             OS/2 has to be installed for VGA.

  If you have modified your OS/2 video since installation, you must return
  it to VGA before you install this driver.
  For details read chapter 5 (Re-installing VGA) in this file.

- You must have OS/2 DOS and REXX Support installed in order to install
  this driver.

- The OS/2 commands ATTRIB and UNPACK are used during installation. If you
  selected not to install the OS/2 System Utilities or you have deleted one
  of the commands, you must use "Selective Install" to restore these two
  commands before continuing.

- The "miroúplus; High speed drivers for OS/2" Install disk
  must be labeled "S3 DRVS".

- Before starting the installation, make a backup copy of the installation
  disk included in the delivery scope.
  Keep the original disk in a safe place and only use the copy.



3. Installing the miro drivers for OS/2
---------------------------------------

The installation of the miro drivers for OS/2 is done from the floppy disk.
During the installation the drivers are copied to the hard disk.

To install the miro drivers, proceed as follows:

- Start your computer and boot OS/2.

- On the OS/2 desktop open the "System" folder.

- In the "System" window open the "Command Prompts" folder.

- Start the "OS/2 Fullscreen" object or the "OS/2 Window" object.

- Insert the "miroúplus; High speed drivers for OS/2; Install disk # 1/1"
  in the disk drive and enter:

  A:MIROINST A: C: <ENTER>

  where A: corresponds to the disk drive,
        C: corresponds to the hard disk on which OS/2 is installed.

- The programm "miro Video Controls" is started automatically.
  Select the installed miro graphics board and monitor and click "OK".

- Close the "OS/2 Fullscreen" or "OS/2 Window" object.

- The system has to be restarted. Therefore, choose "Shut down"
  from the popup-menu on the OS/2 desktop.

- Remove the disk from the disk drive.

- Press <Ctrl>+<Alt>+<Del> to restart the system.

- Insert the "miroúplus; High speed drivers for OS/2; Install disk # 1/1"
  again into the disk drive after OS/2 has booted.

- If you have closed the "System" folder, open it on the OS/2 desktop.

- In the "System" window open the "System Setup" folder.

- Select the "Display Driver Install" object.

- In the "Display Driver Install" window, mark the box for "Primary Display"
  and click "OK".

- In the "Primary Display Adapter Type" window, mark the
  "32-bit miro Display Drivers V1.10.02" entry in the list and click "OK".

- In the "Monitor Configuration/Selection Utility" window accept the
  "Install Using Defaults for Monitor Type" option with "OK".

  ATTENTION: The monitor will blank for some seconds,
                         the computer is still processing.

- If necessary, change the disk drive in the "Source Directory" window and
  click "Install". The miro drivers are copied to the hard disk.

- If a requester comes up, asking if drivers already installed on the hard
  disk should be overwritten, always answer with "Yes".

- Quit the following window with "OK".

- In the "System Setup" window select the object "System".

- In the "System-Settings" window choose the desired resolution and number
  of colors.

- Close the window and perform a Shut down.
  The settings take effect after your computer has been restarted.



4. Windows under OS/2
---------------------

There is the possibility to install the miro Windows drivers under OS/2.
The supplied "miroúwin; High-speed drivers for Windows" Install disks are
required.

To install the Windows drivers for OS/2 correctly, the VGA driver has to be
installed for Windows.

- Issue the following command in an "OS/2 Fullscreen" or "OS/2 Window" 
  session:

  C:\OS2\INSTALL\WINSETUP A: C: <ENTER>

  where A: corresponds to the disk drive,
        C: corresponds to the hard disk on which OS/2 is installed.

  This command will copy the necessary install files from the windows disks
  to your hard disk.

- Start a Win-OS/2 fullscreen session.

- Install the windows drivers as described in the "miroúwin Software Manual"
  from your hard disk. In the programm manager, choose the option "Run" from
  the menu "File" and enter:

  C:\INSTALL.EXE <ENTER>

  where C: corresponds to the hard disk on which OS/2 is installed.

  This command will install the windows drivers from your hard disk.

- Close the Win-OS/2 fullscreen session.

- Issue the following command in an "OS/2 Fullscreen" or "OS/2 Window" 
  session:

  C:\OS2\INSTALL\WINCLEAR C: <ENTER>

  where C: corresponds to the hard disk on which OS/2 is installed.

  This command will delete the install files from your hard disk.
  The windows drivers will of course remain.



5. Re-installing VGA
--------------------

If you are running OS/2 2.1 or 2.11:

- Start your computer and boot OS/2.

- On the OS/2 desktop open the "System" folder.

- In the "System" window open the "System Setup" folder.

- Select the "Display Driver Install" object.

- In the "Display Driver Install" window, mark the box for "Primary Display"
  and click "OK".

- In the "Primary Display Adapter Type" window, mark the
  "VGA (Video Graphics Array)" entry in the list and click "OK".

- If necessary, change the disk drive in the "Source Directory" window and
  click "Install". The VGA drivers are copied to the disk drive.

- Quit the following window with "OK".

- Perform a Shut down.

- OS/2 will now boot using VGA graphics.


If you are running OS/2 Warp V3:

- If necessary, perform a system shutdown.

- Boot your computer.

- While booting, a white rectangle appears in the upper left corner of the
  screen with the text OS/2 to the right.

- Press Alt-F1 while this rectangle is displayed.

- In the following menu, select the option V to re-configure the system to
  VGA graphics.

- OS/2 will now boot using VGA graphics.



6. Known problems
-----------------

- Some systems could have problems after a warm boot (Ctrl-Alt-Del).
  In those cases, please perform a cold boot using the reset switch.

- The resolution 800 * 600 * 64K does not support a hardware cursor.
  Please switch to a software cursor using the "Mouse" notebook.
  Therefore, choose the option "Load group" on the page "Mouse pointer".

- When running the windows clock in seamless mode, some conflicts can
  appear (e.g. the Win-OS/2 fullscreen does not start or the software
  cursor is not drawn correctly).
  Please use the OS/2-programm "System clock".

- Some systems may cause memory conflicts when playing AVIs using the
  digital video player (destroyed or no picture). 
  In those cases, add the following line to your CONFIG.SYS:
  SET VIDEO_APERTURE=0

- On some systems, there may be problems initializing the resolution
  of 1600*1280. Please use the resolution of 1600*1200 instead.