[Ubuntu Wiki] Update of "DebuggingTouchpadDetection" by heymrdjd

[Ubuntu Wiki]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Ubuntu Wiki" for change notification.

The following page has been changed by heymrdjd:
http://wiki.ubuntu.com/DebuggingTouchpadDetection?action=diff&rev1=20&rev2=21

The comment on the change is:
corrected various grammatical/spelling errors, capitalized Touchpad to provide consistency throughout page

------------------------------------------------------------------------------
  = Introduction =
  
  Problems with touchpad detection typically fall into one of these categories:
-  1. Your touchpad doesn't work at all. 
+  1. Your Touchpad doesn't work at all. 
-  1. Your touchpad stops working after a while.
+  1. Your Touchpad stops working after a while.
-  1. Features of Mouse works but features of Touchpad(like Tapping, Scrolling) does not work at all.
+  1. Features of Mouse works but features of Touchpad (like Tapping, Scrolling) does not work at all.
-  1. Some features of your touchpad like scrolling, tapping, dragging don't work as expected.
+  1. Some features of your Touchpad like scrolling, tapping, dragging don't work as expected.
  
  
  <<Anchor(generalinfo)>>
  
  = How to file the bug report =
- Consider this document on filing touchpad bugs with relevant information. Before filing a bug please check the list of known bugs at the end of this document. If your are unsure to which package the bug should be filed or your problem is not listed in any of the categories then, in general file your touchpad related bugs against '''xserver-xorg-input-synaptics'''. If the bug turns out to be a bug related to kernel('''linux''') or any other package, bug triagers will assign your bug additionally to that package and mark the task related to xserver-xorg-input-synaptics, as invalid.
+ Consider this document on filing Touchpad bugs with relevant information. Before filing a bug please check the list of known bugs at the end of this document. If your are unsure to which package the bug should be filed or your problem is not listed in any of the categories then, in general file your touchpad related bugs against '''xserver-xorg-input-synaptics'''. If the bug turns out to be a bug related to kernel('''linux''') or any other package, bug triagers will assign your bug additionally to that package and mark the task related to xserver-xorg-input-synaptics, as invalid.
  
  == General information before filing the bug ==
  This information should be provided in the bug description itself:
@@ -25, +25 @@

  
  Sample Description - 'ALPS Touchpad' incorrectly detected as PS/2 mouse in 'Sony Vaio VPCCW16FG' after the kernel upgrade.
  
- However if you think that the bug is a general one with the type of the touchpad and is irrespective of the Laptop model you could omit mentioning the Laptop model in the description. But only consider doing this, when you are very sure that the bug is affecting all laptops with that touchpad model.
+ However if you think that the bug is a general one with the type of the Touchpad and is irrespective of the Laptop model you could omit mentioning the Laptop model in the description. But only consider doing this, when you are very sure that the bug is affecting all laptops with that Touchpad model.
  
- == In case your touchpad doesn't work at all (No response from the touchpad) ==
+ == In case your Touchpad doesn't work at all (No response from the Touchpad) ==
  
  This is generally a case of kernel('''linux''') or '''xorg''' bug. Check by connecting a mouse that if it works or not. If no, then you should file the bug against '''HAL''' and follow the steps below.
  
   1. Switch to a VT using Crtl+Alt+F2 and enter following in your terminal {{{
  $ sudo evtest /dev/input/eventX > ~/evtest }}}
-  2. Scroll, tap, drag, press buttons and create various other possible events on the touchpad and then press CTRL+C to exit. {{{
+  2. Scroll, tap, drag, press buttons and create various other possible events on the Touchpad and then press CTRL+C to exit. {{{
   $ cp /var/log/Xorg.0.log ~/Xorg.0.log }}}
   4. Press Crtl+Alt+F7 to switch back to X.
   3. Add {{{~/evtest}}} and {{{Xorg.o.log}}} to the bug report in seperate attachments. 
  
- Check your {{{ /dev/input/eventX }}} for your touchpad in {{{ cat /proc/bus/input/devices }}} , you may see something like this 
+ Check your {{{ /dev/input/eventX }}} for your Touchpad in {{{ cat /proc/bus/input/devices }}} , you may see something like this 
  
  {{{ I: Bus=0011 Vendor=0002 Product=0007 Version=01b1 }}}
  {{{ N: Name="SynPS/2 Synaptics TouchPad" }}}
@@ -60, +60 @@

  $ dmesg > ~/dmesg }}}
   1. Attach {{{~/dmesg}}} and your {{{/var/log/Xorg.0.log}}} to the bug report in separate attachments.
  
- == In case your touchpad stops working after a while ==
+ == In case your Touchpad stops working after a while ==
  
  This is generally a case of kernel('''linux''') or '''xorg''' bug. In this case, in description field, specify the steps to make the touchpad stop working. eg- hit a key, drag or something. Now check by connecting a mouse that if it works or not. If no, then you should file the bug against '''HAL''' and follow the steps below.
  
   1. Switch to a VT using Crtl+Alt+F2 and enter following in your terminal {{{
  $ sudo evtest /dev/input/eventX > ~/evtest }}}
