  OS/2 DEVICE DRIVER FOR WD90C24/31 GRAPHICS CONTROLLER


  This package contains the following:

  o   An OS/2* graphics controller driver supporting
      the 90C24/31 chip set from the Western Digital**
      Corporation.
  o   This README file, which is formatted for viewing
      on your screen.  You can:
      -   Use the Table of Contents to
          help you locate specific topics.
      -   Use the Find option in the Edit menu of the
          OS/2 System Editor to help you locate
          specific information.
      -   Print the file.


  IMPORTANT

  PLEASE READ THE FOLLOWING TERMS AND CONDITIONS.  YOUR
  USE OF THE OS/2 DEVICE DRIVER FOR WD90C24/31 GRAPHICS
  CONTROLLER INDICATES YOUR ACCEPTANCE OF THE FOLLOWING
  TERMS AND CONDITIONS:

  o   YOU MUST BE, AND YOU AGREE THAT YOU ARE, A PRIOR
      LICENSEE OF OS/2.
  o   YOU MAY MAKE COPIES OF THE OS/2 DEVICE DRIVER FOR
      WD90C24/31 GRAPHICS CONTROLLER EQUAL TO THE
      NUMBER OF LICENSED COPIES OF OS/2 YOU POSSESS.
  o   ALL OTHER TERMS AND CONDITIONS OF YOUR OS/2
      LICENSE AGREEMENT APPLY TO THIS OS/2 DEVICE
      DRIVER FOR WD90C24/31 GRAPHICS CONTROLLER;
      HOWEVER, THIS DOES NOT EXTEND ANY WARRANTY
      OUTLINED IN SUCH AGREEMENT.


  CONTENTS
  ________


           1.0  Supported Features
             1.1 Supported Resolutions
             1.2 Supported Adapters
             1.3 Supported Columns and Rows
           2.0  Compatibility
           3.0  Preliminary Steps
           4.0  Installation from Diskette
           5.0  Setting Up an External Monitor
                on a Laptop Computer
           6.0  Installation in a CID Environment
           7.0  Functional Restrictions
             7.1  Functional Restrictions for
                  Laptop Computers
           8.0  Setting Your Display to VGA Mode
           9.0  APARs Included in This Driver
          10.0  Trademarks


 1.0  SUPPORTED FEATURES
  __________________

  The WD90C24/31 device driver provides seamless
  support for accelerated display graphics and advanced
  color resolutions when used with the minimum required
  video memory.  It conforms to the OS/2 32-bit flat
  memory model and is designed to function as a 32-bit
  Presentation Manager* graphics display driver under
  the OS/2 32-bit graphics engine.  This driver has
  been enabled for use with the IBM* Distributed Console
  Access Facility (DCAF) product.


 1.1  SUPPORTED RESOLUTIONS

  This video device driver supports these resolutions
  and color depths:

                     Number of    Video Memory
     Resolutions      Colors        Required

      640x480          256           1MB
      800x600          256           1MB*
     1024x768          256           1MB*

      640x480        65,536          1MB**
      800x600        65,536          1MB***

      *Only on laptops with external monitor connected.
     **Only on laptops that support 64K colors.
    ***Only some video adapters with the WD90C31 chip support
       this resolution.


 1.2  SUPPORTED ADAPTERS

  IBM has tested the listed display adapters and
  systems containing the WD90C24/31 chip set with the
  specified amount of memory.  IBM is continuing to
  test; therefore, support for additional cards might
  be added over time.

      IBM ThinkPad* 750c, 750p, 750 Mono, 755 (system board) (C24)
      IBM ThinkPad 360 (C24)
      IBM ThinkPad 510 CS (C24) (65536 colors not supported)

  For a comprehensive listing of all major manufacturing products
  that are OS/2 compatible, Refer to the "OS/2 Hardware Compatibility
  List" book.  This book is available electronically on the following
  Bulletin Board Systems:

     IBM National Support Center BBS (data connection: 919-517-0001)
     CompuServe (IBM OS/2 Support Forum \Library\IBMFiles\PCMTABLE.ZIP)
     Prodigy
     LAN Server & OS/2 BBS -Sydney Australia
     IBM Austria BBS - Vienna, Austria
     IBM BBS - Vancouver, BC, Canada
     IBM PS BBS - Hong Kong
     IBM OS/2 BBS & IBM AP OS/2 BBS - Singapore
     IBM BBS - Belgium
     IBM BBS - England
     IBM BBS - Spain
     OS2BBS  - Denmark
     Hitline BBS- Switzerland
     DAP & PSP BBS - Italy
     IBM BBS - Jakarta
     IBM BBS - Thailand

  NOTE: The compatibility hardware test information supplied is provided for
  information purposes.  IBM makes no warranty, express or implied,
  with respect to the operation of OS/2 on the personal computers listed.


 1.3  SUPPORTED COLUMNS AND ROWS
  ______________________________

  This WD90C24/31 device driver supports the following
  number of columns and rows in an OS/2 full-screen
  session on an external monitor only:

           Columns    Rows
             132       25
             132       43


 2.0 COMPATIBILITY
  _____________

  This graphics accelerator driver is compatible with
  OS/2 2.1, 2.11, and OS/2 Warp 3.


 3.0  PRELIMINARY STEPS
  _________________

  The following steps prepare your computer for the
  WD90C24/31 graphics controller device driver:

  1.  You must have OS/2 DOS Support installed in order
      to install this driver.
  2.  If you previously installed SVGA support, return
      to VGA resolution using the procedures in
      "Setting Your Display to VGA Mode" later in this
      README before you install this driver.
  3.  Be sure to copy the VESA** program supplied with
      your system or video adapter and update your
      AUTOEXEC.BAT file to get support for high
      resolution and high color modes.


 4.0  INSTALLATION FROM DISKETTE
  __________________________

  To install the WD90C24/31 device driver from
  diskette, do the following:

  1.  Insert the WD90C24/31 diskette into drive A (or
      any other diskette drive).
  2.  Open an OS/2 full-screen or OS/2 window session.
  3.  At the OS/2 command prompt, type the following
      command to copy all necessary files to the OS/2
      drive:

             A:SETUP A: C:

      (where A: is the diskette drive, and C: is the
      drive where OS/2 is installed.)

      Then press Enter.
  4.  When prompted to do so, remove the diskette from
      drive A, perform a shutdown, and then restart
      your computer.
  5.  Open the OS/2 System folder.
  6.  Open the System Setup folder.
  7.  Open the Display Driver Install object.
      When the Display Driver Install window appears,
      select Primary Display Driver and then select OK.
  8.  When the Display Driver Select window appears,
      select "Western Digital 90C24 (IBM BBS)" or
      "Western Digital 90C31 (IBM BBS)"
      to install the BBS video driver.
  9.  When the Monitor Configuration/Selection Utility
      window appears, the "Install Using Defaults for
      Monitor Type" choice is preselected.  You can
      accept this choice or select "Install Using
      Display Adapter Utility Program" to choose a
      different refresh rate.  Then select OK.

      If you select the "Install Using Display Adapter
      Utility Program" choice, you must have a DOS
      monitor utility that came with your display
      adapter.  Contact the display adapter
      manufacturer's technical support for information
      on how to use the monitor utility under OS/2.


                                           Page 7


  10.  When the Source Directory pop-up window appears,
      insert the WD90C24/31 diskette into drive A.
      Then select Install.

      NOTE:  At this point, DSPINSTL determines the
             hardware configuration by creating the
             \OS2\SVGADATA.PMI file.  If the
             \OS2\SVGADATA.PMI file has not been
             created, the adapter will not be
             supported.  This process can take
             several seconds and will black-out the screen.

  11. When the installation is complete, do the
      following:
      a.  Open the OS/2 System folder.
      b.  Open the System Setup folder.
      c.  Open the System object.
      d.  When the Settings notebook appears, select
          the Screen tab.
      e.  Select a resolution.  Then close the
          notebook.
      f.  Perform a shutdown and restart your computer.

  Note that during the installation of this driver,
  DISPLAY.LOG and DSPINSTL.LOG files are created in the
  OS2\INSTALL directory.  These files identify the OS/2
  system files that were updated and indicate whether
  the installation was successful.  The contents of
  these files might be useful if you need to report an
  installation problem to IBM.


 5.0 SETTING UP AN EXTERNAL MONITOR ON A LAPTOP COMPUTER
  ___________________________________________________

  Use the following procedure to create an SVGADATA.PMI
  file for a laptop computer supported by the
  WD90C24/31 device driver:

  1.  Turn off your laptop computer, and attach the
      external monitor.
  2.  Insert a DOS bootable diskette into drive A, and
      then turn your laptop computer on.
  3.  Press the appropriate keys to toggle the external
      monitor on.  (If you want to use the higher pixel
      depths available, make sure the internal monitor
      is not on.)
  4.  Change to the drive where OS/2 is installed.

      If you have an IBM ThinkPad 755CE or a non-IBM
      laptop, skip to step 7.  If you are using any
      other IBM ThinkPad, continue with step 5.
  5.  Change to the \IBMVESA directory.
  6.  To run the VESA program for ThinkPads, type the
      following:

             TPADVESA

      Then press Enter.
  7.  Change to the \OS2 directory.
  8.  To back up the SVGADATA.PMI file so the internal
      monitor can be used later, type the following:

             COPY SVGADATA.PMI SVGADATA.INT

      Then press Enter.
  9.  To create a new SVGADATA.PMI file, type the
      following commands (press Enter after each):

             SVGA ON DOS
             COPY SVGADATA.DOS SVGADATA.PMI

  10. To back up the new SVGADATA.DOS file for the
      external monitor, type the following:

             REN SVGADATA.DOS SVGADATA.EXT

      Then press Enter.
  11. If you need to go back to the internal monitor,
      make sure 640x480 is the selected resolution.
      Then type the following from the \OS2 directory
      of the boot drive:

             COPY SVGADATA.INT SVGADATA.PMI

      Then restart your system with the internal
      monitor on.


 6.0 INSTALLATION IN A CID ENVIRONMENT
  _________________________________

  NOTES:

  1.  The server must contain a directory named WD_DRVS
      on the same drive where the OS/2 diskettes
      reside.  The WD_DRVS directory must contain all
      of the files from the WD90C24/31 device driver
      diskette.
  2.  OS/2 must have been successfully installed on the
      client using the CID (Configuration Installation
      Distribution) method.

  To install the WD90C24/31 device driver using CID,
  use the following information to modify your LCU
  command file.

  NOTE:  The following information is meant as a guide.
         Your LCU command file might be different.

    /*****************************************************/
    /*           LCU PRODUCT DATA SECTION                */
    /*****************************************************/

                          .
                          .
                          .

    x.wdvideo = 15
    x.15.name='WD Video'
    x.15.statevar = 'CAS_' || x.15.name
    x.15.instprog = 'x:\img\wd_drvs\SETUP.CMD',
                    ' x:\img\wd_drvs ' || bootdrive || ' CID'
    x.15.rspdir   = ''
    x.15.default  = ''

    x.wddspinstl = 16
    x.16.name='WD CID Dspinstl'
    x.16.statevar = 'CAS_' || x.16.name

    /*****************************************************/
    /* FOR WESTERN DIGITAL 31 CHANGE wdc24bb TO          */
    /* wdc31bb WHERE IT OCCURS                           */
    /*****************************************************/

    x.16.instprog = bootdrive || '\os2\install\DSPINSTL.EXE',
                    ' /pd:' || bootdrive || '\os2\install\wdc24bb.dsc',
                    ' /s:x:\img\wd_drvs',
                    ' /t:' || bootdrive,
                    ' /res:640x480x256',
                    ' /u'
    x.16.rspdir   = ''
    x.16.default  = ''

    /*---------------------------------------------------*/
    /*         NUMBER OF PROGRAMS SET UP IN THE          */
    /*               PRODUCT DATA SECTION                */
    /*---------------------------------------------------*/

    NUM_INSTALL_PROGS = 16

    /*****************************************************/
    /*                  INSTALLATION SECTION             */
    /*****************************************************/
                          .
                          .
                          .

        when OVERALL_STATE = 2 then do
          if RunInstall(x.wdvideo) == BAD_RC then exit
          Call RebootAndGotoState(3)
        end
        when OVERALL_STATE = 3 then do
          if RunInstall(x.wddspinstl) == BAD_RC then exit
          Call CheckBoot
        end
                          .
                          .
                          .
    /******************************************************/
    /*                ROUTINE SECTION                     */
    /*  The following information should already exist in */
    /*  the LCU command file.                             */
    /******************************************************/
                         .
                         .
                         .
    RebootAndGotoState:
      parse arg new_state, other

      rc2 = SetState(new_state, 'RebootAndGotoState', 1)    /* Set the state */
                                                            /*  to go to in  */
                                                            /* OVERALL_STATE */

      Call SaveStates                              /* Save the environment vars */

      Call Reboot                                  /* Reboot the machine */

      return

                          .
                          .
                          .


    /*****************************************************/
                END OF LCU INFORMATION TO BE ADDED
    /*****************************************************/

  Following is an explanation of the line that is
  executed in the LCU command file:

    C:\OS2\INSTALL\DSPINSTL /PK:SVGA /SK:NONE /S:X:\
    /T:C: /MC:4 /res:640x480x256

    C:\OS2\INSTALL\DSPINSTL /pd:c:\os2\install\wdc24bb.dsc
    /S:X:\img\wdc_drvs /T:C: /res:640x480x256 /u

       /pd:c:\os2\install\wdc24bb.dsc  is the dsc laid down during
                                      setup phase
       /S:X:\img\wdc_drvs  where X:\img\wdc_drvs  is the redirected source path.
       /T:C: where C: is the drive where OS/2 is installed.
       /res:640x480x256 is a resolution/color depth from
        the list of "Supported Resolutions" that appears earlier
        in this README.
       /u  Unattended installation.

  NOTES:

  1.  Be sure you have the stated video memory
      required, as listed in "Supported Resolutions"
      earlier in this README.  A safe choice is
      640x480x256.  Any of the listed resolutions can
      be selected, but your display might be damaged if
      you select a resolution that your display does
      not support.
  2.  After the WD90C24 or WD90C31 device driver has been
      successfully installed on the client machine
      using the CID method and the client machine is
      restarted, the resolution will be as specified by
      command line argument.
  3.  After the CID install, refer the end user to
      4.0 INSTALLATION FROM DISKETTE step 11.


 7.0  FUNCTIONAL RESTRICTIONS
  _______________________

  o   The WD90C24/31 driver does not support 16 million
      color mode.
  o   To avoid a general protection fault while loading
      Ventura Publisher** for Windows**, be sure it is
      in one of the 256 color resolutions.
  o   WordPerfect** Versions 5.1 and 5.2 for Windows
      produce a general protection fault when the
      "Print Preview" option is selected while using
      800x600x64K color mode.
  o   Users of the software motion video feature of
      MMPM/2* should expect satisfactory results in
      256-color modes.  However, in 64K-color modes,
      users of the feature will experience unusual
      results.  An OS/2 pervasive fix package will be
      available electronically.
  o   Distributed Console Access Facility (DCAF) is
      supported in 256-color modes only.
  o   CorelDRAW** 2.0 will not run in a WIN-OS/2*
      window session.  It must be run in a WIN-OS/2
      full-screen session.
  o   Micrografx** Charisma 2.1 will not run in a
      WIN-OS/2 window session.  It must be run in a
      WIN-OS/2 full-screen session.


 7.1  FUNCTIONAL RESTRICTIONS FOR LAPTOP COMPUTERS

  o   To change refresh rates on the ThinkPad, edit the
      file called IBMVESA\FRATE.DAT.  See
      IBMVESA\TPADVESA.DOC for instructions on how to
      edit this file.
  o   On laptop computers with Super-Twisted Nematode
      (STN) display, even though 1MB video memory is
      shipped with the system, only 0.5MB is
      addressable by the software.  The other 0.5MB is
      used internally by the controller.  This will,
      therefore, restrict the number of supported
      resolutions.  Most laptops with STN panels have
      model numbers ending with "S."
  o   Many laptops have a built-in internal display
      capable of only a 640x480 resolution when used
      during transportation or at remote sites.
      However, when connected to an external display at
      the office, these systems are capable of 800x600
      and 1024x768 resolutions.
      To avoid the need to select the lower resolution
      prior to leaving the office, the OS/2 device
      driver for the WDC24 automatically detects when
      the internal display is ON and sets the lower
      resolution (even though a higher resolution is
      shown as selected on the Screen page of the
      System Settings notebook).  However, because the
      Windows display drivers cannot automatically
      detect that the internal display is ON, you must
      open the System object, select the Screen page,
      change to a lower resolution, and then shut down
      and restart your system if you want to use a
      WIN-OS/2 window or full-screen session.  (If you
      do not need to use a WIN-OS/2 session, you do not
      need to make the change to the resolution in the
      Settings notebook.  When the laptop is
      reconnected to an external display, the
      originally chosen resolution will be used again.)

      When using your laptop away from the office, the
      System Settings notebook will most likely show
      resolutions which are not possible to use on the
      internal display.  On some laptops, all
      resolutions appear in the System Settings
      notebook, regardless of which displays were on
      when the OS/2 display driver was installed.  On
      most laptops, the higher resolutions appear in
      the System Settings notebook only if the OS/2
      display driver was installed while the internal
      display was OFF.
  o   An external display attached to your system can
      use resolutions above 640x480 while an internal
      display cannot.  Whenever you switch to an
      internal display, you should change the
      resolution to 640x480x256 while the external
      display is attached.  To change the resolution,
      do the following:
      1.  Open OS/2 System.
      2.  Open System Setup.
      3.  Open System.
      4.  On the Screen page of the notebook, select
          640x480x256.
      5.  Close the notebook.
      6.  Shut down and restart your computer.

      NOTE:  If you do not follow the above steps, the
             Desktop will automatically switch to the
             640x480x256 resolution because the
             internal display cannot handle the higher
             resolutions.  However, Windows
             applications running in a WIN-OS/2 window
             or full-screen session will have problems
             because the WIN-OS/2 session settings
             cannot automatically update from a higher
             resolution to the 640x480x256 resolution.
             The OS/2 Desktop will be functional enough
             to correct this situation by using the
             above steps.  These steps can be done
             using either the internal or external
             display.

  o   Due to a hardware restriction, MODE 132 will not
      work on the internal display.
  o   MODE 40 on an external display will utilize only
      half of the screen.
  o   If your system comes up with a black screen while
      the, external display is attached, press the
      display toggle keys to correct the problem.  If
      you have an external keyboard attached to your
      system, refer to the documentation that came with
      your computer for information about the internal
      or external display function key.
  o   If you are using an external display, you might
      occasionally encounter a band (usually black)
      across the screen when you start the system.  To
      correct this problem, do the following:
      1.  Perform a shutdown of your system.
      2.  Turn your computer off and then on again.


 8.0  SETTING YOUR DISPLAY TO VGA MODE
  ________________________________

  Use the following procedures to return to VGA mode.

  o   If you are installing this driver on OS/2 Warp,
      and you do not have a usable OS/2 Desktop, use
      the following procedures to return to VGA mode.
      However, if you have a usable Desktop, it is
      recommended that you use Selective Install to set
      your display to VGA mode.

      1.  Turn on your computer.  If your computer is
          already on, press Ctrl+Alt+Del to restart it.
      2.  When a small white box appears in the upper
          left-hand corner of your screen, press
          Alt+F1.
      3.  When the Recovery Choices screen appears,
          press V.

      Your display adapter is restored and can work in
      VGA mode.  If you want to install a new display
      adapter or video device driver, refer to Chapter
      16, "Video Procedures," in the User's Guide to
      OS/2 Warp.

  o   If you are installing this driver on OS/2 2.1,
      2.11, or OS/2 for Windows, and you do not have a
      usable OS/2 Desktop, use the following procedures
      to return to VGA mode.  However, if you have a
      usable Desktop, it is recommended that you use
      the Display Driver Install object to set your
      display to VGA mode.

      -   If you installed OS/2 from diskettes, do the
          following:

          1.  Start OS/2 using the OS/2 Installation
              Diskette.  When prompted, insert Diskette
              1, and then press F3 to display a command
              prompt.
          2.  Be sure RSPDSPI.EXE is in the
              \OS2\INSTALL directory.  If it is, go to
              step 2.  If it is not, insert Diskette 8
              into drive A and unpack RSPDSPI.EXE with
              the following command:

                   C:\OS2\UNPACK A:\INSTAID C: /N:RSPDSPI.EXE

              (where A: is the drive containing
              Diskette 8, and C: is the drive where
              OS/2 is installed.)
          3.  Type C: and then press Enter.
          4.  Type CD C:\OS2\INSTALL and then press
              Enter.
          5.  Type the following:

                RSPDSPI /PK:VGA /SK:NONE /S:A:\ /T:C:

              (In /T:C:, C: is the drive where OS/2 is
              installed.  In /S:A:, A: is the diskette
              drive you use to install OS/2.)

              Then press Enter.

      -   If you installed OS/2 from CD-ROM or a LAN,
          do the following:

          1.  Start OS/2 using the OS/2 Installation
              Diskette.  When prompted, insert Diskette
              1, and then press F3 to display a command
              prompt.
          2.  Be sure RSPDSPI.EXE is in the
              \OS2\INSTALL directory.  If it is, go to
              step 2.  If it is not, unpack RSPDSPI.EXE
              with the following command:

                  C:\OS2\UNPACK E:\DISK_8\INSTAID C: /N:RSPDSPI.EXE

              (where C: is the drive where OS/2 is
              installed, and E: is the CD-ROM or LAN
              drive.)
          3.  Type C: and then press Enter.
          4.  Type CD C:\OS2\INSTALL and then press
              Enter.
          5.  Type the following:

                RSPDSPI /PK:VGA /SK:NONE /S:E:\OS2SE21\ /T:C:

              (In /T:C:, C: is the drive where OS/2 is
              installed.  In /S:E:, E: is the CD-ROM or
              LAN drive.)

              Then press Enter.


 9.0  APARS INCLUDED IN THIS DRIVER
      ______________________________


      Some fixed APARs may not be listed. If you received this
      driver through the IBM OS/2 support channel and your requested
      APAR is not listed, please install the driver, as your
      requested APAR is included.

       APAR= PJ16637
       IBM THINKPAD IN VGA MODE ALLOWS TESTCASE TO DRAW OUTSIDE THE
       AREA GIVEN


      APAR= PJ17803
      SEAMLESS WINOS2 SESSION ON IBM THINKPAD 755C SPLITS INTO PIECES
      RUNNING UNDER OS2 WARP 3.0 FULLPAK IN SVGA. VGA WORKS FINE.

      APAR= PJ18129
      SELECTING FILE PULLDOWN MENU FROM WINOS2 FULLSREEN SESSION IN
      1024*768*256 ON CRT, LEAVES BEHIND COLOR TRACES CAUSING CORRUPTION

      APAR= PJ18487
      SEAMLESS WINDOWS APPLICATIONS ON LCD WHILE WD3108SL IS STILL SET
      TO 1024*768 CAUSES THE MOUSE POINTER TO TURN INTO A 1-INCH BLACK


