dumpsys battery

読み取りのみ

バッテリーサービスの現在の状態：残量、充電状態、健康度、電圧、温度。

コマンド: adb shell dumpsys battery
コマンド: システムサービス（dumpsys）
リスク: 読み取りのみ

構文

dumpsys battery

使用例

```
dumpsys battery
```
サービスが知っていることの 1 回分のスナップショット。
```
cat /sys/class/power_supply/battery/current_now
```
充電電流をカーネル側と突き合わせます。こちらの単位はメーカーではなく power supply クラスが固定しています。

出力の読み方

出力例

Current Battery Service state:
  AC powered: false
  USB powered: true
  Charge counter: 3110000
  status: 2
  health: 2
  level: 71
  scale: 100
  voltage: 4038
  temperature: 302

字下げされた `key: value` の並びです。罠は単位です。Android には温度の情報源が 3 つあり、それぞれ違う尺度を使います。ここでは摂氏の 10 分の 1 なので `302` は 30.2 °C です。位置ではなく名前でフィールドを読んでください。メーカーは独自の行を並びのどこにでも挿し込みます。

出力フィールド

フィールド	意味
level / scale	`scale` に対する `level` として表される残量。`scale` は出荷されている端末ではどれも 100 ですが、誰も仮定しなくて済むように印字されています。
status	1 不明、2 充電中、3 放電中、4 充電していない、5 満充電。
health	2 良好、3 過熱、4 故障、5 過電圧、6 原因不明の故障、7 低温。
voltage	ミリボルト。`4038` は 4.038 V。
temperature	摂氏の 10 分の 1。`302` は 30.2 °C。
Charge counter	マイクロアンペア時。`3110000` は 3110 mAh。
Max charging current / voltage	それぞれマイクロアンペアとマイクロボルト。

バージョンとメーカーに関する注意

素の Android はここに充電電流もサイクル数も表示しません。`current now` や `cycle count` が出る端末はメーカー改変版で、その電流フィールドは符号も、ビルドによっては尺度も揺れます。大きさは疑い、向きは `status` から取ってください。
`(UPDATES STOPPED -- use 'reset' to restart)` は誰かが `dumpsys battery set` や `unplug` で値を注入したという意味です。その行より下は `dumpsys battery reset` まで作り物です。
ここの温度は 10 分の 1 度、`/sys/class/thermal/*/temp` は 1000 分の 1 度、`dumpsys thermalservice` は浮動小数点の摂氏です。取り違えるとどちらの方向にも 10 倍の誤りになります。

これには UI があります

Android Battery Health はこのコマンドを USB 経由で実行し、返ってきたものを解析します。Chromium 系ブラウザだけで、SDK も不要、どこにもアップロードしません。

Android Battery Health を開く

コマンド	何をするか
dumpsys thermalservice	端末が発熱で性能を絞っているか、そしてハードウェア層が報告する各温度ゾーンを摂氏で表示します。
top	1 回分のプロセス表：CPU 使用率、メモリ、状態、コマンドライン。
dumpsys meminfo	どのプロセスがメモリを最も使っているかを、PSS（比例配分したサイズ）で表示します。

他のシステムサービス（dumpsys）コマンド

コマンド	何をするか
dumpsys diskstats	パーティションごとの空き容量、ディスク書き込み遅延の実測、そしてキャッシュされたアプリ別の使用量内訳。
dumpsys sensorservice	端末にあるすべてのセンサーとそのベンダー、type、レート、バッチング。加えて直近の測定値のバッファ。
dumpsys package	パッケージマネージャが知っているすべて：バージョン、パス、flags、インストール元、ユーザーごとの状態。
dumpsys activity activities	いまどのアプリが前面にいるか、そしてその背後のタスクとスタックの構造。
dumpsys dropbox	クラッシュ、ANR、tombstone を保持するプラットフォームのリングバッファ。root なしで ANR トレースを読む方法です。

Web ADB ツール群のパーサを書きながら、AOSP・toybox・カーネルのソースに突き合わせて確認しています。バージョンやメーカーで本当に挙動が変わるところは、世界の半分の端末で間違いになる数値を出す代わりに、そう書いてあります。

よくある質問

adb shell のコマンドはどう実行しますか？

端末で開発者向けオプションと USB デバッグを有効にし、ケーブルを繋いだうえで、platform-tools を入れた機械から `adb shell <コマンド>` を実行します。`adb shell` だけを実行すれば対話プロンプトが出て、接頭辞なしで打てます。スクリーンショットのようにバイナリを出力するコマンドでは `adb shell` ではなく `adb exec-out` を使ってください。素のシェルサービスは端末を割り当て、それが改行のバイトを書き換えてデータを壊します。

adb shell のコマンドに root は必要ですか？

このリファレンスにあるものには不要です。すべて `shell` ユーザーとして動き、自分の Android ユーザー向けのパッケージ管理、ほとんどの `dumpsys` サービスの読み取り、設定プロバイダへの書き込み、入力の注入、共有ストレージの読み取りができます。root が必要なのはこのリファレンスがあえて避けていること、つまり他のアプリのプライベートデータの読み取り（debuggable なビルドに対する `run-as` を除く）、システムパーティションへの書き込み、`/data/anr` の直接読み取りです。

自分の端末では出力が違って見えるのはなぜ？

Android のバージョンか、メーカーのどちらかです。一部のフラグやフィールドは特定のリリースから入ったもので、それはコマンドごとに注記しています。残りはメーカーによる改変で、いちばん影響が大きいのは `dumpsys` です。ダンプはデバッグ出力で、そのテキストはサービスの作者が最後に印字した内容そのもの、しかもメーカーはそれを変えて自分の変更をバックポートします。フィールドは位置ではなく名前で読み、見慣れない形は失敗ではなく差分として扱ってください。

端末ではなくブラウザから実行できますか？

多くのコマンドは可能です。このサイトの Web ADB ツール群は、Chromium 系のデスクトップブラウザから WebUSB で端末と話し、SDK のインストールも不要、どこにもアップロードしません。各ページは、該当するツールがあればそこへリンクしています。知っておく価値のある制限が 2 つあります。ADB インターフェイスを保持できるプログラムは同時に 1 つだけなので、デスクトップの `adb server` は先に止める必要があります。そして `adb forward` と `adb reverse` はブラウザでは一切動きません。

打つより押したい場合は、Web ADB Toolkit がこの種のコマンドをブラウザから USB 経由で実行します。あるいは全コマンドを見る。

構文

使用例