Kernel Support for OneTouch buttons of HP OmniBooks
===================================================

Some HP OmniBook (and other) laptops have special multimedia keys
(aka OneTouch buttons). Them or some of them are disabled by default
and need to be enabled.

This module try 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:

HP OmniBook XE3 GC, GD, GE and HP Pavilion N5xxx
------------------------------------------------

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

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


HP OmniBook XE3 GF
------------------

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

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

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


HP OmniBook xe4xxx and ze4xxx
-----------------------------

Mail button:                    e06c
Presentation button:            e073
WWW button:                     e032
Lock button:                    e071
Help button:                    e070

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


HP OmniBook xt155
-----------------

Mail button:                    e06c
Presentation button:            e073
WWW button:                     e032
Lock button:                    e071
Help button:                    e070


HP OmniBook XT1000 and ZT11xx
-----------------------------

Mail button:                    e06c
Presentation button:            e074
WWW button:                     e032
Lock button:                    e073
Help button:                    e072

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

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


HP OmniBook 5xx
---------------

Presentation button:		e074
Help button:			e073

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

Volume down button:             e02e (*)
Volume up button:               e030 (*)

(*) On the docking station


Toshiba Satellite 3000-100
--------------------------

WWW button:			e071
Mail button:			e073

DVD button:			e006
CD button:			e013

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

Volume up button:		e075
Volume down button:		e076


There are programs specifically designed for such application keys (e.g.
hotkeys: http://ypwong.org/hotkeys/) or kernel level support for such
keys at http://rick.vanrein.org/linux/funkey/.

XE3L machines are same as XE3 models but they have application launcher
buttons only but do not have multimedia (CD and volume control) buttons.

The extra buttons near the touchpad are not OneTouch buttons. You need
driver for touchpad to use them. If you have Synaptics touchpad you may
try the driver can be found at http://www.mobilix.org/touchpad_driver.html.

The ("Big Blue") Sleep button also not a OneTouch button, it usually
handled by APM or ACPI stuff depending on your BIOS implementation.

Unfortunately the volume control buttons on XE3GC and OB5xx style models are
implemented in different way and do not generates scancodes. On XE3GC style
models scancodes can be emulated but there is no publically available
technical information about implementing them on OmniBook 5xx. Neither
Compal Electronics, Inc. (the manufacturer of HP OmniBook, Toshiba
Satellite 3000 and probably other machines) nor Dritek System, Inc.
(the vendor of the Windows software for OneTouch buttons) send any response
to information requests.
