Lesen¶

Um auszulesen, wie eine Komponente momentan eingestellt ist (status) und welche Optionen zur Verfügung stehen (commands), ist folgender Befehl zu verwenden:

cat /proc/acpi/ibm/KOMPONENTE 

Welche Komponente es gibt, sieht man mit

ls /proc/acpi/ibm/

Dabei kommt z.B. heraus:

beep  bluetooth  cmos  driver  fan  hotkey  led  light  thermal  video  volume

Wird eine Komponente vom aktuellen Gerät nicht unterstützt, so kommt die Rückmeldung

status:     not supported

Schreiben¶

Um die Einstellungen einer Komponente zu verändern, muss die Eingabe an die jeweilige Datei geleitet werden. Das geschieht mit dem echo-Befehl. Weil Dateien im /proc-Verzeichnis aber nur mit Root-Rechten verändert werden dürfen, ist eine verschachtelte Umleitung notwendig. Also entweder durch das Kapseln des Befehls in eine eigene Shell:

sudo bash -c "echo OPTION > /proc/acpi/ibm/KOMPONENTE" 

oder durch eine Umleitung über tee.

echo OPTION | sudo tee /proc/acpi/ibm/KOMPONENTE 

Es können mehrere Optionen gleichzeitig an eine Komponente übergeben werden, sie sind dann durch Kommas zu trennen. Falsch geschriebene Optionen geben eine Fehlermeldung aus.

Speichern¶

Sollen gewisse Komponenten bei jedem Systemstart mit einer bestimmten Option automatisch geladen werden, so kann dies in der Datei /etc/modprobe.d/thinkpad_acpi.conf festgelegt werden. Einträge haben die Form KOMPONENTE=OPTION, eine modifizierte Datei könnte folgendermassen aussehen:

options thinkpad_acpi experimental=1 fan_control=1 hotkey=enable,0xffff8f bluetooth=enable

Nicht alle der hier beispielhaft genannten Optionen machen Sinn, sondern sollten nur bei Bedarf aktiviert werden. Eine Übersicht der möglichen Optionen liefert der Befehl:

modinfo thinkpad-acpi 

Fn-Hotkeys¶

In /proc/acpi/ibm/hotkey können die Fn -Sondertasten aktiviert und deaktiviert, bzw. deren aktuelle Einstellung abgelesen werden. Grundsätzlich freigeschaltet und gesperrt werden können diese Tasten mit den Optionen enable und disable:

echo enable
echo disable 

Es lassen sich aber auch nur einzelne Tasten ein- und ausschalten. Dazu bedient sich der Treiber folgender 16-Bit-Maske (die Zuordnungen der ACPI-Ereignisse können von Modell zu Modell variieren, eine Übersicht bietet das entsprechende Artikel im ThinkWiki):

Es ist nun die Summe der Bit-Masken aller zu aktivierender Hotkeys an die hotkey-Komponente zu übergeben. Dazu einige Beispiele:

echo 0xffff   # Alle möglichen Hotkeys werden aktiviert
echo 0x0000   # Alle möglichen Hotkeys werden deaktiviert
echo 0xff9f   # Alle möglichen Hotkeys außer Fn + F8 werden aktiviert
echo 0x080c   # Nur Fn + F3, Fn + F4 und Fn + F12 werden aktiviert 

Mit der Option reset schließlich lässt sich die ursprüngliche Maske wiederherstellen:

echo reset 

Fn-Hotkeys W510 Bildschirmhelligkeit¶

Wegen den Nvidia-Grafiktreibern funktioniert die Bildschirmhelligkeit Reglung über die Fn-Tasten erst, nachdem man in der Datei /etc/X11/xorg.conf im Bereich Device folgende Option hinzufügt:

1

Option "RegistryDwords" "EnableBrightnessControl=1"

Danach den Benutzer ab- und wieder anmelden und das Regeln der Bildschirmhelligkeit funktioniert wieder.

Temperatur-Sensoren¶

Die meisten ThinkPads verfügen über mindestens sechs Temperatur-Sensoren, übergeben dem normalen ACPI aber nur die CPU-Themperatur (einlesbar unter /proc/acpi/thermal_zone/THM0/temperature). Unter /proc/acpi/ibm/thermal hingegen können bis zu 16 verschiedene Temperatur-Sensoren abgelesen werden. Das ist insbesondere deswegen interessant, weil Lm sensors ThinkPads nicht unterstützen. Hier die Ausgabe bei einem T43 (nicht vorhandene Sensoren werden mit -128 ausgewiesen):

$ cat /proc/acpi/ibm/thermal
temperatures:   00 00 00 00 00 -000 00 -000 00 00 00 -000 -000 -128 -128 -128

