現行リリースのドキュメント FFB-Bridge 1.6.0 古い記述が見つかった場合は、次のフォームでお知らせください フィードバックフォーム.

サポートページ

サポート ページは、ドキュメント、ヘルス チェック、診断、ログ、サポート バンドルのエクスポートのための単一のホームです。物理デバイスの構成はハードウェアの下に存在するようになりました。

「サポート → ヘルスチェック」には確認項目ごとに一行が表示され、「合格」/「情報」/「警告」/「失敗」と、修復できる場合の操作が示されます。最初に開くのは「リソース」タブです。 「サポート → ヘルスチェック」には確認項目ごとに一行が表示され、「合格」/「情報」/「警告」/「失敗」と、修復できる場合の操作が示されます。最初に開くのは「リソース」タブです。
Figure 1. 「サポート → ヘルスチェック」には確認項目ごとに一行が表示され、「合格」/「情報」/「警告」/「失敗」と、修復できる場合の操作が示されます。最初に開くのは「リソース」タブです。

タブストリップ

「サポート」ページでは、最初に リソース (リソース)タブが開き、オンラインドキュメントと同梱 PDF へのリンクが表示されます。他の二つのタブにもワンクリックで移動できます:

  • リソース (最初に開きます)— 公式ドキュメントと PDF マニュアルです。初回ガイドは「設定 → 一般」から再表示できます。
  • ヘルスチェック — 日常的なトリアージ面 (デバイス、Linux 上の udev ルール、SIM の到達可能性、実行時の状態)。クリック チェックを実行 プローブする。
  • 診断 — ランタイム メトリクス、検索可能なイベント ログ、ワンクリックのサポート バンドル エクスポート。別途文書化されています。 診断タブ ページ。

デバイスの選択、方向のキャリブレーション、検証済みのレンダリング、強度制限、および制御の割り当ては、 ハードウェア.

ヘルスチェックタブ

ヘルスチェックは、何かおかしいと感じたときにほとんどのテスターが必要とするパスです。クリック チェックを実行 ブリッジの状態を調査します。行は個別に更新されるため、低速 SIM プローブによってデバイスやランタイム結果の表示がブロックされることはありません。

  • 合格 ブリッジがセットアップのその部分を検証したことを意味します。
  • 情報 これは、何も問題はありませんが、行には有用なコンテキストがあることを意味します。たとえば、MSFS を飛行しているとき、またはモックモードを使用しているときに、X-Plane がリッスンしないことが予想されます。
  • 警告 これは、セットアップは続行できますが、修正または報告する価値のある点があることを意味します。
  • 失敗 ブリッジがブロッキングの問題を発見したことを意味します。ヘルスチェックで安全な修正が判明すると、その行にアクション ボタンが表示されます。
  • 準備完了 そして チェック中 は、走行前および走行中に使用されるニュートラル状態です。

デバイスの自動起動前チェック

起動時、FFB-Bridge は Windows、Linux、macOS のデバイスバックエンドを静かに確認します。Linux では、対応イベントノードへの読み書きアクセスと、インストール済み udev ルールが現在のすべてのデバイス権限を含むかも確認します。「警告」または「失敗」があると、各問題を示すダイアログが開き、[今すぐ確認して修正]と[今は閉じる]を選択できます。

  • すべてのチェックに合格した場合は、何も開きません。
  • 起動時はシミュレーターやネットワークを検査しません。シミュレーターが閉じている状態は正常で、実行時に扱われます。
  • ダイアログが開いている間、「準備ができたら自動でアーム」は待機します。問題を確認して修正するか、意図的にデバイスを外している場合は閉じます。閉じた後も、ほかの前提条件を満たした場合にのみ「準備ができたら自動でアーム」が続行します。
「サポート → ヘルスチェック」には、対応 event node の「合格」、古い udev ルールの「警告」と「修正…」、物理デバイスの「失敗」が表示されます。 「サポート → ヘルスチェック」には、対応 event node の「合格」、古い udev ルールの「警告」と「修正…」、物理デバイスの「失敗」が表示されます。
Figure 2. 「サポート → ヘルスチェック」には、対応 event node の「合格」、古い udev ルールの「警告」と「修正…」、物理デバイスの「失敗」が表示されます。

ハードウェア

以前のサポート ページのハードウェア コントロールには専用の領域が設けられています。分離効果テストには「フライトチェック」を使用し、永続的な物理デバイス設定にはハードウェアを使用します。 ハードウェアガイドを開く.

