M91VIDEO.EXE Use on: Aptiva 2168-M91 systems ONLY. Contents of diskette: This diskette contains video drivers for Aptiva 2168-M91 system with the Matrox Millenium video board installed. MATROX GRAPHICS INC. 4-Jan-1996 The MGA Millennium OS/2 PM Display Driver v 1.11 (build 019) The MGA Millennium OS/2 PM driver supports 8-bit (256 colors), 16-bit (64K colors), and 32-bit (16M colors) display modes under OS/2 2.1 and 3.0 (Warp), in resolutions ranging from 640 x 480 to 1600 x 1280. Installation: Driver Installation ------------------- To install the software, follow the procedure below: 1. If you are installing this driver for the first time, have the MGA board installed and boot OS/2. Select VGA as the display driver. 2. If you downloaded the driver from the Matrox BBS, use the DOS LABEL command to label your floppy as OS2. 3. Using the Command Prompts folder of OS/2, open an OS/2 Window or Full Screen session. 4. Insert the driver disk in a floppy drive (if you are installing from the floppy disk) or insert the CD-ROM in its drive bay. 5. Make the CD-ROM or floppy disk the active drive and type: "SRCPATH\INSTALL", where SRCPATH is the path which contains the MGA PM drivers. Examples: A:\INSTALL (if installing from a diskette with OS/2 only) A:\OS2\INSTALL (if installing from diskette with OS/2 and NT) D:\OS2\INSTALL (if installing from a CD-ROM) Note: if you install this driver to a Warp System, you may run \INSTALL /u and every thing will be installed without any further input from the user (primary, secondary selection, driver selection, and source disk/path selection). 6. You will see a dialog box in which you can select the Primary Display. Choose "Matrox MGA Millennium Series". You may have to change the source drive if you are not installing from drive A. 7. The installation program will then proceed with the installation. When it is complete, you will have to shut down your system in order for the MGA driver to take effect. If you are installing this driver for the first time, OS/2 will restart in Matrox default MGA resolution (640 x 480 x 256). It is therefore advisable to select the desired resolution just BEFORE rebooting, by means of the OS/2 System Setup folder, as explained in the next section. Note: If you are using Selective Install in OS/2 Warp, the MGA Millennium driver shows up as "Other." Driver Configuration -------------------- To change the driver mode (resolution or pixel depth), use the following procedure: 1. Click the right button on the PM desktop background. 2. Select SYSTEM SETUP to open the system setup folder. 3. Double-click on the SYSTEM icon. 4. Select the SCREEN tab and choose the resolution/pixel depth. You will need to reboot the system to see the change take effect. Uninstalling the Driver ----------------------- The Matrox UNINSTAL command file makes use of the OS/2 DSPINSTL.EXE program to switch the display driver from MGA mode back to VGA mode, as shown in the following procedure: 1. Open an OS/2 Text Window (or Full Screen) session. 2. Enter: CD \MGA\OS2 UNINSTAL or UNINSTAL CLEAN (to also delete the Matrox files from your hard disk) 3. Select Primary Display, then choose the driver you require (for example, VGA). You will need to reboot the system to see the change take effect. Note: With Warp, there are two additional ways to switch the driver from MGA mode to VGA mode: 1. You can access a menu by pressing Alt+F1 when the OS/2 logo appears in the upper left corner of the screen during the bootup process. This menu will allow you to change the driver to VGA by selecting the appropriate option. 2. You can also change the driver to VGA by running the following file in an OS/2 window or full screen session: \OS2\INSTALL\RSPDSPI.EXE Monitor Customization --------------------- The OS/2 Millennium driver supports VESA DDC-1 and DDC-2B compliant monitors. If your monitor is not detected as DDC compliant, the driver will take the "Unknown Monitor" hardcoded timings, which assume that you have a monitor supporting all resolutions available on your board, at a 60Hz refresh rate (non-interlaced). If you have a monitor that is capable of refresh rates higher than 60Hz, you can perform monitor file customization with the help of the MGAMON program. This program creates a file called MGA.INF, which contains the appropriate video parameters for your monitor. The MGA.INF file is read by the MGA display driver when OS/2 boots. The MGAMON program is located in the \MGA\OS2\ directory. It is a DOS program, so it must be run in a DOS session (either windowed or full screen). To run MGAMON, open a DOS session: 1. Enter: CD \MGA\OS2 MGAMON 2. Select a monitor and exit the program. You must shut down OS/2 and reboot your computer for the changes to take effect. NOTE: The timing information in MGA.INF over-rides the timing info returned by DDC compliant monitors. If you are using a DDC compliant monitor, and you do not wish to over-ride the monitor's timing info, then delete the MGA.INF file from your \MGA\OS2\ directory. Driver configuration -------------------- Advanced configuration of the MGA driver can be performed through the MGACONF.CMD command file, located in the \mga\os2 directory. MGACONF performs the following: 1. Font settings MGACONF has a switch to change the font settings: mgaconf f You will be prompted for the resolution to affect and the parameter to change: System Font (desktop menu font), Font Resolution (desktop icon font) or Avio Font (font inDOS and OS/2 windows). Command line input is also possible, the syntax being: mgaconf f "resolution" "which_parameter" "parameter_value", where 0-640X480 0-SystemFont 0-Small(100) 1-800X600 1-Medium(101) 2-1024X768 2-Large(102) 3-1152X882 4-1280X1024 1-FontResolution 0-96dpi 5-1600X1200 1-120dpi 6-1600x1280 2-AvioFont 0-8x8 1-10x6 2-10x8 3-12x8 4-14x6 5-14x8 : ... 9-18x8 a-18x10 : ... e-30x12 Example: To change the 1280X1024 resolution to use the small system font, 96 dpi and 8x14 Avio font, the following three lines must be entered: mgaconf f 4 0 0 mgaconf f 4 1 0 mgaconf f 4 2 5 Note that the default values for the fonts are: Sytem Font Font res Avio Font 640x480 100 96 8x14 800x600 100 96 8x14 1024x768 101 120 12x22 1152x882 102 120 12x22 1280x1024 102 120 12x22 1600x1200 102 120 12x22 1600x1280 102 120 12x22 2. Color cursor mgaconf c [0/1/2], where 0 will disable the software cursor (you will have 2 or less colors in the cursor) 1 will enable the software cursor (multicolor cursor) 2 will enable the software cursor if the cursor has 4 or more colors Default is 1. 3. Cursor Vsync The cursor may exhibit some "noise" when an application changes the color palette. This switch forces to wait for a Vsync before changing the palette. The drawback is a loss of speed when changing the palette. Some animated application requires fast changing palette. This switch applies only to 8 bpp. mgaconf v 0 (off) mgaconf v 1 (on) Default is 1. 4. DIVE switch Due to an OS/2 problem in 24 bpp, the Warp AVIO player video image will be shifted to the left. MGACONF has a switch to enable DIVE in 24 bpp: mgaconf d 1 (ON) mgaconf d 0 (OFF) Default is OFF for 24bpp and ON for 8 and 16 bpp. 5. Grayscale driver switch Owners of the Millennium PowerDoc Edition may enable the grayscale driver switch, which defines whether 8 bits per pixel should be in 256 colors or 256 gray shades. mgaconf g 1 (Grayscale) mgaconf g 0 (Color) For all options of MGACONF, you must reboot your computer to see the change take effect. Board Testing ------------- If you encounter any problems running OS/2 with your board, you should first determine whether it is a system or hardware problem. The best way to check for a potential hardware problem is to use the MGA SETUP program. SETUP is a DOS program that is included on the MGA CAD Driver disk, It cannot be run from an OS/2 Command Prompt session. If you have a DOS (FAT) partition on your hard disk, simply install the Setup and Utilities product using the provided installation program. Then go to the \MGA\SETUP directory and type SETUP. If you do not have a DOS partition, you will have to create a bootable disk that has SETUP on it. Here is the procedure: 1. Insert the proper installation disk in your diskette drive. 2. Copy A:\SETUP\FILES1.ZIP and A:\PKUNZIP.EXE to a location on your hard disk. 3. Make that hard disk location current and type "PKUNZIP FILES1" to unarchive the files. 4. Remove the installation disk and format a new bootable DOS disk. 5. Copy the following files from your hard disk to your new floppy disk: SETUP.EXE, DOS4GW.EXE, MGA.MON 6. Reboot your computer with the the new disk. 7. Type SETUP. In SETUP, select "Graphic Mode Test" to test the various modes that are available for your board. The program will not attempt to test a mode which is not supported by your board. The default test will be done at a 60Hz refresh rate for all resolutions. If you have a customized monitor file (MGA.INF) in your \MGA\OS2 subdirectory, SETUP can read it and act upon it if you set the MGA environment variable as shown below: SET MGA=C:\MGA\OS2 File description ---------------- Assume: -> Source path -> Destination drive (OS/2 system drive). -> WinOS/2 or Windows path (\os2\mdos\winos2 or \windows) \INSTALL.CMD --> stay where it is. \FIXAUTO.CMD --> :\MGA\OS2 \UNINSTAL.CMD --> :\MGA\OS2 \MGAX64.OS2 --> :\MGA\OS2\SYSLEVEL.MIL (pack file) :\MGA\OS2\MGACONF.CMD :\MGA\OS2\MGAX64S.DSP :\OS2\DLL\PMGAX64.DLL :\OS2\DLL\BMGAX64.DLL :\MGA\OS2\KMGAX64.SYS :\OS2\MDOS\VMGAX64.SYS \MGAX64W.OS2 --> :\SMGAX64.DRV (pack file) :\MGAX64.DLL \MGAX64.DSP --> stay where it is. \VVGA.SYS --> :\MGA\OS2 and :\OS2\MDOS \MGAX64.DSC --> :\OS2\INSTALL \MGA.MON --> :\MGA\OS2 \MGAMON.EXE --> :\MGA\OS2 \README.OS2 --> :\MGA\OS2 MGAX64.DSP installation support file for "dspinst" (for first install) MGAX64S.DSP installation support file for "dspinst" (for re-install) MGAX64.DSC installation support file MGAX64.DLL initialization library for WinOS2 fullscreen BMGAX64.DLL Base Video Handle (sets VGA for OS/2 fullscreen) PMGAX64.DLL 32bit PM driver (8, 16 and 32bpp) KMGAX64.SYS low-level initialization for 32bit PM driver SMGAX64.DRV WinOS2 Fullscreen and Seamless driver VMGAX64.SYS Virtual MGA Millennium driver (for DOS sessions) VVGA.SYS Modified IBM VGA virtual driver. README.OS2 Readme file INSTALL.CMD first time installation MGACONF.CMD Configuration utility for MGA Millennium PM driver FIXAUTO.CMD inserts "SET MGA=C:\MGA\OS2" in autoexec.bat (WinOS2) UNINSTAL.CMD uninstalls driver (and removes all Millennium files from hard drive) MGA.MON MGA Monitor data file for MGAMON.EXE MGAMON.EXE Monitor program to create MGA.INF out of MGA.MON SYSLEVEL.MIL driver Version info (use OS/2 command syslevel.exe to obtain the driver Version) Driver History -------------- 1.00 (build 007) 9 June 95 - first release 1.01 (build 008) - Fixed STM0003 dtt.exe -> GreBitMaps -> GreImagedataExh, missing left part of the triangle. - Fixed STM0015, STM0016, STM0018: Selective Install window did not refresh when move out and in the display. @800x600x8 (also with 16 and 32bpp) - Fixed STM0019 clear the display after setmode. - Fixed STM0005, STM0020: the outline of the hilight change color (or disapear) when part of it is refresh. (cover it and uncover it). - Fixed STM0006 dtt.exe -> GreAttr -> GreDeviceSetGetAttrExh, reverse pattern. - Fixed STM0021 small black dot at top left corner of any window. - Fixed STM0017 color cursor in scheme palette. - Fixed STM0007 last marker position. - Fixed STM0031 WinOS2 fullscreen switching problem. - Fixed STM0034 OS/2 Chess. - Fixed STM0033 Software cursor with Seamless Windows. - Add Grayscale & 1600x1280 supported (DIP board only). - Fixed #2719 problem with non-DDC Qvision 172 monitor. 1.01 (build 009) - Maintenance version based on build 007. 1.10 (build 010) - New version number, based on build 008. 1.10 (build 011) - Fixed problem with rectangle fill in Seamless Windows Paintbrush. 1.11 (build 018) - Fixed Alt-Esc switching hang when switching between PM Desktop and full-screen WinOS2. - Fixed problems running TCPY and MEMTEST test applications. - Fixed problem with Novell "SEND" command. - Fixed problem running IBM PCM Acceptance test. - Fixed problem openning DOS session on DELL systems. - Fixed booting problem on PentiumPro systems. - Added support for monitors capable of providing DDC Standand and Detailed timing informations. 1.11 (build 019) - Fixed GPF bug when launching WinOS2 Program Manager in Seamless mode. - Fixed Alt-Esc problem when switching from Klondike (auto-play) to full-screen DOS. KNOWN BUGS AND LIMITATIONS -------------------------- The following bugs and limitations are present in this release of the driver: - When using the DSPINSTL program to reconfigure your MGA driver, the program states that VGA is the current driver. This is because the DSPINSTL program included with OS/2 does not correctly identify the MGA Millennium. - The MGA PowerDesk Windows drivers should NOT be used in a Win-OS/2 full screen session. The results will be highly unpredictable. If the MGA windows driver features are absolutely needed, then a dual-boot configuration must be used. When booting from DOS, the PowerDesk Windows driver features are fully supported. - The driver does not work with Mayo Clinic Family Heath Book (Windows app.) in seamless Windows at 16bpp (64K colors). If you need to run this application, please run it in WinOS2 fullscreen instead or you may have to change the pixel depth to 8bpp or 24bpp. - When switching quickly from PM desktop to full-screen WinOS2, the WinOS2 desktop may get corrupted. To restore the WinOS2 desktop, do a slow switch to PM Desktop and back to WinOS2. - This diskette does not support CID. Contact our technical support to get our CID upgrade kit. __________________________________________________________________ IBM SYSTEM PROGRAMS LICENSE AGREEMENT __________________________________________________________________ PLEASE READ THIS AGREEMENT CAREFULLY BEFORE DOWNLOADING AND USING THESE PROGRAMS ON YOUR SYSTEM. DOWNLOADING THESE PROGRAMS INDICATES YOUR ACCEPTANCE OF THESE TERMS. This is a license agreement ("Agreement") for International Business Machines Corporation or its subsidiaries ("IBM") system programs ("Programs") which are provided to support the IBM system ("System"). A System includes IBM machines, features, conversions, upgrades, and options, either separately or in any combination. Programs may be included with the System, or made available electronically or via various media. IBM may also offer other programs which may be licensed under different terms and conditions. Please refer to the license agreement(s) accompanying such other programs for the terms and conditions governing their use. LICENSE Programs are owned by IBM or its suppliers, and copyrighted and licensed not sold. If you are a rightful possessor of a System, or if you have obtained Programs for the purpose of maintaining a System, IBM grants you a nonexclusive license to use the Programs as part of or in conjunction with the System, or to restore and maintain the Programs. This Agreement also covers any future versions of Programs that IBM may make available. You obtain no rights other than those granted to you under this Agreement. You may: 1) use the Programs as part of, or in conjunction with, a System as specified in the documentation that IBM provides; 2) modify or adapt only the SETUP and ADAPTER DESCRIPTION FILES (@XXXX.ADF), if applicable, to enable a System to operate in accordance with IBM's Official Published Specifications; 3) copy the Programs for backup; 4) make copies of the Programs and distribute them to a rightful possessor of a System and to install the Programs for a rightful possessor (but only to the extent necessary to restore or maintain the System), provided that you supply such party a copy of this Agreement; and 5) transfer possession of these Programs and diskette(s) to another party in conjunction with the transfer of a System, provided that you supply a copy of this Agreement and all Program and System documentation to such party. When you do so, your license is terminated and you must destroy all your remaining copies of the Program. YOU MUST REPRODUCE THE COPYRIGHT NOTICE(S) AND ANY LEGENDS ON EACH COPY OF A PROGRAM. You may NOT: 1) use, modify, adapt, copy, merge, display, execute, distribute or transfer the Programs, except as authorized by this license; 2) reverse assemble, reverse compile, decode, or otherwise translate the Programs except as specifically permitted by law without the possibility of contractual waiver; or 3) sublicense, rent, lease, or assign the Programs. LIMITED WARRANTY IBM warrants the Programs solely in accordance with the Statement of Limited Warranty for Machines that accompanied your System, which is hereby incorporated by reference. GENERAL You may terminate your license at any time. IBM may terminate your license if you fail to comply with the terms of this Agreement. In either event, you must destroy or disable all your copies of the Programs. You are responsible for the payment of any taxes, including personal property taxes, resulting from this Agreement. You agree to comply with all applicable export laws and regulations. Neither party may bring an action under this Agreement more than two years after the cause of action arose. This license is governed by the laws of the country in which you acquired the Programs except that: 1) if you acquired the Programs in the United States, this license is governed by the laws of the State of New York; and 2) if you acquired the Programs in Canada, this license is governed by the laws of the Province of Ontario.