OS/2 DEVICE DRIVER FOR IBM ThinkPad 755 with WD90C24 GRAPHICS CONTROLLER This package contains the following: o An OS/2* graphics controller driver supporting the 90C24 chip set from the Western Digital** Corporation. o This README file, - 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 GRAPHICS CONTROLLER INDICATES YOUR ACCEPTANCE OF THE FOLLOWING TERMS AND CONDITIONS: o YOU MUST BE A LICENSEE OF OS/2. o YOU MAY MAKE COPIES OF THE OS/2 DEVICE DRIVER FOR WD90C24 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 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 2.0 Compatibility 3.0 Preliminary Steps 4.0 Installation from Diskette 5.0 Installation in a CID Environment 6.0 Functional Restrictions 6.1 Functional Restrictions for Laptop Computers 7.0 Setting Your Display to VGA Mode 8.0 APARs Included in This Driver 9.0 Trademarks 1.0 SUPPORTED FEATURES __________________ The WD90C24 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 that support 64K colors. 1.2 SUPPORTED ADAPTERS IBM has tested IBM display adapters and systems containing the WD90C24 chip set with the specified amount of memory. 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 System: IBM National Support Center BBS (data connection: 919-517-0001) 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, OS/2 for Windows, and OS/2 Warp Version 3. 3.0 PRELIMINARY STEPS _________________ The following steps prepare your computer for the WD90C24 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. Install the "ThinkPad Features" icon and utility by using the "Install2.exe" program located on your video features diskette. Configure your ThinkPad with the utility to support the resolutions and refresh settings you desire. Refer to the readme file on the video features diskette for more information. 4.0 INSTALLATION FROM DISKETTE __________________________ To install the WD90C24 device driver from diskette, do the following: 1. Insert the WD90C24 diskette into drive A (or any other diskette drive). Note: This diskette should have a volume label of "WD2431 1". To verify, use "Label A:". 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)" 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. Accept this choice. Then select OK. 10. When the Source Directory pop-up window appears, insert the WD90C24 diskette into drive A. Then select Install. NOTE: At this point, DSPINSTL determines the hardware configuration by creating the \OS2\SVGADATA.PMI file. 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 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 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 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 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 This 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 This is a resolution/color depth from the list of "Supported Resolutions" that appears earlier in this README. /u means 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 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 The WD90C24 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, OS/2 2.1 users of the feature will experience unusual results. An OS/2 pervasive fix package is available electronically (request fix package XR06200). The associated APAR PJ11051 is fixed in 2.11 and above. The software motion feature is not supported in 16 million color modes. 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. 6.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 MODE 132 does not work. 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. o On the ThinkPad 755CSE: There is a noticable "moving ripple" effect, especially in the gray areas of inactive title bars. This can be circumvented by using different color schemes. In some cases, running Lockup once clears up the problem. 7.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. 4. Run Selective Install to change the Windows drivers. 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 Enter. When the install options screen appears, press F3 (or Esc) to exit to 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 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. 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= PJ17068 750CS/755CS BOOTS TO A BLACK SCREEN ON THE LCD AFTER EXTERNAL MONITOR IN DISCONNECTED. HAVING CRT HIGHPERFORMANCE ENABLED. APAR= PJ17994 750CS/755CS BOOT TO A BLACK SCREEN ON THE LCD AFTER EXTERNAL MONITOR IN DISCONNECTED UNDER WARP FULLPACK 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 BLOCK. 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 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)