1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
|
<?xml version="1.0" encoding="iso-8859-1"?> <!-- -*-html-helper-*- -->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>keyfuzz @PACKAGE_VERSION@</title>
<link rel="stylesheet" type="text/css" href="style.css" />
</head>
<body>
<h1><a name="top">keyfuzz @PACKAGE_VERSION@</a></h1>
<p><i>Copyright 2004-2006 Lennart Poettering <@PACKAGE_BUGREPORT@></i></p>
<ul class="toc">
<li><a href="#license">License</a></li>
<li><a href="#news">News</a></li>
<li><a href="#overview">Overview</a></li>
<li><a href="#status">Status</a></li>
<li><a href="#documentation">Documentation</a></li>
<li><a href="#requirements">Requirements</a></li>
<li><a href="#installation">Installation</a></li>
<li><a href="#acks">Acknowledgements</a></li>
<li><a href="#download">Download</a></li>
</ul>
<h2><a name="license">License</a></h2>
<p>This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.</p>
<p>This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.</p>
<p>You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</p>
<h2><a name="news">News</a></h2>
<div class="news-date">Tue Jan 14 2006: </div>
<p class="news-text"><a href="@PACKAGE_URL@keyfuzz-0.2.tar.gz">Version 0.2</a> released, include more keyfuzz definition files.</p>
<div class="news-date">Sun Jan 25 2004: </div>
<p class="news-text"><a href="@PACKAGE_URL@keyfuzz-0.1.tar.gz">Version 0.1</a> released, initial release.</p>
<h2><a name="overview">Overview</a></h2>
<p>You may use <tt>keyfuzz</tt> to manipulate the scancode/keycode
translation tables of keyboard drivers supporting the Linux input
layer API (as included in Linux 2.6). This is useful for fixing the
translation tables of multimedia keyboards or laptop keyboards with
special keys. <tt>keyfuzz</tt> is not a daemon like Gnome
<tt>acme</tt> which reacts on special hotkeys but a tool to make
non-standard keyboards compatible with such daemons. <tt>keyfuzz</tt>
should be run once at boot time, the modifications it makes stay
active after the tool quits until reboot. <tt>keyfuzz</tt> does not interact
directly with XFree86. However, newer releases of the latter (4.1 and
above) rely on the Linux input API, so they take advantage of the
fixed translation tables.</p>
<p>The distribution includes scancode tables for <a
href="http://0pointer.de/lennart/aldi/">Medion 9580F</a> and <a
href="http://0pointer.de/lennart/tchibo.html">MSI S270</a> laptops. Feel free to send me scancodes table, I will integrate them into my package!</p>
<h2><a name="status">Current Status</a></h2>
<p>Version @PACKAGE_VERSION@ is more or less stable and feature complete.</p>
<h2><a name="documentation">Documentation</a></h2>
<p>Have a look on the man page <a href="@PACKAGE_URL@keyfuzz.8.xml"><tt>keyfuzz(8)</tt></a>. (An XSLT capable browser is required)</p>
<p>Scancode tables assign scancodes to keycodes. If you don't now what
scancodes or keycodes are, read about it in the relevant HOWTOs or FAQs
available from the <a href="http://www.tldp.org/">Linux
Documentation Project</a>.</p>
<p>The primary target of <tt>keyfuzz</tt> is to patch scancode/keycode
definitions for special multimedia keys into the current scancode
table of a device. An example for such a patch table is the following
file <tt>medion_9580f.keyfuzz</tt>, which is relevant for the Medion
9580F laptop which has four special multimedia keys:</p>
<pre># Mail
0x67 155
# World Wide Web
0x63 150
# Program #1
0x66 148
# Program #2
0x69 149
</pre>
<p>Activate this file with the following command:</p>
<pre>keyfuzz -s < medion_9580f.keyfuzz</pre>
<p>This assigns the scancode <tt>0x67</tt> to the keycode <tt>155</tt>
and so on. For a list of available keycodes have look on the
<tt>KEY_xxx</tt> constant definitions in <tt>/usr/include/linux/input.h</tt>. The
scancodes are keyboard specific. You may use the (console specific)
utility <tt>showkey(1)</tt> to examine the scancode/keycode of a
key. Another way to get the scancodes of special keys is to look for
kernel debug messages like these if you press the relevant keys:</p>
<pre>atkbd.c: Unknown key pressed (translated set 2, code 0x66 on isa0060/serio0).
atkbd.c: Unknown key released (translated set 2, code 0x66 on isa0060/serio0).</pre>
<p>Feel free to to send me patch tables for your hardware. I'll add them to my to distribution.</p>
<p>The <tt>keyfuzz</tt> distribution includes a SysV init script which
runs <tt>keyfuzz -s</tt> for all configured input devices depending on
files or symbolics links named after the devices in
<tt>/etc/keyfuzz</tt>. If you want to use this script, just create a symlink
<tt>/etc/keyfuzz/event0</tt> to a scancode table file
(e.g. <tt>/etc/keyfuzz/medion_9580f.keyfuzz</tt>). The scancode
table of the device <tt>/dev/input/event0</tt> is modified according
to the contents of that file on each boot:</p>
<pre>cd /etc/keyfuzz
ln -s medion_9580f.keyfuzz event0</pre>
<p>The virtual file <tt>/proc/bus/input/devices</tt> lists all available input devices.</p>
<h2><a name="requirements">Requirements</a></h2>
<p><tt>keyfuzz</tt> requires a kernel supporting the Linux input layer, such as 2.6.1.</p>
<h2><a name="installation">Installation</a></h2>
<p>As this package is made with the GNU <tt>autotools</tt> you should run
<tt>./configure</tt> inside the distribution directory for configuring
the source tree. After that you should run <tt>make</tt> for
compilation and <tt>make install</tt> (as root) for installation of
<tt>keyfuzz</tt>.</p>
<h2><a name="acks">Acknowledgements</a></h2>
<p>None so far</p>
<h2><a name="download">Download</a></h2>
<p>The newest release is always available from <a href="@PACKAGE_URL@">@PACKAGE_URL@</a></p>
<p>The current release is <a href="@PACKAGE_URL@keyfuzz-@PACKAGE_VERSION@.tar.gz">@PACKAGE_VERSION@</a></p>
<p>Get <tt>keyfuzz</tt>'s development sources from the <a href="http://subversion.tigris.org/">Subversion</a> <a href="svn://0pointer.de/keyfuzz">repository</a> (<a href="http://0pointer.de/cgi-bin/viewcvs.cgi/?root=keyfuzz">viewcvs</a>): </p>
<pre>svn checkout svn://0pointer.de/keyfuzz/trunk keyfuzz</pre>
<p>You may find an up to date Debian package of <tt>keyfuzz</tt> in my own <a href="http://0pointer.de/debian/">Debian package repository</a>.</p>
<p>If you want to be notified whenever I release a new version of this software use the subscription feature of <a href="http://freshmeat.net/projects/keyfuzz/">Freshmeat</a>.</p>
<hr/>
<address class="grey">Lennart Poettering <@PACKAGE_BUGREPORT@>, January 2006</address>
<div class="grey"><i>$Id$</i></div>
</body>
</html>
|
