Date: 03/31/92
Status: Beta 2.0.01
Revised README.DOC file (04/07/92)
Revised README.DOC file (04/08/92)
Revised README.DOC file (04/14/92)
Revised README.DOC file (04/16/92)

[Usenet/Internet Distribution:
Revised May 2, 1992, by Timothy F. Sipples, netmail
[email protected].]

*Last minute change:
WINOS2 drivers are not included. They can be downloaded
from Trident BBS. These drivers are regular Windows 3.0
VGA.DRV drivers. If you already have these drivers, you
may not want to download them again.

[Usenet/Internet Distribution:
Suitable Win-OS/2 drivers are included (equivalent to Windows 3.0 drivers).
Note that these Win-OS/2 drivers work only with 8900C/9000 chipset Trident
adapters. For suitable drivers for other chipsets use those supplied with
the adapter.]

Trident
TVGA 8900/9000 PM Display Driver Package
for OS/2 Version 2.0

IMPORTANT: Before installing any of the programs in this package, make
--------- sure that you read through this document once.

Download Info
-------------

Instead of downloading the whole package listed below, we
recommend that you choose the one or two drivers that fits your current
needs and system configuration.

After downloading any of the files in this package, please
use PKUNZIP utility to unpack it. All the files listed below are
available from Trident BBS:

W800.ZIP - 800x600-16 Seamless DISPLAY.DLL
and SWINVGA.DRV (W800SL.DRV)
W1024.ZIP - 1024x768-16 DISPLAY.DLL
T640.ZIP - 640x480-256 DISPLAY.DLL
T768.ZIP - 768x1024-256 DISPLAY.DLL (portrait)
T800.ZIP - 800x600-256 DISPLAY.DLL
T1024.ZIP - 1024x768-256 DISPLAY.DLL
T8514.ZIP - 1024x768-256 DISPLAY.DLL with 8514 type
fonts and icons
T640V512.ZIP - 640x480-256 Virtual Desktop DISPLAY.DLL
(1024x512-256 for 512 KB memory)
T640V.ZIP - 640x480-256 Virtual Desktop DISPLAY.DLL
(1024x1024-256 for 1MB memory)
T800V.ZIP - 800x600-256 Virtual Desktop DISPLAY.DLL
(1024x1024-256 for 1MB memory)

[Usenet/Internet Distribution:
These files, and the Win-OS/2 drivers, have been bundled in a slightly
different fashion.]

The above files may also be available from the following
BBSes or Internet FTP archives (maybe different file names):

IBM NSC BBS: (404) 835-6600
Fernwood: (203) 483-0348
OS/2 Shareware: (703) 385-4325
CompuServe IBMOS2 forum
hobbes.nmsu.edu (anonymous FTP)
novell.com (not day time) (anonymous FTP)
mtsg.ubc.ca (anonymous FTP)
archive.latrobe.edu.au (anonymous FTP)
usenet news system: comp.binaries.os2

Newer releases of OS/2 drivers will be posted on Trident
BBS later. Please check the date and status of the driver files.

Descriptions:
-------------

( The following descriptions assume that OS/2 2.0 is installed on
the target system, drive C:. )

The file W800.DLL is a customized PM display driver which supports
the 800x600-16 color mode PM Desktop session. This file (if 800x600 16
color mode is chosen as the desired display mode) will replace the default
DISPLAY.DLL (640x480-16 color standard VGA mode) file in directory
C:\OS2\DLL. This driver is fully compatible with 2.0 display driver spec
and is capable of running seamless Windows applications. To run seamless
Windows apps on 800x600-16 workplace shell, you need also install
W800SL.DRV.

The file W1024.DLL is a customized PM display driver which supports
the 1024x768-16 color mode PM workplace shell. This file will replace the
default DISPLAY.DLL file in directory C:\OS2\DLL.

The file T640.DLL is a customized PM display driver which supports
the 640x480-256 color mode PM workplace shell. This file will replace the
default DISPLAY.DLL file in directory C:\OS2\DLL.

The file T768.DLL is a customized PM display driver which supports
the 768x1024-256 (portrait mode) color mode PM workplace shell. This file
will replace the default DISPLAY.DLL file in directory C:\OS2\DLL.

