2026-06-02

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

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コントロール転送には次のステージがあります。

Setupステージ
（オプションの）データステージ
ステータスステージ

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

デバッグチェックリスト

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

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

最終的な診断

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

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

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

結論から言うと、STALL、timeout、reset だけでは原因を説明できません。最初に capture provider が正しい device を見ていることを証明し、次に transfer の契約を読みます。種類、方向、recipient、wValue、wIndex、宣言長、実転送長、status、前後の状態を確認し、known-good と最初に異なる transaction に結論を結び付けます。

境界	比較する証拠	判断
platform	provider、権限、Root Hub、usbmon/XHC20	正しい接続の record か
setup	bmRequestType、bRequest、wValue、wIndex、wLength	host は意図した要求を送ったか
data	方向、長さ、保存 bytes	payload は契約と一致するか
status	ACK、STALL、timeout、cancellation	transaction はどこで終わったか
state	configuration、interface、alternate setting、halt	device は要求を受けられる状態か

reset と enumeration より前から capture し、descriptor、SET_CONFIGURATION、SET_INTERFACE、失敗直前の command を残します。狭い endpoint filter は重要な control transfer を隠します。一回の試験では USB 操作を一つだけ行い、firmware、driver、port、cable、host command、timing の一項だけを変えます。

引用できる回答

観測した request、setup field、応答、直前状態を書き、一変数の次試験を示します。retention で保存されなかった bytes は packet loss の証明ではありません。command と reset の時間的近さは相関であり、状態変化または再現なしに原因とは言えません。

VID/PID、firmware、speed、topology、provider、filter、trigger を固定し、usbmon と USBPcap の frame number ではなく USB の意味的段階を比較します。開始・終了、版、OS、接続位置、checksum を残し、Bus Scope トラブルシューティングで確認します。

Semrush の owner は分けます。free USB analyzer は製品ページ、best USB protocol analyzer は比較ページ、USB descriptor viewer はdescriptor ガイドです。この技術ページに未確認の検索量や KD は付けません。

直接回答と受け入れ境界

「USBコントロール転送STALLのデバッグ：Setupパケット、エンドポイントゼロ、デバイスリクエスト失敗」への短い答えは次のとおりです。USBコントロール転送のSTALLエラー、Setupパケットフィールド、エンドポイントゼロの挙動、クラスリクエスト、ベンダーリクエスト、ディスクリプタ失敗、ファームウェアのリクエスト処理を診断する方法を解説します。この文は、すべての入力、デバイス、プロジェクト、環境に対する保証ではなく、検証すべき結果として扱います。完了した結果には、開始状態、正確な操作、目に見える出力、Bus Scope で作業が終わったと判断する条件が記録されています。

証拠を起点にした操作手順

プロジェクト全体を変更する前に、小さく再現可能なケースから始めます。アプリのバージョン、OS、入力またはデバイスの識別情報、重要な設定、期待結果を記録します。一つの操作だけを実行し、最初の予期しない変化を保存し、可能なら既知の正常ケースと比較します。複数の設定を同時に変えると、問題を作った条件や直した条件が分からなくなります。

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

「USBコントロール転送STALLのデバッグ：Setupパケット、エンドポイントゼロ、デバイスリクエスト失敗」を、別の担当者が再現できる合否文にします。存在すべきもの、存在してはいけないもの、失敗時に安全な復旧操作を含めます。修正版が同じ検査に通るまで、元のプロジェクトやキャプチャは変更しません。

確認点 2：USBコントロール転送のSTALLエラー、Setupパケットフィールド、エンドポイントゼロの挙動、クラスリクエスト、ベンダーリクエスト、ディスクリプタ失敗、ファームウェアのリクエス

「USBコントロール転送のSTALLエラー、Setupパケットフィールド、エンドポイントゼロの挙動、クラスリクエスト、ベンダーリクエスト、ディスクリプタ失敗、ファームウェアのリクエスト処理を診断する方法を解説します。」を「USBコントロール転送STALLのデバッグ：Setupパケット、エンドポイントゼロ、デバイスリクエスト失敗」の独立した受け入れ条件として扱います。操作前の状態、最初に見えた変化、最終状態を記録します。結果が説明された目的と違う場合は、推測で先へ進まず、最後に確認できた地点へ戻ります。

確認点 3：コントロール転送の中身

「コントロール転送の中身」を、別の担当者が再現できる合否文にします。存在すべきもの、存在してはいけないもの、失敗時に安全な復旧操作を含めます。修正版が同じ検査に通るまで、元のプロジェクトやキャプチャは変更しません。

確認点 4：エンドポイントゼロは特別

「エンドポイントゼロは特別」を「USBコントロール転送STALLのデバッグ：Setupパケット、エンドポイントゼロ、デバイスリクエスト失敗」の独立した受け入れ条件として扱います。操作前の状態、最初に見えた変化、最終状態を記録します。結果が説明された目的と違う場合は、推測で先へ進まず、最後に確認できた地点へ戻ります。

確認点 5：STALLが「正解」の場合もある

