ThinkWiki - User contributions [en]

Problem with APS harddisk parking

2006-05-02T12:39:56Z

Yurigagarin: /* Solution for kernel 2.6.16 or later */

{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;white-space:nowrap;" | __TOC__
|style="vertical-align:top" |
When trying to enable APS functionality by installing <tt>hdaps_protect</tt> and <tt>hdapsd</tt>, the following problems might occur.
|}

==Problem with unload capabilities check==
You may get the following kernel message when the disk is protected (e.g., via {{cmdroot|echo 1 > /sys/block/sda/queue/protect}}):

ata_scsi_issue_protect_fn(): unload support NOT reported..
scsi_protect_queue(): head park not requested, used standby!..

or

idedisk_issue_protect_fn(): unload support NOT reported..
ide_protect_queue(): head park not requested, used standby!..

{{WARN|Using HDAPS in the above state may cause frequent drive spin downs, thereby wearing out your hard disk.}}

If you see this, and you are sure that your drive actually does support unloading (all original drives sold with HDAPS-equipped ThinkPads do), one of the following solutions might help.

=== Drives which have this problem ===
* Hitachi HTS726060M9AT00 (7K60) on ThinkPad {{T43}}
* Fujitsu MHT2040AH (846C) on ThinkPad {{T41}}

=== Solution for kernel 2.6.16 or later ===
The <tt>hdaps_protect</tt> patch for 2.6.16 now accepts the {{bootparm|protect_method|}} module parameter to override the
parking capability detection, which accepts the following numeric values:
*<tt>0</tt>: autodetect capability
*<tt>1</tt>: "unload the head even if the drive doesn't report it has this capability"
*<tt>2</tt>: "standby even if unload is supported"

Hence, depending on your machine type, and whether the module is built into the kernel or not, you can use one of the following options:

If disk driver is built into kernel, add the following to your kernel boot parameters (e.g. {{path|/boot/grub/menu.lst}}):
libata.protect_method=1
ide-disk.protect_method=1

If disk driver is built as module, add the following to your modprobe configuration (e.g., {{path|/etc/modprobe.conf}}):
options libata protect_method=1
options ide-disk protect_method=1

In both cases, if you know whether you use <tt>ide-disk</tt> or <tt>libata</tt>, you can drop the other line.

=== Solution for kernel 2.6.15 and older ===
The following patch overrides automatic protect capability detection.
<pre>
diff -u linux-2.6.15.hdaps/drivers/ide/ide-disk.c linux-2.6.15.hdaps/drivers/ide/ide-disk.c
--- linux-2.6.15.hdaps/drivers/ide/ide-disk.c 2006-01-18 07:11:54.000000000 +0000
+++ linux-2.6.15.hdaps/drivers/ide/ide-disk.c 2006-01-18 07:11:54.000000000 +0000
@@ -869,7 +869,7 @@
else
printk(KERN_DEBUG "idedisk_issue_protect_fn(): unload support NOT reported..\n");

- return ide_protect_queue(q, (drive->id->cfsse & (1 << 13)) ? 1: 0);
+ return ide_protect_queue(q, 1);
}

int idedisk_issue_unprotect_fn(request_queue_t *q)
diff -u linux-2.6.15.hdaps/drivers/scsi/libata-scsi.c linux-2.6.15.hdaps/drivers/scsi/libata-scsi.c
--- linux-2.6.15.hdaps/drivers/scsi/libata-scsi.c 2006-01-18 07:15:31.000000000 +0000
+++ linux-2.6.15.hdaps/drivers/scsi/libata-scsi.c 2006-01-18 07:15:31.000000000 +0000
@@ -661,7 +661,7 @@
printk(KERN_DEBUG "ata_scsi_issue_protect_fn(): unload support NOT reported..\n");

/* call scsi_protect_queue, requesting either unload or standby */
- return scsi_protect_queue(q, ata_id_has_unload(dev->id) ? 1 : 0);
+ return scsi_protect_queue(q, 1);
}

static int ata_scsi_issue_unprotect_fn(request_queue_t *q)
</pre>

==Problem with Hard Drive Firmware==
In case you see a message like below in {{cmdroot|dmesg}} output after you have started the hdaps daemon,
a firmware upgrade of your harddisk might solve your problem.

ide_protect_queue(): head NOT parked!..
ide_unprotect_queue(): No pending I/O, re-enabling power management..