「ハードウェア → キャリブレーション」 — ピッチとロールの方向、力の極性、必要な軸の入れ替えを確認します。 「ハードウェア → キャリブレーション」 — ピッチとロールの方向、力の極性、必要な軸の入れ替えを確認します。
Figure 3. 「ハードウェア → キャリブレーション」 — ピッチとロールの方向、力の極性、必要な軸の入れ替えを確認します。

チェックの配置のしかた

各チェック行には 4 つの部分があります。

  • ステータス — 「合格」 (緑)、「情報」 (青)、「警告」 (オレンジ)、「失敗」 (赤)、「準備完了」 / 「チェック中」 (ニュートラル)、または行がこのプラットフォームに適用されない場合は N/A。
  • タイトル — 何をチェックしているのか。
  • 詳細 — 見つかった内容の 1 行の要約。カーソルを合わせる (またはタッチでタップする) と、詳細が表示されます。
  • アクションボタン — 実行可能な何かがある場合にのみ表示されます。例: ローカルエントリをインストール, ポート5111を使用, 修正….

小切手

FFBジョイスティックデバイス

サポートされているフォースフィードバック ジョイスティックが OS から認識され、ブリッジが排他的にそれを開くことができることを確認します。サポートされている VID/PID が存在しない場合、または別のプロセスがハンドルを保持している場合は失敗します。

Linux udevルール

「ヘルスチェック」は、/etc/udev/rules.d/71-ffb-bridge.rules に現在のすべての対応デバイス入力行、MOZA TTY 権限、および Logitech G940 と Brunner ベースが使用する hidraw アクセスが含まれるか確認します。「修正…」は管理された標準ルールを表示し、pkexec でインストールして以前の 99-ffb-bridge.rules を削除し、udev を再読み込みして、入力デバイス、TTY デバイス、hidraw デバイスをトリガーします。接続済みで明示的に有効化された未登録ジョイスティックはインストール時に追加されます。

古いルールは、MOZAのTTYラインやLogitech G940およびBrunnerベースが使用するhidrawアクセスなど、現在のデバイス許可がない場合、または以前の99-ffb-bridge.rulesのように、ファイル名のために実行順が遅くなりデスクトップセッションのアクセスに間に合わない場合に「警告」として報告されます。ファイルが既に存在していても「修正…」を使用してください。アプリは完全な生成ルールを71-ffb-bridge.rulesとしてインストールし、以前のファイルを削除します。

修正に成功するとルールは有効になり、アプリは再起動を勧めます。[今すぐ再起動]は新しい権限でジョイスティックを開き直し、起動時のフォールバックを解除します。先に続行する必要がある場合は[後で再起動する]を選んでも安全です。

Linux の修正ダイアログは、権限を求める前に、対応デバイス用の標準入力および MOZA TTY ルールを表示します。接続済みで明示的に有効化された未登録ジョイスティックはインストール時に追加されます。 Linux の修正ダイアログは、権限を求める前に、対応デバイス用の標準入力および MOZA TTY ルールを表示します。接続済みで明示的に有効化された未登録ジョイスティックはインストール時に追加されます。
Figure 4. Linux の修正ダイアログは、権限を求める前に、対応デバイス用の標準入力および MOZA TTY ルールを表示します。接続済みで明示的に有効化された未登録ジョイスティックはインストール時に追加されます。
修正に成功するとルールは有効になり、アプリは再起動を勧めます。[今すぐ再起動]は新しい権限でジョイスティックを開き直し、起動時のフォールバックを解除します。先に続行する必要がある場合は[後で再起動する]を選んでも安全です。 修正に成功するとルールは有効になり、アプリは再起動を勧めます。[今すぐ再起動]は新しい権限でジョイスティックを開き直し、起動時のフォールバックを解除します。先に続行する必要がある場合は[後で再起動する]を選んでも安全です。
Figure 5. 修正に成功するとルールは有効になり、アプリは再起動を勧めます。[今すぐ再起動]は新しい権限でジョイスティックを開き直し、起動時のフォールバックを解除します。先に続行する必要がある場合は[後で再起動する]を選んでも安全です。
NixOS の例外

ヘルスチェックにより NixOS が検出されます ( /etc/NIXOS) そして、udev-rule 行をルールを追加する命令に置き換えます。 configuration.nix 代わりに。見る インストール スニペットの場合。

WindowsLinux MSFSのSimConnect設定

SimConnect は MSFS パスであるため、このチェックは Windows と Linux で実行されます。 MSFS を探します SimConnect.xml プラットフォームに適した場所にあるファイルを解析し、有効な IPv4 エントリをブリッジが使用しているポートと比較します。考えられる 3 つの結果:

  • 一致するエントリが見つかりました。 緑 — 何もすることはありません。
  • 別のポートでのエントリ。 アンバー — を提供します ポートを使用:X ボタンをクリックしてそのポートを採用します。
  • 使用可能なエントリ (または解析不可能なファイル) がありません。 赤 — を提供します 修正… ボタンをクリックすると、インストール ダイアログが開きます (下記を参照)。
