HN 日本語サマリー

← 一覧へ戻る
プログラミング

40ユーロのUSB-CハブをNintendo Switch 2ドックとして機能させる方法

Making a €40 USB-C hub work as a Nintendo Switch 2 dock (blog.nozomi.space)

114 pointsby mkopec37 コメント

要約

この記事は、市販の安価なUSB-Cハブを改造して、Nintendo Switch 2のドックとして機能させる方法を解説しています。オリジナルのドックが携帯に適さないという問題に対し、USB-PDの通信を解析し、ハブのファームウェアを書き換えることで、テレビ出力とHDR表示を可能にした技術的な挑戦について詳述しています。

全文翻訳

40ユーロのUSB-CハブをNintendo Switch 2ドックとして機能させる方法

私はNintendo Switch 2を旅行に持っていくのが好きです。毎回梱包するたびに、同じ問題に直面します。公式ドックはかさばり、壊れやすいように感じます。そのため、旅行に持っていくことはありません。ドックはUSB-C DisplayPort Altモードを使用しており、私はすでにそれに対応し、他のすべてのデバイスで完璧に機能するUSB-Cハブを持っているので、これは私を悩ませます。残念ながら、任天堂は(彼らがしばしばそうするように)独自路線を歩んだため、通常の汎用ハブはドックとして機能しません。

友人が最近USB-PDスニッファーをプレゼントしてくれました。コンソールが何をするのか、なぜ公式ドックでのみ機能するのかを調べることにしました。

ハブ

このハブはCable Matters 7-in-1トリプルディスプレイハブです。DP、HDMI、VGAを備え、最大60Wの電力を供給します。分解して内部を確認しました。

  • VL103 USB-PDコントローラー
  • VL817 USBハブ
  • RTD2142 DisplayPort MSTハブ(ここではDP→HDMIコンバーターとして使用)
  • ファームウェア用のXT25F16Bフラッシュチップ

[画像] [画像] [画像]

Switchはすでにハブで充電されているので、標準的なUSB-PDを使用しているはずです。任天堂固有のドッキングネゴシエーションは、USB-PDベンダー定義メッセージを介して行われると推測できます。

標準ファームウェアでは、Switchは驚くほど先に進みます。電力をネゴシエートし、DisplayPort Alt Modeに入り、ピン割り当てDさえ構成し、すべてハブによってACKされます。その後は何も起こりません。テレビモードも、画像も表示されません。DisplayPort Alt Modeだけでは不十分で、何か他のことが先に起こる必要があります。

ツール

USB-PDスニッファー:このスニッファーはWITRN K2で、USB-Cケーブルにインラインで接続され、PDトラフィックを表示します。Windowsアプリしか付属していないため、Claudeに小さなLinux CLIを作成してもらいました。専用スレッドでHIDレポートを読み取り、usbpdparserでデコードし、後で再生できるJSONLをログに記録します。

PDコントローラーの更新:VL103には32KiBのファームウェアを持つ8051マイクロコントローラーが搭載されています。fwupdのvliプラグインは、VL817ハブを介してそれをダンプおよびフラッシュする方法をすでに知っており、このハブのUSB IDに対するクワークエントリが必要なだけでした。イメージの末尾にはCRC-16/USBがあり、新しいコードのための十分な空き領域があります。

sudo fwupdtool --plugins vli firmware-dump OUT.bin <device-id>
sudo fwupdtool --plugins vli --allow-reinstall --prepare --cleanup \
     install-blob patched.bin <device-id>

リバースエンジニアリングには、Ghidraの8051プロセッサを逆アセンブルに、SDCCのアセンブラをパッチに、uCsim 8051シミュレーターを実際のファームウェアをキャプチャに対して実行するために使用しました。

8051プログラミングの経験はありますが、ClaudeとGPTはこのプロジェクト全体で広範囲に使用されました。それらは逆アセンブル、パッチ適用、および元のハブファームウェアの動作分析に役立ちました。それらがなければ、これを機能させるのははるかに困難だったでしょう。

