支持页面

支持页面是文档、运行状况检查、诊断、日志和支持包导出的单一主页。物理设备配置现在位于硬件下。

标签条

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

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

设备选择、方向校准、验证渲染、强度限制和控制分配硬件.

运行状况检查选项卡

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

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

自动设备启动预检

启动时，FFB-Bridge 会静默检查 Windows、Linux 和 macOS 上的设备后端。Linux 还会检查对受支持事件节点的读写权限，以及已安装的 udev 规则是否涵盖当前所有设备权限。出现 WARN 或 FAIL 时，会显示非阻塞的“检查并修复”横幅并列出每个问题。

如果所有检查均通过，不会打开任何窗口。
启动时不会探测模拟器或网络；模拟器未运行属于正常情况，会在运行阶段处理。
对话框打开期间，Auto-arm 会等待。可以检查并修复问题；如果设备是有意断开的，也可以关闭对话框。关闭后，只有其他先决条件均通过，Auto-arm 才能继续。

Figure 2. Support → Health 会显示受支持 event node 的 PASS、过期 udev 规则及 Fix 的 WARN，以及物理设备的 FAIL。

硬件

以前的支持页面硬件控件现在有一个专用区域。使用 Flight Check 进行隔离效应测试，并使用硬件进行持久物理设备设置。打开硬件指南.

Figure 3. Hardware → Calibration — 验证俯仰和滚转方向、力的极性，以及任何必要的轴交换。

如何安排支票

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

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

支票

设备

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

Linux udev 规则

Health checks 会验证 /etc/udev/rules.d/99-ffb-bridge.rules 是否包含当前所有受支持设备的输入行和 MOZA TTY 权限。Fix 会显示维护的标准规则，通过 pkexec 安装，重新加载 udev，并触发输入和 TTY 设备。已连接且明确启用的未列出操纵杆会在安装时追加。

只包含事件权限的旧规则会报告为 WARN，因为缺少当前 MOZA TTY 权限。即使文件已经存在，也请使用 Fix；应用会将其替换为完整生成的规则。

修复成功后，规则已生效，应用会建议重启。“立即重启”会用新权限重新打开操纵杆并退出启动时的备用路径；如果需要先继续使用，选择“稍后重启”也是安全的。

Figure 4. Linux 修复对话框会在请求权限之前显示受支持设备的标准输入与 MOZA TTY 规则。已连接且明确启用的未列出操纵杆会在安装时追加。

Figure 5. 修复成功后，规则已生效，应用会建议重启。“立即重启”会用新权限重新打开操纵杆并退出启动时的备用路径；如果需要先继续使用，选择“稍后重启”也是安全的。

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 上）身份验证提示将要求您批准的内容。

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

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

Linux pkexec 行为

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

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

提示

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

当每张支票都呈绿色时

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