home *** CD-ROM | disk | FTP | other *** search
- README.OS2 MATROX GRAPHICS INC. 13-Mar-1996
-
- The MGA OS/2 PM Display Driver
- v 2.10.020
-
- Product Description
- -------------------
-
- This MGA OS/2 PM driver supports 8-bit (256 colors), 16-bit (64K colors),
- and 24-bit (16M colors) display modes under OS/2 2.1 up to "Warp", in
- resolutions ranging from 640 x 480 to 1600 x 1200. The driver works on
- all MGA Ultima and Impression models. It also includes a Seamless Windows
- driver.
-
- 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)
-
- 6. You will see a dialog box in which you can select the Primary Display.
- Choose "Matrox MGA 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, or over a version
- older than 2.00, OS/2 will restart in the default MGA resolution
- (640 x 480 x 256). It is therefore advisable to select the desired
- resolution immediately before rebooting, by means of the OS/2
- System Setup folder, as explained in the next section.
-
- 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 OS/2 DSPINSTL.EXE program can be used 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 \OS2\INSTALL
- DSPINSTL
-
- 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.
-
- You may want to create an icon for the OS/2 DSPINSTL program if you plan
- to use it frequently.
-
- 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
-
- Your MGA OS/2 diskette also comes with an "UNINSTAL" utility. This batch
- file removes lines that load the driver from your config.sys file. If used
- with the "CLEAN" parameter, the driver files will even be deleted from your
- hard drive. The batch file also invokes DSPINSTL so you can select another
- display driver. To use the UNINSTAL utility:
-
- 1. Open an OS/2 Text Window (or Full Screen) session
-
- 2. Enter: CD \MGA\OS2
- UNINSTAL
- or
- UNINSTAL CLEAN
-
- Monitor Customization
- ---------------------
-
- By default, the driver assumes that you have a monitor which supports
- all resolutions available to 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.
-
- 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,
- version 1.50 and later. 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
-
- Driver History
- --------------
-
- 2.00A3
- - 32-bit driver supporting 8, and 24 bpp color.
- - Added "clean" option to UNINSTAL.CMD for removing old MGA PM drivers
- from the hard disk. The UNINSTAL CLEAN command may be used to clean
- previous or current versions of the MGA driver.
- - Resolution switching is now done by a system setting.
- - Warp (OS/2 v3.00) supported.
-
- 2.00.001
- - Added 16 bpp color.
- - Added DIVE support for 8 and 16 bpp (does not work under 24 bpp).
- - The Version and the Corrective service level now may be obtained via
- the SYSLEVEL command.
-
- 2.00.002
- - Fixed cursor and palette problems on ViewPoint 2026.
- - Added MGACONF.CMD to switch WaitVsync on and off (cursor problem
- on ViewPoint 2026 while updating the palette).
- - Fixed getpixel.
-
- 2.00.003
- - Updated sxcios2.dll (monitor).
-
- 2.00.004
- - Fixed exit progman seamless in 24 bpp Imp+.
- - Fixed magnify glass in filenet display.
- - New MGA.MON file.
-
- 2.00.005
- - Fixed text when running Seamless Windows.
- - Fixed some color and redraw problems in Seamless Windows.
- - Fixed DIVE.
-
- 2.00.007
- - Fixed Reversi (PolyScanline).
- - Fixed Text in DTT.EXE (opaque text).
- - Fixed clearing the VRAM (garbage on screen) before setting MGA mode.
- - Fixed Seamless refresh problem (PowerPoint, Word).
-
- 2.00.008
- - Fixed offscreen font caching on MGA Pro 4.5/V.
- - Improved the look of the color-hardware cursor.
- - Fixed the color-cursor hotspot.
-
- 2.00.009
- - Fixed WinOS2 full screen (on 200b7 and 200b8).
- - Fixed off-screen font caching on VLB2+ board (on 200b8 only).
- - Added 24 bpp DIVE support (used EnDIVE to return ColorEncoding).
-
- 2.00.010
- - Fixed font cache problem in pm 1600 x 1200 x 8.
- - Fixed font cache problem in winos2 seamless 1600 x 1200 x 16.
- - Fixed refresh problem in WinWord seamless when displaying the
- yellow tabs.
- - Fixed fuzzy text in the settings popup window.
- - Fixed lockup when switching from winos2 fullcreen to pm
- - Remove DIVE supported in 24bpp.
-
- 2.01.011
- - Fixed bitblt from color to mono.
- - Fixed the different betwen bitmap and screen in drawing dash line.
- - Fixed the pattern color in Coreldraw 2.5 for OS/2
- - Fixed the poly disjoint line to draw the last pixel.
- - Add software cursor. The software cursor can be disable using
- mgaconf.cmd in \mga\os2 directory.
- - Add switches to change the system font, font resolution and AVIO font.
- The default value for those setting 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
- If you want to change any default for any resolution, please run
- mgaconf.cmd in \mga\os2 directory.
-
- 2.01.012
- - Fixed Cursor in scramble.exe (os2 2.11).
- - add option /U in install.cmd for unattended install (work on Warp only).
- i.e. now you can type:
- a:\install /u
- and every thing will be install in one shot without any further input
- from user (primary, secondary selection, driver selection, and
- source disk/path selection)
-
- 2.01.013
- - add 24bpp DIVE switch to mgaconf.cmd. To enable 24bpp DIVE, please run:
- c:\mga\os2\mgaconf.cmd d 1
- and reboot the computer.
-
- 2.02.014
- - Fixed dump memory problem (switch to text mode when dump).
- - Fixed pattern problem in 1600x1200@24bpp MGA-IMP 3/V/H
- - Fixed Exeption error when mgakrnl.sys is in config.sys but mga32.dll
- is not running.
- - Fixed not to remove DEVINFO=VGA,... from config.sys when install mga
- - Fixed switch to DOS or OS/2 fullscreen problem on some 3026 RAMdAC.
-
- 2.03.015
- - Fixed STM0015, STM0016, STM0018: Selective Install window did not refresh
- when move out and in the display. @800x600x8 (also with 16 and 32bpp)
- - 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 Seamless Excel 5.0 scrolling problem @1280x1024x8bpp.
-
- 2.03.016 Fixed:
- - STM0031 WinOS2 fullscreen switching problem.
- - STM0034 OS/2 Chess.
-
- 2.03.017 Fixed:
- - STM0033 Seamless with software cursor.
- - SQA2584 WinOS2 fullscreen switching problem with mouse.
-
- 2.03.018
- - Fixed bug with text in WinOS2 (both fullscreen & seamless).
-
- 2.10.019
- - Fixed Alt-Esc switching hang when switching between PM Desktop and
- full-screen WinOS2.
- - Fixed OEM app problem (wrong colours used when displaying a 4bpp bmp
- in 24bpp mode).
-
- 2.10.020
- - Fixed hang that occurred when returning to the PM desktop from a FS
- WinOS2 session.
-
-
- KNOWN BUGS AND LIMITATIONS
- --------------------------
-
- The following bugs and limitations are present in this release of the
- driver:
-
- - AT (ISA) and VL boards mapped at AC000: We don't advise that you use the
- (default) mapping of AC000 with this OS/2 driver. At that address, full
- screen Windows does not work. On some systems with a VGA on the
- motherboard, other modes could be unsupported, such as DOS in a window
- and Seamless Windows.
-
- - You will need to modify the settings of your WINOS2 Full Screen session if
- your board is mapped at D8000-DBFFF (The WINOS2 Full Screen driver will not
- be able to find the board). To fix this:
-
- 1. Open the settings of your WINOS2 full screen icon.
-
- 2. Turn to the session page.
-
- 3. Push the WINOS2 settings button.
-
- 4. Set the MEM_EXCLUDE_REGIONS to D8000-DBFFF.
-
- You should do the same for all of your Windows applications running in
- full screen mode.
-
- - MGA boards with BIOS revisions older than 3.40 might experience the
- following problems:
-
- - Opening a DOS Full Screen session results in a blank screen.
-
- - Maximizing (Alt+Home) a DOS Window results in a blank screen.
-
- - Toggling (Alt+Esc) continuously from a Win-OS/2 full screen session
- to the OS/2 PM results in a system hang.
-
- - Only 21 lines are displayed (EGA mode) when you type MODE CO80 from
- a DOS session.
-
- All of the above-stated problems can be resolved by adding the following
- line to the AUTOEXEC.BAT file:
-
- \MGA\OS2\FIXVGA.EXE
-
- A batch file called FIXAUTO.CMD can be used to automatically add the
- above line to your AUTOEXEC.BAT file, for a permanent fix. This batch file
- is installed in your \MGA\OS2 directory.
-
- If your MGA board has a 3.40 revision BIOS (or later), make sure NOT to
- use FIXVGA.EXE.
-
- The BIOS revision may be obtained by running the MGA DOS Setup program.
-
- - Dual-boot users should take note of this significant problem:
-
- When rebooting for DOS using the "DualBoot" icon of the Command Prompts
- folder, the system will reboot, but the MGA card will remain in a high
- resolution mode, and the DOS prompt will not be visible.
-
- Immediate workaround: reset your computer to go to DOS.
-
- Permanent workaround: change the behavior of the DualBoot icon to make
- sure that it goes to full screen mode BEFORE actually rebooting the
- computer.
-
- To do so, follow the procedure below:
-
- 1) Using a text editor, create a file containing the following two lines:
-
- BOOT.EXE /DOS
- PAUSE
-
- Save the file as (for example) BOOTDOS.CMD in your C:\MGA\OS2
- directory.
-
- 2) Edit the "settings" of the dual-boot icon.
-
- - Click on the Session page.
-
- - Remove the check mark from the "Close window on exit" option.
-
- - Change the "OS/2 windows" option to "OS/2 full screen".
-
- In the "Path and filename" field enter:
-
- C:\MGA\OS2\BOOTDOS.CMD
-
- instead of the current BOOT.EXE /DOS line
-
- - The MGA OS/2 driver comes with a special keyboard driver (KBD01.SYS for
- OS/2 2.1 and 2.11 and KBDBASE.SYS for Warp OS/2 3.0). This special driver
- will detect a Ctrl+Alt+Del and reset the MGA board to a proper state before
- the system reboots.
-
- If you install the OS/2 2.1 Service Pack after having installed the MGA
- driver, the Service Pack installation program will detect a different
- keyboard driver and ask you if you want to replace it.
-
- PLEASE DO NOT REPLACE THE KEYBOARD DRIVER.
-
- If you accidentally replace it, simply reinstall the MGA OS/2 Driver
- to restore our special keyboard driver.
-
- - When using the DSPINSTL program to reconfigure your MGA driver, the
- program states that VGA is the current driver. This is a bug in the
- DSPINSTL program that is included by IBM.
-
- - DIVE is not supported in 24 bpp by default (but Multimedia Video player
- still works). If you want to enable 24bpp DIVE, please run:
- \MGA\OS2\MGACONF d 1
- to enable DIVE in 24bpp.
-
- - The MMODE.EXE program included with the Setup & Utilities is not supported
- in a OS/2 DOS Session.
-
- - 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.
-