IBM OS/2 WARP PCMCIA DRIVERS FOR NON-IBM HARDWARE 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 WARP 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 OS2PCM30.ZIP. ********************************************************************* * * * 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 ------------ --------- -------- ------------------------------------ SSVLSI.SYS 6434 11-10-94 AST Ascentia 900N SSDD README.txt 30446 10-31-94 This File 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 OS/2 Warp, but did not install PCMCIA support, perform the following: . Open the OS/2 System folder, then open System Setup folder within it. . From the System Setup folder, select Selective Install. . From the Selective Install window, select PCMCIA Support. This will open a menu of system names. From this list, select Ascentia 800N. Then click on 'Ok' and perform the installation of the PCMCIA support. Be sure to have your OS/2 Warp installation diskettes or CD-ROM available. b. Now that you have installed PCMCIA support on OS/2 Warp, you must change the Socket Service device driver. This will install the appropriate driver for the Ascentia 900N. Type the following command: copy a:\SSVLSI.SYS c:\os2 NOTE: This assumes that the driver package was on a diskette in the a: drive, and that OS/2 is booted from the C: drive or partition. If the install materials are in another location, or if OS/2 Warp is installed on a 2.3 CONFIG.SYS statements The entry in the CONFIG.SYS file for the Socket Service driver must be changed to reflect the new driver's name. Perform the following steps: a. Locate the BASEDEV statement added by the PCMCIA Installation process above. If the Ascentia 800N was chosen, the statement will be: BASEDEV=IBM2AST1.SYS /s0=1 b. Change the statement to read: BASEDEV=SSVLSI.SYS with no other parameters on the statement. c. After rebooting, the PCMCIA support will be available. ******** **** 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 . . . BASEDEV=PCMCIA.SYS BASEDEV=SOCKET.SYS /s0=n {Machine specific Socket Service } DEVICE=C:\OS2\ICMEMMTD.SYS {PCMCIA FLASH Device Driver} DEVICE=C:\OS2\ICMEMCDD.SYS 2,s {PCMCIA FLASH Device Driver} DEVICE=C:\OS2\AUTODRV2.SYS C:\OS2\AUTODRV2.INI {Auto Configuration Driver} DEVICE=C:\OS2\MDOS\VPCMCIA.SYS 2.4 Parameters for SOCKET SERVICES NOTE: There are no optional parameters for the Socket driver for the AST Ascentia 900N driver (SSVLSI.SYS). 2.5 RESOURCE MAP UTILITY Unlike in OS/2 2.1, the are no longer system-dependent resource map utilities installed in the OS/2 Warp PCMCIA support. 2.6 PCMCIA ATA DEVICE DRIVER The PCM2ATA.SYS device driver is a client OS/2 Device Driver for PCMCIA ATA devices. It is installed automatically, as a part of the OS/2 Warp PCMCIA support. 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.7 Parameters for IBM PCMCIA Flash Memory devices The PCMCIA Flash memory support is also a standard part or the OS/2 Warp PCMCIA support. Flash memory is used for saving files that you do not want to modify. You may treat Flash memory like a CD-ROM with the exception that you can write to it once. The Flash memory card can be erased by formatting it using the ICMEMFMT.EXE utility. Once it has been reformatted, the Flash memory card can be written to. The following are limitations imposed when using FLASH memory: o After a file is copied, the date and time might not be the original created time or date of the file. o No subdirectory is allowed. o After a label is created, it cannot be re-created. o A file cannot be erased after it has been written until the FLASH card is formatted. o After a file has been created, its attribute is set to Read-only. o Any file associated with extended attributes will not be able to copy or create in the FLASH memory directly. This is because the extended attribute file will be updated in the FLASH memory every time the file is modified. o Multiple threads writing to the same FLASH memory are not supported. Multiple reads from the FLASH memory FAT file system can be performed. o The following is list of commands known to be failed with the FAT FLASH file system. BACKUP, RECOVER, DISKCOMP, DISKCOPY, FORMAT, .... etc. _____________________________________________________________________ ***** IBM PCMCIA FLASH CARDS SUPPORTED UNDER OS/2 2.X and Warp ***** _____________________________________________________________________ Note: These cards must be formatted with the ICMEMFMT utility before use. SRAM Cards: =========== 256K SRAM 512K SRAM 1MB SRAM 2MB SRAM FLASH Cards: ============ 1MB FLASH 2MB FLASH 4MB FLASH COMBO Cards: ============ 1/2MB FLASH/ 1/2MB SRAM 1MB FLASH/ 1/2MB SRAM 1MB FLASH/ 1MB SRAM 2MB FLASH/ 2MB SRAM ________________________________________________________________ *********************** O P T I O N S ********************** ________________________________________________________________ The following notation illustrates the valid parameters supported by ICMEMCDD.SYS: icmemcdd_parameters = number_of_slots, memory_region_supported number_of_slots 1 or 2 memory_region_supported 'S' for single and 'D' for dual memory Note: Parameters are separated by a comma ','. The number of slots is the number of PCMCIA slots for inserting an IBM PCMCIA Memory Cards. Its value ranges from 1 to 8. If you have two slots the value should be 2. ICMEMCDD also supports a single or dual-memory region card. The latter is used for the IBM COMBO card, which has FLASH memory in its first region and SRAM memory in its second region. After ICMEMCDD has been installed, each slot will be assigned to a drive. In the case of dual-memory support, each slot will be assigned two drives. For instance, assume the available drive starts at letter 'D'. o If you enter DEVICE=ICMEMCDD.SYS 2,S in the CONFIG.SYS file, the following is the result: slot 1 => D: slot 2 => E: o If you enter DEVICE=ICMEMCDD.SYS 2,D in the CONFIG.SYS, the following is the result: slot 1 Reg 1 => D: slot 1 Reg 2 => E: slot 2 Reg 1 => F: slot 2 Reg 2 => G: The default parameter is 1 for number of slots and single for memory region supported. The maximum supported drive is 16 (8 PCMCIA slots with dual memory regions). If a COMBO card is inserted into a slot that has a drive assigned to it, only the first memory region will be used and its second memory will be disabled. If a single memory region card such as the FLASH or SRAM card is inserted into a slot that has two drives assigned to it, the kernel will return a "Drive is not ready" error to the user if the second drive is accessed. In other words, the second drive will not be accessible. 2.8 What about "extra" drives created? The installation utility will install the PCMCIA ATA and the IBM PCMCIA Flash Super Client device drivers 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 rem DEVICE=C:\OS2\ICMEMMTD.SYS rem DEVICE=C:\OS2\ICMEMCDD.SYS 2,s 3.0 Other Equipment Manufacturer Hardware (OEM) Support Only the Personal Computers listed in this section 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 use 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 Ascentia 900N VLSI 12/94 *****************************************************************************