home *** CD-ROM | disk | FTP | other *** search
/ ftp.ib.com / 2003-04-09_ftp.ibm.com-os2.zip / os2ddpak_cur / pccardbr.exe / READ.ME < prev    next >
Text File  |  1996-12-18  |  19KB  |  422 lines
  1.  
  2. <<<<<<<<<<<<<<<  IBM PlayAtWill Installation Program  >>>>>>>>>>>>>>>>>>>>>
  3.  
  4.   Welcome to IBM PlayAtWill Installation Program. PlayAtWill is the advanced
  5.   utility software that enables the user to "Plug & Play" PC Cards
  6.   (previously known as PCMCIA).  This READ.ME contains the latest
  7.   information.  It also contains helpful hints.
  8.  
  9.  
  10.   CONTENTS
  11.   --------
  12.  
  13.  1.0   How to Install IBM PlayAtWill
  14.  
  15.  2.0   How to Run the IBM PlayAtWill Installation Program Utilities
  16.  
  17.  3.0   Parameter Definitions
  18.  
  19.  4.0   Hints
  20.  
  21.  5.0   Enhanced Features
  22.  
  23.  6.0   Files
  24.  
  25.  7.0   Restore
  26.  
  27.  8.0   Possible Problems
  28.  
  29.  
  30.  1.0   How to Install IBM PlayAtWill
  31.        -----------------------------
  32.  
  33.     - Start OS/2 3.0 or later.
  34.     - Start an "OS/2 Full Screen" or an "OS/2 Window".
  35.     - Insert the "IBM PlayAtWill Installation Program for OS/2" diskette
  36.       into the diskette drive.
  37.     - Type "A:\PCMINST2" and press ENTER.
  38.     - Follow the instruction on the screen.
  39.     - Restart the system after completing the installation.
  40.  
  41.  
  42.  2.0   How to Run the IBM PlayAtWill Installation Program Utilities
  43.        ------------------------------------------------------------
  44.  
  45.     The IBM PlayAtWill Installation Program Utilities for OS/2 are registered
  46.     as objects in the "IBM PlayAtWill Installation Program" folder. You can
  47.     see icons titled "IBM PlayAtWill Installation Program","ATA Mount
  48.     Utility","Auto Configurator Utility", and "Supported PCCards". To start
  49.     these utilities, click on an ICON.
  50.  
  51.  
  52.  3.0   Parameter Definitions
  53.        ---------------------
  54.  
  55.   3.1  Socket Services
  56.  
  57.        /C0=z   : These parameters define the IRQ level to be used by the
  58.        /C1=z     Socket Services driver. The new Card Services and Socket
  59.                  Services drivers for OS/2 do not use a hardware interrupt
  60.                  to notify the PCMCIA status change, so you do not need
  61.                  these parameters.
  62.  
  63.        /IG0=y  : This parameter defines a slot number, which Socket Services
  64.                  ignores. If you use the "Point enabler" supplied
  65.                  with a PC Card, you should take into consideration the
  66.                  coexistence with Socket Services.
  67.  
  68.                  For Example, "/IG0=1" defines that slot 1 is reserved for a
  69.                  "Point enabler" and Socket Services will ignore the slot.
  70.  
  71.        /RI0=x  : This parameter defines a slot number, where Socket Services
  72.                  disables the RI_OUT signal. If you are using a modem card
  73.                  with a ThinkPad computer, and you can't enable the "suspend"
  74.                  or "hibernation" function while the modem card is inserted,
  75.                  please try this parameter.
  76.  
  77.                  For Example, "/RI0=1" specifies slot 1.
  78.  
  79.        /D      : This parameter enables "Warm docking" from the
  80.                  view point of PCMCIA hardware. By adding this parameter,
  81.                  two additional PCMCIA slots are reserved for the docking
  82.                  station.
  83.  
  84.        /APOFF  : This parameter turns off the Auto-Power Mode. If the
  85.                  Auto-Power Mode is ON, a PC Card will be automatically
  86.                  turned ON by the hardware when it is inserted.
  87.                  The default for Auto-Power Mode is ON.
  88.  
  89.        /IO0=s  : This parameter defines the slot number, for which Socket
  90.                  Services will change the way the -IOCS16 signal is generated.
  91.                  By default, the -IOCS16 signal is generated based on the
  92.                  -IOIS16 signal from the PC Card. If this parameter is
  93.                  specified, the -IOCS16 signal is generated based on the
  94.                  I/O data size which is specified by the Client program.
  95.                  This option is needed for some cards which do not
  96.                  generate the -IOIS16 signal. You need to verify
  97.                  this information with PCMCIA card vendors.
  98.  
  99.                  For Example, "/IO0=1" specifies that the -IOCS16 signal
  100.                  for slot 1 is to be generated based on the I/O data
  101.                  size specified by the Client program.
  102.  
  103.  
  104.  
  105.  
  106.   3.2  Card Services
  107.  
  108.        /P      : In previous releases, this parameter disabled the hardware
  109.                  interrupt which was used by OS/2 Socket Services drivers to
  110.                  notify clients of a change in status.
  111.  
  112.                  Neither the new Card Services nor Socket Services drivers
  113.                  for OS/2 use a hardware interrupt to signal PCMCIA status
  114.                  changes. So this parameter is no longer needed.
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  4.0   Hints
  121.        -----
  122.  
  123.     - For OS/2 Warp 3.0, you can see current system resource information
  124.       with RMVIEW.EXE program. The RMVIEW.EXE is a standard OS/2 utility
  125.       program which is included in OS/2 Warp 3.0. To run this program,
  126.       type "RMVIEW" at the OS/2 command prompt and press ENTER. You can
  127.       see short help with "/?" option.
  128.  
  129.     - For OS/2 Warp 3.0, the RESERVE.SYS is used instead of the Resource
  130.       Map Utility(ICRMU01.SYS,RMUOS2AT.SYS). The RESERVE.SYS is a standard
  131.       OS/2 device driver which is included in OS/2 Warp 3.0.
  132.  
  133.       RESERVE.SYS: RESERVE.SYS is used in conjunction with the Resource
  134.       Manager in two separate scenarios:
  135.  
  136.       * If you are using a device driver that is not Resource Manager-aware
  137.         and you know the resources that the device uses, use RESERVE.SYS to
  138.         reserve those resources so the Resource Manager-aware drivers will
  139.         not have access to those resources.
  140.  
  141.       * If you have a piece of hardware that does not tolerate the examination
  142.         of its resources, reserve the resources so the Resource Manager-aware
  143.         drivers do not examine the hardware.
  144.  
  145.       To use RESERVE.SYS, place the following statement as the first line in
  146.       CONFIG.SYS:
  147.  
  148.         BASEDEV=RESERVE.SYS <arguments>
  149.  
  150.       Arguments:
  151.  
  152.             ┌───────────────────────────────────────┐
  153.             v                                       │
  154.          ├──┼── /IO:  ──┬───────────┬──┬─────────┬──┴──
  155.             ├── /P:   ──┴─── /DW:───┤  ├─ /EXC  ─┤
  156.             │                       │  ├─ /MUL  ─┤
  157.             ├── /MEM: ──────────────┤  └─ /SHA  ─┘
  158.             ├── /DMA: ──────────────┤
  159.             └── /IRQ: ──────────────┘
  160.  
  161.       ┌────────┬──────────┬───────────────┬─────────────────────────────────┐
  162.       │ Switch │ Format   │ Example       │ Description                     │
  163.       ├────────┼──────────┼───────────────┼─────────────────────────────────┤
  164.       │ /IO:   │ /IO:x,x  │ /IO:340,4     │ Reserve IO ports.               │
  165.       │        │          │               │ The first number is the base    │
  166.       │        │          │               │ port in HEX, and is followed by │
  167.       │        │          │               │ the length (number of ports) in │
  168.       │        │          │               │ HEX.                            │
  169.       ├────────┼──────────┼───────────────┼─────────────────────────────────┤
  170.       │ /P:    │ /P:x,x   │ /P:340,4      │ same as /IO:                    │
  171.       ├────────┼──────────┼───────────────┼─────────────────────────────────┤
  172.       │ /MEM:  │ /MEM:x,x │ /MEM:CA00,100 │ Reserve Memory.                 │
  173.       │        │          │               │ The first number is the base    │
  174.       │        │          │               │ memory address in HEX, with the │
  175.       │        │          │               │ assumption that the address is  │
  176.       │        │          │               │ XXXX:0, and is followed by the  │
  177.       │        │          │               │ length (number of address) in   │
  178.       │        │          │               │ HEX.                            │
  179.       ├────────┼──────────┼───────────────┼─────────────────────────────────┤
  180.       │ /DMA:  │ /DMA:x   │ /DMA:2        │ Reserve DMA Channel             │
  181.       │        │          │               │ The number is in decimal format.│
  182.       ├────────┼──────────┼───────────────┼─────────────────────────────────┤
  183.       │ /IRQ:  │ /IRQ:x   │ /IRQ:13       │ Reserve IRQ.                    │
  184.       │        │          │               │ The number is in decimal format.│
  185.       ├────────┼──────────┼───────────────┼─────────────────────────────────┤
  186.       │ /EXC   │ /EXC     │ /EXC          │ Exclusive resource attribute.   │
  187.       ├────────┼──────────┼───────────────┼─────────────────────────────────┤
  188.       │ /MUL   │ /MUL     │ /MUL          │ Multiplexed resource attribute. │
  189.       ├────────┼──────────┼───────────────┼─────────────────────────────────┤
  190.       │ /SHA   │ /SHA     │ /SHA          │ Shared resource attribute.      │
  191.       ├────────┼──────────┼───────────────┼─────────────────────────────────┤
  192.       │ /DW:   │ /DW:x    │ /DW:10        │ Decode width of IO address.     │
  193.       │        │          │               │ Valid numbers are 10 and 16.    │
  194.       │        │          │               │ Only valid with /IO: switch.    │
  195.       └────────┴──────────┴───────────────┴─────────────────────────────────┘
  196.  
  197.        More than one resource attribute per-resource entry is an error and
  198.        is not allowed. If no attribute or decode width is set, the default
  199.        is EXCLUSIVE and 16 respectively. For example, to reserve an IRQ 13
  200.        EXCLUSIVE, DMA 0 SHARED, MEMORY CA00:0 for 1000 hex-bytes shared,
  201.        IO ports 340 for 10 hex-ports EXCLUSIVE and with a decode width of 16,
  202.        and IO ports 300 for 64 hex-ports with a decode width of 10, the
  203.        following is specified:
  204.  
  205.        BASEDEV=RESERVE.SYS /IRQ:13 /DMA:0 /SHA /MEM:CA00,1000 /SHA /IO:340,10
  206.                            /IO:300,64 /DW:10
  207.  
  208.     - All the PC cards, which have been powered off in the utility, will
  209.       be powered on when you exit from the IBM PlayAtWill Installation
  210.       Program utility.
  211.  
  212.  
  213.   4.1  Storage PC Cards
  214.  
  215.     - Before using a brand-new FLASH PC Card, you have to initialize the
  216.       card with the FFORMAT2.EXE or FCHECK2.EXE
  217.       program.
  218.  
  219.     - If you see the following message :
  220.  
  221.           << Attention >>
  222.           This card isn't supported formally
  223.           It is possible that it doesn't work correctly
  224.  
  225.       while the FFORMAT2.EXE or FFORMAT2.EXE
  226.       program is running, the card will be formatted as if it has
  227.       256KB-erase-zone size and the write/erase logic of INTEL 28F020
  228.       or 28F010.
  229.  
  230.     - If you see the following message :
  231.  
  232.           The size of this card is too small for the card to be formatted
  233.  
  234.       while the FFORMAT2.EXE or FFORMAT2.EXE
  235.       program is running, the card can't be formatted because its size
  236.       is too small to accept the transfer unit.
  237.       (At least one transfer unit is required for FTL.)
  238.  
  239.     - You can't use the SRAM region of the IBM FLASH & SRAM combo card
  240.       on OS/2 even if you install PCM2SRAM.SYS (SRAM device driver).
  241.       The card appears to be a FLASH card if you install
  242.       FLSH2MTD.SYS (FLASH memory technology driver), PCM2FLSH.SYS
  243.       (FLASH device driver), or other drivers.
  244.  
  245.     - OS/2 Warp includes a flash memory card device driver that
  246.       can enable only IBM flash memory cards. The flash memory card device
  247.       driver in this IBM PlayAtWill Installation Program can't enable cards
  248.       formatted with the one in OS/2 Warp.
  249.  
  250.     - In case of formatting two or more Storage PC Cards, you have to run and
  251.       exit the FORMAT program for every card.
  252.       You must not format two or more Storage PC Cards from a single
  253.       invocation of FORMAT.
  254.  
  255.     - You can't use the DISKCOPY program for the Storage PC Cards drive.
  256.  
  257.     - If your PC has two or more PCMCIA slots, do not insert or remove a
  258.       storage PC Card in the slot while you are executing DOS commands,
  259.       such as FORMAT or COPY to a storage PC Card in another slot.
  260.  
  261.   4.2  Others
  262.  
  263.     - For the Auto Configurator driver and Utility, please refer to the
  264.       AUTODRV.DOC file for more detail.
  265.  
  266.     - For the PC Cards, please refer to the PCMCIA.CRD file for more
  267.       detail on the support level.
  268.  
  269.     - For the PC Cards, sample installation/configuration files (CONFIG.SYS,
  270.       AUTOEXEC.BAT, etc.) are available on your "IBM PlayAtWill
  271.       Installation Program for OS/2" diskette. Please refer to the
  272.       \SAMPLES directory on the diskette.
  273.  
  274.     - If your system has three or more PCMCIA slots, for example a
  275.       notebook computer with docking station which has PCMCIA slots, the
  276.       total number of PCMCIA slots which will be used for PC Cards
  277.       must be specified.  For example, if you have four PCMCIA slots:
  278.  
  279.         BASEDEV=PCM2ATA.ADD /S:4 /!DM /NOBEEP
  280.  
  281.     - If you use a Docking Station with your notebook computer, the adapter
  282.       cards or the devices in the docking station may use resources such as
  283.       I/O port, memory window, IRQ.
  284.       Exclude these resources from the usable area of the Card Services.
  285.       To exclude resources from the usable area, RESERVE.SYS can be used.
  286.       See  "4.0 For OS/2" (RESERVE.SYS) in
  287.       this document.
  288.  
  289.  
  290.     - If you have an Adaptec SCSI PCCard, find
  291.  
  292.                   'REM BASEDEV=AHA152X.ADD'
  293.  
  294.       in config.sys and change it to
  295.  
  296.                   'BASEDEV=AHA152X.ADD'.
  297.  
  298.     - If you have a Future Domain SCSI PCCard, find
  299.  
  300.                   'REM BASEDEV=FD16-700.ADD'
  301.  
  302.       in config.sys and change it to
  303.  
  304.                   'BASEDEV=FD16-700.ADD'.
  305.  
  306.     - If you use a ThinkPad 760 E, ED, EL, or ELD without any docking/port
  307.       replicator support place a REM in front of IBM2SS04.SYS in CONFIG.SYS
  308.  
  309.                   'REM BASEDEV=IBM2SS04.SYS
  310.  
  311.     - If you use a ThinkPad 760 E, ED, EL, or ELD with Dock III (SelectaDock)
  312.       REM in front of IBM2SS04.SYS in CONFIG.SYS and add /D option to
  313.       IBM2SS14.SYS
  314.  
  315.                   'REM BASEDEV=IBM2SS04.SYS'
  316.                   'BASEDEV=IBM2SS14.SYS /D'
  317.  
  318.     - If you use a ThinkPad 760 E, ED, EL, or ELD with Dock II add /D to
  319.       IBM2SS04.SYS.
  320.  
  321.                   'BASEDEV=IBM2SS04.SYS /D'
  322.  
  323.  
  324.  5.0   Enhanced Features
  325.        -----------------
  326.  
  327.     - New Storage PC Card Drivers which support ATA, SRAM and FLASH PC Cards.
  328.     - New Auto Configurator which can be customized easily to support a
  329.       variety of I/O PC Cards.
  330.     - New utility programs:
  331.         - ATA Mount Utility which enables multiple partitions on a ATA PC Card.
  332.         - Auto Configurator Utility which helps users with customization.
  333.     - New IBM PlayAtWill Installation Program Utility which provides greater usability:
  334.         - Power control for the PC Cards (ThinkPad Only).
  335.         - Information on errors, PC Card resources, System resources, and
  336.           more.
  337.     - New sample installation/configuration files.
  338.     - New problem determination scenario in the manual.
  339.     - New Virtual Card Services driver which supports MVDM environments.
  340.     - CSSCSI.SYS client driver is no longer needed.  This function has been
  341.       implemented in FD16-700.ADD.
  342.  
  343.  
  344.  6.0   Files
  345.        -----
  346.  
  347.       READ.ME      : This file
  348.       PCMINST2.DAT : Installation program for OS/2, data file
  349.       PCMINST2.EXE : Installation program for OS/2
  350.       PCMCIA.CRD   : PC Card Support List
  351.  
  352.       EZPLAY2.DLL  : IBM PlayAtWill Installation Program Utility for OS/2
  353.       EZPLAY2.HLP  : IBM PlayAtWill Installation Program Utility for OS/2, help file
  354.       EZP2MRI.DLL  : IBM PlayAtWill Installation Program Utility for OS/2, text portion
  355.       PCMCIA.SYS   : Card Services driver for OS/2
  356.       IBM2SSxx.SYS : Socket Services driver for OS/2
  357.       SS2PCIC1.SYS : Socket Services driver for PCIC controller
  358.       SS2TCIC1.SYS : Socket Services driver for TCIC controller
  359.       VPCMCIA.SYS  : Virtual Card Services driver for OS/2
  360.       $ICPMOS2.SYS : PCMCIA Power Management Support driver for OS/2 (ThinkPad Only)
  361.       PAWFLDR.ICO  : IBM PlayAtWill Installation Program Folder ICON file
  362.       LOGO_1.ICO   : PC Card Logo
  363.  
  364.       AUTODRV2.SYS : Auto Configurator for OS/2
  365.       AUTODRV2.SCR : Auto Configurator for OS/2, script file
  366.       AUTOUTL2.EXE : Auto Configurator Utility for OS/2
  367.       AUTODRV2.SEL : Auto Configurator Utility for OS/2, data file
  368.       AUTOUTL2.HLP : Auto Configurator Utility for OS/2, help file
  369.       AUTODRV.DOC  : Auto Configurator READ.ME file
  370.       *.SCR        : Auto Configurator sample script files
  371.  
  372.       ATAMNT2.EXE  : ATA Mount Utility for OS/2
  373.       ATAMNT2.HLP  : ATA Mount Utility for OS/2, help file
  374.       OS2PCARD.DMD : Storage Driver for OS/2
  375.       PCM2ATA.ADD  : Storage Driver for OS/2 (ATA)
  376.       PCMSSDIF.SYS : Storage Driver for OS/2 (Interface)
  377.       PCM2SRAM.SYS : Storage Driver for OS/2 (SRAM)
  378.       FLSH2MTD.SYS : Storage Driver for OS/2 (FLASH MTD)
  379.       PCM2FLSH.SYS : Storage Driver for OS/2 (FLASH)
  380.       FCHECK2.EXE  : FLASH PC Card Low-Level check program for OS/2
  381.       FFORMAT2.EXE : FLASH PC Card Low-Level format program for OS/2
  382.  
  383.       AHA152X.ADD  : Adaptec SCSI PCCard Driver for OS/2
  384.       FD16-700.ADD : Future Domain SCSI PCCard Driver for OS/2
  385.  
  386.  
  387.  7.0   Restore
  388.        -------
  389.       If you wish to return your system to its original state (its state
  390.       prior to PCCARD installation), you should follow the steps below.
  391.  
  392.       1) Copy all files in the backup directory to '\OS2' directory on the
  393.          boot drive.  The backup directory is a subdirectory of the
  394.          PCCARD target directory for which you were prompted at install.
  395.          For IBM ThinkPad, the default target directory is '\THINKPAD'.
  396.          For all other laptops, the default target directory is '\EZPLAY'.
  397.          For example if boot drive is c then
  398.  
  399.                'copy c:\EZPLAY\BACKUP\*.*  c:\OS2'
  400.  
  401.          will restore all device drivers in the backup directory to the
  402.          'c:\OS2' directory.
  403.  
  404.       2) Rename the backup CONFIG.Sxx to CONFIG.SYS.
  405.  
  406.       3) Remove the PlayAtWill object from your desktop by dragging it to
  407.          the shredder or by deleting it using other methods.
  408.  
  409.  
  410.  8.0   Possible Problems
  411.        -----------------
  412.       1)  The IBM ThinkPad 760 ED,ELD,EL,and E has a problem with
  413.       some SRAM cards.  If you format the SRAM card on the top slot you
  414.       can not read this card from the bottom slot.  It is recommended that
  415.       you always format SRAM on the bottom slot.
  416.  
  417.       2)  If you are adding Dock Manager code.  On some Thinkpads when you
  418.       insert a flash card the machine will hang.  To fix the problem you
  419.       need to take the "/D" off of the socket service driver or remove
  420.       Dock Manager.
  421.  
  422.