ThinkWiki - User contributions [en]

Category:X61

2012-01-29T03:38:14Z

Xmw:

__NOTOC__
{| width="100%"
|style="vertical-align:top" |
<div style="margin: 0; margin-right:10px; border: 1px solid #dfdfdf; padding: 0em 1em 1em 1em; background-color:#F8F8FF; align:right;">
=== ThinkPad X61 ===
This pages gives an overview of all ThinkPad X61 related topics.

==== Standard Features ====
* One of the following standard voltage processors:
** [[Intel Core 2 Duo]] CPU T7100 (1.80 GHz)
** [[Intel Core 2 Duo]] CPU T7250 (2.00 GHz)
** [[Intel Core 2 Duo]] CPU T7300 (2.00 GHz)
** [[Intel Core 2 Duo]] CPU T7500 (2.20 GHz)
** [[Intel Core 2 Duo]] CPU T8100 (2.10 GHz)
** [[Intel Core 2 Duo]] CPU T8300 (2.40 GHz)
** [[Intel Core 2 Duo]] CPU T9300 (2.50 GHz)
* [[Intel Graphics Media Accelerator X3100]] ([[Intel 965]])
** 12.1" TFT display with 1024x768 resolution
* 512MB, 1GB or 2GB memory [[PC2-5300]] memory standard, official max 4GB, known to work with 8GB
* 80GB (5400 RPM), 100GB (7200 RPM), 120GB (5400 RPM), 160GB (5400 RPM) or 250GB (5400 RPM) HDD
* [[Active Protection System]]
* Intel HD Audio with [[AD1984]] codec
* [[Intel Gigabit Ethernet (10/100/1000) PCI-Express]]
* [[MiniPCI Express slot]] 1 with one of the following:
** None (empty)
** [[Intel PRO/Wireless 3945ABG Mini-PCI Express Adapter]]
** [[Intel PRO/Wireless 4965AGN Mini-PCI Express Adapter]]
** [[ThinkPad 11a/b/g Wireless LAN Mini Express Adapter]]
** [[ThinkPad 11a/b/g/n Wireless LAN Mini Express Adapter]]
* [[MiniPCI Express slot]] 2 with one of the following:
** None (empty)
** [[Intel® Turbo Memory hard drive cache]]
** [[Sierra Wireless MC5720|Verizon 1xEV-DO WWAN Adapter]]
** [[Sierra Wireless HSDPA WWAN]]
* [[ThinkPad 56K Modem (MDC-1.5)]] in the [[CDC slot]]
* [[Embedded Security Subsystem|Trusted Computing Group TPM 1.2]]
* [[Integrated Fingerprint Reader]] in some models
* [[SD Card slot]] with IO support
* [[CardBus slot]] (PC Card Type 2)
* [[Firewire Port|Firewire 400]] (IEEE1394a)
* Mono speaker and microphone

Weight is ~1.4kg with 4-cell battery, ~1.6kg with 8-cell battery

==== Optional Features ====
* [[ThinkPad Bluetooth with Enhanced Data Rate (BDC-2)|Bluetooth 2.0 EDR]] in the BDC slot

|style="vertical-align:top" |
[[Image:ThinkPadX60.jpg|ThinkPad X61]]
|}

