IBM OS/2 PCMCIA DRIVERS FOR IBM AND NON-IBM HARDWARE (INCLUDES PCMCIA CONFIGURATION MANAGER) Contents Chapter 1. License Chapter 2. Files and Installation (Includes Supported Hardware) 2.1 Syntax Notation 2.2 Installation Instructions 2.3 CONFIG.SYS setting 2.4 Parameters for SOCKET SERVICES 2.5 Parameters for RESOURCE MAP UTILITY (RMU) 2.6 Parameters for PCMCIA ATA DEVICE DRIVER 2.7 Parameters for IBM PCMCIA Flash Memory devices 2.8 What about "extra" drives created? 3.0 Other Equipment Manufacturer Hardware Support *************************************************************************** Chapter 1. License ___________________ IBM Socket Services Driver Package for OS/2 The IBM OS/2 Socket Services Device Driver packages are available on all sponsored IBM BBS's and CompuServe. All the programs are stored and listed in OS2PCM.ZIP and OS2P21.ZIP files. ********************************************************************* * * * NOTICE * * * * You accept these programs with the understanding that * * the IBM Corporation makes no representations or warranties * * as to the suitability of these programs for your particular * * purpose, and that to the extent you use, you do so your own risk. * * In no event will the IBM Corporation be liable for any damages, * * whether consequential, incidental, or special, arising out of * * the use of or inability to use the programs provided. * * Please read the LICENSE which follows to determine if you want * * to use these programs. * * * * Copyright the IBM Corporation, 1994. All rights reserved. * * * * DO NOT POST MODIFIED VERSIONS OF THESE PROGRAMS FOR PUBLIC ACCESS * ********************************************************************* IBM License Agreement for OS/2 Socket Services Device Driver ----------------------------------------------------------------- IF YOU DOWNLOAD OR USE THIS PROGRAM YOU AGREE TO THESE TERMS. International Business Machines Corporation grants you a license to use the Program only in the country where you acquired it. The Program is copyrighted and licensed (not sold). We do not transfer title to the Program to you. You obtain no rights other than those granted you under this license. Under this license, you may: 1. use the Program on one or more machines at a time; 2. make copies of the Program for use or backup purposes within your Enterprise; 3. make copies of the original file you downloaded and distribute it, provided that you transfer a copy of this license to the other party. The other party agrees to these terms by its first use of the Program. You must reproduce the copyright notice and any other legend of ownership on each copy or partial copy, of the Program. You may NOT: 1. sublicense, rent, lease, or assign the Program; and 2. reverse assemble, reverse compile, or otherwise translate the Program. We do not warrant that the Program is free from claims by a third party of copyright, patent, trademark, trade secret, or any other intellectual property infringement. Under no circumstances are we liable for any of the following: 1. third-party claims against you for losses or damages; 2. loss of, or damage to, your records or data; or 3. economic consequential damages (including lost profits or savings) or incidental damages, even if we are informed of their possibility. Some jurisdictions do not allow these limitations or exclusions, so they may not apply to you. We do not warrant uninterrupted or error free operation of the Program. We have no obligation to provide service, defect correction, or any maintenance for the Program. We have no obligation to supply any Program updates or enhancements to you even if such are or later become available. IF YOU DOWNLOAD OR USE THIS PROGRAM YOU AGREE TO THESE TERMS. THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply to you. You may terminate this license at any time. We may terminate this license if you fail to comply with any of its terms. In either event, you must destroy all your copies of the Program. You are responsible for the payment of any taxes resulting from this license. You may not sell, transfer, assign, or subcontract any of your rights or obligations under this license. Any attempt to do so is void. Neither of us may bring a legal action more than two years after the cause of action arose. If you acquired the Program in the United States, this license is governed by the laws of the State of New York. If you acquired the Program in Canada, this license is governed by the laws of the Province of Ontario. Otherwise, this license is governed by the laws of the country in which you acquired the Program. 10/94 --------------------------------------------------------------------------- *************************************************************************** Chapter 2. Files and Installation In Package OS2PCM2.ZIP __________________________________ FILES: ------ DD = Device Driver RMU = Resource Map Utility SSDD = Socket Service Device Driver File Name File Size Date Description ------------ --------- -------- ------------------------------------ AST2RMU1.SYS 7187 06-17-94 AST Bravo/AST PowerExec RMU AUTODRV2.INI 2493 04-26-94 PCMCIA Device Description File AUTODRV2.SYS 10862 06-17-94 Connection Mgr Configuration DD COM.SYS 25544 05-24-94 OS/2 COM.SYS Device Driver IBM2AST1.SYS 10577 06-17-94 AST Bravo/AST PowerExec SSDD INSTALL.EXE 52767 10-28-94 OS/2 2.1 Installation Utility PCM2ATA.ADD 22534 06-23-94 IBM ATA PCMCIA DD PCMCIA.SYS 36203 06-17-94 OS/2 Card Services DD PCMCIA.TBL 1094 10-31-94 Beta PCMCIA Intallation Table README.txt 30446 10-31-94 This File SSVLSI.SYS 6434 11-10-94 AST Ascentia 900N SSDD VPCMCIA.SYS 1120 05-24-94 OS/2 Virtual Card Services DD WPCMPNP.DLL 160793 06-24-94 Configuration Manager Object WPCMPNP.HLP 23255 06-24-94 Configuration Manager Help INSTALLATION: -------------- 2.1 Syntax Notation :- disk drive and directory A "drv" is a valid disk drive letter ended with a colon ":". A "dir" is a valid directory path in your system <> :- means optional | :- means either left or right but not both 2.2 Installation Instructions a. If you have previously installed the EZPLAY or the PlayAtWill application, you must first delete the object from the workplace shell, shutdown and reboot the operating system. This is a problem which is currently being addressed. b. Change your working directory to the directory where the files have been unpacked. This utility will install from diskette or the hard disk. c. Enter INSTALL and press the enter key. d. Select the system to install for from the list. The installation process takes about 30 - 60 seconds to complete. You will be notified when the installation process has completed. You will then need to shutdown and reboot the OS/2 operating system to complete the installation of the drivers. e. A Status log (named PCMINST2.LOG) is created in the root directory of the install drive. You can review this log for errors. f. All device drivers and the CONFIG.SYS will be saved as NAME.xxx where 'NAME' is either the name of the CONFIG.SYS file or the device driver and 'xxx' is a number beginning with '001'. If there is not enough space to make a backup, the install process may fail. WARNING: The install utility does not check to see that enough disk space is available before proceeding. 2.3 CONFIG.SYS statements The following is an example of the general ordering of the CONFIG.SYS file. While your CONFIG.SYS file may not be identical, the following dependencies must be maintained: a. COM.SYS always comes after MOUSE.SYS. No parameters should be passed passed to the COM.SYS device driver. b. AUTODRV2.SYS must always follow the COM.SYS device driver. c. The SOCKET SERVICE and RESOURCE MAP UTILITY drivers are usually located at the end of the CONFIG.SYS file. The RESOURCE MAP UTILITY precedes the SOCKET SERVICE. ******** **** C O N F I G . S Y S E X A M P L E **** ******** ================================== IFS=C:\OS2\HPFS.IFS /CACHE:64 /CRECL:4 PROTSHELL=C:\OS2\PMSHELL.EXE SET USER_INI=C:\OS2\OS2.INI SET SYSTEM_INI=C:\OS2\OS2SYS.INI SET OS2_SHELL=C:\OS2\CMD.EXE SET AUTOSTART=PROGRAMS,TASKLIST,FOLDERS,CONNECTIONS SET RUNWORKPLACE=C:\OS2\PMSHELL.EXE SET COMSPEC=C:\OS2\CMD.EXE . . . DEVICE=C:\OS2\APM.SYS DEVICE=C:\OS2\MDOS\VAPM.SYS DEVICE=C:\OS2\POINTDD.SYS DEVICE=C:\OS2\MOUSE.SYS DEVICE=C:\OS2\COM.SYS {Serial Driver for OS/2 2.1} DEVICE=C:\OS2\MDOS\VCOM.SYS CODEPAGE=437,850 DEVINFO=KBD,US,C:\OS2\KEYBOARD.DCP . . . REM ************* P C M C I A S E C T I O N ************** BASEDEV=PCMCIA.SYS BASEDEV=RMU.SYS {Machine Specific Resource Map Utility} BASEDEV=SOCKET.SYS /s0=n {Machine specific Socket Service } BASEDEV=PCM2ATA.ADD {PCMCIA ATA Device Driver} DEVICE=C:\OS2\AUTODRV2.SYS C:\OS2\AUTODRV2.INI {Auto Configuration Driver} DEVICE=C:\OS2\MDOS\VPCMCIA.SYS REM ********* E N D P C M C I A S E C T I O N ********* 2.4 Parameters for SOCKET SERVICES NOTE: There are no optional parameters for the Socket driver for the AST Ascentia 900N driver (SSVLSI.SYS). The following parameters apply to all other drivers. BASEDEV=\socket.sys /S0=number_of_slots NOTE: '/S0=' and '/C0' is the number zero(0) and not the letter (O). The following parameters will automatically be provided for any computer listed in the install list. This information is provided to allow users to experiment with computers which are not listed in the compatibility list. With the exception of the number_of_slots parameter, all other parameters are optional. socket.sys : The specific OS/2 socket driver for the notebook computer. number_of_slots : 1 | 2 | 3 | 4 Specifies number of PCMCIA socket(slots) for the system. ________________________________________________________________ *********************** O P T I O N S ********************** ________________________________________________________________ status_change_irq : 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 |13 |14 |15 Specifies interrupt level for the PCMCIA controller status change, such as card insertion or removal. The default value interrupt level is 15. If you are using your notebook in a docking station, you may have interrupt (IRQ) conflicts with devices such as CD-ROM drives, LAN or multimedia adapters. This switch will allow you alter the IRQ used by the Socket Controller Chip. /N:IRQ0 : No-Check IRQ-0 Value at SetAdapter\SetSocket Functions. /IRQH : Select IRQ Trigger Level. (AT-Bus system is set to be /IRQL IRQ-High as default) /APOFF : Set Auto-Power Mode to be off. Auto-Power Mode provides the PC-Card Power automatically On\Off by Hardware. (Default:Auto-Power Mode is off) /PH : Change return-code from BAD SOCKET to BUSY when Client access the specified socket which is for the Boot-Socket or Not-Accessible Socket. /IO0= : nnnn /IO1= : nnnn Socket Number List of Adapter n. Adapter number 0 through 1. /IO0=12 :Socket 1 & 2 are changed on Adapter 0. /IO0=21 :Same as \MEM0=12. /IO1=124 :Socket 1 & 2 & 4 are changed on Adapter 1. Change IOCS16 Control-Line Connection from PC-Card itself to PC-Card Controller Chip. This option will be needed for some cards which do not generate IOCS16- signal. Customers will need to verify this information with their computer / PCMCIA card vendors. /MEM0= : nnnn /MEM1= : nnnn Socket Number List of Adapter n. Adapter number 0 through 1. /MEM0=12 :Socket 1 & 2 are changed on Adapter 0. /MEM0=21 :Same as \MEM0=12. /MEM1=124 :Socket 1 & 2 & 4 are changed on Adapter 1. Change MEMCS16-Line generated from A23-A12 to A23-A17. /RI0= : nnnn /RI1= : nnnn Socket Number List of Adapter n. Adapter number 0 through 1. /RI0=12 :Socket 1 & 2 are changed on Adapter 0. /RI0=21 :Same as \MEM0=12. /RI1=124 :Socket 1 & 2 & 4 are changed on Adapter 1. Change RI-Signal (Ring Indicator) from the I\O Card to be mapped STSCHG Line in the system. (For ExCA V1.50 Requirement) /IG0= : nnnn /IG1= : nnnn Socket Number List of Adapter n. Adapter number 0 through 1. /IG0=12 :Socket 1 & 2 are changed on Adapter 0. /IG0=21 :Same as \MEM0=12. /IG1=124 :Socket 1 & 2 & 4 are changed on Adapter 1. Ignore the specified socket(s). For this option, socket services does not access the physical socket(s). This option is for some point-enabler software, but point-enabler software is not guaranteed to work perfectly under running the socket services. /NC0= : nnnn /NC1= : nnnn Socket Number List of Adapter n. Adapter number 0 through 1. /NC0=12 :Socket 1 & 2 are changed on Adapter 0. /NC0=21 :Same as \MEM0=12. /NC1=124 :Socket 1 & 2 & 4 are changed on Adapter 1. Treat specified socket on Adapter to be considered not to be connected in the system. /DEBUG : Display PC-Card Controller Information. /H : for PS2\E System /G : for PS55\E System /TP710T : for ThinkPad 710T System /TP730T : for ThinkPad 730T System Set socket-services environment for specified system. These options are available for IBM2SS01.SYS. 2.5 RESOURCE MAP UTILITY A special purpose device driver created to provide card services with a system specific resource map detailing the resources in use and the resources available at system IPL. The following parameters will automatically be provided for any computer listed in the install list. This information is provided to allow users to experiment with computers which are not listed in the compatibility list. All of these parameters are optional. ________________________________________________________________ *********************** O P T I O N S ********************** ________________________________________________________________ /IX= : Interrupt level currently in use by system or other devices. Format : /IX=1,2,3...... /PX= : IO port currently in use by system or other devices. Format : /PX=100-3FF,400-407..... Hex value, range is from 0000 through FFFF. Upper case, lower case can be specified. /MX= : Memory space currently in use by system or other devices. Format : /MX=C000-CFFF,D800-D8FF...... Hex value, range is from C000 through DFFF. Value represent an address in 4K byte blocks. Upper case, lower case can be specified. /MA= : Memory space available for PCMCIA subsystem. Format :/MA=C000-DFFF........ Hex value, range is from C000 through DFFF. Value represent an address in 4K byte blocks. Upper case, lower case can be specified. Note: The values which are specified in /IX, /PX, or /MX parameters will be registered to Card Services as EXCLUSIVE USE. 2.6 PCMCIA ATA DEVICE DRIVER The PCM2ATA.SYS device driver is a client OS/2 Device Driver for PCMCIA ATA devices. The following are some parameters which may be necessary for proper operation. ________________________________________________________________ *********************** O P T I O N S ********************** ________________________________________________________________ /S:n : The number of sockets (Default is 2). /I:n : Socket number to be ignored (1 origin). The ignored socket is not assigned drive letter. All CARD events for the ignored socket are ignored in the Call Back Handler of PCM2ATA.ADD. This switch is useful for the socket which may always be used for communication PCMCIA cards or for the socket which is always occupied by Type-3 PCMCIA cards. /B : There is a PCMCIA ATA device as used IDE harddisk. This switch must be required when OS\2 is booted up from PCMCIA ATA device itself. This switch is only valid if the computer's BIOS supports booting from a PCMCIA ATA device. Users will have to check with their computer manufacturers to inquire about support for this function. /NOBEEP : No beep is made when PCMCIA ATA device is inserted and is recognized. The default is making a beep sound. /STBTIME : nn Specifies the value in minute that ATA cards will go to standby mode. (Default is 0; maximum value is 21 minutes). If a value bigger than 21 is specified, this option is ignored and set it to default. /EXIRQ : n Do Not use this IRQ level number. IRQ level number specified by this switch is excluded when PCM2ATA.ADD requests IRQ level number for CardService and OS\2. 2.8 What about "extra" drives created? The installation utility will install the PCMCIA ATA device driver as the default. This will create extra removable media icons in the DRIVES folder. This may also interfere with drive letters used when connect to a Local Area Network (LAN). If the user has no plans to use PCMCIA ATA or Flash devices, the user can edit the CONFIG.SYS file and REMark the following lines as demonstrated below: rem BASEDEV=PCM2ATA.ADD 3.0 Other Equipment Manufacturer Hardware (OEM) Support Only the Personal Computers listed in the install utility have been tested by IBM. We are providing the Socket chip sets used in the hardware supported by these drivers in case you have OEM hardware not listed in the installation utility. Please note that even though an OEM may uses the same chip sets, different revisions have been found to perform differently. We make the following information available to assist customers in locating the closest match for their OEM system but the IBM Corporation makes no representations or warranties as to the * suitability of these programs for your particular purpose, and that to the extent you use, you do so your own risk. In no event will the IBM Corporation be liable for any damages, whether consequential, incidental, or special, arising out of the use of or inability to use the programs provided. MANUFACTURER CHIP SET ======================== =============================== AST Bravo/AST Powerexec Intel AST Ascentia 900N VLSI 12/94 *****************************************************************************