home *** CD-ROM | disk | FTP | other *** search
/ Chip 1997 April (Special) / Chip-Special_1997-04_cd.bin / matrox / ulos2210 / read.me < prev   
Text File  |  1996-03-13  |  17KB  |  448 lines
  1. README.OS2                 MATROX GRAPHICS INC.                   13-Mar-1996
  2.  
  3.                        The MGA OS/2 PM Display Driver
  4.                               v 2.10.020
  5.  
  6. Product Description
  7. -------------------
  8.  
  9. This MGA OS/2 PM driver supports 8-bit (256 colors), 16-bit (64K colors), 
  10. and 24-bit (16M colors) display modes under OS/2 2.1 up to "Warp", in 
  11. resolutions ranging from 640 x 480 to 1600 x 1200. The driver works on 
  12. all MGA Ultima and Impression models. It also includes a Seamless Windows 
  13. driver.
  14.  
  15. Driver Installation
  16. -------------------
  17.  
  18. To install the software, follow the procedure below:
  19.  
  20.    1. If you are installing this driver for the first time, have the MGA 
  21.       board installed and boot OS/2. Select VGA as the display driver. 
  22.  
  23.    2. If you downloaded the driver from the Matrox BBS, use the DOS LABEL  
  24.       command to label your floppy as OS2.
  25.  
  26.    3. Using the Command Prompts folder of OS/2, open an OS/2 Window or 
  27.       Full Screen session.
  28.  
  29.    4. Insert the driver disk in a floppy drive (if you are installing from 
  30.       the floppy disk) or insert the CD-ROM in its drive bay.
  31.  
  32.    5. Make the CD-ROM or floppy disk the active drive and type:
  33.  
  34.       "SRCPATH\INSTALL", 
  35.       
  36.       where SRCPATH is the path which contains the MGA PM drivers.
  37.  
  38.       Examples:
  39.  
  40.       A:\INSTALL     (if installing from a diskette with OS/2 only)
  41.       A:\OS2\INSTALL (if installing from diskette with OS/2 and NT)
  42.       D:\OS2\INSTALL (if installing from a CD-ROM)
  43.  
  44.    6. You will see a dialog box in which you can select the Primary Display. 
  45.       Choose "Matrox MGA Series". You may have to change the source drive 
  46.       if you are not installing from drive A.
  47.  
  48.    7. The installation program will then proceed with the installation.
  49.       When it is complete, you will have to shut down your system in
  50.       order for the MGA driver to take effect.
  51.  
  52. If you are installing this driver for the first time, or over a version 
  53. older than 2.00, OS/2 will restart in the default MGA resolution 
  54. (640 x 480 x 256). It is therefore advisable to select the desired 
  55. resolution immediately before rebooting, by means of the OS/2
  56. System Setup folder, as explained in the next section.
  57.  
  58. Driver Configuration
  59. --------------------
  60.  
  61. To change the driver mode (resolution or pixel depth), use the
  62. following procedure:
  63.  
  64.    1. Click the right button on the PM desktop background.
  65.  
  66.    2. Select SYSTEM SETUP to open the system setup folder.
  67.  
  68.    3. Double-click on the SYSTEM icon.
  69.    
  70.    4. Select the SCREEN tab and choose the resolution/pixel depth.
  71.  
  72. You will need to reboot the system to see the change take effect.
  73.  
  74. Uninstalling the Driver
  75. -----------------------
  76.  
  77. The OS/2 DSPINSTL.EXE program can be used to switch the display driver 
  78. from MGA mode back to VGA mode, as shown in the following procedure: 
  79.  
  80.    1. Open an OS/2 Text Window (or Full Screen) session.
  81.  
  82.    2. Enter:  CD \OS2\INSTALL
  83.               DSPINSTL
  84.  
  85.    3. Select Primary Display, then choose the driver you require (for
  86.       example, VGA).
  87.  
  88. You will need to reboot the system to see the change take effect.
  89.  
  90. You may want to create an icon for the OS/2 DSPINSTL program if you plan
  91. to use it frequently.
  92.  
  93. Note: With Warp, there are two additional ways to switch the driver from
  94. MGA mode to VGA mode:
  95.    
  96.   1. You can access a menu by pressing Alt+F1 when the OS/2 logo appears
  97.      in the upper left corner of the screen during the bootup process.
  98.      This menu will allow you to change the driver to VGA by selecting
  99.      the appropriate option.
  100.    
  101.   2. You can also change the driver to VGA by running the following file
  102.      in an OS/2 window or full screen session:
  103.  
  104.               \OS2\INSTALL\RSPDSPI.EXE
  105.  
  106. Your MGA OS/2 diskette also comes with an "UNINSTAL" utility. This batch
  107. file removes lines that load the driver from your config.sys file. If used
  108. with the "CLEAN" parameter, the driver files will even be deleted from your
  109. hard drive. The batch file also invokes DSPINSTL so you can select another
  110. display driver. To use the UNINSTAL utility:
  111.  
  112.    1. Open an OS/2 Text Window (or Full Screen) session
  113.  
  114.    2. Enter:  CD \MGA\OS2
  115.               UNINSTAL 
  116.               or 
  117.               UNINSTAL CLEAN
  118.  
  119. Monitor Customization
  120. ---------------------
  121.  
  122. By default, the driver assumes that you have a monitor which supports
  123. all resolutions available to your board at a 60Hz refresh rate (non-
  124. interlaced). If you have a monitor that is capable of refresh rates higher 
  125. than 60Hz, you can perform monitor file customization with the help of the 
  126. MGAMON program. This program creates a file called MGA.INF, which contains 
  127. the appropriate video parameters for your monitor. The MGA.INF file is 
  128. read by the MGA display driver when OS/2 boots.
  129.  
  130. The MGAMON program is located in the \MGA\OS2\ directory. It is a DOS
  131. program, so it must be run in a DOS session (either windowed or full
  132. screen).
  133.  
  134. To run MGAMON, open a DOS session:
  135.  
  136.    1. Enter: CD \MGA\OS2
  137.  
  138.       MGAMON
  139.  
  140.    2. Select a monitor and exit the program.
  141.  
  142. You must shut down OS/2 and reboot your computer for the changes to take 
  143. effect.
  144.  
  145. Board Testing
  146. -------------
  147.  
  148. If you encounter any problems running OS/2 with your board, you should
  149. first determine whether it is a system or hardware problem. The best way
  150. to check for a potential hardware problem is to use the MGA SETUP program.
  151.  
  152. SETUP is a DOS program that is included on the MGA CAD Driver disk,
  153. version 1.50 and later. It cannot be run from an OS/2 Command Prompt
  154. session.
  155.  
  156. If you have a DOS (FAT) partition on your hard disk, simply install the
  157. Setup and Utilities product using the provided installation program. Then 
  158. go to the \MGA\SETUP directory and type SETUP.
  159.  
  160. If you do not have a DOS partition, you will have to create a bootable
  161. disk that has SETUP on it. Here is the procedure:
  162.  
  163.    1. Insert the proper installation disk in your diskette drive.
  164.  
  165.    2. Copy A:\SETUP\FILES1.ZIP and A:\PKUNZIP.EXE to a location on your 
  166.       hard disk.
  167.  
  168.    3. Make that hard disk location current and type "PKUNZIP FILES1" 
  169.       to unarchive the files.
  170.  
  171.    4. Remove the installation disk and format a new bootable DOS disk.
  172.  
  173.    5. Copy the following files from your hard disk to your new floppy disk:
  174.             
  175.               SETUP.EXE, DOS4GW.EXE, MGA.MON
  176.  
  177.    6. Reboot your computer with the the new disk.
  178.  
  179.    7. Type SETUP.
  180.  
  181. In SETUP, select "Graphic Mode Test" to test the various modes that
  182. are available for your board. The program will not attempt to test a
  183. mode which is not supported by your board. The default test will be
  184. done at a 60Hz refresh rate for all resolutions.
  185.  
  186. If you have a customized monitor file (MGA.INF) in your \MGA\OS2
  187. subdirectory, SETUP can read it and act upon it if you set the MGA
  188. environment variable as shown below:
  189.  
  190.            SET MGA=C:\MGA\OS2
  191.  
  192. Driver History
  193. --------------
  194.  
  195. 2.00A3
  196.      - 32-bit driver supporting 8, and 24 bpp color.
  197.      - Added "clean" option to UNINSTAL.CMD for removing old MGA PM drivers
  198.        from the hard disk. The UNINSTAL CLEAN command may be used to clean 
  199.        previous or current versions of the MGA driver.
  200.      - Resolution switching is now done by a system setting.
  201.      - Warp (OS/2 v3.00) supported.
  202.  
  203. 2.00.001
  204.      - Added 16 bpp color.
  205.      - Added DIVE support for 8 and 16 bpp (does not work under 24 bpp).
  206.      - The Version and the Corrective service level now may be obtained via
  207.        the SYSLEVEL command.
  208.  
  209. 2.00.002
  210.     - Fixed cursor and palette problems on ViewPoint 2026.
  211.     - Added MGACONF.CMD to switch WaitVsync on and off (cursor problem
  212.       on ViewPoint 2026 while updating the palette).
  213.     - Fixed getpixel.
  214.  
  215. 2.00.003
  216.     - Updated sxcios2.dll (monitor).
  217.  
  218. 2.00.004
  219.     - Fixed exit progman seamless in 24 bpp Imp+.
  220.     - Fixed magnify glass in filenet display.
  221.     - New MGA.MON file.
  222.  
  223. 2.00.005
  224.     - Fixed text when running Seamless Windows.
  225.     - Fixed some color and redraw problems in Seamless Windows.
  226.     - Fixed DIVE.
  227.  
  228. 2.00.007
  229.     - Fixed Reversi (PolyScanline).
  230.     - Fixed Text in DTT.EXE (opaque text).
  231.     - Fixed clearing the VRAM (garbage on screen) before setting MGA mode.
  232.     - Fixed Seamless refresh problem (PowerPoint, Word).
  233.  
  234. 2.00.008
  235.     - Fixed offscreen font caching on MGA Pro 4.5/V.
  236.     - Improved the look of the color-hardware cursor.
  237.     - Fixed the color-cursor hotspot.
  238.  
  239. 2.00.009
  240.     - Fixed WinOS2 full screen (on 200b7 and 200b8).
  241.     - Fixed off-screen font caching on VLB2+ board (on 200b8 only).
  242.     - Added 24 bpp DIVE support (used EnDIVE to return ColorEncoding).
  243.  
  244. 2.00.010
  245.     - Fixed font cache problem in pm 1600 x 1200 x 8.
  246.     - Fixed font cache problem in winos2 seamless 1600 x 1200 x 16.
  247.     - Fixed refresh problem in WinWord seamless when displaying the 
  248.       yellow tabs.
  249.     - Fixed fuzzy text in the settings popup window.
  250.     - Fixed lockup when switching from winos2 fullcreen to pm
  251.     - Remove DIVE supported in 24bpp.
  252.  
  253. 2.01.011
  254.     - Fixed bitblt from color to mono.
  255.     - Fixed the different betwen bitmap and screen in drawing dash line.
  256.     - Fixed the pattern color in Coreldraw 2.5 for OS/2
  257.     - Fixed the poly disjoint line to draw the last pixel.
  258.     - Add software cursor.  The software cursor can be disable using
  259.       mgaconf.cmd in \mga\os2 directory.
  260.     - Add switches to change the system font, font resolution and AVIO font.
  261.         The default value for those setting are:
  262.                         Sytem Font  Font res   Avio Font
  263.         640x480             100         96        8x14
  264.         800x600             100         96        8x14
  265.         1024x768            101         120       12x22
  266.         1152x882            102         120       12x22
  267.         1280x1024           102         120       12x22
  268.         1600x1200           102         120       12x22
  269.         If you want to change any default for any resolution, please run
  270.         mgaconf.cmd in \mga\os2 directory.
  271.  
  272. 2.01.012
  273.     - Fixed Cursor in scramble.exe (os2 2.11).
  274.     - add option /U in install.cmd for unattended install (work on Warp only).
  275.         i.e. now you can type:
  276.             a:\install /u
  277.         and every thing will be install in one shot without any further input
  278.         from user (primary, secondary selection, driver selection, and
  279.         source disk/path selection)
  280.  
  281. 2.01.013
  282.     - add 24bpp DIVE switch to mgaconf.cmd. To enable 24bpp DIVE, please run:
  283.         c:\mga\os2\mgaconf.cmd d 1
  284.       and reboot the computer.
  285.  
  286. 2.02.014
  287.     - Fixed dump memory problem (switch to text mode when dump).
  288.     - Fixed pattern problem in 1600x1200@24bpp MGA-IMP 3/V/H
  289.     - Fixed Exeption error when mgakrnl.sys is in config.sys but mga32.dll
  290.       is not running.
  291.     - Fixed not to remove DEVINFO=VGA,... from config.sys when install mga
  292.     - Fixed switch to DOS or OS/2 fullscreen problem on some 3026 RAMdAC.
  293.  
  294. 2.03.015
  295.     - Fixed STM0015, STM0016, STM0018: Selective Install window did not refresh
  296.       when move out and in the display. @800x600x8 (also with 16 and 32bpp)
  297.     - Fixed STM0005, STM0020: the outline of the hilight change color (or
  298.       disapear) when part of it is refresh. (cover it and uncover it).
  299.     - Fixed STM0006 dtt.exe -> GreAttr -> GreDeviceSetGetAttrExh, reverse pattern.
  300.     - Fixed STM0021 small black dot at top left corner of any window.
  301.     - Fixed STM0017 color cursor in scheme palette.
  302.     - Fixed STM0007 last marker position.
  303.     - Fixed Seamless Excel 5.0 scrolling problem @1280x1024x8bpp.
  304.  
  305. 2.03.016 Fixed:
  306.     - STM0031 WinOS2 fullscreen switching problem.
  307.     - STM0034 OS/2 Chess.
  308.  
  309. 2.03.017 Fixed:
  310.     - STM0033 Seamless with software cursor.
  311.     - SQA2584 WinOS2 fullscreen switching problem with mouse.
  312.  
  313. 2.03.018
  314.     - Fixed bug with text in WinOS2 (both fullscreen & seamless).
  315.  
  316. 2.10.019
  317.     - Fixed Alt-Esc switching hang when switching between PM Desktop and
  318.       full-screen WinOS2.
  319.     - Fixed OEM app problem (wrong colours used when displaying a 4bpp bmp
  320.       in 24bpp mode).
  321.  
  322. 2.10.020
  323.     - Fixed hang that occurred when returning to the PM desktop from a FS
  324.       WinOS2 session.
  325.  
  326.  
  327. KNOWN BUGS AND LIMITATIONS
  328. --------------------------
  329.  
  330. The following bugs and limitations are present in this release of the
  331. driver:
  332.  
  333. - AT (ISA) and VL boards mapped at AC000: We don't advise that you use the
  334.   (default) mapping of AC000 with this OS/2 driver. At that address, full 
  335.   screen Windows does not work. On some systems with a VGA on the 
  336.   motherboard, other modes could be unsupported, such as DOS in a window 
  337.   and Seamless Windows.
  338.  
  339. - You will need to modify the settings of your WINOS2 Full Screen session if
  340.   your board is mapped at D8000-DBFFF (The WINOS2 Full Screen driver will not 
  341.   be able to find the board). To fix this:
  342.  
  343.     1. Open the settings of your WINOS2 full screen icon.
  344.  
  345.     2. Turn to the session page.
  346.  
  347.     3. Push the WINOS2 settings button.
  348.  
  349.     4. Set the MEM_EXCLUDE_REGIONS to D8000-DBFFF.
  350.  
  351.   You should do the same for all of your Windows applications running in 
  352.   full screen mode.
  353.  
  354. - MGA boards with BIOS revisions older than 3.40 might experience the 
  355.   following problems:  
  356.  
  357.     - Opening a DOS Full Screen session results in a blank screen.
  358.  
  359.     - Maximizing (Alt+Home) a DOS Window results in a blank screen.
  360.  
  361.     - Toggling (Alt+Esc) continuously from a Win-OS/2 full screen session 
  362.       to the OS/2 PM results in a system hang.
  363.  
  364.     - Only 21 lines are displayed (EGA mode) when you type MODE CO80 from 
  365.       a DOS session.
  366.  
  367.   All of the above-stated problems can be resolved by adding the following 
  368.   line to the AUTOEXEC.BAT file:
  369.  
  370.            \MGA\OS2\FIXVGA.EXE
  371.  
  372.   A batch file called FIXAUTO.CMD can be used to automatically add the
  373.   above line to your AUTOEXEC.BAT file, for a permanent fix. This batch file
  374.   is installed in your \MGA\OS2 directory.
  375.  
  376.   If your MGA board has a 3.40 revision BIOS (or later), make sure NOT to 
  377.   use FIXVGA.EXE.
  378.  
  379.   The BIOS revision may be obtained by running the MGA DOS Setup program.
  380.  
  381. - Dual-boot users should take note of this significant problem:
  382.  
  383.   When rebooting for DOS using the "DualBoot" icon of the Command Prompts
  384.   folder, the system will reboot, but the MGA card will remain in a high 
  385.   resolution mode, and the DOS prompt will not be visible.
  386.  
  387.   Immediate workaround: reset your computer to go to DOS.
  388.  
  389.   Permanent workaround: change the behavior of the DualBoot icon to make
  390.   sure that it goes to full screen mode BEFORE actually rebooting the 
  391.   computer.
  392.  
  393.   To do so, follow the procedure below:
  394.  
  395.   1) Using a text editor, create a file containing the following two lines:
  396.  
  397.            BOOT.EXE /DOS
  398.            PAUSE
  399.  
  400.      Save the file as (for example) BOOTDOS.CMD in your C:\MGA\OS2 
  401.      directory.
  402.  
  403.   2) Edit the "settings" of the dual-boot icon. 
  404.  
  405.      - Click on the Session page. 
  406.  
  407.      - Remove the check mark from the "Close window on exit" option.
  408.  
  409.      - Change the "OS/2 windows" option to "OS/2 full screen".
  410.  
  411.      In the "Path and filename" field enter:
  412.  
  413.            C:\MGA\OS2\BOOTDOS.CMD
  414.      
  415.      instead of the current BOOT.EXE /DOS line
  416.  
  417. - The MGA OS/2 driver comes with a special keyboard driver (KBD01.SYS for 
  418.   OS/2 2.1 and 2.11 and KBDBASE.SYS for Warp OS/2 3.0). This special driver 
  419.   will detect a Ctrl+Alt+Del and reset the MGA board to a proper state before 
  420.   the system reboots.
  421.  
  422.   If you install the OS/2 2.1 Service Pack after having installed the MGA
  423.   driver, the Service Pack installation program will detect a different 
  424.   keyboard driver and ask you if you want to replace it. 
  425.  
  426.   PLEASE DO NOT REPLACE THE KEYBOARD DRIVER. 
  427.  
  428.   If you accidentally replace it, simply reinstall the MGA OS/2 Driver
  429.   to restore our special keyboard driver.
  430.  
  431. - When using the DSPINSTL program to reconfigure your MGA driver, the 
  432.   program states that VGA is the current driver. This is a bug in the 
  433.   DSPINSTL program that is included by IBM.
  434.  
  435. - DIVE is not supported in 24 bpp by default (but Multimedia Video player
  436.   still works).  If you want to enable 24bpp DIVE, please run:
  437.     \MGA\OS2\MGACONF d 1
  438.   to enable DIVE in 24bpp.
  439.  
  440. - The MMODE.EXE program included with the Setup & Utilities is not supported
  441.   in a OS/2 DOS Session.
  442.  
  443. - The MGA PowerDesk Windows drivers should NOT be used in a Win-OS/2 full 
  444.   screen session. The results will be highly unpredictable.
  445.   If the MGA windows driver features are absolutely needed, then a dual-boot 
  446.   configuration must be used. When booting from DOS, the PowerDesk Windows 
  447.   driver features are fully supported.  
  448.