FFB Probe の仕組み

ガイド付き走行

FFB Probe は、1 回の短いテスターの旅を中心に構成されています。つまり、バリュープロップ画面に着地し、スティックを検出し、安全チェックリストを確認し、それぞれのライブ効果を感じ、何が起こったのかに答え、結果のレポートを保存または共有します。各画面は目の前のタスクに焦点を当てているため、テスターは次に何をすべきかを常に把握できます。

ステップ 01

土地

最初の画面では、FFB Probe が何をテストするのか、何が得られるのか、そして公開ハードウェアデータベースがなぜ存在するのかを説明します。続行するまでハードウェアには一切触れません。

ステップ 02

検出する

ウェルカム画面はフォースフィードバックデバイスとその VID:PID、対応エフェクトを特定し、力を再生する前にスティックのリアルタイム表示を示します。

ステップ 03

準備する

チェックリストではテスト強度を設定し、安全に関する注意への同意を求め、他のソフトウェアが閉じられていてスティックを動かせるスペースがあることを確認します。

ステップ 04

感じる

各エフェクトは決まった時間再生され、その間、画面にはセクション、想定される信号、カウントダウンが表示されます。「Stop run」は常に表示され、Esc キーでいつでもテストを停止できます。

ステップ 05

答え

各エフェクトの後、感じた内容に当てはまるチップをすべてタップします。チップは公開されますが、任意のメモ欄は非公開のままです。「Continue」、「Run test again」、「Skip」で次に進みます。

ステップ 06

保存または共有

レポートはまずお使いのコンピューターに保存されます。「Share my results」は秘匿処理済みのペイロードを送信し、その後アプリにサポートコードとデバイスの公開ページへのリンクが表示されます。

ウェルカム画面: 検出と他のプログラム

ウェルカム画面はフォースフィードバックデバイスをスキャンし、テスト対象のデバイスを、その VID:PID、対応エフェクト数、スティックのリアルタイム表示とともに示します。テストするのはそのデバイスだけです。何かを接続したり他のプログラムを閉じたりした後は、Re-scan で検出をやり直します。

フライトシミュレーター、FFB-Bridge、MOZA Cockpit や Pit House、Brunner のツール、Logitech G HUB など、デバイスを占有する可能性のあるプログラムが実行中の場合は、琥珀色の Other software running カードにそのプログラム名と閉じ方が表示されます。この警告によってテストが妨げられることはありません。プログラムを閉じたら Re-check をクリックしてください。

Brunner ベースは出荷時に CLS2Sim モードになっており、このモードにはフォースフィードバックのインターフェースがありません。フォースフィードバックデバイスが見つからない場合、FFB-Probe は Brunner ベースを探し、Switch to DirectX mode を提示します。このクリックなしに切り替えが行われることはありません。Switch back to CLS2Sim mode when finished は既定でオンになっているため、ベースはテスト後、FFB-Probe を閉じたとき、または FFB-Probe が予期せず終了した場合は次回起動時に CLS2Sim モードに戻ります。書き込むのは、元のモードを記録した後の USB モード設定だけです。いずれかの手順が失敗した場合は、ベースを元の状態に戻します。

Simux、CLS2Sim、Brunner USB Config Tool、または FFB-Bridge がベースを使用している場合は、カードにそのプログラム名が表示され、終了するよう求められます。システムトレイからも終了してから Re-scan をクリックしてください。DirectX モードのないファームウェアはその旨を報告し、何も書き込みません。

チェックリスト: 強度、安全、準備

Test strength は、各エフェクトがデバイスをどれだけ強く駆動するかを 0% から 75% まで 5% 刻みで設定します。テストの検証が済んでいるスティック、つまり SideWinder Force Feedback 2、SideWinder FFB Pro USB アダプター (03EB:2056、CAFE:4004)、Logitech G940、Force 3D Pro、WingMan Force 3D、および Brunner FFB-G Joystick は 75% から始まります。Brunner FFB-G Joystick は、取り付けたグリップに関係なく、Brunner の設定チャネルを通じてベースが報告するベースの種類で識別されます。ほかの Brunner ベース、MOZA フライトベース、FFB-Probe がまだ認識していないハードウェアを含むその他のデバイスは 35% から始まります。Simux、CLS2Sim、Brunner USB Config Tool、または FFB-Bridge がこのチャネルを使用している場合はベースの種類を読み取れないため、ベースは 35% から始まり、チェックリストにそのプログラムを閉じて Re-scan をクリックするよう表示されます。FFB-Probe は、デバイスごとに最後に選んだ強度を記憶します。

