OS/2 DOCKING SUPPORT FOR THE IBM THINKPAD DOCK II The initial release of OS/2 Docking Support provides basic warm-docking and hot-swapping support for the IBM ThinkPad 755CE, 755CSE, 755CD, 755CV, 755CDV, and 755CX computers that have the Dock II desktop docking station. This software package consists of 6 device drivers and a graphical user interface (GUI) for controlling docking operations. The Docking Support package is being distributed on various computer network bulletin boards and as part of the pre-installed OS/2 software on new IBM ThinkPad computers. This README file is formatted for viewing on your screen. You can: - Use the Table of Contents to help you locate specific topics. - Use the Find option in the Edit menu of the OS/2 System Editor to help you locate specific information. - Print the entire file. IMPORTANT PLEASE READ THE FOLLOWING TERMS AND CONDITIONS. YOUR USE OF THE OS/2 DOCKING SUPPORT FOR THE IBM DOCK II INDICATES YOUR ACCEPTANCE OF THE FOLLOWING TERMS AND CONDITIONS: o YOU MUST BE A LICENSEE OF OS/2. o YOU MAY MAKE COPIES OF THE OS/2 DOCKING SUPPORT FOR THE IBM DOCK II EQUAL TO THE NUMBER OF LICENSED COPIES OF OS/2 YOU POSSESS. o ALL OTHER TERMS AND CONDITIONS OF YOUR OS/2 LICENSE AGREEMENT APPLY TO THIS OS/2 DOCKING SUPPORT FOR THE IBM DOCK II; HOWEVER, THIS DOES NOT EXTEND ANY WARRANTY OUTLINED IN SUCH AGREEMENT. CONTENTS ________ 1.0 Supported Features 1.1 Warm-Docking Operations 1.2 Hot-Swapping Operations 1.3 Diskette Support 1.4 CD-ROM Support 1.5 SCSI Support 2.0 Installation Instructions 2.1 CID Installation 3.0 Compatibility 4.0 Functional Restrictions 5.0 Trademarks 1.0 SUPPORTED FEATURES 1.1 WARM-DOCKING OPERATIONS Supported IBM ThinkPad computers can be inserted into ("docked") or removed from ("undocked") the Dock II without being powered down or restarted. During docking operations the user can select either "pass-thru" or "full-dock" docking mode. The GUI distributed with this package includes detailed online help to describe user actions and options presented during docking and undocking operations. For information about mechanical docking and undocking procedures, refer to the IBM ThinkPad Dock II Users Guide (Part #84G9682). In pass-thru docking mode, the ThinkPad video, serial, parallel, keyboard, and mouse ports are connected to corresponding ports on the Dock II. If the Dock II has externally connected devices (keyboard, mouse, or display), the ThinkPad will use these devices in parallel with its own devices. While docked in pass-thru mode, the ThinkPad uses external power from the Dock II, and its internal battery is charged, if needed. In full-dock mode, the system performs all pass-thru functions, and also provides access to any recognized SCSI and PCMCIA peripherals installed in the Dock II. With this release of OS/2 Docking Support, any IDE devices installed in the Dock II, or any controllers installed in Dock II ISA slots, will be recognized only after a system cold start with the ThinkPad fully docked. 1.2 HOT-SWAPPING OPERATIONS With OS/2 Docking Support, the ThinkPad 755CD user can swap the under- keyboard CD-ROM drive for the under-keyboard diskette drive and attach an external diskette drive to the clam-shell adapter, without powering down or restarting the system. Configurations possible with hot-swapping are: Configuration: 755-CE 755-CSE 755-CD 1 diskette drive x x x 1 CD x 1 diskette drive, 1 CD x 2 diskette drives x x x 1.3 DISKETTE-DRIVE SUPPORT The DOC1FLPY.ADD driver has all of the CONFIG.SYS options currently documented for IBM1FLPY.ADD. In addition, it includes a new /FORCE:n parameter, which indicates that the driver will force (emulate) n number of diskette drives. The allowable values for the /FORCE parameter are 1 or 2. Also, the existing /F:x parameter must be specified in conjunction with the new /FORCE: parameter to define the drive capacity of the emulated diskette drives. The allowable values for the /F: parameter, when used with the /FORCE: parameter are 1.44MB or 2.88MB. (Note: These are the only sizes of IBM diskette drives supported by the ThinkPad.) In the following example, the CONFIG.SYS statement specifies that a single 1.44MB diskette drive is to be emulated when the drive is not physically present: BASEDEV=DOC1FLPY.ADD /A:0 /FORCE:1 /U:0 /F:1.44MB If /FORCE:2 is specified, two diskette drives (drives A and B) will be BASEDEV=DOC1FLPY.ADD /A:0 /FORCE:2 /U:0 /F:1.44MB /U:1 /F:2.88MB emulated, even though neither drive is physically present. Drive A will always be under the ThinkPad keyboard, and drive B will be treated as an external diskette drive attached to the clam-shell adapter. This means that if the CD-ROM is currently installed under the keyboard, all diskette- drive operations must be directed to drive B. Drive A operations will fail, and a device-not-ready message will be returned. 1.4 CD-ROM SUPPORT Two Drivers (DOC1S506.ADD and DOCIDECD.FLT) provide IDE CD-ROM support. These drivers support all of the CONFIG.SYS options currently documented for the standard IBM IDE device drivers: DOC1S506.ADD ->IBM1S506.ADD DOCIDECD.FLT ->IBMIDECD.FLT The DOCIDECD.FLT driver includes a new /F parameter. This parameter indicates that the filter driver must emulate the presence of any ATAPI devices supported by the DOC1S506.ADD driver, even when the hardware is not physically present. In addition, the DOC1S506.ADD driver's existing /A:x, /U:y, and /ATAPI parameters must be specified in conjunction with the new /F parameter of the DOCIDECD.FLT driver to define the ATAPI device's physical adapter number and unit number. In the following example, the CONFIG.SYS statements specify CD-ROM emulation for the ThinkPad 755CD: BASEDEV=DOC1S506.ADD /A:1 /U:0 /ATAPI BASEDEV=DOCIDECD.FLT /F Elements of the preceding CONFIG.SYS examples can be combined to form an example showing device swapping (diskette drive and CD-ROM drive) for the ThinkPad 755CD: BASEDEV=DOC1S506.ADD /A:1 /U:0 /ATAPI BASEDEV=DOCIDECD.FLT /F BASEDEV=DOC1FLPY.ADD /A:0 /FORCE:1 /U:0 /F:1.44MB 1.5 SCSI SUPPORT Two Drivers (DOCSCSI.DMD and DOC152X.ADD) provide SCSI support for the Adaptec AIC-6360 system board SCSI adapter. These drivers support all of the CONFIG.SYS options currently documented for the standard IBM SCSI device drivers: DOCSCSI.DMD -> OS2SCSI.DMD DOC152X.ADD -> AHA152X.ADD The DOC152X.ADD driver includes a new /F parameter. This parameter indicates that the adapter driver must emulate the presence of all SCSI devices for the adapter identified in the option string, even when the hardware is not physically present. In the following example, the CONFIG.SYS statements specify emulation of all 7 SCSI devices on the first SCSI adapter: BASEDEV=DOC152X.ADD /A:0 /F:0,1,2,3,4,5,6 BASEDEV=DOCSCSI.DMD 2.0 INSTALLATION INSTRUCTIONS To install: 1) Open a OS2 window or full screen 2) Go to the directory or diskette that contains the dock manager files 3) Type INSTALL and press Enter The Dock Manager Install Options screen appears. 4) Select the options you want and click the INSTALL button. The Dock Manager Install panel appears. 5) Click OK 6) Shutdown the system and restart for changes to take affect. 2.1 CID INSTALLATION 1) Open a OS2 window or full screen 2) Go to the directory or diskette that contains the dock manager files 3) Type INSTALL [/d /o /s /a /b] and press ENTER where: target drive letter is the drive that the target machine boots from /d - install Device Swapping Support /o - install DockII Support /s - install SCSI Device Support (also installs DockII support) /a - install Floppy Device Support for machines with only 'A' drive present (also installs DockII support) /b - install Floppy Device Support for machines with 'A' and 'B' drives present (also installs DockII support) For example, to install DockII Support and Floppy Device Support to the 'R' drive for a machine with only a single floppy drive, type the following: INSTALL R: /o /a 3.0 COMPATIBILITY OS/2 Docking Support is compatible with OS/2 Warp Version 3 and later versions of OS/2. This warm docking program only works on the IBM ThinkPad 755CE, 755CSE, 755CD, 755CV, 755CDV, and 755CX computers. 4.0 FUNCTIONAL RESTRICTIONS 1. Warm docking support requires your OS/2 system to be installed in a FAT partition. HPFS formatted data partitions are supported. 2. IDE devices in the Dock II are not supported after warm-docking operations. The ThinkPad must be fully docked, and a system cold start must be performed. 3. Currently, the system will recognize no more than 4 SCSI devices after a warm docking. 4. If disk partitions are removed or changed, or physical drives are removed, the FAUXDASD.FLT and FAUXREM.FLT device drivers must be returned to their initial, as-shipped states. The original versions of these files may be obtained from this package's distribution disk. Copy them to OS2\BOOT before restarting the system after removing or changing disk partitions. If disk drives are being removed, copy these files to OS2\BOOT before shutting down and removing the drives. 5. Dock II ISA slots are not recognized after a warm docking. 6. If you are unable to undock your ThinkPad while in the Full Dock mode, verify that the Hot Dock/Undock option is enabled. If it is enabled, save all open applications and shutdown and undock using the EJECT button. If it is disabled, select Hot Dock/Undock and click OK to enable. You should now be able to undock. 7. Multimedia for Presentation Manager (MMPM) does not currently respond to Advanced Power Management (APM) requests for suspend and resume. Undocking causes a system suspension, resulting in a loss of system sounds. Restarting the ThinkPad will restore system sounds on the undocked ThinkPad. Before doing a dock or undock operation, all audio and video applications must be closed and all system sounds must be completed. 8. Error messages may refer to files that have been renamed as shown below: IBM1FLPY.ADD -> DOC1FLPY.ADD IBM1S506.ADD -> DOC1S506.ADD IBMIDECD.FLT -> DOCIDECD.FLT AHA152X.ADD -> DOC152X.ADD OS2SCSI.ADD -> DOCSCSI.DMD 9. Currently, there is no keyboard sequence recognized by the GUI to cause the system to shift from pass-thru docking mode to full-dock mode. This operation requires a mouse. 5.0 TRADEMARKS The following terms are trademarks of the IBM Corporation in the United States or other countries: Dock II IBM OS/2 Presentation Manager ThinkPad Other company, product, and service names may be trademarks or service marks of others.