AMouse

AMouse 4.01 ----------- Introduction ============ This driver works with all well known standard mice as well as with mice with a wheel, e.g.: - Logitech Pilot Mouse+ with serial or PS/2-port - Logitech Mouse Man+ - Logitech MX700/MX1000 - Microsoft Intellimouse - IBM Scrollpoint Mouse - Typhoon 40159 - Trust 250S - USB mice Copyrights and Licensing ======================== Copyright (c) 2012-2025 David Azarewicz <david@88watts.net> All rights reserved. Copyright (C) 2009 nb software. All rights reserved. Copyright (C) 1992, 2000-2001 IBM Corporation. All rights reserved. Binary programs and documentation for the AMouse driver and related software are licensed to and distributed by Arca Noae, LLC. Important! By downloading or using this software, you acknowledge that you have read and consent to the license agreement contained in the separate License.txt file, that you understand it, and that you agree to be bound by its terms. Requirements ============ - ArcaOS 5.0 or higher, eCS 2.1 or higher, or OS/2 fixpack 15 or higher - USB stack 11.01 or higher - Mouse with serial, PS/2 or USB port. Installation ============ The distribution is a self executing Warpin package. Simply execute it. The AMouse installer will replace and/or remove any conflicting statements in the config.sys. This effectively disables any currently active mouse driver. Any currently intalled mouse driver will not be uninstalled and it can be reinabled by simply changing the config.sys. However, support programs or system changes (if any) related to the previous mouse driver are not affected by simply changing the config.sys. The AMouse installer cannot and should not uninstall any other mouse driver. If you want to uninstall any currently installed mouse driver you must use the install/uninstall program for that driver to uninstall it before installing AMouse. Also, for best results, you should uninstall any conflicting software before installing AMouse. Uninstalling ============ You may uninstall AMouse using the normal Warpin deinstall function. This will cleanly remove all of the AMouse changes, and restore the MOUSE.SYS driver. Getting Support and Reporting Problems ====================================== For more information and to report problems please visit: https://www.arcanoae.com and click on SUPPORT. Or go directly to the AMouse support wiki at: https://www.arcanoae.com/wiki/amouse/ Known problems ============== Pointing devices which use absolute coordinates don't work in Full screen VDMs (DOS or Win/OS/2) sessions. Driver Command Line Options =========================== The normal and recommended way to use the AMouse driver is with no switches. Use driver switches at your own risk. Certain switches or combination of switches can cause malfunctions. Option Description ------------------------------------------------------------------------------ /V Display informational messages during boot. /RELAXED Enables relaxed sync detection. /QSIZE=n Specifies the queue size for certain types of mice. /TYPE=s /STYPE=s /SERIAL=s COMn or NONE /LINEAR=n n=1..9 /FORCEON Force reporting of a PDI mouse even if none is found. /NOVMAPI Disables the VM API (VMWare and VBOX). This disables the VM mouse integration. /USBONLY Disables initialization of all mouse types except for USB mice. Additional debugging options: /BP Execute a int 3 breakpoint immediately upon parsing this switch. /DBG:n /WRAP Causes the debug buffer to wrap. The default is nowrap. /COM:<port> Causes debug messages to be output to the specified serial port. 1=0x3f8, 2=0x2f8, 0xnnnn specifies the COM port base address. /BAUD:<baud> Sets the serial Port to the specified speed. Only valid if /COM is specified first. Notes ===== - Some older versions of the som.dll of the operating system are not compatible with the wps class "AMouse.dll". If you experience some difficulties like a hanging workplace shell during startup, you either have to replace the "som*.dll" files by newer ones or you have to use the executable version of the configuration program ("AMouse.exe") - see below. - Starting from AMouse version 2.1 a simple multimedia support has been implemented. This enables you to change the volume by turning the mouse wheel. The dll file belonging to this feature, "nbaudio.dll" is also used in the DCF77-device driver. If you are using an older version of this package, it might be necessary to delete or replace the dll file of the same name by the corresponding one of this package. It is sufficient to keep just a single one (the newest) in the LIBPATH. - If the drivers are loaded without parameters the system will search for mice in the order Serial -> PS/2 -> USB. The system allows multiple mice to be connected to the system. This can be confusing as to which device the hardware parameters (number of buttons and wheels) are taken from. If a USB mouse is plugged in, the USB mouse hardware parameters override other mice. If needed, you can specify a single USB device to use by using the parameter /DEVICE for USBMOUSE.SYS: DEVICE=D:\OS2\BOOT\USBMOUSE.SYS /DEVICE:1 In this case the hardware parameters are taken from the first detected USB mouse and all other mice are deactivated. Change Log ========== v.4.01 11-Jan-2024 - David Azarewicz Major reorganization and rewrite of amouse.sys. Major rework of configuration object. Installer improvements. Fixed uninstall. Added VirtualBox mouse integration. Added VMWare mouse integration. Added VMWare clipboard support. v.3.01.03 25-Nov-2018 - David Azarewicz Modified the mouse class installer to not accept invalid file names. Fixed some typos in makefiles. Cleaned up some extraneous interrupt code in amouse.sys. v.3.01.02 16-Jan-2017 - David Azarewicz Misc XWP widget cleanup v.3.01.01 27-Jul-2016 - David Azarewicz Misc installer fixes Misc bug fixes v.3.01.00 21-Mar-2015 - David Azarewicz Created Warpin installer for Arca Noae Misc installer fixes. v.2.75.01 26-Aug-2012 - David Azarewicz AMOUSE.SYS: Fixed problematic interrupt setup AMOUSE.SYS: Removed unnecessary SMP argument v.2.75.00 - previous nb software version