ThinkWiki - User contributions [en]

How to get special keys to work

2008-09-24T16:30:48Z

Rkan: /* Firefox (<3.0) */

==Overview==
The following table gives an overview over the special keys found on ThinkPads and what is needed to make them work.
{| {{prettytable}}
! key !! standard function{{footnote|1}} !! tools supporting key{{footnote|2}} !! configurability{{footnote|3}} !! remarks
|-
| {{key|Fn}} || - || [[#xmodmap configuration|xmodmap]], [[#tpb configuration|tpb]] || full || on release without completed key combination
|-
| {{key|Fn}}{{key|F1}} || - || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]] || full ||
|-
| {{key|Fn}}{{key|F2}} || lock screen || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]] || full || in models from T/X/Z 60 onwards
|-
| {{key|Fn}}{{key|F3}} || blank screen || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]] || full ||
|-
| {{key|Fn}}{{key|F4}} || suspend to ram || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]] || full || may generate ACPI event when not enabled in the ibm-acpi hotkey mask
|-
| {{key|Fn}}{{key|F5}} || switch bluetooth || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]] || full || in models starting from 2002
|-
| {{key|Fn}}{{key|F6}} || - || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]] || full ||
|-
| {{key|Fn}}{{key|F7}} || toggle display || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]], [[#tpb configuration|tpb]] || additional actions || [[Sample Fn-F7 script]]
|-
| {{key|Fn}}{{key|F8}} || toggle trackpoint/touchpad || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]], [[#tpb configuration|tpb]] || additional actions ||
|-
| {{key|Fn}}{{key|F9}} || eject from dock || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]] || full ||
|-
| {{key|Fn}}{{key|F10}} || - || [[#ibm-acpi events|ibm-acpi]] || full ||
|-
| {{key|Fn}}{{key|F11}} || - || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]] || full ||
|-
| {{key|Fn}}{{key|F12}} || hibernate || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]] || full || may generate ACPI event when not enabled in the ibm-acpi hotkey mask
|-
| {{key|Fn}}{{key|Home}} / {{key|Fn}}{{key|Pos1}} || brightness up || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]], [[#tpb configuration|tpb]], [[KMilo]] || additional actions ||
|-
| {{key|Fn}}{{key|End}} || brightness down || [[thinkpad-acpi]], [[#tpb configuration|tpb]], [[KMilo]] || additional actions ||
|-
| {{key|Fn}}{{key|PageUp}} || toggle thinklight || [[thinkpad-acpi]], [[#tpb configuration|tpb]], [[KMilo]] || additional actions ||
|-
| {{key|Fn}}{{key|Space}} || toggle zoom || [[thinkpad-acpi]], [[#tpb configuration|tpb]], [[KMilo]] || full ||
|-
| {{key|Fn}}{{key|Ins}} || - || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]]|| full ||
|-
| {{key|Fn}}{{key|Del}} || - || [[#ibm-acpi events|ibm-acpi]] || full ||
|-
| {{key|Fn}}{{key|Backspace}} || - || [[#ibm-acpi events|ibm-acpi]] || full ||
|-
| {{key|NumLock}} || - || [[#xmodmap configuration|xmodmap]] || make working ||
|-
| {{key|Windows}} || - || [[#xmodmap configuration|xmodmap]] || remapping ||
|-
| {{ibmkey|Access IBM|#495988}} or {{ibmkey|ThinkPad|#494949}} or {{ibmkey|ThinkVantage|#495988}} || help application || [[thinkpad-acpi]],[[#tpb configuration|tpb]], [[KMilo]] || full ||
|-
| {{ibmkey|Home|#494949}} || open web browser || [[#xmodmap configuration|xmodmap]], [[#tpb configuration|tpb]], [[KMilo]] || full || only {{A30}}, {{A30p}}, {{A31}}, {{A31p}} and ext. keyboards
|-
| {{ibmkey|Search|#494949}} || open search application || [[#xmodmap configuration|xmodmap]], [[#tpb configuration|tpb]], [[KMilo]] || full || only {{A30}}, {{A30p}}, {{A31}}, {{A31p}} and ext. keyboards
|-
| {{ibmkey|Mail|#494949}} || open mail application || [[#xmodmap configuration|xmodmap]], [[#tpb configuration|tpb]], [[KMilo]] || full || only {{A30}}, {{A30p}}, {{A31}}, {{A31p}} and ext. keyboards
|-
| {{ibmkey|Favorites|#494949}} || open favorites || [[#xmodmap configuration|xmodmap]], [[#tpb configuration|tpb]] || full || only {{A30}}, {{A30p}}, {{A31}}, {{A31p}} and ext. keyboards
|-
| {{ibmkey|Reload|#494949}} || reload web page || [[#xmodmap configuration|xmodmap]], [[#tpb configuration|tpb]] || full || only {{A30}}, {{A30p}}, {{A31}}, {{A31p}} and ext. keyboards
|-
| {{ibmkey|Abort|#494949}} || abort loading page || [[#xmodmap configuration|xmodmap]], [[#tpb configuration|tpb]] || full || only {{A30}}, {{A30p}}, {{A31}}, {{A31p}} and ext. keyboards
|-
| {{ibmkey|Backward|#494949}} || previous page || [[#xmodmap configuration|xmodmap]], [[#tpb configuration|tpb]] || full || ext. keyboards and ThinkPads starting from 2002
|-
| {{ibmkey|Forward|#494949}} || next page || [[#xmodmap configuration|xmodmap]], [[#tpb configuration|tpb]] || full || ext. keyboards and ThinkPads starting from 2002
|-
| {{ibmkey|Volume up|#494949}} || volume up || [[thinkpad-acpi]], [[#tpb configuration|tpb]], [[KMilo]] || additional actions ||
|-
| {{ibmkey|Volume down|#494949}} || volume down || [[thinkpad-acpi]], [[#tpb configuration|tpb]], [[KMilo]] || additional actions ||
|-
| {{ibmkey|Volume mute|#494949}} || mute volume || [[thinkpad-acpi]], [[#tpb configuration|tpb]], [[KMilo]] || additional actions ||
|-
| {{ibmkey|Play/Pause|#494949}} || start/pause playback || [[#xmodmap configuration|xmodmap]] || full || {{X60s}} (Fn+Arrow Down)
|-
| {{ibmkey|Stop|#494949}} || stop playback || [[#xmodmap configuration|xmodmap]] || full || {{X60s}} (Fn+Arrow Up)
|-
| {{ibmkey|Next|#494949}} || play next || [[#xmodmap configuration|xmodmap]] || full || {{X60s}} (Fn+Arrow Right)
|-
| {{ibmkey|Previous|#494949}} || play previous || [[#xmodmap configuration|xmodmap]] || full || {{X60s}} (Fn+Arrow Left)
|-
| {{ibmkey|Power|#494949}} || shutdown || [[#ibm-acpi events|ibm-acpi]],[[thinkpad-acpi]] || full || triggered on pressing 3secs, but notebook goes off on 5sec press
|-
| Display lid || blank screen || [[#ibm-acpi events|ibm-acpi]], [[thinkpad-acpi]] || full ||
|-
| Ultrabay lid || announce ultrabay change || [[#ibm-acpi events|ibm-acpi]] || full ||
|-
| Dock eject || eject from dock || [[#ibm-acpi events|ibm-acpi]] || full ||
|-
| {{ibmkey|Tablet power|#494949}} || shutdown || [[#ibm-acpi events|ibm-acpi]] || full || triggered on pressing 3secs, but notebook goes off on 5sec press
|-
| {{ibmkey|Tablet orientation|#494949}} || rotates screen || [[#Mapping keys with setkeycodes|setkeycodes]] || full ||
|-
| {{ibmkey|Tablet shortcut|#494949}} || shortcut menu || [[#Mapping keys with setkeycodes|setkeycodes]] || full ||
|-
| {{ibmkey|Tablet Esc|#494949}} || esc key || [[#Mapping keys with setkeycodes|setkeycodes]] || full ||
|-
| {{ibmkey|Tablet Enter|#494949}} || enter key || [[#mapping keys with setkeycodes|setkeycodes]] || full ||
|-
| {{ibmkey|Tablet Up|#494949}} || up key || [[#Mapping keys with setkeycodes|setkeycodes]] || full ||
|-
| {{ibmkey|Tablet Down|#494949}} || down key || [[#Mapping keys with setkeycodes|setkeycodes]] || full ||
|-
| {{ibmkey|Tablet (unlabeled)|#494949}} || down key || [[#Mapping keys with setkeycodes|setkeycodes]] || full ||
|}

For completeness, note that the WiFi enable/disable switch is located (on the X61 and other models that have it) just under the front edge of the base of the machine. You should see a small horizontal slider switch. Enable by sliding it rightwards, disable by sliding it leftwards.

==Triggering key events==
===ibm-acpi/thinkpad-acpi events===
Some of the following events require a {{cmdroot|echo enable,0xffff >/proc/acpi/ibm/hotkey}} (when using ibm-acpi) in order to make acpi able to get information on them. Since the newer thinkpad-acpi has a larger number of bits that can be set in the mask, you might try {{cmdroot|echo enable,0xffffffff >/proc/acpi/ibm/hotkey}} if you are using this driver. These events can be used to [[How to configure acpid|configure acpid]].

{| {{prettytable}}
|+ events triggered by [[ibm-acpi]] for {{path|/etc/acpi/events}} files. May vary on different models.
! key !! event
|-
| {{key|Fn}}{{key|F1}} || ibm/hotkey HKEY 00000080 00001001
|-
| {{key|Fn}}{{key|F2}} || ibm/hotkey HKEY 00000080 00001002
|-
| {{key|Fn}}{{key|F3}} || ibm/hotkey HKEY 00000080 00001003
|-
| {{key|Fn}}{{key|F4}} || ibm/hotkey HKEY 00000080 00001004
|-
| {{key|Fn}}{{key|F5}} || ibm/hotkey HKEY 00000080 00001005
|-
| {{key|Fn}}{{key|F6}} || ibm/hotkey HKEY 00000080 00001006
|-
| {{key|Fn}}{{key|F7}} || ibm/hotkey HKEY 00000080 00001007
|-
| {{key|Fn}}{{key|F8}} || ibm/hotkey HKEY 00000080 00001008
|-
| {{key|Fn}}{{key|F9}} || ibm/hotkey HKEY 00000080 00001009
|-
| {{key|Fn}}{{key|F10}} || ibm/hotkey HKEY 00000080 0000100a
|-
| {{key|Fn}}{{key|F11}} || ibm/hotkey HKEY 00000080 0000100b
|-
| {{key|Fn}}{{key|F12}} || ibm/hotkey HKEY 00000080 0000100c
|-
| {{key|Fn}}{{key|Backspace}} || ibm/hotkey HKEY 00000080 0000100d
|-
| {{key|Fn}}{{key|Ins}} || ibm/hotkey HKEY 00000080 0000100e
|-
| {{key|Fn}}{{key|Del}} || ibm/hotkey HKEY 00000080 0000100f
|-
| {{key|Fn}}{{key|Home}}/{{key|Fn}}{{key|Pos1}} || ibm/hotkey HKEY 00000080 00001010
|-
| {{key|Fn}}{{key|End}} || ibm/hotkey HKEY 00000080 00001011
|-
| {{key|Fn}}{{key|PgUp}} || ibm/hotkey HKEY 00000080 00001012
|-
| {{key|Fn}}{{key|Space}} || ibm/hotkey HKEY 00000080 00001014
|-
| {{ibmkey|Volume up|#494949}}|| ibm/hotkey HKEY 00000080 00001015
|-
| {{ibmkey|Volume down|#494949}} || ibm/hotkey HKEY 00000080 00001016
|-
| {{ibmkey|Volume mute|#494949}} || ibm/hotkey HKEY 00000080 00001017
|-
| {{ibmkey|Access IBM|#495988}} or {{ibmkey|ThinkPad|#494949}} or {{ibmkey|ThinkVantage|#495988}} || ibm/hotkey HKEY 00000080 00001018
|-
| Ultrabay eject || ibm/bay MSTR 00000003 00000000
|-
| Ultrabay inserted || ibm/bay MSTR 00000001 00000000
|-
| Dock eject || ibm/dock GDCK 00000003 00000001
|-
| Wireless switch || ibm/hotkey HKEY 00000080 00007000
|}

By disassembling and editing the DSDT, more events can be added. HKEY events are triggered by calls to the MKHQ function, e.g. <tt>\_SB.PCI0.LPC.EC.HKEY.MHKQ(0Ã—1007)</tt> will trigger "ibm/hotkey HKEY 00000080 00001007". Most of these can be found in <tt>_Qxx</tt> methods within the DSDT, which are executed on embedded controller events, e.g. _Q10 is triggered by pressing Fn-F7. You can add a call to MKHQ into an existing <tt>_Qxx</tt> method to get it recognized by ibm-acpi as well as creating new <tt>_Qxx</tt> methods, which if you're lucky will correspond to an EC event that IBM never used (e.g. A 770 will send Fn-Home/End/PgUp/PgDn to ibm-acpi if hacked in this fashion). For example, [http://www.wormnet.eu/ibm-g40/morebuttons.dsl this is a modified block of DSDT for a G40].

=== ACPI events from the <tt>button</tt> module===

A few keys can generate ACPI events that result from the <tt>button</tt> kernel module, as long as they are masked off in the <tt>ibm-acpi</tt>/<tt>thinkpad-acpi</tt> hotkey's mask or the hotkey function of the latter module is disabled.

If you want the ThinkPad's BIOS and ACPI methods to know about these keys being pressed, you probably want to leave them masked out from ibm-acpi, and use their non-HKEY events listed below, instead.

{| {{prettytable}}
|+ events triggered by ACPI when hotkey is masked out or disabled.
! key !! event !! T60 event
|-
| {{ibmkey|Power|#494949}} || button/power PWRF 00000080 xxxxxxxx || button/power PWRF 00000080 00000001
|-
| {{key|Fn}}{{key|F4}} || button/sleep SLPB 00000080 00000001 || button/sleep SLPB 00000080 00000001
|-
| Display lid || button/lid LID 00000080 xxxxxxxx || button/lid LID 00000080 00000001
|}

===tpb configuration===
{| {{prettytable}}
|+ configuration keywords for [[tpb]] (to put in {{path|/etc/tpbrc}})
! key !! config keyword
|-
| {{ibmkey|Access IBM|#495988}} or {{ibmkey|ThinkPad|#494949}} || THINKPAD
|-
| {{ibmkey|Home|#494949}} || HOME
|-
| {{ibmkey|Search|#494949}} || SEARCH
|-
| {{ibmkey|Mail|#494949}} || MAIL
|-
| {{ibmkey|Favorites|#494949}} || FAVORITES
|-
| {{ibmkey|Reload|#494949}} || RELOAD
|-
| {{ibmkey|Abort|#494949}} || ABORT
|-
| {{ibmkey|Backward|#494949}} || BACKWARD
|-
| {{ibmkey|Forward|#494949}} || FORWARD
|-
| {{key|Fn}} || FN
|-
| {{key|Fn}}{{key|Space}} || CALLBACK (zoom on/off)
|-
| {{key|Fn}}{{key|PageUp}} || CALLBACK (thinklight on/off)
|-
| {{key|Fn}}{{key|F7}} || CALLBACK (display lcd/crt/both)
|-
| {{key|Fn}}{{key|F8}} || CALLBACK (expand on/off)
|-
| {{key|Fn}}{{key|Home}} / {{key|Fn}}{{key|Pos1}} || CALLBACK (brightness <percent>)
|-
| {{key|Fn}}{{key|End}} || CALLBACK (brightness <percent>)
|-
| {{ibmkey|Volume up|#494949}} || CALLBACK (volume <percent>)
|-
| {{ibmkey|Volume down|#494949}} || CALLBACK (volume <percent>)
|-
| {{ibmkey|Volume mute|#494949}} || CALLBACK (mute on/off)
|}

To all parameter keywords should be assigned the full path to the executables supposed to be started on key press.
The exectable provided for the CALLBACK keyword should take the parameters given in parentheses and act according to them.
If you want to use xmodmap for the HOME, SEARCH, MAIL, FAVORITES, RELOAD, ABORT, BACKWARD, FORWARD and FN keys you should
provide a <tt>XEVENTS OFF</tt> in your {{path|/etc/tpbrc}}.
You can use an appropriate executable to [[How to inject fake keystrokes|inject fake keystrokes]].

For Debian users, tpb is started from {{path|/etc/X11/Xsession.d/90tpb}}.

'''Sound Button configuration'''

''Note: Tested on T60p with Ubuntu 6.06 LTS''

Most Thinkpads have a hardware sound mixer, thus the volumes buttons should work without configuration. However, this change is not reflected in the software mixer. tpb has a switch to enable software mixer support via OSS. The manual recommends this only for devices without a hardware mixer, but it also works for other hadware mixer enabled devices, even with the ALSA system. Just put MIXER ON in your {{path|/etc/tpbrc}} file and you can see the effect immediately in any ALSA mixer (e.g. kmix). For this to work you need write permissions to {{path|/dev/nvram}}.

''Note: Tested on X21 with Ubuntu 6.06 LTS''

On the ThinkPad X21 (and maybe some other older models) ACPI causes problems with tpb. On an X21 using acpi the volume buttons would work occasionally, and the OSD for tpb functions would rarely work. If a volume buttons was pressed too often, sometimes the computer would enter a low power (unplugged state) and would require a reboot. The solution is to use APM instead of ACPI. Instructions can be found in [[How_to_make_APM_work]].

===KMilo configuration===
The programs to be executed by [[KMilo]] are configured via the KDE Control Center (<tt>kcontrol</tt>), under <tt>System Administration --> IBM Thinkpad Laptop</tt>. Note that you can use appropriate commands to [[How to inject fake keystrokes|inject fake keystrokes]].

===xmodmap configuration===
xmodmap enables you to edit the modifier map and keymap tables that are used to translate keycodes into keysyms.
Understood? Well, basically it allows you to give the X server a dictionary for the translation of keycodes like "97" into more human readable synonyms like "Home". This way xmodmap allows you to make the special keys of your keyboard known to X applications.

To discover the keycode that a certain keypress produces, use the tool {{cmduser|xev}}

Usually you should write your keycode-keysym associations into the file {{path|~/.Xmodmap}}. This file is usually read by the X session startup scripts of your system, so that the mappings automatically get included everytime you run the X server.

The {{path|~/.Xmodmap}} lines for our purpose are in the form of
keycode <keycode> = <keysym>

Load the assocation using the command

{{cmduser|xmodmap ~/.Xmodmap}}

(some configurations do this automatically upon X startup).

The following table shows the keycodes generated by the ThinkPad special keys and sensible keysyms to assign them to.
{| {{prettytable}}
|+ keycodes and recommended keysyms
! key !! keycode !! keysym
|-
| {{ibmkey|Access IBM|#495988}} or {{ibmkey|ThinkPad|#494949}} || 159 || XF86LaunchA
|-
| {{ibmkey|Backward|#494949}} || 234 || XF86Back or F19
|-
| {{ibmkey|Forward|#494949}} || 233 || XF86Forward or F20
|-
| {{ibmkey|Play/Pause|#494949}} || 162 || XF86AudioPlay
|-
| {{ibmkey|Stop|#494949}} || 164 || XF86AudioStop
|-
| {{ibmkey|Next|#494949}} || 153 || XF86AudioNext
|-
| {{ibmkey|Previous|#494949}} || 144 || XF86AudioPrev
|-

| {{ibmkey|Home|#494949}} || 178 || XF86HomePage
|-
| {{ibmkey|Search|#494949}} || 229 || XF86Search
|-
| {{ibmkey|Mail|#494949}} || 236 || XF86Mail
|-
| {{ibmkey|Favorites|#494949}} || 230 || XF86AddFavorite or XF86Favorites
|-
| {{ibmkey|Reload|#494949}} || 231 || XF86Reload
|-
| {{ibmkey|Abort|#494949}} || 232 || XF86Stop
|-
| {{key|Fn}} || 227 || F35
|}

Note: You can also use xkeycaps (an X tool to display and edit the X keyboard mapping) to generate proper .Xmodmap.

Note: if you are running [[tpb]] you might need to add the line <tt>XEVENTS=off</tt> into your tpbrc to stop it from grabbing the key events and allow them to get through to X instead. See [[http://www.thinkwiki.org/wiki/Tpb]] for more detailed instruction on how to use tpb and xmodmap.

Note: XF86Forward and XF86Back do not work correctly in Firefox. You may want to map them to F19 and F20 instead if you use Firefox.

Note: The "XF86AudioPlay" etc. just works with a few programs. To make it work with more multimedia programs you have map the key to use something like [http://www.kde-apps.org/content/show.php/ReMoot?content=63140 ReMoot]. ReMoot is a command line wrapper that control 18 of the most common multimedia applications.

=====Enabling the Windows and Menu Keys=====
On some systems the Windows and Menu keys may not be recognized. You can enable then by
making the following changes:

keycode 115 = F13
keycode 227 = F35

F13 and F35 are used for the Windows and and Menu keys respectively. Labelling keycpode 227 as "Menu" may conflict with the right-mouse-click event.

=====Using Caps Lock as Super L (Windows key)=====
You can easily use Caps Lock as Win key by adding the following in your ~/.Xmodmap:
! No Caps Lock
clear lock
! Caps Lock as Win key
add mod4 = Caps_Lock
=====NumLock=====
On the ThinkPad {{600}}, {{T20}}, {{T21}}, {{T22}}, {{T30}}, {{X20}}, {{X21}}, {{X31}}, {{X40}}, {{T42p}}, {{T43}}, {{R51}}, {{R52}} and possibly other models, X does not recognize the keycode for {{key|NumLk}} = {{key|Shift}}+{{key|ScrLk}}. To fix this, add the following to {{path|~/.Xmodmap}} in your home directory or {{path|/etc/X11/Xmodmap}} and run <tt>xmodmap</tt>, ex: <tt>xmodmap ~/.Xmodmap</tt>:
keycode 77 = Num_Lock

This configuration also enables the respective LED.

Please note, pressing the {{key|Shift}}+{{key|ScrLk}} key combination, without first following the above configuration, will start an accessibility feature, which will allow the numeric keypad to maneuver the mouse pointer. Starting this accessibility feature and subsequently running xmodmap, as described above, results in the accessibility feature and the numeric lock LED functioning simultaneously. As such, the above configuration should be completed before the accessibility feature is started in order to produce numbers.
======T60 (and possibly others)======
It seems that on the T60, PrtSc, ScrLk and Pause all generate the correct keycodes, however Fn-PrtSc (labelled as SysRq) generates keycode 64 (Alt_L) followed by the expected 111 (Sys_Req) on down and the same thing in the opposite order on release. Fn-ScrLk (labelled as NmLk) does indeed toggle the Numlock, but only seems to register as an X event the first time it is engaged. The above solution does not appear to work. This is perhaps because the Numlock toggle is built into the firmware rather than controlled by the kernel. Finally, Fn-Pause (labelled as Break) generates keycode 37 (Control_L) followed by the expected keycode 110 (Break) on down and the same thing in reverse order on release.

===Mapping keys with setkeycodes===
You can use the setkeycodes command to remap certain keys. I.e. you can use {{cmdroot|setkeycodes 6e 109 6d 104 69 28 6b 1}} to map the Tablets Up and Down keys to the standard PageUp and PageDown keys and Tablet Escape and Enter to their respective keys.

The following table shows the keycodes generated by the ThinkPad keys.
{| {{prettytable}}
|+ keycodes
! key !! keycode
|-
| {{ibmkey|Tablet orientation|#494949}} || 0x6d
|-
| {{ibmkey|Tablet Shortcut|#494949}} || 0x6e
|-
| {{ibmkey|Tablet Esc|#494949}} || 0x6b
|-
| {{ibmkey|Tablet Enter|#494949}} || 0x69
|-
| {{ibmkey|Tablet Up|#494949}} || 0x68
|-
| {{ibmkey|Tablet Down|#494949}} || 0x6c
|-
| {{ibmkey|Tablet (unlabeled)|#494949}} || 0x67
|}

===acpi_fakekey===
You can turn acpi events into user-level xevents by putting <tt>acpi_fakekey</tt> commands into the acpi action scripts. There are several layers involved in using acpi keys in this way, so I'll go through the example of using the ThinkVantage button to open xmms.

My ThinkVantage button generates an '''acpi event''' "ibm/hotkey HKEY 00000080 00001018", so we have the event file <tt>/etc/acpi/events/ThinkVantage</tt> for it which executes the script <tt>/etc/acpi/actions/fakekey-macro.sh</tt>.
<pre>
event=ibm/hotkey HKEY 00000080 00001018
action=/etc/acpi/actions/fakekey-macro.sh
</pre>
In turn, the executable <tt>/etc/acpi/actions/fakekey-macro.sh</tt> script calls acpi_fakekey with the '''key number''' defined in <tt>/usr/share/acpi-support/key-constants</tt> as $KEY_MACRO which is 112 (you could just as well choose an other key number, just make sure that it doesn't belong to something else like the "j" key or something).
<pre>
#!/bin/sh
. /usr/share/acpi-support/key-constants
acpi_fakekey $KEY_MACRO
</pre>
I have no idea how this actually corresponds to which xevent is generated, so I can find out out by running the program <tt>xev</tt> and hitting the ThinkVantage button while the mouse is in the <tt>xev</tt> window (remember to <tt>/etc/init.d/acpid restart</tt> first if you just created the <tt>/etc/acpi/events/ThinkVantage</tt> file). I get something popping up in the terminal where I ran xev that looks like this:
<pre>
KeyPress event, serial 30, synthetic NO, window 0x2800001,
root 0x6a, subw 0x0, time 2000522842, (138,83), root:(781,500),
state 0x0, keycode 239 (keysym 0x0, NoSymbol), same_screen YES,
XLookupString gives 0 bytes:
XmbLookupString gives 0 bytes:
XFilterEvent returns: False

KeyRelease event, serial 30, synthetic NO, window 0x2800001,
root 0x6a, subw 0x0, time 2000522842, (138,83), root:(781,500),
state 0x0, keycode 239 (keysym 0x0, NoSymbol), same_screen YES,
XLookupString gives 0 bytes:
XFilterEvent returns: False
</pre>
This tells me that the <tt>acpi_fakekey 112</tt> as executed by hitting the ThinkVantage button generates KeyPress event followed by a KeyRelease event with '''keycode''' 239 and that this keycode has been assigned no corresponding '''keysym'''. Thus, I am free to assign the keycode to any keysym I want. You can find a list of available keysyms in <tt>/usr/share/X11/XKeysymDB</tt>. Again try and pick one that is not likely to have already been taken by something, such as <tt>XF86LaunchA</tt>. To assign this keysym to keycode 239, you can either edit ~/.Xmodmap on an individual user basis, or edit the systemwide <tt>/etc/X11/Xmodmap</tt> file to contain the line
<pre>
keycode 239 = XF86LaunchA
</pre>
If you choose to go with the former, you may need to run <tt>xmodmap ~/.Xmodmap</tt> for every login session in order to read in your ~/.Xmodmap file if your window manager does not do it for you. Regardless of which option you choose, you can run <tt>xmodmap <file></tt> to read in the updated Xmodmap file without logging out and logging back in.

You should now find that hitting the ThinkVantage button creates the following output from <tt>xev</tt>:
<pre>
KeyPress event, serial 55, synthetic NO, window 0x2800001,
root 0x6a, subw 0x0, time 2001286078, (0,106), root:(643,523),
state 0x0, keycode 239 (keysym 0x1008ff4a, XF86LaunchA), same_screen YES,
XLookupString gives 0 bytes:
XmbLookupString gives 0 bytes:
XFilterEvent returns: False

KeyRelease event, serial 55, synthetic NO, window 0x2800001,
root 0x6a, subw 0x0, time 2001286078, (0,106), root:(643,523),
state 0x0, keycode 239 (keysym 0x1008ff4a, XF86LaunchA), same_screen YES,
XLookupString gives 0 bytes:
XFilterEvent returns: False
</pre>
Note the change of <tt>(keysym 0x0, NoSymbol)</tt> to <tt>(keysym 0x1008ff4a, XF86LaunchA)</tt>.

You're now ready to map <tt>XF86LaunchA</tt> to executing xmms. This is highly dependent on what keygrabber you decide to use. For openbox, I edit my <tt>~/.config/openbox/rc.xml</tt> file and add the following entry in the <keyboard> section:
<pre>
<keybind key="XF86LaunchA">
<action name="Execute">
<startupnotify>
<enabled>true</enabled>
</startupnotify>
<command>
xmms
</command>
</action>
</keybind>
</pre>
After, right clicking on the desktop and selecting the "Reconfigure" menu option, you should then have xmms pop up when you hit the ThinkVantage key.

==Example Applications==
===Web Browsers===
====Firefox (<3.0)====

There are various ways to assign actions to the browser keys. The easiest way is to install [http://mozilla.dorando.at/keyconfig.xpi keyconfig.xpi] from http://mozilla.dorando.at, which adds a menu entry Tools->Keyconfig. Then you can assign any action you want to the F19/F20 keys (you still need to create {{path|~/.Xmodmap}} as explained above).

The remaining discussion gives you various more complicated ways to achieve the same thing.
To have firefox make use of the browser keys you need to modify one of its files{{footnote|4}}.
To do this you will first need to extract it from the {{path|browser.jar}} archive. Do...

Step 1: Edit .Xmodmap and add entries for F19 and F20 as explained above.

Step 2:

Note: <firefox-directory> is probably /usr/lib/firefox. Use your version so, if you have 3.0.1 or 3.0.2 use /usr/lib/firefox-3.0.1

:{{cmdroot|cd <firefox-directory>/chrome}} 
:{{cmdroot|unzip browser.jar}}

The file of interest is {{path|content/browser/browser.xul}}. Edit it {and don't forget to make a backup copy first}...
:{{cmdroot|vi content/browser/browser.xul}}

Look for the '''<keyset id="mainKeyset">''' section and add the following lines within...
<key id="goBackKb" keycode="VK_F19" command="Browser:Back" />
<key id="goForwardKb" keycode="VK_F20" command="Browser:Forward" />

The Command you need for Next Tab
<key id="goBackTabKb" keycode="VK_F19" oncommand="gBrowser.mTabContainer.advanceSelectedTab(-1)" />
For the Previous Tab
<key id="goForwardTabKb" keycode="VK_F20" oncommand="gBrowser.mTabContainer.advanceSelectedTab(1)" />

Now save the file and repackage the {{path|browser.jar}} archive...
:{{cmdroot|zip -rD0 browser.jar content/browser/}}

That's it.

Step 3: Restart Firefox.

{{HINT|Outdated: Another interesting Page on Firefox is http://dqd.com/~mayoff/notes/thinkpad/dqdnavkeys/ It uses different key mappings (F19 resp. F20) but a ready [http://dqd.com/~mayoff/notes/thinkpad/dqdnavkeys/dqdnavkeys-1.2.xpi .xpi] is provided which is pretty comfortable. However, this xpi file does not install on Firefox 1.5. or later.}}

{{HINT| You can also use the [http://extensionroom.mozdev.org/more-info/keyconfig keyconfig] extension to configure custom keys. This extension works with Firefox 1.5 and also with Firefox 2.0. The Command you need for Next Tab is gBrowser.mTabContainer.advanceSelectedTab(1,true); For Previous Tab its gBrowser.mTabContainer.advanceSelectedTab(-1,true); You can alternatively install the [http://www.pqrs.org/~tekezo/firefox/extensions/functions_for_keyconfig/index.html functions for keyconfig] and set the variable f4kc_NextTab to F20 and f4kc_PrevTab to F19.}}.

====Firefox 3.0====
Thankfully the people at Mozilla decided to include the expected functionality for the XF86Back and XF86Forward keysyms in the new release so all you need to do is
 <code># printf 'keycode 234 = XF86Back\nkeycode 233 = XF86Forward' >> /etc/X11/Xmodmap</code> 
And to make this take effect immediately (i.e., without having to log out and log in again), as a regular user run:
 <code>{{cmduser|Xmodmap /etc/X11/Xmodmap}}</code>

For Hardy Heron, the xmodmap command is all lowercase. Also, the /etc/X11/Xmodmap file is not being read on boot. I've added the command to my .bashrc to have it called on startup.

====Konqueror====
KDE allows you set key mappings for KDE applications (Go to KMenu > System > Control Center > Regional & Accessibility > Keyboard Shortcuts). By default (at least in KDE 3.5), XF86Back and XF86Forward are set as alternatives to Alt-Left and Alt-Right, and are mapped to KDE Back and Forward navigation actions.

If you use Konqueror as your only browser, you only need to set up {{path|~/.Xmodmap}} as described [[#xmodmap configuration|above]] to assign ThinkPad back/forward keys to the symbols XF86Back/XF86Forward. This also make these keys work for other KDE applications such as Quanta Plus, KPackage and so on (not all KDE applications honor this setting, e.g. KDE help system doesn't).

If you want to use Firefox, however, the above settings do not work. You will have to map ThinkPad back/forward keys to F19/F20 as described [[#Firefox|above]], and change KDE navigation key settings to use F19/F20 instead of the default.

====Opera====
However this isn't a simple configration file, you can set your browser manually. 
Go to Tool > Settings > Mouse and keyboard > Keyboard settings > Edit > Browser Window. There add F19 - Back and F20 - Forward. Now you can surf using your TP keys ;-)

====Epiphany====
To get the keys work in epiphany, you could use the extension from [http://crashman.homelinux.org/~andre/public/epiphany%20extensions/thinkpad%20browserkeys/ here]
You just need to edit your Xmodmap like described for Firefox < 3.0 (bind the keys on F19 and F20)

===Open an application===

To configure the ThinkVantage button to open a terminal window in Gnome:

Step 1:
Use xev to find the keycode generated by the button on your machine. In my case is is 159.

Step 2:
Create an entry in .Xmodmap like so

keycode 159 = XF86LaunchA

replacing 159 by the keycode found in step 1. Load the map using

:{{cmd|xmodmap ~/.Xmodmap}}

Step 3:
Configure the required function (e.g. open terminal window) in System->Preferences->Keyboard shortcuts

===Window Managers===
====fvwm====
To get the {{ibmkey|Forward|#494949}} and {{ibmkey|Backward|#494949}} keys to cycle through pages in the virtual desktop, add this to your {{path|~/.fvwmrc}}:
Key XF86Back A A Scroll -100000 0
Key XF86Forward A A Scroll +100000 0
If you use multiple virtual desktops, you could instead use the keys to flip between them by using GotoDesk.

====fluxbox====
To get the keys to cycle through pages in the virtual desktop, add this to your {{path|~/.fluxbox/keys}}:
None F19 :PrevWorkspace
None F20 :NextWorkspace

====pekwm configuration====
You can make the two browser keys switch workspaces in pekwm, by adding the following two lines to the {{path|~/.pekwm/keys}} file:
KeyPress = "Mod1 XF86Back" { Actions = "GoToWorkspace prev" }
KeyPress = "Mod1 XF86Forward" { Actions = "GoToWorkspace next" }

====pwm====
Another example how to use these two keys to switch between pwm tabs. These two lines should be added to {{path|~/.pwm/keys-default.conf}} or {{path|/etc/pwm/keys-default.conf}}:
kbind "Back", "switch_rot", -1
kbind "Forward", "switch_rot", 1

====IceWM====
To make IceWM cycle workspaces using the {{ibmkey|Forward|#494949}} and {{ibmkey|Backward|#494949}} keys, change these two options in {{path|~/.icewm/preferences}} (Provided you assigned keysyms F19 and F20 with xmodmap):
# "Previous workspace" shortcut
KeySysWorkspacePrev="F19"
# "Next workspace" shortcut
KeySysWorkspaceNext="F20"

==== Gnome/metacity ====

Follow the [https://wiki.ubuntu.com/Keybindings Ubuntu guide].

===Other Uses===
====Console tools configuraton====
To make the {{ibmkey|Forward|#494949}} and {{ibmkey|Backward|#494949}} keys useful in console, add this to your keymap ({{path|/etc/console/boottime.kmap.gz}} in {{Debian}}):
keycode 158 = Decr_Console
keycode 159 = Incr_Console

Alternatively you can load this script (perhaps on system startup) to enable Backward/Forward button console (VT) switch:

#!/bin/sh
echo keycode 158 = Decr_Console | loadkeys
echo keycode 159 = Incr_Console | loadkeys

It should work with any distro.

====Cycling through tabs====
In Gnome and Xfce4, Ctrl-PageUp/Ctrl-PageDown move to the previous/following open tab in all applications that have tabbed user interfaces (terminal emulator, web browser, ...). To make use of the {{ibmkey|Forward|#494949}} and {{ibmkey|Backward|#494949}} keys for this task, there're two possibilities.

For both ways, you should map the keycodes 233 and 234 to XF86Back and XF86Forward as described in [[#xmodmap_configuration|xmodmap configuration]].

=====Using xautomation=====
xautomation can be found [http://hoopajoo.net/projects/xautomation.html here].

Create two files with permissions 755:

{{path|/usr/local/bin/tp_back}}:
<bash>
#!/bin/bash
/usr/bin/xte 'keydown Control_L' 'keydown Page_Up' 'keyup Page_Up' 'keyup Control_L'
</bash>

{{path|/usr/local/bin/tp_forward}}:
<bash>
#!/bin/bash
/usr/bin/xte 'keydown Control_L' 'keydown Page_Down' 'keyup Page_Down' 'keyup Control_L'
</bash>

Use your desktop's keyboard shortcut editor to assign XF86Back as a shortcut for tp_back and XF86Forward as a shortcut for tp_forward.

This should work in all distros and with all window managers (you might have to use other key combinations than Ctrl-PageUp and Ctrl-PageDown).

=====Redirecting XF86Back/XF86Forward=====
Create {{path|/etc/X11/xkb/compat/thinkpad}}:
<pre>
// $XFree86$
// XFree86 special keysyms
default partial xkb_compatibility "basic" {
interpret.repeat= True;

interpret XF86Back {
action = Redirect(Key=<PGUP>, modifiers=Control);
};
interpret XF86Forward {
action = Redirect(Key=<PGDN>, modifiers=Control);
};
};
</pre>

Edit {{path|/etc/X11/xkb/compat/complete}} and add <tt>'''augment "thinkpad"'''</tt> so that it looks similar to the following:
<pre>
// $XKeyboardConfig: xkbdesc/compat/complete,v 1.3 2005/10/17 00:42:11 svu Exp $
// $Xorg: complete,v 1.3 2000/08/17 19:54:34 cpqbld Exp $
default xkb_compatibility "complete" {
include "basic"
augment "iso9995"
augment "mousekeys"
augment "accessx(full)"
augment "misc"
augment "xfree86"
augment "level5"
augment "thinkpad"
};
</pre>

==External Sources==
*[http://www-307.ibm.com/pc/support/site.wss/document.do?lndocid=MIGR-51537 IBMs page on configuring the ThinkPad buttons (ThinkPad, Access IBM, Mail, Search, and Home buttons) under Linux]
*[http://dqd.com/~mayoff/notes/thinkpad/dqdnavkeys/ Rob Mayoffs page on using IBM Keyboard Navigation Keys in Linux Mozilla and Firefox]
*[http://snarfed.org/space/thinkpad+keys+in+firefox Ryan Barretts blog article about using the browser keys in Firefox]
*[http://chaotika.org/~bluesceada/?page=soft&sub=thinkpad#acpibutn DennisG's help to get the ibm-acpi buttons do useful things] on a {{Z61e}} and possibly {{Z61m}}, {{Z61t}} and {{Z61p}}

{{footnotes|
#Note that the associated functionality for Fn-F* key combinations is not consistent amongst all ThinkPads. We are maintaining [[Default meanings of special keys|a table of associated meanings]].
#if there are more than one tool listed, one is sufficient
#'full' means you can completely reassign any action to be triggered by the key, 'additional actions' means you can trigger actions in addition to the standard function of the key, which can not be changed.
#Thanks go to Ryan Barrett for writing the [http://snarfed.org/space/thinkpad+keys+in+firefox little howto] on [http://snarfed.org/space/start his blog].
}}

Problem with unauthorized MiniPCI network card

2008-02-12T20:52:16Z

Rkan: /* Successful BIOS Modifications */

==Problem Description==
Although the MiniPCI slot is an industry standard and can accept any MiniPCI adapter, the IBM BIOS is set to only allow you to boot with an 'authorized' adapter installed. Attempts to install an unsupported card will result in the following message:

1802: Unauthorized network card is plugged in - Power off and remove the miniPCI network card.

This is because the card's sub-vendor PCI-ID (which can be seen using ''lspci -v'') are checked against a [[Wikipedia:Whitelist|whitelist]] in the BIOS. IBM's reasoning for this is that the combination of MiniPCI card and the integrated antenna in the ThinkPad needs to be certified by the US FCC (Federal Communications Commission).{{footnote|1}} or similar agencies in other countries.

==Affected Models==
All machines with integrated WiFi, or machines with WiFi added

==Affected Operating Systems==
All - problem is in the BIOS

==Status==
* Workarounds exist for most affected models.

==Solutions==
It may be possible to use the computer with the unauthorized card deactivated (but not removed). Press {{key|F1}} to enter the BIOS and deactivate the WLAN card, then attempt to boot with the card disabled. This does not make the wireless card work, but it may allow you to boot the computer normally.

{{NOTE|Any of the following solutions should suffice to make the wireless card useable. You only need to perform one of them.}}

* You may can modify the BIOS whitelist to include the PCI-ID of the card you wish to use. The complete instructions for this procedure are [http://www.paul.sladen.org/thinkpad-r31/wifi-card-pci-ids.html here].
{{WARN|It is dangerous to mess with your BIOS, you can easily make your machine unbootable, proceed with caution!}}

* A safer and better method than modifying the BIOS is modifying the PCI-ID of the wlan card to match the authorized one(why? 1.you'll risk the wireless card instead of the motherbord 2.future BIOS updates will not create any problem 3.no problem with newer laptops with different BIOS, the only reqirement is to find an ID that is already listed in the BIOS that can be easily acheived if community maintain a compatibility table). The instructions are [http://www.dagarlas.org/stuff/computing/article0001.php here]. This page is for Atheros-based cards and HP notebooks, but it applies to Thinkpads as well. It also has links on how to edit the PCI-ID on Intel Pro Wireless cards.
Instruction for intel 2200/2915 cards are [http://stachon.webpark.cz/ipw-eeprom.html here].
{{NOTE|Modifying your PCI-ID will require either a laptop without a BIOS lock or a PCI adapter for your desktop. Also, this procedure can render your card useless, but that's better than bricking your laptop.}}

* You can use the [[Problem with error 01C9 - More than one Ethernet devices | no-1802 and no-01C9 Linux Live CD]] without applying the no-01C9 patch. It is very convenient to use and based on the C code below.

* You can use the DOS [http://jcnp.pku.edu.cn/~shadow/1802/no-1802.com no-1802] utility, written by Tisheng Chen.{{footnote|2}} It will set a certain bit in the CMOS memory which disables the whitelist check, but it has been reported not to work on the latest machines, such as the T43 and X41

* You can compile and run (as root) the following C-code, which was written by Matthew Garrett. It was based on the code written by Vojtech Pavlik, which in turn was based on the assembly used in the no-1802 program. {{footnote|3}}

<code>
#include <stdio.h>
#include <sys/types.h>
#include <unistd.h>
#include <sys/stat.h>
#include <fcntl.h>

int main(void)
{
int fd;
unsigned char data;

fd = open("/dev/nvram", O_RDWR);
if (fd==-1) {
printf("Opening /dev/nvram failed\n");
return 1;
}
printf("Disabling WiFi whitelist check.\n");

/* BIG INFORMATIONAL WARNING */
/* The linux nvram driver doesn't give access to the first 14 bytes of
the CMOS. As a result, we seek to 0x5c rather than 0x6a. If you're
implementing this under another OS, then you'll have to go to whichever
address is appropriate for your access method */

lseek(fd, 0x5c, SEEK_SET);
read(fd, &data, 1);
printf("CMOS address 0x5c: %02x->", data);
data |= 0x80;
printf("%02x\n", data);
lseek(fd, 0x5c, SEEK_SET);
if (write(fd, &data, 1)<0) {
printf("Unable to write to /dev/nvram - hack failed\n");
close(fd);
return 2;
}
close(fd);
printf("Done.\n");
return 0;
}

</code>
{{NOTE|On the R32, T43, X41, X60 and probably others, the BIOS hacks and the "no-1802" utility don't work.}}

==Successful BIOS Modifications==
{{WARN|This table is meant to give users an idea of what models have been successfully modified and how. As stated before, it is dangerous to mess with your BIOS, you can easily make your machine unbootable. Please proceed with caution!}}

The following table contains information about ThinkPad models that have been successfully modified to run an unauthorized Mini PCI card. {{footnote|4}}

{| align="center" cellpadding="2" width="100%" style="border:1px; background:grey;"
! style="background:#efefef;"| Model
! style="background:#efefef;"| Type
! style="background:#efefef;"| BIOS Version
! style="background:#efefef;"| Operating System
! style="background:#efefef;"| Method
! style="background:#efefef;"| Success
|- style="background: white;"
| ThinkPad 240
| 2609-21G
| 1.18
| Damn Small Linux
| Matthew Garrett code {{footnote|3}}
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad G40
| 2388-2UU
| 1.21 (2006/2/24; 1TETA6WW)
| Windows XP Home
| no-1802 DOS 6.22 floppy
! style ="color:green;"| Yes
|- style="background: white;"
| ThinkPad R31
| 2656-6FG
| 3.11 (12-01-2004)
| Windows XP Boot Disk
| no-1802 utility
! style ="color:green;"| Yes
|- style="background: white;"
| ThinkPad R32
| 2656-EG1
| 2.16 (16-06-2006)
| DOS Boot Disk
| no-1802 utility
! style ="color:red;"| No
|- style="background: white;"
| ThinkPad R40
| 2656-69U
| ?
| Windows 2000 Pro
| no-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad R40
| 2681-F7G
| n/a
| Windows XP Pro SP2 w/ Intel 2200BG
| No-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad R40
| 2682
| ?
| Debian Etch
| Matthew Garrett code
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad R40
| 2896-J3U
| 1.24 (10-18-2005)
| Fedora Core 4
| Vojtech Pavlik code
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad R40
| 2681-L7U
| 1.24 (10-18-2005)
| Windows XP Pro
| no-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad R40
| 2722-BDG
| 1.33
| Windows XP Pro
| no-1802 Linux Live CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad R40e
| 2684-LKG
| ?
| Windows XP Pro
| no-1802 DOS boot CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad R40
| 2681-CDG
| 1.27 (10-06-2006)
| Windows XP Pro
| no-1802 LiveCD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad R40
| 2722-DM2
| 1.09 (2003)
| Windows XP Pro
| no-1802 LiveCD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad R40
| 2681-CFM
| 1.24 (10-17-2005)
| Gentoo & XP Pro
| no-1802 utility (boot from USB key to apply)
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad R40
| 2724
| 1.30 (10-19-2005)
| FreeBSD 6.1-p1
| code by Matthew Garrett, compiled and run on bactrack
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad R40
| 2724-3XU
| 1.33 (06-29-2006)
| Windows XP Pro
| no-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad R40
| 2682
| 1.01 (2003-01-24)
| Debian GNU/Linux etch (March 2007)
| Matthew Garret's code
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad R40
| 2722-BDG
| 1.33 (2006/6/29)
| Lunar Linux (2007/03/04)
| Matthew Garret's code
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad R50
| 1829-7RG
| 3.21 (02-06-2006)
| Windows XP Pro
| no-1802 Linux Live CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad R50p
| 1832-2AG
| 3.19 (13-10-2005)
| Ubuntu 5.10 (kernel 2.6.12-10-686)
| Vojtech Pavlik code
! style ="color:green;"| Yes
|- style="background: white; color:black;"
|ThinkPad R51
| 2887-W2C
| 1.27 (03-03-2006)
| Windows XP Pro SP2
| no-1802 utility (boot from USB key to apply)
! style ="color:green;"| Yes
|- style="background: white; color:black;"
|ThinkPad R52
| 1849-BMU
|1.27 (09-20-2006)
| Windows XP Pro SP2
| no-1802 utility (boot from external USB floppy)
! style ="color:red;"| No
|- style="background: white; color:black;"
|ThinkPad T23
| 2647-4MU
| 1.18 (08-06-2004)
| Windows XP Pro/SP2
| no-1802 utility (W98se-bootfloppy)
! style ="color:green;"| Yes
|- style="background: white; color:black;"
|ThinkPad T30
| 2366-68G
| 2.09 (08-08-2005)
| Windows XP Pro
| no-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
|ThinkPad T30
| 2366-ES1
| 2.10
| Windows XP Pro
| no-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T30
| 2366-97G
| 2.09 (08-08-2005)
| Windows XP Pro
| no-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T30
| 2366-N6G
| 2.09 (08-08-2005)
| Windows XP Pro
| no-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T30
| 2366-N6G
| 2.10 (26-06-2006)
| Windows XP Pro
| no-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T30
| 2366-81U
| 2.10 (27-06-2006)
| Windows XP Pro
| no-1802 Linux Live CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T30
| 2366-86U
| 2.10 (27-06-2006)
| Windows XP Pro SP 2
| no-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T30
| 2366-86G
| 2.10 (27-06-2006)
| Windows XP Pro SP 2 and Ubuntu 7.10 "Gutsy Gibbon" Intel BG2200
| no-1802 Linux Live CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T30
| 2366-DU9
| 2.10 (27-06-2006)
| Suse Linux 10.1
| no-1802 Linux Live CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T40
| 2373-7CU
| 3.21
| Windows XP Pro
| no-1802 Linux Live CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T40
| 2373-4BG
| 3.21
| Windows XP Pro SP2
| no-1802 Linux Live CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T40
| 2373-7CU
| 3.21 (06-02-2006)
| Windows XP Pro SP2
| no-1802 Linux Live CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T40
| 2373-75U
| 3.21 (09-12-2006)
| Fedora 6 w Intel 2915ABG
| no-1802 Linux Live CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T40
| 2373-82U
| 3.18 (09-15-2005)
| Windows XP/ SUSE 10.1
| No-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T40
| 2373-8CG
| 3.05a (2004-05-14)
| Arch Linux
| No-1802 LiveCD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T40
| 2373-8CG
| 3.15 (2005-03-29)
| Windows XP Pro SP2 w/[http://www.giga-byte.com.tw/Products/Communication/Products_Spec.aspx?ClassValue=Communication&ProductID=985&ProductName=GN-WI01GS Gigabyte GN-WI01GS]
| No-1802 LiveCD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T40
| 2373-PU7
| 3.21 (09-12-2006)
| Windows XP Professional
| No-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T40
| 2373-42G
| 3.20 (11-05-2006)
| Windows 2000 Pro
| no-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T40
| 2374-8CG
| 3.20 (11-05-2006)
| Ubuntu 6.06 LTS w/Intel Pro Lan2200
| no-1802 Linux Live CD
! style ="color:green;"| Yes
|- style="background: white; coloar:black;"
| ThinkPad T40
| 2374-DG1
| 3.21 (06-02-2006)
| Ubuntu 6.10 w/Broadcom 4306
| Matthew Garrett's code
! style ="color:green;"| Yes
|- style="background: white; coloar:black;"
| ThinkPad T40p
| 2373-G1G
| 3.19 (10-13-2005)
| Debian GNU/Linux (sid)
| no-1802 Linux Live CD
! style ="color:green;"| Yes
|- style="background: white; coloar:black;"
| ThinkPad T40p
| 2373-G5G
| 3.21 (2006-06-02)
| Windows XP Pro SP2 / Gentoo 2007.0
| no-1802 Linux Live CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T41
| 2373-1FG
| 3.21 (2007-06-18)
| Windows XP Pro SP2
| no-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T41
| 2373-5G1
| 2004
| Fedora Core 6 w/Intel Pro 2915ABG a/b/g
| no-1802 Linux Live CD
! style ="color:green;"| Yes
|- style="background: white; coloar:black;"
|ThinkPad T41
| 2373-9HU
| n/a
| Ubuntu 6.10 w/Atheros 5212 a/b/g
| no-1802 Linux Live CD
! style="color:green;"| Yes
|- style="background: white; color:black;"
|ThinkPad T41
| 2373-2FG
| n/a
| Windows XP Pro SR2 w/ Intel 2200BG
| no-1802 utility
! style="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T41p
| 2373-GEG
| BIOS Build ID: 1RETDOWW(3.20)
| Gentoo / XP pro SP2
| Matthew Garrett's code {{footnote|3}}
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T41p
| 2374-GGU
| 3.21 (1RETDPWW) 6/2/2006
| Slackware / XP pro SP2
| Matthew Garrett's code
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T41
| 2373-K32
| BIOS Build ID: 1RETDOWW(3.20)
| CentOS 5.0 w/Atheros 5212 (CM9)
| Matthew Garrett's code
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T42
| 2373-6UU
| Not noted
| Fedora 7 w/Atheros 5212
| Matthew Garrett's code
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T42
| 2373-4TG
| 3.13 (1RETDHWW) (29-10-2004)
| Windows XP Pro SP2 w/ Intel PRO 2200BG
| no-1802 Linux Live CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T42p
| 2373-HTU
| 3.23 (1RETDRWW) (06-18-2007)
| Windows XP Pro SP2 w/ Intel 2915ABG
| No-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T42
| 2373-K2G
| 3.17 (07-27-2005)
| Windows XP Pro SP2 w/ Intel 2915ABG
| No-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T42
| 2373-M1U
| 3.13 1RETDHWW (10/29/2004)
| Fedora 7 w/ Intel PRO 2200BG
| Matthew Garrett's code
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T42
| 2373-LM1
| 3.23 (1RETDRWW) (06-18-2007)
| Debian Lenny (2.6.21-2-686) w/ Intel PRO 2915ABG
| Matthew Garrett's code
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T42
| 2378-EXU
| 3.18 (09-15-2005)
| Windows XP Pro SP2
| No-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad T43
| 1871-F1G
| 1.19 (70ET59WW) (2005-09-20)
| n/a
| no-1802 Linux Live CD
! style ="color:red;"| No
|- style="background: white; color:black;"
| ThinkPad X22
| 2662-95G
| 1.32 (2003-06-10)
| Debian GNU/Linux testing, kernel 2.6.18-3-686
| Matthew Garrett's code
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad X30
| AR5212
| ?
| Debian Linux 2.6.18-5
| Matthew Garrett's code
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad X30
| 2672-41j
| 1.08 (08-09-2005)
| Gentoo Kernel 2.6.15
| no-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad X30
| 2672-4XU
| 1.09
| Win XP Pro SP2
| no-1802 Linux Live CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad X30
| 2673-EU2
| 1.09
| Windows XP Pro SP2
| no-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad X31
| 2672-C2G
| 3.02 (22-09-2005)
| Debian Etch (Testing), Kernel 2.6.22-rc7
| no-1802 utility
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad X31
| 2672-PG9
| 2.04 (2003-11-10)
| Debian Etch (Testing), Kernel 2.6.21-2
| Matthew Garrett's code
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad X31
| 2673-C27
| 3.02 (22-09-2005)
| Ubuntu 5.10 (kernel 2.6.12-9-386)
| Matthew Garrett code {{footnote|3}}
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad X31
| 2672-1UG
| 3.02 (22-09-2005)
| FreeBSD 6-STABLE
| no-1802 Linux Live CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad X31
| 2672-CEG
| 3.02 (22-09-2005)
| Debian Etch (Testing), Kernel 2.6.17-2-686
| no-1802 Linux Live CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad X31
| 2672-CXU
| 2.04
| Windows XP Pro
| no-1802 DOS boot CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad X31
| 2672-PBU
| 3.02
| Windows XP Pro
| no-1802 DOS boot CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad X31
| 2672-I5A
| 3.02
| Windows XP Pro
| no-1802 DOS boot CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad X31
| 2672-C8G
| 3.02
| Debian (kernel 2.6.16.20-386)
| Matthew Garrett code {{footnote|3}}
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad X31
| 2672-CEG
| 2.11 (02/13/2004)
| Debian (kernel 2.6.18-4-686, gcc 4.1.2)
| Matthew Garrett code {{footnote|3}}
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad X31
| 2884-BRU
| 1.03 (1QET34WW) 2003-04-08
| Windows XP Pro SP2 w/ Intel 2915ABG
| no-1802 DOS boot CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad X40
| 2371-8EU
| 1.42 (2004/09/16; 1UET92WW)
| Windows XP Pro
| no-1802 Linux Live CD
! style ="color:green;"| Yes
|- style="background: white; color:black;"
| ThinkPad X41
| 1866-6SU
| ?
| Windows XP Pro
| no-1802 DOS boot CD
! style ="color:red;"| No
|- style="background: white; color:black;"
| ThinkPad X41
| 2525-A2U
| 2.06 (2006/03/14; 74ET61WW)
| Windows XP Pro
| no-1802 Linux Live CD
! style ="color:red;"| No
|- style="background: white; color:black;"
| ThinkPad X41
| 2528-ELU
| 2.06 (2006/03/14; 74ET61WW)
| Windows XP Pro / OSX 10.4.8 / Ubuntu Edgy
| no-1802 Linux Live CD
! style ="color:red;"| No
|- style="background: white; color:black;"
| ThinkPad X60s
| 1702-3JU
| ?
| Debian Testing
| Matthew Garrett's code
! style ="color:red;"| NO (bricked)
|-
|}

==External Sources==
* Additional Information about "Unauthorised" MiniPCI adapters can be found on [http://www.srcf.ucam.org/~mjg59/thinkpad/wireless.html Matthew Garrett's website].

* Thinkpad Mini PCI Wireless [http://www.srcf.ucam.org/~mjg59/thinkpad/tables.html compatibility matrix].

* Bootable "no-1802" [http://www.command-tab.com/2006/02/26/unauthorized-wireless-cards/ CD and floppy image]

{{footnotes|
#This is explained in a [http://lkml.org/lkml/2003/6/3/162 message to the LKML] and subsequently [http://lkml.org/lkml/2003/6/9/50 clarified].
#The no-1802 tool was announced and explaned in a [http://mailman.linux-thinkpad.org/pipermail/linux-thinkpad/2004-June/018253.html message to the Linux-Thinkpad ML].
#Vojtech Pavlik's C-code was originally posted in a [http://lkml.org/lkml/2004/6/13/69 message to the LKML]. It was based on the assembly used in the no-1802 program. Matthew Garrett [http://www.srcf.ucam.org/~mjg59/thinkpad/hacks.html rewrote] the code to provide more error checking.
#This information has been added by users. Please feel free to add systems if you have had personal success or failure.
}}