FFB Probe リリースノート

既定のテスト強度の修正: 75% から始まるのは Brunner FFB-G Joystick だけになり、その他の Brunner ベースはすべて 35% から始まります。

Brunner の既定強度

• 75% から始まるのは Brunner FFB-G Joystick だけ。 FFB-Probe は、取り付けたグリップに関係なく、Brunner の設定チャネルを通じてベースが報告するベースの種類でこれを識別し、チェックリストに「Validated base (Brunner FFB-G Joystick) — default 75%」と表示します。1.1.1 では、すべての Brunner ベースの既定値が 75% になっていました。
• ほかの Brunner ベースは 35% から開始。 CLS-E、CLS-P、ラダーをはじめ、その他すべての Brunner ベースは、テストの検証が済んでいないデバイスと同じく 35% から始まります。ほかのデバイスと同様に、75% の上限まで自分で強度を上げられます。
• 種類を読み取れないベースは 35% から開始。 Simux、CLS2Sim、Brunner USB Config Tool、または FFB-Bridge が設定チャネルを使用している間は、FFB-Probe はベースの種類を読み取れません。その場合、チェックリストにそのプログラムを閉じて「Re-scan」をクリックするよう表示されます。

テストがデバイスを駆動する強さを選べるようになりました。強さが厳格な上限を超えることはなく、テストを開始する前に、デバイスを安全に操作することを確認します。

テスト強度

• チェックリストに強度スライダー。 テストの前に、テスト強度を 0% から 75% まで 5% 刻みで設定できます。スライダーの横には設定値、デバイスの既定値、上限の 75% が表示され、FFB-Probe はデバイスごとに最後に選んだ強度を記憶します。
• デバイスごとの既定値。 テストの検証が済んでいるスティック、つまり SideWinder Force Feedback 2、SideWinder FFB Pro USB アダプター (03EB:2056、PicoWinder CAFE:4004)、Logitech G940、Force 3D Pro、WingMan Force 3D、およびすべての Brunner ベースは 75% から始まります。MOZA フライトベースや FFB-Probe がまだ認識していないハードウェアを含むその他のデバイスは 35% から始まります。
• 75% は絶対的な上限。 FFB-Probe が再生するものは、どのデバイスでもどのテストでも、コマンドラインの --magnitude オプションや診断モードを含め、フルスケールの 75% を超えることはありません。同時に再生されるエフェクトは選んだ強度を分け合うため、合計しても選んだ強度を超えません。飽和テストでは強度を 3 つの力に分割するようになりました (75% のときはそれぞれ 25%)。
• Brunner ベースの 35% 制限を撤廃。 テスト中は DirectX ゲインを引き上げるため、SideWinder FFB2 と同様に 75% から始まるようになりました。35% ではテストが弱すぎて判断できませんでした。
• MOZA フライトベースの強度を引き上げ可能に。 引き続き 35% (このハードウェアに対する FFB-Bridge の上限) から始まりますが、強度を自分で上げられるようになりました。以前の 35% 固定の上限は、既定値と 75% の上限に置き換えられました。

安全に関する確認

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

レポート

• 強度を記録。 すべてのレポートに、テスト強度とそれを変更したかどうかが記録されます。HTML レポートには「Test strength: 75% (default)」または「Test strength: 50% (chosen by tester)」と表示され、共有データには strength_pct と strength_source を持つ新しい run オブジェクトが含まれます。レポート形式は引き続き schema: 1 です。
• 2 軸テストの名前を 1 つに統一。 「Two-axis diagonal — diagonal (X=75%, Y=75%)」ではなく「Two-axis diagonal — diagonal」として報告されるようになったため、強度を調整できるようになっても、強度ごとに別の項目に分かれることはありません。ウェブサイトでは旧名を新しい名前に統合します。
• メモは非公開のまま。 入力したメモは非公開のままで、公開デバイスページに表示されることはありません。

コマンドライン

• --magnitude でテスト強度を設定。 0..75 の範囲外の値は拒否されず、範囲内に丸められます。指定しない場合はデバイスの既定値 (75% または 35%) が使用されます。以前のビルドでは Windows で 75%、Linux で 50%、アプリから起動された場合は 60% を使用していました。コンソールとデバッグログには、使用された強度とそれが既定値だったかどうかが記録されます。

堅牢性を高めるリリースです。完了したテストが「Share」の段階で失われることがなくなり、公開データベースに届く結果がより正確になり、Brunner と MOZA のフライトベースが追加設定なしで動作するようになりました。

