当前版本。 FFB-Bridge v1.2.1 已上线。这些文档跟随发布清单所描述的当前应用。如果某个部分看起来过时,请通过 反馈表.

支持页面

支持页面(标记为 支持 侧边栏中的 )是您在出现问题、需要参考或想为开发者导出支持包时要打开的一切内容的单一主页。三个选项卡: 资源, 健康检查, 和 诊断。以前驻留在此处的硬件兼容性控件已移至 设置 → 硬件.

支持页面。默认的运行状况检查选项卡为每个探测项显示一行,标注 PASS / INFO / WARN / FAIL 状态,并在有可用修复时显示上下文操作按钮。 支持页面。默认的运行状况检查选项卡为每个探测项显示一行,标注 PASS / INFO / WARN / FAIL 状态,并在有可用修复时显示上下文操作按钮。
图 1。 支持页面。默认的运行状况检查选项卡为每个探测项显示一行,标注 PASS / INFO / WARN / FAIL 状态,并在有可用修复时显示上下文操作按钮。

标签条

支持页面打开时位于 资源 选项卡 — 文档 + 手动链接 + 欢迎游览重播作为友好的首次登陆。其他两个选项卡只需点击一下即可:

  • 资源 (首先打开)- 链接到此处托管的文档和手册,以及欢迎游览重播和出版商/法律页面。
  • 健康检查 — 日常排查界面(设备、Linux 上的 udev 规则、模拟器可达性、运行时状态)。点击 运行检查 进行探测。
  • 诊断 — 运行时指标、可搜索事件日志和一键支持包导出。单独记录在 诊断标签页 页面。

硬件兼容性(带反转 + 俯仰/滚转互换的轴测试、效果渲染、Windows 设备后端、设备选择器,以及 测试硬件效果 探针)不再是支持选项卡 — 它存在于 设置 → 硬件.

运行状况检查选项卡

健康检查是大多数测试人员在出现问题时所需的路径。点击 运行检查 探测桥接状态。行独立更新,因此缓慢的 sim 探针不会阻止设备或运行时结果的显示。

  • 通过 表示 FFB-Bridge 已验证设置的该部分。
  • 信息 表示没有任何问题,但该行有有用的上下文。例如,当您正在飞 MSFS 或使用模拟模式时,X-Plane 未在侦听是预期内的。
  • 警告 意味着设置可以继续,但有一些值得修复或报告的地方。
  • 失败 表示网桥发现了一个阻塞性问题。当运行状况检查知道有安全的修复方法时,该行会提供一个操作按钮。
  • 就绪检查 是运行前和运行期间使用的中性状态。

硬件控件已移至“设置”

硬件兼容性控件以前是「支持」选项卡的一部分。它们现在位于 设置 → 硬件:直播 轴测试 (与 反转轴极性交换俯仰/滚转轴), 效果渲染 单选项(硬件效果 vs 软件兼容模式)、Windows 设备后端、用于多个已连接摇杆的设备选择器、实验性的未列出设备选择启用,以及 测试硬件效果 探针。请参阅 设置页面 查看完整演练。

设置 → 硬件 — 轴测试(反转 + 俯仰/滚转互换)、效果渲染、Windows 设备后端,以及测试硬件效果探针。 设置 → 硬件 — 轴测试(反转 + 俯仰/滚转互换)、效果渲染、Windows 设备后端,以及测试硬件效果探针。
图 2。 设置 → 硬件 — 轴测试(反转 + 俯仰/滚转互换)、效果渲染、Windows 设备后端,以及测试硬件效果探针。

如何安排支票

每个支票行都有四个部分:

  • 状态 — PASS(绿色)、INFO(蓝色)、WARN(琥珀色)、FAIL(红色)、READY / CHECKING(中性),或在该行不适用于此平台时显示 N/A。
  • 标题 — 正在检查什么。
  • 详情 ——对所发现内容的一行摘要。悬停(或在触摸屏上点按)即可查看完整详情。
  • 动作按钮 - 仅当有可操作的事情时才出现。示例: 安装 udev 规则, 使用端口:5111, 修复....

支票

设备

确认受支持的力反馈摇杆对操作系统可见,并且桥接器可以独占地打开它。如果不存在受支持的 VID/PID,或者另一个进程正在持有该句柄,则失败。

