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 はブラウザでは一切動きません。

dumpsys sensorservice

読み取りのみ

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

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

構文

dumpsys sensorservice

使用例

```
dumpsys sensorservice
```
センサー表と、センサーごとの直近の測定値。
```
getevent -lp
```
入力側のもう半分：タッチパネルを含む生の evdev デバイス。

出力の読み方

出力例

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]	呼び出し側にそのセンサーの権限がありません。値は「欠けている」のではなく「伏せられている」のです。

必要な権限

`SensorService` はネイティブなので、チェックもいつもの Java のものではありません。`SensorService::dump` は `PermissionCache::checkCallingPermission` に `android.permission.DUMP` を問い合わせ――これは Shell パッケージが持っています――失敗するとセンサー一覧の代わりに拒否の行を末尾に足します。センサー表を見るのに root は要りません。その上にもう 1 つ静かな関門があり、混乱するのはそちらです。同じ関数の中で `privileged` は `getCallingUid() == 0`、つまり root だけとして計算されます。`adb shell` は uid 2000 で動くので決して privileged にはならず、`getRequiredPermission()` が空でないセンサーはすべて、直近イベントのバッファがマスクされた形式に切り替わります。何も拒否されず、警告も出ません。タイムスタンプはそのまま並び、数値があるべき場所に `[value masked]` が入ります。測定値が欠けているのでも、センサーが眠っているのでも、ドライバが壊れているのでもありません。実行し直しても変わりません。このページで `adb root` が変えられる唯一のものですが、user ビルドでは `adb root` が拒否されるので、市販端末ではマスクされたままです。センサー表そのもの――handle、ベンダー、レート、バッチング――はマスクされません。だから Android Sensor Tester は素のシェルから一覧を組み立てられます。

エラーメッセージの読み解き

メッセージ	意味
Permission Denial: can't dump SensorService from pid=4821, uid=10231	ネイティブのコードなので、この行には Java のダンプが持つ `from from` の重複がなく、足りない権限の名前も出ません。独自の文字列として照合してください。結果バッファに追記されるため標準出力に、しかもセンサー一覧の代わりに届きます。ぱっと見が「センサーの無い端末」に読めるのはそのせいです。
No Sensors on the device	サービスがセンサーを 1 つも保持していないときに出て、すぐ後ろにセンサーデバイス自身の初期化状態を載せた `devInitCheck : <n>` の行が続きます。そこが負の値なら、それは立ち上がらなかったハードウェア層からの errno です。本当にセンサーを積んでいないエミュレータイメージとはまったく別の問題で、このダンプから両者を見分ける唯一の手がかりがその値です。
Can't find service: sensorservice	サービスに接触する前に `dumpsys` バイナリが標準エラーへ出す行で、サービスマネージャに `sensorservice` の登録がありません。起動中なら普通のことです。標準エラーに出るので、`2>&1` なしで拾った実行では、理由がどこにも書かれていない空の一覧だけが残ります。
* SERVICE 'sensorservice' DUMP TIMEOUT (10000ms) EXPIRED *	10 秒は `dumpsys` の既定値で、このダンプは全センサーと全直近イベントバッファを歩くあいだ、サービスの接続ロックを握ります。残るのは出力の先頭、つまりセンサー表で、失われるのは末尾、つまり直近イベントです。切れたダンプは棚卸しとしてはまだ使えますが、測定値のサンプルとしては使えません。

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

テキストのダンプは長らく最大レンジ・分解能・消費電力を印字していません。プラットフォーム API と proto 形式には存在するので、それらが出るビルドはメーカー改変版です。
同名のセンサーが 2 つあると直近イベントのバッファの対応が曖昧になり、誤った結び付けは別のセンサーの値をプロットします。
このダンプはこの一族でいちばん不安定です。テキストが複数の別コンポーネントによって、共通のスキーマなしに組み立てられています。

これには UI があります

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

Android Sensor Tester を開く

コマンド	何をするか
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・カーネルのソースに突き合わせて確認しています。バージョンやメーカーで本当に挙動が変わるところは、世界の半分の端末で間違いになる数値を出す代わりに、そう書いてあります。