summaryrefslogtreecommitdiffstats
path: root/man4/mouse.4
diff options
context:
space:
mode:
Diffstat (limited to 'man4/mouse.4')
-rw-r--r--man4/mouse.4171
1 files changed, 0 insertions, 171 deletions
diff --git a/man4/mouse.4 b/man4/mouse.4
deleted file mode 100644
index 21ff1a2..0000000
--- a/man4/mouse.4
+++ /dev/null
@@ -1,171 +0,0 @@
-'\" t
-.\" This manpage is Copyright (C) 1996 Michael Haardt.
-.\" Updates Nov 1998, Andries Brouwer
-.\"
-.\" SPDX-License-Identifier: Linux-man-pages-copyleft
-.TH mouse 4 2023-10-31 "Linux man-pages 6.7"
-.SH NAME
-mouse \- serial mouse interface
-.SH CONFIGURATION
-Serial mice are connected to a serial RS232/V24 dialout line, see
-.BR ttyS (4)
-for a description.
-.SH DESCRIPTION
-.SS Introduction
-The pinout of the usual 9 pin plug as used for serial mice is:
-.P
-.TS
-center;
-r c l.
-pin name used for
-2 RX Data
-3 TX \-12 V, Imax = 10 mA
-4 DTR +12 V, Imax = 10 mA
-7 RTS +12 V, Imax = 10 mA
-5 GND Ground
-.TE
-.P
-This is the specification, in fact 9 V suffices with most mice.
-.P
-The mouse driver can recognize a mouse by dropping RTS to low and raising
-it again.
-About 14 ms later the mouse will send 0x4D (\[aq]M\[aq]) on the data line.
-After a further 63 ms, a Microsoft-compatible 3-button mouse will send
-0x33 (\[aq]3\[aq]).
-.P
-The relative mouse movement is sent as
-.I dx
-(positive means right)
-and
-.I dy
-(positive means down).
-Various mice can operate at different speeds.
-To select speeds, cycle through the
-speeds 9600, 4800, 2400, and 1200 bit/s, each time writing the two characters
-from the table below and waiting 0.1 seconds.
-The following table shows available speeds and the strings that select them:
-.P
-.TS
-center;
-l l.
-bit/s string
-9600 *q
-4800 *p
-2400 *o
-1200 *n
-.TE
-.P
-The first byte of a data packet can be used for synchronization purposes.
-.SS Microsoft protocol
-The
-.B Microsoft
-protocol uses 1 start bit, 7 data bits, no parity
-and one stop bit at the speed of 1200 bits/sec.
-Data is sent to RxD in 3-byte packets.
-The
-.I dx
-and
-.I dy
-movements are sent as
-two's-complement,
-.I lb
-.RI ( rb )
-are set when the left (right)
-button is pressed:
-.P
-.TS
-center;
-r c c c c c c c.
-byte d6 d5 d4 d3 d2 d1 d0
-1 1 lb rb dy7 dy6 dx7 dx6
-2 0 dx5 dx4 dx3 dx2 dx1 dx0
-3 0 dy5 dy4 dy3 dy2 dy1 dy0
-.TE
-.SS 3-button Microsoft protocol
-Original Microsoft mice only have two buttons.
-However, there are some
-three button mice which also use the Microsoft protocol.
-Pressing or
-releasing the middle button is reported by sending a packet with zero
-movement and no buttons pressed.
-(Thus, unlike for the other two buttons, the status of the middle
-button is not reported in each packet.)
-.SS Logitech protocol
-Logitech serial 3-button mice use a different extension of the
-Microsoft protocol: when the middle button is up, the above 3-byte
-packet is sent.
-When the middle button is down a 4-byte packet is
-sent, where the 4th byte has value 0x20 (or at least has the 0x20
-bit set).
-In particular, a press of the middle button is reported
-as 0,0,0,0x20 when no other buttons are down.
-.SS Mousesystems protocol
-The
-.B Mousesystems
-protocol uses 1 start bit, 8 data bits, no parity,
-and two stop bits at the speed of 1200 bits/sec.
-Data is sent to RxD in
-5-byte packets.
-.I dx
-is sent as the sum of the two two's-complement
-values,
-.I dy
-is send as negated sum of the two two's-complement
-values.
-.I lb
-.RI ( mb ,
-.IR rb )
-are cleared when the left (middle,
-right) button is pressed:
-.P
-.TS
-center;
-r c c c c c c c c.
-byte d7 d6 d5 d4 d3 d2 d1 d0
-1 1 0 0 0 0 lb mb rb
-2 0 dxa6 dxa5 dxa4 dxa3 dxa2 dxa1 dxa0
-3 0 dya6 dya5 dya4 dya3 dya2 dya1 dya0
-4 0 dxb6 dxb5 dxb4 dxb3 dxb2 dxb1 dxb0
-5 0 dyb6 dyb5 dyb4 dyb3 dyb2 dyb1 dyb0
-.TE
-.P
-Bytes 4 and 5 describe the change that occurred since bytes 2 and 3
-were transmitted.
-.SS Sun protocol
-The
-.B Sun
-protocol is the 3-byte version of the above 5-byte
-Mousesystems protocol: the last two bytes are not sent.
-.SS MM protocol
-The
-.B MM
-protocol uses 1 start bit, 8 data bits, odd parity, and one
-stop bit at the speed of 1200 bits/sec.
-Data is sent to RxD in 3-byte
-packets.
-.I dx
-and
-.I dy
-are sent as single signed values, the
-sign bit indicating a negative value.
-.I lb
-.RI ( mb ,
-.IR rb )
-are
-set when the left (middle, right) button is pressed:
-.P
-.TS
-center;
-r c c c c c c c c.
-byte d7 d6 d5 d4 d3 d2 d1 d0
-1 1 0 0 dxs dys lb mb rb
-2 0 dx6 dx5 dx4 dx3 dx2 dx1 dx0
-3 0 dy6 dy5 dy4 dy3 dy2 dy1 dy0
-.TE
-.SH FILES
-.TP
-.I /dev/mouse
-A commonly used symbolic link pointing to a mouse device.
-.SH SEE ALSO
-.BR ttyS (4),
-.BR gpm (8)