Brunner ベース

• CLS2Sim モードを検出します。 Brunner ベースは出荷時に CLS2Sim モードになっており、このモードにはフォースフィードバックのインターフェースがないため、以前のビルドではデバイスが見つかりませんでした。フォースフィードバックデバイスが見つからない場合、FFB-Probe は Brunner ベースの有無を確認し、「Switch to DirectX mode」を提示するようになりました。このクリックなしに切り替えが行われることはありません。
• 元のモードへ自動で戻します。 「Switch back when finished」は既定でオンです。テスト後、FFB-Probe を閉じたとき、または予期せず終了した場合は次回起動時に、ベースを CLS2Sim モードに戻します。書き込むのは USB モードの設定だけで、いずれかの手順が失敗した場合はベースを元の状態に戻します。
• フルパワーのエフェクト。 ベースはすべてのエフェクトに自身が保存しているゲイン (工場出荷時は 50%) を掛けるため、エフェクトはおよそ 4 分の 1 の強さでしかモーターに届いていませんでした。ライブテストの間、FFB-Probe は FX master とエフェクトのゲインを 100% に設定し、終了後に元の値を復元します。保存されていたゲインはレポートに記録されます。
• ベースを使用中のプログラムを特定します。 Simux、CLS2Sim、Brunner USB Config Tool、または FFB-Bridge がベースを使用している場合、FFB-Probe はそのプログラム名と閉じ方を表示します。Linux でベースの設定インターフェースへのアクセスが拒否された場合は、追加すべき udev ルールの行を表示します。
• 回転した方向は測定どおりに記録します。 DirectX モードで感じることがある方向の 90° のずれは、Brunner の DirectX モードによる軸の割り当て方によるものです。FFB-Probe はこれを測定どおりに記録します。

MOZA フライトベース

• テスト前に準備状態を確認します。 FFB-Probe は何も変更せずに、MOZA AB9、AY210、AB6、AY90 が実際にフォースフィードバックエフェクトを再生できるかを読み取ります。MOZA Cockpit の Telemetry モードのベースや、フォースフィードバックが無効、トルク出力が抑止、ゲームゲインが 0 のベースは動きません。以前のビルドではこれが「何も起きなかった」と記録されていましたが、現在はそのようなベースのレポートに準備ができていなかったことが明記されます。
• ベースの事前準備 (任意)。 「Prepare base for testing」は設定を保存したうえでベースを DirectInput モードに切り替え、力の出力制限を解除します。「Restore my MOZA settings when finished」(既定でオン) は終了後に設定を元に戻します。可動範囲の制限、キャリブレーション、Force Sensing には一切触れません。
• 安全な強さの上限。 MOZA フライトベースと Brunner ベースでは、エフェクトテストを最大 35% の強さで実行します。これはこれらのハードウェアに対する FFB-Bridge の上限で、手を離したスティックがエンドストップまで動かされることを防ぎます。

デバイスを使用する他のプログラム

• 競合するプログラムを警告します。 ウェルカム画面では、デバイスを占有する可能性のあるプログラム (FFB-Bridge、MOZA Cockpit / Pit House、Brunner のツール、Logitech G HUB、フライトシミュレーター) が実行中の場合に警告します。
• 排他アクセスのエラーをわかりやすく。 別のプログラムがデバイスを排他的に使用している場合、FFB-Probe は汎用エラーで失敗する代わりに、どのプログラムかを表示します。Linux ではデバイスを使用しているプロセス名を表示します。これらのプログラム名はあなたにだけ表示され、共有レポートに追加されることはありません。

有効なテストなら共有は必ず成功します

• テストが無駄になることはもうありません。 以前は長いメモが 1 つ、あるいはチップが 1 つ多いだけで、サイトがレポート全体を拒否していました。現在は送信前にすべてのフィールドをサイトの制限内に収めます。すべてのチップを選択しても失敗せず、非常に長いメモは短縮され、「test」のような仮のデバイス名は Unknown force-feedback device vvvv:pppp に置き換えられます。
• パスの除去を強化。 エラーメッセージからファイルパスをより徹底的に除去します。ユーザー名にスペースを含む Windows のパスも対象です。
• 共有後にサポートコードとデバイスページへのリンクを表示。 どちらもアプリ内と、HTML レポートの「Share」ボタンに表示されます。
• 形式もプライバシーも従来どおり。 レポートの形式は変わりません (schema: 1)。入力したメモは引き続き非公開で、公開デバイスページに表示されることはありません。

