ACPI Wakeup

Version vom 23. Februar 2009, 22:55 Uhr

Anwendung

Kernel < 2.6.22

Der Pfad lautet /proc/acpi/alarm. Die Weckzeit wird im Format YYYY-MM-DD HH:MM:SS erwartet. Unbedingt darauf achten, ob die HW-Uhr in UTC oder in lokaler Zeit läuft! Gegebenenfalls muss man eine oder zwei Stunden abziehen.

Beispiel:

 echo 2006-02-09 23:05:00 > /proc/acpi/alarm

Kernel >= 2.6.22

Der Pfad lautet /sys/class/rtc/rtc0/wakealarm. Näheres zur benötigten Kernelkonfiguration siehe MythTV-Wiki-Eintrag zu ACPI-Wakeup. Die Weckzeit wird als Anzahl der Sekunden seit dem 01.01.1970 erwartet und ohne Beachtung der jeweiligen Zeitzone in YYYY-MM-DD HH:MM:SS umgerechnet. Es ist daher ratsam, die Systemuhr in UTC laufen zu lassen, um im Shutdown-Skript keine Zeitzonen-abhängige Korrektur der vom VDR kommenden UTC-Zeiten vornehmen zu müssen.

Ist bereits ein Wert gesetzt, so muss der Alarm erst wieder deaktiviert werden, sonst schlägt ein zweites Setzen fehl. Dies geschieht durch Setzen eines Datums in der Vergangenheit (z.B. 0).

Hinweis: Bei manchen Motherboards muss man den HPET deaktivieren. Die Deaktivierung erreicht man indem man dem kernel hpet=disable als Parameter übergibt. Da die RTC-Treiber ein HPET-Gerät emulieren genügt es nicht während der Kernel-Konfiguration CONFIG_HPET abzuwählen!

Beispiel:

 echo 0 > /sys/class/rtc/rtc0/wakealarm
 date +%s -d "Fri Feb 22 21:00:00 MET 2008" > /sys/class/rtc/rtc0/wakealarm

Test

Bei beiden Varianten kann mittels...

 cat /proc/driver/rtc

...der Erfolg des Setzens überprüft werden.

Überprüfen der Hardwarefähigkeiten

Voraussetzung für das Funktionieren von ACPI-Wakeup ist natürlich ein ACPI-fähiges Motherboard, was auf alle Consumer-Boards ab dem Jahr 2000 zutreffen sollte. Bevor man sich genauer mit der Thematik auseinandersetzt, ist es sinnvoll, die Fähigkeiten des Boards herauszufinden. Interessant ist hier besonders, ob das Setzen des Datums und das Aufwachen aus dem SoftOff-Zustand unterstützt wird.

Diese Informationen sind in einer standardisierten Tabelle, der Sog. FADT (Fixed ACPI Description Table) hinterlegt. Bei aktuellen Kerneln (>= 2.6.22) werden diese Informationen im Kernel-Log ausgegeben:

 ACPI: RTC can wake from S4
 ...
 rtc0: alarms up to one month

Hat man nur einen älteren Kernel zur Verfügung, muss man die FADT selber über eine Pseudodatei im proc-Verzeichnisbaum auslesen. Das geschieht wie folgt:

 cat /proc/acpi/fadt > ~/fadt.bin

Diese Datei kann nun in einem Hexeditor (z. B. xxd oder KHexEdit) geöffnet werden. Interessant sind die Bytes 0x6A (106) und 0x6B (107). Sind diese nicht null, sollte das Board das Setzten des Tages (106) und des Monats (107) unterstützen. Die Fähigkeit, aus Zustand S4 aufzuwachen, wird mit dem höchstwertigen Bit im Byte 0x70 (112) kodiert.

