DebuggingMouseDetection

Differences between revisions 2 and 3
⇤ ← Revision 2 as of 2007-07-31 22:17:43 →
Size: 3709
Editor: 86-39-13-189
Comment: Work in progress
← Revision 3 as of 2007-08-09 13:03:07 → ⇥
Size: 3794
Editor: 86-39-13-141
Comment:
Deletions are marked like this. Additions are marked like this.
Line 5: Line 5:
Follow the steps below if your mouse is not detected by Ubuntu, Xubuntu or Kubuntu. This procedure is only meant for external mouse detection problem, if you have a laptop and your touchpad is not detected please follow the steps described here: DebuggingTouchpadDetection.
Line 7: Line 7:
There are 3 types of mice in common use. Serial port mouse, PS/2 mice and USB mice. An important step is to identify the type of connection your mouse has. Problems with mouse detection typically fall into one off these categories:
 1. Your mouse is not detected at all.
 1. Your mouse stops working after a while.
 1. Some mouse buttons don't work (as expected).
Line 9: Line 12:
== Identifying the connection type of your mouse ==

A serial port mouse uses a connector in the shape of a D with 9 or 25 pins, the mouse connector is female (has holes) while your computer connection is male (has pins).

PS/2 mice have small round connectors with 6 pins, the mouse connector is male (has pins) while your computer connection is female (has holes). In most cases the connector has a green color.
  
USB mice have connectors in the form of a rectangle that fit in one of your computer's USB ports.

##Bugs relating to <package name/category> typically fall into X categories:
## 1. User interface bugs - require a detailed description of the issue, steps to reproduce and screen captures where appropriate.
## 1. Crasher bugs - Log files from the crash incident are required to track down these.
Line 23: Line 15:
## = How to file = = How to file a bug report =
Line 26: Line 18:
Mouse related bugs should initially be filed against '''xserver-xorg-input-mouse'''.
If the bug turns out to be a kernel bug, bug triagers will assign the bug additionally to linux-source-2.6.x and mark the xserver-xorg-input-mouse task as invalid.
Line 27: Line 21:
= Debugging procedure = == General information ==
Line 29: Line 23:
== General == For all bug categories the following general information should be provided:
Line 31: Line 25:
 1. Mention the version and flavour (Ubuntu, Kubuntu, Xubuntu) of Ubuntu your are using in the bug report.
 1. Open a terminal/console and enter the following command:
  {{{$ uname -a}}}
 1. Mention the output of the above command into the bug report.
 1. Attach /etc/X11/xorg.conf to the bug report.		  1. How is your mouse connected to your PC: serial, PS/2, USB, USB wireless, ...[[BR]]What mechanism does your mouse use: ball mouse, optical, trackball, ...[[BR]]How many physical buttons and scrollwheels does you mouse have?
 1. For a USB mouse enter the following command on a terminal/console: {{{
 $ lsusb -v > ~/lsusb-v.log }}}
 1. Open a terminal/console and enter the following commands: {{{
 $ uname -a > ~/uname-a.log
 $ cat /proc/version_signature > ~/version.log
 $ dmesg > ~/dmesg.log
 $ sudo lspci -vvnn > ~/lspci-vvnn.log }}}
 1. Attach {{{~/lsusb-v.log}}}, {{{~/uname-a.log}}}, {{{~/version.log}}} and {{{~/dmesg.log}}} and {{{~/lspci-vvnn.log}}} to the bug report.
Line 37: Line 35:
== USB mice == == In case your mouse is not detected at all ==

Introduction

This procedure is only meant for external mouse detection problem, if you have a laptop and your touchpad is not detected please follow the steps described here: DebuggingTouchpadDetection.

Problems with mouse detection typically fall into one off these categories:

  1. Your mouse is not detected at all.
  2. Your mouse stops working after a while.
  3. Some mouse buttons don't work (as expected).

How to file a bug report

Mouse related bugs should initially be filed against xserver-xorg-input-mouse. If the bug turns out to be a kernel bug, bug triagers will assign the bug additionally to linux-source-2.6.x and mark the xserver-xorg-input-mouse task as invalid.

General information

For all bug categories the following general information should be provided:

  1. How is your mouse connected to your PC: serial, PS/2, USB, USB wireless, ...BRWhat mechanism does your mouse use: ball mouse, optical, trackball, ...BRHow many physical buttons and scrollwheels does you mouse have?

  2. For a USB mouse enter the following command on a terminal/console: 

     $ lsusb -v > ~/lsusb-v.log

  3. Open a terminal/console and enter the following commands: 

     $ uname -a > ~/uname-a.log 
 $ cat /proc/version_signature > ~/version.log
 $ dmesg > ~/dmesg.log
 $ sudo lspci -vvnn > ~/lspci-vvnn.log

  4. Attach ~/lsusb-v.log, ~/uname-a.log, ~/version.log and ~/dmesg.log and ~/lspci-vvnn.log to the bug report.

In case your mouse is not detected at all

  1. Unplug you USB mouse and enter the following command in a terminal/console:

    • $ tail -f /var/log/messages | tee messages.txt

  2. Now plug in your USB mouse, you should see some messages appearing.
  3. Press Ctrl-C to stop the logging and attach messages.txt to the bug report.
  4. Enter the following command in a terminal/console:

    • $ sudo lsusb > lsusb.txt

  5. Attach lsusb-v.txt to the bug report.

Known bugs

Description of known issues, how to recognise them and stock responses/actions.

Open

Bug#

Description

Action

Closed

Bug#

Description

Action

Also see

CategoryBugSquad