より正確な結果

• Windows で符号付きの動きを測定。 FFB-Probe は Linux と同様に Windows でも、各エフェクトの間にスティックがどれだけ、どの方向に動いたかを測定するようになりました。測定値には符号が付き (例: X peak +25.1%)、方向がわかります。
• エフェクトは時間どおりに停止します。 各エフェクトは、回答したときではなく、再生時間が終わった時点で停止します。一部のファームウェア (Brunner など) では、5 秒間の力が約 1 秒長く続いていました。
• オートセンターが邪魔をしなくなりました。 デバイス自身のオートセンタースプリングはライブテスト中にオフにされ、終了後に復元されるため、テスト中のエフェクトを打ち消したり覆い隠したりしなくなりました。Brunner ベースでは、これがすべてのエフェクトを妨げていました。
• より多くの回答がレポートに反映されます。 ランプの回答が破棄されずにレポートに含まれるようになり、極性、2 軸、飽和の結果が公開診断に表示されるようになりました。
• デバイスの種類を記録します。 レポートには、デバイスがジョイスティック、フライトスティック、ホイール、ゲームパッドのいずれかが記録されるため、公開データベースでフライト用ハードウェアとホイールを区別できます。
• エフェクトのパラメーターを修正。 オートセンターのテストはオートセンターのプロパティを正しく使用し (以前のビルドは誤ったプロパティ ID を使用していました)、スプリング、ダンパー、慣性、摩擦は DirectInput が想定する座標の規約に従います。Windows では、不明なデバイスが再び実際のドライバー名を報告するようになりました。

アプリ

• ライブ表示はテスト中のデバイスに追従します。 以前は Windows が最初に列挙したゲームコントローラーを表示していたため、複数のコントローラーがある環境では動きませんでした。
• Stop はどこでも機能します。 Stop はテストのどの段階でも機能し、Esc キーでもテストを停止できます。テスト中にウィンドウを閉じると、まずエフェクトを停止してデバイスを解放します。テストするのは選択したデバイスだけで、アプリが終了するとプローブエンジンも停止します。
• 使いやすさを向上。 回答をスキップでき、ウィンドウのサイズを変更でき、テキストが読みやすくなりました。
• 更新の案内を適切なタイミングで。 テストの実行中に更新が案内されることはなく、安定版を使用している人にベータ版が案内されることもありません。

Linux

• テストの再実行が機能します。 「Run test again」でエフェクトが再び再生されるようになりました。
• カーネルのオートセンターをエフェクトごとに制御。 各エフェクトの再生中はオフにし、エフェクトの合間に復元します。ドライバーがこの設定を無視する Logitech G940 では一切変更しません。
• テストごとのファイルを削減。 通常のテストでは HTML レポートと共有用 JSON だけを書き出します。従来のサポートファイルは FFB_PROBE_KEEP_LEGACY=1 が設定されている場合にのみ書き出されます。

デバイス名の更新

• 新しい名前と修正された名前。 MOZA 346E:1002 は MOZA AB6 と表示されるようになりました。追加: MOZA AY90 (346E:1003)、Brunner FFB-G / FFB-H、PicoWinder SideWinder FFB Pro アダプター (CAFE:4004)、Adapt-FFB-Joy (03EB:204E)。

カーネル形式の Linux 文字列ではなくディストリビューションの表示名で自身を記述する Linux ディストリビューション向けの、レポート共有の修正です。

Linux からのレポート共有

• 単一の粗い os.family トークン。 送信ペイロードの os.family は常に Windows、Linux、macOS、Unknown のいずれかになりました。.NET 8 以降、Linux はディストリビューションの表示名（例: Fedora Linux 42 (Workstation Edition)）を報告し、以前のビルドはそれをそのまま転送していました。サイトは 32 文字を超える値を os_family_invalid として拒否します。
• 表示名は実行中のプラットフォームを通じて解決されます。 Ubuntu のように Linux という語を含まないディストリビューション名は、OS の説明ではなくプローブが実行されているプラットフォームを通じて解決されるようになり、公開データベースの OS ごとの機能スナップショットが分断されなくなりました。
• 既存のインストールでも共有を続けられます。 サイト側でも受信時に旧形式の値を正規化するため、古いビルドからのレポートも先に更新することなく共有できます。

自動更新は Windows と Linux に適用され、同日初めに公開された動作測定とハードウェア識別の作業が引き継がれます。

自動更新