Beispiel (interessante Bytes mit * markiert):

 xxd -g 1 ~/fadt.bin
 0000000: 46 41 43 50 74 00 00 00 01 bf 47 42 54 20 20 20  FACPt.....GBT   
 0000010: 41 57 52 44 41 43 50 49 31 2e 30 42 41 57 52 44  AWRDACPI1.0BAWRD
 0000020: 00 00 00 00 00 00 ef 03 c0 30 ef 03 00 00 09 00  .........0......
 0000030: b2 00 00 00 a1 a0 00 00 00 40 00 00 00 00 00 00  .........@......
 0000040: 04 40 00 00 00 00 00 00 00 00 00 00 08 40 00 00  .@...........@..
 0000050: 2c 40 00 00 28 40 00 00 04 02 00 04 04 04 10 00  ,@..(@..........
 0000060: 5a 00 84 03 00 00 00 00 01 01*0d*00*00 00 00 00  Z...............
 0000070:*a5*04 00 00

Dieses Board (Gigabyte GA-6OXM) unterstützt also das Aufwachen aus S4 (0xA5 = 10100101b) und das Setzten des Tages, nicht aber das Setzen des Monats.

Hinweise

• Manche Mainboards sind etwas begriffsstutzig, so dass die Weckzeit zweimal in /proc/acpi/alarm geschrieben werden muss. Die Gentoo-VDR-Skripte machen das bereits.
• Manche Mainboards wachen nicht auf, wenn nach dem Speichern der Aufwachzeit die Hardwareuhr verändert wird, was meist beim Herunterfahren mittels eines Init-Skriptes geschieht. Die meisten Distributionen halten einen Parameter in ihren Init-Skripten oder Konfigurationsdateien bereit, um dieses zu deaktivieren. Alternativ kann man das Skript auch so modifizieren, dass es direkten ISA-Zugriff verwendet. Dazu dem hwclock-Aufruf "hwclock --systohc" zusätzlich den Parameter "--directisa" mitgeben. Das Skript findet man mit:

 grep "hwclock" /etc/init.d/*

weitere ausführliche Lösungen für debian, redhat, suse mythtv.org
nur debian systeme: /etc/init.d/hwclock.sh editieren, unter help.ubuntu.com

• Wenn ein Board aus S4 aufwachen kann, ist die Chance groß, dass es auch aus dem SoftOff erwacht, auch wenn dies vom ACPI-Standard nicht vorgesehen ist.
• ACPI-Wakeup ist verwandt mit der BIOS-Option "Wake on RTC", bei der man im BIOS eine Aufwachzeit einstellt. Diese Option muss je nach Board mal aktiviert, mal deaktivert sein, damit ACPI-Wakeup funktioniert.

ACPI Test Script

#!/bin/bash

# Startet dem Rechner nach 3 Minuten über ACPI neu. 

min=`date "+%M"`
nextmin=`expr $min + 3`
nextboot=`date "+%Y-%m-%d %H:"$nextmin:00`
echo $nextboot > /proc/acpi/alarm  # Einige Mainboards sind etwas begriffsstutzig,
echo $nextboot > /proc/acpi/alarm  # sie kapieren erst nach zwei Aufrufen, was Sache ist.
  
echo "Aktuelle Zeit:         "`date "+%Y-%m-%d %H:%M:%S"`
echo "Starte Rechner neu um: "`cat /proc/acpi/alarm`
echo "Fahre Rechner nun runter." 

#busybox poweroff
#/usr/bin/poweroff.pl
poweroff

Konkretes VDR Shutdown Script

Meine Uhr läuft auf Localtime (UTS=no in /etc/rcS) - deshalb funktioniert bei mir folgendes Skript:

sudo hwclock --systohc --localtime
 
#ACPI
echo "Arguments:  $*"
echo "Next timer: $1 seconds from 1970/01/01, UTC"

naechsterTimer=$(/bin/date --date "now +$2 seconds" "+%Y-%m-%d %H:%M:%S")

sudo chmod a+wr  /proc/acpi/alarm

# wakealarm löschen (wenn schon gesetzt, muss er gelöscht werden)
echo 0 >  /proc/acpi/alarm
#alarm setzen
echo $naechsterTimer >  /proc/acpi/alarm
echo $naechsterTimer >  /proc/acpi/alarm

sudo /sbin/shutdown -h now
EXITSTATUS=0
exit $EXITSTATUS

Anmerkung: der Vdr ruft dieses Skript mit den Parametern "Uhrzeit des nächster Timerevent in utc" und "Sekunden bis dahin" wie unschwer zu erkennen ist bezieht sich $2 bei der Zuweisung von naechsterTimer auf diesen zweiten Parameter.

Liste getesteter Mainboards

Hier eine Liste von Mainboards, bei denen das Aufwachen per ACPI funktioniert oder aber auch nicht funktioniert.

Von VDR-Benutzern werden erfolgreich bzw. nicht erfolgreich eingesetzt:

Siehe auch: http://linvdr.org/wiki/index.php?%20pagename=LinVDR-Mainboards

systohc bug = einige Mainboards wachen nicht auf, wenn nach dem setzen der Weckzeit die Hardwareuhr per hwclock --systohc aktualisiert wird. (bei vielen Distributionen der Fall) Details siehe auch im Abschnitt Hinweise innerhalb dieses Artikels.

ACPI Schlafmodus

Mit ACPI kann man ausserdem das System schlafen legen, wenn das Mainboard mitspielt. Je nach BIOS werden verschiedene Modi unterstützt, S1 (Standby), S3 (Suspend to RAM) oder S4 (Suspend to Disk). Im Gegensatz zum vollständigen Shutdown braucht das Reaktivieren des Systems viel weniger Zeit.

S1: CPU und einige andere Komponenten werden abgeschaltet. Das ist die einfachste, schnellste und schonendste Variante, die aber auch am wenigsten Strom spart.

 echo -n "standby" > /sys/power/state

S3: Ausser dem Speicher wird alles abgeschaltet. Der Inhalt des Speichers bleibt so erhalten. Beim Einschalten kehrt das System zum ursprünglichen Zustand zurück. Man muss jedoch drauf achten, dass vor dem Abschalten alle Dateisysteme unmounted werden (vor allem Festplatten oder Netzwerk-Dateisysteme), da sonst Datenverlust droht. Ausserdem sollte VDR beendet und die DVB-Treiber entladen werden, weil die DVB-Karten auch abgeschaltet werden und beim Reaktivieren neu initialisiert werden müssen.

 /etc/init.d/vdr stop
 /etc/init.d/dvb stop
 echo -n "mem" > /sys/power/state
 /etc/init.d/dvb start
 /etc/init.d/vdr start

Links

1. acpi-wakeup-0.1.tar.bz2
2. Anleitung
3. "Computer programmgesteuert aufwecken" von Mirko Dölle, Linux-Magazin 8/2004
4. ACPI-Projekthomepage (Dokumentation, Kernel-Patches, Wiki)
5. ACPI 2.0 Spezifikation, Compaq/Intel/Microsoft/Phoenix/Toshiba 27. Juli 2000