ThinkWiki - User contributions [en]

Installation instructions for the ThinkPad X60 Tablet

2012-08-28T16:58:35Z

Lcampagn: Updated URL for reference material

[[Category: X60 Tablet]]

==Distro specific instructions==
*{{Install|Gentoo||X60 Tablet}}
*{{Install|Ubuntu||X60 Tablet}}

==External Sources==
*[http://luke.campagnola.me/x60tablet/ Linux on the X60 Tablet]

Installing Ubuntu 7.04 (Feisty Fawn) on an X61 Tablet

2012-08-28T16:49:45Z

Lcampagn: Updated URL for reference material

You can get Linux running pretty smoothly on this machine. I will simply repeat the steps I used to get my tablet working, some of these steps might be superfluous. Please edit, if some of the steps are unneccessary. I expect Gutsy Gibbon installs to be much smoother, when the system comes out in October...

===Helpful Guides===
A helpful guide for me was http://luke.campagnola.me/x60tablet/

===Feisty v. Gutsy===
I have gotten the computer to work well with both Feisty and Gutsy Tribe 4 and 5. If you install Feisty, you will have to upgrade to the 2.6.22 kernel to get all the drivers to work. I would advise using Gutsy, as it makes everything easier to set up (with drivers). The 2.6.23 kernel, once it officially comes out, should *probably* make this laptop an out-of-the-box machine. (the 2.6.23 kernel has plans to include the graphics, sound, and wireless drivers for this machine by default)

===Known Problems===
These are issues that I have run into and have not resolved yet. None of them are 'show stoppers' in my book. If you have a fix, please add how to resolve the issue on this page (preferrably in the respective how-to section..)

*Screen rotation with 3D acceleration. Both screen rotation (through xrandr) and 3d acceleration work independantly, however a rotated screen crashes when you try to run a 3d application.
*ALSA sound glitch when rotating to tablet mode. For some reason rotating to tablet mode from laptop mode causes the sound to cut out. Sound works otherwise.
*Brightness auto-adjust on Gutsy. Brightness auto adjust cannot determine what level to stay at, and indefinitely adjusts up and down. Pressing the brightness keys fixes this. See launchpad for the official bug '''Already fixed in Gutsy'''

===Actual installation===
***Works in both Feisty and Gutsy

The trickiest part about actually installing Ubuntu on this machine is that there is no CD drive. If you've shelled out the $200 for the UltraBase then you can just pop the CD in that, and proceed normally. I had to install via a pendrive. Instructions on how to do this are at

http://www.pendrivelinux.com/2007/02/12/usb-ubuntu-tutorial-for-linux-users/

*On my machine, and with my particular USB drive, I found that it was difficult get power to the USB drive in a normal boot process. I had to enter the BIOS (F1 during power on), configure the USB HDD to be first boot choice, and then enable the POST memory check (extended boot?, I think it was called). Then I had to insert the USB drive during the memory check, and make sure the light on the USB came on in order to get it to boot from the installer. Hopefully most people won't have this problem, but I did, so if you have problems getting the drive to be seen, make sure the USB is getting powered.

===Graphics Card===
***Feisty
The X3100 with an Intel GMA965 runs Compiz Fusion very nicely, once the proper drivers are installed. The 'i810' driver that is installed by default with Feisty does not support the X3100, but there are newer drivers (simply named 'intel') that do support it. Source is available from http://www.intellinuxgraphics.org/. Unfortunately, installing on the stock kernel (2.6.18, if I remember) does not work with these drivers, as agpgart is incorrectly registered. I upgraded to 2.6.22 and the drivers work nicely. Here's the walkthrough...

*Install the new kernel

# gedit /etc/apt/sources.list
Add the Gutsy repositories
# deb http://archive.ubuntu.com/ubuntu gutsy main restricted universe multiverse
# deb-src http://security.ubuntu.com/ubuntu gutsy main restricted universe multiverse
Save and exit gedit

Install the new kernel
# apt-get update
# apt-get install linux-image-2.6.22-9-generic linux-ubuntu-modules-2.6.22-9-generic linux-backports-modules-2.6.22-9-generic linux-headers-2.6.22-9 linux-headers-2.6.22-9-generic linux-restricted-modules-2.6.22-9-generic

Reboot. Make sure to select the new kernel in GRUB when you turn on the computer.

Install the graphics card drivers from the repositories
# sudo apt-get install xserver-xorg-video-intel xserver-xorg libgl1-mesa-dri libgl1-mesa-glx libglu1-mesa mesa-utils

Let X11 know to use the Intel drivers
# gedit /etc/X11/xorg.conf

Change
Section "Device"
Identifier "Generic Video Card"
Driver "vesa"
BusID "PCI:0:2:0"
EndSection

to

Section "Device"
Identifier "Generic Video Card"
Driver "intel"
BusID "PCI:0:2:0"
EndSection

Reboot

***Gutsy
3d acceleration works out of the box, but I had to compile compiz fusion and awm from source to get them to work. If I find time, I'll make a deb for both....

===Solving the Weird Resolution Problems===
***Applies to both Feisty and Gutsy
When you reboot into the new drivers, it seems that X defaults to the graphics card's 'TV' output instead of the 'LVDS' option as it should. This will cause X to be confused about where the screen edges are, and in general make everything weird. This can be corrected in one of two ways

*Solution 1:
Everytime you log in, enter this command
# xrandr --output TV --off

*Solution 2:
Edit xorg.conf to automatically correct this problem. Note that this will cause xrandr (which you may want to use for screen rotation) to fail when you try to use it.

add this to the device section

Option "monitor-TV" "TVOutput"
Option "CacheLines" "32768"
Option "TripleBuffer" "true"
Option "DRI" "true"
Option "PageFlip" "true"

add this at the bottom

Section "Monitor"
Identifier "TVOutput"
Option "Disable" "true"
EndSection

save and exit, restart X

===Installing compiz fusion===
***Feisty
Basically, I followed the instructions at
http://fosswire.com/2007/07/11/how-to-compiz-fusion-on-ubuntu-704-feisty-fawn/

The line about adding the GPG keys is malformed, copying and pasting won't work. Use this command
# gpg --keyserver subkeys.pgp.net --recv-keys 81836EBF
# gpg --export --armor 81836EBF | sudo apt-key add -

***Gutsy
I had to compile from source. This is a kinda long process, and you have to have programming/compiling skills, but it definitely works well if you can do it.

There you go! Now you have a visually gorgeous system running :-D! All the effects run very smoothly for me, I was very pleased with this integrated card's performance... (no stuttering for even complex effects like explode or airplane)

===Wireless===
This essential laptop feature will definitely work. The intel ABG card has drivers, guides should abound as to how to install it. (if anyone has time, put how you got it to work here) I purchased the newer AGN card, and this is how I installed the new drivers.

Walkthough for newbies :-)

