home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 33 VDrivers
/
33-VDrivers.zip
/
cirrus1.zip
/
README.TXT
< prev
next >
Wrap
Text File
|
1996-05-10
|
22KB
|
597 lines
OS/2 DEVICE DRIVER FOR THE CIRRUS LOGIC 5426, 5428,
5430, and 5434
This package contains the following:
o An OS/2* graphics device driver supporting the 5426,
5428, 5430, and 5434 chip sets from Cirrus Logic**, Inc.
o This README file, which is formatted for viewing
on your screen. You can:
- 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 THE CIRRUS LOGIC
5426, 5428, 5430, 5434 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
THE CIRRUS LOGIC 5426, 5428, 5430, 5434 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 THE CIRRUS LOGIC 5426, 5428, 5430, 5434;
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
7.0 Setting Your Display to VGA Mode
8.0 APAR Fixes Included in This Driver
9.0 Trademarks
1.0 SUPPORTED FEATURES
_______________________
The Cirrus Logic 5426, 5428, 5430, 5434 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 accelerator driver supports
these resolutions and color depths:
Number of Video Memory
Resolutions Colors Required
640x480 256 1MB
800x600 256 1MB
1024x768 256 2MB
1280x1024 256 2MB
640x480 65,536 1MB
800x600 65,536 1MB
1024x768 65,536 2MB
640x480 16,777,216 2MB
1.2 SUPPORTED ADAPTERS
IBM has tested display adapters and systems containing the
Cirrus Logic 5426, 5428, 5430, 5434 chip sets with the specified
amount of memory. IBM is continuing to test; therefore, support
for additional cards might be added over time.
For a comprehensive listing of all 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 Systems:
IBM National Support Center BBS (data connection: 919-517-0001)
CompuServe (IBM OS/2 Support Forum \Library\IBMFiles\PCMTABLE.ZIP)
Prodigy
LAN Server & OS/2 BBS -Sydney Australia
IBM Austria BBS - Vienna, Austria
IBM BBS - Vancouver, BC, Canada
IBM PS BBS - Hong Kong
IBM OS/2 BBS & IBM AP OS/2 BBS - Singapore
IBM BBS - Belgium
IBM BBS - England
IBM BBS - Spain
OS2BBS - Denmark
Hitline BBS- Switzerland
DAP & PSP BBS - Italy
IBM BBS - Jakarta
IBM BBS - Thailand
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 3.
3.0 PRELIMINARY STEPS
______________________
The following steps prepare your computer for the
Cirrus Logic 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.
4.0 INSTALLATION FROM DISKETTE
_______________________________
To install the Cirrus Logic device driver
from diskette, do the following:
1. Insert the Cirrus Logic diskette into drive A (or
any other diskette drive).
Note: This diskette should have a volume label of "CIRRUS 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 "Cirrus Logic 5426, 5428, 5430, 5434 (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. You can
accept this choice or select "Install Using
Display Adapter Utility Program" to choose a
different refresh rate. Then select OK.
If you select the "Install Using Display Adapter
Utility Program" choice, you must have the DOS
monitor utility that came with your display
adapter. Contact the display adapter
manufacturer's technical support for information
on how to use the monitor utility under OS/2.
NOTE: At this point, 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.
10. When the Source Directory pop-up window appears,
insert the Cirrus Logic diskette into drive A.
Then select Install.
11. When the installation is complete, do the
following for all adapters except the 5426.
For the 5426 step 'e' is skipped.
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. On Screen page 2, select your display from
the display list. If your display does not
appear in the list, select Default.
f. Return to Screen page 1 and select a screen
resolution and a screen refresh rate.
g. Close the Settings notebook.
h. 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
CIR_DRVS on the same drive where the OS/2
diskettes reside. The CIR_DRVS directory must
contain all of the files from the Cirrus Logic
device driver diskette.
2. OS/2 must have been successfully installed on the
client using the CID (Configuration Installation
Distribution) method.
To install the Cirrus Logic 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.cirvideo = 15
x.15.name='Cirrus Video'
x.15.statevar = 'CAS_' || x.15.name
x.15.instprog = 'x:\img\cir_drvs\SETUP.CMD',
' x:\img\cir_drvs ' || bootdrive || ' CID'
x.15.rspdir = ''
x.15.default = ''
x.cirdspinstl = 16
x.16.name='Cirrus CID Dspinstl'
x.16.statevar = 'CAS_' || x.16.name
x.16.instprog = bootdrive || '\os2\install\DSPINSTL.EXE',
' /pd:' || bootdrive || '\os2\install\cl54xbb.dsc',
' /s:x:\img\cir_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.cirvideo) == BAD_RC then exit
Call RebootAndGotoState(3)
end
when OVERALL_STATE = 3 then do
if RunInstall(x.cirdspinstl) == 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\cl54xbb.dsc
/S:X:\img\cir_drvs /T:C: /res:640x480x256 /u
/pd:c:\os2\install\cl54xbb.dsc
is the dsc laid down during setup phase.
/S:X:\img\cir_drvs
where X:\img\cir_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:
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 Cirrus 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 After Dark** for Windows** images that move from
left to right do not perform properly at
640x480x16M resolution.
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 To avoid a trap in Lotus** 1-2-3** for OS/2, do
not attempt to run the program at 16.7 million
colors.
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 or 600x480x16 million 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
as Fix Package XR06200 for APAR PJ11051. OS/2 versions
2.11 and above have this fix. The software motion
video feature is not supported in 16-million
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.
o Distributed Console Access Facility (DCAF) is
supported in 256-color modes only.
o You might have to run the CLMODE utility to
enable the BIOS to generate high-resolution
modes.
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
option 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 3. 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 Enter. When the install
option 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 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 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.
APAR=PJ16493
WARP,CM/2 1.11,5250 EMULATOR IN ANY SVGA RES
UNDERSCORE DISPLAYS OUT OF WINDOW.
APAR=PJ17644
GPIFLOODFILL() DOES NOT RETURN WHEN SELECTED PALETTE IS OTHER
THAN DEFAULT. THIS HAPPENS ONLY USING CIRRUS LOGIC 5422 DRIVER.
APAR=PJ18212
DRAG OPEN FOLDERS INSIDE FILE MANAGER (SEAMLESS SESSION),
AND REMNANTS OF THE BORDERS ARE LEFT INSIDE FILE MANAGER.
APAR=PJ18892
TOGGLING BETWEEN WINOS2 FULL SCREEN AND DESKTOP WITH CIRRUS DRIVERS
SVGA CAUSES CORRUPTION.
APAR=PJ19154
CIRRUS LOGIC ACCELERATOR BBS DRIVER CAUSES CORRUPTION IN VIDEO
DISPLAY WHEN TOGGLING INTO WINDOWS FULLSCREEN SESSIONS.
APAR=PJ19369
TRAP000E LOGGING OFF RESTRICTED SHELL WITH WINOS2 SESSION IN
BACKGROUND. TRAP IS IN VSVGA.SYS CIRRUS 5430 DRIVERS.
APAR=PJ19408
RUNNING A PROGRAM CREATED BY GRASP IN FULLSCREEN. DOS SESSION AND
SWITCHING TO DESKTOP WILL CORRUPT DOS SESSION.
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:
DCAF
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:
TRADEMARK OWNER
After Dark Berkely Systems, Inc.
Cirrus Logic Cirrus Logic, Inc.
CorelDRAW Corel Corporation
Lotus Lotus Development
Corporation
Micrografx Micrografx Incorporated
Ventura Publisher Ventura Software, Inc.
Windows Microsoft Corporation
WordPerfect WordPerfect Corporation
1-2-3 Lotus Development
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)