Wo genau die Sensoren liegen, variiert von Modell zu Modell; folgende Angaben treffen aber für die meisten neueren ThinkPads zu:

Ein Modell-spezifische Zusammenstellung, an welcher Stelle welcher Sensor ausgewiesen wird, findet sich auf thinkwiki.org .

Bei dieser Komponente lässt sich manuell nichts verändern; zum Lesen und Überwachen der Temperatur-Sensoren eignet sich folgender Befehl, wobei X das Zeitintervall in Sekunden angibt, in welchem die Sensor-Daten neu ausgegeben werden sollen:

watch -n X cat /proc/acpi/ibm/thermal 

Lüfter¶

Unter /proc/acpi/ibm/fan lässt sich der Lüfter manuell steuern, was besonders interessant ist, weil der übliche Weg mit Lm sensors bei ThinkPads nicht unterstützt wird.

sudo apt-get install thinkfan 

sudo aptitude install thinkfan 

Grundsätzlich lässt sich der Lüfter mit den Befehlen enable und disable ein- und ausschalten.

echo enable
echo disable 

Die direkte Steuerung des Lüfters erfolgt über Levels, wobei die gewünschte Stufe jeweils als level X zu übergeben ist (nicht jedes Level muss zu einer spürbaren Veränderung führen):

echo level 0           # stoppt den Ventilator
echo level 1           # niedrigste Stufe
...
echo level 7           # höchste (gesicherte) Stufe
echo level disengaged  # Lüfter läuft ungebremst (kann zu Hardware-Schäden führen)
echo level auto        # überlässt die Lüfter-Steuerung dem PC 

Zur Sicherheit verfügt die Lüftungssteuerung zudem über eine Überwachungsfunktion (watchdog): ihr kann eine Zeitspanne zwischen "1" und "120" Sekunden übergeben werden, nach deren Ablauf dem Lüfter automatisch das enable-Kommando (mit dem Level auto) übergeben wird, sofern inzwischen vom Benutzer kein neues Kommando eingegangen ist:

echo watchdog 30 

Einmal gesetzt, bleibt der Wachhund auch für jede weitere Manipulation gesetzt, bis er entweder manuell verändert oder mit 0 ausgeschaltet wird.

Bildschirm-Helligkeit¶

Unter /proc/acpi/ibm/brightness kann die Helligkeit des LCD-Bildschirms eingestellt werden. Dies geschieht entweder, indem als level X direkt eine Helligkeitsstufe zwischen "0" (dunkelste) und "7" (hellste) eingegeben wird,

echo 'level 0'
...
echo 'level 7' 

oder indem mit up und down die Helligkeit eine Stufe höher, bzw. tiefer gestellt wird (entspricht den Tastenkombinationen Fn + Pos1 und Fn + Ende ):

echo up
echo down 

Bei manchen Modellen kann die Helligkeit über /sys/class/backlight/acpi_video0 (oder thinkpad_screen ab Ubuntu 11.04) gesteuert werden. Andere Modelle (getestet für X240) nutzen /sys/class/backlight/intel_backlight/brightness, wobei in der Datei max_brightness der Helligkeitsmaximalwert hinterlegt ist. Hier schaltet

echo 0 

den Bildschirm ab, ohne dass er sich durch Mausbewegung etc. wieder einschaltet – im Gegensatz zu:

xset dpms force off 

Lautstärke-Regler¶

Um mit /proc/acpi/ibm/volume die Lautstärke regeln zu können muss dem thinkpad-acpi Modul zusätzlich der Parameter volume_control=1 übergeben werden. Dann kann entweder als level X direkt eine Stufe zwischen "0" (stumm) und "15" (Maximum) eingegeben werden,

echo 'level 0'
...
echo 'level 15' 

oder es kann mit up und down die Lautstärke eine Stufe höher, bzw. tiefer gestellt werden. Allerdings entspricht nicht zwingend jede Stufe einer eigenen Lautstärke, so dass nicht jeder Schritt eine hörbare Veränderung hervorrufen muss.

Mit mute schließlich kann die Lautstärke ausgeschaltet werden; dabei ist zu beachten, dass der Stumm-Modus nicht mit einem Level-Befehl, sondern nur mit up oder down wieder verlassen werden kann:

echo up
echo down
echo mute 

Alternativ lässt sich die Lautstärke auch mit dem Befehl amixer -D [device] set Console [0-14,mute,unmute] regeln.

Bildschirmlampe¶

