---------------
S3 Vision 864
1995/05/22
Pre-V3 Files
V3 Files
---------------

         OS/2 DEVICE DRIVER FOR THE S3 VISION864


  This package contains the following:

  o   An OS/2* graphics accelerator driver supporting
      the 86C864 chip set from S3** Incorporated.
  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 THE S3 VISION864
  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
      THE S3 VISION864 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 THE S3 VISION864; 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  Installation in a CID Environment
           6.0  Functional Restrictions
           7.0  Setting Your Display to VGA Mode
           8.0  APARs Included in This Driver
           9.0  Trademarks




 1.0  SUPPORTED FEATURES
  __________________

  The Vision864 (S3_864) graphics accelerator 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 accelerator driver supports these
  resolutions and color depths:

                            Number of    Video Memory
          Resolutions        Colors        Required

           640x480            256           1MB
           800x600            256           1MB
          1024x768            256           1MB
          1280x1024           256           2MB

           640x480           65,536         1MB
           800x600           65,536         1MB
          1024x768           65,536         2MB
          1280x1024          65,536         2MB

           640x480        16,777,216        2MB


 1.2  SUPPORTED ADAPTERS

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

            IBM ValuePoint* (2MB) models 6472, 6482, and 6484
            IBM PC 3xx & 7xx models 6575, 6585, 6875, 6876,
            6885, and 6886

  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 S3_864 graphics accelerator driver supports the
  following number of columns and rows in an OS/2
  full-screen session:

           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
  S3_864 graphics accelerator 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.  If you are installing this device driver on a
      system that was preinstalled with OS/2, do the
      following:
      a.  Insert the S3_864 diskette 2 into drive A (or
          any other diskette drive).
      b.  Open an OS/2 full-screen or OS/2 window
          session.
      c.  At the OS/2 command prompt, type the
          following:

                 A:PRELOAD A: C:

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

          Then press Enter.


 4.0 INSTALLATION FROM DISKETTE
  __________________________

  To install the S3_864 device driver from diskette, do
  the following:

  1.  Insert S3_864 diskette 1 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 "S3_864 (32bit) (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.

      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.

  10. When the Source Directory pop-up window appears,
      insert S3_864 diskette 1 into drive A.  Then
      select Install.  When prompted to do so, remove
      diskette 1 and insert diskette 2.
  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.  Then go to Screen page 2.
      e.  On Screen page 2, select your display from
          the display list.  If your display does not
          appear in the list, select Default.
      f.  Return to Screen page 1 and select a screen
          resolution and a screen refresh rate.
      g.  Close the Settings notebook.
      h.  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  INSTALLATION IN A CID ENVIRONMENT
  _________________________________

  NOTES:

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

  To install the S3_864 graphics accelerator 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.s3video = 15
    x.15.name='S3 Video'
    x.15.statevar = 'CAS_' || x.15.name
    x.15.instprog = 'x:\img\s3_drvs\SETUP.CMD',
                    ' x:\img\s3_drvs ' || bootdrive || ' CID'
    x.15.rspdir   = ''
    x.15.default  = ''

    x.s3dspinstl = 16
    x.16.name='S3 CID Dspinstl'
    x.16.statevar = 'CAS_' || x.16.name
    x.16.instprog = bootdrive || '\os2\install\DSPINSTL.EXE',
                    ' /pd:' || bootdrive || '\os2\install\s3864bb.dsc',
                    ' /s:x:\img\s3_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.s3video) == BAD_RC then exit
          Call RebootAndGotoState(3)
        end
        when OVERALL_STATE = 3 then do
          if RunInstall(x.s3dspinstl) == 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 /pd:c:\os2\install\s3864bb.dsc
    /S:X:\img\s3_drvs /T:C: /res:640x480x256 /u

       /pd:c:\os2\install\s3864bb.dsc  is the dsc laid down during
                                      setup phase
       /S:X:\img\s3_drvs  where X:\img\s3_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 s3_864 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.


 6.0  FUNCTIONAL RESTRICTIONS
  _______________________

  o   After Dark** for Windows** images that move from
      left to right do not perform properly at
      640x480x16M resolution.
  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   To avoid a trap in Lotus** 1-2-3** for OS/2, do
      not attempt to run the program at 16.7 million
      colors.
  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 or 600x480x16 million 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.  The software motion
      video feature is not supported in 16-million
      color modes.
  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.
  o   Distributed Console Access Facility (DCAF) is
      supported in 256-color modes only.


 7.0  SETTING YOUR DISPLAY TO VGA MODE
  ________________________________

  Use the following procedures to return to VGA mode.

  NOTE:  If your display is out of sync, start OS/2
         using the OS/2 Installation Diskette, insert
         Diskette 1 when prompted, then press F3 to
         display a command prompt.  Use the following
         instructions to reset your display mode:

  o   If you are installing this driver on OS/2 Warp,
      returning to VGA mode has been simplified.  Do
      the following:

      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 installed from
      diskettes, do the following:

      1.  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.)
      2.  Type C: and then press Enter.
      3.  Type CD C:\OS2\INSTALL and then press Enter.
      4.  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.

  o   If you are installing this driver on OS/2 2.1,
      2.11, or OS/2 for Windows, and you installed from
      CD-ROM or a LAN, do the following:

      1.  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.)
      2.  Type C: and then press Enter.
      3.  Type CD C:\OS2\INSTALL and then press Enter.
      4.  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.


 8.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= PJ15437
        TRANSPARENT BITMAPS WILL NOT DISPLAY PROPERLY USING S3-864
        DRIVERS W/ THE S3 CHIPSET.

        APAR= PJ16740
        VIOGETSTATE IN OS/2 FULLSCREEN SESSION RETURNS INCORRECT VALUES.

        APAR= PJ16806
        1280X1024X256 RESOLUTION MISSING FROM  12/94 S3_864 DRIVERS.

        APAR= PJ16968
        WITH S3 864 IN HIGH RESOLUTION THE TESTCASE DRAWS A LINE
        OUTSIDE THE GIVEN AREA

        APAR= PJ17076
        PLUS SIGN IN DRIVE TREE-VIEW MISSING BOTTOM OF BOX  USING S3
        DRIVERS.

        APAR= PJ17148
        IBM S3 BBS DATED 12/94 DOES NOT SUPPORT THE SGS1703 DAC,  AFTER
        INSTALL, USERS W\ 2.11 OR 3.0 WILL BOOT TO A BLACK SCREEN.

        APAR= PJ17395
        OS/2 2.11 DOES NOT WORK IN SVGA ON PC 750 MACHINES.  S3
        CHIPSET IS NOT RECOGNIZED.

        APAR= PJ17962
        PC 750'S WITH S3 864 ON MOTHERBOARD DO NOT WORK IN 1024X768
        RESOLUTIONS WITH 256 OR 64K COLORS UNDER WARP  FULLPACK.

        APAR= PJ18100
        REFRESH RATE AND MONITOR PAGE IS MISSING FROM THE SYSTEM ICON
        ON A 730 SYSTEM WITH WARP FULLPAK

        APAR= PJ18104
        REFRESH RATE AND MONITOR PAGE IS MISSING FROM THE SYSTEM ICON
        ON A 750 SYSTEM WITH WARP

        APAR= PJ18154
        VIDEO CORRUPTION RUNNING OS/2 WARP FULLPAK AND AMI PRO
        FOR OS/2 IN 1024X768X256 WITH S3

        APAR= PJ18203
        IN 1024X768X256 43 IS THE HIGHEST REFRESH RATE AVAILABLE
        WITH THE WARP DRIVERS ON THE 700 AND 300 SERIES

        APAR= PJ18204
        1280X1024X768 IS MISSING FROM THE RESOLUTIONS WITH THE WARP
        FULLPAK DRIVERS ON THE 700 AND 300 SERIES

        APAR= PJ18205
        1280X1024X768 IS MISSING FROM THE RESOLUTIONS  WITH WARP
        ON PC730, PC750 OR DELL WITH S3 864 CHIPSET ON THE MOTHERBOARD

        APAR= PJ18215
        IN 1024X768X256 43 IS THE HIGHEST REFRESH RATE AVAILABLE
        WITH THE WARP DRIVERS ON THE 700 AND 300 SERIES

        APAR= PJ17575
        S3 864 VIDEO - FLICKER IN FULL SCREEN WINOS2 SESSION AT
        1024X768X256 COLORS


 9.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
      PS/ValuePoint
      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

  After Dark               Berkely Systems, Inc.

  CorelDRAW                Corel Corporation

  Lotus                    Lotus Development
                           Corporation

  Micrografx               Micrografx Incorporated

  S3                       S3 Incorporated

  Ventura Publisher        Ventura Software, Inc.

  Windows                  Microsoft Corporation

  WordPerfect              WordPerfect Corporation

  1-2-3                    Lotus Development
                           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)