download these:
http://intellinuxwireless.org/mac80211/downloads/mac80211-8.0.2.tgz
http://intellinuxwireless.org/iwlwifi/downloads/iwlwifi-4965-ucode-4.44.17.tgz
http://intellinuxwireless.org/iwlwifi/downloads/iwlwifi-1.0.0.tgz

extract them

prepare the build environment
# sudo mkdir /lib/firmware/$(uname -r)
# sudo ln -s /usr/src/linux-headers-$(uname -r) /lib/modules/$(uname -r)/source

make everything

# cd mac80211-8.0.2
# sudo make patch_kernel

# cd ../iwlwifi-1.0.0
# make
# sudo make install

# cd ../iwlwifi-4965-ucode-4.44.17
# sudo cp iwlwifi-4965.ucode /lib/firmware/$(uname -r)

Finally, Load the modules
sudo modprobe mac80211
sudo modprobe iwl4965

You should have wifi now!

Thanks goes to rye_ of ubuntuforums!

They work pretty well, I've only noticed them being flaky once.

===Wacom===
We bought this machine largely for the tablet abilities, and the pen works out of the box! Yay! The side button automatically maps to scrollwheel-pressed-down, but you can remap it to right click if you want. Eraser also works.

===Tablet-Specific Applications===
We're tablet users and we have special needs! Here are some apps I found these apps indespensible

Jot.
When I placed my order for my tablet, Lenovo said I had a full month wait til it arrived. I filled the time writing a handwriting recognition app for Linux. My goal is to allow for full sentence or full word recognition. As of 8/20/2007, its still in alpha testing, but I should have a pretty good release mid-September to early October. Source is available from http://bazaar.launchpad.net/~kdub432/jot/trunk. You need libfakekey0, gtkmm-2.4-dev, libcairomm-1.0-dev installed so the makefile will work...

Onestroke.
This program will recognize a single character at a time pretty well. Its written by Michael Levin, and is in pretty usuable condition. Onestroke can be found at
http://www.paperaffinity.com/risujin/onestroke.php

Xournal
A journal clone, that is great for taking notes. Fully functional, an all-around great app.
#apt-get install xournal

'''[[CellWriter]]'''

CellWriter is a grid-entry natural handwriting input panel. As you write characters into the cells, your writing is instantly recognized at the character level. When you press Enter on the panel, the input you entered is sent to the currently focused application as if typed on the keyboard.

GoK warning!!! Running GoK on Feisty screwed up some things for me. It may be that I was just too lazy to fix my dependancies, but I was real ticked at how it installed itself when I was running Feisty. Use the default Ubuntu program onboard ('onboard' from a terminal) if you want an onscreen keyboard

===Sound===
Sound does not work out of the box, with Gutsy or Feisty, but the mercurial/cvs alsa drivers do have support. This issue was extremely hard to track down, and requires some advanced knowledge. I will provide a short walkthrough to give some guidance.

Step 1 Setup a fundamental build environment
# sudo apt-get install mercurial build-essential libncurses5-dev python2.5 automake libtool
# sudo mkdir /usr/src/alsa
# cd /usr/src/alsa

(This was taken just from memory, if you get errors about something not being installed, just install whatever it complains about...)

Next, get latest alsa drivers
# sudo hg clone http://hg.alsa-project.org/alsa-driver alsa-driver
# sudo hg clone http://hg.alsa-project.org/alsa-kernel alsa-kernel
# sudo hg clone http://hg.alsa-project.org/alsa-lib alsa-lib
# sudo hg clone http://hg.alsa-project.org/alsa-utils alsa-utils

Install everything
# cd alsa-driver
# sudo ./cvscompile --with-cards=all --with-card-options=all (Nota Bene, this makes all the drivers. do more research if you just want the intel ones ;-D)
# sudo make install
# cd ../alsa-lib
# sudo ./cvscompile
# sudo make install
# cd ../alsa-utils
# sudo ./cvscompile
# sudo make install

Phew, that was tough. Its not over yet though, you've gotta edit some configuration files
sudo nano /etc/modprobe.d/alsa-base

and add this to the bottom,

options snd-hda-intel model=thinkpad

Save, exit and reboot.

THIS IS VERY IMPORTANT! IT TOOK ME 5+ HOURS TO FIGURE THIS OUT ON MY OWN!

YOU MUST HAVE BIOS SET TO FACTORY INSTALL (for the most part)

