USB Alternate Settingと帯域デバッグ:音声・UVC・ストリーミングが高品質で失敗する理由
USBのAlternate Setting、帯域予約、UVCカメラモード、オーディオサンプルレート、アイソクロナスエンドポイント、インターフェース切替、高品質ストリームの失敗をデバッグする方法を解説します。
USBストリーミングデバイスは、低品質では動くのに高品質で失敗することがよくあります。Webカメラは720pなら動くが1080pでフリーズする。USBオーディオインターフェースは48 kHzはOKだが192 kHzでクリックノイズが出る。キャプチャデバイスは最初のモードでは動くが、アプリケーションが別のモードを選んだ瞬間に失敗する。完全に壊れているわけではなく「あるモードだけが落ちている」このパターンを解決しようと、USB alternate setting bandwidth、UVC camera alternate setting、USB audio isochronous bandwidth、SET_INTERFACE streaming failed、USB device works low resolution not high resolution で検索するわけです。
Bus Scopeが威力を発揮するのは、Alternate Settingがディスクリプタと SET_INTERFACE リクエストの両方に表れるからです。鍵となる証拠は「失敗前にどのAlternate Settingが選択されていたか」です。
Alternate Settingとは何か
USBインターフェースは複数のAlternate Settingを持てます。Alternate Setting 0は多くの場合、ストリーミング用エンドポイントを持ちません。Alternate Settingが大きい番号のものには、別のパケットサイズや帯域要件を持つエンドポイントが現れます。
例:
Interface 1 alternate 0: no streaming
Interface 1 alternate 1: low bandwidth endpoint
Interface 1 alternate 2: medium bandwidth endpoint
Interface 1 alternate 3: high bandwidth endpoint
ホスト側は次のリクエストで選択します。
SET_INTERFACE interface=1 alternate=3
Alternate 3が必要とする帯域をバスが供給できなければ、ストリーミングは失敗します。
UVCカメラのモード
USB Video Classのカメラは、多くのモードを提示してきます。
- MJPEG vs 非圧縮 YUY2
- 720p vs 1080p vs 4K
- 15 fps vs 30 fps vs 60 fps
- 異なるエンドポイントのパケットサイズ
- 異なるAlternate Setting
非圧縮ビデオはMJPEGより圧倒的に帯域が必要です。カメラは正しく列挙されても、アプリケーションが攻めたモードを選んだ瞬間に失敗します。
USBオーディオのサンプルレート
オーディオインターフェースは、サンプルレート・チャンネル数・ビット深度・パケットサイズに合わせてAlternate Settingを切り替えます。あるホストコントローラでは動くモードが、ハブやドック経由だと失敗することも珍しくありません。
症状:
- 高サンプルレートでクリック音やポップ音が入る
- チャンネル数を増やすとストリームが落ちる
- 再接続直後は動くがモード切替後に失敗する
- 別のUSBデバイスがトラフィックを始めるとオーディオが途切れる
バスのトレースを見れば、選択されたAlternate Settingとアイソクロナスパケットの状態が分かります。
帯域予約
アイソクロナスとインタラプト転送は、周期的な帯域を予約します。バスが要求に応じきれないと、ホスト側がインターフェース選択を拒否したり、ストリームが不安定になったりします。
帯域を圧迫する要因は次のとおりです。
- 1つのハブに複数のカメラを繋いでいる
- USBオーディオとキャプチャデバイスが同居
- Full-speed機器がトランザクショントランスレータ越し
- ドックトポロジ
- ホストコントローラのスケジューリング上限
- ケーブルによる速度フォールバック
デバッグチェックリスト
次の流れで作業すると、原因に早くたどり着けます。
- 接続直後のディスクリプタをキャプチャする
- ストリーミング対象インターフェースのAlternate Settingを一覧する
SET_INTERFACEリクエストをキャプチャする- 実際に選択されたAlternate Settingを記録する
- 動作するモードと失敗するモードを比較する
- エンドポイントの最大パケットサイズと interval を確認する
- ネゴシエートされたデバイス速度を確認する
- ポート直結とハブ/ドック経由を両方試す
- 解像度・フレームレート・サンプルレート・チャンネル数を下げる
- セットアップとストリーミングのパケットを一緒に保全する
最終的な診断
USB Alternate Setting の失敗は「モード選択と帯域」の問題です。デバイスは列挙し、あるモードでは動くのに、ホストが帯域の大きいAlternate Settingを選んだ瞬間に落ちます。
Bus Scopeは選択中のインターフェースモードとエンドポイントの証拠を可視化するので、高品質ストリームの失敗を「アプリケーションの不安定さ」ではなく、USBの帯域とディスクリプタ挙動の問題として診断できます。