drivers/input/sermouse/sermouse.txt

   1  Following information obtained from Tomi Engdahl (then@delta.hut.fi),
   2  http://www.hut.fi/~then/mytexts/mouse.html
   3
   4  Microsoft serial mouse
   5
   6    Serial data parameters:
   7      1200bps, 7 databits, 1 stop-bit
   8
   9    Data packet format:
  10      Data packet is 3 byte packet. It is send to the computer every time mouse
  11      state changes (mouse moves or keys are pressed/released).
  12          D7      D6      D5      D4      D3      D2      D1      D0
  13      1.  X       1       LB      RB      Y7      Y6      X7      X6
  14      2.  X       0       X5      X4      X3      X2      X1      X0
  15      3.  X       0       Y5      Y4      Y3      Y2      Y1      Y0
  16
  17      Note: The bit marked with X is 0 if the mouse received with 7 databits
  18      and 2 stop bits format. It is also possible to use 8 databits and 1 stop
  19      bit format for receiving. In this case X gets value 1. The safest thing
  20      to get everything working is to use 7 databits and 1 stopbit when
  21      receiving mouse information (and if you are making mouse then send out
  22      7 databits and 2 stop bits).
  23      The byte marked with 1. is send first, then the others. The bit D6 in
  24      the first byte is used for syncronizing the software to mouse packets
  25      if it goes out of sync.
  26
  27       LB is the state of the left button (1 means pressed down)
  28       RB is the state of the right button (1 means pressed down)
  29       X7-X0 movement in X direction since last packet (signed byte)
  30       Y7-Y0 movement in Y direction since last packet (signed byte)
  31
  32     Mouse identification
  33       When DTR line is toggled, mouse should send one data byte containing
  34       letter 'M' (ascii 77).
  35
  36
  37  Logitech serial mouse
  38
  39    Logitech uses the Microsoft serial mouse protocol in their mouses (for
  40    example Logitech Pilot mouse and others). The origianal protocol supports
  41    only two buttons, but logitech as added third button to some of their
  42    mouse models. To make this possible logitech has made one extension to
  43    the protocol.
  44    I have not seen any documentation about the exact documents, but here is
  45    what I have found out: The information of the third button state is sent
  46    using one extra byte which is send after the normal packet when needed.
  47    Value 32 (dec) is sent every time when the center button is pressed down.
  48    It is also sent every time with the data packet when center button is kept
  49    down and the mouse data packet is sent for other reasons. When center
  50    button is released, the mouse sends the normal data packet followed by
  51    data bythe which has value 0 (dec). As you can see the extra data byte
  52    is sent only when you mess with the center button.
  53
  54
  55  Mouse systems mouse
  56
  57    Serial data parameters:
  58      1200bps, 8 databits, 1 stop-bit
  59
  60    Data packet format:
  61           D7      D6      D5      D4      D3      D2      D1      D0
  62      1.   1       0       0       0       0       LB      CB      RB
  63      2.   X7      X6      X5      X4      X3      X2      X1      X0
  64      3.   Y7      Y6      Y5      Y4      Y3      Y4      Y1      Y0
  65      4.   X7'     X6'     X5'     X4'     X3'     X2'     X1'     X0'
  66      5.   Y7'     Y6'     Y5'     Y4'     Y3'     Y4'     Y1'     Y0'
  67
  68      LB is left button state (0 = pressed, 1 = released)
  69      CB is center button state (0 = pressed, 1 = released)
  70      RB is right button state (0 = pressed, 1 = released)
  71      X7-X0 movement in X direction since last packet in signed byte
  72            format (-128..+127), positive direction right
  73      Y7-Y0 movement in Y direction since last packet in signed byte
  74            format (-128..+127), positive direction up
  75      X7'-X0' movement in X direction since sending of X7-X0 packet in
  76              signed byte format (-128..+127), positive direction right
  77      Y7'-Y0' movement in Y direction since sending of Y7-Y0 packet in
  78              signed byte format (-128..+127), positive direction up
  79
  80      The last two bytes in the packet (bytes 4 and 5) contains information
  81      about movement data changes which have occured after data bytes 2 and 3
  82      have been sent.