Safety の注意は常に表示されます。フォースフィードバックデバイスは突然、実際の力で動くことがあるため、グリップに軽く手を添え、指やケーブル、物を近づけず、いつでも Esc キーまたは「Stop run」で停止できるようにしてください。I understand and accept responsibility にチェックを入れ、チェックリストのすべての項目を確認するまで、Arm probe は無効のままです。強度をデバイスの既定値より上げると、強力なダイレクトドライブのベースがエンドストップに激しく当たる可能性があるという警告が追加されます。

チェックリストはデバイスに合わせて変わります。SideWinder FFB2 と Logitech G940 では、誰もスティックを握っていないとグリップセンサーがモーター出力を遮断するため、手を添えていることを確認する項目が追加されます。アプリのハードウェア表にない VID:PID の場合は、実際のメーカー名とモデル名の入力を求めます。

MOZA フライトベース

MOZA AB9、AY210、AB6、AY90 の場合、チェックリストに MOZA BASE カードが追加されます。このカードは何も変更せずに、ベースが実際にエフェクトを再生できるかを読み取ります。MOZA Cockpit の Telemetry モードのベースや、フォースフィードバックが無効、トルク出力が抑止、ゲームゲインが 0 のベースは、すべてのエフェクトを受け付けても何も動きません。

ベースの準備ができていない場合、カードはその理由を一覧表示し、Prepare base for testing を提示します。これは設定を保存したうえでベースを DirectInput モードに切り替え、力の出力制限を解除します。Restore my MOZA settings when finished は既定でオンで、テスト後または FFB-Probe を閉じたときに設定を元に戻します。可動範囲の制限、キャリブレーション、Force Sensing には一切触れません。MOZA Cockpit、MOZA Pit House、または FFB-Bridge が設定ポートを使用している場合はカードにその名前が表示されるので、そのプログラムを閉じて Re-check をクリックしてください。

実行: 感じる、答える、止める

テストは Constant、Periodic、Condition、Ramp の 4 つのセクションに分かれています。各エフェクトは決まった時間 (Windows では 5 秒、Linux では 2.5 秒) 再生され、その時間が終わるとすぐに停止します。続いて回答カードで感じた内容を尋ねられます。当てはまるチップをすべてタップし、必要に応じて非公開のメモを追加して、Continue、Run test again、Skip のいずれかを選んでください。

Stop run はヘッダーとカウントダウンの横に表示され、Esc キーでいつでもテストを停止できます。テスト中にウィンドウを閉じると、まずエフェクトを停止してデバイスを解放します。停止までに測定された内容はローカルに保存されます。

結果: 保存、共有、フォローアップ

結果画面にはレポートの保存場所が、Show in folder と See my results とともに表示されます。Share my results は秘匿処理済みのペイロードを送信します。それ以外に何かがアップロードされることはありません。共有後、アプリには サポートコード とデバイスの公開ページへのリンクが表示され、HTML レポートの Share ボタンにも同じものが表示されます。後で提出内容について問い合わせたり削除を依頼したりする可能性がある場合は、このコードを保管してください。任意のメールアドレス欄に入力すると、FFB-Bridge がお使いのスティックに対応したときのお知らせなど、ニュースを受け取れます。

他のプログラムがデバイスを排他的に使用していた場合、結果画面にそのプログラム名が表示され、このテストではデバイスから何も測定できなかったことが説明されます。テストのために切り替えた Brunner ベースや、テスト用に準備した MOZA ベースは、プローブエンジンの終了後に元の状態に戻されます。

プローブがハードウェアに要求すること

Windows はライブテストを Constant、Periodic、Condition、Ramp の各セクションに分けます。Linux は各デバイスが通知する同等の evdev エフェクトを表示します。正確な数は両プラットフォームともドライバーとハードウェアによって異なります。

テスト強度と 75% の上限

すべてのエフェクトは、チェックリストで選んだテスト強度で再生されます。FFB-Probe が再生するものは、どのデバイスでもどのテストでも、コマンドラインの --magnitude オプションや診断モードを含め、フルスケールの 75% を超えることはありません。同時に再生されるエフェクトは強度を分け合うため、合計しても選んだ強度を超えません。すべてのレポートに、強度とそれを変更したかどうかが記録されます。

オートセンターと停止のタイミング

