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

サポートページ

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

サポートページ。デフォルトのヘルスチェックタブには、プローブごとに 1 行が表示され、PASS / INFO / WARN / FAIL 状態と、修正が利用可能な場合のコンテキスト アクション ボタンが表示されます。 サポートページ。デフォルトのヘルスチェックタブには、プローブごとに 1 行が表示され、PASS / INFO / WARN / FAIL 状態と、修正が利用可能な場合のコンテキスト アクション ボタンが表示されます。
Figure 1. サポートページ。デフォルトのヘルスチェックタブには、プローブごとに 1 行が表示され、PASS / INFO / WARN / FAIL 状態と、修正が利用可能な場合のコンテキスト アクション ボタンが表示されます。

タブストリップ

サポートページが開きます リソース タブ — ドキュメント + マニュアル リンク + ウェルカム ツアー リプレイがフレンドリーな最初の着陸としてそこにあります。他の 2 つのタブは 1 クリックでアクセスできます。

  • リソース (最初に開きます) — ここでホストされているドキュメントとマニュアル、さらにウェルカム ツアーのリプレイと発行者/法的ページへのリンクです。
  • ヘルスチェック — 日常的なトリアージ面 (デバイス、Linux 上の udev ルール、SIM の到達可能性、実行時の状態)。クリック チェックを実行する プローブする。
  • 診断 — ランタイム メトリクス、検索可能なイベント ログ、ワンクリックのサポート バンドル エクスポート。別途文書化されています。 診断タブ ページ。

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

ヘルスチェックタブ

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

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

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

起動時、FFB-Bridge は Windows、Linux、macOS のデバイスバックエンドを静かに確認します。Linux では、対応イベントノードへの読み書きアクセスと、インストール済み udev ルールが現在のすべてのデバイス権限を含むかも確認します。WARN または FAIL があると、各問題を示す非ブロッキングの[確認して修正]バナーが表示されます。

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

ハードウェア

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

Hardware → Calibration — ピッチとロールの方向、力の極性、必要な軸の入れ替えを確認します。 Hardware → Calibration — ピッチとロールの方向、力の極性、必要な軸の入れ替えを確認します。
Figure 3. Hardware → Calibration — ピッチとロールの方向、力の極性、必要な軸の入れ替えを確認します。

チェックの配置のしかた

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

  • ステータス — PASS (緑)、INFO (青)、WARN (オレンジ)、FAIL (赤)、READY / CHECKING (ニュートラル)、または行がこのプラットフォームに適用されない場合は N/A。
  • タイトル — 何をチェックしているのか。
  • 詳細 — 見つかった内容の 1 行の要約。カーソルを合わせる (またはタッチでタップする) と、詳細が表示されます。
  • アクションボタン — 実行可能な何かがある場合にのみ表示されます。例: udevルールをインストールする, 使用ポート:5111, 修正….

小切手

デバイス

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

Linux udev ルール

Health checks は、/etc/udev/rules.d/99-ffb-bridge.rules に現在のすべての対応デバイス入力行と MOZA TTY 権限が含まれるか確認します。Fix は管理された標準ルールを表示し、pkexec でインストールして udev を再読み込みし、入力デバイスと TTY デバイスをトリガーします。接続済みで明示的に有効化された未登録ジョイスティックはインストール時に追加されます。

イベント専用の古いルールは、現在の MOZA TTY 権限がないため WARN として報告されます。ファイルがすでに存在していても Fix を使用してください。アプリが完全な生成ルールに置き換えます。

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

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

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

WindowsLinux SimConnect 構成

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

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

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

SimConnect の到達可能性

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

X-Plane の到達可能性

X-Plane パスはあらゆるプラットフォームで動作し、macOS (Apple Silicon) では、X-Plane 12 と SideWinder FFB2 の組み合わせがサポートされています。このチェックでは、小さな RREF プローブが送信されます。 127.0.0.1:49000 そして、応答としての dataref を少し待ちます。タイムアウトと Winsock の両方をマップします WSAECONNRESET (ICMP ポート到達不能が配信されたときに受信) を「非実行」にします。

ランタイム

制御ループが目標の 50 Hz で動作していることを確認します。過去 60 秒の平均が 45 Hz を下回った場合に警告します。

クラッシュログ

最後のセッションのクラッシュ ログがある場合は、行がオレンジ色になり、オファーが表示されます。 明らかにする ファイルマネージャーでそのファイルにジャンプし、 フィードバックフォームから送信する これにより、ログが添付されたフィードバック送信が事前に入力されます。

修正ダイアログ

修正… ボタンは変更を直接適用しません。何が、どこで変更されようとしているか、そして (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 行のステータスよりも詳細な情報が表示されます。またはジャンプしてください トラブルシューティング 一般的な症状と修正については。