=== Resources ===
* {{IBMDOCURL|MIGR-62866|ThinkPad X60, X60s, X61, X61s - Hardware Maintenance Manual}}
* [http://www-307.ibm.com/pc/support/site.wss/document.do?lndocid=MIGR-67777 Product overview]
* [http://www-307.ibm.com/pc/support/site.wss/document.do?lndocid=MIGR-62866 Hardware maintenance manual]
* [http://www-307.ibm.com/pc/support/site.wss/document.do?lndocid=MIGR-67774 Setup guide]
* [http://ithinkpad.wordpress.com/2011/10/14/x6xipsguide A step by step guide to build a ThinkPad X61/X61s with IPS screen]

=== Reviews ===
* [http://www.notebookreview.com/default.asp?newsID=3765 NotebookReview.com], 2007-06-20

=== Notes ===
The CPU speed will be throttled back to 800MHz or 1200MHz if the machine is run on the 65W AC adapter with no battery installed. To avoid this throttling
* run on a 90W AC adapter, or
* install a battery pack.

[[Category:X Series]]

Pentium M undervolting and underclocking

2010-11-07T18:25:40Z

Xmw: /* Alternative 0: linux-phc */ updated Gentoo section

== Background ==

Intel Pentium M processors from the [[Intel Pentium M (Dothan)|Dothan]] and [[Intel Pentium M (Banias)|Banias]] families can be instructed to operate at voltage and clock frequencies lower than the nominal ones recommended by Intel and used by ThinkPads by default. Experience shows that the processor may continue working correctly at lower-than-nominal voltages and frequencies, thereby reducing power consumption, heat and fan noise.

In the Pentium M, speed and voltage are controlled by software (through the MSR registers). It is up to the operating system to choose the right voltage for each frequency. Normally this is done according to tables published by Intel or according to ACPI tables. However, this can be overriden - in the case of Linux, by a kernel patch.

{{WARN|Following this instructions will operate your CPU under conditions it was not designed for. Even if your system seems stable, it may still suffer transient faults leading to arbitrary data corruption. In addition, errors in following these instructions (or changes between processor models) may operate the CPU ''above'' its nominal parameters, which, if taken too far, can cause kernel panics or even possibly hardware damage}}

For an example of what may be achieved, consider these examples: when voltages on one ThinkPad {{T43}} were reduced by 20-30%, stable CPU temperature dropped by 7-10deg under both idle and burn-in conditions. Combined with [[how to control fan speed|fan speed control]], this greatly reduced the [[Problem with fan noise|problem with fan noise]]. On one user's ThinkPad {{R51}}, an undervolt brought the full-load processor temperature down from 87 degrees to 63 degrees while maintaining full stability. The effect was, however, negligible at idle.

{{NOTE|While under''volting'' has a clear measurable effect, it's not clear if under''clocking'' really works. <tt>/proc/cpuinfo</tt> reflects the underclocked frequency, but enabling debug output on <tt>cpufreq</tt> causes it to say things like "<tt>CPU frequency out of sync: cpufreq and timing core thinks of 533000, is 800000 kHz.</tt>" where the former is the chosen underclocked frequency and the latter is the documented minimum frequency. This discrepancy also causes [[Software Suspend 2]] to oops during suspend.}}

There are several methods to control CPU voltage in Linux, and currently all of them require a patched kernel.

== Alternative 0: linux-phc ==

Use the [[linux-phc]] kernel patch. '''This is the recommended method, as it is most generic and best supported.'''
* [http://phc.athousandnights.de/ linux-phc home page]

The sysfs interface of linux-phc (version 0.3.0 or newer) requires you to specify VID (Voltage ID) numbers; see the documentation in the source package. For pre-Core Intel CPUs, VID is related to voltage (in mV) as follows: <tt>VID=(voltage-700)/16</tt>.

A typical configuration command would look something like this:

{{cmdroot|echo '27 22 16 10 3' > /sys/devices/system/cpu/cpu0/cpufreq/phc_vids}}

Note : 
PHC plus patches for >=2.6.35 kernel is in the Gentoo tree as [http://sources.gentoo.org/cgi-bin/viewvc.cgi/gentoo-x86/sys-power/phc-intel/ sys-power/phc-intel]. [http://sources.gentoo.org/cgi-bin/viewvc.cgi/gentoo-x86/sys-power/phc-k8/ sys-power/phc-k8] and the GUI [http://sources.gentoo.org/cgi-bin/viewvc.cgi/gentoo-x86/sys-power/phctool/ sys-power/phctool].

== Alternative 1: patch with hard-coded voltages ==
=== Instructions ===

# Determine the stable voltages for each frequency, using some overclocking/undervolting utility that has specific support for Pentium M ("Centrino") processors. It seems that no such utility exists for Linux. For windows, one good choice is [http://www.pbus-167.com/chc.htm Notebook Hardware Control (NHC)], which conveniently also includes a table of nominal frequencies and voltages (in its help file). Ascertain that at the undervolted settings the CPU actually performs correct computation ([http://www.mersenne.org/freesoft.htm Prime95] in "Tortute Test" mode seems to be a good partial test emphasizing FPU and memory access). Note that beside reducing voltages (undervolting), you can also try to add lower frequencies (underclocking). If you undervolt a particular frequency too much your machine is likely to crash, so try not to have any other programs open.
# Determine the model name string reported by the CPU, e.g., via the "<tt>Model name</tt>" line in {{path|/proc/cpuinfo}}, and likewise the <tt>cpu_family</tt>, <tt>model</tt> and <tt>stepping</tt>.
# Grab a copy of the example patch below and update it to reflect the parameters, frequencies and voltages you found.
# Apply the patch to your kernel (tested with 2.6.13.1 and 2.6.14-rc2).
# To prevent the ACPI table from overriding your table, disable the <tt>CONFIG_X86_SPEEDSTEP_CENTRINO_ACPI</tt> kernel option.
# Compile and install the new kernel.

The changes should be active now. If you want to see debug information attesting to thus, do the following:

# Reboot in <tt>single</tt> mode.
# {{cmdroot|echo 2 > /sys/module/cpufreq/parameters/debug}}
# {{cmdroot|modprobe speedstep-centrino}}
# {{cmdroot|dmesg}} and check for the message "<tt>speedstep-centrino: found "Intel(R) Pentium(R) M processor </tt>..."

If you don't see that message, you got the <tt>cpu_id</tt> or <tt>model_name</tt> parmaeters wrong. If your system crashes, re-test the voltages and adjust accordingly.

Please report your results (including voltages)!

=== Linux kernel patch (example) ===

The following example shows how to undervolt a Pentium M 750 (1.86GHz) on a ThinkPad {{T43}}. As discussed above, the parameters are specific to this one CPU. You will need to experimentally find the correct settings for your own CPU and adjust the patch accordingly.

Note that the Pentium M 750 has a 533MHz FSB (quad-pumped 133MHz), hence the use of <tt>OP133</tt>. If you have a Pentium M with 400MHz FSB (i.e., quad-pumped 100MHz, found in [[Intel Pentium M (Banias)|Banias]] and older [[Intel Pentium M (Dothan)|Dothan]]) then in the voltage table change <tt>OP133</tt> to <tt>OP</tt>.

{{CodeRef|undervolt-pentium-m-2.6.13.1.patch}}

Don't forget to disable <tt>CONFIG_X86_SPEEDSTEP_CENTRINO_ACPI</tt>.

== Alternative 2: patch with user-space control ==

If you want to use the Ubuntu 2.6.15 Kernel, please have a look at this thread: http://ubuntuforums.org/showthread.php?t=146366

The [http://fabrice.bellamy.club.fr/bdz.undervolt.2005.10.22.a.patch bdz.undervolt.2005.10.22.a.patch] patch, written by Gentoo-Wiki user "Bdz", allows voltages to be changed without reboot.

It presents a userspace interface, as in the following example:
:{{cmdroot|cat /sys/devices/system/cpu/cpu0/cpufreq/voltage_table}}
:{{cmdresult|1356,1356,1356,1356,1356,1356,1356,1244,1116,988}}
:{{cmdroot|echo "1084,1084,1084,1084,1084,1084,1084,988,908,860" >/sys/devices/system/cpu/cpu0/cpufreq/voltage_table}}

The relevant [http://gentoo-wiki.com/HOWTO_Undervolt_a_Pentium_M_CPU page] on Gentoo-Wiki providues further information and some helpful hints and scripts for voltage adjustment.

When applying this patch be sure to keep the "ACPI tables for decoding frequency pairs" option -- this patch only allows adjustment of the voltages for the normal clock speeds as reported by the ACPI table in the BIOS. On some models (e.g., ThinkPad {{T43}}) this does not include all clock speeds supported by the processor.

=== Initscript ===
This is a Gentoo initscript for the patch from Gentoo-Wiki user "Bdz".

==== Configuration file ====
<bash>
# /etc/conf.d/undervoltage

# voltage table sysfs interface
VTABLE_SYSFS="/sys/devices/system/cpu/cpu0/cpufreq/voltage_table"

# switch back to DEFAULT_VTABLE if undervoltage is stopped? [yes/no]
SWITCH_BACK="no"

# pentium-m banias 1,7GHz default voltages
DEFAULT_VTABLE="1484,1308,1228,1116,1004,956"
# pentium-m banias 1,7GHz lowered voltages [ -208mV ]
MOD_VTABLE="1276,1100,1020,908,796,748"
</bash>

==== Initscript ====
<bash>
#!/sbin/runscript
# Copyright 1999-2005 Gentoo Foundation
# Distributed under the terms of the GNU General Public License v2
# $Header: $

sysfs_check() {

if ! [ -e ${VTABLE_SYSFS} ]; then
logger "No sysfs voltage_table present. Modifying vcore voltage failed."
eerror "It seems that the undervolting patch has not been applied to the kernel."
eerror "see http://gentoo-wiki.com/HOWTO_Undervolt_a_Pentium_M_CPU for further information"
return 1
fi
}

start() {
sysfs_check || return 1
ebegin "Switching to modified voltage table [${MOD_VTABLE}]"
echo ${MOD_VTABLE} > ${VTABLE_SYSFS}
eend $?
}

# I think it is not necessary to switch to the default voltage table on shutdown
stop() {
if [ $SWITCH_BACK = "yes" ]; then
ebegin "Switching back to default voltage table [${DEFAULT_VTABLE}]"
echo ${DEFAULT_VTABLE} > ${VTABLE_SYSFS}
eend $?
fi
}
</bash>

== Alternative 3: another patch with user-space control ==

The [http://avkrok.net/nw8240/centrino-voltages.diff centrino-voltages.diff] patch, written by Rickard Holmberg, also provides user-space control. See [http://avkrok.net/nw8240/ here] and [http://mailman.linux-thinkpad.org/pipermail/linux-thinkpad/2005-December/030772.html here] for usage.

== Stress Testing ==

This [[Undervolt Stress Testing Script|script]] illustrates a very conservative method to stress test your lowered voltage settings.

== Tested frequencies/voltages ==

If you have done excessive testing with user defined frequencies (stable system for over a month).
and no lookups occur when computing primes with mprime http://mersenne.org/ (gentoo: 'emerge gimps')
you can post your frequencies here. But note that this is just a rough indication, since the stable values will differ between individual processors, even in the same model.

{| {{prettytable}}
! CPU Type !! GHz !! Frequency Steps
|-
| Pentium-M Banias || 1.6 || 1212,1084,956,860,796,748
|-
| Pentium-M Banias || 1.7 || 1276,1100,1020,908,796,748
|-
| Pentium-M Dothan || 2.0 || 1084,940,844,764,748
|-
| Pentium-M Dothan || 1.86 || 1068,972,876,780,700
|-
| Pentium-M SL6F7 || 1.6 || 1196,1052,956,860,780,732
|-
| Pentium-M Dothan || 1.6 || 940,876,812,748,716,716
|-
| Pentium-M Dothan || 1.5 || 924,892,860,828,812,796,764,732,700
|-
| Pentium-M Dothan || 1.4 || 924,892,860,828,796,764,732,700
|}

Following values were obtained with: (running at the same time)
<bash>
nice -n19 glxgears &
mplayer somedivx.avi &
cd /usr/src/linux && make -j2
</bash>
* note1: for pre-Core Intel CPUs, VID is related to voltage (in mV) as follows: VID=(voltage-700)/16 (or: voltage=(VID*16+700) mV)
* note2: when testing for stability you should pay attention to sound too, occasional distortions which disappear after bumping voltage a notch or two
* note4: if you use phc_vids for your script, then take only second number in each pair
{| {{prettytable}}
! Machine !! CPU Type !! GHz !! phc_controls (fid:vid)
|-
| {{T42}} || Pentium-M Dothan (735) || 1.7 || 17:19 14:12 12:8 10:4 8:1 6:1
|-
| {{X31}} || Pentium-M Banias (1.4) || 1.4 || 14:35 12:32 10:25 8:20 6:10 (fairly conservative)
|-
| {{X32}} || Pentium-M Dothan (745) || 1.8 || 18:26 16:20 14:15 12:11 10:6 8:2 6:1
|-
| {{X40}} || Pentium-M Banias LV (718) || 1.2 || 12:18 11:15 10:12 9:9 8:6 6:3
|-
| {{X41T}} || Pentium-M Dothan LV (758) || 1.5 || 15:15 14:13 13:11 12:9 11:7 10:5 9:3 8:2 6:2
|}

[[Category:Patches]]

Installing Gentoo on a ThinkPad X40

2010-11-07T18:05:40Z

Xmw: /* CPU Undervolting */ phc* now in Gentoo tree

== kernel compilation ==
=== ipw2200 driver (intel wireless nic) ===
don't forget to compile it as a module : http://bugs.gentoo.org/202557

=== zen kernel ===
==== tuxonice compression ====
cf http://en.gentoo-wiki.com/wiki/TuxOnIce :
 select lzo compression in "make menuconfig"
 change tuxonice.conf accordingly

== Tips ==
=== laptop_mode and other power management tips ===
http://www.gentoo.org/doc/en/power-management-guide.xml

Fan Control : http://en.gentoo-wiki.com/wiki/Lenovo_Thinkpad_T61#Fan_control
 (note that if Fan Control doesn't seem to work anymore after a system update you may need to run pwmconfig again and select manual controls by answering "y" at the first question)

=== CPU Undervolting ===
I've used phc with the hagan voltages found on : http://www.gentoo-wiki.info/Pentium_M/Undervolting
which translate to the following phc vids :
<pre>x40 ~ # cat /sys/devices/system/cpu/cpu0/cpufreq/phc_vids
14 12 10 8 6 4 2 0
</pre>

Note : some versions of linux 2.6.34 need to be patched for phc_intel to be loadable : http://www.linux-phc.org/forum/viewtopic.php?f=8&t=195

The packages sys-power/phctool and sys-power/phc-intel with support up to 2.6.36 were included in the main tree.
 (exploration notes : the phc kernel patch is included in sys-kernel/zen-sources see also : http://zen-kernel.org/included-code and http://forums.gentoo.org/viewtopic-t-805069.html )

=== x11 with x11-drivers/xf86-video-intel-2.9.1 crashing the machine ===
Apparently solved with x11-drivers/xf86-video-intel-2.11.0 : http://forums.gentoo.org/viewtopic-t-803621.html

==External Sources==
*[http://www.eletztrick.de/Members/stefan/articles/x40 Installation tutorial] (German)
*[http://www.mathematik.uni-marburg.de/~dfinke/html/howto.html x40 Installation tutorial using acpi] (German)

[[Category:X40]] [[Category:Gentoo]]

ThinkLight

2010-11-07T18:01:59Z

Xmw: /* Applications */

{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;" | __NOTOC__
[[Image:Thinklight.jpg|ThinkLight]]
|style="vertical-align:top" |
<div style="margin: 0; margin-right:10px; border: 1px solid #dfdfdf; padding: 0em 1em 1em 1em; background-color:#F8F8FF; align:right;">
The ThinkLight is a little LED light integrated into the top edge of the display frame in the A, R, T, X, Z and i Series ThinkPad models. It illuminates the ThinkPad's keyboard so that one can type in the dark without using an external light source. The ThinkLight can be controlled via the {{key|Fn}}{{key|PageUp}} key combination or via ACPI on some of the newer models. The LED is amber on some models (e.g. X30s, X40s), and white on others (e.g. T40s).
Note that the ThinkLight is not available on the G series ThinkPads, nor on the X41 Tablet.
</div>
|}
==Linux Support==
Controlling the ThinkLight with the keyboard works on all systems since it relies on the BIOS exclusively. Just press {{key|Fn}}{{key|PageUp}} to toggle its state between on and off.

===Software Control via thinkpad-acpi===
Support for controlling the light with ACPI is provided by [[thinkpad-acpi]]. After installing it, a simple
:{{cmdroot|echo 255 > /sys/class/leds/tpacpi\:\:thinklight/brightness}}
switches it on and a
:{{cmdroot|echo 0 > /sys/class/leds/tpacpi\:\:thinklight/brightness}}
switches it off again.

This allows one to control the light in scripts. Unfortunately, no known ThinkPad comes with a light sensor (yet). ;)

To use these controls in scripts without root permissions, you should run
:{{cmdroot|chmod 666 /sys/class/leds/tpacpi\:\:thinklight/brightness}}, which is probably best done using udev.

===Applications===
*'''led-notification''': Pidgin plugin to use any LED to indicate new messages. I've forked [http://github.com/Sitwon/led-notification led-notification] to support the ThinkLight via [[thinkpad-acpi]]. The plugins below either weren't compatible with the latest pidgin or didn't compile for me. The original author of led-notification seems MIA. Another fork [http://github.com/xmw/pidgin-led-notification pidgin-led-notification] to write user defined strings (added to Gentoo/Linux)
*'''gaim-thinklight''': If you are using [http://gaim.sf.net GAIM], the [http://www.joachim-breitner.de/blog/archives/38-Created-gaim-thinklight.html gaim-thinklight] plugin will enable you to use the ThinkLight as an indicator for new messages. This depends on [[thinkpad-acpi]].
*'''gaim-lighthink''': [http://www.chris-lamb.co.uk/code/gaim-lightthink/ gaim-lightthink] is an alternative to gaim-thinklight.
*'''pidgin-blinklight''':[http://packages.debian.org/unstable/net/pidgin-blinklight pidgin-blinklight] is a replacement for gaim-lighthink intended for use with [http://pidgin.im/ Pidgin].
*'''rocklight''': [http://hunz.org/ rocklight] is a xmms visualization plugin that makes the ThinkLight flash to the beat of your music. The package also includes a standalone stroboscope mode program.
*'''thinkblinkd''':[http://badcode.de/downloads/thinkblinkd-0.1.7.tar.gz] Thinkblinkd is a python daemon to control the thinklight (and possibly other lights on your Thinkpad) it comes with the daemon and a control script.
*The [[script for theft alarm using HDAPS]] optionally flashes the ThinkLight when the alarm is armed (disabled by default, to enable set <tt>$use_light=1</tt>).
*'''kopete-thinklight''':[http://kde-apps.org/content/show.php?content=47886] This plugin for kopete will enable the usage of the thinklight as notifiaction for new messages.
*'''stupid little hack to blink the ThinkLight''': [http://paste.lisp.org/display/37500] A little C program that may be set SUID so that you can use it from non-privileged programs that needs to do a little notification.
*'''thinkalert''': [http://www.mike.tl/view/Main/ThinkAlert] Another C program that may be set SUID to allow non-privileged programs to manipulate the ThinkLight. Adds some features over the "stupid little hack to blink the ThinkLight" program.
*'''thinklight-notification''': This [http://ubuntuforums.org/showthread.php?t=1017263 Evolution plugin] notifies the user with a blinking light whenever a new message has arrived.
*'''ThinkBlink''': [http://pikeypl.com/index.php?show=blink_en blink.sh] is an universal bash script making ThinkLight blink. It can be used with any application.

==Windows support==
Likewise, controlling the ThinkLight with the keyboard works without any additional software. The Hotkey Features software from IBM/Lenovo adds OSD icons that appear when the light is turned on/off.

===Software control via Hotkey Features===
The Hotkey Features software exposes an interface that allows (among other things) to control the ThinkLight. See [[Python script for Windows to control ThinkPad features]] for more information.

==Models featuring this Technology==
*ThinkPad {{I1460}}, {{I1480}}, {{I1482}}, {{I1483}}, {{I1492}}
*ThinkPad {{A Series}}
*ThinkPad {{R Series}}
*ThinkPad {{T Series}}
*ThinkPad {{W Series}}
*ThinkPad {{X20}}, {{X21}}, {{X22}}, {{X23}}, {{X24}}, {{X30}}, {{X31}}, {{X32}}, {{X40}}, {{X41}}, {{X60}}, {{X60s}}, {{X61}}, {{X61s}}, {{X200}}, {{X300}}, {{X301}}
*ThinkPad {{Z60m}}, {{Z60t}}, {{Z61m}}
*ThinkPad {{S30}}, {{S31}}

[[Category:Glossary]]

HDAPS

2010-08-31T13:54:08Z

Xmw:

{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;white-space:nowrap;" | __TOC__
|style="vertical-align:top" |
=== HDAPS - IBM Active Protection System Linux Driver ===
This is the Linux driver for monitoring the accelerometer known as [[Active Protection System|IBM Active Protection System]].

The driver only enables reading of the acceleration data. It does '''not''' perform [[#Harddisk Protection|automatic disk head parking]]. But there are already some other useful [[#Applications|applications]] for HDAPS, using the {{path|/sys}} interface it provides.

{{WARN|There are two versions of the hdaps driver, one in the Linux kernel mainline, and another provided by [[tp_smapi]]. '''Use of the tp_smapi version of hdaps is strongly recommended by the current hdaps developers.'''}}
|}

=== Features ===
*provides accelerometer values via sysfs
*provides a joystick type input device

=== Project Homepage / Availability ===
*[http://hdaps.sourceforge.net/ Project Homepage]
*The driver is included in the 2.6-mm series of kernels since August, 26th 2005.
*The driver is now in the mainline (2.6.14).
*The [[tp_smapi]] package contains some patches to this driver. These are necessary for some recent models, and recommended for all.

=== Status ===
A driver is included in recent Linux kernels and is actively maintained, but it is very inferior to the driver in tp_smapi (which provides its own hdaps module).

=== How to install the driver ===
Recent Linux kernels include the <tt>hdaps</tt> driver. However, the driver in the mainline Linux kernel has two problems with recent models:
* It doesn't whitelist them (you have to edit hdaps_init() in drivers/hwmon/hdaps.c to include a line like <tt>HDAPS_DMI_MATCH_LENOVO("ThinkPad T60")</tt>)
* It doesn't work reliably, e.g., it may read out constant values (0,0). See [http://sourceforge.net/mailarchive/message.php?msg_id=15350314 here].

To solve both problems, install the modified hdaps that is bundled with [[tp_smapi]].

=== Harddisk Protection ===
As mentioned above, the hdaps kernel driver is only responsible for reading the accelerometer data and exporting it through the sysfs interface. In order to use this information to protect the disk, some additional steps are required.

See [[How to protect the harddisk through APS]].

=== Input device support ===
In more recent versions of the Linux kernel,bVy6hxT the hdaps exports event devices with the accelerometer data. These devices can be used as-is by some programs (e.g. hdapsd), but for most they must be handled by the additional kernel module <code>joydev</code>.

When both modules are loaded, joydev will provide standard joystick device emulation for hdaps (standard hdaps exports just one joystick device. enhanced hdaps from tp_smapi will export two due to issues still unsolved on joydev, but the second one must not be used as a joystick).

{{WARN|Letting a program bind to these joystick devices can cause surprising results if you are not aware of it. e.g.: mplayer can act quite strangely. Also, letting a program bind to the second joystick device from enhanced HDAPS is guaranteed to be trouble}}

Udev can be used to create device nodes in /dev for use by user space programs that access the joystick, and to set appropriate permissions.

In order for non-root users to access these device files, their permissions must be tweaked a little through an appropriate udev rule and corresponding "joy" group.

{{cmdroot|addgroup joy}} 
{{cmdroot|adduser <you> joy}} 
<code># echo 'SUBSYSTEM=="input", KERNEL=="js*", MODE="0660", GROUP="joy"' >> /etc/udev/hdaps-joy.rules</code> 
{{cmdroot|ln -s ../hdaps-joy.rules /etc/udev/rules.d/z60_hdaps-joy.rules}} 

Programs you can use to test and calibrate the device files include <code>jscalibrator</code> (gui) and <code>jstest</code>/<code>jscal</code> (cli) packaged together (at least in Debian) simply as "joystick".

=== Applications ===
====Disk head parking====
You will need the kernel patch below and the hdapsd userspace daemon. The GUI monitoring is optional.

See [[How to protect the harddisk through APS]] for more information.

===== Kernel patch =====
Due to significant changes in the way the libata module which handles disk i/o, applying any of the currently available patches to kernel 2.6.24 will intermittently cause system hangs when the queue is frozen (i.e., the heads are parked). It is recommended either that you stay at kernel [http://www.kernel.org/pub/linux/kernel/v2.6/linux-2.6.23.17.tar.bz2 2.6.23] or do without disk protection in 2.6.24 until the kinks have been worked out. There has been significant work on the part of [http://lkml.org/lkml/2008/2/25/478 Elias Oltmanns], author of the more recent patches, to get this worked out and eventually get shock protection built into the mainline kernel.

Below are some links to patches for various Linux kernel versions. As noted above, your mileage may vary with the 2.6.24-rc3 patch as it was after this release candidate that things stopped working nicely.
{{HINT|To apply a patch, change to the root directory of the kernel tree and run <code>patch -p1 -l < hdaps_xx.patch</code>}}
* New interface (requires hdapsd dated 2008-10-04 or newer)
** In mainline kernel 2.6.28
** [http://article.gmane.org/gmane.linux.drivers.hdaps.devel/1393 disk-protect patch for kernel 2.6.27.2]
* Old interface
**[http://article.gmane.org/gmane.linux.drivers.hdaps.devel/1324/raw disk-protect patch for kernel 2.6.26]
**[http://article.gmane.org/gmane.linux.drivers.hdaps.devel/1297/raw disk-protect patch for kernel 2.6.26-rc9]
**[http://article.gmane.org/gmane.linux.drivers.hdaps.devel/1245/raw disk-protect patch for kernel 2.6.25-rc9] — may cause system locks (same as patch for 2.6.24-rc3). Apply [http://mailman.linux-thinkpad.org/pipermail/linux-thinkpad/2008-February/042226.html this fix] before.
**[http://article.gmane.org/gmane.linux.drivers.hdaps.devel/1094 disk-protect patch for kernel 2.6.24-rc3] — may cause system locks (see [http://marc.info/?l=linux-thinkpad&m=120259594519907 here], [http://marc.info/?l=linux-thinkpad&m=120259929023300 here] and try [http://mailman.linux-thinkpad.org/pipermail/linux-thinkpad/2008-February/042226.html this fix])
**[http://article.gmane.org/gmane.linux.drivers.hdaps.devel/1092 disk-protect patch for 2.6.23.8] + [http://article.gmane.org/gmane.linux.drivers.hdaps.devel/1113 error check fix]
**[http://article.gmane.org/gmane.linux.drivers.hdaps.devel/1077 disk-protect patch for 2.6.22.9 and 2.6.23-rc9]
**[http://article.gmane.org/gmane.linux.drivers.hdaps.devel/993 disk-protect patch for 2.6.20-rc6]
* Ancient interface
**[http://www.nabble.com/attachment/9047418/0/hdaps_protect-2.6.20.patch.bz2 Latest sata/ide disk protection patch for 2.6.20]
**[http://article.gmane.org/gmane.linux.kernel/470413 Latest sata/ide disk protection patch for 2.6.19-rc6]
**[http://www.dresco.co.uk/hdaps/hdaps_protect-2.6.18.3-2.patch Latest sata/ide disk protection patch for 2.6.18.3]
**[http://exitzero.de/t41p-configs/hdaps_protect-2.6.17.1-20060625.patch Untested patch for 2.6.17.1]: see [http://thread.gmane.org/gmane.linux.drivers.hdaps.devel/708/focus=708]
**[http://whoopie.gmxhome.de/linux/patches/2.6.17.14-tj/03-hdaps_protect-20060430-for-2.6.17-tj.patch Latest sata/ide disk protection patch for use with the libata hotplug 2.6.17.4 patches] - See [[How_to_hotswap_UltraBay_devices]]
**[http://whoopie.gmxhome.de/linux/patches/2.6.16-tj/05-hdaps_protect-20060430-for-2.6.16-tj.patch Latest sata/ide disk protection patch for use with the libata hotplug 2.6.16.16 patches] - See [[How_to_hotswap_UltraBay_devices]]
**[http://www.dresco.co.uk/hdaps/hdaps_protect.20060430.patch Latest sata/ide disk protection patch for 2.6.16]
**[http://www.dresco.co.uk/hdaps/hdaps_protect.20060118.patch sata/ide disk protection patch for 2.6.15]
**[http://jenster.dyndns.org/files/blk_freeze-01-nodetection-for-2.6.15.patch disk park patch adapted for the t41p model] <tt> kernel 2.6.15 ([http://sourceforge.net/mailarchive/message.php?msg_id=13214288 capability detection disabled], no libata support)</tt>
**[http://jenster.dyndns.org/files/blk_freeze-01-nodetection-for-2.6.14.patch disk park patch adapted for the t41p model] <tt> kernel 2.6.14 ([http://sourceforge.net/mailarchive/message.php?msg_id=13214288 capability detection disabled], no libata support)</tt>
**[http://lwn.net/Articles/154923/ disk park patch] <tt>an experimental patch for parking the disk (Linux 2.6.14 for 2.6.15 see below)</tt>

===== Userspace daemon =====
*Current version: [http://sourceforge.net/project/showfiles.php?group_id=138242&package_id=308030 hdapsd-20090401] 
This version optionally reduces timer interrupts (as measured by [[PowerTOP]]), and thereby reduces power consumption on modern ("tickless") Linux kernels. Interrupt reduction requires the <tt>hdaps</tt> kernel module from [[tp_smapi]] 0.32 or newer, and a udev rule. If these are not present, it will default to an older polling method that is slightly more power-hungry. The udev rule helps hdapsd find the input device, and on most distributions it can be created as follows:
# echo 'KERNEL=="event[0-9]*", ATTRS{phys}=="hdaps/input1",ATTRS{modalias}=="input:b0019v1014p5054e4801-*",SYMLINK+="input/hdaps/accelerometer-event"' \
> /etc/udev/rules.d/51-hdaps.rules
Then reboot or run {{cmdroot|/sbin/udevtrigger}}, and verify that the {{path|/dev/input/hdaps/accelerometer-event}} symlink exists.

*[ftp://rohrmoser-engineering.de/HDAPS_Userspace_Daemon/ Modified adaptive algorithm version] - uses a different (and potentially better) algorithm for the adaptive sensivity threshold.
{{HINT| Gentoo users : due to new interface your initscript won't be longer working. Read documentation before upgrading to this version.
Use an overlay listed bellow with updated versions of related packages}}

{{NOTE| Linux 2.6.33.2: with the hdaps driver from tp_smapi-0.40, hdapsd don't need udev help any more. hdapsd will loop all the event devices at /dev/input/event* to find out
the accelerometer event. Kernel has to enable the input event interface (Device Drivers->input Device support ->Event interface), otherwise the /dev/input/event* will not be populated.}}

===== GUI monitoring =====
*[http://roy.marples.name/node/269 khdapmonitor] KDE System Tray Monitor
*[http://www.dresco.co.uk/hdaps/gnome-hdaps-applet-20081204.tar.gz gnome-hdaps-applet] visual display of disk protection status in gnome panel
*[http://www.kde-look.org/content/show.php/Applet+HDAPS?content=78387 applet_hdaps] KDE4 Plasmoid display disk protection status
*[http://www.kde-look.org/content/show.php/HDAPS+monitor?content=103481 hdaps monitor] Other KDE4 Plasmoid display disk protection status
*[http://awn.planetblur.org/index.php?shard=forum&action=g_reply&ID=1916&page=1&isLive=true ThinkHDAPS] Avant Window Manager applet for disk protection status
*[http://pani.webhop.org/?id=projects:thinkhdaps ThinkHDAPS] A Gtk/Gnome panel icon based on the AWN applet.
*[http://michael.orlitzky.com/code/xfce4-hdaps.php xfce4-hdaps] An XFCE4 panel plugin for the HDAPS system.

====Security & safety====
*[[Script for theft alarm using HDAPS]]

====Tilt monitoring====
*[http://www.mulliner.org/collin/gkibm-acpi.php gkhdaps] <tt>a GKrellM applet displaying tilt data</tt>
*[https://sourceforge.net/project/showfiles.php?group_id=138242 gnome-tilt] <tt>a gnome applet showing tilt data</tt>

====Visualisation of ThinkPad orientation====
*[https://sourceforge.net/project/showfiles.php?group_id=138242 hdaps-gl] <tt>a little app animating a 3D-ThinkPad</tt>
*[https://sourceforge.net/project/showfiles.php?group_id=138242 hdapsgl-applet] <tt> a GNOME applet animating a 3D-ThinkPad</tt>
*[https://sourceforge.net/project/showfiles.php?group_id=138242 wmadhps] <tt>a WindowMaker DockApp animating a 3D-ThinkPad</tt>
*[http://www.cs.cmu.edu/~ecc/gyro.tar.gz OpenGL gyroscope hack] <tt>keeps your display levelled when tilting the ThinkPad</tt> (warning: [http://en.wikipedia.org/wiki/Tarbomb uncompresses in the current directory]!)

====Games====
*[http://icculus.org/neverball/ Neverball] is quite fun with HDAPS. (You'll need to have the HDAPS joystick device)
*Turn your ThinkPad into a Jedi Weapon (hey, it [http://isnoop.net/blog/2006/05/20/macsaber-turn-your-mac-into-a-jedi-weapon works for Mac laptops])

====Other====

*[http://blog.micampe.it/articles/2006/06/04/here-comes-the-smackpad smack.py] - switch workspace by smacking your laptop, inspired by the [http://blog.medallia.com/2006/05/smacbook_pro.html SmackBook] (uses EWMH)
**an [http://weblogs.mozillazine.org/gerv/archives/2006/09/stablilised_smackpad.html improved version] adds stabilization (by comparing smacks to previous ones, uses EWMH)
**another [http://pberndt.com/Programme/Linux/pyhdaps/index.html approach] adds stabilization (by requiring a certain type of value deflection, uses xmacroplay)
**[http://www.gnome.org/~fherrera/gtollina.c GTollina] is another smack program for use with compiz (video [http://www.gnome.org/~fherrera/blog/gtollina.html here]).
*[http://blog.odonnell.nu/61.html xmms-smack.py] - move through your xmms playlist by smacking, based on the two smack scripts above.
*[http://www-128.ibm.com/developerworks/linux/library/l-knockage.html?ca=dgr-lnxw02aKnockBasedCommands KnockBasedCommands] - Execute commands by tapping your laptop.
*[http://people.ksp.sk/~mic/Projects/Rotate rotate.py] - rotate desktop by turning your laptop
*[[hdaps_ess|Enhanced smack script]] ess.py is based on the smacks scripts listed in this section. It includes stabilization, a lot of tuning options and it handles both axis (at best you should be able to map 8 commands, even if it is possible I was not able to do so). It is not perfect but on my Thinkpad it works better than the other scripts.

=== Interesting links related to this project ===
* [https://lists.sourceforge.net/lists/listinfo/hdaps-devel HDAPS mailinglist and its archive]
* #hdaps channel on irc.freenode.org
* [https://sourceforge.net/projects/hdaps/ hdaps projects] overview of userspace programs using hdaps
* [http://www-307.ibm.com/pc/support/site.wss/document.do?lndocid=TPAD-HDFIRM IBM ThinkPads hardware drive firmware site]
* [http://www.paul.sladen.org/thinkpad-r31/accelerometer.html http://www.paul.sladen.org/thinkpad-r31/accelerometer/]
* http://bugs.gentoo.org/show_bug.cgi?id=119845 Gentoo ebuild for hdaps driver and daemon including a initscript*
* http://bugs.gentoo.org/show_bug.cgi?id=137345 Gentoo ebuild for gkhdaps gkrell plugin
* http://bugs.gentoo.org/show_bug.cgi?id=137350 Gentoo ebuild for hdaps-gl application
* http://bugs.gentoo.org/show_bug.cgi?id=137351 Gentoo ebuild for gnome hdapsgl-applet
* http://bugs.gentoo.org/show_bug.cgi?id=137352 Gentoo ebuild for gnome tilt application
* http://bugs.gentoo.org/show_bug.cgi?id=137353 Gentoo ebuild for wmhdaps
* gnome-hdaps-applet in the Gentoo main tree
* http://gentoo.o0o.nu Gentoo sectools overlay with fresh hdaps-related ebuilds and patches
* [http://lenovoblogs.com/insidethebox/?p=71 Why the ThinkPad accelerometer is only 2D] - explanation by Lenovo

[[Category:R50]] [[Category:R50p]] [[Category:R51]] [[Category:R52]] [[Category:R60]] [[Category:T41]] [[Category:T41p]] [[Category:T42]] [[Category:T42p]] [[Category:T43]] [[Category:T43p]] [[Category:T60]] [[Category:T60p]] [[Category:T61]] [[Category:X40]] [[Category:X41]] [[Category:X41 Tablet]] [[Category:X60]] [[Category:X60s]] [[Category:Z60m]] [[Category:Z60t]] [[Category:Drivers]] [[Category:Z61m]]

HDAPS

2009-06-02T07:37:48Z

Xmw: gentoo ebuild for gnome-hdaps-applet

{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;white-space:nowrap;" | __TOC__
|style="vertical-align:top" |
=== HDAPS - IBM Active Protection System Linux Driver ===
This is the Linux driver for monitoring the accelerometer known as [[Active Protection System|IBM Active Protection System]].

The driver only enables reading of the acceleration data. It does '''not''' perform [[#Harddisk Protection|automatic disk head parking]]. But there are already some other useful [[#Applications|applications]] for HDAPS, using the {{path|/sys}} interface it provides.

{{WARN|There are two versions of the hdaps driver, one in the Linux kernel mainline, and another provided by [[tp_smapi]]. '''Use of the tp_smapi version of hdaps is strongly recommended by the current hdaps developers.'''}}
|}

=== Features ===
*provides accelerometer values via sysfs
*provides a joystick type input device

=== Project Homepage / Availability ===
*[http://hdaps.sourceforge.net/ Project Homepage]
*The driver is included in the 2.6-mm series of kernels since August, 26th 2005.
*The driver is now in the mainline (2.6.14).
*The [[tp_smapi]] package contains some patches to this driver. These are necessary for some recent models, and recommended for all.

=== Status ===
A driver is included in recent Linux kernels and is actively maintained, but it is very inferior to the driver in tp_smapi (which provides its own hdaps module).

=== How to install the driver ===
Recent Linux kernels include the <tt>hdaps</tt> driver. However, the driver in the mainline Linux kernel has two problems with recent models:
* It doesn't whitelist them (you have to edit hdaps_init() in drivers/hwmon/hdaps.c to include a line like <tt>HDAPS_DMI_MATCH_LENOVO("ThinkPad T60")</tt>)
* It doesn't work reliably, e.g., it may read out constant values (0,0). See [http://sourceforge.net/mailarchive/message.php?msg_id=15350314 here].

To solve both problems, install the modified hdaps that is bundled with [[tp_smapi]].

=== Harddisk Protection ===
As mentioned above, the hdaps kernel driver is only responsible for reading the accelerometer data and exporting it through the sysfs interface. In order to use this information to protect the disk, some additional steps are required.

See [[How to protect the harddisk through APS]].

=== Input device support ===
In more recent versions of the Linux kernel, the hdaps exports event devices with the accelerometer data. These devices can be used as-is by some programs (e.g. hdapsd), but for most they must be handled by the additional kernel module <code>joydev</code>.

When both modules are loaded, joydev will provide standard joystick device emulation for hdaps (standard hdaps exports just one joystick device. enhanced hdaps from tp_smapi will export two due to issues still unsolved on joydev, but the second one must not be used as a joystick).

{{WARN|Letting a program bind to these joystick devices can cause surprising results if you are not aware of it. e.g.: mplayer can act quite strangely. Also, letting a program bind to the second joystick device from enhanced HDAPS is guaranteed to be trouble}}

Udev can be used to create device nodes in /dev for use by user space programs that access the joystick, and to set appropriate permissions.

In order for non-root users to access these device files, their permissions must be tweaked a little through an appropriate udev rule and corresponding "joy" group.

{{cmdroot|addgroup joy}} 
{{cmdroot|adduser <you> joy}} 
<code># echo 'SUBSYSTEM=="input", KERNEL=="js*", MODE="0660", GROUP="joy"' >> /etc/udev/hdaps-joy.rules</code> 
{{cmdroot|ln -s ../hdaps-joy.rules /etc/udev/rules.d/z60_hdaps-joy.rules}} 

Programs you can use to test and calibrate the device files include <code>jscalibrator</code> (gui) and <code>jstest</code>/<code>jscal</code> (cli) packaged together (at least in Debian) simply as "joystick".

=== Applications ===
====Disk head parking====
You will need the kernel patch below and the hdapsd userspace daemon. The GUI monitoring is optional.

See [[How to protect the harddisk through APS]] for more information.

===== Kernel patch =====
Due to significant changes in the way the libata module which handles disk i/o, applying any of the currently available patches to kernel 2.6.24 will intermittently cause system hangs when the queue is frozen (i.e., the heads are parked). It is recommended either that you stay at kernel [http://www.kernel.org/pub/linux/kernel/v2.6/linux-2.6.23.17.tar.bz2 2.6.23] or do without disk protection in 2.6.24 until the kinks have been worked out. There has been significant work on the part of [http://lkml.org/lkml/2008/2/25/478 Elias Oltmanns], author of the more recent patches, to get this worked out and eventually get shock protection built into the mainline kernel.

Below are some links to patches for various Linux kernel versions. As noted above, your mileage may vary with the 2.6.24-rc3 patch as it was after this release candidate that things stopped working nicely.
{{HINT|To apply a patch, change to the root directory of the kernel tree and run <code>patch -p1 -l < hdaps_xx.patch</code>}}
* New interface (requires hdapsd dated 2008-10-04 or newer)
** In mainline kernel 2.6.28
** [http://article.gmane.org/gmane.linux.drivers.hdaps.devel/1393 disk-protect patch for kernel 2.6.27.2]
* Old interface
**[http://article.gmane.org/gmane.linux.drivers.hdaps.devel/1324/raw disk-protect patch for kernel 2.6.26]
**[http://article.gmane.org/gmane.linux.drivers.hdaps.devel/1297/raw disk-protect patch for kernel 2.6.26-rc9]
**[http://article.gmane.org/gmane.linux.drivers.hdaps.devel/1245/raw disk-protect patch for kernel 2.6.25-rc9] — may cause system locks (same as patch for 2.6.24-rc3). Apply [http://mailman.linux-thinkpad.org/pipermail/linux-thinkpad/2008-February/042226.html this fix] before.
**[http://article.gmane.org/gmane.linux.drivers.hdaps.devel/1094 disk-protect patch for kernel 2.6.24-rc3] — may cause system locks (see [http://marc.info/?l=linux-thinkpad&m=120259594519907 here], [http://marc.info/?l=linux-thinkpad&m=120259929023300 here] and try [http://mailman.linux-thinkpad.org/pipermail/linux-thinkpad/2008-February/042226.html this fix])
**[http://article.gmane.org/gmane.linux.drivers.hdaps.devel/1092 disk-protect patch for 2.6.23.8] + [http://article.gmane.org/gmane.linux.drivers.hdaps.devel/1113 error check fix]
**[http://article.gmane.org/gmane.linux.drivers.hdaps.devel/1077 disk-protect patch for 2.6.22.9 and 2.6.23-rc9]
**[http://article.gmane.org/gmane.linux.drivers.hdaps.devel/993 disk-protect patch for 2.6.20-rc6]
* Ancient interface
**[http://www.nabble.com/attachment/9047418/0/hdaps_protect-2.6.20.patch.bz2 Latest sata/ide disk protection patch for 2.6.20]
**[http://article.gmane.org/gmane.linux.kernel/470413 Latest sata/ide disk protection patch for 2.6.19-rc6]
**[http://www.dresco.co.uk/hdaps/hdaps_protect-2.6.18.3-2.patch Latest sata/ide disk protection patch for 2.6.18.3]
**[http://exitzero.de/t41p-configs/hdaps_protect-2.6.17.1-20060625.patch Untested patch for 2.6.17.1]: see [http://thread.gmane.org/gmane.linux.drivers.hdaps.devel/708/focus=708]
**[http://whoopie.gmxhome.de/linux/patches/2.6.17.14-tj/03-hdaps_protect-20060430-for-2.6.17-tj.patch Latest sata/ide disk protection patch for use with the libata hotplug 2.6.17.4 patches] - See [[How_to_hotswap_UltraBay_devices]]
**[http://whoopie.gmxhome.de/linux/patches/2.6.16-tj/05-hdaps_protect-20060430-for-2.6.16-tj.patch Latest sata/ide disk protection patch for use with the libata hotplug 2.6.16.16 patches] - See [[How_to_hotswap_UltraBay_devices]]
**[http://www.dresco.co.uk/hdaps/hdaps_protect.20060430.patch Latest sata/ide disk protection patch for 2.6.16]
**[http://www.dresco.co.uk/hdaps/hdaps_protect.20060118.patch sata/ide disk protection patch for 2.6.15]
**[http://jenster.dyndns.org/files/blk_freeze-01-nodetection-for-2.6.15.patch disk park patch adapted for the t41p model] <tt> kernel 2.6.15 ([http://sourceforge.net/mailarchive/message.php?msg_id=13214288 capability detection disabled], no libata support)</tt>
**[http://jenster.dyndns.org/files/blk_freeze-01-nodetection-for-2.6.14.patch disk park patch adapted for the t41p model] <tt> kernel 2.6.14 ([http://sourceforge.net/mailarchive/message.php?msg_id=13214288 capability detection disabled], no libata support)</tt>
**[http://lwn.net/Articles/154923/ disk park patch] <tt>an experimental patch for parking the disk (Linux 2.6.14 for 2.6.15 see below)</tt>

===== Userspace daemon =====
*Current version: [http://sourceforge.net/project/showfiles.php?group_id=138242&package_id=308030 hdapsd-20090401] 
This version optionally reduces timer interrupts (as measured by [[PowerTOP]]), and thereby reduces power consumption on modern ("tickless") Linux kernels. Interrupt reduction requires the <tt>hdaps</tt> kernel module from [[tp_smapi]] 0.32 or newer, and a udev rule. If these are not present, it will default to an older polling method that is slightly more power-hungry. The udev rule helps hdapsd find the input device, and on most distributions it can be created as follows:
# echo 'KERNEL=="event[0-9]*", ATTRS{phys}=="hdaps/input1",ATTRS{modalias}=="input:b0019v1014p5054e4801-*",SYMLINK+="input/hdaps/accelerometer-event"' \
> /etc/udev/rules.d/51-hdaps.rules
Then reboot or run {{cmdroot|/sbin/udevtrigger}}, and verify that the {{path|/dev/input/hdaps/accelerometer-event}} symlink exists.

*[ftp://rohrmoser-engineering.de/pub Modified adaptive algorithm version] - uses a different (and potentially better) algorithm for the adaptive sensivity threshold.
{{HINT| Gentoo users : due to new interface your initscript won't be longer working. Read documentation before upgrading to this version.
Use an overlay listed bellow with updated versions of related packages}}

===== GUI monitoring =====
*[http://roy.marples.name/node/269 khdapmonitor] KDE System Tray Monitor
*[http://www.dresco.co.uk/hdaps/gnome-hdaps-applet-20081204.tar.gz gnome-hdaps-applet] visual display of disk protection status in gnome panel
*[http://www.kde-look.org/content/show.php/Applet+HDAPS?content=78387 applet_hdaps] KDE4 Plasmoid display disk protection status
*[http://awn.planetblur.org/index.php?shard=forum&action=g_reply&ID=1916&page=1&isLive=true ThinkHDAPS] Avant Window Manager applet for disk protection status
*[http://web.student.tuwien.ac.at/~e0726415/thinkhdaps.html ThinkHDAPS] A standalone (=gtk.StatusIcon) version of onox' awn applet; v0.2 supports new sysfs layout (kernel >=2.6.27); Should work for the new HP driver as well.
*[http://michael.orlitzky.com/code/xfce4-hdaps.php xfce4-hdaps] An XFCE4 panel plugin for the HDAPS system.

====Security & safety====
*[[Script for theft alarm using HDAPS]]

====Tilt monitoring====
*[http://www.mulliner.org/collin/gkibm-acpi.php gkhdaps] <tt>a GKrellM applet displaying tilt data</tt>
*[https://sourceforge.net/project/showfiles.php?group_id=138242 gnome-tilt] <tt>a gnome applet showing tilt data</tt>

====Visualisation of ThinkPad orientation====
*[https://sourceforge.net/project/showfiles.php?group_id=138242 hdaps-gl] <tt>a little app animating a 3D-ThinkPad</tt>
*[https://sourceforge.net/project/showfiles.php?group_id=138242 hdapsgl-applet] <tt> a GNOME applet animating a 3D-ThinkPad</tt>
*[https://sourceforge.net/project/showfiles.php?group_id=138242 wmadhps] <tt>a WindowMaker DockApp animating a 3D-ThinkPad</tt>
*[http://www.cs.cmu.edu/~ecc/gyro.tar.gz OpenGL gyroscope hack] <tt>keeps your display levelled when tilting the ThinkPad</tt> (warning: [http://en.wikipedia.org/wiki/Tarbomb uncompresses in the current directory]!)

====Games====
*[http://icculus.org/neverball/ Neverball] is quite fun with HDAPS. (You'll need to have the HDAPS joystick device)
*Turn your ThinkPad into a Jedi Weapon (hey, it [http://isnoop.net/blog/2006/05/20/macsaber-turn-your-mac-into-a-jedi-weapon works for Mac laptops])

====Other====

*[http://blog.micampe.it/articles/2006/06/04/here-comes-the-smackpad smack.py] - switch workspace by smacking your laptop, inspired by the [http://blog.medallia.com/2006/05/smacbook_pro.html SmackBook] (uses EWMH)
**an [http://weblogs.mozillazine.org/gerv/archives/2006/09/stablilised_smackpad.html improved version] adds stabilization (by comparing smacks to previous ones, uses EWMH)
**another [http://pberndt.com/Programme/Linux/pyhdaps/index.html approach] adds stabilization (by requiring a certain type of value deflection, uses xmacroplay)
**[http://www.gnome.org/~fherrera/gtollina.c GTollina] is another smack program for use with compiz (video [http://www.gnome.org/~fherrera/blog/gtollina.html here]).
*[http://blog.odonnell.nu/61.html xmms-smack.py] - move through your xmms playlist by smacking, based on the two smack scripts above.
*[http://www-128.ibm.com/developerworks/linux/library/l-knockage.html?ca=dgr-lnxw02aKnockBasedCommands KnockBasedCommands] - Execute commands by tapping your laptop.
*[http://people.ksp.sk/~mic/?menu=32&file=rotate.py rotate.py] - rotate desktop by turning your laptop
*[[hdaps_ess|Enhanced smack script]] ess.py is based on the smacks scripts listed in this section. It includes stabilization, a lot of tuning options and it handles both axis (at best you should be able to map 8 commands, even if it is possible I was not able to do so). It is not perfect but on my Thinkpad it works better than the other scripts.

=== Interesting links related to this project ===
* [https://lists.sourceforge.net/lists/listinfo/hdaps-devel HDAPS mailinglist and its archive]
* #hdaps channel on irc.freenode.org
* [https://sourceforge.net/projects/hdaps/ hdaps projects] overview of userspace programs using hdaps
* [http://www-307.ibm.com/pc/support/site.wss/document.do?lndocid=TPAD-HDFIRM IBM ThinkPads hardware drive firmware site]
* [http://www.paul.sladen.org/thinkpad-r31/accelerometer.html http://www.paul.sladen.org/thinkpad-r31/accelerometer/]
* http://bugs.gentoo.org/show_bug.cgi?id=119845 Gentoo ebuild for hdaps driver and daemon including a initscript*
* http://bugs.gentoo.org/show_bug.cgi?id=137345 Gentoo ebuild for gkhdaps gkrell plugin
* http://bugs.gentoo.org/show_bug.cgi?id=137350 Gentoo ebuild for hdaps-gl application
* http://bugs.gentoo.org/show_bug.cgi?id=137351 Gentoo ebuild for gnome hdapsgl-applet
* http://bugs.gentoo.org/show_bug.cgi?id=137352 Gentoo ebuild for gnome tilt application
* http://bugs.gentoo.org/show_bug.cgi?id=137353 Gentoo ebuild for wmhdaps
* http://bugs.gentoo.org/show_bug.cgi?id=272212 and http://svn.xmw.de/gentoo-overlay/gnome-extra/hdaps-applet/ Gentoo ebuild for gnome-hdaps-applet
* http://gentoo.o0o.nu Gentoo sectools overlay with fresh hdaps-related ebuilds and patches
* [http://lenovoblogs.com/insidethebox/?p=71 Why the ThinkPad accelerometer is only 2D] - explanation by Lenovo

[[Category:R50]] [[Category:R50p]] [[Category:R51]] [[Category:R52]] [[Category:R60]] [[Category:T41]] [[Category:T41p]] [[Category:T42]] [[Category:T42p]] [[Category:T43]] [[Category:T43p]] [[Category:T60]] [[Category:T60p]] [[Category:T61]] [[Category:X40]] [[Category:X41]] [[Category:X41 Tablet]] [[Category:X60]] [[Category:X60s]] [[Category:Z60m]] [[Category:Z60t]] [[Category:Drivers]] [[Category:Z61m]]