公式ドックの通信を傍受する

スニッファーを接続し、PCでスニッフィングスクリプトを実行して、USB-PDトラフィックを観察します。

14:19:11.863  SOP Source_Capabilities Source/DFP id=0  [F 5.0V@3.0A, F 9.0V@3.0A, F 15.0V@2.8A]
14:19:11.868  SOP Request Sink/UFP id=0  [[3] F 15.0V@2.8A]
14:19:12.070  SOP Vendor_Defined Sink/DFP id=4  VDM PD SID(0xFF00) Discover Identity REQ
14:19:12.073  SOP Vendor_Defined Source/UFP id=5  VDM PD SID(0xFF00) Discover Identity ACK  VDOs: 0x5460057E 0x00000000 0x20620000 0x65000031 0x00000000
14:19:12.080  SOP Vendor_Defined Source/UFP id=6  VDM PD SID(0xFF00) Discover SVIDs ACK  SVIDs: DisplayPort(0xFF01), Nintendo(0x057E)
14:19:12.162  SOP Vendor_Defined Sink/DFP id=0  VDM Nintendo(0x057E) Enter Mode REQ  mode #1
14:19:12.183  SOP Vendor_Defined Sink/DFP id=1  VDM DisplayPort(0xFF01) Enter Mode REQ  mode #1
14:19:12.210  SOP Vendor_Defined Sink/DFP id=3  VDM DisplayPort(0xFF01) 17 REQ  VDOs: 0x00000806
14:19:12.228  SOP Vendor_Defined Sink/DFP id=4  VDM/unstructured Nintendo(0x057E) 0x0001  VDOs: 0x00000020
14:19:12.240  SOP Vendor_Defined Source/UFP id=5  VDM/unstructured Nintendo(0x057E) 0x0041  VDOs: 0x00000020 0x00000000
14:19:12.249  SOP Vendor_Defined Sink/DFP id=5  VDM/unstructured Nintendo(0x057E) 0x0001  VDOs: 0x00000001
14:19:12.260  SOP Vendor_Defined Source/UFP id=6  VDM/unstructured Nintendo(0x057E) 0x0041  VDOs: 0x00000001 0x03010503
14:19:12.438  SOP Vendor_Defined Sink/DFP id=6  VDM/unstructured Nintendo(0x057E) 0x0001  VDOs: 0x00000002
14:19:12.450  SOP Vendor_Defined Source/UFP id=7  VDM/unstructured Nintendo(0x057E) 0x0041  VDOs: 0x00000002 0x0003006E
14:19:12.458  SOP Vendor_Defined Sink/DFP id=7  VDM/unstructured Nintendo(0x057E) 0x0001  VDOs: 0x00000006
14:19:12.471  SOP Vendor_Defined Source/UFP id=0  VDM/unstructured Nintendo(0x057E) 0x0041  VDOs: 0x00000006 0x330107DA 0x06016D68 0x330107DA 0x06016D68

いくつかの点が際立っています。

  • Discover Identity:ドックは任天堂(VID 057E)、製品 2062、「ペリフェラル」として識別されます。
  • Discover SVIDs:DisplayPort(FF01)に加えて、ドックは任天堂独自のSVID 057Eをアドバタイズします。SwitchはDisplayPortモードの前に任天堂モードに入ります。
  • Nintendoメッセージ:DPが構成された後、Switchは一連の非構造化ベンダーメッセージを送信します。各リクエストは057E0001 + コマンド番号で、ドックは057E0041 + 同じコマンド + データで応答します。
コマンドドックの応答メモ
2000000000定期的にポーリングされる
0103010503
29, 44, 41, 49, 23, 131, 51エコー
020003006Eバージョン番号のよう
06330107DA 06016D68 ×2バージョンレコード、タグ hm
04330107DA 06016D61 ×2バージョンレコード、タグ am

