ByteScope

dumpsys sensorservice

読み取りのみ

端末にあるすべてのセンサーとそのベンダー、type、レート、バッチング。加えて直近の測定値のバッファ。

コマンド
adb shell dumpsys sensorservice
コマンド
システムサービス(dumpsys)
リスク
読み取りのみ

構文

dumpsys sensorservice

使用例

出力の読み方

出力例

Sensor List:
0x00000001) LSM6DSO Accelerometer | STMicro | ver: 1 | type: android.sensor.accelerometer(1) | perm: n/a | flags: 0x00000000
	continuous | minRate=12.50Hz | maxRate=416.00Hz | FIFO (max,reserved) = (3000, 600) events | non-wakeUp
Accelerometer: last 50 events
	 1 (ts=12345.678901234, wall=13:37:01.234) 0.12, 9.81, 0.03,

各センサーは 16 進の handle、閉じ括弧、そしてパイプ区切りのフィールドで、その後にタブで字下げされたレートとバッチングの行が続きます。さらに下の直近イベントのバッファは handle ではなくセンサーの「名前」で引かれ、新しいものから順に並びます。フィールドの順序はバージョンもメーカーも跨いで安定しないので、ラベルで読んでください。

出力フィールド

フィールド意味
0x…)センサーの handle。どのバージョンでも必ず印字される唯一のトークンです。
type: android.sensor.x(N)プラットフォームの type 文字列とその数値。
minRate / maxRate単位は Hz。名前は見た目と逆で、minRate は最大遅延から、maxRate は最小遅延から算出されます。
FIFO (max,reserved)バッチング容量をイベント数で。バッチングがない場合は代わりに `no batching` が出ます。
wakeUp / non-wakeUpサスペンドから端末を起こせるセンサーかどうか。
ts=boot time クロックの秒。サスペンドを挟むとバッファ内で単調でなくなり得ます。
[value masked]呼び出し側にそのセンサーの権限がありません。値は「欠けている」のではなく「伏せられている」のです。

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

これには UI があります

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

Android Sensor Tester を開く

関連コマンド

dumpsys sensorservice と同じ作業で出てくるコマンド。

コマンド何をするか
geteventカーネルから生の入力イベントを流し読みします。各入力デバイスが何を報告できるかの一覧も取れます。
dumpsys thermalservice端末が発熱で性能を絞っているか、そしてハードウェア層が報告する各温度ゾーンを摂氏で表示します。
wm sizeディスプレイの解像度を報告します。上書きすれば、端末は別の画面のふりをします。

他のシステムサービス(dumpsys)コマンド

コマンド何をするか
dumpsys batteryバッテリーサービスの現在の状態:残量、充電状態、健康度、電圧、温度。
dumpsys diskstatsパーティションごとの空き容量、ディスク書き込み遅延の実測、そしてキャッシュされたアプリ別の使用量内訳。
dumpsys meminfoどのプロセスがメモリを最も使っているかを、PSS(比例配分したサイズ)で表示します。
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 経由で実行します。あるいは全コマンドを見る