Go to the [http://www-307.ibm.com/pc/support/site.wss/document.do?lndocid=MIGR-62282 IBM harddrive firmware update utility page] and check if a firmware upgrade is available for your harddisk. IBM/Lenovo provides a bootdisk for easy firmware upgrade (~17MB download).

===supported/unsupported harddrive firmwares===
Use {{cmdroot| hdparm -i /dev/hda}} to get your harddisk model name and firmware version (replace <tt>/dev/hda</tt> with the actual device for your hard drive).

The following line is the important one in the output:

Model=HTS726060M9AT00, FwRev=MH4O'''A6GA''', SerialNo=MRHXXXXXXXXX

The last four characters of the '''FwRev''' actually marks the firmware version.

The table lists known working / not working firmware versions with [[HDAPS]]

{| cellspacing="0" cellpadding="2" border="1"
|- style="text-align:left;"
!Drive!!firmware!!park command output
|- style="text-align:left;vertical-align:top;"
| IC25N040ATCS04-0 || CA40'''A71A''' || not parked
|- style="text-align:left;vertical-align:top;"
| IC25N040ATMR04-0 || MO2O'''AD4A''' || not parked
|- style="text-align:left;vertical-align:top;"
| IC25N040ATMR04-0 || MO2O'''ADEA''' || not parked
|- style="text-align:left;vertical-align:top;"
| HTC426040G9AT00 || 00P4'''A0B4''' || parked
|- style="text-align:left;vertical-align:top;"
| HTS548040M9AT00 || MG20'''A5BA''' || not parked
|- style="text-align:left;vertical-align:top;"
| HTS548040M9AT00 || MG20'''A5HA''' || parked
|- style="text-align:left;vertical-align:top;"
| HTS548080M9AT00 || (TBA) || parked
|- style="text-align:left;vertical-align:top;"
| HTS541060G9AT00 || MB3I'''A60A''' || parked
|- style="text-align:left;vertical-align:top;"
| HTS726060M9AT00 || MH4O'''A6GA''' || parked
|- style="text-align:left;vertical-align:top;"
| Fujitsu MHT2040AH || 846C || parked
|}

How to protect the harddisk through APS

2006-04-28T12:57:24Z

Yurigagarin: /* Gentoo */

{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;white-space:nowrap;" | __TOC__
|style="vertical-align:top" |
This page tells you how to make the [[Active Protection System]] work under Linux to protect your harddrive from damage in case of a notebook drop or other kind of impact while it is running.

Specific instructions for {{Fedora}} can be found [[Installing_Fedora_Core_5_on_a_ThinkPad_X41_Tablet#Harddrive_Active_Protection_System_.28HDAPS.29|here]].

== How APS works in Linux ==
APS in Linux consists of four components on the software side:
* The [[HDAPS]] driver (included in recent kernels). It exports a sysfs interface providing the acceleration values.
* The [http://www.dresco.co.uk/hdaps/ <tt>hdaps_protect</tt>] disk protection kernel patch, which exports a sysfs interface that enables an ide or sata disk to be protected by a userspace process.
* The [http://www.dresco.co.uk/hdaps/ <tt>hdapsd</tt>] disk protection userspace daemon. It monitors the acceleration values through the HDAPS interface and automatically initiates disk protection through the hdaps_protect interface - given that the movement exceeds a user specified threshold.
* Optional: the [http://www.oakcourt.dyndns.org/projects/khdapsmon/ <tt>khdapsmon</tt> KDE System Tray applet] or the [http://www.dresco.co.uk/hdaps/ <tt>gnome-hdaps-applet</tt>]. These applets provide a visual indication of the disk protection status and also a graphical interface for adjusting configuration options for <tt>hdapsd</tt>.
|}

==Installation==
As mentioned above, the hdaps kernel driver found in recent kernels 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.

* Download and build the latest hdaps_protect disk protection kernel patches.
* Enable the drivers in the kernel (requires kernel rebuild).
* Download, build and configure the hdapsd userspace daemon.
* Download and build one of the applets to get a real-time representation of the disk protection status.

===Getting the files===
{| border="1" cellspacing="0" cellpadding="2"
! Latest Sources
|
*<tt>hdaps_protect</tt>, <tt>hdapsd</tt> and the <tt>gnome-hdaps-applet</tt>: http://www.dresco.co.uk/hdaps
*<tt>khdapsmon</tt>: http://www.oakcourt.dyndns.org/projects/khdapsmon/
|-
! {{Debian}}
|
*<tt>hdapsd</tt>, <tt>hdaps_protect</tt>, <tt>khdapsmon</tt>, <tt>gnome-hdaps-applet</tt>:
:{{cmdroot|deb http://www.oakcourt.dyndns.org/debian/ ./}}
:{{cmdroot|deb-src http://www.oakcourt.dyndns.org/debian/ ./}}
|-
! {{Fedora}}
| see instructions [[Installing_Fedora_Core_5_on_a_ThinkPad_X41_Tablet#Harddrive_Active_Protection_System_.28HDAPS.29|here]]
*kernel RPM packages including <tt>hdaps_protect</tt>: http://www.dresco.co.uk/hdaps/
*kernel RPM packages including <tt>hdaps_protect</tt> and [[Software Suspend 2]]: http://mhensler.de/swsusp/download/yum/development/fc5/ (build 2084_2 and up)
|-
! {{Gentoo}}
|
*<tt>hdapsd</tt> ebuild: http://bugs.gentoo.org/show_bug.cgi?id=119845
*<tt>khdapsmon</tt> ebuild: http://bugs.gentoo.org/show_bug.cgi?id=124175
|}

=== Adding kernel support ===
A kernel patch is required for disk head parking and queue freezing.

==== Manually patching and compiling a kernel ====
As root, do:
:{{cmdroot|cd /usr/src/linux}}
:{{cmdroot|patch -p1 < ~/hdaps_protect.20060409.patch}}
:{{cmdroot|make clean}}
:{{cmdroot|make}}
:{{cmdroot|make modules_install}}

=== Installing hdapsd ===
==== Manual compilation from source ====
* Download the <tt>hdapsd</tt> sources (see above)
* Compile using {{cmdroot|gcc -o hdapsd hdapsd-*.c}}
* Run {{cmdroot|./hdapsd -d sda -s 12 -a}} (replace <tt>sda</tt> with your hard disk device; run {{cmdroot|./hdapsd}} without arguments for help)

==== Gentoo ====
{{Gentoo}} users can try the ebuild attached to [http://bugs.gentoo.org/show_bug.cgi?id=119845 gentoo bug 119845].

*Add hdapsd support in your kernel: device drivers -> hardware monitoring -> ... (you need it as modul if you want to use tp_smapi and hdaps, see tp_smapi topic)
*Download the ebuild, use same ebuild date as the kernel-patch.
*Make known the portage an extern ebuild path and add the following line to {{path|/etc/make.conf}}:
PORTDIR_OVERLAY="/usr/local/portage/" (or any other location)
*Create directory {{path|/usr/local/portage}} and {{path|/usr/local/portage/app-laptop/}}
*Copy the downloaded ebuild to {{path|/usr/local/portage/app-laptop}} ({{path|/usr/local/portage/app-laptop/hdapsd}} should now exists)
*Make portage known the new ebuild and creat digist with:
:{{cmdroot|ebuild /usr/local/portage/app-laptop/hdapsd/hdapsd-20060326.ebuild digest}}
*Optional: Copy source file to portage distfiles (if no internet connection is available):
:{{cmdroot|cp hdapsd-20060326.c /usr/portage/distfiles}}
*Accept the x86 keyword for this package: {{cmdroot|echo "app-laptop/hdapsd ~x86" >> /etc/portage/package.keywords}}
*Install hdapsd with: {{cmdroot|emerge hdapsd}}.
*Edit {{path|/etc/conf.d/hdapsd}} (change your harddrive if neccessary: mine is sda, and change the value from 5, 5 is to sensitive, 12 is a good value in my opinion).
*start deamon with: {{cmdroot|/etc/init.d/hdapsd start}}
*Optional: add to default runlevel: {{cmdroot|rc-update add hdapsd default, rc-update add hdapsd battery}}
Write an eMail to abartel[Ã¤d]htwm.de, if you want to get my hdapsd-20060326.ebuild and please upload it.

=== Building an applet ===
====hdaps-gl====
*Make sure you have installed hdaps [and loaded] and ?opengl?
*Download <tt>hdaps-gl-0.0.5</tt> from the web.
*Extract files to {{path|/opt/hdaps-gl}}.
*{{cmdroot|make}}
*Start the applet: {{cmdroot|./hdaps-gl}}

====khdapsmon====
This application uses GNU autotools, so building it is the same as any other autotooled program:
*extract the source somewhere and change to that directory,
*run {{cmdroot|./configure && make && make install}}.
See [[#Getting the files|above]] for Debian packages and a Gentoo ebuild.

====gnome-hdaps-applet====
=====Debian/Ubuntu=====
Packages available at site listed above (with source packages that can do the building for you)

==Troubleshooting==
See the [[Problem with APS harddisk parking]] page for troubleshooting APS issues.
{{NOTE|1=If you use [[tp_smapi]], remember to include the option <tt>HDAPS=1</tt> when [[Tp_smapi#Installation|installing tp_smapi]]. Also, you might need to build the hdaps driver as module.}}

==Further Information==
*Additonal information and support is available through the [[Mailinglists#HDAPS Developers Mailinglist|hdaps-devel]] mailinglist and its archive.

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