Certain BIOS options seem to break these drivers! I'm not sure which, but the factory settings work fine.

On next login, you should have sound. If you don't, make sure nothing is muted in alsaconf/alsamixer.
Also, make sure your login name is in the 'audio' or 'users' groups.

Alright, you have sound now! Yay!

Both headphones and speakers work, theres a switch on a tab in the gnome panel audio adjustment properties that turns either on/off

Note! It has been brought to my attention that an ubuntu developer has compiled packages for these drivers. I have not tested these yet and cannot ensure that they will work, although there are people on this site who have reported sucess using these packages
https://bugs.launchpad.net/ubuntu/+bug/122560

For what it's worth, I installed Ubuntu 7.10 on my new X61 tablet and sound worked (almost) out of the box. The bugs I see are that the built-in volume control buttons are mapped to the microphone channel instead of the speaker channel, and there's an issue with XMMS not being able to share the sound channel with Firefox (though maybe that's a wider issue than the X61tablet). If you're running Gnome, the volume control buttons can be mapped to the speakers by going to System > Preferences > Sound and selecting PCM in the Default Mixer Tracks.

===Keyboard and Buttons===
You should have no trouble with getting the main 105 keys to work.

Some of the Fn buttons work, some don't. I'm still wading through ways to get these to work, but they're not super-high on my priority list. If you find ways, feel free to post :-)....

Screen Buttons.
The D-pad will work, but by default maps to weird values. Add
setkeycodes 6f 108
setkeycodes 71 103
setkeycodes 6e 105
setkeycodes 6d 106

to /etc/rc.local to make the D-pad work like your keyboard arrow keys. The middle button is 'Enter'

The other buttons also work. I have not mapped them to anything specific yet, but in a real terminal (no X environment), you can use the showkey command and setkeycodes to map the other 4 buttons to whatever you want. More instructions on this will follow once I decide what I want to use these 4 buttons for

===Suspend and Hibernate===
The default Ubuntu suspend and resume cycle causes a kernel panic. I got my computer to flawlessly suspend and resume by installing pm-utils
sudo apt-get install pm-utils

then you can suspend using the command
sudo pm-suspend --quirk-s3-bios --quirk-s3-mode

I'm content with suspend working, but if anyone figures out hibernate, let me know :-D

Works for Gutsy (please confirm for Feisty): In order to make the quirk settings the default for your machine, apply the following patch:
<pre>
--- /usr/share/hal/fdi/information/10freedesktop/20-video-quirk-pm-lenovo.fdi.orig 2007-10-08 13:35:45.000000000 +0200
+++ /usr/share/hal/fdi/information/10freedesktop/20-video-quirk-pm-lenovo.fdi 2008-01-20 11:16:58.000000000 +0100
@@ -2,6 +2,11 @@
<deviceinfo version="0.2">
<device>
<match key="system.hardware.vendor" string="LENOVO">
+ 
+ <match key="system.hardware.product" prefix="776796U">
+ <merge key="power_management.quirk.s3_bios" type="bool">true</merge>
+ <merge key="power_management.quirk.s3_mode" type="bool">true</merge>
+ </match>

<match key="system.hardware.product" prefix="1702">
<merge key="power_management.quirk.s3_bios" type="bool">true</merge>
</pre>
Make sure you adjust the prefix="776796U" to match your particular model, using the output from the following command:
<pre>
lshal |grep system.hardware.product
</pre>
You have to reboot your machine to make the changes permanent (restarting hal should actually be sufficient, but was not on my system). After that, gnome should be able to suspend/resume your system without crashing the machine or leaving the video backlight off. The only issue left on my system is that NetworkManager hangs after a resume, but that is easily solved by creating the following script in /etc/pm/sleep.d/01NetworkManagerRestart and making it executable by 'sudo chmod +x /etc/pm/sleep.d/01NetworkManagerRestart':
<pre>
#!/bin/bash
case $1 in
hibernate)
;;
suspend)
;;
thaw)
;;
resume)
/bin/sh -c 'sleep 3;modprobe -r ipw3945;modprobe ipw3945;' &
;;
*) echo "somebody is calling me totally wrong."
;;
esac
</pre>

== Other x61 install guides on the web ==
* http://bayleshanks.com/tips-computer-lenovoX61t-gnuLinuxSetup (feel free to integrate the content on that page into this wiki -- Bayle)

[[Category:X61 Tablet]]

Tp smapi

2007-12-30T04:22:27Z

Lcampagn: /* Model-specific status */ Added hdaps orientation for X60 tablet

{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;white-space:nowrap;" | __TOC__
|style="vertical-align:top" |
The <tt>tp_smapi</tt> kernel module exposes some features of the ThinkPad hardware/firmware via a <tt>sysfs</tt> interface. Currently, the main implemented functionality is control of battery charging and extended battery status. It also includes an improved version of the [[HDAPS]] driver. The underlying hardware interfaces are [[SMAPI support for Linux|SMAPI]] and direct access to the embedded controller.

For older ThinkPad models, see also [[tpctl]].

{{WARN|This driver uses undocumented features and direct hardware access. It thus cannot be guaranteed to work and could conceivably damage your computer (though so far no incidents have been reported).}}
|}

===Features===
*Battery charge/discharge control
*Battery status information