10.0  TRADEMARKS
  __________

  The following terms, denoted by an asterisk (*) in
  this file, are trademarks or registered trademarks of
  IBM Corporation in the United States and/or other
  countries:

      IBM
      MMPM/2
      OS/2
      Presentation Manager
      ThinkPad
      WIN-OS/2

  The following terms, denoted by a double asterisk
  (**) in this file, are trademarks or registered
  trademarks of other companies as follows:


  TRADEMARK                OWNER

  CorelDRAW                Corel Corporation

  Dell                     Dell Computer Corporation

  Micrografx               Micrografx Incorporated

  Ventura Publisher        Ventura Software, Inc.

  VESA                     Video Electronics Standards
                           Association

  Western Digital          Western Digital Corporation

  Windows                  Microsoft Corporation

  WordPerfect              WordPerfect Corporation

  IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR
  IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED
  WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND
  MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN
  THIS DOCUMENT.  BY FURNISHING THIS DOCUMENT, IBM
  GRANTS NO LICENSES TO ANY RELATED PATENTS OR
  COPYRIGHTS.

  THIS DRIVER IS COPYRIGHTED BY INTERNATIONAL BUSINESS
  MACHINES CORPORATION.  ALL APPROPRIATE RESTRICTIONS
  APPLY.

                                (End of Document)