-  2. Scroll, tap, drag, press buttons and create various other possible events on the touchpad and then press CTRL+C to exit. {{{
+  2. Scroll, tap, drag, press buttons and create various other possible events on the Touchpad and then press CTRL+C to exit. {{{
   $ cp /var/log/Xorg.0.log ~/Xorg.0.log }}}
   4. Press Crtl+Alt+F7 to switch back to X.
-  3. Add {{{~/evtest}}} and {{{Xorg.o.log}}} to the bug report in seperate attachments. 
+  3. Add {{{~/evtest}}} and {{{Xorg.o.log}}} to the bug report in separate attachments. 
  
- Check your {{{ /dev/input/eventX }}} for your touchpad in {{{ cat /proc/bus/input/devices }}} , you may see something like this 
+ Check your {{{ /dev/input/eventX }}} for your Touchpad in {{{ cat /proc/bus/input/devices }}} , you may see something like this 
  
  {{{ I: Bus=0011 Vendor=0002 Product=0007 Version=01b1 }}}
  {{{ N: Name="SynPS/2 Synaptics TouchPad" }}}
@@ -101, +101 @@

  $ diff -ns ~/Xorg.0.log ~/Xorg.0.log_tmp > ~/Xorg.0.log_diff }}}
   1. Attach {{{~/dmesg_boot}}}, {{{~/dmesg_diff}}}, {{{~/Xorg.0.log}}} and {{{~/Xorg.0.log_diff}}} to the bug report in separate attachments.
  
- == In case your touchpad features like scrolling, tapping, etc does not work at all. ==
+ == In case Touchpad features like scrolling, tapping, etc do not work at all. ==
  
  This happens when 'Touchpad' Tab is not there in System>Preferences>Mouse. 
  
@@ -109, +109 @@

  
  To check whether to report for kernel or not {{{
  $ cat /proc/bus/input/devices >~/devices }}}