===Project Homepage / Availability===
* Project page: http://tpctl.sourceforge.net/
* You need to [http://sourceforge.net/project/showfiles.php?group_id=1212&package_id=171579 download] only the <tt>tp_smapi</tt> package.

===Installation===
====Installation from source====
You will need the kernel headers and makefiles corresponding to your current kernel version. On {{Fedora}}, this means {{cmdroot|yum install kernel-devel-$(uname -r)}} .

:{{cmdroot|tar xzvf tp_smapi-0.33.tgz}}
:{{cmdroot|cd tp_smapi-0.33}}

Then, either compile and load the driver within the current working directory (for testing):
:{{cmdroot|make load}}
OR compile and install into the kernel's module path:
:{{cmdroot|make install}}

If you use the [[HDAPS]] driver, add <tt>HDAPS=1</tt> to also patch the <tt>hdaps</tt> for compatibility with <tt>tp_smapi</tt> (this requires a kernel source tree matching the current kernel).
Again, either load the driver within the current working directory:
:{{cmdroot|1=make load HDAPS=1}}
OR install into the kernel's module path:
:{{cmdroot|1=make install HDAPS=1}}

To prepare a stand-alone patch against the current kernel tree (including
a patch against <tt>hdaps</tt> and new <tt>Kconfig</tt> entries):
:{{cmdroot|make patch}}

To delete all autogenerated files:
:{{cmdroot|make clean}}

The original kernel tree is never modified by any these commands.
The {{path|/lib/modules}} directory is modified only by {{cmdroot|make install}}.

====Installation in Gentoo====
The {{Gentoo}} portage system carries a [http://packages.gentoo.org/packages/?category=app-laptop;name=tp_smapi tp_smapi package], which follows the latest version pretty closely. On a Gentoo system, you can install and load as follows.

If you use the [[HDAPS]] driver, do this first:

* Configure <tt>hdaps</tt> as module in your kernel
* Add the <tt>hdaps</tt> use flag in {{path|/etc/make.conf}}
* {{cmdroot|rmmod hdaps}}

Then:

* {{cmdroot|emerge tp_smapi}} (or install tp_smapi with hdaps support manually, as above)
* {{cmdroot|echo "tp_smapi" >> /etc/modules.autoload.d/kernel-2.6}}
* {{cmdroot|echo "hdaps" >> /etc/modules.autoload.d/kernel-2.6}}

Then reboot, or run:
* {{cmdroot|modprobe tp_smapi}}
* {{cmdroot|modprobe hdaps}}

====Installation on Debian unstable (sid) or testing (lenny)====
Debian now contains the [http://packages.debian.org/tp-smapi packaged module source] for use with module-assistant.

* {{cmdroot|apt-get install tp-smapi}}
* {{cmdroot|m-a -t a-i tp-smapi}}

====Installation on Ubuntu/Debian====
Installation on Ubuntu or Debian is quite easy, but there are a few things to look after:

To get your system ready for compiling code, install the build-essentials (as root, of course, as all of the following comands; Ubuntu users have to prepend 'sudo' to every line and enter their own password when prompted):
<pre><nowiki>apt-get install build-essential</nowiki></pre>

To get tp_smapi to work, obtain the latest source as mentioned above and unpack it. If you want to use HDAPS, you need to install the kernel source matching te kernel you are running. To do so, issue this:
<pre><nowiki>uname -r</nowiki></pre>
This will give you the version of your current kernel. As Ubuntu adds '-generic' to the kernel-version, the following command works for Debian users only:
<pre><nowiki>apt-get install linux-source-`uname -r`</nowiki></pre>
Ubuntu users use the kernel-version they got by the command before, e.g. 'linux-source-2.6.20'

Now change to the tp_smapi dir:
<pre><nowiki>cd tp_smapi-X.YY</nowiki></pre> (X.YY being the version-number of [[tp_smapi]])
and make and install tp_smapi as instructed above.

If you get an error that the kernel version isn't matching (or that you need to set KSRC/KBUILD), please check that there is a symlink from the modules dir to the kernel source:
<pre><nowiki>root@localhost:~#ls -l /lib/modules/2.6.20-16-generic
lrwxrwxrwx 1 root root 28 2007-02-02 08:39 source -> /usr/src/linux-source-2.6.20</nowiki></pre>
Create the link if the line above is not existent:
<pre><nowiki>root@localhost:~#ln -s /usr/src/linux-source-2.6.20 /lib/modules/2.6.20-16-generic/source</nowiki></pre>

Now the following will build and install the correct modules to their locations:
<pre><nowiki>make install HDAPS=1</nowiki></pre>
To make sure your system loads the modules at boot time, do this:
<pre><nowiki>echo "tp_smapi" >> /etc/modules
echo "hdaps" >> /etc/modules</nowiki></pre>
and update your initramfs:
<pre><nowiki>update-initramfs -u</nowiki></pre>

To get tp_smapi running now, just load the modules:
<pre><nowiki>modprobe -a tp_smapi hdaps</nowiki></pre>

This description was tested on Kubuntu 'Feisty Fawn' and should work on all Debian-based distros with minor tweaks.

'''EDIT:''' Works on Kubuntu 7.10 ("Gutsy Gibbon"), too

===Battery charge control features===
To set the thresholds for starting and stopping battery charging (in percent of current full charge capacity):
:{{cmdroot|echo 40 > /sys/devices/platform/smapi/BAT0/start_charge_thresh}}
:{{cmdroot|echo 70 > /sys/devices/platform/smapi/BAT0/stop_charge_thresh}}
:{{cmdroot|cat /sys/devices/platform/smapi/BAT0/*_charge_thresh}}
{{HINT|Battery charging thresholds can be used to keep Li-Ion ad Li-Polymer batteries partially charged, in order to [[Maintenance#Battery_treatment|increase their lifetime]].}}
To prevent charging for 17 minutes (regardless of thresholds):
:{{cmdroot|echo 17 > /sys/devices/platform/smapi/BAT0/inhibit_charge_minutes}}
{{HINT|Charge inhibiting can be used to reduce the power draw of the laptop, in order to use an under-spec power supply that can't handle the combined power draw of running and charging. It can also be used to control which battery is charged when [[How to use UltraBay batteries|using an Ultrabay battery]].}}

To cancel charging preventation:
:{{cmdroot|echo 0 > /sys/devices/platform/smapi/BAT0/inhibit_charge_minutes}}

To force battery discharging (even if connected to AC):
:{{cmdroot|echo 1 > /sys/devices/platform/smapi/BAT0/force_discharge}}
{{HINT|This can be used to choose which battery is discharged when [[How to use UltraBay batteries|using an UltraBay battery]].}}

To cancel forced discharge:
:{{cmdroot|echo 0 > /sys/devices/platform/smapi/BAT0/force_discharge}}

===Battery status features===
To view extended battery status such as charging state, voltage, current, capacity, cycle count and model information:

<pre>
# cat /sys/devices/platform/smapi/BAT0/installed
# cat /sys/devices/platform/smapi/BAT0/state # idle/charging/discharging
# cat /sys/devices/platform/smapi/BAT0/cycle_count
# cat /sys/devices/platform/smapi/BAT0/current_now # instantaneous current
# cat /sys/devices/platform/smapi/BAT0/current_avg # last minute average
# cat /sys/devices/platform/smapi/BAT0/power_now # instantaneous power
# cat /sys/devices/platform/smapi/BAT0/power_avg # last minute average
# cat /sys/devices/platform/smapi/BAT0/last_full_capacity
# cat /sys/devices/platform/smapi/BAT0/remaining_percent
# cat /sys/devices/platform/smapi/BAT0/remaining_running_time
# cat /sys/devices/platform/smapi/BAT0/remaining_charging_time
# cat /sys/devices/platform/smapi/BAT0/remaining_capacity
# cat /sys/devices/platform/smapi/BAT0/design_capacity
# cat /sys/devices/platform/smapi/BAT0/voltage
# cat /sys/devices/platform/smapi/BAT0/design_voltage
# cat /sys/devices/platform/smapi/BAT0/manufacturer
# cat /sys/devices/platform/smapi/BAT0/model
# cat /sys/devices/platform/smapi/BAT0/barcoding
# cat /sys/devices/platform/smapi/BAT0/chemistry
# cat /sys/devices/platform/smapi/BAT0/serial
# cat /sys/devices/platform/smapi/BAT0/manufacture_date
# cat /sys/devices/platform/smapi/BAT0/first_use_date
# cat /sys/devices/platform/smapi/BAT0/temperature # in milli-Celsius
# cat /sys/devices/platform/smapi/ac_connected
</pre>

The raw status data is also available, including some fields not listed above (in case you can figure them out):

:{{cmdroot|cat /sys/devices/platform/smapi/BAT0/dump}}

In all of the above, replace <tt>BAT0</tt> with <tt>BAT1</tt> to address the 2nd battery.

Note that the battery status readout conflicts with the stock [[HDAPS|hdaps]] driver, so if you use <tt>hdaps</tt> you will need to load <tt>tp_smapi</tt> using {{cmdroot|1=make load HDAPS=1}} (see [[#Bundled hdaps driver|Bundled hdaps driver]] below).

On [[ACPI]]-enabled systems, most of above information is also available through the files under {{path|/proc/acpi/battery}}. However, the ACPI interface does not include the instantaneous power and cycle count readouts, and does not work well when [[How to use UltraBay batteries|hotswapping UltraBay batteries]].

====Scripts====
Some scripts can make it easier to grep the information you need from tp_smapi
* [[battery.rb]]

===Other features===

There is also [[sysfs]] attribute for making direct SMAPI requests to the SM BIOS firmware. Don't touch it unless you really know what you're doing. Example:
# echo '211a 100 0 0' > /sys/devices/platform/smapi/smapi_request; cat /sys/devices/platform/smapi/smapi_request
211a 34b b2 0 0 0 'OK'
The "4b" in the 2nd value, converted to decimal, is 75: the current charging stop threshold (stop_charge_thresh).

===Bundled <tt>hdaps</tt> driver===

The tp_smapi package includes a modified version of the <tt>hdaps</tt> Linux kernel driver used by the [[HDAPS]] system. To use <tt>tp_smapi</tt> and <tt>hdaps</tt> concurrently, you '''must''' use the modified version.

To build the modified version, simply append the <tt>HDAPS=1</tt> parameter to the <tt>make</tt> command (see [[#Installation|Installation]] above):
:{{cmdroot|1=make load HDAPS=1}}
or
:{{cmdroot|1=make install HDAPS=1}}

If you don't do that, you will not be able to load <tt>tp_smapi</tt> (and its support module <tt>thinkpad_ec</tt>) when <tt>hdaps</tt> is loaded, and vice versa. You can use <tt>rmmod</tt> to switch between these modules.

Note that some of the battery status is also visible through ACPI ({{path|/proc/acpi/battery/*}}), independently of <tt>tp_smapi</tt>.

The modified <tt>hdaps</tt> has several changes:
* The <tt>hdaps</tt> driver in mainline kernels conflicts with the extended battery status (they use the same IO ports). The modified <tt>hdaps</tt> coordinates this access through the bundled <tt>thinkpad_ec</tt> driver.
* The modified <tt>hdaps</tt> driver fixes reliability and improves support for recent ThinkPad models (*60 and newer), since unlike the mainline driver, it correctly follows the Embedded Controller communication protocol.
* Several other improvements, such as the ability to control the polling rate.

===Troubleshooting===

If you get "<tt>thinkpad_ec: no ThinkPad embedded controller!</tt>" when trying to load the module on a supported model listed below, you should [[BIOS_Upgrade|upgrade your BIOS]]. Some early BIOS (like 1.x on the X31) don't handle the embedded controller.

===Model-specific status===

<div style="font-size: 92%">
{| border="1" cellspacing="0" cellpadding="2"
|+<tt>tp_smapi</tt> feature support matrix
|-
! colspan=11 style="text-align:center;background:#efefef;" |
=====A series=====
|-
{{tp_smapi/model_status_table_header}}
|-
! {{A22p}} 2629-USG
| {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{A30}}
| {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || || ||
|-
! colspan=11 style="text-align:center;background:#efefef;" |
=====G series=====
|-
{{tp_smapi/model_status_table_header}}
|-
! {{G41}}
| {{Cyes}} || {{Cno}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || {{Cunk}} || {{Cunk}} || || ||
|-
! colspan=11 style="text-align:center;background:#efefef;" |
=====R series=====
|-
{{tp_smapi/model_status_table_header}}
|-
! {{R31}}
| {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cunk}} || {{Cunk}} || || || No SMAPI BIOS
|-
! {{R40}}
| {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cunk}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{R50}}
| {{Cunk}} || {{Cno}} || {{Cunk}} || {{Cunk}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{R50e}} 1834-JAG
| {{Cyes}} || {{Cno}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{R50p}}
| {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{R51}} 18*
| {{Cyes}} || {{Cno}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes|text=}} 0 || 0.32 || 3.22 || Machine types 1829, 1830, 1831 and 1836
|-
! {{R51}} 28*
| {{Cyes}} || {{Cno}} || {{Cyes}} || {{Cunk}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || || 1.29 || Machine types 2883, 2887, 2888, 2889, 2894 and 2495
|-
! {{R52}}
| {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes|text=}} 0 || 0.33 || 1.29 ||
|-
! {{R60}}
| {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} ||{{Cyes}} || {{Cno|text=}} 1 || 0.33 || ||
|-

! colspan=11 style="text-align:center;background:#efefef;" |

=====T series=====
|-
{{tp_smapi/model_status_table_header}}
|-
! {{T20}}
| {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cunk}} || {{Cunk}} || || || Has SMAPI BIOS but no function is supported. EC LPC3 protocol fails.
|-
! {{T22}}
| {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cunk}} || {{Cunk}} || || || Has SMAPI BIOS but no function is supported. EC LPC3 protocol fails.
|-
! {{T23}}
| {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{T30}}
| {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{T40}}
| {{Cno}} || {{Cno}} || {{Cno}} || {{Cunk}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{T40p}}
| {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{T41}}
| {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{T41p}} 2373-AM9
| {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cyes}} || {{Cyes}} || {{Cyes|text=}} 1 || 0.32 || 3.20 || EC v3.04
|-
! {{T42}}
| {{Cyes}} || {{Cno}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{T42p}} 2373-KXU
| {{Cyes}} || {{Cno}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes|text=}} 1 || 0.32 || 3.21 || Stop charge threshold works in Windows, but dmesg says "__get_real_thresh: cannot get stop_thresh of bat=0: Function is not supported by SMAPI BIOS".
|-
! {{T42p}} 2373-KUU
| {{Cyes}} || {{Cno}} || {{Cyes}} || {{Cunk}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{T43}} 2686
| {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes|text=}} 0 || 0.33 || 1.27 ||
|-
! {{T43p}}
| {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cunk}} || {{Cyes|text=}} 0 || || ||
|-
! {{T60}}
| {{Cyes}} || {{Cyes}} || {{Cunk}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cno|text=}} 7 || 0.32 || ||
|-
! {{T60p}} 8743-CTO
| {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes|text=}} 1 || 0.32 || ||
|-
! {{T61}}
| {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cno|text=}} 1 || 0.32 || || [http://ubuntuforums.org/showthread.php?p=3146719 ref]
|-
! {{T61p}} 6457-7XG
| {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cno|text=}} 1 || 0.32 || || [http://ubuntuforums.org/showthread.php?p=3146719 ref]
|-
! colspan=11 style="text-align:center;background:#efefef;" |

=====X series=====
|-
{{tp_smapi/model_status_table_header}}
|-
! {{X20}} 2662-31G
| {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{X24}}
| {{Cno}} || {{Cno}} || {{Cno}} || {{Cunk}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{X30}}
| {{Cno}} || {{Cno}} || {{Cunk}} || {{Cunk}} || {{Cunk}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{X31}}
| {{Cno}} || {{Cno}} || {{Cno}} || {{Cunk}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{X32}}
| {{Cno}} || {{Cno}} || {{Cno}} || {{Cno}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{X40}}
| {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cno|text=}} 3 || 0.32 || 2.08 || EC v1.62
|-
! {{X41}}
| {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cno|text=}} 3 || 0.32 || ||
|-
! {{X41_Tablet}}
| {{Cunk}} || {{Cunk}} || {{Cunk}} || {{Cunk}} || {{Cunk}} || {{Cyes}} || {{Cno|text=}} (see ref) || 0.32 || || [http://sourceforge.net/mailarchive/message.php?msg_name=4757BD30.8080808%40ugcs.caltech.edu ref] ||
|-
! {{X60}}
| {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cno|text=}} 6 || || 2.07 || EC v1.10, 2.6.20 issue (see discussion)
|-
! {{X60s}}
| {{Cunk}} || {{Cunk}} || {{Cunk}} || {{Cunk}} || {{Cunk}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{X61s}}
| {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cno|text=}} 6 / 3 || 0.32 || || [http://www.slackwiki.org/ThinkPad_X61s ref] says 3 but conflicting report received
|-
! {{X60_Tablet}}
| {{Cunk}} || {{Cunk}} || {{Cunk}} || {{Cunk}} || {{Cunk}} || {{Cyes}} || {{Cno|text=}} 3 || || || [http://luke.no-ip.org/x60tablet/ ref] [http://rad.bioinfo.ulaval.ca/hardware/x60tablet ref]
|-
! {{X61_Tablet}}
| {{Cyes}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || {{Cyes}} || {{Cyes}} || {{Cno|text=}} 6 || 0.32 || ||
|-
! colspan=11 style="text-align:center;background:#efefef;" |

=====Z series=====
|-
{{tp_smapi/model_status_table_header}}
|-
! {{Z60m}}
| {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{Z60t}}
| {{Cyes}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || || ||
|-
! {{Z61m}}
| {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes|text=}} 0 || 0.32 || ||
|-
! {{Z61t}}
| {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cyes}} || {{Cunk}} || || || [https://bugs.launchpad.net/ubuntu/+source/linux-source-2.6.20/+bug/45014 ref]
|-
! {{Z61p}}
| {{Cyes}} || {{Cyes}} || {{Cunk}} || {{Cunk}} || {{Cyes}} || {{Cyes}} || {{Cunk}} || || ||
|}
</div>

SMAPI capabilities may depend on the BIOS version as well, so upgrading to the latest version of the BIOS might provide more SMAPI functions (especially true for long-lived BIOS with lots of releases, like the TP-1R).

Please update the above and report your experience on the [[Talk:tp_smapi|discussion]] page. If the module loads but gives a "<tt>not supported</tt>" or "<tt>not implementeded</tt>" error when you try to use some specific file in {{path|/sys/devices/platform/smapi/}}, please report the <tt>dmesg</tt> output and whether the corresponding functionality is available under Windows - maybe your ThinkPad just can't do that.

While at it, you may also want to add your laptop to the [[list of DMI IDs]].

=====HDAPS axis orientation=====
<sup>1</sup> The HDAPS axis orientation is set using the <tt>invert</tt> module parameter (at load time) or sysfs attribute (at runtime). The tp_smapi's hdaps driver supports all 8 possible sensor orientations (inversion and swapping). You can use [[HDAPS#Visualisation_of_ThinkPad_orientation|hdaps visualisation]] to check if the settings is correct.

<tt>invert</tt> is an integer between 0 and 7, whose meaning is as follows. Let <tt>X</tt> and <tt>Y</tt> denote the hardware readouts. Let <tt>R</tt> denote the laptop's roll (tilt left/right), and let <tt>P</tt> denote the laptop's pitch (tilt forward/backward). The possible values are as follows:
invert=0: R= X P= Y (same as mainline)
invert=1: R=-X P=-Y (same as mainline)
invert=2: R=-X P= Y (new)
invert=3: R= X P=-Y (new)
invert=4: R= Y P= X (new)
invert=5: R=-Y P=-X (new)
invert=6: R=-Y P= X (new)
invert=7: R= Y P=-X (new)

[[Category:Drivers]] [[Category:Patches]]

===Tools using this driver===

The driver's interface can be accessed directly through the files under {{path|/sys/devices/platform/smapi}}, or via the following tools:
* [[KThinkBat]] - display battery status on the KDE <tt>kicker</tt> panel.
* [[gkrellm-ThinkBat]] - battery status plugin for Gkrellm2
* {{CodeRef|thinkpad-smapi.sh}} - script to display various SMAPI information using tp_smapi module.

Installation instructions for the ThinkPad X60 Tablet

2007-02-22T03:39:19Z

Lcampagn:

==External Sources==
*[http://luke.no-ip.org/x60tablet/ Linux on the X60 Tablet]

Installation

2007-02-22T02:40:35Z

Lcampagn: /* Installation instructions for specific ThinkPads */

{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;white-space:nowrap;" | __TOC__
|style="vertical-align:top" |
Here you will find specific information on how to install different operating systems on your ThinkPad.
|}

==General installation instructions==
*[[Pre-Installation steps]]
*[[Installation on ThinkPads without CD-ROM drive]]
*[[How to setup boot loaders]]
*[[Supported Boot Devices]]

==Installation instructions for specific ThinkPads==
{| cellspacing="0" cellpadding="5" border="1"
|- style="text-align:left;"
!Numbered!!A series!!G series!!R series!!S series!!T series!!X series!!Z series!!others
|- style="text-align:left;vertical-align:top;"
|
'''{{ThinkPad|220|Installation instructions for the}}'''

'''{{ThinkPad|230|Installation instructions for the}}'''

'''{{ThinkPad|240|Installation instructions for the}}'''

'''{{ThinkPad|340|Installation instructions for the}}'''

'''{{ThinkPad|350|Installation instructions for the}}'''

'''{{ThinkPad|360|Installation instructions for the}}'''

'''{{ThinkPad|365|Installation instructions for the}}'''

'''{{ThinkPad|370|Installation instructions for the}}'''

'''{{ThinkPad|380|Installation instructions for the}}'''

'''{{ThinkPad|385|Installation instructions for the}}'''

'''{{ThinkPad|390|Installation instructions for the}}'''

'''{{ThinkPad|500|Installation instructions for the}}'''

'''{{ThinkPad|560|Installation instructions for the}}'''

'''{{ThinkPad|570|Installation instructions for the}}'''

'''{{ThinkPad|600|Installation instructions for the}}'''

'''{{ThinkPad|700|Installation instructions for the}}'''

'''{{ThinkPad|701|Installation instructions for the}}'''

'''{{ThinkPad|750|Installation instructions for the}}'''

'''{{ThinkPad|755|Installation instructions for the}}'''

'''{{ThinkPad|760|Installation instructions for the}}'''

'''{{ThinkPad|765|Installation instructions for the}}'''

'''{{ThinkPad|770|Installation instructions for the}}'''
||
'''{{ThinkPad|A20m|Installation instructions for the}}'''

'''{{ThinkPad|A20p|Installation instructions for the}}'''

'''{{ThinkPad|A21e|Installation instructions for the}}'''

'''{{ThinkPad|A21m|Installation instructions for the}}'''

'''{{ThinkPad|A21p|Installation instructions for the}}'''

'''{{ThinkPad|A22e|Installation instructions for the}}'''

'''{{ThinkPad|A22m|Installation instructions for the}}'''

'''{{ThinkPad|A22p|Installation instructions for the}}'''

'''{{ThinkPad|A30|Installation instructions for the}}'''

'''{{ThinkPad|A30p|Installation instructions for the}}'''

'''{{ThinkPad|A31|Installation instructions for the}}'''

'''{{ThinkPad|A31p|Installation instructions for the}}'''

||
'''{{ThinkPad|G40|Installation instructions for the}}'''

'''{{ThinkPad|G41|Installation instructions for the}}'''

||
'''{{ThinkPad|R30|Installation instructions for the}}'''

'''{{ThinkPad|R31|Installation instructions for the}}'''

'''{{ThinkPad|R32|Installation instructions for the}}'''

'''{{ThinkPad|R40|Installation instructions for the}}'''

'''{{ThinkPad|R40e|Installation instructions for the}}'''

'''{{ThinkPad|R50|Installation instructions for the}}'''

'''{{ThinkPad|R50p|Installation instructions for the}}'''

'''{{ThinkPad|R50e|Installation instructions for the}}'''

'''{{ThinkPad|R51|Installation instructions for the}}'''

'''{{ThinkPad|R51e|Installation instructions for the}}'''

'''{{ThinkPad|R52|Installation instructions for the}}'''

'''{{ThinkPad|R60e|Installation instructions for the}}'''

'''{{ThinkPad|R60|Installation instructions for the}}'''
||
'''{{ThinkPad|S30|Installation instructions for the}}'''

'''{{ThinkPad|S31|Installation instructions for the}}'''
||
'''{{ThinkPad|T20|Installation instructions for the}}'''

'''{{ThinkPad|T21|Installation instructions for the}}'''

'''{{ThinkPad|T22|Installation instructions for the}}'''

'''{{ThinkPad|T23|Installation instructions for the}}'''

'''{{ThinkPad|T30|Installation instructions for the}}'''

'''{{ThinkPad|T40|Installation instructions for the}}'''

'''{{ThinkPad|T40p|Installation instructions for the}}'''

'''{{ThinkPad|T41|Installation instructions for the}}'''

'''{{ThinkPad|T41p|Installation instructions for the}}'''

'''{{ThinkPad|T42|Installation instructions for the}}'''

'''{{ThinkPad|T42p|Installation instructions for the}}'''

'''{{ThinkPad|T43|Installation instructions for the}}'''

'''{{ThinkPad|T43p|Installation instructions for the}}'''

'''{{ThinkPad|T60|Installation instructions for the}}'''

'''{{ThinkPad|T60p|Installation instructions for the}}'''
||
'''{{ThinkPad|X20|Installation instructions for the}}'''

'''{{ThinkPad|X21|Installation instructions for the}}'''

'''{{ThinkPad|X22|Installation instructions for the}}'''

'''{{ThinkPad|X23|Installation instructions for the}}'''

'''{{ThinkPad|X24|Installation instructions for the}}'''

'''{{ThinkPad|X30|Installation instructions for the}}'''

'''{{ThinkPad|X31|Installation instructions for the}}'''

'''{{ThinkPad|X32|Installation instructions for the}}'''

'''{{ThinkPad|X40|Installation instructions for the}}'''

'''{{ThinkPad|X41|Installation instructions for the}}'''

'''{{ThinkPad|X41 Tablet|Installation instructions for the}}'''

'''{{ThinkPad|X60|Installation instructions for the}}'''

'''{{ThinkPad|X60s|Installation instructions for the}}'''

'''{{ThinkPad|X60 Tablet|Installation instructions for the}}'''
||
'''{{ThinkPad|Z60m|Installation instructions for the}}'''

'''{{ThinkPad|Z60t|Installation instructions for the}}'''

'''{{ThinkPad|Z61p|Installation instructions for the}}'''
||
'''[[Installation instructions for the RS/6000 Notebook 860|RS/6000 Notebook 860]]'''[[Category:860]]

'''[[Installation instructions for the PC110|PC110]]'''[[Category:PC110]]

'''{{ThinkPad|TransNote|Installation instructions for the}}'''
|}

==External Sources==
*[http://www-307.ibm.com/pc/support/site.wss/document.do?sitestyle=ibm&lndocid=MIGR-48NT8D IBMs Linux on Personal Systems page]
*[http://www.linux-laptop.net Linux on Laptops] features a [http://www.linux-laptop.net/ibm.html list of installation guides for IBM Notebooks]
*[http://tuxmobil.org/ TuxMobil] also features a [http://tuxmobil.org/ibm.html list of installation guides for IBM Notebooks]
*[http://ce.et.tudelft.nl/~zhijiangchang/index.html#useful How to make Windows, Linux and AcessIBM working all together]