getevent
読み取りのみカーネルから生の入力イベントを流し読みします。各入力デバイスが何を報告できるかの一覧も取れます。
- コマンド
- adb shell getevent
- コマンド
- 入力とタッチ
- リスク
- 読み取りのみ
構文
getevent [-l] [-t] [-p] [/dev/input/eventN]フラグと引数
| トークン | 意味 |
|---|---|
| -l | 素の 16 進ではなくカーネルのラベル名を印字します。 |
| -t | 各イベントにカーネルの monotonic なタイムスタンプを付けます。 |
| -p | 流し読みせず、各デバイスの能力を印字して終了します。 |
| /dev/input/eventN | デバイスを 1 つに絞ります。同時に各行のデバイス接頭辞が消えます。接頭辞はデバイス指定がなかったときだけ印字されるからです。 |
使用例
getevent -lpすべての入力デバイスとその軸・範囲。自分で終了します。
getevent -lt /dev/input/event3タッチパネル 1 つをタイムスタンプ付きで見ます。
出力の読み方
出力例
/dev/input/event3: EV_ABS ABS_MT_TRACKING_ID ffffffff
/dev/input/event3: EV_SYN SYN_REPORT 000000001 行 3 フィールド：イベント type、イベント code、値。値は符号なし 32 ビットの 16 進で印字され、これがここ最大の罠です。tracking id の `ffffffff` は -1、つまり「指が離れた」という合図で、符号なしとして読むと 40 億という、ごく普通の新しい接触に見えます。`SYN_REPORT` はフレームの境界です。その前は部分的なパケットで、それを描くと座標が半分だけ更新された指が表示されます。
出力フィールド
| フィールド | 意味 |
|---|---|
| EV_ABS / EV_KEY / EV_SYN | イベントの type：絶対軸、キー、同期の印。 |
| ABS_MT_SLOT | 続く軸がどの接触を指すかを選びます。 |
| ABS_MT_TRACKING_ID | 0 以上の値で接触が始まり、`ffffffff`（-1）で終わります。 |
| ABS_MT_POSITION_X / _Y | パネル自身の単位での接触位置。画面のピクセルではありません。 |
| SYN_REPORT | コミット：ここまでのフレームが完成しました。 |
| SYN_DROPPED | カーネルのキューが溢れました。溜めた状態を捨てて再同期してください。 |
| : value v, min a, max b, fuzz f, flat l, resolution r | 能力の行で、出力全体の中で唯一の 10 進の数値です。`max` は上限を含むので、0〜1439 の軸は 1440 個の位置を持ちます。 |
必要な権限
root も `adb root` も不要で、この一族には珍しく Android の権限すらありません。`/dev/input/*` は `ueventd.rc` によって `0660 root input` で作られるので、イベントノードを開けるかは素の Unix のグループの問題で、`adbd` はそれに意図して答えています。権限を落とすとき shell に決まった補助グループの組を渡すのですが、その配列の脇のコメントはこのツール自身を名指ししています。曰く `AID_INPUT to diagnose input issues (getevent)`。ロックされた製品版の端末で、他の多くが読めないのに生のタッチデータだけは普通の `adb shell` から読める理由がこれで、USB デバッグ以外に開発者向けオプションの関門がない理由でもあります。ここから 2 つ出てきます。このグループが与えるのは読み取りだけで、どのノードも `O_RDONLY` で開かれます。だからこのページはデジタイザを覗けても、タッチを合成することはできません。それは別の仕組みと別の権限を通る `input` の仕事です。そしてエラー報告そのものがフラグの向こうにあります。デバイスのエラーメッセージは冗長度マスクの `errs` ビットが立っているときだけ印字され、コマンドラインでデバイスを名指しすると既定でそのビットが立ちますが、`-q` はマスク全体を消します。つまり開けないノードに対する `getevent -q /dev/input/event3` は、何も印字しないまま非ゼロで終了します。
エラーメッセージの読み解き
| メッセージ | 意味 |
|---|---|
| could not open /dev/input/event3, Permission denied | `open()` が失敗し、カンマの後ろは C ライブラリの `strerror` です。`Permission denied` はプロセスが `input` グループにいないという意味で、adbd は自分でそのグループを与えるので、よくある原因は adbd が起こしたシェル以外から実行していることです。`No such file or directory` ならノードの番号が単に違います。当てずっぽうではなく `getevent -lp` で列挙してください。 |
| could not get driver version for /dev/input/event3, Inappropriate ioctl for device | ノードは開けたのに `EVIOCGVERSION` の ioctl が拒まれた、つまり evdev デバイスではありません。`getevent` はそのノードを諦めて非ゼロを返します。自分で選んだパスでこれが出るなら、たいてい `/dev/input` の下の `eventN` でないものを名指ししています。 |
| scan dir failed for /dev/input | デバイス引数がないと `getevent` はディレクトリを列挙しますが、これは個々のデバイスではなく列挙そのものが失敗しています。即座に 1 を返すのでストリームは一切得られません。パネルを疑う前に `/dev/input` が存在して辿れるかを確認してください。 |
| getevent: invalid option -z | 知らないスイッチです。使い方の説明が続き、何も開かずに 1 で終了します。覚えておく価値があるのは、ここのフラグが 1 文字で束ねられるからです。`-lp` は `-l -p` であり、束の中の打ち間違い 1 つが実行全体を落とします。 |
バージョンとメーカーに関する注意
- 軸は前の値が残ります。ドライバは変わったものだけを送るので、横に動いた指は前回の縦位置を保ちます。置き換えるのではなく積み上げてください。
- パネルの座標は画面の座標ではありません。対応付けは、軸の最小値を引いて「画面サイズ ÷（max − min + 1）」で拡縮します。+1 はごまかしではなく、最大値が上限を含むためです。
- あるパネルがディスプレイに対して回転や鏡像で取り付けられているかは、軸の範囲からは分かりません。実機で角を触って確かめる必要があります。
- `-l` を付けると値が単語になることがあります。キーの値は UP / DOWN / REPEAT、tool type は MT_TOOL_FINGER / MT_TOOL_PEN / MT_TOOL_PALM です。
これには UI があります
Android Sensor Tester はこのコマンドを USB 経由で実行し、返ってきたものを解析します。Chromium 系ブラウザだけで、SDK も不要、どこにもアップロードしません。
関連コマンド
getevent と同じ作業で出てくるコマンド。
| コマンド | 何をするか |
|---|---|
| dumpsys sensorservice | 端末にあるすべてのセンサーとそのベンダー、type、レート、バッチング。加えて直近の測定値のバッファ。 |
| input text | いまフォーカスがある入力欄に文字列を打ち込みます。 |
| wm size | ディスプレイの解像度を報告します。上書きすれば、端末は別の画面のふりをします。 |
他の入力とタッチコマンド
| コマンド | 何をするか |
|---|---|
| input keyevent | ハードウェアキーや仮想キーを押します。Home、Back、電源、音量、Enter など。 |
Web ADB ツール群のパーサを書きながら、AOSP・toybox・カーネルのソースに突き合わせて確認しています。バージョンやメーカーで本当に挙動が変わるところは、世界の半分の端末で間違いになる数値を出す代わりに、そう書いてあります。