FFB Probe 的工作原理

引导运行

FFB Probe 围绕一个简短的测试者旅程进行组织：降落在超值道具屏幕上，检测摇杆，确认安全检查表，感受每个实时效果，回答发生的情况，然后保留或分享生成的报告。每个屏幕都专注于手头的任务，因此测试人员始终知道下一步该做什么。

步骤 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%。已验证过测试的摇杆从 75% 开始：SideWinder Force Feedback 2、SideWinder FFB Pro USB 适配器（03EB:2056、CAFE:4004）、Logitech G940、Force 3D Pro 和 WingMan Force 3D，以及 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。每个效果播放固定时长（Windows 上为五秒，Linux 上为两秒半），时长一到立即停止。随后回答卡片会询问你的感受：点选所有符合的标签，可添加一条私密备注，然后选择 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 播放的任何内容都不会超过满量程的 75%，适用于任何设备和任何测试，包括命令行 --magnitude 选项和诊断模式。同时播放的效果共享该强度，因此合计绝不会超过它。每份报告都会记录该强度以及你是否更改过它。

自动回中与停止时机

设备自身的自动回中弹簧会在实时测试期间关闭并在结束后恢复，因此不会抵消或掩盖正在测试的效果。每个效果在其播放时段结束时立即停止，而不是等到你作答时。Linux 上的 Logitech G940 是例外：其驱动程序会忽略自动回中设置，因此 FFB-Probe 不做改动，并注明硬件自动回中处于启用状态。

测量运动

每个效果播放时，探测器会在 Windows 和 Linux 上对摇杆的 X 轴和 Y 轴采样，并以各轴半量程的带符号百分比记录峰值位移，例如 X peak +25.1%, Y peak -0.8%。符号表示方向，从而让方向回答成为可验证的证据。位移从效果开始时摇杆的静止位置算起，因此静止时偏离中心的摇杆可能显示超过 100%。弹簧和阻尼等条件效果不会移动居中的摇杆，因此预计它们在静止时不会产生运动。该测量保留在私密的响应备注字段中，不会显示在公开设备页面上。

Brunner 基座

Brunner 基座会用自身保存的增益（出厂为 50%）缩放每个 DirectX 效果。在实时测试期间，FFB-Probe 会将 FX master 和各效果增益设为 100%（绝不更高，也不改动全局阻尼），并在结束后恢复你的数值，即使你中途停止测试也会恢复。在 DirectX 模式下，基座映射的轴旋转了 90°：0° 向右拉，90° 向前，180° 向左，270° 向后。这是 Brunner 固件的行为；FFB-Probe 按实测记录，不做校正。

每次运行写入的两个文件

在 Windows 上，报告保存到 %LOCALAPPDATA%\Programs\ffb-probe\Results\FFB-Probe-<timestamp>\；在 Linux 上保存到 ~/.local/share/ffb-probe/Results/FFB-Probe-<timestamp>/。每次测试会写入两个文件：HTML 报告和用于分享的 JSON。HTML 会将 JSON 嵌入 <pre> 块中，因此本地报告与上传数据的字节完全相同。只有设置了 FFB_PROBE_KEEP_LEGACY=1 时，才会写入旧版的文本、README 和支持 ZIP 文件。

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* 节点的写入访问权限。如果向导报告权限失败，请修复一次该设备的事件节点权限，而不是用 sudo 运行整个 AppImage。

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让它持久化

向 udev 询问该摇杆的 USB ID：

udevadm info -q property -n /dev/input/event2 | grep -E 'ID_VENDOR_ID|ID_MODEL_ID|NAME'

在设备特定的规则中使用这些小写十六进制 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 基座：配置接口

为了在 CLS2Sim 和 DirectX 模式之间切换 Brunner 基座，并在测试时提高其增益，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 向导使用 evdev 力反馈效果而不是 DirectInput。共享报告架构与 Windows 相同，因此 Linux 提交内容出现在相同的公共数据库和操作系统细分中。

Windows 和 Linux 上需经同意的更新

GUI 在启动时读取一个小的稳定版本清单。它不发送安装 ID、当前版本查询、设备信息或探测结果； offline and malformed responses stay silent.

测试进行中绝不会提供更新，未经你同意也不会安装任何内容。稳定版只会收到稳定版本的更新；beta 版会收到更新的 beta 版本以及取代它们的稳定版本。

明确同意后，FFB-Probe 下载安装程序，验证其确切长度和 SHA-256，需要 Rohsam Inc. 的有效 Windows 签名，以静默方式运行每用户安装程序，然后重新启动新版本。

正在运行的 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.

已知问题和恢复步骤

文字字节是审计表面

除非您点击 Share，否则报告文件会保留在本地。分享会将 JSON 文件通过 POST 发送到 /submit；这些字节与 HTML 报告底部嵌入的内容相同。GUI 会另外执行上述无标识符的启动清单检查，但绝不会在该检查中发送报告或设备数据。

公开硬件数据库按 VID:PID 显示汇总视图。它绝不会显示 responses[].notes；该字段可能包含测试者的可选文字以及探测器测得的运动。所选标签、设备类别、测试强度（run）、能力标志、支持的效果、结果代码、失败效果和运行错误可以显示在设备页面上。

欢迎界面中关于其他正在运行的程序的警告以及独占访问消息只会显示给你；其中的程序名称绝不会添加到报告中。

阅读完整的隐私合同 → · 打开上传的报告样本 →