「Tp smapi」の版間の差分
(→3番目のオプション、カーネル: 微修正) |
(→インストール: 情報を更新) |
||
10行目: | 10行目: | ||
Ivy Bridge プロセッサあるいはそれよりも新しいプロセッサ (型番が {{ic|*30}}, {{ic|*40}}, {{ic|*50}} のモデル) が搭載された最新の Thinkpad にインストールしても、tp_smapi は動作しません。{{Pkg|tpacpi-bat}} か {{AUR|tpacpi-bat-git}} を使って下さい。 |
Ivy Bridge プロセッサあるいはそれよりも新しいプロセッサ (型番が {{ic|*30}}, {{ic|*40}}, {{ic|*50}} のモデル) が搭載された最新の Thinkpad にインストールしても、tp_smapi は動作しません。{{Pkg|tpacpi-bat}} か {{AUR|tpacpi-bat-git}} を使って下さい。 |
||
− | ==インストール== |
+ | == インストール == |
− | 最近 community リポジトリに移動された {{Pkg|tp_smapi}} パッケージを[[インストール]]してください。カスタムカーネルの [[linux-ck]] を使っている場合は [[AUR]] からインストールできる {{AUR|tp_smapi-ck}} が存在します。 |
||
+ | {{Pkg|linux}} の場合は {{Pkg|tp_smapi}} パッケージ、または {{Pkg|linux-lts}} の場合は {{Pkg|tp_smapi-lts}} を [[インストール]] します。他のすべてのカーネル (例:{{Pkg|linux-zen}}) の場合は、{{AUR|tp_smapi-dkms}} の使用を検討してください。 |
||
− | パッケージによって3つの新しい[[カーネルモジュール]]が追加されます: |
||
+ | ''tp_smapi'' (およびそのバリエーション) は、次の [[カーネルモジュール]] を提供します。 |
||
− | {| class="wikitable" align="center" style="width:100%; text-align:left;" |
||
− | |- style="text-align: center;" |
||
− | | colspan="2" | '''カーネルモジュール''' |
||
− | |- style="text-align: center;" |
||
− | | width="30%" |'''名前''' |
||
− | | |'''説明''' |
||
− | |- |
||
− | |tp_smapi |
||
− | | |
||
− | ThinkPad SMAPI サポート |
||
− | |- style="border-top:1px solid #aaaaaa;" |
||
− | |hdaps |
||
− | | |
||
− | IBM [[Hard Drive Active Protection System]] (HDAPS) ドライバー |
||
− | |- style="border-top:1px solid #aaaaaa;" |
||
− | |thinkpad_ec |
||
− | | |
||
− | ThinkPad の組み込みコントローラハードウェアへのアクセス (tp_smapi と hdaps のどちらも依存) |
||
− | |} |
||
+ | ; tp_smapi: ThinkPad SMAPI サポート |
||
− | 再起動後、tp_smapi とその依存モジュールは自動的にロードされ、{{ic|/sys/devices/platform/smapi}} 下の sysfs インターフェイスが使えるようになります。 |
||
+ | ; hdaps: IBM ハードドライブアクティブ保護システム ([[HDAPS]]) ドライバー |
||
+ | ; thinkpad_ec: ThinkPad 組み込みコントローラーのハードウェアアクセス ({{ic|tp_smapi}} と {{ic|hdaps}} は両方ともこれに依存します) |
||
+ | |||
+ | 再起動後、{{ic|tp_smapi}} とその依存関係が自動ロードされ、{{ic|/sys/devices/platform/smapi/}} の sysfs インターフェイスが完全に機能するようになります。 |
||
==機能== |
==機能== |
2023年10月13日 (金) 10:23時点における版
tp_smapi は ThinkPad ノートパソコンのハードウェアから情報を取得したりコマンドを送信したりするカーネルモジュールのセットです。tp_smapi の情報は /sys/devices/platform/smapi
ファイルシステムに存在します。/proc
ファイルシステムと同じように、ファイルから情報を読み書きしたりハードウェアにコマンドを送信することが可能です。サポートされている ThinkPad ノートパソコンを使っている場合は、tp_smapi をインストールすることが強く推奨されます。
目次
サポートされているノートパソコン
まず、あなたのノートパソコンがサポートされているかどうか確認してください。Thinkwiki に サポートされている Thinkpad の完全なリスト が載っています。あなたの TP が stop_threshold をサポートしておらず start_threshold しかサポートしていない場合は #部分的にサポートされているノートパソコンの対処方法 を見て下さい。
Ivy Bridge プロセッサあるいはそれよりも新しいプロセッサ (型番が *30
, *40
, *50
のモデル) が搭載された最新の Thinkpad にインストールしても、tp_smapi は動作しません。tpacpi-bat か tpacpi-bat-gitAUR を使って下さい。
インストール
linux の場合は tp_smapi パッケージ、または linux-lts の場合は tp_smapi-lts を インストール します。他のすべてのカーネル (例:linux-zen) の場合は、tp_smapi-dkmsAUR の使用を検討してください。
tp_smapi (およびそのバリエーション) は、次の カーネルモジュール を提供します。
- tp_smapi
- ThinkPad SMAPI サポート
- hdaps
- IBM ハードドライブアクティブ保護システム (HDAPS) ドライバー
- thinkpad_ec
- ThinkPad 組み込みコントローラーのハードウェアアクセス (
tp_smapi
とhdaps
は両方ともこれに依存します)
再起動後、tp_smapi
とその依存関係が自動ロードされ、/sys/devices/platform/smapi/
の sysfs インターフェイスが完全に機能するようになります。
機能
以下は tp_smapi を使って行えることの一部です。自由に追加してください。
バッテリーの充電の制御
長時間にわたってノートパソコンのバッテリーを満充電の状態にしておくことは良いことではありません 。長時間バッテリーを使わなければならない状況ではないかぎり、できるだけバッテリーは 40-80% ほど残っている状態にしておくべきです。
一般的な方法
tp_smapi を使うことで充電を開始したり停止する閾値を制御することができます。以下のコマンドを実行して適当な値を設定してください:
echo 40 > /sys/devices/platform/smapi/BAT0/start_charge_thresh echo 80 > /sys/devices/platform/smapi/BAT0/stop_charge_thresh
上記の場合、バッテリーが 40% 以下になると充電が開始され、80% を超えるとそれ以上充電しなくなります。このように設定することでバッテリーの寿命を伸ばすことができます。
バッテリーを一度抜いて、再挿入したりすると、設定した閾値はデフォルトの値にリセットされることがあります。リセットを回避するには、値を設定するスクリプトを作成して、起動時やバッテリーが接続されたときにスクリプトを実行させるようにしてください。より詳しい手順は以下のとおりです。
スクリプト /usr/sbin/set_battery_thresholds
を作成:
#!/bin/sh # set the battery charging thresholds to extend battery lifespan echo ${2:-40} > /sys/devices/platform/smapi/BAT${1:-0}/start_charge_thresh echo ${3:-80} > /sys/devices/platform/smapi/BAT${1:-0}/stop_charge_thresh
上記のスクリプトを使ってバッテリーの閾値を設定するのはとても簡単で、(set_bat_thresh
がスクリプトの名前だとして) 以下のコマンドを入力するだけです:
set_battery_thresholds 0 96 100
引数を付けないで実行すると、BAT0 の閾値が 40% と 80% に設定されます。
スクリプトに実行可能属性を付与してください:
# chmod 744 /usr/sbin/set_battery_thresholds
起動時に systemd でスクリプトを実行します (initscripts の rc.local
を使うのはもう非推奨になりました)。まず /etc/systemd/system/tp_smapi_set_battery_thresholds.service
を作成:
[Unit] Description=Set Battery Charge Thresholds by tp_smapi [Service] Type=oneshot ExecStart=/usr/sbin/set_battery_thresholds RemainAfterExit=yes [Install] WantedBy=multi-user.target
そして systemd で有効化:
# systemctl enable tp_smapi_set_battery_thresholds.service
バッテリーが接続されたときもスクリプトを実行させるには、acpid をインストール・設定している必要があります。/etc/acpi/handler.sh
を編集してください:
#... other ACPI stuff battery) case "$2" in BAT0) case "$4" in 00000000) ;; 00000001) /usr/sbin/set_battery_thresholds ;; #... more ACPI stuff
設定が反映されているかどうか確認
設定が反映されたかどうか確認するには、以下の出力を確認します:
cat /sys/devices/platform/smapi/BAT0/start_charge_thresh cat /sys/devices/platform/smapi/BAT0/stop_charge_thresh
ハードディスクを落下から保護
tp_smapi にはノートパソコンの加速度計を読み取って、ハードドライブにダメージを与える落下などの動きを検出できるドライバーが含まれています。この機能に関する情報は HDAPS のページを見て下さい。
部分的にサポートされているノートパソコンの対処方法
部分的にしかサポートされていないノートパソコンでも、バッテリーの制御ができることがあります。まず実際にサポートされている機能を確認してください:
cat /sys/devices/platform/smapi/BAT0/start_charge_thresh cat /sys/devices/platform/smapi/BAT0/stop_charge_thresh
start-charge_thresh
はサポートされているのに stop_charge_thresh
はサポートされていない場合でも、コンピュータに充電を止めさせる方法が2つあります。
1番目のオプション、カスタムスクリプト
- 上述のようにスクリプト
/usr/sbin/set_battery_thresholds
を作成 - オリジナルの
/etc/acpi/handler.sh
を/etc/acpi/handler.sh.start
にコピー - 上述のように
/etc/acpi/handler.sh
を編集して/etc/acpi/handler.sh.stop
にコピー
以下のスクリプトをコピーして、実行可能属性を付与し、自由に値を調整して、cron などで数分ごとに root で実行するようにしてください。
#!/bin/bash CURRENTCHARGE=$(acpitool -b | cut -d, -f2 | cut -d. -f1 | cut -b2-) if [ $CURRENTCHARGE -gt 80 ]; then cp /etc/acpi/handler.sh.stop /etc/acpi/handler.sh echo 99 > /sys/devices/platform/smapi/BAT0/start_charge_thresh exit 0 fi if [ $CURRENTCHARGE -lt 60 ]; then cp /etc/acpi/handler.sh.start /etc/acpi/handler.sh echo 99 > /sys/devices/platform/smapi/BAT0/start_charge_thresh echo 0 > /sys/devices/platform/smapi/BAT0/start_charge_thresh exit 0 fi exit 0
2番目のオプション, tpacpi-bat
バッテリーの充電の閾値を制御するには、AUR から Perl スクリプトの tpacpi-bat または tpacpi-bat-gitAUR をインストールします。
次を実行して acpi_call
カーネルモジュールをロードしてください:
# modprobe acpi_call
もしくは /etc/rc.config
の MODULES にカーネルモジュールを追加します。
手動で閾値を設定するには以下を実行:
tpacpi-bat -v -s startThreshold 0 40 tpacpi-bat -v -s stopThreshold 0 80
上記の例で指定している 40 や 80 はバッテリーの最大容量からのパーセンテージです。必要に応じて調整してください。また、上記の行を /etc/rc.local
に追加することで起動時に実行させることができます。上記の値は永続的なはずですが、バッテリーを抜いたときに値がリセットされることがあります。
3番目のオプション、カーネル
カーネル 4.17 には、ThinkPad のバッテリ充電のしきい値を直接調整するオプションが追加されました。
echo 60 > /sys/class/power_supply/BAT0/charge_stop_threshold echo 40 > /sys/class/power_supply/BAT0/charge_start_threshold
値を表示しようとすると最後のセットのみが表示され、128が追加されます。
これは既知の問題ですが、バッテリの動作からわかるように実際は別の値が設定されています。
他の興味深いパラメータは /sys/class/power_supply/BAT 0/
にあります。