USBコントロール転送STALLのデバッグ：Setupパケット、エンドポイントゼロ、デバイスリクエスト失敗

USBコントロール転送は、列挙とデバイス管理の基盤です。ディスクリプタの読み取り、アドレス設定、コンフィギュレーション選択、インターフェース変更、クラスリクエストの発行、ベンダー固有コマンドの送信を担います。コントロール転送がストールすると、「USB device not recognized」「control transfer failed」「libusb control transfer error」「endpoint zero stalled」、あるいは「初期化で止まるファームウェア更新ツール」といった形で問題が現れます。

「USB control transfer STALL」「USB setup packet debugging」「endpoint zero stall」「GET_DESCRIPTOR failed」「vendor request stalled」といった検索ワードは、「通常のバルク・インタラプト・アイソクロナストラフィックが始まる前」に失敗が起きたことを示しています。

Bus Scopeが効くのは、Setupパケットが「リクエストの中身」を物語ってくれるからです。これがないと、STALLはただの汎用エラーで終わります。

コントロール転送の中身

USBコントロール転送には次のステージがあります。

1. Setupステージ
2. （オプションの）データステージ
3. ステータスステージ

Setupパケットには次のフィールドが含まれます。

• bmRequestType
• bRequest
• wValue
• wIndex
• wLength

これらのフィールドが、方向・リクエスト種別・受信者・リクエストコード・ディスクリプタ種別・インターフェース・エンドポイント・期待データ長を定義します。

デバイスがストールしたら、まずSetupパケットを確認しましょう。

エンドポイントゼロは特別

エンドポイントゼロは、すべてのUSBデバイスに必ず存在します。列挙とコントロール操作に使われます。エンドポイントゼロの挙動が壊れていると、ホストは通常ドライバをバインドできないかもしれません。

エンドポイントゼロの失敗は次のような形で現れます。

• デバイスディスクリプタのリクエストが失敗
• コンフィギュレーションディスクリプタの読み取りが失敗
• 文字列ディスクリプタのリクエストがストール
• SET_CONFIGURATIONが失敗
• クラス固有リクエストが失敗
• ベンダーコマンドが失敗

カスタムファームウェアでは、エンドポイントゼロの正確さは譲れません。

STALLが「正解」の場合もある

すべてのSTALLがバグとは限りません。デバイスは、サポートしていないリクエストを正規にストールさせることができます。問題は、「ホストがそれを期待していたか」「デバイスの状態がそれを許していたか」です。

例：

• 未サポートのベンダーリクエスト：STALLは正解かもしれない
• 不正なディスクリプタインデックス：STALLは正解かもしれない
• 列挙中に必須のクラスリクエスト：STALLするとドライババインドを壊す
• 状態違いのDFUリクエスト：STALLはステートマシン不一致を示しているかも

意味はリクエスト種別とタイミングで決まります。

ディスクリプタリクエストの失敗

ディスクリプタのSTALLは、カスタムUSBスタックで頻発します。次のような点に注意してください。

• wValue 内のディスクリプタ種別が誤っている
• 未サポートの文字列インデックス
• コンフィギュレーションのトータル長不一致
• 要求より少ないデータを誤って返している
• 短い初期ディスクリプタ読み取りを処理していない
• ファームウェアが特定ホストのリクエストパターン決め打ち

OSによってディスクリプタを要求する順番は異なります。Linuxでは動くデバイスが、Windowsが列挙中に送ってくるリクエストでストールすることがあります。

クラス／ベンダーリクエスト

クラスリクエストはUSBクラスごとに解釈されます。HID、CDC、DFU、Audio、Video、Mass Storage、ベンダー固有デバイスは、それぞれ固有の期待があります。

よくある例：

• HID GET_REPORT
• HID SET_REPORT
• CDC SET_LINE_CODING
• CDC SET_CONTROL_LINE_STATE
• DFU GETSTATUS
• UVCのProbe/Commitコントロール
• ベンダー固有のブートローダコマンド

クラスリクエストがストールするなら、wIndex のインターフェース番号が対象と一致しているか確認してください。複合デバイスでは、ホストがあるインターフェースに送ったリクエストをファームウェアが別インターフェースで処理しているケースがよくあります。

デバッグチェックリスト

次の流れで作業すると、原因に早くたどり着けます。

1. 接続直後からキャプチャする
2. 最初のコントロール転送STALLを見つける
3. Setupパケットのフィールドをデコードする
4. リクエストがstandard、class、vendorのどれかを確認する
5. 受信者（device、interface、endpoint、other）を確認する
6. wValue、wIndex、wLength を確認する
7. ディスクリプタと現在のデバイス状態と突き合わせる
8. STALLが期待されるものか致命的なものかを判断する
9. CLEAR_FEATUREやリセットなどの復旧リクエストを探す
10. クロスプラットフォームで挙動が違う場合はホストOSのリクエスト順を比較する

最終的な診断

USBコントロール転送のSTALLは、それ単体では情報が足りません。Setupパケットこそが診断のアンカーです。失敗したリクエストの種類、対象受信者、期待データ長、デバイス状態が妥当だったかを示してくれます。

Bus ScopeはエンドポイントゼロとSetupパケットの証拠をそのまま可視化するので、ファームウェア・ドライバ・QAチームがコントロールパス上の失敗をピンポイントでデバッグできます。