これらのほとんどが何を意味するのかはわかりません。バージョンレコードはCypress/Infineon CCGxファームウェアバージョンのレイアウトと一致しており、別のドックパッチングプロジェクトでは、公式ドックのアップデートで02が変更されるのを確認しました。

ハブにハンドシェイクを教える

VL103ファームウェアを取得し、Claudeにデコンパイルと分析を依頼することから始めました。Ghidraを使おうとしたとき、すぐにセーフティ分類器による停止に遭遇しました。そのため、デコンパイルタスクは代わりにGPTによって実行されました。

VL103ファームウェアに応答を追加しました。約540バイトの8051コードを、標準PDスタックにフックして任天堂のメッセージに応答し、残りは元のコードに任せるようにしました。その後、一度に1つのことを変更しました。

バージョン変更結果
v1/v2任天堂のDiscover/Enter Modeとエコーコマンドに応答ワイヤー上ではACK、DPは構成されたが、画像なし
v3ドックと同様に15V/2.8Aを提供する(標準ハブは2.53A)画像なし
v4VIAの代わりに任天堂のベンダーIDを報告する画像なし
v5公式ドックの完全なIDを返すテレビモードが動作!
v6ドックのバージョンで02に応答するSwitchは06で停止する
v7ドックのレコードで06と04に応答する完全なシーケンスが一致し、ドッキングが高速化

v4とv5の比較が興味深かったです。ベンダーIDだけでは不十分で、Switchはさらに多くのID情報をチェックします。v7は、約3秒の遅延をなくしました。v5では、Switchは02を要求し、「サポートされていません」という応答を得て、続行する前に待機しました。

バージョン応答は公式ドックからコピーされたもので、このハブ内の実際のバージョンではありません。また、それらのコマンドの背後にあるものは何も実装されていません。認識できないコマンドは、引き続き標準の「サポートされていません」という応答を受け取ります。

HDRが色褪せて見える

テレビモードは動作しましたが、HDRでは色が著しく脱色して見えました。同じモニターとゲームで公式ドックは問題なく動作しました。除外した要因は以下の通りです。

  • ディスプレイ:同じ現象が私のモニターとテレビの両方で発生し、HDRインジケーターは両方で点灯します。
  • RGBレンジ:リミテッドにすると悪化し、フルでも色褪せたままです。
  • ハブ全般:私のLinux PCは、同じハブでHDRを正しく出力します。
  • PDコントローラー:HDRのオン/オフでPDトラフィックは同一です。

画像はカラースペースが一致していないように見えたため、SwitchはBT.2020カラーを送信しているが、ディスプレイにはBT.709であると伝えられ、色が圧縮されているのではないかという仮説を立てました。DisplayPort側はPDコントローラーに一切触れず、RTD2142に直接接続されます。したがって、そのチップが次でした。

RTD2142の内部

まず、そのファームウェアをダンプする必要がありました。flashromには、USB-Cケーブルを介したI²C-over-DP-AUXでチップと通信するrealtek_mst_i2c_spiプログラマーがあります。2回の読み取りで同一の2MiBイメージが得られました。ファームウェアは署名されていないため、変更されたイメージを単純にフラッシュできます(SOIC-8クリップはバックアッププランでした)。

flashrom -p realtek_mst_i2c_spi:bus=7,allow_brick=yes,reset_mcu=1 -r rtd2142.bin

分析:これも8051で、今回はトランポリンを介して切り替えられる8つの64KiBコードバンクがあります。シミュレーターを拡張してバンクスイッチを追跡しました。最も役立ったのは、関連するRTD2172用のRealtekツールデータベースを公開GitHubリポジトリで見つけたことです。そこには、このファームウェアの動作と一致するハードウェアレジスタの名前と説明がありました。

HDMI出力は、ビデオと共に送信される小さなパケットであるAVI InfoFrameで画像の色を記述します。その色度フィールドはBT.709と表示されていました。コンバーターは、特定の標準的な方法でシグナルされた場合にのみ、受信したDisplayPortストリームからBT.2020を受け入れ、出力が起動するときにのみHDMIカラーラベルを更新します。HDR輝度メタデータは別のパケットを通過するため、テレビはHDRモードに切り替わりました。

