--------------------------------------------------------BRW-08/04/97--
OS/2 Video Device Driver for
S3 Trio64V2
Driver Version 3.03.07
README File
----------------------------------------------------------------------
This README file contains procedures for installing from diskette the
S3 Trio64V2 video device driver for OS/2 Warp 3.0 and 4.0; it also
contains other video-related procedures.
The following topics are included in the file:
1. Supported Features
2. Supported Resolutions
3. Preliminary Installation Steps
4. Setting Your Monitor to VGA Mode
5. Installing the S3 Video Device Driver from Diskette
6. Installing the S3 Video Device Driver in a CID Environment
7. DDC Monitor Support
8. Selecting Small or Large Fonts for Windows
9. Limitations
10. Technical Support
11. Trademarks
+--- Important ------------------------------------------------------+
o "S3 DRV1" must be the label on the installation diskette in
this package. This label can be applied using the DOS or OS/2
LABEL command. The S3 video device driver installation will
fail without this step.
o Read this entire file before beginning the device driver
installation.
+--------------------------------------------------------------------+
1. Supported Features
----------------------
This graphics-accelerator device driver provides seamless support
for accelerated video 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 device driver under
the OS/2 32-bit graphics engine. This device driver supports
the following features:
o "System - Settings" notebook support for setting refresh rate
o DDC monitor detection support
o Windows "Large font" and "Small font" support in high
resolutions
o WIN-OS/2 based on latest S3 Windows 3.1 drivers
o One-diskette package
2. Supported Resolutions
-------------------------
+=============+=============+===================+
| Resolution | Color Depth | Refresh Rates |
| | (Bits per | (Hz) |
| | Pixel) | |
| | | |
|-------------|-------------|-------------------|
| 640x480 | 8, 16, 32 | 60, 72, 75, 85 |
|-------------|-------------|-------------------|
| 800x600x8 | 8, 16 | 60, 72, 75, 85 |
|-------------|-------------|-------------------|
| 1024x768x8 | 8, 16 | 43 interlaced, |
| | | 60, 70, 75, 85 |
|-------------|-------------|-------------------|
| 1280x1024x8 | 8 | 43 interlaced, |
| | | 60, 70, 75, 85 |
+=============+=============+===================+
Note: The 32 bpp device driver might need a large swap space on the
hard disk, for example, 15 MB.
Note: Refresh rates listed are supported by the display controller.
Your monitor might not support all refresh rates and display
modes listed.
3. Preliminary Installation Steps
----------------------------------
The following steps must be performed before you install the
graphics-accelerator S3 video device driver:
1. You must have OS/2 DOS Support installed.
2. If you previously installed SVGA support, you must reset the
resolution to VGA mode, using the procedure under "Setting Your
Monitor to VGA Mode" (section 5.0 in this README).
3. The S3 video device driver diskette must be labeled "S3 DRV1."
4. After the device driver is installed, the OS/2 SYSLEVEL
command can be used to confirm the version level of the new
device driver. It may also be used prior to installing the
device driver to verify the current device driver version.
Note, however, some previous device drivers do not provide this
information. Following execution of the SYSLEVEL command look
for the following information:
C:\OS2\INSTALLATION\SYSLEVEL.VID
Vision864/964/868/968/Trio32/64/64V+/64V2
Version 3.03 Component ID 562107701
Current CSD level: S328103
Prior CSD level: S328018
In this case, the current version level is S3 3.03.07.
5. In some situations, installing this device driver over a 2.80.xx
or 2.81.xx version of the driver can result in duplicated icons.
To prevent this from happening, delete the "S3 Windows Font Size"
and "DDC Display Setup" icons from the System Setup Folder prior
to installing this device driver.
4. Setting Your Monitor to VGA Mode
------------------------------------
To switch to VGA mode:
1. Start OS/2 Warp or Merlin.
2. When the small white (OS/2) box appears in the upper-left
corner of the screen, press Alt+F1; when the list of choices
appears, press V.
Your video subsystem is now restored to work in VGA mode. If you want to
install a new video adapter refer to Chapter 16 "Video Procedures," in the
User's Guide to OS/2 Warp/Merlin.
5. Installing the S3 Video Device Driver from Diskette
-------------------------------------------------------
To install the S3 video device driver from diskette, do the following:
1. If your system is not in VGA mode, use the steps under section
5.0 to switch to VGA mode.
2. Insert the S3 video device driver installation diskette into drive A.
Note: "S3 DRV1" must be the volume label of this diskette.
To verify the label, use "Label A:".
3. Open an OS/2 full-screen or OS/2 window session.
4. At the OS/2 command prompt, type the following command to copy
all necessary files to the OS/2 drive:
A:SETUP
where A: is the diskette drive. Then press Enter.
Setup will then identify your chip set. When prompted to do
so, press Enter to continue.
| Due to the limitations with a single pass installation. A dialog box
| may come up during installation with the message, "The installed
| adapter does not support the selected display driver. Do you wish to
| continue?". Please continue the installation by selecting the Yes
| button.
5. When the Monitor Configuration/Selection Utility window appears,
the "Install Using Defaults for Monitor Type" choice is
preselected. Select OK. Do not select "Install Using Display Adapter
Utility Program" since this method of setting refresh rates is not
supported anymore.
NOTE: 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.
6. When the Source Directory pop-up window appears, insert the S3 video
device driver diskette into drive A. Then select INSTALL.
7. When the installation is complete, shut down your system,
remove the diskette, and restart your computer.
8. When the system has restarted:
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.
If your monitor has been detected as Plug and-Play (DDC)
compatible, go to step 10a.
9. On Screen page 2, select your monitor from the list. If your
monitor does not appear in the list, select DEFAULT.
It might be necessary to restart your computer to have all
refresh rate options available.
10. When the system has restarted:
a. Open the System object and select Screen page 1, as in step
13.
b. Select a screen resolution and a screen refresh rate.
c. Close the Settings notebook.
d. Perform a shutdown and restart your computer.
NOTES:
o During the installation of this device driver, DISPLAY.LOG and
DSPINSTL.LOG files are created in the OS/2\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.
o If the video memory size is changed after the device driver is
installed, the device driver must be reinstalled in order for
the system to recognize the change. Not reinstalling the
device driver might result in serious system problems.
o To start a WIN-OS/2 session, double-click on one of the WIN-OS/2
icons located in the "Command Prompts" folder within the "OS/2
System" icon. For additional information, see section 10.0
"Limitations."
6. Installing the S3 Video Device Driver in a CID Environment
--------------------------------------------------------------
Notes:
o 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 video device driver
diskette.
o OS/2 must have been successfully installed on the client using
the CID (Configuration Installation Distribution) method.
To install the S3 video 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.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 = ''
/*---------------------------------------------------*/
/* 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
/* Set the state to go to in OVERALL_STATE */
rc2 = SetState(new_state, 'RebootAndGotoState', 1)
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\00S3.dsc
/S:X:\img\s3_drvs /T:C: /res:640x480x256 /u
/pd:c:\os2\install\00S3.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
means Unattended installation.
Notes:
o After the CID installation, refer to section 6.0 "Installing the
S3 Video Device Driver from Diskette," step 8.
o Be sure you have the stated video memory required, as listed
under section 2.0 "Supported Resolutions." A safe choice is
640x480x256. Any of the listed resolutions can be selected, but
your monitor might be damaged if you select a resolution that
your monitor does not support.
o After the video 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.
o To select a refresh rate, SVGA.EXE can be executed again separately
after DSPINSTL. Example, SVGA ON INIT 1024 75
This will create another \OS2\VIDEO.CFG file with 75Hz as the default
at 1024x768 resolution. The prior \OS2\VIDEO.CFG file should be
deleted first.
7. DDC Monitor Support
-----------------------
VESA Display Data Channel (DDC) 1 and 2B protocols are supported,
allowing similarly enabled computers and operating system software
to identify the monitor and its capabilities. This S3 video device
driver automatically detects DDC monitor capabilities and sets the
display to the maximum refresh rate supported by the monitor. If,
after installing this device driver, you switch from a non-DDC
monitor to a DDC monitor or switch to a different DDC monitor, you
must run the DDC Display Setup program in the System Setup folder.
Use the following procedures when installing a DDC monitor.
1. Reset the monitor to the lowest refresh rate available. This
will prevent the system from attempting to display at a
refresh rate higher than that supported by the new monitor.
2. Shut down your computer and install the new monitor.
3. Restart your computer.
4. Double-click on the DDC DISPLAY SETUP icon in the OS/2 System
folder.
5. When you are instructed to do so, shut down your computer and
restart it.
8. Selecting Small or Large Fonts for Windows
----------------------------------------------
The default font sizes for Windows sessions are listed below.
Resolution Default Font Size
---------- -----------------
640x480 Small
800x600 Small
1024x768 Large
1280x1024 Large
1600x1200 Large
Note: Large fonts are not available for 640x480 resolution.
Use the following procedures to select small or large fonts for
Windows sessions.
1. Select the S3 WINDOWS FONT SIZE object in the OS/2 System
Setup Folder.
2. Click on the radio button next to the font size you wish to
select.
3. Click on the OK button.
A message will be displayed indicating that the new settings will
take effect the next time you restart your Windows session.
4. Click on the OK button.
5. Start any WIN-OS/2 window or full-screen session.
The setting you select will remain in effect until you explicitly
change it, you change your monitor resolution, or you install a new
video device driver.
9. Limitations
---------------
These are some known limitations:
1. CID install pauses due to SVGA.EXE loading in the background.
Workaround: In the CID installation script, do not initiate any
other processes until DISPINSTL completes execution. Ensure
that no other processes are running during CID install. This
can be accomplished by adding the following line to the
CONFIGSYSLINE keyword of the CID response file:
SET RESTARTOBJECTS=STARTUPFOLDERSONLY
2. During CID install of IBM AntiVirus when using NetView DM/2,
the OS/2 full screen is displayed as a black screen.
Workaround: Perform CID install under VGA.
3. DISPINSTL does not allow CID selection of monitor and refresh
rate.
WORK AROUND:
Requirements:
* A system with the same graphics subsystem and monitor
configured with this graphics-accelerator device driver,
the correct display type, the desired resolution and
refresh rate.
Step 1: Copy Configured Video/Display Data Files
* copy the video and display data files containing information
about the display type, resolution and refresh rate to the
CID server (\img\svgadata).
> copy \os2\svgadata.pmi x:\img\svgadata
> copy \os2\video.cfg x:\img\svgadata
Step 2: Create CID Command File
* create a command file to copy svgadata.pmi and video.cfg
to the client system's \OS2 directory via CID.
* reboot the client system.
* the client system will be configured with the correct
driver, display type, resolution and refresh rate.
Another work around is to delete \OS2\VIDEO.CFG and to execute
SVGA.EXE again after DSPINSTL completes. Example:
SVGA ON INIT 1024 75 to set 75Hz as the default refresh rate at
1024x768.
4. In all modes, video corruption or an out-of-sync screen is
displayed when using Alt+Esc to switch between WIN-OS/2, OS/2,
and DOS window and full-screen sessions started from the
Startup folder. To avoid this situation, do not start
sessions from the Startup folder or press Alt+Esc several
times to restore.
5. Some programs, such as WINBENCH95, WINBENCH96, and After
Dark 3.0, were written specifically for the Windows
environment. In the Windows environment, these programs
prevent any keystrokes from interfering with their proper
execution. However, in the OS/2 environment, it is possible
to switch context away from the Windows session without
notifying these programs. General Protection Faults (GPFs)
may result. Therefore, do not perform context switching during
the execution of WINBENCH95 and WINBENCH96 tests. Also, do not
perform context switching during the execution of the After Dark
3.0 demo.
6. If you attempt to start a WIN-OS/2 session from an OS/2 Full
Screen session by typing "WIN" or "WINOS2" at the command
prompt, it will not execute with the settings needed to
support WIN-OS/2, and will result in video corruption or a
system lockup. Therefore, whenever you want to launch a
Windows session, use one of the WIN-OS/2 icons located in the
"Command Prompts" folder within the "OS/2 System" icon.
7. When attempting to start a WIN-OS/2 session from a DOS Full
screen or DOS Window by typing the "WIN" or WINOS2" command,
you must first be sure that the video settings of the session
are changed to enable this feature. These settings can be
changed using the following procedure:
a. Place the mouse pointer over the DOS Full Screen icon
(or any DOS session icon you want to alter). Press
mouse button 2 (the right button) to bring up a
context-sensitive menu.
b. Click on SETTING; then click on the SESSION tab.
c. Click on the DOS SETTING button.
d. Click on DOS VIDEO SETTINGS; then click on OK.
e. From the list of settings that appear, ensure that
"VIDEO_8514A_XGA_IOTRAP" is set to OFF, and
"VIDEO_SWITCH_NOTIFICATION" is set to ON; then save
these settings by clicking on SAVE.
10. Technical Support
----------------------
Updates for this device driver, when available, may be obtained
from the following sources:
http://www.pc.ibm.com
IBM National Support Center (data connection: 919-517-0001)
IBM National Support Center (voice connection: 800-772-2227)
11. Trademarks
---------------
The following terms are trademarks of the IBM Corporation in the
United States or other countries or both:
IBM Presentation Manager
NetView WIN-OS/2
OS/2 Aptiva
The following terms are trademarks of other companies:
After Dark Berkely Systems, Inc.
S3 S3 Incorporated
VESA Video Electronics Standards Association
Microsoft and Windows are trademarks or registered trademarks of
Microsoft Corporation.
Other company, product, and service names may be trademarks or
service marks of others.
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)