Installing Ubuntu 11.04 (Natty Narwhal) on a ThinkPad X220
I installed Ubuntu 11.04 (Natty Narwhal) on a ThinkPad X220, model 42902GW.
I have since upgraded to Ubuntu 11.10 (Oneiric Ocelot) and have updated some of the information below accordingly.
Contents
Netboot
As a source of network installation files I made use of another GNU/Linux computer on my home LAN which is connected to the Internet through a familiar ADSL-modem/gateway/router/caching nameserver/DHCP server (call it "the gateway") at address 172.19.3.1. The gateway's DHCP server issues leases in the range 172.19.3.2 to 172.19.3.100.
First I set up the "source" machine, in my case one which already also had Ubuntu 11.04 installed. It has address 172.19.3.7 (assigned to it by the gateway's DHCP server). For the X220 to boot from it the machine needs to run a DHCP server and a TFTP server. The DHCP server serves only this special purpose since, as I mentioned, the gateway is the network's main DHCP server. The source's DHCP server must be so configured that it doesn't conflict with the existing DHCP server.
Install the isc-dhcp-server package and edit /etc/dhcp/dhcpd.conf using the following as a model. I am not sure that every line is needed, but this worked for me.
ddns-update-style none;
option domain-name-servers 172.19.3.1; # This is the address of my gateway
option routers 172.19.3.1; # This is the address of my gateway
option subnet-mask 255.255.0.0; # This is the netmask of my home network
default-lease-time 600;
max-lease-time 7200;
allow booting;
allow bootp;
subnet 172.19.3.0 netmask 255.255.255.0 {
range 172.19.3.220 172.19.3.229; # This is a range separate from the one used by the gateway and includes the address below
}
group {
next-server 172.19.3.7; # This is the address of the "source"
host trawsfynydd { # 'trawsfynydd' is the name I chose for my X220
hardware ethernet f0:de:f1:6b:22:bf; # This is the Ethernet address of the X220
fixed-address 172.19.3.220; # This is an address in the range as defined above
filename "/pxelinux.0";
}
}
Now install the tftpd-hpa package, download the network installation tarball and untar it into the location whence tftpd serves files.
$ cd /tmp $ wget http://archive.ubuntu.com/ubuntu/dists/natty/main/installer-amd64/current/images/netboot/netboot.tar.gz $ cd /var/lib/tftpboot $ sudo tar zxf /tmp/netboot.tar.gz
Second set up the X220 for PXE (Pre-boot eXecution Environment).
- Switch on the X220 and press F1. ThinkPad Setup starts.
- Set Config | Network | Ethernet LAN Option ROM to "Enabled".
- Select Startup | Boot; select "PCI LAN IBA GE Slot..." and use the [+] key to move it to the top of the boot priority order
- Press F10 to save and exit.
Voilà, the X220 boots the Ubuntu installer.
Installation
I won't describe the Ubuntu installer. I'll just mention some little problems I had.
First, when it came time to resize the existing (ntfs) partition the partitioner asked what size I would like for "this partition". Did it mean the to-be-resized ntfs partition or the new ext4 partition?
Turns out it meant: the to-be-resized ntfs partition, so the suggested "max" selection was the opposite of what I wanted.
Second, when I selected (only) the "Ubuntu desktop" task the installation reported failure without explaining what had gone wrong.
I de-selected all tasks and the installation succeeded.
Third, after reboot the screen came up black.
I pressed CTRL-ALT-F1 to get the system console so I could log in.
After logging in I ran tasksel and installed "Ubuntu desktop" and this time no failure was reported.
Information
dmidecode
# dmidecode -s system-manufacturer LENOVO # dmidecode -s system-product-name 42902WG # dmidecode -s system-version ThinkPad X220
/proc/cpuinfo
processor : 0 vendor_id : GenuineIntel cpu family : 6 model : 42 model name : Intel(R) Core(TM) i5-2540M CPU @ 2.60GHz stepping : 7 cpu MHz : 800.000 cache size : 3072 KB physical id : 0 siblings : 4 core id : 0 cpu cores : 2 apicid : 0 initial apicid : 0 fpu : yes fpu_exception : yes cpuid level : 13 wp : yes flags : fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush dts acpi mmx fxsr sse sse2 ss ht tm pbe syscall nx rdtscp lm constant_tsc arch_perfmon pebs bts rep_good nopl xtopology nonstop_tsc aperfmperf pni pclmulqdq dtes64 monitor ds_cpl vmx smx est tm2 ssse3 cx16 xtpr pdcm sse4_1 sse4_2 x2apic popcnt aes xsave avx lahf_lm ida arat epb xsaveopt pln pts dts tpr_shadow vnmi flexpriority ept vpid bogomips : 5182.27 clflush size : 64 cache_alignment : 64 address sizes : 36 bits physical, 48 bits virtual power management:
lspci
00:00.0 Host bridge: Intel Corporation 2nd Generation Core Processor Family DRAM Controller (rev 09) 00:02.0 VGA compatible controller: Intel Corporation 2nd Generation Core Processor Family Integrated Graphics Controller (rev 09) 00:16.0 Communication controller: Intel Corporation 6 Series Chipset Family MEI Controller #1 (rev 04) 00:19.0 Ethernet controller: Intel Corporation 82579LM Gigabit Network Connection (rev 04) 00:1a.0 USB Controller: Intel Corporation 6 Series Chipset Family USB Enhanced Host Controller #2 (rev 04) 00:1b.0 Audio device: Intel Corporation 6 Series Chipset Family High Definition Audio Controller (rev 04) 00:1c.0 PCI bridge: Intel Corporation 6 Series Chipset Family PCI Express Root Port 1 (rev b4) 00:1c.1 PCI bridge: Intel Corporation 6 Series Chipset Family PCI Express Root Port 2 (rev b4) 00:1c.3 PCI bridge: Intel Corporation 6 Series Chipset Family PCI Express Root Port 4 (rev b4) 00:1c.4 PCI bridge: Intel Corporation 6 Series Chipset Family PCI Express Root Port 5 (rev b4) 00:1d.0 USB Controller: Intel Corporation 6 Series Chipset Family USB Enhanced Host Controller #1 (rev 04) 00:1f.0 ISA bridge: Intel Corporation 6 Series Chipset Family LPC Controller (rev 04) 00:1f.2 SATA controller: Intel Corporation 6 Series Chipset Family 6 port SATA AHCI Controller (rev 04) 00:1f.3 SMBus: Intel Corporation 6 Series Chipset Family SMBus Controller (rev 04) 03:00.0 Network controller: Intel Corporation Centrino Advanced-N 6205 (rev 34) 0d:00.0 System peripheral: Ricoh Co Ltd Device e823 (rev 04)
lsusb
Bus 002 Device 002: ID 8087:0024 Intel Corp. Integrated Rate Matching Hub Bus 002 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub Bus 001 Device 006: ID 04f2:b217 Chicony Electronics Co., Ltd Bus 001 Device 005: ID 0a5c:217f Broadcom Corp. Bluetooth Controller Bus 001 Device 004: ID 147e:2016 Upek Biometric Touchchip/Touchstrip Fingerprint Sensor Bus 001 Device 003: ID 0424:2514 Standard Microsystems Corp. USB 2.0 Hub Bus 001 Device 002: ID 8087:0024 Intel Corp. Integrated Rate Matching Hub Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Key table
This table was prepared before keys were remapped as discussed elsewhere on this page.
References:
- Hotkey architecture in Ubuntu
- Hotkey troubleshooting instructions
- /usr/include/linux/input.h -- list of Linux key codes
- Default meanings of special keys
| Key combination | Extra function symbol | Scan code (showkey -s) (hex) |
Linux key code (showkey -k) |
Input event (input-events) |
... on input device(*) | ACPI event (acpi_listen) |
X KeyCode (xev) |
Keyboard Shortcuts name |
|---|---|---|---|---|---|---|---|---|
| 📢⃥ (loudspeaker icon with stroke) | down: e0 20 up: e0 a0 |
113 | KEY_MIN_INTERESTING (0x71) | 3 | (none) | 121 | XF86AudioMute | |
| −📢 (minus sign, loudspeaker icon) | down: e0 2e up: e0 ae |
114 | KEY_VOLUMEDOWN (0x72) | 3 | (none) | 122 | XF86AudioLowerVolume | |
| 📢+ (loudspeaker icon, plus sign) | down: e0 30 up: e0 b0 |
115 | KEY_VOLUMEUP (0x73) | 3 | (none) | 123 | XF86AudioRaiseVolume | |
| 🎤⃥ (microphone icon with stroke) | (none) | 240 (rop) | KEY_UNKNOWN (0xf0) | 6 | ibm/hotkey HKEY 00000080 0000101b | 248 | "∅" (sic) | |
| ThinkVantage | down: e0 1f e0 9f | 148 (rop) | KEY_PROG1 (0x94) | 6 | ibm/hotkey HKEY 00000080 00001018 | 156 | XF86Launch1 | |
| Fn | up: e0 63 e0 e3 | 143 | KEY_WAKEUP (0x8f) | 3 | (none) | 151 | XF86WakeUp | |
| Fn-F1 | (none) | 466 (rop) | KEY_FN_F1 (0x1d2) | 6 | ibm/hotkey HKEY 00000080 00001001 | (none) | (none) | |
| Fn-F2 | 🔒 (padlock symbol) | down: e0 12 e0 92 | 152 (rop) | KEY_SCREENLOCK (0x98) | 6 | ibm/hotkey HKEY 00000080 00001002 | 160 | XF86ScreenSaver |
| Fn-F3 | 🔋 (battery symbol) | down: e0 71 e0 f1 | 236 (rop) | KEY_BATTERY (0xec) | 6 | ibm/hotkey HKEY 00000080 00001003 | 244 | XF86Battery |
| Fn-F4 | ☾ | down: e0 5f e0 df (but sometimes nothing) |
142 (rop) | KEY_SLEEP (0x8e) | 6 | ibm/hotkey HKEY 00000080 00001004 | 150 | XF86Sleep |
| Fn-F5 | ⸨💻⸩ (radiating computer symbol) | down: e0 73 e0 f3 | 238 (rop) | KEY_WLAN (0xee) | 6 | ibm/hotkey HKEY 00000080 00001005 | 246 | XF86WLAN |
| Fn-F6 | (camera, headset) | down: e0 3b e0 bb | 212 (rop) | KEY_CAMERA (0xd4) | 6 | ibm/hotkey HKEY 00000080 00001006 | 220 | XF86WebCam |
| Fn-F7 | 💻⎚ (computer symbol, screen symbol) | down: e0 56 e0 d6 | 227 (rop) | KEY_SWITCHVIDEOMODE (0xe3) | 6 | ibm/hotkey HKEY 00000080 00001007 | 235 | XF86Display |
| Fn-F8 | (trackpoint symbol, vertical bar, trackpad symbol) | down: e0 74 e0 f4 | 191 (rop) | KEY_F21 (0xbf) | 6 | ibm/hotkey HKEY 00000080 00001008 | 199 | XF86TouchpadToggle |
| Fn-F9 | down: 6f ef | 194 (rop) | KEY_F24 (0xc2) | 6 | ibm/hotkey HKEY 00000080 00001009 | 202 | "Ê" (sic) | |
| Fn-F10 | (none) | (none) | (none) | (none) | (none) | |||
| Fn-F11 | (none) | 476 (rop) | KEY_FN_F11 (0x1dc) | 6 | ibm/hotkey HKEY 00000080 0000100b | (none) | (none) | |
| Fn-F12 | 💻 ▶❍ (computer symbol, right arrowhead, diskpack symbol) | down: e0 25 e0 a5 (but sometimes nothing) |
205 (rop) | KEY_SUSPEND (0xcd) | 6 | ibm/hotkey HKEY 00000080 0000100c | 213 | XF86Suspend |
| Fn-Home | ☀▴ | down: e0 54 e0 d4 e0 54 e0 d4 | 225 (double) (rop) | KEY_BRIGHTNESSUP (0xe1) | 4, 6 | ibm/hotkey HKEY 00000080 00001010 and video LCD0 00000086 00000000 | 233 | XF86MonBrightnessUp |
| Fn-End | ☀▾ | down: e0 4c e0 cc e0 4c e0 cc | 224 (double) (rop) | KEY_BRIGHTNESSDOWN (0xe0) | 4, 6 | ibm/hotkey HKEY 00000080 00001011 and video LCD0 00000087 00000000 | 232 | XF86MonBrightnessDown |
| Fn-PgUp | (illuminating overhead lamp symbol) | (none) | (none) | (none) | (none) | (none) | (none) | (none) |
| Fn-Space | [🔍+] (screen with magnifying glass symbol and plus sign, i.e., "zoom" symbol) | (none) | 372 (rop) | KEY_ZOOM (0x174) | 6 | ibm/hotkey HKEY 00000080 00001014 | (none) | (none) |
| Fn-→ | ⏭ (barred right arrowhead, i.e., "next" symbol) | down: e0 19 up: e0 99 |
163 | KEY_NEXTSONG (0xa3) | 3 | (none) | 171 | XF86AudioNext |
| Fn-↓ | ⏯ (right arrowhead, double bar, i.e., "play/pause" symbol) | down: e0 22 up: e0 a2 |
164 | KEY_PLAYPAUSE (0xa4) | 3 | (none) | 172 | XF86AudioPlay |
| Fn-← | ⏮ (barred left arrowhead, i.e., "prev" symbol) | down: e0 10 up: e0 90 |
165 | KEY_PREVIOUSSONG (0xa5) | 3 | (none) | 173 | XF86AudioPrev |
| Fn-↑ | ∎ ("stop play" symbol) | down: e0 24 up: e0 a4 |
166 | KEY_STOPCD (0xa6) | 3 | (none) | 174 | XF86AudioStop |
| ◂ ⎗ (left arrowhead, page icon) | down: e0 6a up: e0 ea |
158 | KEY_BACK (0x9e) | 3 | (none) | 166 | XF86Back | |
| ⎘ ▸ (page icon, right arrowhead) | down: e0 69 up: e0 e9 |
159 | KEY_FORWARD (0x9f) | 3 | (none) | 167 | XF86Forward |
In the Linux key code column, "rop" means "release on press", i.e., the release event is generated at the same time as the press event.
The button on the UltraBase doesn't seem to generate any events visible to userspace.
Input device numbers and types as reported by lsinput:
| n | name |
|---|---|
| 0 | "Lid Switch" |
| 1 | "Sleep Button" |
| 2 | "Power Button" |
| 3 | "AT Translated Set @ keyboard" |
| 4 | "Video Bus" |
| 5 | "Integrated Camera" |
| 6 | "ThinkPad Extra Buttons" |
| 7 | "SynPS/2 Synaptics TouchPad" |
| 8 | "TPPS/2 IBM TrackPoint" |
Hotkey mask when the above table was compiled:
$ cat /sys/devices/platform/thinkpad_acpi/hotkey_mask 0x078dffff $ cat /sys/devices/platform/thinkpad_acpi/hotkey_all_mask 0x07ffffff $ cat /sys/devices/platform/thinkpad_acpi/hotkey_recommended_mask 0x078dffff $ cat /sys/devices/platform/thinkpad_acpi/hotkey_report_mode 1
Accessories
Accessories I purchased for this laptop:
- ThinkPad UltraBase Series 3 with built-in Serial Ultrabay Slim
- Serial Ultrabay Slim DVD Multi IV Drive
- ThinkPad Mini Dock Series 3 433710U which comes with a 90W power supply
- 1.95Ah battery 42T4901
- 8.4Ah battery 42T4942
Configuration and solved problems
Fingerprint reader
See how to enable the integrated fingerprint reader with fprint.
Fix for hotkey shortcomings
By default the "zoom" (Fn-Space) and "microphone-mute" (button next to the ThinkVantage button) hotkeys do nothing.
Zoom: The thinkpad-acpi module, kernel and udev map the zoom key's ACPI event (ibm/hotkey HKEY 00000080 00001014) correctly to an input event (KEY_ZOOM (372)) but the number is out of the range of key-event codes (maximum 255) that X can handle.
Micmute: The thinkpad-acpi module and kernel generate an ACPI event (ibm/hotkey HKEY 00000080 0000101b) for the microphone mute button but this is not currently mapped to anything. This has been reported in various places, including here.
A workaround is to add a /etc/udev/rules.d/keymap.rules file to cause the ACPI events to be mapped to input events that X can use. The following /etc/udev/rules.d/keymap.rules maps the zoom hotkey to "search" which becomes X event XF86Search, and maps the microphone mute key to prog2 which becomes XF86Launch2. The X events can be assigned functions in System Settings | Keyboard Shortcuts.
ACTION=="remove", GOTO="keyboard_end"
SUBSYSTEM!="input", GOTO="keyboard_end"
KERNEL!="event*", GOTO="keyboard_end"
ENV{DMI_VENDOR}=="LENOVO*", KERNELS=="input*", ATTRS{name}=="ThinkPad Extra Buttons", RUN+="keymap $name 0x13 search 0x1A prog2"
LABEL="keyboard_end"
Note that, for some reason, ACPI event "...14" corresponds to 0x13 — i.e., one less — in the keymap file. Likewise ACPI event "...1b", generated by the microphone mute button, corresponds to 0x1A.
There is no built-in function for muting the microphone but it is straightforward to concoct one using amixer. In Keyboard Shortcuts press Add to create a new shortcut and create "Microphone mute" with the following command.
sh -c "if amixer get Capture,0 | grep -q '\[on\]' ; then amixer -q set Capture,0 nocap ; else amixer -q set Capture,0 cap; fi"
Assign this to XF86Launch2, corresponding to prog2, as mentioned above.
A more convenient workaround is being worked on in the form of a keymap override feature. With the patch in Debian bug report #556045 applied to /lib/udev/keymap the procedure is
# sudo su # mkdir /etc/udev/keymaps # cp /lib/udev/keymaps/module-lenovo /etc/udev/keymaps # vi /etc/udev/keymaps/module-lenovo
In the last step, edit the file so that it contains the following lines.
0x13 search 0x1A prog2
This won't work until the keymap-override feature gets into a Ubuntu udev package, which should be sometime in late 2011. The patch was committed in August.
Udev has also been patched upstream to include the 0x1A prog2 line in /lib/udev/keymaps/module-lenovo. I would think, though, that in the long run this assignment will change.
Fix for the known no-system-beep problem
As I described in more detail earlier:
- Create .xprofile containing
pactl upload-sample /usr/share/sounds/gnome/default/alerts/glass.ogg bell.ogg
- Run gconf-editor and at desktop | gnome | peripherals | keyboard change the value of bell_mode from off to on.
- If the default bell volume of 50 (percent) is not loud enough, add a line like the following to ~/.bashrc.
xset b 100
- To cause terminal bells to ring also in non-X terminals (e.g., the console terminal), comment out the blacklist pcspkr line in /etc/modprobe.d/blacklist.conf.
Fix for "[drm:i915_hangcheck_ring_idle] *ERROR* Hangcheck timer elapsed... blt ring idle..." problem
To fix this known problem upgrade the kernel: install the linux-image-2.6.38-11-generic package and reboot.
Fix for tp-smapi loading problem
First, it is as usual necessary to add
tp-smapi
to /etc/modules so that modoprobe will attempt to load the module at boot time.
But the distributed tp-smapi and hdaps modules don't load on my X220 and thinkpad-acpi reports the EC firmware number as "unknown".
The BIOS setup program reports this information about the BIOS:
- Model 42902WG
- UEFI BIOS 8DET46WW (1.16) 2011-05-18
- Embedded Controller 8DHT23WW (1.07)
This problem has been fixed in tp-smapi version 0.41-1. As of 7 August 2011 tp-smapi-dkms is available in Debian unstable (Ubuntu uses Debian tp-smapi packages with no changes) and this is the version in Ubuntu 11.10 (Oneiric Ocelot).
Output from dmesg after modprobeing thinkpad-ec, tp-smapi and hdaps:
[ 714.842090] thinkpad_ec: thinkpad_ec 0.41 loaded. [ 721.983409] tp_smapi 0.41 loading... [ 721.984742] tp_smapi successfully loaded (smapi_port=0xb2). [ 729.462533] hdaps: LENOVO ThinkPad X220 detected, setting orientation 4 [ 729.462894] hdaps: initial mode latch is 0x05 [ 729.463022] hdaps: setting ec_rate=250, filter_order=2 [ 729.463242] hdaps: device successfully initialized. [ 729.463799] input: ThinkPad HDAPS joystick emulation as /devices/virtual/input/input15 [ 729.464101] input: ThinkPad HDAPS accelerometer data as /devices/virtual/input/input16 [ 729.464342] hdaps: driver successfully loaded.
Modinfo:
$ modinfo tp-smapi filename: /lib/modules/2.6.38-11-generic/updates/dkms/tp_smapi.ko license: GPL version: 0.41 description: ThinkPad SMAPI Support author: Shem Multinymous srcversion: B6841670771B2FF5222BFFD depends: thinkpad_ec vermagic: 2.6.38-11-generic SMP mod_unload modversions parm: debug:Debug level (0=off, 1=on) (int)
hdaps
Having loaded hdaps do:
sudo add-apt-repository ppa:linrunner/thinkpad-extras sudo apt-get update sudo apt-get install hdaps-utils hdaps-gl
Result:
Miscellaneous configuration
- Having installed bare Ubuntu I had to run tasksel and select at least "Ubuntu Desktop".
- In order to allow NetworkManager to manage eth0 I had to comment out the "eth0" stanza in /etc/network/interfaces
- I used System Settings | Ubuntu Software Center to install ccsm ("Advanced Desktop Effects Settings") so I could enable Wobbly Windows and so I can initiate window resize with Alt+Button3 which is easier than the default Alt-Button2 (i.e., Alt-scrollwheelbutton).
- Add PPAs to apt sources list for additional indicators
Ex-problems
Suspend causes kernel panic
"Suspend-to-RAM and brightness control of the display work with kernel >= 3.0-rc6" according to this fellow.
Since I upgraded to kernel 2.6.38-11-generic I haven't had any kernel panics on suspend.
TPM can't be used
To try it out, install tpm-tools.
When I first tried it, the tpm_version program failed with "Communication failure".
But now it prints this:
TPM 1.2 Version Info: Chip Version: 1.2.8.32 Spec Level: 2 Errata Revision: 3 TPM Vendor ID: STM TPM Version: 01010000 Manufacturer Info: 53544d20
Presumably the new kernel fixed this.
memtest86+ didn't work
Upgrading to the oneiric version, v4.20, fixed this.
Multiple monitors
Configuring an extended desktop over two monitors led to malfunction. Side-by-side worked, one above the other did not.
In natty the solution was just to avoid the layouts that caused the malfunction.
The problems appear to have been completely solved in Ubuntu 11.10 (Oneiric Ocelot).
Switching bluetooth on or off either using the indicator or Fn-F5 sometimes crashed the machine.
I haven't seen this problem in Ubuntu 10.10 (Oneiric Ocelot).
Remaining problems
Indicator lamp on microphone mute key doesn't work
I haven't looked into this problem yet. It has been discussed, e.g., here.
Comparison with a Ubuntu 10.10 user's experience
- (improvements)
- I didn't have to do anything special to have the thinkpad-acpi module loaded or use special keys
- The mute-microphone button can be made to work as described above
- Both left and right microphones are seen
- I have no difficulties with the fans
- I have no difficulties with SD cards
- The "Hangcheck timer elapsed" problem has been fixed in a new kernel version, as described above
Things to look into
- Thoroughly test docking and undocking
- Thoroughly test suspending and resuming
With earlier ThinkPad models and earlier versions of Ubuntu these never worked properly. Especially annoying, for example: my suspended laptop would wake up while in my briefcase. Or: after resuming, connecting a different monitor would screw up the GUI. Consequently I developed the habit of never using suspend and never docking or undocking a running machine. Before trusting these allegedly working features I will have to very thoroughly test them.
