OS/2 GRADD DEVICE DRIVERS Page 1
EXTRACTION
__________
To set up the GRADD Graphics BBS driver installation directory, do the
following:
1. Open an OS/2 full-screen or OS/2 window session.
2. Before running the GRADDBB*.EXE self extracting zip file (the exact
name depends on the release build number), change the current directory
to the "installation directory" in which you wish to store the GRADD
Graphics BBS driver installation files. We suggest C:\BBS\GRADD.
At the OS/2 command prompt, type the following commands:
C:
MD C:\BBS
MD C:\BBS\GRADD
CD C:\BBS\GRADD
3. Use the "-DIR" and "-OVER" options on the GRADDBB*.EXE self extracting
zip file to create the installation directory tree. You may wish to copy
the GRADDBB*.EXE self extracting zip file to the installation directory
first. Then at the OS/2 command prompt, type the following command:
GRADDBB* -DIR -OVER
4. Use SET LANG= to set the correct language. The language may already be
correctly set in your CONFIG.SYS. If not, then at the OS/2 command
prompt, type one of these SET LANG= commands to choose your language:
SET LANG=ar_AA for Arabic (English wlth Arabic graphics formatting)
SET LANG=pt_BR for Brazil
SET LANG=zh_CN for Simplified Chinese
SET LANG=de_DE for Germany
SET LANG=da_DK for Denmark
SET LANG=es_ES for Spain
SET LANG=el_GR for Greece (English with Greek graphics formatting)
SET LANG=fi_FI for Finland
SET LANG=fr_FR for France
SET LANG=iw_IL for Israel (English with Hebrew graphics formatting)
SET LANG=it_IT for Italy
SET LANG=ja_JP for Japan
SET LANG=ko_KR for Korea
SET LANG=nl_NL for Netherlands
SET LANG=no_NO for Norway
SET LANG=sv_SE for Sweden
SET LANG=zh_TW for Taiwan
SET LANG=en_US for English (default)
Each language has its own copy of this README.TXT file, which may be
translated from English, as well as other language dependent files.
OS/2 GRADD DEVICE DRIVERS Page 2
5. The SETUP command in the installation directory may then be used to
install the proper language dependent files and configuration
information from the install directory onto your boot drive.
Running SETUP without any options will give brief syntactic help
about the SETUP command (described later in detail in this README file)
in your chosen or default language. To see this help, at the OS/2
command prompt, type the following command:
SETUP
CONTENTS
________
Extraction . . . . . . . . . . . . . . . . . . . . 1
Package Contents . . . . . . . . . . . . . . . . . 2
Licenses and Warranties. . . . . . . . . . . . . . 3
Trademarks . . . . . . . . . . . . . . . . . . . . 3
Graphics Adapter Device Drivers (GRADD) . . . . . 4
Supported Features . . . . . . . . . . . . . . . . 4
Drivers Included . . . . . . . . . . . . . . . . . 4
Supported Resolutions . . . . . . . . . . . . . . 5
Compatibility . . . . . . . . . . . . . . . . . . 5
Functional Restrictions . . . . . . . . . . . . . 5
Copying To Diskettes . . . . . . . . . . . . . . . 6
Installation . . . . . . . . . . . . . . . . . . . 7
Preliminary Steps . . . . . . . . . . . . . . . . 7
Setting Your Display To VGA Mode . . . . . . . . . 7
Attended Installation . . . . . . . . . . . . . . 7
Installation in a CID Environment . . . . . . . . 10
APAR Fixes Included in This Driver . . . . . . . . 12
PACKAGE CONTENTS
________________
This package contains the following:
o OS/2* GRADD graphics device drivers.
o This README.TXT file, formatted for viewing on your screen.
You can:
- Use the Table of Contents and page numbers (which appear at the top
of each page) 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.
OS/2 GRADD DEVICE DRIVERS Page 3
LICENSES AND WARRANTIES
_______________________
PLEASE READ THE FOLLOWING TERMS AND CONDITIONS.
YOUR USE OF THE OS/2 GRADD DEVICE DRIVERS
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 GRADD DEVICE DRIVERS
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
THESE OS/2 GRADD DEVICE DRIVERS;
HOWEVER, THIS DOES NOT EXTEND ANY WARRANTY OUTLINED IN SUCH AGREEMENT.
o READ THIS ENTIRE DOCUMENT BEFORE BEGINNING THE GRAPHICS DEVICE DRIVER
INSTALLATION.
IBM DISCLAIMS ALL OTHER 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.
THESE DRIVERS ARE COPYRIGHTED BY INTERNATIONAL BUSINESS MACHINES CORPORATION.
ALL APPROPRIATE RESTRICTIONS APPLY.
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
WIN-OS/2
The following terms, denoted by a double asterisk (**) in this file, are
trademarks or registered trademarks of other companies as follows:
TRADEMARKS OWNER
__________ __________________________
Windows Microsoft Corporation
nVidia nVidia Corporation
VESA Video Electronics Standards Association
OS/2 GRADD DEVICE DRIVERS Page 4
GRAPHICS ADAPTER DEVICE DRIVERS (GRADD)
_______________________________________
GRADD is an architecture that makes it easier to support new graphics
hardware as it becomes available. Enhanced PM applications performance
can be realized when using accelerated GRADD drivers.
Several new and updated GRADD drivers are included with this package.
SUPPORTED FEATURES
__________________
The GRADD device drivers provide seamless support for accelerated and
unaccelerated display graphics and advanced color depth and resolutions.
They conform to the OS/2 32-bit flat memory model and are designed to
function as 32-bit Presentation Manager* graphics display drivers under
the OS/2 32-bit graphics engine.
DRIVERS INCLUDED
________________
The following accelerated GRADD drivers are included:
* nVidia GRADD (NVGRADD)
Also included are generic VGA and SVGA support.
* Video Graphics Array GRADD (VGAGRADD)
* Generic SVGA GRADD (GENGRADD)
If an accelerated GRADD or PM driver is not included for your adapter,
GENGRADD may provide UNACCELERATED support for display graphics at enhanced
resolutions and colors depths. GENGRADD will work with most adapters
that include a VESA compliant BIOS; and the performance, which will vary
depending on system configuration, will not be as good as an accelerated
driver.
OS/2 GRADD DEVICE DRIVERS Page 5
SUPPORTED RESOLUTIONS
_____________________
Supported resolutions and color depths are adapter dependent and will vary
depending on the amount of graphics memory and the adapter implementation.
COMPATIBILITY
_____________
These graphics device drivers are currently compatible with:
All versions of OS/2 3.0 with fixpak level 35 or later
All versions of OS/2 4.0 with fixpak level 5 or later
All versions of OS/2 Warp Server for e-business
The SETUP installation command rejects installations on unacceptable OS/2
versions or fixpak levels.
Also, after installing these graphics drivers, if you later wish to
uninstall any required Fixpak to a Fixpak level before Fixpak 5 (OS/2 4.0)
or Fixpak 35 (OS/2 3.0), you should first restore your computer to VGA to
remove the GRADD BBS drivers.
Other than the use of English messages, the SBCS drivers installed for SBCS
languages not in the SET LANG= list in the section entitled "Extraction"
above are correctly functional for the chosen language.
FUNCTIONAL RESTRICTIONS
_______________________
Current known restrictions include the following:
1) IBM has tested many computers and adapters incorporating the graphics
devices for the accelerated drivers listed. Testing was only done on
computers with PCI bus graphics, although a PCI bus is not a specific
requirement.
2) Sniff testing on ISA bus graphics adapters has worked. However when
trying to restore your previous "PM" driver, there was a sometimes a
problem detecting the adapter. Powering off the computer to initialize
the adapter after restoring VGA should solve the problem.
3) All the GRADD drivers, except for VGAGRADD, require VESA** compliant video
BIOS (Version 1.2 or greater) or an appropriate SVGADATA.PMI file. For
older non-VESA adapters with SVGA PM driver support from IBM, GENGRADD may
often be used as an alternative SVGA driver set by following the GRADD
Graphics BBS drivers SETUP installation command with the command
"SVGA ON INIT" from an OS/2 or DOS Full Screen prompt to create an
SVGADATA.PMI file, before rebooting to use the GRADD drivers.
OS/2 GRADD DEVICE DRIVERS Page 6
You can find future fixes and updates for the GRADD and other graphics device
drivers via the internet at:
http://service5.boulder.ibm.com/pspfixpk.nsf
At the above URL choose "All Fix packages - By Product" and then search for
"GRADD".
COPYING TO DISKETTES
____________________
Once extracted to an installation directory tree, you may place the GRADD
driver installation files on diskettes for backup or transportation purposes
using the OS/2 BACKUP command:
1. Open an OS/2 full-screen or OS/2 window session.
2. Type "BACKUP C:\BBS\GRADD A: /S" and press the Enter key.
3. Label and insert as many preformatted diskettes as required.
4. You can use HELP BACKUP to get more information about the BACKUP command.
To restore the same diskettes to the same or a different computer:
1. Open an OS/2 full-screen or OS/2 window session.
2. Type "RESTORE A: C:\BBS\GRADD /N /S" and press the Enter key.
3. Insert previously backed up diskettes as required.
4. You can use HELP RESTORE to get more information about the RESTORE command.
IBM has made no provision for installing these drivers directly from
diskettes.
OS/2 GRADD DEVICE DRIVERS Page 7
INSTALLATION
____________
PRELIMINARY STEPS
_________________
The following steps prepare your computer before installing the GRADD device
drivers:
1. Other applications, particularly WIN-OS/2 applications, should be closed
so that the device driver installation can replace the driver files which
an open application might have locked as read only.
2. If you previously installed an SVGA driver, return to VGA resolution using
the procedures in the section of this README entitled "Setting Your
Display to VGA Mode".
SETTING YOUR DISPLAY TO VGA MODE
________________________________
If your display is in sync and you otherwise have a usable Desktop, we
recommend that you use Selective Install to set your display to VGA mode.
Otherwise, use the following procedures to return to VGA mode.
1. Turn on your computer. If your computer is already on, shutdown or
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 function key F3
or the letter "V" depending on the operating system version.
4. Run Selective Install to change the Windows drivers.
Once the computer has booted, your display adapter is restored and can work
in VGA mode. If you want to install a new display adapter or graphics
device driver, refer to the chapter entitled "Video Procedures" in the User's
Guide to OS/2 Warp.
ATTENDED INSTALLATION
_____________________
To do an attended install of the GRADD Drivers from the self extracting zip
file installation directory, do the following:
1. Open an OS/2 full-screen or OS/2 window session.
2. Before running the extracted SETUP.CMD file, use SET LANG= to set the
correct language. The language may already be correctly set in your
CONFIG.SYS. The section of this README entitled "Extraction" gives
examples.
OS/2 GRADD DEVICE DRIVERS Page 8
3. At the OS/2 command prompt, type the following command to copy all the
required files to the OS/2 boot drive:
SETUP xxx [] [] [/u]
Where:
xxx is one of:
"GEN" - Generic VESA Unaccelerated GRADD
"NV" - nVidia Family GRADD
"VGA" - Video Graphics Array (VGA) GRADD
for SETUP is required if SETUP is not in the current
directory.
[] parameter is optional (required if next parameter
specified) and is the installation directory.
[] is optional and is the drive where OS/2 is installed.
[/u] is optional and indicates an unattended install such as for
CID installations. A CID response file is not required.
Then press Enter.
4. When prompted to do so, shutdown, and then restart your computer.
NOTES:
1) During the installation of this driver, DISPLAY.LOG and DSPINSTL.LOG
files are created or appended to in the OS2\INSTALL directory. These
files identify the OS/2 system files that were updated and indicate
whether the installation was successful and reasons for failure. The
contents of these files might be useful if you need to report an
installation problem to IBM.
2) You may be prompted about whether you want to overlay certain files
where the target file is newer than the source file. In general, you
should answer YES to all the prompts unless you have previously
experienced specific problems with the driver and are re-installing it.
OS/2 GRADD DEVICE DRIVERS Page 9
5. After the computer reboots, do the following to configure correctly for
your current display and choose an appropriate resolution and refresh
rate:
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. VESA** Display Data Channel (DDC) 1 and 2B protocols are supported
for automatically detecting DDC displays.
If your display is DDC compatible, Screen Page 2 should show a
description of your display.
If your display is not DDC compatible,
select your display from the display list on Screen Page 2.
If your display does not appear in the list, select Default.
f. Return to Screen Page 1 and select a resolution and refresh rate.
Depending your adapter and display, refresh rates may not be
selectable.
g. Close the Settings notebook.
h. Shutdown and restart your computer.
OS/2 GRADD DEVICE DRIVERS Page 10
INSTALLING IN A CID ENVIRONMENT
_______________________________
NOTES:
1. Create a directory on the server (e.g. X:\BBS\GRADD) and extract the
installation files from the self extracting GRADDBB*.EXE file to the
X:\BBS\GRADD installation directory as described under the section
entitled "Extraction".
2. You must have OS/2 successfully installed on the client using the CID
(Configuration Installation Distribution) method.
3. To configure display selection, resolution and refresh rate, refer to the
file "README.CFG" in this package.
To install a device driver using CID, use the following information to modify
your LCU command file. The example below installs the ATI Mach64/Rage GRADD
(M64GRADD).
NOTE: The following information is meant as a guide.
Your LCU command file might be different.
/*****************************************************/
/* LCU PRODUCT DATA SECTION */
/*****************************************************/
.
.
.
x.graddvideo = 15
x.15.name='ATI Gradd Video'
x.15.statevar = 'CAS_' || x.15.name
x.15.instprog = 'x:\bbs\gradd\SETUP.CMD',
' ATI',
' x:\bbs\gradd ' || bootdrive,
' /u'
x.15.rspdir = ''
x.15.default = ''
/*****************************************************/
/* NUMBER OF PROGRAMS SET UP IN THE */
/* PRODUCT DATA SECTION */
/*****************************************************/
NUM_INSTALL_PROGS = 15
OS/2 GRADD DEVICE DRIVERS Page 11
/*****************************************************/
/* INSTALLATION SECTION */
/*****************************************************/
.
.
.
when OVERALL_STATE = 2 then do
if RunInstall(x.graddvideo) == 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 computer */
return
.
.
.
/*****************************************************/
/* END OF LCU INFORMATION TO BE ADDED */
/*****************************************************/
OS/2 GRADD DEVICE DRIVERS Page 12
APAR FIXES 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.
(End of Document)