- If this include the name of your touchpad eg Name="SynPS/2 Synaptics TouchPad", then kernel has detected it right. In this case, please don't report the bug against the kernel, rather report it against '''HAL'''. For more information on reporting bugs against HAL, refer DebuggingHal
+ If the output includes the name of your Touchpad eg Name="SynPS/2 Synaptics TouchPad", then kernel has detected it right. In this case, please don't report the bug against the kernel, rather report it against '''HAL'''. For more information on reporting bugs against HAL, refer DebuggingHal
  
  In any case, include the outputs of the following commands: {{{
  $ cat /proc/bus/input/devices >~/devices
@@ -120, +120 @@

  
  '''IMP :''' Please do not file bug against the kernel unless you are very sure that it should be filed and do it only after reading this whole document. If you are unsure, file it against xserver-xorg-input-synaptics, somebody will change to kernel if is so. 
  
- == In case your atleast one of touchpad features works but does not work correctly and as expected ==
+ == In case at least one of Touchpad features works but does not work correctly and as expected ==
  
- eg - Jumpy cursor, scrolling problems, touchpad area is misdetected, circular scrolling, buttons not correctly mapped.
+ eg - Jumpy cursor, scrolling problems, Touchpad area is misdetected, circular scrolling, buttons not correctly mapped.
  
   1. Enter the following command in a terminal/console: {{{
  $ xmodmap -pp >~/xmodmap
  $ xinput --list-props <id> >~/xinput }}}
   1. Switch to a VT using Crtl+Alt+F2 and enter following in your terminal {{{
  $ sudo evtest /dev/input/eventX > ~/evtest }}}
-  2. Scroll, tap, drag, press buttons and create various other possible events on the touchpad and then press CTRL+C to exit.
+  2. Scroll, tap, drag, press buttons and create various other possible events on the Touchpad and then press CTRL+C to exit.
   4. Press Crtl+Alt+F7 to switch back to X.
   5. Attach {{{~/xmodmap}}}, {{{~/xinput}}} and your {{{~/evtest}}} to the bug report in separate attachments.
  
- In {{{ xinput --list-props <id> }}}, <id> is of your touchpad in {{{ xinput --list }}}.
+ In {{{ xinput --list-props <id> }}}, <id> is of your Touchpad in {{{ xinput --list }}}.
  
- Check your {{{ /dev/input/eventX }}} for your touchpad in {{{ cat /proc/bus/input/devices }}} , you may see something like this 
+ Check your {{{ /dev/input/eventX }}} for your Touchpad in {{{ cat /proc/bus/input/devices }}} , you may see something like this 
  
  {{{ I: Bus=0011 Vendor=0002 Product=0007 Version=01b1 }}}
  {{{ N: Name="SynPS/2 Synaptics TouchPad" }}}
@@ -154, +154 @@

  This bug is common in Synaptics Touchpad V7.2 where multitouch works perfect in windows but not in linux. This is not a bug related to xserver-xorg-input-synaptics. Multitouch capabilities are not detected but the kernel itself as evident in {{{ xinput --list-props <id of your touchpad> }}} shows 
  {{{ Synaptics Capabilities (277):	1, 1, 1, 0, 0 }}}
  
- This bug is already known (see the '''Known bugs''' below). In this case please don't file any new bugs and instead add a comment in the existing bug for any relevent information that you have.
+ This bug is already known (see the '''Known bugs''' below). In this case please don't file any new bugs and instead add a comment in the existing bug for any relevant information that you have.
  
- '''NOTE :''' Synaptics is not willing to disclose the protocol it uses for the multitouch support for its newer touchpads. As soon as Synaptics come up with its protocol, this issue will be fixed. So this is not a bug in general. So it has been classified as a wishlist.
+ '''NOTE :''' Synaptics is not willing to disclose the protocol it uses for the multitouch support for its newer Touchpads. As soon as Synaptics come up with its protocol, this issue will be fixed. So this is not a bug in general. So it has been classified as a wishlist.
  
   1. For any other case, include the outputs in the bug report in separate comments. {{{
  $ xinput --list-props <id> >~/xinput }}}
   2. Switch to a VT using Crtl+Alt+F2 and enter following in your terminal {{{
  $ sudo evtest /dev/input/eventX > ~/evtest }}}
-  3. Scroll, tap, drag, press buttons and create various other possible events on the touchpad and then press CTRL+C to exit.
+  3. Scroll, tap, drag, press buttons and create various other possible events on the Touchpad and then press CTRL+C to exit.
   4. Press Crtl+Alt+F7 to switch back to X.
-  5. Take your pointer in the windows and hold down your two fingres on the touchpad and raise. Also try to tap with two fingers. {{{ 
+  5. Take your pointer in the windows and hold down your two fingers on the Touchpad and raise. Also try to tap with two fingers. {{{ 
   $ xev | grep -i button > ~/xev}}}
   6. Attach {{{~/xev}}}, {{{~/xinput}}} and your {{{~/evtest}}} to the bug report in separate attachments.
  
  In {{{ xinput --list-props <id> }}}, <id> is of your touchpad in xinput --list.
  
- Check your {{{ /dev/input/eventX }}} for your touchpad in {{{ cat /proc/bus/input/devices }}} , you may see something like this 
+ Check your {{{ /dev/input/eventX }}} for your Touchpad in {{{ cat /proc/bus/input/devices }}} , you may see something like this 
  
  {{{ I: Bus=0011 Vendor=0002 Product=0007 Version=01b1 }}}
  {{{ N: Name="SynPS/2 Synaptics TouchPad" }}}
@@ -188, +188 @@

  
  = Some general work flow for Triagers  =
  
- If the features of your touchpad (like Tapping, Scrolling) does '''not''' work at all. In this case user will not see the '''Touchpad''' Tab in System>Administration>Mouse in Main menu. This means that Touchpad is misdetected as PS/2 mouse. Here the following workflow must be followed.
+ If the features of your Touchpad (like Tapping, Scrolling) do '''not''' work at all. In this case, user will not see the '''Touchpad''' Tab in System>Administration>Mouse in Main menu. This means that Touchpad is misdetected as PS/2 mouse. Here the following workflow must be followed.
  
-  1. Check weather Kernel has detected the touchpad or not by the following. {{{
+  1. Check whether Kernel has detected the Touchpad or not by the following. {{{
  $ cat /proc/bus/input/devices }}}
  
-   If a touchpad is detected, then something like following will appear.
+   If a Touchpad is detected, then something like following will appear.
      '''Name="SynPS/2 Synaptics TouchPad"'''
  
-   If touchpad is not detected then following will appear. In this case the bug must be a kernel issue.
+   If Touchpad is not detected then following will appear. In this case the bug must be a kernel issue.
      '''Name="ImPS/2 Generic Wheel Mouse"'''
  
-  2. Check weather xserver has detected the touchpad correctly by. {{{
+  2. Check whether xserver has detected the Touchpad correctly by. {{{
  $ xinput --list }}}
-   You will see the same name of touchpad as above.
+   You will see the same name of Touchpad as above.
  
   3. Check weather synaptics module is correctly loaded in xserver or not in. {{{
  $cat /var/log/Xorg.0.log | grep -i synaptics }}}
@@ -229, +229 @@

  Synaptics Touchpad is incorrectly detected by kernel https://bugs.edge.launchpad.net/ubuntu/+source/linux/+bug/565543
  
  ----
- CategoryBugSquad CategoryDebugging
+ CategoryBugSquad CategoryDebugging CategoryCleanup