


  IBM PC Card Director Software for OS/2 Warp supporting IBM ThinkPads
                       Installation Package README.
  ----------------------------------------------------------------------

  November 09, 2004

  OS/2 Device Driver Development
  IBM Solution Technologies
  Austin, TX

  (c) Copyright International Business Machines Corporation, 2001, 2004.
  All rights Reserved.


  CONTENTS
  --------



 1.0   Systems supported by this Installation Package

 2.0   How to Run the IBM PC Card Director Installation Program Utilities

 3.0   Limitations

 4.0   Parameter Definitions

 5.0   Using Point Enablers with the PC Card Director Package

 6.0   Hints

 7.0   Files

 8.0   Restore

 9.0   Copyright and Trademark Information


   


 1.0   Systems Supported by this Installation Package
       ----------------------------------------------

       This package provides PC Card Director software for IBM ThinkPads
       using the following versions of OS/2:
                OS/2 Warp 4,
                OS/2 Warp Server for e-business,
                OS/2 Warp 4 Convenience Pack 1,
                OS/2 Warp 4 Convenience Pack 2,
                OS/2 Warp Server for e-business Convenience Pack 1,
                OS/2 Warp Server for e-business Convenience Pack 2.
 
       This package have been tested on IBM ThinkPads
       with the following PC Card controllers:

          Texas Instruments TI1130
          Texas Instruments TI1131
          Texas Instruments TI1225
          Texas Instruments TI1250A
          Texas Instruments TI1251
          Texas Instruments TI1251B
          Texas Instruments TI1420
          Texas Instruments TI1450
          Texas Instruments TI1520
          Texas Instruments TI4520
          Cirrus Logic CL-PD6729
          Ricoh R5C821

       The Socket Services (IBM2SS14.SYS) and the Card Services (PCMCIA.SYS)
       drivers in this package support PC Card Standard version 8.0.



 2.0   How to Run the IBM PC Card Director Installation Program Utilities
       ------------------------------------------------------------------

    The IBM PC Card Director Installation Program Utilities for OS/2 are
    registered as objects in the "IBM PC Card Director Installation Program"
    folder. You can see ICONs titled "IBM PC Card Director Installation Program",
    "ATA Mount Utility","Auto Configurator Utility", and "Supported PCCards".
    To start these utilities, click on an ICON.

    Refer to the README.CID installation instructions for installing the
    PC Card Director Utilities for OS/2 with CID.


 3.0   Limitations
       -----------

    When utilizing cardbus cards, this code only supports the two (2) PCCard
    slots the base system unit. Non-Cardbus  (16-bit cards) function in all 
    available slots (base system unit and docking station).

 4.0   Parameter Definitions
       ---------------------

  4.1  Socket Services (IBM2SS14.SYS)
       /IG0=y  : This parameter defines a slot number that will be ignored by
                 Socket Services. If you use the "Point enabler" supplied
                 with the PC Card, you should take into consideration the
                 coexistence with Socket Services.

                 For Example, "/IG0=1" defines that slot 1 is reserved for a
                 "Point enabler" and Socket Services will ignore the slot.
		 For additional information see section 5.0.
		 
       /V      : This parameter allows the driver to show the information about
                 PC Card adapter and sockets found on system and Driver 
		    Information during startup.
		 
       /W      : This parameter allows the driver to show the information about
                 PC Card adapter and sockets found on system and Driver 
		 Information during startup. After displaing information driver 
		 waits for user response to continue loading.


  4.2  Card Services (PCMCIA.SYS)
  
       /IH     : Ignore handle parameter. This parameter forces driver to do not 
                 check the Handle passed from Client Driver. This parameter is
		 required for some client drivers. For additional information
		 see section 6.0
  
       /V      : This parameter allows the driver to show the information about
                 version and build date during startup.
		 
       /W      : This parameter allows the driver to show the information about
                 version and build date during startup. After displaing
		 information driver waits for user response to continue loading.
  



  4.3  Power Management for PC Card ($ICPMOS2.SYS)

       /C0     : Allows suspend when the communication PC Card (Modem,LAN) 
                 is inserted if the Battery Status is High.

       /C1     : Allows suspend when the communication PC Card (Modem,LAN) 
                 is inserted if the Battery Status is Low. 

       /C2     : Allows suspend when the communication PC Card (Modem,LAN) 
                 is inserted if the Battery Status is Critical.
     
      If '/Cx' parameter is not specified the default is '/C2' setting.

                 

 5.0   Using Point Enablers with the PC Card Director Package
       ------------------------------------------------------

        Point Enabler Adapter card drivers are device drivers that support
        specific Adapter cards without requiring the use of the Card and
        Socket services provided in the PC Card Director package.

        Problems using these Point Enabler device driver will occur when used
        in conjunction with the Card and Socket Services. The problem that
        must likely will occur is that the Point Enabler Adapter card will not
        function. The PC Card Director will indicate that the Card Type is
        incorrect and the Status of the Card will be 'IN' instead of 'READY'.

        In order to use a Adapter card with Point Enabler Device driver a
        configuration parameter must be added to the IBM2SS14.SYS device
        driver entry in CONFIG.SYS. The parameter is as follows:

        /IG0=y  : Where 'y' defines the slot number that contains the Adapter
                  card using the Point Enabler Device Driver.

        After the system has been rebooted the slot specified in the
        configuration parameter will be ignored by Card and Socket Services
        allowing that slot to be used by Point Enabler device drivers.
        It also means the following:
          - the PC Card Director program will not detect the insertion or
            removal of adapter cards in that slot
          - Adapter cards with device drivers that utilitize Card and
            Socket Services can no longer use that slot

        The following is a list of Adapter Cards that use Point Enabler
        Device Drivers:

        IBM 10/100 EtherJet Cardbus Adapter
        IBM 10/100 EtherJet Cardbus Adapter with 56K modem
        Intel PRO/100 Cardbus II
        Xircom CreditCard Ethernet Adapter II
        Xircom CreditCard Ethernet Adapter 10/100


 6.0   Hints
       -----

    - You can see current system resource information with RMVIEW.EXE program.
      The RMVIEW.EXE is a standard OS/2 utility program which is included in
      OS/2 Warp 4.0. To run this program, type "RMVIEW" at the OS/2 command
      prompt and press ENTER. You can see short help with "/?" option.

  6.1  Problems with Adapter Cards

    - If problems occur with an Adapter Card, like failing to work properly,
      there are three suggestions that may correct the problem:

      1. The adapter card may be using a Point Enabler device driver, in that
         case refer to Section 4.0 and set the ignore slot /IG0=y 
         parameter in the CONFIG.SYS entry for IBM2SS14.SYS.

      2. The adapter may require the use of the version 2.0 of Card Services.
         In that case set the /R:200 parameter in the CONFIG.SYS entry for
         PCMCIA.SYS.

      3. The adapter driver may require the adapter to be inserted into the slot
         before the system is booted.


  6.2  Token Ring Credit Card Adapter
    - The parameter "ENHANCED" is required to be set "ON" for this
      adapter. Use MPTS utility, for setting this parameter.


  6.3 3270 Adapter Cards

    -  On IBM 600 series ThinkPads, IBM 3270 Adapter Cards must be placed
       in the lower adapter card slot (slot 2). The 3270 Adapter Card may
       also be used in either adapter slot on attached Docking Stations.


  6.4  Storage PC Cards

    - Before using a brand-new FLASH PC Card, you have to initialize the
      card with the FFORMAT.EXE, FCHECK.EXE, FFORMAT2.EXE or FCHECK2.EXE
      program.

    - If you see the following message :

          << Attention >>
          This card isn't supported formally
          It is possible that it doesn't work correctly

      while the FFORMAT.EXE, FCHECK.EXE, FFORMAT2.EXE or FFORMAT2.EXE
      program is running, the card will be formatted as if it has
      256KB-erase-zone size and the write/erase logic of INTEL 28F020
      or 28F010.

    - If you see the following message :

          The size of this card is too small for the card to be formatted

      while the FFORMAT.EXE, FCHECK.EXE, FFORMAT2.EXE or FFORMAT2.EXE
      program is running, the card can't be formatted because its size
      is too small to accept the transfer unit.
      (At least one transfer unit is required for FTL.)

    - You can't use the SRAM region of the IBM FLASH & SRAM combo card
      on OS/2 even if you install PCM2SRAM.SYS (SRAM device driver).
      The card appears to be a FLASH card if you install
      FLSH2MTD.SYS (FLASH memory technology driver), PCM2FLSH.SYS
      (FLASH device driver), or other drivers.

    - OS/2 Warp includes a flash memory card device driver that
      can enable only IBM flash memory cards. The flash memory card device
      driver in this IBM PC Card Director Installation Program can't enable
      cards formatted with the one in OS/2 Warp.

    - In case of formatting two or more Storage PC Cards, you have to run and
      exit the FORMAT program for every card.
      You must not format two or more Storage PC Cards from a single
      invocation of FORMAT.

    - You can't use the DISKCOPY program for the Storage PC Cards drive.

    - If your PC has two or more PCMCIA slots, do not insert or remove a
      storage PC Card in the slot while you are executing DOS commands,
      such as FORMAT or COPY to a storage PC Card in another slot.

    - If your system has three or more PCMCIA slots, for example a
      notebook computer with docking station which has PCMCIA slots, the
      total number of PCMCIA slots which will be used for Storage PC Cards
      must be specified.  For example, if you have four PCMCIA slots:

        BASEDEV=PCM2ATA.ADD /S:4 /!DM /NOBEEP

  6.5 Avoiding PC Card Resource Conflicts

    - PC Card Director checks the resources for most devices used by the 
      system to avoid resource conflicts, but it does not recognize all 
      option devices used. Especially if you are using the docking station, 
      there is a possibility that the I/O port address or IRQ level might 
      conflict with the PC Card.  
      Check the status of the PC Card by using PC Card Director. When the 
      PC Card is set to "Ready," the resources used for that PC Card are 
      displayed. Refer to the manuals supplied with the system or option 
      adapters to check that the resources for the devices in the system 
      or for the option adapters do not conflict with the resources for 
      the IRQ level, I/O port address, or memory window of the PC Card. 
      If you are using OS/2 Warp Version 3 or later versions , you can check 
      the assigned system resources using RMVIEW.EXE.

   - If there is a conflict:

      1) Use RESERVE.SYS to register those resources in OS/2. 
         To set RESERVE.SYS, refer to the manuals or online help 
         for OS/2 Warp, or refer to the READ.ME file of PC Card Director.

      2) If you are using Auto Configurator, change the enabling order or 
         resource information using the Auto Configurator Utility.  
         
      3) If you are using network cards, change the resource information 
         for the PC Card stated in the PROTOCOL.INI, NET.CFG file or 
         using MPTS utility.
         To change the configuration file for the network cards, refer to 
         the manuals or READ.ME files of the PC Cards or network drivers.


  6.6 Others

    - For the Auto Configurator driver and Utility, please refer to the
      AUTODRV.DOC file for more detail.

    - For the PC Cards, please refer to the PCMCIA.CRD file for more
      detail on the support level.

    - For the PC Cards, sample installation/configuration files (CONFIG.SYS,
      AUTOEXEC.BAT, etc.) are available on your "IBM PC Card Director
      Installation Program for OS/2" diskette. Please refer to the \SAMPLES
      directory on the diskette.

    - If you use a Docking Station with your notebook computer, the adapter
      cards or the devices in the docking station may use resources such as
      I/O port, memory window, IRQ.
      Exclude these resources from the usable area of the Card Services.
      To exclude resources from the usable area, RESERVE.SYS can be used.
      See  "4.0 For OS/2" (RESERVE.SYS) in this document.
      
    - If you are using Kingston EtheRx IC PC Card  ethernet adapter you have
      to specify '/IH' parameter for PCMCIA.SYS driver in CONFIG.SYS to enable
      this card. The Client Driver for this card provides  incorrect client 
      handle to the Card Services driver.

    - Add /INT option if an error or a timeout occurs while ATA(HDD) card
      being used.

        DEVICE=...PAWATA.SYS /INT   or
        DEVICE=...PAWATAS.SYS /INT  or
        DEVICE=...PAWATASF.SYS /INT

      In this case 4KB memory window is required for every ATA(HDD) card.

    - If you have an Adaptec SCSI PCCard, find

                  'REM BASEDEV=AHA152X.ADD'

      in config.sys and change it to

                  'BASEDEV=AHA152X.ADD'.

      Adaptec SCSI adapter must be inserted into the slot before 
      booting your system and the SCSI device must be connected 
      to the adapter also.

    - If you have a Future Domain SCSI PCCard, find

                  'REM BASEDEV=FD16-700.ADD'

      in config.sys and change it to

                  'BASEDEV=FD16-700.ADD'.


 7.0   Files
       -----

      README.TXT   : This file
      PCMINST2.EXE : Installation program for OS/2
      PCMINST2.DAT : Installation program for OS/2, data file
      PCMCIA.CRD   : PC Card Support List

      EZPLAY2.DLL  : IBM PC Card Director Installation Program Utility for OS/2
      EZPLAY2.HLP  : IBM PC Card Director Installation Program Utility for OS/2, help file
      PCMCIA.SYS   : Card Services driver for OS/2
      VPCMCIA.SYS  : Virtual Card Services driver for OS/2
      $ICPMOS2.SYS : PCMCIA Power Management Support driver for OS/2
      PAWFLDR.ICO  : IBM PC Card Director Installation Program Folder ICON file
      LOGO_1.ICO   : PC Card Logo

      IBM2SS14.SYS : Socket Services driver for IBM ThinkPad

      AUTODRV2.SYS : Auto Configurator for OS/2
      AUTODRV2.SCR : Auto Configurator for OS/2, script file
      AUTOUTL2.EXE : Auto Configurator Utility for OS/2
      AUTODRV2.SEL : Auto Configurator Utility for OS/2, data file
      AUTOUTL2.HLP : Auto Configurator Utility for OS/2, help file
      AUTODRV.DOC  : Auto Configurator READ.ME file
      *.SCR        : Auto Configurator sample script files

      ATAMNT2.EXE  : ATA Mount Utility for OS/2
      ATAMNT2.HLP  : ATA Mount Utility for OS/2, help file
      OS2PCARD.DMD : Storage Driver for OS/2
      PCM2ATA.ADD  : Storage Driver for OS/2 (ATA)
      PCMSSDIF.SYS : Storage Driver for OS/2 (Interface)
      PCM2SRAM.SYS : Storage Driver for OS/2 (SRAM)
      FLSH2MTD.SYS : Storage Driver for OS/2 (FLASH MTD)
      PCM2FLSH.SYS : Storage Driver for OS/2 (FLASH)
      FCHECK2.EXE  : FLASH PC Card Low-Level check program for OS/2
      FFORMAT2.EXE : FLASH PC Card Low-Level format program for OS/2

      AHA152X.ADD  : Adaptec SCSI PCCard for OS/2
      FD16-700.ADD : Future Domain SCSI PCCard for OS/2

      TDKENAB.OS2  : TDK CardBus NetFlyer NDIS Driver
      TDKFLYR.OS2  : TDK CardBus NetFlyer Client Driver
      PROTOCOL.INI : Protocol file for TDK Netflyer CardBus Card

      *.SYM        : Device Driver Symbol Files


