文档 · 变更日志
FFB Probe 发行说明
每个公开版本中的更改,最新的在前。有意省略未发布的内部版本。
v1.1.2
最新修正默认测试强度:只有 Brunner FFB-G Joystick 从 75% 开始,其他所有 Brunner 基座均从 35% 开始。
Brunner 默认强度
- 只有 Brunner FFB-G Joystick 从 75% 开始。 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”。
v1.1.1
现在你可以选择测试驱动设备的强度(绝不超过硬性上限),并在测试开始前确认你会安全操作设备。
测试强度
- 检查清单新增强度滑块。 测试开始前,你可以将测试强度设为 0% 到 75%,步长 5%。滑块旁会显示当前值、设备的默认值和 75% 的上限,FFB-Probe 会记住你为每台设备最后选择的强度。
- 按设备设定默认值。 已验证过测试的摇杆从 75% 开始:SideWinder Force Feedback 2、SideWinder FFB Pro USB 适配器(03EB:2056、PicoWinder CAFE:4004)、Logitech G940、Force 3D Pro 和 WingMan Force 3D,以及所有 Brunner 基座。其他所有设备,包括 MOZA 飞行基座和 FFB-Probe 尚未识别的硬件,均从 35% 开始。
- 75% 是硬性上限。 FFB-Probe 播放的任何内容都不会超过满量程的 75%,适用于任何设备和任何测试,包括命令行 --magnitude 选项和诊断模式。同时播放的效果共享你选择的强度,因此合计绝不会超过它;饱和测试现在会将强度分配给三个力,在 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)”,共享数据中新增一个 run 对象,包含 strength_pct 和 strength_source。报告格式仍为 schema: 1。
- 双轴测试只使用一个名称。 它现在报告为“Two-axis diagonal — diagonal”,而不是“Two-axis diagonal — diagonal (X=75%, Y=75%)”,因此可调强度不会使它按每种强度拆分为单独的条目。网站会将旧名称合并到新名称中。
- 备注保持私密。 你输入的备注仍然保密,绝不会出现在公开设备页面上。
命令行
- --magnitude 用于设置测试强度。 超出 0..75 的值会被截取到该范围内,而不是被拒绝。未指定时,使用设备的默认值(75% 或 35%);早期版本在 Windows 上使用 75%,在 Linux 上使用 50%,由应用启动时使用 60%。控制台和调试日志会说明所用的强度以及它是否为默认值。
v1.1.0
这是一个加固版本:已完成的测试不会再在“Share”步骤丢失,进入公开数据库的结果更加准确,Brunner 和 MOZA 飞行基座现在开箱即用。
Brunner 基座
- 可检测 CLS2Sim 模式。 Brunner 基座出厂时处于 CLS2Sim 模式,该模式没有力反馈接口,因此早期版本找不到设备。现在如果未找到力反馈设备,FFB-Probe 会检查是否连接了 Brunner 基座,并提供“Switch to DirectX mode”;不点击该按钮就不会切换任何设置。
- 自动切换回原模式。 “Switch back when finished”默认开启:基座会在测试结束后、关闭 FFB-Probe 时,或在意外退出后的下次启动时恢复到 CLS2Sim 模式。只会写入 USB 模式设置;任何步骤失败时,基座都会恢复原状。
- 全强度效果。 基座会用自身保存的增益(出厂为 50%)缩放每个效果,因此效果到达电机时只有约四分之一的强度。在实时测试期间,FFB-Probe 会将 FX master 和各效果增益设为 100%,结束后恢复你的数值,并在报告中注明你保存的增益。
- 指出占用基座的程序。 如果 Simux、CLS2Sim、Brunner USB Config Tool 或 FFB-Bridge 占用了基座,FFB-Probe 会指出是哪个程序并告诉你如何关闭它。在 Linux 上,如果访问基座配置接口被拒绝,FFB-Probe 会显示需要添加的 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 上会列出占用设备的进程。这些程序名称只向你显示,绝不会添加到共享的报告中。
有效测试的分享绝不会失败
- 不再丢失测试。 以前,一条过长的备注或多选一个标签,就会让网站拒绝整份报告。现在每个字段在发送前都会限制在网站的范围内:选择所有标签不会再失败,过长的备注会被截短,“test”之类的占位设备名称会替换为 Unknown force-feedback device vvvv:pppp。
- 更彻底地清除路径。 会更彻底地从错误消息中移除文件路径,包括用户名含空格的 Windows 路径。
- 分享后显示支持代码和设备页面链接。 两者都会显示在应用中,以及 HTML 报告的“Share”按钮上。
- 格式不变,隐私不变。 报告格式保持不变(schema: 1),你输入的备注仍然保密,绝不会出现在公开设备页面上。
更准确的结果
- 在 Windows 上测量带符号的运动。 FFB-Probe 现在会在 Windows 上测量每个效果期间摇杆移动的幅度和方向,与 Linux 上已有的做法一致。读数带有正负号,例如 X peak +25.1%,因此可以看出方向。
- 效果按时停止。 每个效果在其播放时段结束时立即停止,而不是等到你作答时。某些固件(如 Brunner)会让 5 秒的力多持续约一秒。
- 自动回中不再干扰测试。 设备自身的自动回中弹簧会在实时测试期间关闭并在结束后恢复,因此不会再抵消或掩盖正在测试的效果。在 Brunner 基座上,它曾阻挡所有效果。
- 更多回答进入报告。 斜坡回答现在会被纳入报告而不再丢弃,极性、双轴和饱和结果也会显示在公开诊断中。
- 记录设备类别。 报告会记录设备是操纵杆、飞行摇杆、方向盘还是游戏手柄,以便公开数据库区分飞行硬件和方向盘。
- 正确的效果参数。 自动回中测试会使用自动回中属性(早期版本使用了错误的属性 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)。
v1.0.8
针对使用发行版友好名称而非内核风格 Linux 字符串来描述自身的 Linux 发行版,修复了报告分享问题。
从 Linux 分享报告
- 单一的粗粒度 os.family 标记。 提交负载中的 os.family 现在始终是 Windows、Linux、macOS 或 Unknown 之一。在 .NET 8 及更高版本中,Linux 会报告发行版友好名称——例如 Fedora Linux 42 (Workstation Edition)——而早期版本会原样转发;网站会以 os_family_invalid 拒绝超过 32 个字符的值。
- 友好名称通过运行平台解析。 从不包含 Linux 一词的发行版名称(例如 Ubuntu 的名称)现在通过探针所运行的平台来解析,而不是通过操作系统描述,因此不再拆分公共数据库中按操作系统划分的能力快照。
- 现有安装仍可继续分享。 网站还会在接收时规范化旧版值,因此来自较早版本的报告无需先更新即可成功分享。
v1.0.7
自动更新到达 Windows 和 Linux,推进了当天早些时候发布的测量运动和硬件识别工作。
自动更新
- 私人启动检查。 GUI 在启动时读取一个小的稳定版本清单。它不发送安装 ID、当前版本查询、设备信息或探测结果; offline and malformed responses stay silent.
- Windows 可以完成升级。 明确同意后,FFB-Probe 下载安装程序,验证其确切长度和 SHA-256,需要 Rohsam Inc. 的有效 Windows 签名,以静默方式运行每用户安装程序,然后重新启动新版本。
- AppImage 安装可以自行更新。 正在运行的 Linux AppImage 可以下载并验证新的 AppImage,调用其用户范围的安装处理程序,刷新桌面条目和图标,并启动已安装的副本。
- 其他安装的安全回退。 开发版本、提取的 AppDirs、发行版包和其他非 AppImage Linux 安装永远不会被覆盖。 The prompt links to the download page and these release notes instead, and every user can defer or skip a version.
包括硬件和 Linux 改进
- 测量 Linux 效果期间的运动。 实时测试现在可以在施加力的同时对设备轴进行采样,同时记录目标位移测试人员的答案。
- MOZA AY210 指导。 AY210 (346E:1001) 具有规范名称和供应商设置的飞行前指南,可以屏蔽外部指挥的部队。
- 正确、一致的硬件名称。 MOZA 346E:1002 被标识为共享 AB6/AB9 基 PID,并且 03EB:2056 处的改编 SideWinder Force Feedback Pro 在应用程序和公共数据库中使用一个跨平台名称。
- 更强大的 Linux 发现。 驱动程序路径和 HID-描述符解析更具防御性,并且仅当设备通告该功能时才写入 autocenter。
升级说明
- 为现有用户提供一次手动更新。 通过 1.0.6 的版本不包含更新程序,因此它们必须手动安装一次 1.0.7 。然后可以从应用程序内部安装 1.0.7 之后的版本。
v1.0.6
取代硬件和 Linux 证据版本在网站下载通道推进之前已被 1.0.7 取代。
Linux 测量
- 安讯士遥测加入了主观答案。 Linux 工作人员在效果播放时记录测量的位移,帮助区分工作效果和错误的“不执行任何操作”响应。
- 更安全的设备设置。 输入事件路径和 HID 报告描述符解析更可靠,而 FF_AUTOCENTER 仅在公开它的硬件上被触及。
硬件身份
- 添加了 MOZA AY210。 AY210 (346E:1001) 在测试之前接收规范名称和 MOZA Cockpit 前提条件。
- MOZA AB6/AB9 PID 已更正。 共享 346E:1002 标识符不再仅表示两个兼容基本模型之一。
- 改编后的 SideWinder 名称标准化。 03EB:2056 现在聚合在一个 Windows/Linux 名称下。这是命名更正,而不是新的驱动支持声明。
Linux 包装
- 用户范围的 AppImage 安装。 AppImage 获得了内置 --install 和 --uninstall 桌面集成,用于用户的应用程序和 XDG 目录。
v1.0.4
固件的 Windows 驱动修复在其自己的春季启动模式,并在不产生物理力的情况下接受探针命令。
修复
- 实时效果之前的干净设备状态。 获取设备并设置全局增益后,Windows 工作线程在实时测试序列开始之前发送尽力而为的 DirectInput STOPALL。这会清除固件拥有的默认力量,因此上传的 FFB Probe 效果可以从第一次测试中获得控制。
- 无破坏性重置。 该修复故意避免 DISFFC_RESET,保留设备效果表并保留崩溃恢复的完全重置。
谁受益
- 默认弹簧和 DIY 固件。 此更改的目标设备(包括 Fino 派生的 DIY 轭)报告成功的 Create 和 Play 调用,但仍由启动弹簧保持,直到发出 STOPALL 为止。
v1.0.2
一个集中的界面版本,使每个所需的操作都可以在固定大小的向导窗口内进行。
清单布局
- 未知设备命名不再涵盖控件。 当出现额外的“命名此设备”卡时,清单卡会滚动,同时 Arm 探针、后退和进度控件保持固定并可见。
测试答案布局
- 长时间的私人笔记保留在其中。 答案区域可以滚动,多行笔记框有自己的高度上限,因此无论笔记长度或选择的芯片如何,继续并再次运行测试仍然可以访问。
回归覆盖
- 屏幕截图涵盖了问题布局。 屏幕截图工具现在呈现未知设备清单和长的多行答案,保护回归的布局。
v1.0.1
元数据和设备识别修补程序,可保持公共硬件行干净并在共享之前使未知设备显式化。
一致的提交元数据
- FFB Probe 版本使用稳定的 SemVer。 现在,上传会发送诸如 1.0.1 之类的值,而无需 SDK 源版本后缀,因此公共数据库不会将一个版本拆分为多个构建字符串。
设备名称
- 共享 138 个条目 VID:PID 目录。 Windows、Linux、GUI 和网站获得了更广泛的力反馈名称表,包括 MOZA AB9 和 Logitech G940 标识符。
- 必须命名未知硬件。 GUI 在制造商/型号名称的清单处暂停,交互式 CLI 运行提示,并且自动化可以通过 --device-name。 Generic placeholders are rejected before upload.
- 有用的平台名称仍然可用。 非交互式运行在存在时保留有意义的已清理操作系统名称,否则它们将使用显式的未知强制反馈设备 VID:PID 后备。
网站协调
- 现在应用程序和数据库名称匹配。 网站收到相同的规范化目录,因此新旧提交会聚合在稳定的名称下。
v1.0.0
初始版本针对 Windows 和 Linux 的独立 FFB-Probe 诊断的第一个稳定公开版本。
指导硬件测试
- 以测试人员为中心的完整向导。 FFB-Probe 检测连接的力反馈设备,呈现安全检查表,播放简短的实时效果,并记录测试人员每次效果后的感受。
- 广泛的效果覆盖范围。 测试套件通过图表和分段感知进度检查恒定、条件、周期性、弹簧、阻尼器、惯性和斜坡行为。
- 从第一天起 Windows 和 Linux。 Windows DirectInput 工作人员和Linux evdev 工作船位于同一跨平台 Avalonia 接口后面。
报告和共享
- 人类可读和机器可读的输出。 每次运行都会在本地写入 HTML 报告和准确的 JSON 提交负载,因此测试人员可以在决定是否共享之前检查证据。
- 共享是选择加入的。 Nothing uploads automatically.仅当测试人员可以查看收集的字段后,结果屏幕和保存的 HTML 报告才会公开共享操作。
- 公开事实,私人注释。 硬件功能、效果答案和封闭词汇诊断可以支持公共数据库,而自由文本注释则保持私有以进行支持分类。
发布包
- 独立版本。 公开版本包括每个用户Windows 安装程序和 Linux x86-64 AppImage 以及捆绑的 .NET 运行时。
- 签名的 Windows 发行版。 稳定的 Windows 二进制文件和安装程序是通过 Rohsam 发布者身份的发布工作流程生成的。