Unter /proc/acpi/ibm/light lässt sich das ThinkLight ein- und ausschalten sowie sein aktueller Status ablesen. Zum Ein- und Ausschalten dienen die Optionen on' und off (entspricht Fn + Bild ↑ ):

echo on
echo off 

Einstellung via CMOS¶

Alternativ besteht die Möglichkeit, die eben erwähnten und einige weitere Komponenten über eine interne acpi-Schnittstelle unter /proc/acpi/ibm/cmos anzusprechen. Die Eingabe erfolgt über eine Zahl zwischen 0 und 21

echo 0
...
echo 21 

wobei zu folgenden Zahlen die Effekte bekannt sind (möglicherweise von Modell zu Modell verschieden, bitte ergänzen):

Bluetooth¶

In /proc/acpi/ibm/bluetooth kann ein installiertes Bluetooth-Gerät ein- und ausgeschaltet sowie der aktuelle Status ausgelesen werden. Zum Ein- und Ausschalten dienen die Optionen enable und disable (fürs Bluetooth entspricht dies Fn + F5 ):

echo enable
echo disable 

Eine Alternative zum Ein- und Ausschalten ist der Befehl rfkill.

Video-Ausgänge¶

In /proc/acpi/ibm/video lassen sich der LCD-, der CRT- und, falls vorhanden, der DVI-Video-Ausgang steuern. Jeder lässt sich mit X_enable, bzw. X_disable ein- und ausschalten:

echo lcd_enable    # bzw. lcd_disable
echo crt_enable    # bzw. crt_disable
echo dvi_enable    # bzw. dvi_disable 

Zudem kann mit auto_enable, bzw. auto_disable ein automatisches Wechseln des aktiven Video-Ausgangs - etwa beim Zuklappen des Laptops - ein- und ausgeschaltet werden (eingeschaltet kann die Option manchmal zu einem Flackern führen). Wenn die Option ausgeschaltet ist, kann mit video_switch der Video-Ausgang manuell umgeschaltet werden (entspricht Fn + F7 ):

auto_enable        # bzw. auto_disable
video_switch 

Damit besteht etwa die Möglichkeit, einen Beamer zu benutzen, auch wenn dieser beim Hochfahren noch nicht an den PC angeschlossen war.

Ultra-Bay¶

Unter /proc/acpi/ibm/bay lässt sich der Status der Ultra-Bay ablesen; für ThinkPad-Modelle, die über keinen Schalter verfügen, um die Ultra-Bay bei laufendem PC auszuwerfen, besteht zudem die Möglichkeit, mit der Option eject die notwendigen ACPI-Ereignisse für ein sicheres Entfernen zu veranlassen:

echo eject 

Sobald die Kontrollleuchte an der Ultra-Bay erlischt, kann sie sicher entfernt werden.

Docking-Station¶

Der Zustand einer Docking-Station kann unter /proc/acpi/ibm/dock ausgelesen werden. Damitt ist es möglich, die ACPI-Ereignisse eines An- und Abdockens hervorzurufen:

echo undock
echo dock 

Letzteres ist etwa dann sinnvoll, wenn der PC nicht innerhalb der Docking-Station gestartet wurde und sie nun nicht automatisch erkennt. Der undock-Befehl löst nur die Dock-spezifischen ACPI-Ereignisse aus, weitere an der Dock angeschlossene Hardware muss separat ausgeworfen werden.

Kontrollleuchten¶

In /proc/acpi/ibm/led lassen sich die Kontrollleuchten ansprechen. Zur Verfügung stehen die Optionen on, off und blink:

echo X on
echo X off
echo X blink 

"X" ist dabei ein Zahl zwischen "0" und "7", wobei die Zahlen bei den meisten Modellen für folgende Leuchten stehen:

Für Sonderfälle bietet diese Tabelle den besten Überblick.

Warntöne¶

Unter /proc/acpi/ibm/beep können eine Reihe von Warntönen ausgelöst werden, indem der Komponente eine Zahl zwischen "0" und "17" übergeben wird:

echo X 

Die Zahlen stehen für folgende Warntöne:

Der Treiber¶

Unter /proc/acpi/ibm/driver erfährt man, welche Treiberversion aktuell installiert ist. In diese Datei lässt sich entsprechend nicht schreiben.

ecdump¶

In /proc/acpi/ibm/ecdump lassen sich schließlich die Werte von 256 internen Kontroll-Registern lesen. Werte, die sich seit dem letzten Ablesen verändert haben, sind mit einem Stern markiert. Damit ist es möglich, durch spezifisches Verändern von Hardware-Begebenheiten auf die zugehörigen Kontroll-Register zu schließen. Genaueres dazu ist der Entwickler-Dokumentation von ibm-acpi zu entnehmen.