Merge remote-tracking branch 'origin/new-interfaces'
[hdapsd.git] / README
blobd2e2bf503b189e40dbccbece2ca2db8715c11b9b
1 hdapsd - Hard Drive Active Protection System Daemon
2 ===================================================
4 This is a disk protection user-space daemon. It monitors the acceleration
5 values through the various motion interfaces and automatically initiates
6 disk head parking if a fall or sliding of the laptop is detected.
8 Currently, the following motion interfaces are supported:
9  * HDAPS on IBM/Lenovo ThinkPads
10  * AMS on Apple iBooks and PowerBooks (G4)
11  * HP3D on Hewlett-Packard laptops
12  * APPLESMC on Apple MacBooks and MacBooks Pro (Intel) (UNTESTED!)
14 1. Compilation
15 --------------
16 ./configure
17 make
18 make install
20 2. Usage
21 --------
22 hdapsd (it will try to autodetect everything itself)
23 for more options, please read man hdapsd
25 3. Compatibility
26 ----------------
27 Since kernel 2.6.28 you don't need to patch your kernel, as support for
28 IDLE_IMMEDIATE is present in mainline.
29  NOTE: The new interface only allows IDLE_IMMEDIATE for drives that
30        announce to be ATA-7 conform. But threre are also drives that
31        support ATA-6 only but do IDLE_IMMEDIATE fine. For those you
32        need to force the interface with:
33        echo -1 > /sys/block/$DISK/device/unload_heads
34    OR: Call hdapsd like this: hdapsd -f -d $DISK
36 For kernels <2.6.28, please have a look at
37 http://www.thinkwiki.org/wiki/HDAPS#Kernel_patch
38 and patch your kernel with the appropriate patch before using hdapsd.
40 4. mainline hdaps module vs tp_smapi (ThinkPad only)
41 ----------------------------------------------------
42 The mainline hdaps module present in Linux kernels does not support all
43 hdaps-enabled ThinkPads, thus it is recommended to use the one provided
44 by tp_smapi.
45 Additionally the tp_smapi version provides a input interface to the data,
46 which stops hdapsd from polling the data itself all the time, saving your
47 battery.