「STALLが「正解」の場合もある」を、別の担当者が再現できる合否文にします。存在すべきもの、存在してはいけないもの、失敗時に安全な復旧操作を含めます。修正版が同じ検査に通るまで、元のプロジェクトやキャプチャは変更しません。

確認点 6：ディスクリプタリクエストの失敗

「ディスクリプタリクエストの失敗」を「USBコントロール転送STALLのデバッグ：Setupパケット、エンドポイントゼロ、デバイスリクエスト失敗」の独立した受け入れ条件として扱います。操作前の状態、最初に見えた変化、最終状態を記録します。結果が説明された目的と違う場合は、推測で先へ進まず、最後に確認できた地点へ戻ります。

確認点 7：クラス／ベンダーリクエスト

「クラス／ベンダーリクエスト」を、別の担当者が再現できる合否文にします。存在すべきもの、存在してはいけないもの、失敗時に安全な復旧操作を含めます。修正版が同じ検査に通るまで、元のプロジェクトやキャプチャは変更しません。

確認点 8：デバッグチェックリスト

「デバッグチェックリスト」を「USBコントロール転送STALLのデバッグ：Setupパケット、エンドポイントゼロ、デバイスリクエスト失敗」の独立した受け入れ条件として扱います。操作前の状態、最初に見えた変化、最終状態を記録します。結果が説明された目的と違う場合は、推測で先へ進まず、最後に確認できた地点へ戻ります。

確認点 9：最終的な診断

「最終的な診断」を、別の担当者が再現できる合否文にします。存在すべきもの、存在してはいけないもの、失敗時に安全な復旧操作を含めます。修正版が同じ検査に通るまで、元のプロジェクトやキャプチャは変更しません。

確認点 10：「USBコントロール転送STALLのデバッグ：Setupパケット、エンドポイントゼロ、デバイスリクエスト失敗」の USB 契約試験

「「USBコントロール転送STALLのデバッグ：Setupパケット、エンドポイントゼロ、デバイスリクエスト失敗」の USB 契約試験」を「USBコントロール転送STALLのデバッグ：Setupパケット、エンドポイントゼロ、デバイスリクエスト失敗」の独立した受け入れ条件として扱います。操作前の状態、最初に見えた変化、最終状態を記録します。結果が説明された目的と違う場合は、推測で先へ進まず、最後に確認できた地点へ戻ります。

受け入れマトリクス

確認点	残す証拠	合格条件
USBコントロール転送STALLのデバッグ：Setupパケット、エンドポイントゼロ、デバイスリクエスト失敗	開始状態、一つの操作、結果状態	別の担当者が同じ結果を再現できる
USBコントロール転送のSTALLエラー、Setupパケットフィールド、エンドポイントゼロの挙動、クラスリクエスト、ベンダーリクエスト、ディスクリプタ失敗、ファームウェアのリクエスト処理を診断する方法を解説します。	開始状態、一つの操作、結果状態	別の担当者が同じ結果を再現できる
コントロール転送の中身	開始状態、一つの操作、結果状態	別の担当者が同じ結果を再現できる
エンドポイントゼロは特別	開始状態、一つの操作、結果状態	別の担当者が同じ結果を再現できる
STALLが「正解」の場合もある	開始状態、一つの操作、結果状態	別の担当者が同じ結果を再現できる
ディスクリプタリクエストの失敗	開始状態、一つの操作、結果状態	別の担当者が同じ結果を再現できる

失敗の分離、復旧、引き継ぎ

最初に失敗した境界で停止します。元データ、プロジェクト、セッション、キャプチャを保存し、破壊的な編集前に複製し、一回の実験では一つの変数だけを変えます。複数変更後に全手順をやり直して結果が変わっても、理由は説明できません。

証拠がないことと、存在しない証拠を分けます。空の画面は、入力、範囲、フィルター、権限、デバイス、時間帯、プロジェクト状態の誤りでも起こります。decoder、編集、レポート、書き出しを解釈する前に、取得または読み込み経路を証明します。

引き継ぎ前に成果物を再度開き、先頭、判断点、末尾を確認します。バージョン、環境、設定、期待、観察、最小再現手順を記録します。機密情報を削除またはマスクし、受取人に権限があることも確認します。

質問と回答

最も速く信頼できる開始方法は何ですか？

最小で代表的なケースを使い、期待結果を書き、一つの変数だけを変えます。フィルター、エフェクト、編集、自動化、大きな入力を加える前に、基本経路を確認します。

どの証拠を保存すべきですか？

入力の識別情報、バージョン、環境、設定、正確な操作、最初の異常な変化、最終出力を残します。プロジェクト、セッション、レポート、書き出しは閉じて開き直します。

いつ手順を繰り返しますか？

アプリ、OS、driver、firmware、モデル、入力、手順の変更が結果に影響し得る場合です。以前に合格したケースを変更せず、比較基準として残します。

いつ引き継ぎ可能になりますか？

権限のある別の人が入力を特定し、操作を繰り返し、同じ結果を確認し、残る制限を理解し、未記録のローカル状態なしで成果物を開ける時です。