USBMOUSE README

October 15, 2001

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

This README contains information
for the Universal Serial Bus (USB) Mouse Device Driver Support for
OS/2 Warp 3,
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.


CONTENTS
________

1.0  Introduction
2.0   USB-Mouse Support
	2.1  USB-Mouse Installation
	2.2  Using USB Mouse with the OS/2 Installation or Ulitity Diskettes
		2.2.1  Boot Diskettes Modifications
		2.2.2  Additonal Diskette 1 Modifications
	2.3  USB-Mouse Driver Additional Parameters
	2.4  USB-Mouse Un-Install Instructions
	2.5  List of Tested USB-Mice
	2.6  Requirements
3.0  Copyright and Trademark Information


1.0  Introduction
_________________

This USBMOUSE.EXE driver package provides you with IBM's most current support
for Universal Serial Bus (USB) mouse devices on the OS/2 Operating System.

1.1  The USBMOUSE.EXE file that you received contains the following 5 USB
     files in a self-extracting compressed format.

        -  USBMOUSE.TXT  This file that you are reading
        -  USBMOUSE.DDP  Device driver profile file
        -  USBMOUSE.SYS  USB Mouse Driver
	-  MOUSE.SYS     Mouse Driver with USB support
        -  TSTUSBC.EXE   Tests USB Stack


2.0  USB-Mouse Support
______________________

The USB Base Stack package (USBBASIC) is a pre-requisite for
USB Mouse Support. Please install it first.

2.1  USB-Mouse Installation Instructions
========================================

2.1.1	To use these USB driver files, you must expand the USBMOUSE.EXE
	file into its 5 component files by
 		(a.) opening an OS/2 window and
        	(b.) typing USBMOUSE at the OS/2 command prompt.
	Once the USBMOUSE.EXE file is expanded, please continue with the
        USB Installation Instructions.

2.1.2	At the OS/2 command prompt, type DDINSTAL. This command will open
	Device Driver Installation dialog.

2.1.3	Change Source directory to current (where 5 component files reside)
	by pressing 'Change..." button.

2.1.4	Press "Install..." button to perform actual installation and "Exit"
	button installation utility.

	If USBBASIC stack was not installed on the system you will see the message
	"The file, TSTUSBC.EXE, returned a non-zero return code.This DDP file
	did not run." You have to install USBBASIC before installing USBMOUSE.EXE.

2.1.5	This completes the installation procedure. You can install
	any other USB device drivers and after that you must
	REBOOT the system.


2.2 Using USB Mouse with the OS/2 Installation or Ulitity Diskettes
===================================================================

The USB Stack must be added to the Installation or Utility diskettes
first. See the USBBASIC package for details.

2.2.1 Boot Diskettes Modifications
----------------------------------

Add the following statement to the CONFIG.SYS file
on Diskette 1 after the string BASEDEV=USBHID.SYS

    DEVICE=\USBMOUSE.SYS

Copy the following USB Device Driver to Diskette 2:

    USB Mouse Driver (USBMOUSE.SYS)

Copy the following Device Driver to Diskette 1:

    Mouse Driver (MOUSE.SYS)


2.3 USB-Mouse Driver Additional Parameters
==========================================

DEVICE=drive:\OS2\BOOT\USBMOUSE.SYS

       Where drive: is the drive letter of the OS/2 boot partition on your
       system.

PARAMETER 	FUNCTION

  /V		Verbose Mode, displays driver information
		during OS/2 initialization.

  /DEVICE:n     Parameter is added to select which USB device to serve in
		multidevice configurations (several mice devices attached
		to USB bus).


2.4  USB-Mouse Un-Install Instructions
======================================

2.4.1  Delete from CONFIG.SYS file line configuring USBMOUSE.SYS device driver
       (line starting with DEVICE=drive:\OS2\BOOT\USBMOUSE.SYS) and file
       USBMOUSE.SYS from \os2\boot directory.

2.4.2  Safely shut down and then re-boot your system in order to remove the
       USB-Mouse driver from the system configuration.


2.5 List of Tested USB-Mice
===========================

KYE/GeniusTwo Button USB Mouse
Kensigton Mouse in a box (USB PS2)
KYE/Genius Net Mouse Pro (USB)
Macally  iMouse Pro
A4-Tech AM-5E Mouse
Belkin 3 Button USB Mouse


2.6 Requirements
================

2.6.1  Hardware
USBMOUSE.SYS driver is designed to work with any USB standard mouse device.

2.6.2  Software
       (a.) USB Basic support


3.0  Copyright and Trademark Information
________________________________________

The following terms, are registered trademarks of the International 
Business Machines Corporation in the United States, or other countries,
or both:
o IBM
o OS/2
o Warp

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. All rights reserved.
U.S. Government Users Restricted Rights -- Use, duplication or 
disclosure restricted by GSA ADP Schedule Contract with IBM Corp.