home *** CD-ROM | disk | FTP | other *** search
/ Enter 1999 April - Disc 1 / enter_04_1999_1.iso / OS2 / XFREE86 / XDOC.ZIP / XFree86 / lib / X11 / doc / README.mouse < prev    next >
Encoding:
Text File  |  1999-01-09  |  28.0 KB  |  925 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                            Mouse Support in XFree86
  11.  
  12.                                 Kazutaka Yokota
  13.  
  14.                                28 February 1998
  15.  
  16.  
  17.  
  18. 1.  Introduction
  19.  
  20. This document describes mouse support in XFree86 3.3.2, whose X servers have
  21. the revised mouse driver.
  22.  
  23. Mouse configuration has often been mysterious task for novice users.  However,
  24. once you learn several basics, it is straightforward to choose options in
  25. XF86Setup or write the "Pointer" section in the XF86Config file by hand.
  26.  
  27.  
  28. 2.  Supported Hardware
  29.  
  30. XFree86 X servers support three classes of mice: serial, bus and PS/2 mice.
  31.  
  32.       Serial mouse
  33.             The serial mouse has been the most popular pointing device for PCs.
  34.             There have been numerous serial mouse models from a number of manu-
  35.             factures.  Despite the wide range of variations, there have been
  36.             relatively few protocols (data format) with which the serial mouse
  37.             talks to the host computer.
  38.  
  39.             The modern serial mouse conforms to the PnP COM device specifica-
  40.             tion so that the host computer can automatically detect the mouse
  41.             and load an appropriate driver.  The XFree86 3.3.2 X servers sup-
  42.             port this specification and can detect popular PnP serial mouse
  43.             models.
  44.  
  45.       Bus mouse
  46.             The bus mouse connects to a dedicated interface card in an expan-
  47.             sion slot.  Some video cards, notably those from ATI, and inte-
  48.             grated I/O cards may also have a bus mouse connector.  Some bus
  49.             mice are known as `InPort mouse'.
  50.  
  51.             Note that some mouse manufactures have sold a package including a
  52.             serial mouse and a serial interface card.  Don't confuse this type
  53.             of products with the genuine bus mouse.
  54.  
  55.       PS/2 mouse
  56.             They are sometimes called `Mouse-port mouse'.  The PS/2 mouse is
  57.             becoming increasingly common and popular.
  58.  
  59.             The PS/2 mouse is an intelligent device and may have more than
  60.             three buttons and a wheel or a roller.  The PS/2 mouse is usually
  61.             compatible with the original PS/2 mouse from IBM immediately after
  62.  
  63.  
  64. Mouse Support in XFree86                                                      1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. Mouse Support in XFree86                                                      2
  71.  
  72.  
  73.  
  74.             power up.  The PS/2 mouse with additional features requires a spe-
  75.             cialized initialization procedure to enable these features.  With-
  76.             out proper initialization, it behaves as though it were an ordinary
  77.             two or three button mouse.
  78.  
  79. Many mice nowadays can be used both as a serial mouse and as a PS/2 mouse.
  80. They has a logic to distinguish which interface it is connected to.  However,
  81. the mouse which is not marketed as compatible with both serial and PS/2 mouse
  82. interface lacks this logic and cannot be used in such a way, even if you can
  83. find an appropriate adapter with which you can connect the PS/2 mouse to a
  84. serial port or visa versa.
  85.  
  86. XFree86 now supports the mouse with a wheel, a roller or a knob.  Its action is
  87. detected as the Z (third) axis motion of the mouse.  As the X server or clients
  88. normally do not use the Z axis movement of the pointing device, a new configu-
  89. ration option, ZAxisMapping, is provided to assign the Z axis movement to
  90. another axis or a pair of buttons (see below).
  91.  
  92.  
  93. 3.  OS Support for Mice
  94.  
  95. 3.1  Summary of Supported Mouse Protocol Types
  96.  
  97.                                      Protocol Types
  98.                      serial     PnP     BusMouse    PS/2   Extended PS/2
  99.      OS platforms   protocols  serial   protocol  protocol  protocols
  100.                                "Auto"  "BusMouse"  "PS/2"   "xxxPS/2"
  101.      --------------------------------------------------------------------
  102.      BSD/OS            Ok        ?         ?         ?         ?
  103.      FreeBSD           Ok        Ok        Ok        Ok        SP*1
  104.      FreeBSD(98)       Ok        ?         Ok        NA        NA
  105.      Interactive Unix  Ok        NA        ?*1       ?*1       NA
  106.      Linux             Ok        Ok        Ok        Ok        Ok
  107.      Linux/98          Ok        ?         Ok        NA        NA
  108.      LynxOS            Ok        NA        Ok        Ok        NA
  109.      NetBSD            Ok        Ok        Ok        SP*1      NA
  110.      NetBSD/pc98       Ok        ?         Ok        NA        NA
  111.      OpenBSD           Ok        Ok        Ok        Ok*1      OK*1
  112.      OS/2              SP*2      SP*2      SP*2      SP*2      SP*2
  113.      SCO               Ok        ?         SP*1      SP*1      NA
  114.      Solaris 2.x       Ok        NA*1      ?*1       Ok        NA
  115.      SVR4              Ok        NA*1      SP*1      SP*1      NA
  116.      PANIX             Ok        ?         SP*1      SP*1      NA
  117.  
  118.      Ok: support is available,  NA: not available, ?: untested or unknown.
  119.      SP: support is available in a different form
  120.  
  121.      *1 Refer to the following sections for details.
  122.      *2 XFree86/OS2 will support any type of mouse that the OS supports,
  123.         whether it is serial, bus mouse, or PnP type.
  124.  
  125. 3.2  BSD/OS
  126.  
  127. No testing has been done with BSD/OS.
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. Mouse Support in XFree86                                                      3
  137.  
  138.  
  139.  
  140. 3.3  FreeBSD
  141.  
  142. FreeBSD supports the "SysMouse" protocol which must be specified when the
  143. moused daemon is running in versions 2.2.1 or later.
  144.  
  145. FreeBSD versions 2.2.5 or earlier do not support extended PS/2 mouse protocols
  146. ("xxxPS/2").  Always specify the "PS/2" protocol for any PS/2 mouse in these
  147. versions regardless of the brand of the mouse.
  148.  
  149. FreeBSD versions 2.2.6 or later include the kernel-level support for these
  150. mice.  Specify the "PS/2" or "Auto" protocol and the X server will automati-
  151. cally make use of the kernel-level support.  In fact, you may always specify
  152. "Auto" to any mouse in these versions unless the mouse is an old serial model
  153. which doesn't support PnP.
  154.  
  155. 3.4  FreeBSD(98)
  156.  
  157. The PS/2 mouse is not supported.
  158.  
  159. 3.5  Interactive Unix
  160.  
  161. The PnP serial mouse support (the "Auto" protocol) is not supported for the
  162. moment.
  163.  
  164. The bus mouse and PS/2 mouse should be supported by using the appropriate
  165. device drivers.  Use /dev/mouse for the "BusMouse" protocol and /dev/kdmouse
  166. for the "PS/2" protocol.  These protocols are untested but may work.  Please
  167. send success/failure reports to <michael.rohleder@stadt-frankfurt.de>.
  168.  
  169. 3.6  Linux
  170.  
  171. All protocol types should work.
  172.  
  173. 3.7  Linux/98
  174.  
  175. The PS/2 mouse is not supported.
  176.  
  177. 3.8  LynxOS
  178.  
  179. The PnP serial mouse support (the "Auto" protocol) is disabled in LynxOS,
  180. because of limited TTY device driver functionality.
  181.  
  182. 3.9  NetBSD
  183.  
  184. NetBSD does not support extended PS/2 mouse protocols ("xxxPS/2").  The PS/2
  185. mouse device driver /dev/pms emulates the bus mouse.  Therefore, you should
  186. always specify the "BusMouse" protocol for any PS/2 mouse regardless of the
  187. brand of the mouse.
  188.  
  189. 3.10  NetBSD/pc98
  190.  
  191. The PS/2 mouse is not supported.
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. Mouse Support in XFree86                                                      4
  203.  
  204.  
  205.  
  206. 3.11  OpenBSD
  207.  
  208. The raw PS/2 mouse device driver /dev/psm0 uses the raw PS/2 mouse protocol.
  209.  
  210. OpenBSD 2.2 and earlier does not support extended PS/2 mouse protocols
  211. ("xxxPS/2") .  Therefore, you should specify the "PS/2" protocol for any PS/2
  212. mouse regardless of the brand of the mouse.
  213.  
  214. OpenBSD 2.3 and later support all extended PS/2 mouse protocols.  You can
  215. select the "Auto" protocol for PnP PS/2 mice or any specific extended
  216. ("xxxPS/2") protocol for non PnP mice.
  217.  
  218. There is also a cooked PS/2 mouse device driver /dev/pms0 which emulates the
  219. bus mouse.  Specify the "BusMouse" protocol for any PS/2 mouse regardless of
  220. the brand of the mouse when using this device.
  221.  
  222. 3.12  OS/2
  223.  
  224. XFree86/OS2 always uses the native mouse driver of the operating system and
  225. will support any type of pointer that the OS supports, whether it is serial,
  226. bus mouse, or PnP type.  If the mouse works under Presentation Manager, it will
  227. also work under XFree86/OS2.
  228.  
  229. Always specify "OSMouse" as the protocol type.
  230.  
  231. 3.13  SCO
  232.  
  233. The bus and PS/2 mouse are supported with the "OSMouse" protocol type.
  234.  
  235. The "OSMouse" may also be used with the serial mouse.
  236.  
  237. 3.14  Solaris
  238.  
  239. Testing has been done with Solaris 2.5.1 and 2.6.  Logitech and Microsoft bus
  240. mice have not been tested, but might work with the /dev/logi and /dev/msm
  241. devices.  Standard 2 and 3 button PS/2 mice work with the "PS/2" protocol type
  242. and the /dev/kdmouse device.  The PnP serial mouse support (the "Auto" proto-
  243. col) has been tested and does not work.
  244.  
  245. 3.15  SVR4
  246.  
  247. The bus and PS/2 mouse may be supported with the "Xqueue" protocol type.
  248.  
  249. The "Xqueue" may also be used with the serial mouse.
  250.  
  251. The PnP serial mouse support (the "Auto" protocol) is not tested.
  252.  
  253. 3.16  PANIX
  254.  
  255. The PC/AT version of PANIX supports the bus and PS/2 mouse with the "Xqueue"
  256. protocol type.  The PC-98 version of PANIX supports the bus mouse with the
  257. "Xqueue" protocol type.
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. Mouse Support in XFree86                                                      5
  269.  
  270.  
  271.  
  272. 4.  Configuring Your Mouse
  273.  
  274. Before using the XF86Setup or xf86config programs to set up mouse configura-
  275. tion, you must identify the interface type, the device name and the protocol
  276. type of your mouse.  Blindly trying every possible combination of mouse set-
  277. tings will lead you nowhere.
  278.  
  279. The first thing you need to know is the interface type of the mouse you are
  280. going to use.  It can be determined by looking at the connector of the mouse.
  281. The serial mouse has a D-Sub female 9- or 25-pin connector.  The bus mice have
  282. either a D-Sub male 9-pin connector or a round DIN 9-pin connector.  The PS/2
  283. mouse is equipped with a small, round DIN 6-pin connector.  Some mice come with
  284. adapters with which the connector can be converted to another.  If you are to
  285. use such an adapter, remember that the connector at the very end of the
  286. mouse/adapter pair is what matters.
  287.  
  288. The next thing to decide is a device node to use for the given interface.  For
  289. the bus and PS/2 mice, there is little choice; your OS most possibly offers
  290. just one device node each for the bus mouse and PS/2 mouse.  There may be more
  291. than one serial port to which the serial mouse can be attached.
  292.  
  293. The next step is to guess the appropriate protocol type for the mouse.  The X
  294. server may be able to select a protocol type for the given mouse automatically
  295. in some cases.  Otherwise, the user has to choose one manually.  Follow the
  296. guidelines below.
  297.  
  298.       Bus mouse
  299.             The bus and InPort mice always use "BusMouse" protocol regardless
  300.             of the brand of the mouse.
  301.  
  302.             Some OSs may allow you to specify "Auto" as the protocol type for
  303.             the bus mouse.
  304.  
  305.       PS/2 mouse
  306.             The "PS/2" protocol should always be tried first for the PS/2 mouse
  307.             regardless of the brand of the mouse.  Any PS/2 mouse should work
  308.             with this protocol type, although wheels and other additional fea-
  309.             tures are unavailable in the X server.
  310.  
  311.             After verifying the mouse works with this protocol, you may choose
  312.             to specify one of "xxxPS/2" protocols so that extra features are
  313.             made available in the X server.  However, support for these PS/2
  314.             mice assumes certain behavior of the underlying OS and may not
  315.             always work as expected.  Support for some PS/2 mouse models may be
  316.             disabled all together for some OS platforms for this reason.
  317.  
  318.             Some OSs may allow you to specify "Auto" as the protocol type for
  319.             the PS/2 mouse and the X server will automatically adjust itself.
  320.  
  321.       Serial mouse
  322.             The XFree86 server supports a wide range of mice, both old and new.
  323.             If your mouse is of a relatively new model, it may conform to the
  324.             PnP COM device specification and the X server may be able to detect
  325.             an appropriate protocol type for the mouse automatically.
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. Mouse Support in XFree86                                                      6
  335.  
  336.  
  337.  
  338.             Specify "Auto" as the protocol type and start the X server.  If the
  339.             mouse is not a PnP mouse, or the X server cannot determine a suit-
  340.             able protocol type, the server will print the following error mes-
  341.             sage and abort.
  342.  
  343.                  xf86SetupMouse: Cannot determine the mouse protocol
  344.  
  345.             If the X server generates the above error message, you need to man-
  346.             ually specify a protocol type for your mouse.  Choose one from the
  347.             following list:
  348.  
  349.                o GlidePoint
  350.  
  351.                o IntelliMouse
  352.  
  353.                o Logictech
  354.  
  355.                o Microsoft
  356.  
  357.                o MMHittab
  358.  
  359.                o MMSeries
  360.  
  361.                o MouseMan
  362.  
  363.                o MouseSystems
  364.  
  365.                o ThinkingMouse
  366.  
  367.             When you choose, keep in mind the following rule of thumb:
  368.  
  369.               1.  "Logitech" protocol is for old serial mouse models from Log-
  370.                   itech.  Modern Logitech mice use either "MouseMan" or
  371.                   "Microsoft" protocol.
  372.  
  373.               2.  Most 2-button serial mice support the "Microsoft" protocol.
  374.  
  375.               3.  3-button serial mice may work with the "Mousesystems" proto-
  376.                   col. If it doesn't, it may work instead with the "Microsoft"
  377.                   protocol although the third (middle) button won't function.
  378.                   3-button serial mice may also work with the "Mouseman" proto-
  379.                   col under which the third button may function as expected.
  380.  
  381.               4.  3-button serial mice may have a small switch at the bottom of
  382.                   the mouse to choose between ``MS'' and ``PC'', or ``2'' and
  383.                   ``3''.  ``MS'' or ``2'' usually mean the "Microsoft" proto-
  384.                   col.  ``PC'' or ``3'' will choose the "MouseSystems" proto-
  385.                   col.
  386.  
  387.               5.  If the serial mouse has a roller or a wheel, it may be com-
  388.                   patible with the "IntelliMouse" protocol.
  389.  
  390.               6.  If the serial mouse has a roller or a wheel and it doesn't
  391.                   work with the "IntelliMouse" protocol, you have to use it as
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. Mouse Support in XFree86                                                      7
  401.  
  402.  
  403.  
  404.                   a regular 2- or 3-button serial mouse.
  405.  
  406.             If the "Auto" protocol is specified and the mouse seems working,
  407.             but you find that not all features of the mouse is available, that
  408.             is because the X server does not have native support for that model
  409.             of mouse and is using a ``compatible'' protocol according to PnP
  410.             information.
  411.  
  412.             If you suspect this is the case with your mouse, please send report
  413.             to <XFree86@XFree86.Org>.
  414.  
  415.       Standardized protocols
  416.             Mouse device drivers in your OS may use the standardized protocol
  417.             regardless of the model or the class of the mouse.  For example,
  418.             SVR4 systems may support "Xqueue" protocol.  In FreeBSD the system
  419.             mouse device /dev/sysmouse uses the "SysMouse" protocol.  Please
  420.             refer to the OS support section of this file for more information.
  421.  
  422.  
  423. 5.  XF86Config Options
  424.  
  425. The following new options are available for the Pointer section of the XF86Con-
  426. fig file.
  427.  
  428. 5.1  Buttons
  429.  
  430. This option tells the X server the number of buttons on the mouse.  Currently
  431. there is no reliable way to automatically detect the correct number.  This
  432. option is the only means for the X server to obtain it.  The default value is
  433. three.
  434.  
  435. Note that if you intend to assign Z axis movement to button events using the
  436. ZAxisMapping option below, you need to take account of those buttons into N
  437. too.
  438.  
  439.           Buttons N
  440.  
  441. 5.2  ZAxisMappping
  442.  
  443. This option maps the Z axis (wheel) motion to a pair of buttons or to another
  444. axis.
  445.  
  446.           ZAxisMapping X
  447.           ZAxisMapping Y
  448.           ZAxisMapping N M
  449.  
  450. The first example will map the Z axis motion to the X axis motion.  Whenever
  451. the user moves the wheel/roller, its movement is reported as the X axis motion.
  452. When the wheel/roller stays still, the real X axis motion is reported as is.
  453. The last example will map negative Z axis motion to the button N and positive Z
  454. axis motion to the button M.  If this option is used and the buttons N or M
  455. actually exists in the mouse, their actions won't be detected by the X server.
  456.  
  457. Currently this option can not be set in the XF86Setup program.  You need to
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. Mouse Support in XFree86                                                      8
  467.  
  468.  
  469.  
  470. edit the XF86Config file by hand to add this option.
  471.  
  472. 5.3  Resolution
  473.  
  474. The following option will set the mouse device resolution to N counts per inch,
  475. if possible:
  476.  
  477.           Resolution N
  478.  
  479. Not all mice and OSs can support this option.  This option can be set in the
  480. XF86Setup program.
  481.  
  482.  
  483. 6.  Mouse Gallery
  484.  
  485. 6.1  MS IntelliMouse  (serial, PS/2)
  486.  
  487. This mouse has been supported since XFree86 3.3.  However, support in 3.3.2 is
  488. slightly different; the wheel movement is recognized as the Z axis motion.
  489. This behavior is not compatible with XFree86 3.3, but is more consistent with
  490. the support for other mice with wheels or rollers.  If you want to make the
  491. wheel behave like before, you can use the new option "ZAxisMapping" as
  492. described above.
  493.  
  494. IntelliMouse supports the PnP COM device specification.
  495.  
  496. To use this mouse as a serial device:
  497.  
  498.           Protocol "Auto" or "IntelliMouse"
  499.           Device   "/dev/xxxx" (where xxxx is a serial port)
  500.  
  501. To use this mouse as the PS/2 device and the OS supports PS/2 mouse initializa-
  502. tion:
  503.  
  504.           Protocol "IMPS/2"
  505.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  506.  
  507. To use this mouse as the PS/2 device but the OS does not support PS/2 mouse
  508. initialization (the wheel won't work in this case):
  509.  
  510.           Protocol "PS/2"
  511.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  512.  
  513. To use this mouse as the PS/2 device and the OS supports automatic PS/2 mouse
  514. detection:
  515.  
  516.           Protocol "Auto"
  517.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  518.  
  519. 6.2  Kensington Thinking Mouse (serial, PS/2)
  520.  
  521. This mouse has four buttons.  Thinking Mouse supports the PnP COM device speci-
  522. fication.
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. Mouse Support in XFree86                                                      9
  533.  
  534.  
  535.  
  536. To use this mouse as a serial device:
  537.  
  538.           Protocol "Auto" or "ThinkingMouse"
  539.           Device   "/dev/xxxx" (where xxxx is a serial port)
  540.  
  541. To use this mouse as the PS/2 device and the OS supports PS/2 mouse initializa-
  542. tion:
  543.  
  544.           Protocol "ThinkingMousePS/2"
  545.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  546.  
  547. To use this mouse as the PS/2 device but the OS does not support PS/2 mouse
  548. initialization (the third and the fourth buttons act as though they were the
  549. first and the second buttons):
  550.  
  551.           Protocol "PS/2"
  552.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  553.  
  554. To use this mouse as the PS/2 device and the OS supports automatic PS/2 mouse
  555. detection:
  556.  
  557.           Protocol "Auto"
  558.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  559.  
  560. 6.3  Genius NetScroll (PS/2)
  561.  
  562. This mouse has four buttons and a roller.  The roller movement is recognized as
  563. the Z axis motion.
  564.  
  565. To use this mouse as the PS/2 device and the OS supports PS/2 mouse initializa-
  566. tion:
  567.  
  568.           Protocol "NetScrollPS/2"
  569.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  570.  
  571. To use this mouse as the PS/2 device but the OS does not support PS/2 mouse
  572. initialization (the roller and the fourth button won't work):
  573.  
  574.           Protocol "PS/2"
  575.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  576.  
  577. To use this mouse as the PS/2 device and the OS supports automatic PS/2 mouse
  578. detection:
  579.  
  580.           Protocol "Auto"
  581.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  582.  
  583. 6.4  Genius NetMouse and NetMouse Pro (serial, PS/2)
  584.  
  585. These mice have a "magic button" which is used like a wheel or a roller.  The
  586. "magic button" action is recognized as the Z axis motion.  NetMouse Pro is
  587. identical to NetMouse except that it has the third button on the left hand
  588. side.
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. Mouse Support in XFree86                                                     10
  599.  
  600.  
  601.  
  602. NetMouse and NetMouse Pro support the PnP COM device specification.  When used
  603. as a serial mouse, they are compatible with MS IntelliMouse.
  604.  
  605. To use these mice as a serial device:
  606.  
  607.           Protocol "Auto" or "IntelliMouse"
  608.           Device   "/dev/xxxx" (where xxxx is a serial port)
  609.  
  610. To use this mouse as the PS/2 device and the OS supports PS/2 mouse initializa-
  611. tion:
  612.  
  613.           Protocol "NetMousePS/2"
  614.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  615.  
  616. To use this mouse as the PS/2 device but the OS does not support PS/2 mouse
  617. initialization (the "magic button" and the third button won't work):
  618.  
  619.           Protocol "PS/2"
  620.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  621.  
  622. To use this mouse as the PS/2 device and the OS supports automatic PS/2 mouse
  623. detection:
  624.  
  625.           Protocol "Auto"
  626.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  627.  
  628. 6.5  ALPS GlidePoint (serial, PS/2)
  629.  
  630. The serial version of this pad device has been supported since XFree86 3.2.
  631. `Tapping' action is interpreted as the fourth button press.  (IMHO, the fourth
  632. button of GlidePoint should always be mapped to the first button in order to
  633. make this pad behave like the other pad products.)
  634.  
  635. To use this pad as a serial device:
  636.  
  637.           Protocol "GlidePoint"
  638.           Device   "/dev/xxxx" (where xxxx is a serial port)
  639.  
  640. To use this mouse as the PS/2 device and the OS supports PS/2 mouse initializa-
  641. tion:
  642.  
  643.           Protocol "GlidePointPS/2"
  644.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  645.  
  646. To use this mouse as the PS/2 device but the OS does not support PS/2 mouse
  647. initialization:
  648.  
  649.           Protocol "PS/2"
  650.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  651.  
  652. To use this mouse as the PS/2 device and the OS supports automatic PS/2 mouse
  653. detection:
  654.  
  655.           Protocol "Auto"
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. Mouse Support in XFree86                                                     11
  665.  
  666.  
  667.  
  668.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  669.  
  670. 6.6  ASCII MieMouse (serial, PS/2)
  671.  
  672. This mouse appears to be OEM from Genius.  Although its shape is quite differ-
  673. ent, it works like Genius NetMouse Pro.  This mouse has a "knob" which is used
  674. like a wheel or a roller.  The "knob" action is recognized as the Z axis
  675. motion.
  676.  
  677. MieMouse supports the PnP COM device specification.  When used as a serial
  678. mouse, it is compatible with MS IntelliMouse.
  679.  
  680. To use this mouse as a serial device:
  681.  
  682.           Protocol "Auto" or "IntelliMouse"
  683.           Device   "/dev/xxxx" (where xxxx is a serial port)
  684.  
  685. To use this mouse as the PS/2 device and the OS supports PS/2 mouse initializa-
  686. tion:
  687.  
  688.           Protocol "NetMousePS/2"
  689.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  690.  
  691. To use this mouse as the PS/2 device but the OS does not support PS/2 mouse
  692. initialization (the knob and the third button won't work):
  693.  
  694.           Protocol "PS/2"
  695.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  696.  
  697. To use this mouse as the PS/2 device and the OS supports automatic PS/2 mouse
  698. detection:
  699.  
  700.           Protocol "Auto"
  701.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  702.  
  703. 6.7  Logitech MouseMan+ and FirstMouse+ (serial, PS/2)
  704.  
  705. MouseMan+ has two buttons on top, one side button and a roller.  FirstMouse+
  706. has two buttons and a roller.  The roller movement is recognized as the Z axis
  707. motion.  The roller also acts as the third button.  The side button is recog-
  708. nized as the fourth button.
  709.  
  710. MouseMan+ and FirstMouse+ support the PnP COM device specification.  They have
  711. MS IntelliMouse compatible mode when used as a serial mouse.
  712.  
  713. To use these mice as a serial device:
  714.  
  715.           Protocol "Auto" or "IntelliMouse"
  716.           Device   "/dev/xxxx" (where xxxx is a serial port)
  717.  
  718. To use this mouse as the PS/2 device and the OS supports PS/2 mouse initializa-
  719. tion:
  720.  
  721.           Protocol "MouseManPlusPS/2"
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. Mouse Support in XFree86                                                     12
  731.  
  732.  
  733.  
  734.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  735.  
  736. To use this mouse as the PS/2 device but the OS does not support PS/2 mouse
  737. initialization (the wheel and the fourth button won't work):
  738.  
  739.           Protocol "PS/2"
  740.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  741.  
  742. To use this mouse as the PS/2 device and the OS supports automatic PS/2 mouse
  743. detection:
  744.  
  745.           Protocol "Auto"
  746.           Device   "/dev/xxxx"  (where xxxx is the PS/2 mouse device)
  747.  
  748.      Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/mouse.sgml,v 1.1.2.10 1998/11/07 13:52:45 dawes Exp $
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796. Mouse Support in XFree86                                                     13
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.                                    CONTENTS
  867.  
  868.  
  869.  
  870. 1. Introduction  ............................................................ 1
  871.  
  872. 2. Supported Hardware  ...................................................... 1
  873.  
  874. 3. OS Support for Mice  ..................................................... 2
  875.    3.1  Summary of Supported Mouse Protocol Types  .......................... 2
  876.    3.2  BSD/OS  ............................................................. 2
  877.    3.3  FreeBSD  ............................................................ 3
  878.    3.4  FreeBSD(98)  ........................................................ 3
  879.    3.5  Interactive Unix  ................................................... 3
  880.    3.6  Linux  .............................................................. 3
  881.    3.7  Linux/98  ........................................................... 3
  882.    3.8  LynxOS  ............................................................. 3
  883.    3.9  NetBSD  ............................................................. 3
  884.    3.10 NetBSD/pc98  ........................................................ 3
  885.    3.11 OpenBSD  ............................................................ 4
  886.    3.12 OS/2  ............................................................... 4
  887.    3.13 SCO  ................................................................ 4
  888.    3.14 Solaris  ............................................................ 4
  889.    3.15 SVR4  ............................................................... 4
  890.    3.16 PANIX  .............................................................. 4
  891.  
  892. 4. Configuring Your Mouse  .................................................. 5
  893.  
  894. 5. XF86Config Options  ...................................................... 7
  895.    5.1  Buttons  ............................................................ 7
  896.    5.2  ZAxisMappping  ...................................................... 7
  897.    5.3  Resolution  ......................................................... 8
  898.  
  899. 6. Mouse Gallery  ........................................................... 8
  900.    6.1  MS IntelliMouse  (serial, PS/2)  .................................... 8
  901.    6.2  Kensington Thinking Mouse (serial, PS/2)  ........................... 8
  902.    6.3  Genius NetScroll (PS/2)  ............................................ 9
  903.    6.4  Genius NetMouse and NetMouse Pro (serial, PS/2)  .................... 9
  904.    6.5  ALPS GlidePoint (serial, PS/2)  .................................... 10
  905.    6.6  ASCII MieMouse (serial, PS/2)  ..................................... 11
  906.    6.7  Logitech MouseMan+ and FirstMouse+ (serial, PS/2)  ................. 11
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.                                        i
  923.  
  924.  
  925.