Lesen¶

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

cat /sys/devices/platform/thinkpad_acpi/KOMPONENTE 

Welche Komponenten es gibt, sieht man mit

find /sys/devices/platform/thinkpad_acpi/ -type f | grep -E -v 'modalias|input|power|rfkill|trigger|uevent' | sort 

Dabei kommt z.B. heraus:

/sys/devices/platform/thinkpad_acpi/bluetooth_enable
/sys/devices/platform/thinkpad_acpi/cmos_command
/sys/devices/platform/thinkpad_acpi/driver_override
/sys/devices/platform/thinkpad_acpi/hotkey_adaptive_all_mask
/sys/devices/platform/thinkpad_acpi/hotkey_all_mask
/sys/devices/platform/thinkpad_acpi/hotkey_bios_enabled
/sys/devices/platform/thinkpad_acpi/hotkey_bios_mask
/sys/devices/platform/thinkpad_acpi/hotkey_enable
/sys/devices/platform/thinkpad_acpi/hotkey_mask
/sys/devices/platform/thinkpad_acpi/hotkey_poll_freq
/sys/devices/platform/thinkpad_acpi/hotkey_radio_sw
/sys/devices/platform/thinkpad_acpi/hotkey_recommended_mask
/sys/devices/platform/thinkpad_acpi/hotkey_source_mask
/sys/devices/platform/thinkpad_acpi/leds/tpacpi::standby/brightness
/sys/devices/platform/thinkpad_acpi/leds/tpacpi::standby/max_brightness
/sys/devices/platform/thinkpad_acpi/leds/tpacpi::thinklight/brightness
/sys/devices/platform/thinkpad_acpi/leds/tpacpi::thinklight/max_brightness
/sys/devices/platform/thinkpad_acpi/leds/tpacpi::thinkvantage/brightness
/sys/devices/platform/thinkpad_acpi/leds/tpacpi::thinkvantage/max_brightness
/sys/devices/platform/thinkpad_acpi/wakeup_hotunplug_complete
/sys/devices/platform/thinkpad_acpi/wakeup_reason
/sys/devices/platform/thinkpad_acpi/wwan_enable

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 /sys-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 sh -c "echo OPTION > /sys/devices/platform/thinkpad_acpi/KOMPONENTE" 

oder durch eine Umleitung über tee.

echo OPTION | sudo tee /sys/devices/platform/thinkpad_acpi/KOMPONENTE 

Speichern¶

Sollen gewisse Komponenten bei jedem Systemstart mit einer bestimmten Option automatisch geladen werden, so kann dies in einer Datei /etc/modprobe.d/thinkpad_acpi.conf (neu anzulegen) festgelegt werden ^[2]. Einträge haben die Form KOMPONENTE=OPTION, die Datei könnte z.B. folgendermassen aussehen:

options thinkpad_acpi experimental=1 fan_control=1

Der Name der Datei spielt übrigens keine Rolle, solange er auf .conf endet.

Eine Übersicht der möglichen Optionen liefert der Befehl:

modinfo thinkpad_acpi | grep 'parm:' 

Ladeschwellen (ab Ubuntu 18.04.2)¶

Seit Kernel 4.18.0-17 kann man in den Verzeichnissen unterhalb /sys/class/power_supply/BAT0 bzw. BAT1 nicht mehr nur die Daten des/der Akkus auslesen, sondern zusätzlich das Ladeverhalten beeinflussen.

Dabei ist modellabhängig

• BAT0 der interne bzw. Hauptakku,

• BAT1 der Ultrabay-, Slice- bzw. Wechselakku.

Folgende Dateien sind relevant:

Folgende Befehle aktivieren die Werkseinstellung:

echo 100 | sudo tee charge_stop_threshold
echo 96 | sudo tee charge_start_threshold 

LEDs¶

In den Verzeichnissen unterhalb /sys/devices/platform/thinkpad_acpi/leds/ lassen sich

• ThinkLight,

• Tastatur-Hintergrundbeleuchtung,

• Tasten-LEDs; sowie

• Kontrolleuchten

ein- und ausschalten bzw. in der Helligkeit anpassen, sowie der aktuelle Zustand auslesen.

Befindet man sich in einem der Verzeichnisse, läßt sich die zugehörige LED über die Datei brightness wie folgt schalten:

echo 255 | sudo tee brightness  # an
echo 0   | sudo tee brightness  # aus 

Den maximalen Wert für brightness liefert

cat max_brightness 

