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 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 2MB 1024x768 65,536 2MB 640x480 16,777,216 2MB 1.2 SUPPORTED ADAPTERS IBM has tested the following IBM systems containing the S3 86C864 chip set with the specified amount of memory. 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 other major manufacturing products that have been tested by IBM and 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. 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: NOTE: The volume label of the first diskette must be S3_864 1. The volume label of the second diskette must be S3_864 2. The device drivers will not install if they have been changed. 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, S3 868 [32 bit] (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. Before running RSPDSPI, delete the following file: [OS2 DRIVE]:\OS2\INSTALL\S3864BB.DSC 2. Be sure RSPDSPI.EXE is in the \OS2\INSTALL directory. If it is, go to step 3. 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. 6. After running RSPDSPI and before rebooting the system, remove the following lines from CONFIG.SYS. DEVICE=[OS/2DRIVE]:\OS2\POWER_9K\P9100.SYS SET VIDEO_DEVICES=VIO_P9X00 SET VIO_P9X00=DEVICE(BVHVGA,BVHP9100) DEVICE=[OS/2DRIVE]:\OS2\POWER_9K\VP91VGA.SYS DEVICE=[OS/2DRIVE]:\OS2\POWER_9K\VP9100.SYS o FOR CID USERS: After running RSPDSPI and before rebooting the system, 1. Edit PSVGA32.DSP. This file is located on DISPLAY DISK 1. 2. Find the following line: :DEL_CONFIG_LINE :MODE=PRIMARY 3. Add the following lines below the line mentioned in STEP 2: DEVICE=%BOOTDRIVE%:\OS2\POWER_9K\P9100.SYS DEVICE=%BOOTDRIVE%:\OS2\POWER_9K\VP91VGA.SYS DEVICE=%BOOTDRIVE%:\OS2\POWER_9K\VP9100.SYS SET VIDEO_DEVICES=VIO_P9X00 SET VIO_P9X00=DEVICE(BVHVGA,BVHP9100) 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. Before running RSPDSPI, delete the following files: [OS2 DRIVE]:\OS2\INSTALL\S3864BB.DSC 2. Be sure RSPDSPI.EXE is in the \OS2\INSTALL directory. If it is, go to step 3. 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. 6. After running RSPDSPI and before rebooting the system, remove the following lines from CONFIG.SYS. DEVICE=[OS/2DRIVE]:\OS2\POWER_9K\P9100.SYS SET VIDEO_DEVICES=VIO_P9X00 SET VIO_P9X00=DEVICE(BVHVGA,BVHP9100) DEVICE=[OS/2DRIVE]:\OS2\POWER_9K\VP91VGA.SYS DEVICE=[OS/2DRIVE]:\OS2\POWER_9K\VP9100.SYS o FOR CID USERS: After running RSPDSPI and before rebooting the system, 1. Edit PSVGA32.DSP. This file is located on DISPLAY DISK 1. 2. Find the following line: :DEL_CONFIG_LINE :MODE=PRIMARY 3. Add the following lines below the line mentioned in STEP 2: DEVICE=%BOOTDRIVE%:\OS2\POWER_9K\P9100.SYS DEVICE=%BOOTDRIVE%:\OS2\POWER_9K\VP91VGA.SYS DEVICE=%BOOTDRIVE%:\OS2\POWER_9K\VP9100.SYS SET VIDEO_DEVICES=VIO_P9X00 SET VIO_P9X00=DEVICE(BVHVGA,BVHP9100) 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 (ROCKET) 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)