Linux udev 规则

检查是否 /etc/udev/rules.d/99-ffb-bridge.rules 存在并且与规范内容匹配。当不存在时,动作是 安装 udev 规则 — 这会触发 pkexec 提示将文件写入特权位置。

NixOS 异常

健康检查检测 NixOS(通过查找 /etc/NIXOS)并将 udev-rule 行替换为将规则添加到的指令 configuration.nix 而是 。看 安装 对于片段。

WindowsLinux SimConnect 配置

SimConnect 是 MSFS 的连接路径,因此此检查会在 Windows 和 Linux 上运行。它会查找 MSFS 的 SimConnect.xml 在平台适当的位置,解析它,并将任何启用的 IPv4 条目与网桥正在使用的端口进行比较。三种可能的结果:

  • 找到匹配的条目。 绿色——无事可做。
  • 在不同端口上的条目。 琥珀色 — 提供 使用端口:X 按钮采用该端口。
  • 没有可用的条目(或文件无法解析)。 红色 — 提供 修复... 打开安装对话框的按钮(见下文)。
Linux 使用非特权端口

MSFS 在端口 500 上提供其库存 SimConnect 条目。在 Windows 上绑定良好并且网桥使用它。在 Linux 上的 Proton 下,用户命名空间进程无法绑定低于 1024 的端口,因此网桥会在 MSFS-in-Proton 实际可以绑定的非特权端口(默认为 5111)上安装并使用并行条目 - 这就是 Linux 修复和 使用端口 操作点位于较高端口。

SimConnect 可达性

探测配置的 TCP 端口。发送真实的 SimConnect OPEN 数据包并检查响应标头,以便能够区分 MSFS 正在监听 来自 有其他东西在听.

X-Plane可达性

X-Plane 路径适用于所有平台 - 在 macOS (Apple Silicon) 上,X-Plane 12 与 SideWinder FFB2 是受支持的组合。此检查会发送一个微小的 RREF 探针到 127.0.0.1:49000 并短暂等待 dataref 响应。映射超时和 Winsock 的 WSAECONNRESET (在发送 ICMP 端口不可达时收到)到“未运行”。

运行时

检查控制环路是否在目标 50 Hz 运行。如果最近 60 秒的平均值低于 45 Hz,则发出警告。

崩溃日志

如果有上次会话的崩溃日志,该行将变为琥珀色并提供 显示 在文件管理器中跳转到它,并且 通过反馈表单发送 它预先填充反馈提交并附加日志。

修复对话框

修复... 按钮不会直接应用更改——它们会打开一个对话框,准确显示将要更改的内容、更改位置以及(在 Linux 上)身份验证提示将要求您批准的内容。

修复 SimConnect 配置安装对话框。将显示要添加的确切 XML 片段以及结果文件的预览。 修复 SimConnect 配置安装对话框。将显示要添加的确切 XML 片段以及结果文件的预览。
图 3。 修复 SimConnect 配置安装对话框。将显示要添加的确切 XML 片段以及结果文件的预览。

对话框总是 添加剂:现有条目永远不会被覆盖。如果目标文件不可解析,该对话框会说明将首先进行带时间戳的备份。取消始终是安全的选择。

Linux pkexec 行为

写入系统路径的操作(udev 规则、以下任何内容) /etc) 路线经过 pkexec。您将看到您的发行版的正常 polkit 提示符 - 与弹出的相同提示符 gparted 或包管理器 GUI。退出代码 健康检查解释:

退出含义健康检查报告
0成功绿色支票;行重新评估。
126用户关闭了身份验证提示Amber 显示「已取消」——准备好后请重试。
127无 polkit 代理/身份验证失败红色“身份验证失败。”
提示

在最小的环境(无头 Linux、没有 polkit 代理的 sway)中运行桥接器是没问题的——你只是不能使用支持页面的特权修复。手动安装所需的文件或在启动网桥之前启动 polkit 代理。

当每张支票都呈绿色时

该应用程序应该可以正常工作。如果不行,请切换到 诊断标签页 — 其事件日志将显示比运行状况检查的一行状态更多的详细信息。或者跳转到 故障排除 了解常见症状和修复方法。