The file T800.DLL is a customized PM display driver which supports
the 800x600-256 color mode PM workplace shell. This file will replace the
default DISPLAY.DLL file in directory C:\OS2\DLL.

The file T1024.DLL is a customized PM display driver which supports
the 1024x768-256 color mode PM workplace shell. This file will replace the
default DISPLAY.DLL file in directory C:\OS2\DLL.

The file T8514.DLL is similar to T1024.DLL, which supports the
1024x768-256 color mode PM workplace shell. However, it contains 8514
compatible type of fonts and icons. This file will replace the default
DISPLAY.DLL file in directory C:\OS2\DLL.

The file T640V512.DLL is a Virtual Desktop PM display driver which
supports 1024x512-256 color PM workplace shell through a physical 640x480
256 color display screen. This file will replace the default DISPLAY.DLL
file in directory C:\OS2\DLL. (For more info on Virtual Desktop, see
Appendices below.)

The file T640V.DLL is a Virtual Desktop PM display driver which
supports 1024x1024-256 color PM workplace shell through a physical 640x480
256 color display screen. This file will replace the default DISPLAY.DLL
file in directory C:\OS2\DLL. (For more info on Virtual Desktop, see
Appendices below.)

The file T800V.DLL is a Virtual Desktop PM display driver which
supports 1024x1024-256 color PM workplace shell through a physical 800x600
256 color display screen. This file will replace the default DISPLAY.DLL
file in directory C:\OS2\DLL. (For more info on Virtual Desktop, see
Appendices below.)

The file W800SL.DRV (zipped in W800.ZIP) is a customized WINOS2
display driver which supports Windows applications running on PM workpalce
shell seamlessly. The PM workplace shell should run in 800x600-16 mode
(using W800.DLL as DISPLAY.DLL). This file will replace the default
SWINVGA.DRV in directory C:\OS2\DLL.

BVH driver support, which is a nice feature with our 1.x drivers,
is no longer included in this package since OS/2 2.0 has build-in Trident
SuperVGA support.

PMFIX for 1.x should not be executed under 2.0.

OS2CRTC, which is used to adjust video parameters for 1.2/1.3
OS/2 drivers is not available at this time. However, there is an
alternative. See descriptions in "Appendices" below.

Installation:
-------------

[Usenet/Internet Distribution:
Make sure that IOPL=YES in CONFIG.SYS.]

0. Install OS/2 2.0 GA version with TVGA card on system
Assume the startup drive is C:
1. Make a backup copy of the following OS/2 drivers:
C:\OS2\DLL\DISPLAY.DLL
(PM display driver)
C:\OS2\MDOS\WINOS2\SYSTEM\VGA.DRV
(WINOS2 full screen driver)
C:\OS2\MDOS\WINOS2\SYSTEM\SWINVGA.DRV
(WINOS2 seamless driver)
We recommend that the backup be put on a floppy
2. Unzip the drivers to be installed
3. Go to a DOS Full Screen session, run system command
SVGA ON
A file called SVGADATA.PMI will be generated in C:\OS2
Save this file on a floppy disk
4. Switch to OS/2 protected mode session and start
DDINSTAL
5. Follow the instructions to finish the rest of the procedures
6. You need to shut down and re-boot the system before the
driver takes into effect
7. Before installing T768.DLL, T640V512.DLL, T640V.DLL T800V.DLL,
read the special discussions below

Appendices:
----------

1. Files in the package:

README DOC -- Read this first

W800 DLL -- 800x600-16 color PM driver
W1024 DLL -- 1024x768-16 color PM driver
T640 DLL -- 640x480-256 color PM driver
T768 DLL -- 768x1024-256 color PM driver
T800 DLL -- 800x600-256 color PM driver
T1024 DLL -- 1024x768-256 color PM driver
T8514 DLL -- 1024x768-256 color PM driver
with 8514 compatible resources
T640V512 DLL -- 640x480-256 color PM driver
with 1024x512 virtual desktop
T640V DLL -- 640x480-256 color PM driver
with 1024x1024 virtual desktop
T800V DLL -- 800x600-256 color PM driver
with 1024x1024 virtual desktop

W800SL DRV -- 800x600-16 seamless WINOS2 driver

