home *** CD-ROM | disk | FTP | other *** search
/ MGA Millennium Bulk / BLK_5_FEB_96.iso / os2 / readme.os2 < prev    next >
Text File  |  1996-01-03  |  16KB  |  432 lines
  1. README.OS2                MATROX GRAPHICS INC.                    4-Jan-1996
  2.  
  3.                   The MGA Millennium OS/2 PM Display Driver
  4.                            v 1.11 (build 019)
  5.  
  6. Product Description
  7. -------------------
  8.  
  9. The MGA Millennium OS/2 PM driver supports 8-bit (256 colors), 16-bit (64K 
  10. colors), and 32-bit (16M colors) display modes under OS/2 2.1 and 3.0 (Warp),
  11. in resolutions ranging from 640 x 480 to 1600 x 1280.
  12.  
  13. Driver Installation
  14. -------------------
  15.  
  16. To install the software, follow the procedure below:
  17.  
  18.    1. If you are installing this driver for the first time, have the MGA 
  19.       board installed and boot OS/2. Select VGA as the display driver. 
  20.  
  21.    2. If you downloaded the driver from the Matrox BBS, use the DOS LABEL  
  22.       command to label your floppy as OS2.
  23.  
  24.    3. Using the Command Prompts folder of OS/2, open an OS/2 Window or 
  25.       Full Screen session.
  26.  
  27.    4. Insert the driver disk in a floppy drive (if you are installing from 
  28.       the floppy disk) or insert the CD-ROM in its drive bay.
  29.  
  30.    5. Make the CD-ROM or floppy disk the active drive and type:
  31.  
  32.       "SRCPATH\INSTALL", 
  33.       
  34.       where SRCPATH is the path which contains the MGA PM drivers.
  35.  
  36.       Examples:
  37.  
  38.       A:\INSTALL     (if installing from a diskette with OS/2 only)
  39.       A:\OS2\INSTALL (if installing from diskette with OS/2 and NT)
  40.       D:\OS2\INSTALL (if installing from a CD-ROM)
  41.  
  42.       Note: if you install this driver to a Warp System, you may run
  43.  
  44.       \INSTALL /u
  45.  
  46.       and every thing will be installed without any further input from the
  47.       user (primary, secondary selection, driver selection, and source 
  48.       disk/path selection). 
  49.  
  50.    6. You will see a dialog box in which you can select the Primary Display. 
  51.       Choose "Matrox MGA Millennium Series". You may have to change the source 
  52.       drive if you are not installing from drive A.
  53.  
  54.    7. The installation program will then proceed with the installation.
  55.       When it is complete, you will have to shut down your system in
  56.       order for the MGA driver to take effect.
  57.  
  58. If you are installing this driver for the first time, OS/2 will restart in 
  59. Matrox default MGA resolution (640 x 480 x 256). It is therefore advisable 
  60. to select the desired resolution just BEFORE rebooting, by means of the OS/2
  61. System Setup folder, as explained in the next section.
  62.  
  63. Note: If you are using Selective Install in OS/2 Warp, the MGA Millennium
  64.       driver shows up as "Other."
  65.  
  66.  
  67. Driver Configuration
  68. --------------------
  69.  
  70. To change the driver mode (resolution or pixel depth), use the
  71. following procedure:
  72.  
  73.    1. Click the right button on the PM desktop background.
  74.  
  75.    2. Select SYSTEM SETUP to open the system setup folder.
  76.  
  77.    3. Double-click on the SYSTEM icon.
  78.    
  79.    4. Select the SCREEN tab and choose the resolution/pixel depth.
  80.  
  81. You will need to reboot the system to see the change take effect.
  82.  
  83. Uninstalling the Driver
  84. -----------------------
  85.  
  86. The Matrox UNINSTAL command file makes use of the OS/2 DSPINSTL.EXE program
  87. to switch the display driver from MGA mode back to VGA mode, as shown in the 
  88. following procedure: 
  89.  
  90.    1. Open an OS/2 Text Window (or Full Screen) session.
  91.  
  92.    2. Enter:  CD \MGA\OS2
  93.  
  94.       UNINSTAL
  95.       or 
  96.       UNINSTAL CLEAN (to also delete the Matrox files from your hard disk)
  97.  
  98.    3. Select Primary Display, then choose the driver you require (for
  99.       example, VGA).
  100.  
  101. You will need to reboot the system to see the change take effect.
  102.  
  103. Note: With Warp, there are two additional ways to switch the driver from
  104. MGA mode to VGA mode:
  105.    
  106.   1. You can access a menu by pressing Alt+F1 when the OS/2 logo appears
  107.      in the upper left corner of the screen during the bootup process.
  108.      This menu will allow you to change the driver to VGA by selecting
  109.      the appropriate option.
  110.    
  111.   2. You can also change the driver to VGA by running the following file
  112.      in an OS/2 window or full screen session:
  113.  
  114.               \OS2\INSTALL\RSPDSPI.EXE
  115.  
  116. Monitor Customization
  117. ---------------------
  118.  
  119. The OS/2 Millennium driver supports VESA DDC-1 and DDC-2B compliant monitors. 
  120.  
  121. If your monitor is not detected as DDC compliant, the driver will take the 
  122. "Unknown Monitor" hardcoded timings, which assume that you have a monitor 
  123. supporting all resolutions available on your board, at a 60Hz refresh rate 
  124. (non-interlaced). 
  125.  
  126. If you have a monitor that is capable of refresh rates higher than 60Hz, you 
  127. can perform monitor file customization with the help of the MGAMON program. 
  128. This program creates a file called MGA.INF, which contains the appropriate 
  129. video parameters for your monitor. The MGA.INF file is read by the MGA display 
  130. driver when OS/2 boots.
  131.  
  132. The MGAMON program is located in the \MGA\OS2\ directory. It is a DOS program, 
  133. so it must be run in a DOS session (either windowed or full screen).
  134.  
  135. To run MGAMON, open a DOS session:
  136.  
  137.    1. Enter: CD \MGA\OS2
  138.  
  139.       MGAMON
  140.  
  141.    2. Select a monitor and exit the program.
  142.  
  143. You must shut down OS/2 and reboot your computer for the changes to take
  144. effect.
  145.  
  146. NOTE: The timing information in MGA.INF over-rides the timing info returned
  147.       by DDC compliant monitors. If you are using a DDC compliant monitor,
  148.       and you do not wish to over-ride the monitor's timing info, then 
  149.       delete the MGA.INF file from your \MGA\OS2\ directory.
  150.  
  151.  
  152. Driver configuration 
  153. --------------------
  154.  
  155. Advanced configuration of the MGA driver can be performed through the
  156. MGACONF.CMD command file, located in the \mga\os2 directory.
  157.  
  158. MGACONF performs the following:
  159.  
  160. 1. Font settings
  161.  
  162.    MGACONF has a switch to change the font settings:
  163.    
  164.    mgaconf f
  165.  
  166.    You will be prompted for the resolution to affect and the parameter to
  167.    change: System Font (desktop menu font), Font Resolution (desktop icon
  168.    font) or Avio Font (font inDOS and OS/2 windows). 
  169.  
  170.    Command line input is also possible, the syntax being:
  171.  
  172.    mgaconf f "resolution" "which_parameter" "parameter_value", where
  173.  
  174.               0-640X480    0-SystemFont      0-Small(100)
  175.               1-800X600                      1-Medium(101)
  176.               2-1024X768                     2-Large(102)
  177.               3-1152X882                     
  178.               4-1280X1024  1-FontResolution  0-96dpi
  179.               5-1600X1200                    1-120dpi
  180.               6-1600x1280
  181.                            2-AvioFont        0-8x8
  182.                                              1-10x6
  183.                                              2-10x8
  184.                                              3-12x8
  185.                                              4-14x6
  186.                                              5-14x8
  187.                                              : ...
  188.                                              9-18x8
  189.                                              a-18x10
  190.                                              : ...
  191.                                              e-30x12
  192.  
  193.    Example:
  194.  
  195.    To change the 1280X1024 resolution to use the small system font, 96 dpi
  196.    and 8x14 Avio font, the following three lines must be entered:
  197.  
  198.    mgaconf f 4 0 0   
  199.    mgaconf f 4 1 0
  200.    mgaconf f 4 2 5
  201.  
  202.    Note that the default values for the fonts are:
  203.  
  204.                        Sytem Font  Font res  Avio Font
  205.    640x480             100         96        8x14
  206.    800x600             100         96        8x14
  207.    1024x768            101         120       12x22
  208.    1152x882            102         120       12x22
  209.    1280x1024           102         120       12x22
  210.    1600x1200           102         120       12x22
  211.    1600x1280           102         120       12x22
  212.  
  213. 2. Color cursor
  214.  
  215.    mgaconf c [0/1/2],
  216.  
  217.    where 0 will disable the software cursor (you will have 2 or less colors
  218.            in the cursor)
  219.          1 will enable the software cursor (multicolor cursor)
  220.          2 will enable the software cursor if the cursor has 4 or more colors
  221.  
  222.    Default is 1.
  223.  
  224. 3. Cursor Vsync
  225.  
  226.    The cursor may exhibit some "noise" when an application changes the color 
  227.    palette. This switch forces to wait for a Vsync before changing the palette.
  228.    The drawback is a loss of speed when changing the palette. Some animated 
  229.    application requires fast changing palette. This switch applies only to 
  230.    8 bpp.
  231.  
  232.    mgaconf v 0      (off)
  233.    mgaconf v 1      (on)
  234.  
  235.    Default is 1. 
  236.  
  237. 4. DIVE switch
  238.  
  239.    Due to an OS/2 problem in 24 bpp, the Warp AVIO player video image will
  240.    be shifted to the left.
  241.  
  242.    MGACONF has a switch to enable DIVE in 24 bpp:
  243.  
  244.    mgaconf d 1 (ON)
  245.    mgaconf d 0 (OFF)
  246.  
  247.    Default is OFF for 24bpp and ON for 8 and 16 bpp.
  248.  
  249. 5. Grayscale driver switch
  250.  
  251.    Owners of the Millennium PowerDoc Edition may enable the grayscale driver
  252.    switch, which defines whether 8 bits per pixel should be in 256 colors or
  253.    256 gray shades.
  254.  
  255.    mgaconf g 1 (Grayscale)
  256.    mgaconf g 0 (Color)
  257.  
  258. For all options of MGACONF, you must reboot your computer to see the change 
  259. take effect.
  260.  
  261. Board Testing
  262. -------------
  263.  
  264. If you encounter any problems running OS/2 with your board, you should
  265. first determine whether it is a system or hardware problem. The best way
  266. to check for a potential hardware problem is to use the MGA SETUP program.
  267.  
  268. SETUP is a DOS program that is included on the MGA CAD Driver disk,
  269. It cannot be run from an OS/2 Command Prompt session.
  270.  
  271. If you have a DOS (FAT) partition on your hard disk, simply install the
  272. Setup and Utilities product using the provided installation program. Then 
  273. go to the \MGA\SETUP directory and type SETUP.
  274.  
  275. If you do not have a DOS partition, you will have to create a bootable
  276. disk that has SETUP on it. Here is the procedure:
  277.  
  278.    1. Insert the proper installation disk in your diskette drive.
  279.  
  280.    2. Copy A:\SETUP\FILES1.ZIP and A:\PKUNZIP.EXE to a location on your 
  281.       hard disk.
  282.  
  283.    3. Make that hard disk location current and type "PKUNZIP FILES1" 
  284.       to unarchive the files.
  285.  
  286.    4. Remove the installation disk and format a new bootable DOS disk.
  287.  
  288.    5. Copy the following files from your hard disk to your new floppy disk:
  289.             
  290.               SETUP.EXE, DOS4GW.EXE, MGA.MON
  291.  
  292.    6. Reboot your computer with the the new disk.
  293.  
  294.    7. Type SETUP.
  295.  
  296. In SETUP, select "Graphic Mode Test" to test the various modes that
  297. are available for your board. The program will not attempt to test a
  298. mode which is not supported by your board. The default test will be
  299. done at a 60Hz refresh rate for all resolutions.
  300.  
  301. If you have a customized monitor file (MGA.INF) in your \MGA\OS2
  302. subdirectory, SETUP can read it and act upon it if you set the MGA
  303. environment variable as shown below:
  304.  
  305.            SET MGA=C:\MGA\OS2
  306.  
  307. File description
  308. ----------------
  309.  
  310. Assume: <S> -> Source path
  311.         <D> -> Destination drive (OS/2 system drive).
  312.         <W> -> WinOS/2 or Windows path (\os2\mdos\winos2 or \windows)
  313.  
  314. <S>\INSTALL.CMD     --> stay where it is.
  315. <S>\FIXAUTO.CMD     --> <D>:\MGA\OS2
  316. <S>\UNINSTAL.CMD    --> <D>:\MGA\OS2
  317. <S>\MGAX64.OS2      --> <D>:\MGA\OS2\SYSLEVEL.MIL
  318.    (pack file)          <D>:\MGA\OS2\MGACONF.CMD
  319.                         <D>:\MGA\OS2\MGAX64S.DSP
  320.                         <D>:\OS2\DLL\PMGAX64.DLL
  321.                         <D>:\OS2\DLL\BMGAX64.DLL
  322.                         <D>:\MGA\OS2\KMGAX64.SYS
  323.                         <D>:\OS2\MDOS\VMGAX64.SYS
  324. <S>\MGAX64W.OS2     --> <W>:\SMGAX64.DRV
  325.    (pack file)          <W>:\MGAX64.DLL
  326. <S>\MGAX64.DSP      --> stay where it is.
  327. <S>\VVGA.SYS        --> <D>:\MGA\OS2 and <D>:\OS2\MDOS
  328. <S>\MGAX64.DSC      --> <D>:\OS2\INSTALL
  329. <S>\MGA.MON         --> <D>:\MGA\OS2
  330. <S>\MGAMON.EXE      --> <D>:\MGA\OS2
  331. <S>\README.OS2      --> <D>:\MGA\OS2
  332.  
  333.  MGAX64.DSP     installation support file for "dspinst" (for first install)
  334.  MGAX64S.DSP    installation support file for "dspinst" (for re-install)
  335.  MGAX64.DSC     installation support file
  336.  MGAX64.DLL     initialization library for WinOS2 fullscreen
  337. BMGAX64.DLL     Base Video Handle (sets VGA for OS/2 fullscreen)
  338. PMGAX64.DLL     32bit PM driver (8, 16 and 32bpp)
  339. KMGAX64.SYS     low-level initialization for 32bit PM driver
  340. SMGAX64.DRV     WinOS2 Fullscreen and Seamless driver
  341. VMGAX64.SYS     Virtual MGA Millennium driver (for DOS sessions)
  342. VVGA.SYS        Modified IBM VGA virtual driver.
  343. README.OS2      Readme file
  344. INSTALL.CMD     first time installation
  345. MGACONF.CMD     Configuration utility for MGA Millennium PM driver
  346. FIXAUTO.CMD     inserts "SET MGA=C:\MGA\OS2" in autoexec.bat (WinOS2)
  347. UNINSTAL.CMD    uninstalls driver (and removes all Millennium files from
  348.                 hard drive)
  349. MGA.MON         MGA Monitor data file for MGAMON.EXE 
  350. MGAMON.EXE      Monitor program to create MGA.INF out of MGA.MON
  351. SYSLEVEL.MIL    driver Version info
  352.                 (use OS/2 command syslevel.exe to obtain the driver Version)
  353.  
  354. Driver History
  355. --------------
  356.  
  357. 1.00 (build 007) 9 June 95
  358. - first release
  359.  
  360. 1.01 (build 008)
  361. - Fixed STM0003 dtt.exe -> GreBitMaps -> GreImagedataExh, missing left part of the
  362.   triangle.
  363. - Fixed STM0015, STM0016, STM0018: Selective Install window did not refresh
  364.   when move out and in the display. @800x600x8 (also with 16 and 32bpp)
  365. - Fixed STM0019 clear the display after setmode.
  366. - Fixed STM0005, STM0020: the outline of the hilight change color (or disapear)
  367.   when part of it is refresh. (cover it and uncover it).
  368. - Fixed STM0006 dtt.exe -> GreAttr -> GreDeviceSetGetAttrExh, reverse pattern.
  369. - Fixed STM0021 small black dot at top left corner of any window.
  370. - Fixed STM0017 color cursor in scheme palette.
  371. - Fixed STM0007 last marker position.
  372. - Fixed STM0031 WinOS2 fullscreen switching problem.
  373. - Fixed STM0034 OS/2 Chess.
  374. - Fixed STM0033 Software cursor with Seamless Windows.
  375. - Add Grayscale & 1600x1280 supported (DIP board only).
  376. - Fixed #2719 problem with non-DDC Qvision 172 monitor.
  377.  
  378. 1.01 (build 009)
  379. - Maintenance version based on build 007.
  380.  
  381. 1.10 (build 010)
  382. - New version number, based on build 008.
  383.  
  384. 1.10 (build 011)
  385. - Fixed problem with rectangle fill in Seamless Windows Paintbrush.
  386.  
  387. 1.11 (build 018)
  388. - Fixed Alt-Esc switching hang when switching between PM Desktop and
  389.      full-screen WinOS2.
  390. - Fixed problems running TCPY and MEMTEST test applications.
  391. - Fixed problem with Novell "SEND" command.
  392. - Fixed problem running IBM PCM Acceptance test.
  393. - Fixed problem openning DOS session on DELL systems.
  394. - Fixed booting problem on PentiumPro systems.
  395. - Added support for monitors capable of providing DDC Standand and Detailed
  396.      timing informations.
  397.  
  398. 1.11 (build 019)
  399. - Fixed GPF bug when launching WinOS2 Program Manager in Seamless mode.
  400. - Fixed Alt-Esc problem when switching from Klondike (auto-play) to
  401.      full-screen DOS.
  402.  
  403. KNOWN BUGS AND LIMITATIONS
  404. --------------------------
  405.  
  406. The following bugs and limitations are present in this release of the
  407. driver:
  408.  
  409. - When using the DSPINSTL program to reconfigure your MGA driver, the 
  410.   program states that VGA is the current driver. This is because the
  411.   DSPINSTL program included with OS/2 does not correctly identify the
  412.   MGA Millennium.
  413.  
  414. - The MGA PowerDesk Windows drivers should NOT be used in a Win-OS/2 full 
  415.   screen session. The results will be highly unpredictable.
  416.   If the MGA windows driver features are absolutely needed, then a dual-boot 
  417.   configuration must be used. When booting from DOS, the PowerDesk Windows 
  418.   driver features are fully supported.
  419.  
  420. - The driver does not work with Mayo Clinic Family Heath Book (Windows app.)
  421.   in seamless Windows at 16bpp (64K colors).  If you need to run this
  422.   application, please run it in WinOS2 fullscreen instead or you may have
  423.   to change the pixel depth to 8bpp or 24bpp.
  424.  
  425. - When switching quickly from PM desktop to full-screen WinOS2, the
  426.   WinOS2 desktop may get corrupted. To restore the WinOS2 desktop,
  427.   do a slow switch to PM Desktop and back to WinOS2.
  428.  
  429. - This diskette does not support CID. Contact our technical support to get 
  430.   our CID upgrade kit.
  431. 
  432.