デバイス自身のオートセンタースプリングはライブテスト中にオフにされ、終了後に復元されるため、テスト中のエフェクトを打ち消したり覆い隠したりしません。各エフェクトは、回答したときではなく、再生時間が終わった時点で停止します。例外は Linux 上の Logitech G940 です。そのドライバーはオートセンター設定を無視するため、FFB-Probe は設定を変更せず、ハードウェアのオートセンターが有効だったことを記録します。

測定された動き

各エフェクトの再生中、プローブは Windows と Linux でスティックの X 軸と Y 軸をサンプリングし、各軸の片側範囲に対する符号付きの割合としてピーク移動量を記録します (例: X peak +25.1%, Y peak -0.8%)。符号は方向を示すため、方向に関する回答を検証可能な証拠にできます。動きはエフェクト開始時にスティックが静止していた位置から測定するため、中心から外れた位置で静止しているスティックでは 100% を超えることがあります。スプリングやダンパーなどの Condition エフェクトは中心にあるスティックを動かさないため、静止状態で動きがないのが正常です。この測定値は非公開の回答メモ欄に残り、公開デバイスページには表示されません。

Brunner ベース

Brunner ベースは、すべての DirectX エフェクトに自身が保存しているゲイン (工場出荷時は 50%) を掛けます。ライブテストの間、FFB-Probe は FX master とエフェクトのゲインを 100% に設定し (それより高くはせず、グローバルのダンピングには触れません)、終了後に元の値を復元します。テストを停止した場合も同様です。DirectX モードでは、ベースは軸を 90° 回転させて割り当てます。0° は右へ、90° は前へ、180° は左へ、270° は後ろへ引きます。これは Brunner のファームウェアの動作です。FFB-Probe はこれを測定どおりに記録し、補正しません。

2 つのファイルはそれぞれ実行すると書き込みます

レポートは、Windows では %LOCALAPPDATA%\Programs\ffb-probe\Results\FFB-Probe-<timestamp>\、Linux では ~/.local/share/ffb-probe/Results/FFB-Probe-<timestamp>/ に保存されます。実行ごとに HTML レポートと共有用 JSON の 2 つのファイルが書き込まれます。HTML は JSON を <pre> ブロックに埋め込んでいるため、ローカルレポートとアップロードされるペイロードはまったく同じバイト列です。以前のテキスト、README、サポート ZIP ファイルは、FFB_PROBE_KEEP_LEGACY=1 が設定されている場合にのみ書き込まれます。

Windows へのインストールと発行元の確認

FFB Probe は Rohsam Inc. によって発行されています。インストーラーはユーザーごとにインストールされ、管理者パスワードや UAC プロンプトは必要ありません。バイナリは %LOCALAPPDATA%\Programs\ffb-probe の下に配置され、デスクトップ ショートカットと Start Menu エントリが書き込まれます。ディレクトリ選択機能は非表示になっているため、誤って奇妙な場所にインストールすることはありません。安定版の Windows リリースには署名が付いています。実行する前に、ダウンロード ページで Windows が発行元として Rohsam Inc. を表示していることと、SHA-256 を確認する を確かめてください。

Windows がインストーラーの検証済み発行元として Rohsam Inc. を表示しない場合、またはハッシュが公開マニフェストと一致しない場合は、そのファイルを実行しないでください。

リリース マニフェストが、ファイル名、サイズ、ハッシュに関する信頼できる情報源です。Windows インストーラーと Linux AppImage はどちらもオプトインのダウンロードです。プローブを実行しても、Share を選択するまでレポートはローカルに保持されます。

AppImage および evdev 権限

Linux ビルドは、自己完結型の AppImage として出荷されます。これを実行可能としてマークして実行し、スティックに十分な電力が供給された状態で移動できるようにします。

chmod +x ./FfbProbe-*.AppImage
./FfbProbe-*.AppImage

AppImage はそのまま実行できます。また、./FfbProbe-*.AppImage --install を使うと ~/Applications にユーザー単位のデスクトップ統合を追加できます。インストール済みコピーとメニュー項目を削除するには --uninstall を使用します。

検出は読み取り専用アクセスで機能しますが、ライブエフェクトにはジョイスティックの /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 グループに追加するよりも安全です。

4. Brunner ベース: 設定インターフェース

Brunner ベースを CLS2Sim モードと DirectX モードの間で切り替えたり、テストのためにゲインを上げたりするために、FFB-Probe はベースの hidraw 設定インターフェースを使用します。このインターフェースは既定では root しかアクセスできません。アクセスが拒否された場合、FFB-Probe は追加すべきルールを表示します。FFB-Bridge の udev ルールにはすでに含まれています。それ以外の場合は、次のファイルを作成してベースを接続し直してください：