W800 DDP -- Device Driver Profile (for DDINSTAL)
W1024 DDP
T640 DDP
T768 DDP
T800 DDP
T1024 DDP
T8514 DDP
T640V512 DDP
T640V DDP
T800V DDP

2. On board video memory requirements (8900/9000)

driver resolution min. mem (KB) chipset

W800.DLL 800x600 -16 256 8900/9000
W1024.DLL 1024x768-16 512 8900/9000
T640.DLL 640x480-256 512 8900/9000
T768.DLL 768x1024-256 1024 8900
T800.DLL 800x600-256 1024 8900
T1024.DLL 1024x768-256 1024 8900
T8514.DLL 1024x768-256 1024 8900
T640V512.DLL 640x480-256 (1Kx.5K) 512 8900/9000
T640V.DLL 640x480-256 (1Kx1K) 1024 8900
T800V.DLL 800x600-256 (1Kx1K) 1024 8900

Fail to comply with the above requirements may cause
system hangup during OS/2 boot. In case this happens,
use a bootup diskette to boot from drive A, restore OS/2
default DISPLAY.DLL driver (the saved one), then boot
OS/2 again.

[Usenet/Internet Distribution:
It appears that T640.DLL and T640V512.DLL actually require 1024K video
memory. This problem is being worked on.]

3. Some useful tips for trouble shooting

. Use TVGA 8900C/9000 chips or newer.
8900B chipset works in most cases.

[Usenet/Internet Distribution:
Note: The archive "8900bfix" provides additional support for this
level chipset.]

. Use OS/2 2.0 GA version only.
OS/2 installation should be done after installation
of TVGA card.
. Do not forget to backup original OS/2 drivers
. Do not forget to run SVGA ON system command from
DOS FULL SCREEN session.
. Alt-F1 on system boot time will erase SVGADATA.PMI
Back up the .PMI files before trying Alt-F1
. Make sure your TVGA board has enough memory for
the designated PM display mode.
. Expierenced users may choose to manually copy the
driver files to C:. Make sure DISPLAY.DLL and
Seamless WINOS2 drivers use the same resolution
and color. Full screen WINOS2 driver may use
different display mode.
. Whenever the TVGA board configuration is changed,
such as adding or removing display RAM, setting
jumpers, you need to run SVGA ON again to replace
.PMI file. The best way for this is to run SVGA OFF,
restore the original VGA (640x480-16) DISPLAY.DLL,
erase old .PMI file first. Change the hardware
configuration. Then boot and run SVGA ON from DOS
full screen session. Install the SVGA driver
and reboot.
. T768.DLL (portrait mode) needs a special .PMI
entry that currently can not be generated by
SVGA.EXE. If you have problem installing this
driver, contact our technical support.
. If abnormal display occurs when running apps,
please try to duplicate the problem. You may
also want to try the same apps under the original
DISPLAY.DLL which comes with your OS/2. If the
problem is still there, there is a high chance
that this is an application's bug. Otherwise,
please report the problem to our technical
support.
. Bugs can usually be fixed within days. But for
stability, the drivers may not be available to
the public immediately until the next major driver
release. Private build can be obtained on individual
bases for evaluation.
. If you cannot get TVGA driver for WINOS2 working,
check to see if the driver is compressed. A regular
size (just like the W800SL.DRV) is about 73000 bytes.
If yours is considerably small, you need to uncompress
it first. Try the EXPAND.EXE program in GA Disk 9 to
uncompress the .DRV file.

[Usenet/Internet Distribution:
Note: The Win-OS/2 drivers supplied with the OS/2 drivers have been
pre-EXPANDed for convenience.]

4. Advanced topic: adjusting video parameters

In most cases, TVGA card matches display monitors
perfectly. However, some monitors cannot sync under
default system settings. Other monitors support high
refresh rates. To get the best display result, you
may want to go through the following procedures to
adjust video parameters. Unless this is necessary,
and you fully understand how this works, we recommend
that you skip this operation.