• プライベートな起動チェック。 GUI は起動時に小さな安定リリース マニフェストを読み取ります。インストール ID、現在のバージョンのクエリ、デバイス情報、プローブ結果は送信されません。オフラインおよび不正な応答は沈黙を保ちます。
• Windows はアップグレードを完了できます。 明示的な同意の後、FFB-Probe はインストーラーをダウンロードし、その正確な長さと SHA-256 を確認し、Rohsam Inc. からの有効な Windows 署名を要求し、ユーザーごとのインストーラーをサイレントに実行して、新しいビルドを再起動します。
• AppImage インストールは自動的に更新できます。 実行中の Linux AppImage は、新しい AppImage をダウンロードして確認し、そのユーザー スコープのインストール ハンドラーを呼び出し、デスクトップ エントリとアイコンを更新し、インストールされたコピーを起動できます。
• 他のインストールの安全なフォールバック。 開発ビルド、抽出された AppDirs、ディストリビューション パッケージ、およびその他の非 AppImage Linux インストールは上書きされません。プロンプトは代わりにダウンロード ページとリリース ノートにリンクしており、すべてのユーザーはバージョンを延期またはスキップできます。

ハードウェアと Linux の改善が含まれています

• Linux 効果中のモーションを測定しました。 ライブ テストでは、力の再生中にデバイスの軸をサンプリングし、テスターの回答とともに客観的な変位を記録するようになりました。
• MOZA AY210 のガイダンス。 AY210 (346E:1001) には、外部から命令された力をマスクできるベンダー設定の正規名と飛行前ガイダンスがあります。
• 正確で一貫性のあるハードウェア名。 MOZA 346E:1002 は、共有 AB6/AB9 ベース PID として識別され、03EB:2056 で適応された SideWinder Force Feedback Pro は、アプリとパブリック データベースで 1 つのクロスプラットフォーム名を使用します。
• より堅牢な Linux 検出。 ドライバー パスと HID 記述子の解決はより防御的であり、オートセンターはデバイスがその機能をアドバタイズする場合にのみ書き込まれます。

アップグレードメモ

• 既存ユーザー向けの手動アップデートが 1 つあります。 1.0.6 までのバージョンにはアップデータが含まれていないため、1.0.7 を手動で一度インストールする必要があります。 1.0.7 以降のリリースは、アプリ内からインストールできるようになります。

Web サイトのダウンロード チャネルが発展する前に、1.0.7 に置き換えられたハードウェアおよび Linux 証拠リリース。

Linux 測定

• 軸テレメトリは主観的な回答に加わります。 Linux ワーカーは、エフェクトの再生中に測定された変位を記録し、動作中のエフェクトと誤った「何もしなかった」応答を区別するのに役立ちます。
• より安全なデバイスのセットアップ。 入力イベント パスと HID レポート記述子はより確実に解決されますが、FF_AUTOCENTER はそれを公開するハードウェア上でのみ操作されます。

ハードウェアのアイデンティティ

• MOZA AY210 が追加されました。 AY210 (346E:1001) は、テスト前に正規名と MOZA Cockpit の前提条件を受け取ります。
• MOZA AB6/AB9 PID を修正しました。 共有 346E:1002 識別子は、2 つの互換性のある基本モデルのうちの 1 つだけを意味するものではなくなりました。
• SideWinder 名を正規化して調整しました。 03EB:2056 は、1 つの Windows/Linux 名の下に集約されるようになりました。これはネーミングの修正であり、新たな作動サポートの主張ではありません。

Linux パッケージ化

• ユーザースコープの AppImage インストール。 AppImage には、ユーザーのアプリケーション ディレクトリと XDG ディレクトリ用の組み込みの --install および --uninstall デスクトップ統合が追加されました。

独自のスプリング モードで起動し、それ以外の場合は物理的な力を生成せずにプローブ コマンドを受け入れるファームウェアの Windows 作動修正。

修正

• ライブ エフェクト前のクリーンなデバイス状態。 デバイスを取得してグローバル ゲインを設定した後、Windows ワーカーはライブ テスト シーケンスが開始する前にベストエフォートの DirectInput STOPALL を送信します。これにより、ファームウェアが所有するデフォルトの強制がクリアされるため、アップロードされた FFB Probe 効果が最初のテストから制御できるようになります。
• 破壊的なリセットはありません。 この修正では、DISFFC_RESET を意図的に回避し、デバイス エフェクト テーブルを保存し、クラッシュ回復のために完全なリセットを予約します。

誰が得をするのか

