home *** CD-ROM | disk | FTP | other *** search
/ Enter 1999 April - Disc 1 / enter_04_1999_1.iso / OS2 / SDD / IBMGRADD / README.TXT < prev    next >
Encoding:
Text File  |  1998-01-21  |  12.4 KB  |  402 lines
  1.   Graphics Adapter Device Drivers (GRADD)
  2.   ───────────────────────────────────────
  3.  
  4.   OS/2 Warp 4  introduced a new graphics adapter device driver (GRADD)
  5.   architecture that makes it easier to support new hardware as it becomes
  6.   available.  Enhanced PM applications performance can be realized when using
  7.   accelerated GRADD drivers.
  8.  
  9.   Several new and updated GRADD drivers are included with this package.
  10.  
  11.       This README file, which is formatted for viewing on your screen.  You
  12.       can:
  13.       -   Use the Table of Contents and page numbers (which appear at the top of
  14.           each page) to help you locate specific topics.
  15.       -   Use the Find option in the Edit menu of the OS/2 System Editor to help
  16.           you locate specific information.
  17.       -   Print the file.
  18.  
  19.  
  20.   IMPORTANT
  21.  
  22.   PLEASE READ THE FOLLOWING TERMS AND CONDITIONS.  YOUR USE OF THE OS/2 GENGRADD
  23.   DEVICE DRIVER INDICATES YOUR ACCEPTANCE OF THE FOLLOWING TERMS AND CONDITIONS:
  24.  
  25.   o   YOU MUST BE, AND YOU AGREE THAT YOU ARE, A PRIOR LICENSEE OF OS/2.
  26.   o   YOU MAY MAKE COPIES OF THE OS/2 GRAPHICS ADAPTER DEVICE DRIVERS (GRADD)
  27.       EQUAL TO THE NUMBER OF LICENSED COPIES OF OS/2 YOU POSSESS.
  28.   o   ALL OTHER TERMS AND CONDITIONS OF YOUR OS/2 LICENSE AGREEMENT APPLY TO
  29.       THESE OS/2 GRADD DEVICE DRIVERS; HOWEVER, THIS DOES NOT EXTEND ANY
  30.       WARRANTY OUTLINED IN SUCH AGREEMENT.
  31.  
  32.  
  33.   CONTENTS
  34.   ________
  35.  
  36.  
  37.   Supported Features   . . . . . . . . . . . . . . .  2
  38.     Supported Adapters   . . . . . . . . . . . . . .  2
  39.     Supported Resolutions  . . . . . . . . . . . . .  2
  40.   Compatibility  . . . . . . . . . . . . . . . . . .  2
  41.   Preliminary Steps  . . . . . . . . . . . . . . . .  3
  42.   Installation from Diskette   . . . . . . . . . . .  3
  43.   Installation in a CID Environment  . . . . . . . .  4
  44.   Setting Your Display to VGA Mode   . . . . . . . .  6
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                                                           Page 1
  65.  
  66.  
  67.  
  68.   SUPPORTED FEATURES
  69.   __________________
  70.  
  71.   The GRADD device drivers provide seamless support for accelerated/
  72.   unaccelerated display graphics and advanced color depth and resolutions. They
  73.   conform to the OS/2 32-bit flat memory model and are designed to function as
  74.   32-bit Presentation Manager* graphics display drivers under the OS/2 32-bit
  75.   graphics engine.
  76.  
  77.   SUPPORTED ADAPTERS
  78.  
  79.   The following accelerated GRADD drivers are provided:
  80.  
  81.       * ATI Rage II/Mach 64 GRADD       (M64GRADD)
  82.       * Chips & Technology 6555X GRADD  (CHPGRADD)
  83.       * Matrox Millenium/Mystique GRADD (MGAGRADD)
  84.       * S3 864/TRIO GRADD               (S3GRADD)
  85.       * S3 Virge/Virge VX GRADD         (S3DGRADD)
  86.  
  87.   Also included are generic VGA and SVGA support.
  88.  
  89.       * Video Graphics Array GRADD      (VGAGRADD)
  90.       * Generic SVGA GRADD              (GENGRADD)
  91.  
  92.   All of the drivers listed, except for VGAGRADD, require VESA compliant video
  93.   BIOS (Version 1.2 or greater).
  94.  
  95.   If an accelerated GRADD or PM driver is not available for your adapter,
  96.   GENGRADD may provide UNACCELERATED support for  display graphics at enhanced
  97.   resolutions and colors depths.  GENGRADD will work with most adapters
  98.   that implement VESA compliant BIOS and the performance, which will vary
  99.   depending on system configuration, will not be as good as an accelerated
  100.   driver.
  101.  
  102.   IBM has tested a number of systems and adapters incorporating the graphics
  103.   devices for the accelerated drivers listed.  Testing was only done on systems
  104.   with PCI bus graphics.
  105.  
  106.   Current known restrictions are the following:
  107.  
  108.      ATI Mach 64 ISA Bus adapters currently not supported.
  109.  
  110. NOTE:
  111.  
  112.   Sniff testing on ISA bus graphics adapters has worked. However when trying
  113.   to restore your previous "PM" driver, there was a problem in detecting
  114.   the adapter.  Powering off the system to initialize the adapter after
  115.   restoring VGA should solve the problem.
  116.  
  117.   Future fixes and updates for the GRADD and other video drivers can be found
  118.   via the internet at:
  119.  
  120.       http://service5.boulder.ibm.com/pspfixpk.nsf
  121.  
  122.   At the above URL choose All Fix packages and then search for "GRADD".
  123.  
  124.  
  125.  
  126.   SUPPORTED RESOLUTIONS
  127.  
  128.   Supported resolutions and color depths are adapter dependent and will vary
  129.   based on video memory and adapter implementation.
  130.  
  131.  
  132.   COMPATIBILITY
  133.   _____________
  134.  
  135.   These graphics drivers are currently compatible with OS/2 4.0
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.                                                                           Page 2
  144.  
  145.  
  146.   with Fixpak 5 or later.  Since Fixpak 5 or later enables the use of
  147.   GRADD drivers, you should restore your system to VGA before uninstalling
  148.   to a fixpak level that is prior to Fixpak 5.
  149.  
  150.  
  151.   PRELIMINARY STEPS
  152.   _________________
  153.  
  154.   1.  If you previously installed SVGA support, return to VGA resolution using
  155.       the procedures in "Setting Your Display to VGA Mode" later in this README
  156.       before you install this driver.
  157.  
  158.  
  159.   INSTALLATION
  160.   _________________
  161.  
  162.   INSTALLATION FROM DISKETTE
  163.   __________________________
  164.  
  165.   To install the GRADD Drivers from diskette, do the following:
  166.  
  167.   1.  Insert the GRADD driver diskette into drive A (or any other diskette
  168.       drive).
  169.   2.  Open an OS/2 full-screen or OS/2 window session.
  170.   3.  At the OS/2 command prompt, type the following command to copy all
  171.       necessary files to the OS/2 drive:
  172.  
  173.  
  174.       SETUP xxx [<SrcPath>] [<BootDrive>] [/u]
  175.  
  176.        where:
  177.                  xxx is one of:
  178.  
  179.                  "ATI"   -   ATI Rage/Mach 64
  180.                  "CHP"   -   Chips & Technology 6555X
  181.                  "GEN"   -   GENGRADD Generic SVGA
  182.                  "MGA"   -   Matrox Millenium/Mystique
  183.                  "S3"    -   S3 864/Trio
  184.                  "VGA"   -   VGAGRADD Generic VGA
  185.                  "VIRGE" -   S3 Virge
  186.  
  187.              [<SrcPath>] is optional (required if next parameter specified) and
  188.                          is the diskette drive
  189.  
  190.              [<BootDrive>] is optional and is the drive where OS/2 is installed.
  191.  
  192.              [/u] is optional and is used to indicate unattended install
  193.                   such as for CID installations. A CID response file is
  194.                   not required.
  195.  
  196.       Then press Enter.
  197.  
  198.  
  199.   4.  When prompted to do so, remove the diskette from drive A, perform a
  200.       shutdown, and then restart your computer.
  201.   5.  When the system reboots, do the following:
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.                                                                           Page 3
  210.  
  211.  
  212.        a.  Open the OS/2 System folder.
  213.        b.  Open the System Setup folder.
  214.        c.  Open the System object.
  215.        d.  When the Settings notebook appears, select the Screen tab.  Then go
  216.            to Screen page 2.
  217.        e.  On Screen page 2, select your display from the display list.  If your
  218.            display does not appear in the list, select Default.
  219.        f.  Return to Screen page 1 and select a resolution.
  220.        g.  Close the Settings notebook.
  221.        h.  Perform a shutdown and restart your computer.
  222.  
  223.   NOTES:
  224.   1) During the installation of this driver, DISPLAY.LOG and DSPINSTL.LOG
  225.      files are created in the OS2\INSTALL directory.  These files identify the
  226.      OS/2 system files that were updated and indicate whether the installation
  227.      was successful.  The contents of these files might be useful if you need to
  228.      report an installation problem to IBM.
  229.  
  230.   2) Installation of the GRADDs uses the Dspinstl utility shipped with OS/2 4.0.
  231.      This utility can fail if if finds a "*.dsc" file which is not a dspinstl
  232.      description file.  During testing, it was found that installation of
  233.      SystemView for OS/2 client may leave behind a file called "commonag.dsc" on
  234.      the root of the bootdrive.  This file is not a Dspinstl description file
  235.      and will cause Dspinstl to fail.  If you have this problem, simply rename
  236.      or delete the problem file.  If an incorrect description file is
  237.      encountered, it will be noted in the above log(s).
  238.  
  239.  
  240.   INSTALLATION IN A CID ENVIRONMENT
  241.   _________________________________
  242.  
  243.   NOTES:
  244.  
  245.   1.  Create a directory on the server (i.e. GRADDS). Copy the files from the
  246.       GRADD drivers diskette to the GRADDS directory.
  247.   2.  OS/2 must have been successfully installed on the client using the CID
  248.       (Configuration Installation Distribution) method.
  249.  
  250.   To install a GRADD driver using CID, use the following information to modify
  251.   your LCU command file.  Example below installs the ATI Rage II/Mach 64 GRADD
  252.   (M64GRADD).
  253.  
  254.   NOTE:  The following information is meant as a guide.
  255.          Your LCU command file might be different.
  256.  
  257.  
  258.     /*****************************************************/
  259.     /*           LCU PRODUCT DATA SECTION                */
  260.     /*****************************************************/
  261.  
  262.                           .
  263.                           .
  264.                           .
  265.  
  266.     x.graddvideo = 15
  267.     x.15.name='ATI Gradd Video'
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.                                                                           Page 4
  276.  
  277.  
  278.     x.15.statevar = 'CAS_' || x.15.name
  279.     x.15.instprog = 'x:\img\gradds\SETUP.CMD',
  280.                     ' ATI',
  281.                     ' x:\img\gradds ' || bootdrive,
  282.                     ' /u'
  283.     x.15.rspdir   = ''
  284.     x.15.default  = ''
  285.  
  286.  
  287.     /*---------------------------------------------------*/
  288.     /*         NUMBER OF PROGRAMS SET UP IN THE          */
  289.     /*               PRODUCT DATA SECTION                */
  290.     /*---------------------------------------------------*/
  291.  
  292.     NUM_INSTALL_PROGS = 15
  293.  
  294.     /*****************************************************/
  295.     /*                  INSTALLATION SECTION             */
  296.     /*****************************************************/
  297.                           .
  298.                           .
  299.                           .
  300.  
  301.         when OVERALL_STATE = 2 then do
  302.           if RunInstall(x.graddvideo) == BAD_RC then exit
  303.           Call CheckBoot
  304.         end
  305.                           .
  306.                           .
  307.                           .
  308.  
  309.  
  310.  
  311.     /******************************************************/
  312.     /*                ROUTINE SECTION                     */
  313.     /*  The following information should already exist in */
  314.     /*  the LCU command file.                             */
  315.     /******************************************************/
  316.                          .
  317.                          .
  318.                          .
  319.     RebootAndGotoState:
  320.       parse arg new_state, other
  321.  
  322.       rc2 = SetState(new_state, 'RebootAndGotoState', 1)    /* Set the state */
  323.                                                             /*  to go to in  */
  324.                                                             /* OVERALL_STATE */
  325.  
  326.       Call SaveStates                              /* Save the environment vars */
  327.  
  328.       Call Reboot                                  /* Reboot the machine */
  329.  
  330.       return
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.                                                                           Page 5
  340.  
  341.  
  342.                           .
  343.                           .
  344.                           .
  345.  
  346.  
  347.     /*****************************************************/
  348.  
  349.  
  350.  
  351.                 END OF LCU INFORMATION TO BE ADDED
  352.     /*****************************************************/
  353.  
  354.  
  355.   SETTING YOUR DISPLAY TO VGA MODE
  356.   ________________________________
  357.  
  358.   Use the following procedures to return to VGA mode.
  359.  
  360.       1.  Turn on your computer.  If your computer is already on, press
  361.           Ctrl+Alt+Del to restart it.
  362.       2.  When a small white box appears in the upper left-hand corner of your
  363.           screen, press Alt+F1.
  364.       3.  When the Recovery Choices screen appears, press function key F3.
  365.  
  366.       Your display adapter is restored and can work in VGA mode.  If you want to
  367.       install a new display adapter or video device driver, refer to the User's
  368.       Guide to OS/2 Warp.
  369.  
  370.  
  371.  
  372.   IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT
  373.   LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND
  374.   MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT.  BY
  375.   FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY RELATED PATENTS OR
  376.   COPYRIGHTS.
  377.  
  378.   THESE DRIVERS ARE COPYRIGHTED BY INTERNATIONAL BUSINESS MACHINES CORPORATION.
  379.   ALL APPROPRIATE RESTRICTIONS APPLY.
  380.  
  381.                                 (End of Document)
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.                                                                           Page 6
  402.