pms(4) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
PMS(4)                  NetBSD Kernel Interfaces Manual                 PMS(4)


NAME

     pms - PS/2 auxiliary port mouse driver


SYNOPSIS

     pckbc* at isa?
     pms* at pckbc?
     wsmouse* at pms?

     options PMS_DISABLE_POWERHOOK


DESCRIPTION

     The pms driver provides an interface to PS/2 auxiliary port mice within
     the wscons(4) framework. Parent device in terms of the autoconfiguration
     framework is pckbc(4), the PC keyboard controller.  ``pms'' is a generic
     driver which supports mice using common variants of the PS/2 protocol,
     including wheel mice of the ``IntelliMouse'' breed.  Wheel movements are
     mapped to a third (z-) axis.  The driver is believed to work with both
     3-button and 5-button mice with scroll wheels.  Mice which use other pro-
     tocol extensions are not currently supported, but might be if protocol
     documentation could be found.  Mouse related data are accessed by
     wsmouse(4) devices.

     The pms driver has been updated to attempt to renegotiate mouse protocol
     after seeing suspicious or defective mouse protocol packets, or unusual
     delays in the middle of a packet; this should improve the chances that a
     mouse will recover after being switched away or reset (for instance, by a
     console switch).

     The PMS_DISABLE_POWERHOOK kernel option disables PS/2 reset on resume.


SEE ALSO

     pckbc(4), ums(4), wsmouse(4)


AUTHORS

     The pms driver was originally written by Christopher G. Demetriou.  The
     changes to merge the ``IntelliMouse'' protocol in, and reset the mouse in
     the event of protocol problems, were contributed by Peter Seebach.  Spe-
     cial thanks to Ray Trent, at Synaptics, who contributed valuable insight
     into how to identify bogus mouse data.


BUGS

     It is possible for the driver to mistakenly negotiate the non-scroll-
     wheel protocol, after which it is unlikely to recover until the device is
     closed and reopened.

NetBSD 2.1                       May 14, 2003                       NetBSD 2.1