dumpsys battery

唯讀

電池服務目前的狀態：電量、充電狀態、健康度、電壓與溫度。

指令: adb shell dumpsys battery
指令: 系統服務（dumpsys）
風險: 唯讀

語法

dumpsys battery

範例

```
dumpsys battery
```
服務所知的一份即時快照。
```
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 有三個溫度來源、用三種不同的刻度：這裡是攝氏的十分之一，所以 `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	攝氏的十分之一：`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` 之前，那行以下都是假的。
這裡的溫度是十分之一度，`/sys/class/thermal/*/temp` 是千分之一度，而 `dumpsys thermalservice` 印的是浮點數的攝氏。搞混就是往任一方向差十倍。

這個我們有 UI

Android Battery Health 會透過 USB 執行這個指令並解析回應——只要 Chromium 系瀏覽器，不必安裝 SDK，也不會上傳任何東西。

開啟 Android Battery Health

指令	做什麼
dumpsys thermalservice	手機是不是正在因為溫度而降速，以及硬體層回報的每一個溫區，單位是攝氏。
top	一次性的行程表：CPU 占用、記憶體、狀態與指令列。
dumpsys meminfo	哪些行程最吃記憶體，量的是 PSS（按比例分攤的用量）。

其他系統服務（dumpsys）指令

指令	做什麼
dumpsys diskstats	每個分割區的剩餘空間、一次磁碟寫入延遲的實測，以及一份快取起來的各 app 空間用量。
dumpsys sensorservice	手機上的每一個感測器，含廠商、type、取樣率與批次能力，以及一段近期讀數的緩衝。
dumpsys package	套件管理員知道的一切：版本、路徑、flags、安裝來源，以及每個使用者的狀態。
dumpsys activity activities	現在哪個 app 在前景，以及它背後的 task 與 stack 結構。
dumpsys dropbox	平台用來存放當機、ANR 與 tombstone 的環形緩衝——這是不用 root 讀 ANR 追蹤的方法。

這些行為是在撰寫 Web ADB 工具背後的解析程式時，對照 AOSP、toybox 與核心原始碼查證的。真的會因 Android 版本或廠牌而異的地方，這一頁會直接說明，而不是給你一個在半數手機上都是錯的數字。

常見問題

adb shell 指令要怎麼執行？

在手機上打開開發者選項與 USB 除錯、接上線，然後從裝了 platform-tools 的機器執行 `adb shell <指令>`——或者只執行 `adb shell` 取得互動提示字元，再直接打指令、不用前綴。如果指令會輸出二進位資料（例如截圖），請改用 `adb exec-out` 而不是 `adb shell`：單純的 shell 服務會配一個終端機，而它會改寫換行位元組並毀掉資料。

adb shell 指令需要 root 嗎？

這份參考裡的都不用。它們以 `shell` 使用者身分執行，可以針對自己的 Android 使用者管理套件、讀取大多數 `dumpsys` 服務、寫入設定提供者、注入輸入，以及讀取共用儲存空間。需要 root 的是這份參考刻意避開的事：讀取其他 app 的私有資料（除了對可除錯版本使用 `run-as`）、寫入系統分割區，或直接讀 `/data/anr`。

為什麼在我的手機上輸出看起來不一樣？

不是 Android 版本就是廠商。有些旗標與欄位是從特定版本才有的，那些都在各指令頁註明了。其餘是廠商改動，而受影響最深的是 `dumpsys`：一份 dump 是除錯輸出，它的文字就是那個服務的作者最後印了什麼，而廠商既會改它也會把改動往回移植。請用名稱而不是位置來讀欄位，並把沒見過的格式當成差異而不是失敗。

可以用瀏覽器而不是終端機來跑嗎？

很多指令可以——本站的 Web ADB 工具從 Chromium 系桌面瀏覽器透過 WebUSB 和手機對話，不必安裝 SDK，也不會上傳任何東西。每一頁在有對應工具時都會連過去。有兩個限制值得知道：同一時間只有一個程式能持有 ADB 介面，所以桌面的 `adb server` 要先停掉；而 `adb forward` 與 `adb reverse` 在瀏覽器裡完全無法運作。

比較想按而不是打字？Web ADB Toolkit 會從瀏覽器透過 USB 執行這類指令。或者瀏覽全部指令。

語法

範例