
USB機器の通信を記録し、操作内容と照らし合わせて制御方法を推定するオープンソースツール「usb-rea」が公開されています。解析結果の報告書に加え、PythonのUSBライブラリを使うドライバーや、通信解析ソフト向けの解析プログラムを生成できます。
操作とUSB通信を対応付ける
usb-reaは、Emir Mrkaljević氏が開発したツールです。メーカーの専用アプリで操作する機器を対象に、USB通信の記録からコマンドや通信手順の構造を推定します。対象例にはPCケースの液晶画面、RGBコントローラー、マウス、スマートランプが挙げられています。
実機を解析する際は、メーカーのドライバーを動かして通信を記録します。利用者は専用アプリで行う操作に、明るさ0%や50%といった注釈を付けます。各設定について3種類以上の値を記録する手順が示されています。
操作ごとのパケットを比較すると、値に対応して変化する部分などを推定できます。記録した通信には操作との時間的な対応が付けられます。記録を終えた後、報告書とドライバーをそれぞれのコマンドで生成します。
記録形式と推定結果の扱い
通信の記録には、LinuxのusbmonやWindowsのUSBPcapを使えます。usb-reaが読み込むファイル形式はpcapまたはpcapngです。Windowsで注釈を付けずに記録した場合も、操作を順番に列挙すると、操作間の間隔で通信を分割できます。
推定対象には、固定のヘッダーやコマンドID、設定値、連番などがあります。複数の色成分や、線形に変化しない選択肢も扱えます。一定の間隔で繰り返される通信は、操作に伴うコマンドと分けて報告します。
数値の線形関係は、標本を1つずつ除いた交差検証を通過した場合に採用されます。通過しない場合は、記録した値に対応する一覧表に切り替わります。標本が3つ未満の場合は、推定の信頼度が下がります。
報告書と解析用プログラムを出力
報告書はMarkdown形式で出力され、各推定の根拠となるWiresharkのフレーム番号を参照できます。Wiresharkは通信を記録・解析するためのソフトウェアです。usb-reaは推定した構造を基に、単独で動くpyusbドライバーも生成します。
さらに、Wiresharkで通信内容を読み解くためのLua形式の解析プログラムも生成できます。これを読み込むと、推定した設定値や連番などをWireshark上で確認できます。チェックサムの不一致には警告も表示されます。
デモでは、実機を用意せずに合成されたファンコントローラーの通信を解析できます。通信手順と機器からの応答を推定し、報告書とドライバーを出力します。インストールには「pip install usb-rea」を使います。
既存の対応状況をUSB IDで検索
解析前には、lookupコマンドで機器のUSB IDを調べられます。USB IDはメーカーと製品を識別する番号の組み合わせです。オープンソースのプロジェクトが通信手順を実装済みの機器について、対応状況を検索できます。
検索は標準ではオフラインの一覧を使います。この一覧には、検証に使われた機器や事例が収録されています。記録ファイルを指定して、その中の機器情報からIDを読み取ることも可能です。
任意のオンライン検索では、OpenDeviceDBにも問い合わせます。その際に送信するのはUSB IDだけです。同じIDが複数の機器や改訂版で使われる場合もあるため、IDの一致だけでは通信手順まで同じとは限りません。
検証例と開発状況
usb-reaはアルファ版のv0.7.14として公開されています。合成した機器の通信、公開されているWiresharkの記録、利用者が共有した水冷クーラーの液晶画面の通信などで検証されています。NZXT Kraken Xのファン制御コマンドについては、既存ドライバーの送信内容と一致する構造を復元したとされています。
実機の通信記録を使った検証では、ASUS TUF Gaming LC IIIの画面の明るさ変更と画像ストリームが解析されました。その記録を回帰テストに使う過程で、機器情報の読み取りと画像フレームへの応答判定に問題が見つかりました。いずれもv0.7.6で修正されています。
usb-reaには、AIエージェントから機能を利用するためのMCPサーバーもあります。MCPは、外部ツールと接続するための仕組みです。開発者は、Windows専用アプリを使う機器について、通信記録を添えた解析依頼を受け付けています。











