FFB Probe の仕組み
ウィザード、ライブ フォース フィードバック セクション、2 つのローカル レポート ファイル、既知の問題、および Share をクリックしたときに送信される内容についてのテスター中心のガイドです。
ガイド付き走行
FFB Probe は、1 回の短いテスターの旅を中心に構成されています。つまり、バリュープロップ画面に着地し、スティックを検出し、安全チェックリストを確認し、それぞれのライブ効果を感じ、何が起こったのかに答え、結果のレポートを保存または共有します。各画面は目の前のタスクに焦点を当てているため、テスターは次に何をすべきかを常に把握できます。
ヘッダ
現在のステップがメイン作業領域を所有している間、ヘッダーは FFB Probe ID を表示したままにします。実行コントロールは、アクティブな画面内の、影響を受けるアクションの近くに表示されます。
進捗
ウィザードは、状況に応じて進行状況を表示します。プローブ前のチェックリストの数、フォースがアクティブな間のセクション カードと効果の数、実行終了時のクリアな結果状態が表示されます。
作業エリア
ボディはフルブリードで、ライブスティックのプレビュー、チェックリスト、信号図、回答チップ、または最終レポート/共有パネルなど、フェーズに応じて変化します。
土地
最初の起動の着陸では、テスターが何かを行う前に、FFB Probe とは何か、テストに必要な内容、およびパブリック ハードウェア データベースが重要である理由が説明されます。
検出する
次の画面では、ジョイスティック、VID:PID、およびフォース フィードバック機能が識別され、フォースが再生される前のスティックのライブ読み出しが表示されます。
準備する
チェックリストにより、テスターはシミュレータを近くに置き、机のスペースを空け、スティックに手を添えたままにし、FFB2 グリップ センサーの癖に対処するようになります。
感じる
実行中のビューには、Stop コントロールを隠すことなく、ライブ セクション、予期される信号、カウントダウン、および現在のエフェクトが表示されます。
答え
各エフェクトの後、2 つのサーフェスがテスターの応答をキャプチャします。チップ グリッド (複数選択、パブリック - これらのラベルはデバイスのハードウェア DB ページに表示されます) とオプションの自由テキスト ノート ボックス (プライベート - サーバー側に保持され、パブリック ページには表示されません)。
保存または共有
結果ページでは、デフォルトでレポートがローカルに保持されます。共有すると、編集されたハードウェア ペイロードが送信され、オプションの電子メール フィールドを使用して、FFB-Bridge がスティックのサポートを開始する場合に注意を求めることができます。
プローブがハードウェアに要求すること
標準の Windows バッテリーには、GUI に表示される 4 つのライブ セクション (Constant、Periodic、Condition、および Ramp) が表示されます。プローブは各ドライバーが実際に列挙したものを尊重するため、カウントは異なる場合があります。
極性スイープ
約5秒間安定して引っ張ります。スティックが動いた物理的な方向を報告します。
便利なチップ: 左、右、前方、後方、何もしませんでした
2軸対角線
XモーターとYモーターを同時に使用した斜め引き。その後、デバイスが弱ったままになってはいけません。
便利なチップ: 斜め、1軸のみ、弱い、何もしなかった
正弦
約5秒間の滑らかな振動または揺動運動を繰り返します。
便利なチップ: 遅い発振、早い発振、ブザー音
四角
よりシャープなオン/オフ振動、または約 5 秒間の繰り返しタップ。
便利なチップ: 高速発振、ブザー音、ワンジャーク
三角形
繰り返される前後の動き。通常は方形よりも滑らかですが、正弦よりも機械的です。
便利なチップ: 低速発振、高速発振
鋸歯状
繰り返されるランピングまたはブーンという動き。非対称に感じるかもしれません。
便利なチップ: Ramp音、ブザー音、弱い
春
スティックをゆっくりと動かします。中心に向かって押し戻されるはずです。
便利なチップ: 中央、減衰、何もしませんでした
ダンパー
スティックをゆっくりと動かします。シロップの中を移動するような動きに抵抗する必要があります。
便利なチップ: 減衰、Friction、何もしませんでした
慣性
スティックを静かに動かし始めたり止めたりします。動きの変化に抵抗する可能性があります。
便利なチップ: Inertia、重い、何もしなかった
摩擦
スティックをゆっくりと動かします。重くなったり、ベタつくように感じる場合があります。
便利なチップ: Friction、減衰、何もしませんでした
Ramp スイープ
テストされた各アクチュエータ上で、ゼロから設定された大きさまで増加する力。
便利なチップ: Ramping、左、後退、何もしませんでした
飽和プローブ
複数の同方向定数は、エフェクトがスタックされたときにデバイスがどのようにクリップするかを特徴付けます。
便利なチップ: 強い、弱い、切り取られた、何もしなかった
2 つのファイルはそれぞれ実行すると書き込みます
レポートの保存先 %LOCALAPPDATA%\Programs\ffb-probe\Results\FFB-Probe-<timestamp>\ Windows と ~/.local/share/ffb-probe/Results/FFB-Probe-<timestamp>/ Linux で。実行ごとに 2 つのファイル。HTML は JSON を埋め込みます。 <pre> ブロックするため、ローカル レポートとアップロード ペイロードは同じバイトであることが保証され、2 番目の隠れたアーティファクトは発生しません。
自己完結型レポート — ブラウザで開き、独自の Share ボタンがあります。 ~22KB
リテラルの SubmissionPayload — HTML の下部に埋め込まれているのと同じバイト、GUI が /submit に POST するのと同じバイト。 ~6KB
未署名のインストーラーの警告を超えて
インストーラーはユーザーごとにインストールされます。管理者パスワードや UAC プロンプトは必要ありません。バイナリを以下に配置します %LOCALAPPDATA%\Programs\ffb-probe そして、デスクトップ ショートカットと Start Menu エントリを書き込みます。ディレクトリ選択機能は非表示になっているため、誤って奇妙な場所にインストールすることはありません。 SHA-256 を確認する ダウンロード ページにあるファイルは、実行前に持っていたファイルと一致します。
ベータ ビルドはまだコード署名されていません。コード署名は v1.0 ロードマップに含まれています。警告が 2 つ表示されます。どちらも予期されています。
Windows SmartScreen— 「Windows が PC を保護しました」
「認識されないアプリ」または「Windows が PC を保護しました」という青いダイアログが表示され、 走らないで ボタン。クリック 詳細情報 一番上で、その後 とにかく走ってください 一番下にあります。ブリッジ インストーラがたどるパスと同じです。
Windows 11 Smart App Control (SAC)
SAC がオン (アクティブ モード) の場合、インストーラーは単純に起動しません。SmartScreen プロンプトも表示されません。 とにかく走ってください オプションを選択しても、何も起こりません。 SAC は、署名されていない実行可能ファイルを完全に拒否します。 v1.0 が署名付きバイナリを出荷するまでの回避策:
- 開く 設定 → プライバシーとセキュリティ → Windows セキュリティ → アプリとブラウザの制御 → Smart App Control 設定.
- SAC を次のように切り替えます。 オフ。 Windows は、クリーン インストールしないとオンに戻すことはできないと警告します。これは、オフからアクティブへの移行の場合にのみ当てはまります。に行く 評価 または休んでも大丈夫です。
- プローブ インストーラーを実行します。
- インストール後、必要に応じて SAC を再度有効にすることができます。インストールされたバイナリは実行可能なままです。
Microsoft の SAC FAQ トグルについて詳しく説明します。
v1.0 リリースがコード署名証明書とともに出荷されると、両方の警告が表示されなくなり、SAC がインストーラーをブロックしなくなります。それまでは、警告を問題の証拠としてではなく、予想どおりに扱ってください。
AppImage および evdev 権限
Linux ビルドは、自己完結型の AppImage として出荷されます。これを実行可能としてマークして実行し、スティックに十分な電力が供給された状態で移動できるようにします。
chmod +x ./FfbProbe-*.AppImage
./FfbProbe-*.AppImage
検出は読み取り専用アクセスで機能しますが、ライブエフェクトにはジョイスティックへの書き込みアクセスが必要です。 /dev/input/event* ノード。ウィザードが権限の失敗を報告した場合は、AppImage 全体を実行するのではなく、デバイスのイベント ノードの権限を一度修正します。 sudo.
1. イベントノードを見つける
レポートまたはエラー テキストでは通常、次のような名前が付けられます。 event=/dev/input/event2。ジョイスティック イベントのシンボリックリンクを検査することもできます。
ls -l /dev/input/by-id/*event-joystick
2. 一時的な許可を試してください
交換する event2 スティックのノードを使用します。これはデバイスのプラグが抜かれるかマシンが再起動するまで続くため、問題を確認する安全な方法です。
sudo setfacl -m "u:$USER:rw" /dev/input/event2
./FfbProbe-*.AppImage
3. udev を使用して永続化します。
スティックの USB ID については、udev に問い合わせてください。
udevadm info -q property -n /dev/input/event2 | grep -E 'ID_VENDOR_ID|ID_MODEL_ID|NAME'
これらの小文字の 16 進 ID をデバイス固有のルールで使用します。この例は、SideWinder FFB2、VID:PID 用です。 045e:001b:
sudo tee /etc/udev/rules.d/70-ffb-probe-045e-001b.rules > /dev/null <<'EOF'
# FFB Probe: allow the active desktop user to open this joystick's event node.
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
EOF
sudo udevadm control --reload-rules
sudo udevadm trigger --subsystem-match=input
スティックを取り外して再度接続し、AppImage を通常どおり実行します。ルールはデバイスごとであるため、ユーザーを広範囲のデバイスに追加するよりも安全です。 input グループ。
Linux ウィザードは、DirectInput ではなく evdev フォース フィードバック エフェクトを使用します。共有レポートのスキーマは Windows と同じであるため、Linux の送信は同じパブリック データベースと OS 内訳に表示されます。
既知の問題と回復手順
フォースフィードバックデバイスが検出されませんでした
フライト シミュレーター、joy.cpl、Logitech Profiler、およびデバイスを既に所有している可能性のあるその他のツールを閉じます。スティックを抜き差しし、再スキャンします。
ワーカーが実行中にクラッシュした
危険な DirectInput 作業がワーカー プロセスに分離されているため、GUI は実行を続けます。部分的なレポートを保管し、サポートに送信してください。
棒は引き続けます
USB と電源を取り外し、10 秒待って、最初に電源を接続し、次に USB を再接続します。 FFB2 ファームウェアは、ハード障害後の最後の力を保持できます。
SideWinder FFB2 は何もしません
グリップセンサーを覆うか、軽く握ります。 DirectInput 呼び出しは、アクチュエーターが光センサーによってゲートされている間は成功します。
Linux 権限が拒否されました
ユーザーはスティックの /dev/input/event* ノードへの読み取り/書き込みアクセスを必要とする場合があります。 Linux ドキュメントには、setfacl を使用してこれをテストし、デバイスごとの udev ルールを使用して永続化する方法が示されています。
Windows SmartScreen「認識されないアプリ」
インストーラーはまだコード署名されていません。コード署名は v1.0 のロードマップに含まれています。 「詳細」をクリックしてから「とにかく実行」をクリックして続行します。ダウンロード ページの SHA-256 が、実行前に取得したファイルと一致することを確認します。
Windows 11 Smart App Control はインストーラーをブロックします
SAC が有効になっている場合、インストーラーは単純に起動しません。プロンプトも「とにかく実行」も表示されません。 [設定] → [プライバシーとセキュリティ] → [Windows セキュリティ] → [アプリとブラウザのコントロール] → [スマート アプリ コントロール設定] で SAC をオフに切り替え、プローブをインストールしてから、SAC をオンに戻します。ベータ版のビルドは署名されていません。 1.0 のコード署名を出荷すると、このステップはなくなります。
リテラルバイトは監査面です
プローブをローカルで実行しても何も送信されません。2 つのファイルはディスク上に残ります。クリックする Share JSON ファイルを次の宛先に POST します。 /submit このサーバー上で。その JSON は、HTML レポートの下部に埋め込まれているバイトと同じです。共有する前に読むことができます。
パブリック ハードウェア データベースは、VID:PID ごとに集計ビューをレンダリングします。表示されない唯一のフィールドはエフェクトごとです 自由記述メモ — テスターが実行中にオプションのメモ ボックスに入力した内容。その他すべて (チップ選択、機能フラグ、サポートされているエフェクト、HRESULT コード、失敗したエフェクト、実行エラー) は、プローブが書き込んだとおりにデバイス ページに表示されます。