home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 33 VDrivers
/
33-VDrivers.zip
/
mx_10311.exe
/
readme.txt
< prev
next >
Wrap
Text File
|
1997-11-13
|
25KB
|
639 lines
OS/2 Video Device Driver for S3
ViRGE,ViRGE/VX,ViRGE/DX,ViRGE/GX,ViRGE/GX2
Driver Version 1.03.11
Release date: 13 Nov 1997 5:25pm
Table of Contents
_________________
Important Notices
Supported Features Section 1.0
Supported Resolutions Section 1.1
Compatibility Section 2.0
DDC Monitor Support Section 3.0
Preliminary Steps Section 4.0
VGA Mode Reset Section 5.0
Installing the S3 Display Driver from Diskette Section 6.0
Installing in a CID Environment Section 7.0
Selecting Small or Large Fonts for Windows Section 8.0
Known Limitations Section 9.0
This single diskette package contains an OS/2 graphics accelerator
device driver which supports the ViRGE and ViRGE/VX/DX/GX/GX2 chip
sets from S3 Incorporated.
IMPORTANT Notices
_________________
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 installation will fail without this step.
o Read this entire document before beginning the device driver
installation.
1.0 Supported Features
_______________________
o Provides seamless support for accelerated display graphics and
advanced color resolutions when used with the minimum required
video memory.
o Conforms to the OS/2 32-bit, flat memory model.
o Functions as a 32-bit Presentation Manager graphics display
device driver under the OS/2 32-bit graphics engine.
o Supports setting the refresh rate using the appropriate
function in the OS/2 System Setup Folder specific to your OS/2
version:
OS/2 3.0 System - Settings notebook (page 2 of the Screen tab)
OS/2 4.0 System Properties.
o Supports monitor detection using Display Data Channel (DDC)
protocols.
1.1 Supported Resolutions
|============================================================|
| Mode | Resolution | Number | Minimum | ViRGE | ViRGE |
| | | of | Memory | Family | Family |
| | | Colors | Required| ViRGE |ViRGE/DX |
| | | | |ViRGE/VX |ViRGE/GX |
| | | | | |ViRGE/GX2|
|------|-------------|---------|---------|---------|---------|
| 101 | 640x480 | 256 | 1 MB | Y | Y |
|------|-------------|---------|---------|---------|---------|
| 103 | 800x600 | 256 | 1 MB | Y | Y |
|------|-------------|---------|---------|---------|---------|
| 105 | 1024x768 | 256 | 1 MB | Y | Y |
|------|-------------|---------|---------|---------|---------|
| 107 | 1280x1024 | 256 | 2 MB | Y | Y |
|------|-------------|---------|---------|---------|---------|
| 111 | 640x480 | 64K | 1 MB | Y | Y |
|------|-------------|---------|---------|---------|---------|
| 114 | 800x600 | 64K | 2 MB | Y | Y |
|------|-------------|---------|---------|---------|---------|
| 116 | 1024x768 | 64K | 2 MB | Y | Y |
|------|-------------|---------|---------|---------|---------|
| 11A | 1280x1024 | 64K | 4 MB | Y | Y |
|------|-------------|---------|---------|---------|---------|
| 112 | 640x480 | 16.7M | 2 MB | Y | Y |
|------|-------------|---------|---------|---------|---------|
| 115 | 800x800 | 16.7M | 2 MB | Y | Y |
|------|-------------|---------|---------|---------|---------|
| 118 | 1024x768 | 16.7M | 4 MB | Y | Y |
|------|-------------|---------|---------|---------|---------|
| 11B | 1280x1024 | 16.7M | 4 MB | Y | N/S |
|------|-------------|---------|---------|---------|---------|
| 120 | 1600x1200 | 256 | 2 MB | Y | N/S |
|------|-------------|---------|---------|---------|---------|
|========================================|=========|=========|
NOTES:
o Y = Supported; N/S = Not Supported.
o 1280x1024x24bpp is supported with the ViRGE/VX chip only.
o 1 MB only - 640x480x24 is supported for 1 MB memory
configuration only; for 2 MB and above, 24 bits per pixel (bpp)
is supported.
o S3 BIOS supports 800x600x16 with 1 MB; S3 OS/2 device driver
needs 2 MB of memory.
For TrueColor modes (16.7M) a large swap space on the hard disk
(e.g. 15 MB or greater) is recommended.
2.0 Compatibility
__________________
This graphics accelerator device driver is compatible with OS/2
2.11, OS/2 Warp 3.0, and OS/2 Warp 4.0. The installation procedures
for the three supported versions of OS/2 will vary. Please read
this entire document to determine the required steps for your
environment.
3.0 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 device driver
automatically detects DDC monitor capabilities and adjusts the
available selections to match the monitors capabilities. If the
monitor attached to the system is included on the list, which
appears on page 2 of the System Properties Screen Tab, that monitor
should be used, not the DDC or Default.
When switching to a different monitor, you must run the DDC Display
Setup program in the System Setup Folder.
Use the following procedure after attaching a different DDC monitor
to your system.
1. In the System Setup Folder, reset the display 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 system and install the new monitor.
3. Restart your system.
4. Select the "DDC Display Setup" icon in the OS/2 System Folder.
5. When you are instructed to do so, shut down your system and
restart it.
4.0 Preliminary Steps
______________________
The following steps must be performed before you install the
display 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 procedures in "Setting Your
Display to VGA Mode" (section 5.0 in this README).
3. Use "Label A:" to verify that the device driver diskette is
labeled "S3 DRV1."
4. The OS/2 SYSLEVEL command may be used prior to installation
to verify the current driver version. NOTE: some previous device
drivers did not provide this information.
Execute the SYSLEVEL command and look for the information
similar to the following:
C:\OS2\INSTALLATION\SYSLEVEL.VID
ViRGE,ViRGE/VX,ViRGE/DX,ViRGE/GX
Version 2.81 Component ID 562107701
Current CSD level: S328103
Prior CSD level: S328018
In this case the current version level is S3 2.81.03.
5.0 VGA Mode Reset
___________________
Use the following procedures to reset 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,
press F3 to display a command prompt, and then use the
following instructions to reset your display mode.
o OS/2 Warp 3.0 or OS/2 Warp 4.0 VGA mode reset:
1. Restart your computer.
2. Simultaneously press Alt and F1 key immediately when a
square block appears in the top left hand corner.
3. In OS/2 Warp 3.0, press 'v' key for VGA.
In OS/2 Warp 4.0, press F3 key for VGA.
4. Perform a shutdown and restart your computer.
5. Proceed to Section 6.0 or 7.0.
o OS/2 2.11 or OS/2 for Windows VGA mode reset:
1. Before running RSPDSPI, delete the following file:
[OS2 DRIVE]:\OS2\INSTALL\00S3.DSC
2. Be sure RSPDSPI.EXE is in the \OS2\INSTALL directory.
If it is, go to step 3.
If installing from diskette, insert OS/2 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.
If installing from CD or LAN, 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. If installing from diskette, type the following:
RSPDSPI /PK:VGA /SK:NONE /S:A:\ /T:C:
In /S:A:, A: is the source diskette drive for installing
the device driver.
In /T:C:, C: is the target drive where OS/2 is installed.
If installing from CD or LAN, type the following:
RSPDSPI /PK:VGA /SK:NONE /S:E:\OS2SE21\ /T:C:
In /S:E:, E: is the source CD-ROM or LAN drive.
In /T:C:, C: is the target drive where OS/2 is installed.
Then press Enter.
6. Perform a shutdown and restart your computer.
7. Proceed to Section 6.0 or 7.0.
6.0 Installing the S3 Display Driver from Diskette
___________________________________________________
To install the display driver from diskette, do the following:
1. If your system is not in VGA mode, set the display to VGA mode.
See steps above.
2. Insert the S3 ViRGE display driver diskette, with the label
"S3 DRV1", into drive A (or any other diskette drive).
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 chipset. When prompted to do so,
press Enter to continue.
5. When the Monitor Configuration/Selection Utility window appears,
the "Install Using Defaults for Monitor Type" choice is
pre-selected. Select OK.
Do NOT select "Install Using Display Adapter Utility Program"
since this method of setting refresh rates is not supported
in this driver version.
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 installation is complete, shut down your system, remove
the diskette, and restart your computer.
7. 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 (for OS/2 3.0) or
System Properties (for OS/2 4.0) appears,
select the Screen tab.
If your monitor has been detected as Plug and-Play (DDC)
compatible, go to step 9.
8. If your monitor has not been detected as DDC compatible,
on page 2 of Screen Tab, select your display from the display list.
If your display does not appear in the list, select Default.
Restart your computer to ensure all refresh rate options are
available.
9. When the system has restarted:
a. Open the System object and select page 1 of Screen Tab,
as in step 7.
b. Select the desired screen resolution and a screen refresh rate.
c. Close the Settings notebook or System Properties.
d. Perform a shutdown and restart your computer.
NOTES:
o If the selected vertical refresh rate is not supported by your
monitor, delete \OS2\VIDEO.CFG file and reboot. This will set
the refresh rate to the default value. A new refresh rate can
then be selected using the procedure described above.
o 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.
o The display driver should be re-installed with any changes in
video hardware configuration. Not re-installing the driver might
result in serious system problems.
o When starting a WIN-OS/2 session it is recommended that the user
launch the session via one of the WIN-OS/2 icons located in the
"Command Prompts" Folder within the "OS/2 System" icon. For
additional information see section 9.0 Known Limitations.
7.0 Installing 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 display 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 display 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',
' /u /res:640x480x256'
x.15.rspdir = ''
x.15.default = ''
/*---------------------------------------------------*/
/* NUMBER OF PROGRAMS SET UP IN THE */
/* PRODUCT DATA SECTION */
/*---------------------------------------------------*/
NUM_INSTALL_PROGS = 15
/*****************************************************/
/* 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\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 supported resolution and color depth combination.
/u
means Unattended installation.
NOTES:
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.
o After the S3 display device driver has been successfully
installed on the client machine using the CID method and the
client machine is restarted, the resolution will be that
specified by command line argument.
o After the CID installation, refer the end user to section 6.0
"Installing the S3 Display Driver from Diskette," step 7.
8.0 Selecting Small or Large Fonts for Windows
_______________________________________________
The default font sizes for Windows sessions are listed below.
Resolution Default Font Size Available Fonts
---------- ----------------- ---------------
640x480 Small Small
800x600 Small Small/Large
1024x768 Large Small/Large
1280x1024 Large Small/Large
1600x1200 Large Small/Large
Use the following procedure to change fonts for Windows sessions.
1. Open the OS/2 System Setup Folder and select the "S3 Windows
Font Size" object.
2. Select the radio button next to the desired font size.
3. Select OK.
4. A dialog box appears with the message that the new settings
will take effect the next time you restart your Windows session.
Current open sessions will not be affected by the new
settings.
5. Click OK.
6. Start any WIN-OS/2 window or full-screen session.
Selected settings remain in effect until explicitly changed, or the
display resolution or driver is changed.
9.0 Known Limitations
______________________
1. CID install pauses due to SVGA.EXE loading in the background.
Workaround: In the CID install 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 installation 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. The workaround is as follows:
a) Create a master cfg file using a system with the same graphics
card and monitor configured with the S3 driver, the correct
display type, and the desired resolution and refresh rate.
b) 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
c) Create a CID Command file to copy svgadata.pmi and video.cfg
to the client system's \os2 directory via CID.
d) Execute the CID file.
e) Reboot the client system. The client system will be configured
with the correct driver, display type, resolution and refresh
rate.
4. In OS/2 3.0, when attempting to start a WIN-OS/2 session from a
DOS Full screen or DOS Window using the "WIN" command, be sure
that the video settings of the session are set to enable this
feature:
a) Click, using the Number 1 mouse button, on the DOS Full Screen
icon (or any DOS session icon you want to alter). A context
sensitive menu will appear.
b) Select Settings. The DOS Full Screen (or Window) Settings Notebook
will appear.
c) Select the Session tab. The DOS Full Screen or DOS Window
Radio Button should already be selected. If not, select the
desired radio button.
d) Select the DOS Settings push button.
e) Select the DOS Video Settings radio button.
f) Select the OK push button. The DOS Settings - DOS Video Settings
window will appear.
g) From the list of settings which appear ensure that
"VIDEO_8514A_XGA_IOTRAP" is switched OFF, AND
"VIDEO_SWITCH_NOTIFICATION" is switched to ON.
h) Select the Save push button.
i) Close the DOS Full Screen (or Window) Settings Notebook.
NOTES:
o See notes below following item 5.
5. In OS/2 4.0, when attempting to start a WIN-OS/2 session from a
DOS Full screen or DOS Window using the "WIN" command, be sure
that the video settings of the session are set to enable this
feature:
a) Click, using the Number 2 mouse button, on the DOS Full Screen
icon (or any DOS session icon you want to alter). A context
sensitive menu will appear.
b) Select Properties. The DOS Full Screen (or Window) Properties
Notebook will appear.
c) Select the Session tab. The DOS Full Screen or DOS Window
Radio Button should already be selected. If not, select the
desired radio button.
d) Select the DOS Properties push button.
e) Select the DOS Video Settings radio button.
f) Select the OK push button. The DOS Settings - DOS Video Settings
window will appear.
g) From the list of settings which appear ensure that
"VIDEO_8514A_XGA_IOTRAP" is switched OFF, AND
"VIDEO_SWITCH_NOTIFICATION" is switched to ON.
h) Select the Save push button.
i) Close the DOS Full Screen (or Window) Settings Notebook.
NOTES:
o Any session started with this altered icon will support a Windows
session started with the WIN command.
o Some DOS games will not run properly with these altered settings.
Therefore, it is recommended that you reset the altered settings
to their defaults first.
o If a WIN-OS2 session is started without changing the
"VIDEO_8514A_XGA_IOTRAP" or "VIDEO_SWITCH_NOTIFICATION" options,
and the WIN-OS2 session hangs, use the following recovery
procedure rather than powering off your system:
a) Press Ctrl+Esc. This displays the OS/2 Window List.
b) Click, using the Number 2 mouse button, on the DOS session
which has the WIN-OS2 session running. A context sensitive
menu is displayed.
c) Click, using the Number 1 mouse button, on the Close option.
A DOS Window (or Full Screen) message is displayed stating
that this session may have an active program and asking if it
should be closed without saving your data.
d) Click on the YES push button. The WIN-OS2 Session and the DOS
Window (or Full Screen) will be closed.
(End of Document)