8.0    Restore
       -------
      If you wish to return your system to its original state (its state
      prior to PCCARD installation), you should follow the steps below.

      1) Copy all files in the backup directory to '\os2' directory on the
         boot drive.  The backup directory is a subdirectory of the
         PCCARD target directory for which you were prompted at install.
         The default target directory is '\thinkpad'. For example,

               'copy c:\thinkpad\backup\*.*  c:\os2'

         will restore all device drivers in the backup directory to the
         'c:\os2' directory.

      2) Rename the backup CONFIG.Sxx to CONFIG.SYS.

      3) Remove the PC Card Director object from your desktop by dragging it to
         the shredder or by deleting it using other methods.


9.0 Copyright and Trademark Information
    -----------------------------------

  The following terms are trademarks of International Business Machines
  Corporation in the United States and/or other countries:
          IBM
          OS/2
          Warp
          ThinkPad
  Other company, product, and service names may be trademarks or service
  marks of others.

  THE INFORMATION PROVIDED IN THIS README IS PROVIDED "AS IS" WITHOUT 
  WARRANTY OF ANY KIND.  IBM DISCLAIMS ALL WARRANTIES, WHETHER 
  EXPRESSED 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, 2001, 2004. All rights reserved.
  U.S. Government Users Restricted Rights -- Use, duplication or 
  disclosure restricted by GSA ADP Schedule Contract with IBM Corp.