Intel(R) Brookdale-G (845-G) chipset GRADD video driver
For IBM(R) OS/2 Warp(R)
version 2.19 Build 0002
Installation Readme


This package installs an update to the IBM OS/2 device driver 
for the Intel(R) Brookdale-G (845-G) video chipset that comes
preinstalled in your IBM(R) computer.

This document refers to all IBM NetVista systems containing the
Intel(R) Brookdale-G (845-G) chipset. This update requires
a blank 3.5 inch 1.44MB floppy diskette.

Print this file so that you can refer to it during the installation.


Downloading the update
----------------------
1. Click the file link to download the file from the Web page.
2. When prompted, select a drive and directory in which to save
   the downloaded file.

Extracting the update
---------------------
1. Run the executable file e40t04a.exe.  
2. Follow the onscreen prompts. The necessary files will be 
   extracted to the diskette. 


Installing the update
---------------------
1. Check the system requirements. IBM OS/2 must be fully
   installed and running on the system prior to running this
   software. The system must be in VGA mode. If installing 
   additional fixpacks, do so while the system is in VGA mode. 
   For instructions on setting the desktop in VGA mode, refer 
   to the "De-Installing the Software" section. All IBM OS/2 
   sessions must be closed prior to installing this driver.
2. Insert the Intel GRADD driver diskette into drive A 
   (or any other diskette drive).
3. Open an IBM OS/2 full-screen or IBM OS/2 window session.
   IBM OS/2 version 4 only:
   ^^^^^^^^^^^^^^^^^^^^^^^^
    At the IBM OS/2 command prompt, change to drive A:.
    Type the following command to copy all necessary files 
    to the IBM OS/2 drive:
    [a:]SETUP <SrcPath> <BootDrive> [/u]
      <SrcPath> is the diskette drive.
      <BootDrive> is the drive where IBM OS/2 is installed.
      [/u] is optional and is used to indicate unattended install 
      such as for CID installations. A CID response file is not 
      required.

    IBM OS/2 version 3 only:
    ^^^^^^^^^^^^^^^^^^^^^^^
    Requires the setup to be executed from the partition containing 
    the OS. In IBM OS/2 version 3, copy all files from the floppy 
    disk to the hard drive.
    At the IBM OS/2 version command prompt, type the following 
    command to copy all necessary files to the IBM OS/2 drive:
    [c:]SETUP <SrcPath> <BootDrive> [/u]
      <SrcPath> is the diskette drive.
      <BootDrive> is the drive where IBM OS/2 is installed.
      [/u] is optional and is used to indicate unattended 
      install such as for CID installations. A CID response 
      file is not required.

    Then press Enter.
    A number of system files will be transferred if the ones 
    found on the system are older. When a popup asking for 
    Monitor configuration choice pops up, accept "Use monitor 
    defaults" choice.

    The installation will then blank the screen while testing 
    VESA modes and if successful, it will transfer driver files.

4.  When prompted to do so, remove the diskette from drive A, perform 
    a shutdown, and then restart your computer.

5.  When the system reboots, do the following:
    a.  Open the IBM 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.
    e.  Select a resolution from the page 1.
    f.  Select a monitor from page 2.
    g.  Select refresh setting from the page 1 of the Screen tab.
    h.  Close the Settings notebook.
    i.  The selected resolution will be in effect upon the next boot.

  INSTALLATION IN A CID ENVIRONMENT
  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

  1.  Create a directory on the server (i.e. GRADDS). Copy 
      the files from the Intel(R) GRADD driver diskette to 
      the GRADDS directory.

  2.  IBM OS/2 must have been successfully installed on the 
      client using the CID (Configuration Installation 
      Distribution) method.

  To install a GRADD 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.graddvideo = 15
    x.15.name='Intel Gradd Video'
    x.15.statevar = 'CAS_' || x.15.name
    x.15.instprog = 'x:\img\gradds\SETUP.CMD',
                    ' x:\img\gradds ' || bootdrive,
                    ' /u'
    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.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

    /* Set the state to go in OVERALL_STATE */
      rc2 = SetState(new_state, 'RebootAndGotoState', 1)  
   
    /* Save the environment vars */
      Call SaveStates                  
         
    /* Reboot the machine */
      Call Reboot                               

      return
                          .
                          .
                          .

    /*****************************************************/
                END OF LCU INFORMATION TO BE ADDED
    /*****************************************************/

You may refer to readme.cfg on this diskette for information
on how to setup monitor, resolution and refresh during
CID install.


Verifying installation of the software
--------------------------------------
1.  Open the IBM OS/2 System folder.
2.  Open the System Setup folder.
3.  Open the System object.
4.  When the Settings notebook appears, select the Screen tab.
5.  Select Configuration from the page 2. The window will 
    contain the Intel(R) Brookdale-G or 845-G keyword.


Troubleshooting
---------------
This section provides troubleshooting information.

Installation problems
1. During the installation of this driver, DISPLAY.LOG and 
   DSPINSTL.LOG files are created in the OS2\INSTALL directory. 
   These files identify the IBM 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 Intel.

2. Installation of the GRADD uses the Dspinstl utility shipped 
   with IBM OS/2 4.0.  This utility can fail if it finds a 
   *.dsc file which is not a dspinstl description file. During 
   testing, it was found that installation of SystemView for 
   IBM OS/2 client may leave behind a file called "commonag.dsc"
   on the root of the bootdrive. This file is not a Dspinstl
   description file and will cause Dspinstl to fail. If you have 
   this problem, simply rename or delete the problem file. If an 
   incorrect description file is encountered, it will be noted 
   in the above log(s).

How to determine if the OS/2 GRADD Display Driver is loaded:
Refer to section 4: Verifying installation of the software.
Refer to section 7: Identifying the software version number.


De-installing the software
--------------------------
Use the following procedures to return to VGA mode and 
deinstall the software:

  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 function 
      key F3.

  4.  Your desktop will now boot in VGA mode.

This de-installation procedure is specific only to the
version of the driver and installation file included in this
package.


Identifying the software version number
---------------------------------------
You may execute bldlevel command as follows:

cd \os2\dll
bldlevel intgradd.dll

The Vendor string should read "INT", and the Revision string should be
the same as revision value of this readme. The vendor and revision
strings can also be found in the build.lvl file on the installation
diskette.


Trademarks
----------
IBM, OS/2 Warp, and Aptiva are trademarks of the IBM Corporation 
in the United States, other countries, or both.

Microsoft and Windows are trademarks of Microsoft Corporation in
the United States, other countries, or both.

Other company, product, and service names may be trademarks or
service marks of others.

THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.
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 PATENTS OR COPYRIGHTS.

(C) Copyright IBM Corporation 2002.  All rights reserved.