他のサードパーティ製ドックがこれをどのように処理しているか調べました。「グレーまたは暗いHDRを修正する」ファームウェアアップデートが出荷されています。そのうちの1つには、デバッグ文字列「switch2 color space patch」が含まれています。Switch 2を検出し、ストリームが標準的なBT.2020としてマークされていない場合、ディスプレイのEDIDから色度を取得します。したがって、この問題に直面したのは私だけではありませんでした。

HDRの修正

Switchを検出する代わりに、私のパッチはHDRメタデータ自体を調べます。

  • HDRメタデータが存在し、その転送関数がPQまたはHLGの場合、すべてのAVI InfoFrameはBT.2020としてマークされ、チェックサムが修正されます。
  • InfoFrameは、HDRがオンまたはオフに切り替わるたびに再構築されます。
  • 他の何も変更されません。同じピクセル、SDR用の同じパケット、DPまたは起動パスに何も変更はありません。

これは単一バンク内の108バイトです。3つの小さなフックと、消去されたパディング内のコードです。フラッシュする前に、元のファームウェアとパッチをシミュレーターで実行しました。すべてのピクセルフォーマット、HDRのオン/オフ遷移、および完全な入力から出力までのチェーンをテストしました。

結果:HDRが正しく表示されます。ピクセルは最初から問題なく、ラベルだけが間違っていました。

ハブのDisplayPort出力は、パッチを当てていない別のパスを使用しているため、DPポート経由のHDRはまだ色褪せて見えます。修正するにはあまり関心がないと判断しました :)

VRR?

ハブが公式ドックになりすますため、SwitchはVRRも提供します。有効にするとDPポート経由の画像がフリーズし、HDMIポートではリフレッシュレートは60Hzのままでした。ファームウェアを見ると、VRRサポートは全くありません。ソースに可変タイミングを処理できることを伝えず、HDMI VRRパケットも送信しません。

完全なドッキングソリューションが欲しかったので、それでも試しました。RTD2142ファームウェアには、同じAUXチャネル上のI²Cアドレス0x35にデバッグインターフェイスがあることが判明しました。1つのコマンドで任意のレジスタを読み取り、別のコマンドで書き込むことができます。これにより、フラッシュせずにチップのライブ状態を読み取り、レジスタに書き込むことができました。

実際にVRRを使用するソースを取得するために、ハブがAdaptive-Syncをアドバタイズするようにする2番目のパッチを作成し、LinuxにEDIDオーバーライドを与えました。amdgpuは喜んでVRRを有効にしましたが、フレームレートが実際に変動するとすぐに画面が真っ黒になりました。チップのメインループは、タイミングが安定するまで応答しなくなりました。再起動しているわけではなく、FIFOウォッチドッグと割り込みを無効にしても効果はありませんでした。私の最良の推測は、決して安定しないクロック再ロックループです。

これを機能させるには、チップが入力にロックオンする方法を書き直し、タイミングジェネレーターが可変フレームに追従できることを期待し、HDMI VRRパケットを追加する必要があります。そこで作業を終了し、HDRのみのファームウェアに戻りました。このようなハブを使用するときは、Switchの設定でVRRをオフにするだけです。

結論

ハブは、私が気にかけていること、つまりテレビモードとHDMI経由のHDRを、Switchの充電と同時に機能するようになりました。USBポートやイーサネットはあまりテストしませんでした。VRRは機能しないため、Switchの設定でオフのままにしています。合計で、ハブはPDコントローラーに約540バイト、RTD2142に108バイトを必要としました。

ハブは公式任天堂ドックとして報告されますが、PCやスマートフォンでも通常通り機能します。

8051チップを搭載してくれたVIAとRealtekに感謝します。ハッキングがはるかにシンプルでアクセスしやすくなりました :)