. Boot OS/2 with the default DISPLAY.DLL (640x480-16).
. Use the TVGACRTC.EXE utility (on TVGA Driver/Utility
Diskettes, also available in Trident BBS) under OS/2
DOS FULL SCREEN.
It will generate TVGACRTC.SYS file and insert a line
DEVICE=TVGACRTC.SYS
in the CONFIG.SYS.
. Shutdown OS/2 and reboot the system.
. Open a DOS full screen and run
SVGA ON
This will generate a "corrected" .PMI file.
. Remove DEVICE=TVGACRTC.SYS statement from CONFIG.SYS
. Shutdown OS/2 and reboot again.

5. Advanced topic: Vertual Desktop Display Driver

Virtual Desktop Drivers (T640V512.DLL, T640V.DLL and
T800V.DLL) are a new type of OS/2 display drivers.
The driver enables user to work on a larger desktop
which cannot be supported directly by the video display
hardware. For example, your VGA monitor does not support
high resolution, or your VGA adapter is not able to set
video resolution higher than 1024x768 256 color. Also on
a smaller monitor (say 14"), you may not want to use the
highest resolution mode but still want a bigger dimension
desktop.

Typical 256 color Virtual Desktop dimensions on TVGA
chipset are 1024x1024 for 1MB RAM, 1024x512 for 512KB
RAM. Larger sizes may be supported on future TVGA
chipsets.

Since the physical screen (the viewport) is smaller than
the virtual desktop, there must be a way to move the
viewport around the desktop to display different parts
of the desktop. Current driver design enables the user
to move mouse pointer beyond the boundary of the viewport,
to the direction of the part of desktop to be viewed.
The display driver will follow the mouse pointer and
adjust the position of viewport accordingly.

Some users may not like Virtual Desktop Drivers, for
various reasons. They can use the T640.DLL or T800.DLL
instead.

To install T640V512.DLL, T640V.DLL or T800V.DLL, you need
to edit the .PMI file. Make sure that you understand the
structure of .PMI file before editing it. First make a
copy of the current .PMI file (in case you want to go back
to T640.DLL or T800.DLL). Then use an editor to open
C:\OS2\SVGADATA.PMI.

If you are installing T640V512.DLL, find the mode entry
for 640x480-256 color mode from SVGADATA.PMI file:

[comment]
Graphics Mode: 640 x 480 x 256 colours.

and change the [modeinfo] section to:

[ModeInfo]
ModeAttributes = 0x18
BytesPerScanLine = 80
XResolution = 1024
YResolution = 512
TextRows = 30
BitsPerPixel = 8
NumberOfPlanes = 1
PageLength = 524288
SaveSize = 524288
InterlaceMode = 0
BufferAddress = 0x0a0000

All other steps are similar to installing T640.DLL.

If you are installing T640V.DLL, find the mode entry
for 640x480-256 color mode from SVGADATA.PMI file:

[comment]
Graphics Mode: 640 x 480 x 256 colours.

and change the [modeinfo] section to:

[ModeInfo]
ModeAttributes = 0x18
BytesPerScanLine = 80
XResolution = 1024
YResolution = 1024
TextRows = 30
BitsPerPixel = 8
NumberOfPlanes = 1
PageLength = 1048576
SaveSize = 1048576
InterlaceMode = 0
BufferAddress = 0x0a0000

All other steps are similar to installing T640.DLL.

If you are going to install T800V.DLL, find the mode
entry for 800x600-256 color mode from SVGADATA.PMI file:

[comment]
Graphics Mode: 800 x 600 x 256 colours.

and change the [modeinfo] section to:

[ModeInfo]
ModeAttributes = 0x18
BytesPerScanLine = 100
XResolution = 1024
YResolution = 1024
TextRows = 37
BitsPerPixel = 8
NumberOfPlanes = 1
PageLength = 1048576
SaveSize = 1048576
InterlaceMode = 0
BufferAddress = 0x0a0000

All other steps are similar to installing T800.DLL.

Trident Microsystems, Inc.
205 Ravendale Drive
Mountain View, CA 94043

Phone: (415) 691-9211
BBS: (415) 691-1016 (Original distribution site for this package)
Line 0: 9600 bps
Line 1: 2400 bps
Parity: NONE
Data: 8
Stop: 1

* This package if provided by Trident Microsystems, Inc. It can be
uploaded to any other electronic media, provided that no charge is
made from it.