In der Regel wird hier 255 ausgegeben. Ausnahme ist die Tastatur-Hintergrundbeleuchtung, die 2 ausgibt und die brightness-Werte 0, 1, 2 unterstützt.

⚓︎

Temperatur-Sensoren¶

Ältere ThinkPads (bis zur Generation des X200/T400) verfügen über mindestens sechs Temperatur-Sensoren. Diese können zwar herkömmlich über Lm sensors ausgelesen werden, jedoch bietet bei diesen Modellen

cat /proc/acpi/ibm/thermal 

die Möglichkeit, bis zu 16 verschiedene Temperatur-Sensoren im kompakter Darstellung auszulesen. Hier die Ausgabe bei einem X200 (nicht vorhandene Sensoren werden mit -128 ausgewiesen):

temperatures:   29 35 -128 30 26 -128 25 -128 35 33 -128 -128 -128 -128 -128 -128

Wo genau die Sensoren liegen, variiert von Modell zu Modell; folgende Angaben treffen aber auf die meisten unterstützten ThinkPads zu:

Eine 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.

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

echo enable  | sudo tee /proc/acpi/ibm/fan
echo disable | sudo tee /proc/acpi/ibm/fan 

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 | sudo tee /proc/acpi/ibm/fan  # stoppt den Ventilator
echo level 1 | sudo tee /proc/acpi/ibm/fan  # niedrigste Stufe
...
echo level 7 | sudo tee /proc/acpi/ibm/fan  # höchste (gesicherte) Stufe
echo level disengaged | sudo tee /proc/acpi/ibm/fan # Lüfter läuft ungebremst (kann zu Hardware-Schäden führen)
echo level auto | sudo tee /proc/acpi/ibm/fan  # überlässt die Lüfter-Steuerung dem ThinkPad 

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 | sudo tee /proc/acpi/ibm/fan 

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

sudo apt-get install thinkfan 

Bluetooth, WWAN¶

In /sys/devices/platform/thinkpad_acpi/bluetooth_enable kann ein integriertes Bluetooth-Gerät ein- und ausgeschaltet, sowie der aktuelle Status ausgelesen werden.

Die Datei /sys/devices/platform/thinkpad_acpi/wwan_enable tut dasselbe für integriertes WWAN (UMTS/3G, LTE/4G).

Ein- und Ausschalten tut man per:

echo 1 | sudo tee bluetooth_enable  # an
echo 0 | sudo tee bluetooth_enable  # aus 

Fn-Hotkeys¶

In /sys/devices/platform/thinkpad_acpi/hotkey_mask kann die Behandlung der Fn -Sondertasten durch den Kerneltreiber aktiviert und deaktiviert, bzw. die aktuelle Einstellung abgelesen werden. Es werden allerdings nicht alle Fn -Sondertasten durch thinkpad_acpi behandelt.

Um einzelne Tasten ein- und auszuschalten, bedient sich der Treiber einer 32-Bit-Maske, deren untere 12 Bits nachstehend beschrieben werden (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 | sudo tee hotkey_mask  # Alle möglichen Hotkeys werden aktiviert
echo 0x0000 | sudo tee hotkey_mask  # Alle möglichen Hotkeys werden deaktiviert
echo 0xff9f | sudo tee hotkey_mask  # Alle möglichen Hotkeys außer Fn + F8 werden aktiviert
echo 0x080c | sudo tee hotkey_mask  # Nur Fn + F3, Fn + F4 und Fn + F12 werden aktiviert 

Den ursprünglichen Zustand kann man jederzeit mit

cat hotkey_recommended_mask | sudo tee hotkey_mask 

wieder herstellen.

Weitere vordefinierte Zustände kann man aus den Dateien hotkey_all_mask, hotkey_recommended_mask und hotkey_source_mask auslesen. Die detaillierte Beschreibung – auch für einige weitere, weniger gebräuchliche Hotkey-Komponenten – findet sich in der Kernel-Dokumentation 🇬🇧.

Weitere Komponenten¶

Dieser Artikel beschreibt nur Komponenten, die für die Mehrzahl der User interessant sind. Für weniger gebräuchliche Komponenten sei auf die Kernel-Dokumentation 🇬🇧 verwiesen.

Hotkey-Problembehebung¶

echo 0x00fc7fff | sudo tee hotkey_mask

echo 0x00fc7fff > /sys/devices/platform/thinkpad_acpi/hotkey_mask

1

Option "RegistryDwords" "EnableBrightnessControl=1"