• デフォルトのスプリングと DIY ファームウェア。 この変更は、成功した Create および Play 呼び出しを報告するが、STOPALL が発行されるまで起動スプリングによって保持されたままになる、Fino 由来の DIY ヨークを含むデバイスを対象としています。

固定サイズのウィザード ウィンドウ内で必要なすべてのアクションにアクセスできるようにする、焦点を絞ったインターフェイス リリース。

チェックリストのレイアウト

• 不明なデバイスの名前がコントロールに適用されなくなりました。 追加の「このデバイスに名前を付ける」カードが表示されると、チェックリスト カードがスクロールし、アーム プローブ、戻る、および進行状況のコントロールは固定されて表示されたままになります。

テストと回答のレイアウト

• プライベートな長いメモは含まれたままになります。 回答エリアはスクロール可能で、複数行のノート ボックスには独自の高さ制限があるため、ノートの長さや選択したチップに関係なく、「続行」と「テストの再実行」に到達できます。

回帰カバレッジ

• 問題のレイアウトはスクリーンショットでカバーされています。 スクリーンショット ハーネスは、未知のデバイスのチェックリストと長い複数行の回答の両方をレンダリングし、退行したレイアウトを保護します。

パブリック ハードウェアの行をクリーンな状態に保ち、共有する前に不明なデバイスを明示するメタデータおよびデバイス識別ホットフィックス。

一貫した送信メタデータ

• FFB Probe バージョンでは、安定した SemVer が使用されます。 アップロードでは、SDK ソース リビジョン サフィックスのない 1.0.1 などの値が送信されるようになりました。そのため、パブリック データベースは 1 つのリリースを複数のビルド文字列に分割しません。

デバイス名

• 138 エントリの共有 VID:PID カタログ。 Windows、Linux、GUI、および Web サイトは、MOZA AB9 および Logitech G940 識別子を含む、より広範なフォース フィードバック名テーブルを取得しました。
• 不明なハードウェアに名前を付ける必要があります。 GUI はメーカー/モデル名のチェックリストで一時停止し、対話型 CLI はプロンプトを実行し、自動化は --device-name を渡すことができます。一般的なプレースホルダーはアップロード前に拒否されます。
• 有用なプラットフォーム名は引き続き使用できます。 非対話型の実行では、意味のあるサニタイズされた OS 名が存在する場合はその名前が保持されます。それ以外の場合は、明示的な不明なフォース フィードバック デバイス VID:PID フォールバックが使用されます。

ウェブサイト連携

• アプリとデータベースの名前が使用されるようになりました。 ウェブサイトは同じ正規化されたカタログを受信したため、古い送信と新しい送信は安定した名前で集約されます。

Windows および Linux 用のスタンドアロン FFB-Probe 診断の最初の安定したパブリック リリース。

ガイド付きハードウェア テスト

• テスターに特化した完全なウィザード。 FFB-Probe は、接続されたフォース フィードバック デバイスを検出し、安全性チェックリストを提示し、短いライブ エフェクトを再生し、それぞれの後にテスターが感じたことを記録します。
• 幅広い効果範囲。 テスト スイートは、図とセクション認識の進行状況を使用して、定数、条件付き、周期的、スプリング、ダンパー、慣性、およびランプの動作をチェックします。
• 初日からの Windows と Linux。 Windows DirectInput ワーカーと Linux evdev ワーカーは、同じクロスプラットフォーム Avalonia インターフェイスの背後に出荷されます。

レポートと共有

• 人間が判読できる出力と機械が判読できる出力。 実行ごとに HTML レポートと正確な JSON 送信ペイロードがローカルに書き込まれるため、テスターは共有するかどうかを決定する前に証拠を検査できます。
• 共有はオプトインです。 何も自動的にアップロードされません。結果画面と保存された HTML レポートは、テスターが収集されたフィールドを確認した後にのみ共有アクションを公開します。
• 公的な事実と個人的なメモ。 ハードウェア機能、効果的な回答、および非公開の語彙診断は公開データベースをサポートできますが、フリーテキストのメモはサポートの優先順位付けのために非公開のままです。

リリース パッケージ

• 自己完結型リリース。 パブリック リリースには、ユーザーごとの Windows インストーラーと、.NET ランタイムがバンドルされた Linux x86-64 AppImage が含まれています。
• 署名済みの Windows 配布パッケージ。 安定した Windows バイナリとインストーラーは、Rohsam パブリッシャー ID の下でリリース ワークフローを通じて作成されます。