             Kernel Support for HP OmniBook OneTouch buttons
             ===============================================

Some HP OmniBook laptops (XE3s and XT1000) have special multimedia keys
(aka OneTouch buttons) disabled by default. They need to be enabled.

Linux kernel able to detect your HP OmniBook and enabling the OneTouch
buttons to generate scancodes.
Look in syslog messages for "keyboard: unknown scancode e0 xx" messages to
identify the scancode assigned to button. Use setkeycodes from console-tools
package to assign keycodes to them.

The scancodes are different on different models:

XT1000 models
------------n-

Mail button:                     e06c
Special-1 button:                e074
WWW button:                      e032
Special-2 button:                e073
Help button:                     e072

MP3 button:                      e071
Previous Track button:           e010
Next Track button:               e019
Play / Pause button:             e022
Stop / Eject button:             e024

Volume down button:              e02e
Volume up button:                e030
Mute / Unmute button:            e020

XE3 GF models
-------------

WWW button:                      e032
Mail button:                     e06c
Demo button:                     e074
Help button:                     e073

Previous Track button:           e010
Play / Pause button:             e022
Stop / Eject button:             e024
Next Track button:               e019

Volume down (and Fn-Down arrow): e02e
Volume up (and Fn-Up arrow):     e030
Mute / Unmute (Fn-F7):           e020

XE3 GC models
-------------

WWW button:                      e073
Mail button:                     e074
Demo button:                     e072
Help button:                     e071

Previous Track button:           e010
Play / Pause button:             e022
Stop / Eject button:             e024
Next Track button:               e019

Unfortunately the volume control buttons on HP OmniBook XE3 GC models are
implemented in different way and do not generates scancodes. There is no
publically available technical information about implementing them.

HP refusing to share any information:

> Thank you for contacting Hewlett Packard laptop email support.
> 
> I'm sorry, but I won't be able to help you with that. HP does not
> recommend or support the installation of any version of Linux on any of
> our notebook products.

Additionally neither Compal Electronics, Inc. (the manufacturer of OmniBook
XE3 machines) nor Dritek System, Inc. (the vendor of the Windows software for
OneTouch buttons) send any response to information requests.

There are programs sepcifically designed such application keys (e.g. hotkeys:
http://ypwong.org/hotkeys/).

Credits:

* Al Stone <ahs3@fc.hp.com>
   sharing some programming information
* Guido Guenther <agx@sigxcpu.org> and Pavel Mihaylov <bin@bash.info>
   initial OneTouch enabling code
* Jens Thoms Toerring <Jens.Toerring@physik.fu-berlin.de>
   initial power management code
* Peter Soos <sp@osb.hu>
   dmi and power management code
* Some others on OmniBook mailing list
   providing information and testing

For more information you can see the OmniBook mailing list at
http://zurich.ai.mit.edu/mailman/listinfo/omnibook

You can find actual version of this patch at
http://sourceforge.net/projects/omke

---
Written by: Peter Soos <sp@osb.hu>
