現在のリリースです。 FFB-Bridge v1.2.1 は公開中です。このドキュメントはリリースマニフェストに記載された現在のアプリを追跡します。古い内容に見える箇所があれば、 フィードバックフォーム.

サポートページ

サポートページ (ラベル サポート サイドバーの ) は、何か問題がある場合、リファレンスが必要な場合、または開発者向けのサポート バンドルをエクスポートしたい場合に開くすべての単一のホームです。 3 つのタブ: リソース, ヘルスチェック、そして 診断。以前ここに存在していたハードウェア互換性コントロールは、次の場所に移動されました。 設定→ハードウェア.

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

タブストリップ

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

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

ハードウェア互換性 (反転 + ピッチ/ロール スワップによる軸テスト、エフェクト レンダリング、Windows デバイス バックエンド、デバイス ピッカー、および ハードウェア効果をテストする プローブ) は [サポート] タブではなくなりました - 存続します 設定→ハードウェア.

ヘルスチェックタブ

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

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

ハードウェアコントロールは設定に移動されました

ハードウェア互換性コントロールは以前は [サポート] タブにありました。現在は次の場所にあります 設定→ハードウェア: ライブ 軸テスト軸極性の反転 そして ピッチ/ロール軸を交換する)、 エフェクトの演出 ラジオ (ハードウェア エフェクトとソフトウェア互換モード)、Windows デバイス バックエンド、複数の接続されたスティックのデバイス ピッカー、実験的な非公開デバイスのオプトイン、および ハードウェア効果をテストする プローブ。を参照してください。 設定ページ 完全なウォークスルーについては。

設定 → ハードウェア — 軸テスト (反転 + ピッチ/ロール スワップ)、エフェクト レンダリング、Windows デバイス バックエンド、およびテスト ハードウェア エフェクト プローブ。 設定 → ハードウェア — 軸テスト (反転 + ピッチ/ロール スワップ)、エフェクト レンダリング、Windows デバイス バックエンド、およびテスト ハードウェア エフェクト プローブ。
図2 。 設定 → ハードウェア — 軸テスト (反転 + ピッチ/ロール スワップ)、エフェクト レンダリング、Windows デバイス バックエンド、およびテスト ハードウェア エフェクト プローブ。

チェックの配置のしかた

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

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

小切手

デバイス

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

Linux udev ルール

Checks whether /etc/udev/rules.d/99-ffb-bridge.rules が存在し、正規のコンテンツと一致します。不在の場合のアクションは、 udevルールをインストールする — これにより、 pkexec 特権のある場所にファイルを書き込むように求めるプロンプトが表示されます。

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 スニペットが、結果のファイルのプレビューとともに表示されます。
図3 。 SimConnect 構成インストールのダイアログを修正。追加される正確な XML スニペットが、結果のファイルのプレビューとともに表示されます。

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

Linux pkexec の動作

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

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

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

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

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