医師

Doctor ページはワンストップの健康診断です。デバイス、SIM、ホスト環境に対していくつかのプローブを実行し、明らかな修正がある場合は、それを適用するためのインラインアクションを提供します。何かがうまくいかないときはいつでもここから始めてください - おそらくドクターはすでにそれが何であるかを知っています。

Figure 1. Doctor page. Each row is one check: status icon, title, inline detail, and a contextual action button.

ハードウェアの互換性

Doctor ページの最初のカードは、 ハードウェアの互換性 パネル。これは 2 つの関連するコントロールをホストします。 軸極性の反転 トグルとライブドラッグパッド 極性テスト. Both exist because different production runs of the Sidewinder Force Feedback 2 interpret force-feedback polarity differently — on some sticks, what the bridge thinks is “forward” physically pulls back, and vice-versa. The toggle is the install-level fix; the test is how you know whether to flip it.

Figure 2. Hardware compatibility card at the top of the Doctor page — Invert axis polarity toggle, drag-pad polarity test, and the hardware-periodics compatibility row with its Test hardware effects button.

ライブ極性テスト

クリック スタート 小さな X-Y ドラッグパッドがアクティブになります。パックを動かすと、スティックがリアルタイムで追従します。テスト中はブリッジがモックモードで自動アームするため、SIM 接続がなくても前提条件チェックがパスします。クリック停止終わったら。確認モーダルで尋ねられます 「スティックはパックを追ったのか？」:

はい — 極性は正しく、変更は行われません。
いいえ — トグルは自動的に反転し、その後のピッチ軸とロール軸の両方の力はデバイスの出力エッジで打ち消されます。

テスト中に Doctor ページから移動すると、自動的に停止し、以前の入力ソース (ライブまたはアイドル) が復元されます。明示的な停止は必要ありません。

軸極性反転（手動）

カードの左側にあるトグルは、テストで書き込まれる設定と同じです。スティックにフリップが必要であることがすでにわかっている場合は、これを直接使用します。たとえば、以前のインストールでこれを経験しており、テスト前に設定したい場合などです。この設定はプロファイルごとではなくインストールレベルです。この設定はブリッジの環境設定内に存在し、ピッチ軸とロール軸の両方に一緒に適用され、再起動後も存続します。

なぜ両方の軸が一緒なのか

以前のビルドでは、ロールとは独立してピッチを反転できました。これは、FFB2 のファームウェアの実際の癖とは一致しませんでした。一方の軸が反転すると、両方の軸が反転します。トグルにより、それらがペアとして反転されます。既存のピッチごとの設定は、最初の起動時に前方に移行されます。

ソフトウェアブレンド定期刊行物

ブリッジには、周期的エフェクトとワンショットエフェクト (ランブル、ビュッフェ、震えなど) を FFB2 にディスパッチする 2 つの方法があります。 ハードウェアモード — 新規インストールのデフォルト — DirectInput ハードウェアエフェクトを使用し、beta.11 ではそのトポロジを意図的に小さく保ちます (ベクトル定数 1 つ、2 軸スプリング 1 つ、遅延 3 スロット周期プール)。ファームウェアは引き続きネイティブレートで周期波形を駆動します。ブリッジは、現在の滑走路、エンジン、ビュッフェ、ワンショットキュー用にそれらの物理スロットを再利用するだけです。 ソフトウェアブレンド定期刊行物、同じ Doctor 行のトグルは、連続力/センタリングハードウェアパスのみを保持し、C# で 200 Hz で周期的およびワンショットキューを合成し、結果を定力出力に組み込みます。

ハードウェアモードでは、ファームウェアがブリッジのティックレートよりも高速にエフェクトを駆動するため、最高周波数のエフェクトがより鮮明でレイテンシーが低くなります。ソフトウェアブレンディングは、ハードウェアモードでもクラッシュするドライバースタック、失敗したプローブ結果、または意図的にそれを好むユーザーのための互換性フォールバックです。一般的なクリーンでない出口は、それ自体でソフトウェアブレンディングを強制しません。どちらのモードでも、同じエフェクトごとのチューニングスライダーを備えた同じ 14 個のエフェクトが使用されます。選択は機能の切り替えではなく、ディスパッチの詳細によって行われます。どちらの方法でも再起動が必要です。ディスパッチャは起動時にモードを読み取ります。

クリック ハードウェア効果をテストする コンパクトなハードウェアトポロジを安全に試すことができます。 Doctor は別のワーカープロセスを開始し、ブリッジが飛行中に使用するのと同じベクトル定数、2 軸スプリング、周期的なプールを割り当ててから、ブリッジを破棄します。 Windows の DirectInput/PID スタックがクラッシュした場合、ワーカーのみが死亡し、ブリッジは開いたままになります。テストに合格すると、Doctor とランタイムは次回の起動時に同じハードウェアモード状態に切り替わり、Doctor のステータスと実際のディスパッチャモードが一致します。

小切手の配置方法

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

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

小切手

デバイス

Sidewinder Force Feedback 2 が OS に認識され、ブリッジが排他的にそれを開くことができることを確認します。 VID/PID が存在しない場合、または別のプロセスがハンドルを保持している場合は失敗します。

Linux udev ルール

Checks whether /etc/udev/rules.d/99-ffb-bridge.rules is present and matches the canonical content. When absent, the action is udevルールをインストールする — this triggers a pkexec prompt to write the file into a privileged location.

NixOS の例外

Doctor detects NixOS (by looking for /etc/NIXOS) and replaces the udev-rule row with an instruction to add the rule to configuration.nix instead. See インストールスニペットの場合。

SimConnect 構成

Looks for MSFS's SimConnect.xml in the platform-appropriate location, parses it, and compares any enabled IPv4 entries against the port the bridge is using. Three possible outcomes:

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

SimConnect の到達可能性

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

X-Plane の到達可能性

Sends a tiny RREF probe to 127.0.0.1:49000 and waits briefly for a dataref in response. Maps both timeout and Winsock's WSAECONNRESET (received when an ICMP port-unreachable was delivered) to “not running”.

ランタイム

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

クラッシュログ

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

修正ダイアログ

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

Figure 3. Fix dialog for SimConnect config install. The exact XML snippet to be added is shown, along with a preview of the resulting file.

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

Linux pkexec の動作

Actions that write to system paths (udev rules, anything under /etc) route through pkexec. You'll see your distro's normal polkit prompt — the same one that pops up for gparted or a package manager GUI. Exit codes Doctor interprets:

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

ヒント

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

ドクターがどこでも緑色のとき

アプリは動作するはずです。そうでない場合、Diagnostics のイベントログには、Doctor の 1 行のステータスよりも詳細な情報が表示されます。次にそこに向かうか、次の場所にジャンプしてくださいトラブルシューティング一般的な症状と修正については。