sudo tee /etc/udev/rules.d/71-ffb-probe-brunner.rules > /dev/null <<'EOF'
SUBSYSTEM=="hidraw", KERNEL=="hidraw*", ATTRS{modalias}=="usb:v25BBp*in01", TAG+="uaccess"
EOF

sudo udevadm control --reload
sudo udevadm trigger

5. MOZA ベース: 設定ポート

MOZA の準備状態チェックと Prepare base for testing は、ベースの USB シリアル設定ポート /dev/ttyACM* を介して通信します。FFB-Probe がポートを開けない場合は、dialout グループへの追加を提案します。追加した後は、一度ログアウトしてから再度ログインしてください：

sudo usermod -aG dialout "$USER"

デバイスごとのルールを使うと、アクティブなデスクトップユーザーだけに同じアクセス権を与えられます：

sudo tee /etc/udev/rules.d/70-ffb-probe-moza.rules > /dev/null <<'EOF'
SUBSYSTEM=="tty", KERNEL=="ttyACM*", ATTRS{idVendor}=="346e", TAG+="uaccess"
EOF

sudo udevadm control --reload-rules
sudo udevadm trigger --subsystem-match=tty

他のプログラムがデバイスを使用している場合

テストの前に、Linux ワーカーはイベントノードを一度開きます。ノードが使用中 (EBUSY) の場合、FFB-Probe は /proc/*/fd を調べて、ノードを保持しているプロセスの名前を表示します。アクセスが拒否された場合 (EACCES または EPERM) は、上記の権限設定の手順を案内します。他のユーザーや root が実行しているプロセスは権限がないと一覧表示できず、メッセージにもその旨が示されます。

カーネルのオートセンターは各エフェクトの再生中はオフにされ、エフェクトの合間に復元されます。Logitech G940 では一切変更しません。この Linux ドライバーは設定を無視し、常に最大の強さでセンタリングするためです。

Linux ウィザードは、DirectInput ではなく evdev フォースフィードバック エフェクトを使用します。共有レポートのスキーマは Windows と同じであるため、Linux の送信は同じパブリック データベースと OS 内訳に表示されます。

Windows と Linux で同意を前提とした更新

GUI は起動時に小さな安定リリース マニフェストを読み取ります。インストール ID、現在のバージョンのクエリ、デバイス情報、プローブ結果は送信されません。オフラインおよび不正な応答は沈黙を保ちます。

テストの実行中に更新が案内されることはなく、同意なしに何かがインストールされることもありません。安定版のビルドには安定版のリリースだけが案内されます。ベータ版のビルドには、より新しいベータ版と、それらに取って代わる安定版リリースが案内されます。

明示的な同意の後、FFB-Probe はインストーラーをダウンロードし、その正確な長さと SHA-256 を確認し、Rohsam Inc. からの有効な Windows 署名を要求し、ユーザーごとのインストーラーをサイレントに実行して、新しいビルドを再起動します。

実行中の Linux AppImage は、新しい AppImage をダウンロードして確認し、そのユーザー スコープのインストール ハンドラーを呼び出し、デスクトップ エントリとアイコンを更新し、インストールされたコピーを起動できます。

開発ビルド、抽出された AppDirs、ディストリビューション パッケージ、およびその他の非 AppImage Linux インストールは上書きされません。プロンプトは代わりにダウンロード ページとリリース ノートにリンクしており、すべてのユーザーはバージョンを延期またはスキップできます。

既知の問題と回復手順

リテラルバイトは監査面です

Share をクリックしない限り、レポートファイルはローカルに残ります。共有すると JSON ファイルが /submit に POST されます。これは HTML レポート下部に埋め込まれたものと同じバイトです。GUI は別途、上記の識別子を含まない起動時マニフェスト確認を行いますが、レポートやデバイスのデータは送信しません。

公開ハードウェアデータベースは VID:PID ごとの集計ビューを表示します。任意のテスター入力とプローブが測定した動きを含むことがある responses[].notes は一切表示しません。選択ラベル、デバイスクラス、テスト強度 (run)、機能フラグ、対応エフェクト、結果コード、失敗したエフェクト、実行エラーはデバイスページに表示されることがあります。

実行中の他のプログラムに関するウェルカム画面の警告と排他アクセスのメッセージは、あなたにのみ表示されます。そこに含まれるプログラム名がレポートに追加されることはありません。

プライバシー契約全文を読む→ · アップロードされたサンプルレポートを開く →