Linux は非特権ポートを使用します

MSFS はポート 500 でストック SimConnect エントリを出荷します。Windows では正常にバインドされ、ブリッジはそれを使用します。 Linux 上の Proton では、ユーザー名前空間プロセスは 1024 未満のポートをバインドできないため、ブリッジは、MSFS-in-Proton が実際にバインドできる非特権ポート (デフォルトでは 5111) に並列エントリをインストールして使用します。これが、Linux の修正と 使用ポート その上位ポートのアクションポイント。

MSFSへの接続性

設定された TCP ポートをプローブします。実際の SimConnect OPEN パケットを送信し、応答ヘッダーを検査して区別できるようにします。 MSFS がリッスンしています から 他の何かが聞いている.

X-Planeへの接続性

X-Plane への接続は、Windows、Linux、Apple Silicon の macOS で利用できます。この確認では、次の宛先に RREF プローブを送信します: 127.0.0.1:49000 そして、応答としての dataref を少し待ちます。タイムアウトと Winsock の両方をマップします WSAECONNRESET (ICMP ポート到達不能が配信されたときに受信) を「非実行」にします。

ランタイムの状態

現在のデバイス、データソース、テレメトリ、例外の状態をまとめて示します。「合格」はデバイスが開いていて、ライブのシミュレーターまたはモックシムのデータがパイプラインを駆動していることを示します。「情報」はデバイスが開いているもののライブのシミュレーターデータがない状態で、シミュレーターを閉じている間は想定どおりです。「失敗」はデバイスが開いていないことを示します。

クラッシュレポート

前回のセッションがクラッシュした場合、FFB-Bridge は次回の起動時に、「ヘルスチェック」の行ではなくクラッシュレポートのダイアログを表示します。 コピー で保存されたスタックトレースをコピーし、 フィードバックフォームを開く でブラウザーのフィードバックページを開くと、ログを貼り付けてサポートバンドルを添付できます。

修正ダイアログ

修正… ボタンは変更を直接適用しません。何が、どこで変更されようとしているか、そして (Linux では) 認証プロンプトで何の承認を求められるかを正確に示すダイアログを開きます。

「SimConnectの設定」をインストールする「修正」ダイアログ。追加される正確な XML スニペットが、結果のファイルのプレビューとともに表示されます。 「SimConnectの設定」をインストールする「修正」ダイアログ。追加される正確な XML スニペットが、結果のファイルのプレビューとともに表示されます。
Figure 6. 「SimConnectの設定」をインストールする「修正」ダイアログ。追加される正確な XML スニペットが、結果のファイルのプレビューとともに表示されます。

ダイアログは常に 加算的: 既存のエントリは決して上書きされません。ターゲット ファイルが解析できない場合、ダイアログには、タイムスタンプ付きのバックアップが最初に作成されることが説明されます。キャンセルは常に安全な選択です。

Linux pkexec の動作

システムパスに書き込むアクション (udev ルール、以下のもの) /etc) 経由ルート pkexec。ディストリビューションの通常の polkit プロンプトが表示されます。これは、 gparted またはパッケージマネージャーGUI。終了コード ヘルスチェックでは次のように解釈されます。

終了意味ヘルスチェックレポート
0成功グリーンチェック。行が再評価されます。
126ユーザーが認証プロンプトを閉じたアンバー色の「キャンセルされました」 — 準備ができたらもう一度お試しください。
127polkit エージェントなし / 認証失敗赤「認証に失敗しました。」
ヒント

最小限の環境 (ヘッドレス Linux、polkit エージェントを使用しない sway) でブリッジを実行するのは問題ありません。サポート ページの特権付き修正は使用できないだけです。必要なファイルを手動でインストールするか、ブリッジを起動する前に polkit エージェントを起動します。

すべてのチェックが緑色の場合

アプリは動作するはずです。そうでない場合は、に切り替えます。 診断タブ — そのイベント ログには、「ヘルスチェック」の 1 行のステータスよりも詳細な情報が表示されます。またはジャンプしてください トラブルシューティング 一般的な症状と修正については。

MSFS 2020 と 2024、または複数のインストールが存在する場合は、修復前に表示された各設定対象を確認してください。修復は選択したシミュレーターの設定を更新します。完了後は、そのシミュレーターを再起動してください。Bridge が次回起動時に選ぶシミュレーターは、「設定 → セッション」で設定します。