安装 FFB-Bridge

FFB-Bridge 以独立的 Windows 安装程序、Linux AppImage 和 macOS DMG (Apple Silicon) 形式提供。三者都捆绑了 .NET 10 运行时。在现代 Windows、Linux 或 macOS 上，受支持的 USB 力反馈摇杆无需下载任何驱动程序。

开始之前

你需要：

已在 Windows、Linux 和 macOS 上完成验证：MOZA AB6、AB9 和 AY210、Microsoft SideWinder Force Feedback 2、Logitech G940、Force 3D Pro 和 WingMan Force 3D，以及 Brunner FFB-G。符合条件的未列出操纵杆仍可作为安全的实验性选择启用。硬件页面.
受支持的模拟器：Microsoft Flight Simulator 2024、Microsoft Flight Simulator 2020、X-Plane 11 或 X-Plane 12。不支持 DCS、Prepar3D 和更早的飞行模拟器。 在 macOS 上，仅支持 X-Plane — MSFS 仅在 Windows 和 Linux 上连接。
其中之一：
- Windows 11.
- 任何具有以下功能的现代 Linux 发行版 evdev ——这基本上涵盖了所有主流桌面发行版。
- 适用于 Apple Silicon（M1 或更新型号）的 macOS。macOS 构建仅支持 X-Plane 12，以及 SideWinder Force Feedback 2 和受支持的 MOZA AB6、AB9、AY210 设备；不支持 Intel Mac。

自动更新

Windows 和打包的 Linux AppImage 安装可以在您批准后下载、验证、安装和重新启动。 macOS 自动检查并打开已签名的下载。

Windows 安装程序

下载

当您注册后主页，我们会通过电子邮件向您发送标记化的下载链接。单击 Windows 安装程序链接进行保存 ffb-bridge-setup-1.4.0-x64.exe .

运行安装程序

双击安装程序。您将看到 Inno Setup 向导，对于全新签名的版本，Windows 还可能显示 SmartScreen 信誉提示：

发布者检查。 Windows 安装程序由 Rohsam 发布者身份进行代码签名。在继续之前，请确认 Windows 显示 Rohsam Inc. 或 Rohsam Inc 作为发布者。
SmartScreen 信誉提示。 新签名的版本可能仍会被标记为无法识别，直到该确切文件获得下载历史记录。如果来源是 ffb-bridge.com，哈希匹配，发布者为Rohsam，点击 更多信息，那么 仍然运行.
Inno Setup 设置向导。 点击 下一页 通过两页。默认安装位置是 %LOCALAPPDATA%\Programs\FfbBridge — 按用户安装，无需管理员权限。

Windows 11 智能应用程序控制和新签名版本

如果您使用的是 Windows 11 智能应用程序控制 (SAC) 在主动模式下启用时，在信誉积累期间，Windows 仍可能阻止全新的已签名版本。代码签名可证明 Rohsam 发布者身份；但它不保证每个新文件哈希在第一天就拥有 SmartScreen 或 SAC 信誉。

Microsoft 自己的指南涵盖了智能应用程序控制行为以及在何处查看其设置（设置 → 隐私和安全 → Windows 安全 → 应用程序和浏览器控制 → 智能应用程序控制设置):

Microsoft：智能应用程序控制常见问题解答

如果 SAC 在您的机器上直接阻止新版本，请等待该版本积累信誉，或改用其他 Windows 设备，在那里您可以验证 Rohsam 签名并做出明智的选择。

启动中

一个名为下列名称的「开始」菜单快捷方式 FFB-Bridge 登陆 FFB-Bridge 程序组。您也可以直接从 %LOCALAPPDATA%\Programs\FfbBridge\FfbBridge.Desktop.exe.

注意——防病毒软件

某些防病毒产品会标记新的或信誉不佳的二进制文件。如果您完全隔离安装程序（而不仅仅是警告），请将标记的示例通过电子邮件发送至 support·ffb-bridge.com (replace the · with an @) so we can investigate.

卸载

打开 应用程序和功能 在 Windows 设置中，搜索 FFB-Bridge，并选择卸载。您的个人资料和偏好如下 %APPDATA%\ffb-bridge 留在原处，以便重新安装可以再次拾取它们；如果您想要一个干净的状态，请手动删除该文件夹。

Linux AppImage

下载

与 Windows 相同的注册流程 — 单击电子邮件中的 Linux 链接，您将获得版本化的 AppImage，例如 FfbBridge-1.4.0-x86_64.AppImage.

使其可执行并安装

AppImage 需要先设置可执行位，Linux 才会运行它们。设置之后，FFB-Bridge 的 AppImage 可以将自身安装到您用户范围的 XDG 桌面目录中：

chmod +x FfbBridge-1.4.0-x86_64.AppImage && ./FfbBridge-1.4.0-x86_64.AppImage --install

的 --install 标志将 AppImage 复制到 ~/Applications，写了一个 .desktop 启动器，安装捆绑的图标，并在这些帮助工具可用时刷新桌面缓存。之后，一个 FFB-Bridge 条目应与其他 GUI 应用程序一起出现在您的应用程序菜单中。

安装后 KDE Plasma 应用程序启动器中的 FFB-Bridge 条目 — Figure 1. KDE Plasma 上安装的菜单项。 GNOME、Xfce 和其他 XDG 兼容环境在 AppImage --install 步骤后选择它。

udev规则（推荐）

Linux 需要所选 /dev/input/event* 节点的权限，还需要受支持 MOZA 设备使用的固件策略 TTY 通道权限。Support → Health checks 会显示受支持设备的标准规则，并可通过 polkit 提示安装。如果符合条件的未列出操纵杆已明确启用并连接，其输入行会在安装时追加。

# /etc/udev/rules.d/99-ffb-bridge.rules
SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c2a8", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c286", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c283", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess"
SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess"
SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1001", TAG+="uaccess"
SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1001", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="00d2", TAG+="uaccess"

现有规则也可能已经过时

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

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

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

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

尼克斯操作系统

NixOS 从系统配置中读取 udev 规则。它忽略直接放置在 /etc/udev/rules.d。将等效项添加到您的 configuration.nix:

services.udev.extraRules = ''
  SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c2a8", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c286", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c283", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess"
  SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess"
  SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1001", TAG+="uaccess"
  SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1001", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
  SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="00d2", TAG+="uaccess"
'';

然后 sudo nixos-rebuild switch 并重新插上摇杆。

卸载

运行已安装的 AppImage --uninstall 删除启动器和图标，然后删除 AppImage ~/Applications 如果您不再需要它。位于以下路径下的配置文件和偏好设置 ~/.config/ffb-bridge 保留供以后重新安装。

macOS DMG（苹果芯片）

macOS 构建仅支持 X-Plane 12。它运行于 Apple Silicon（M1 或更新版本） 并连接到 X-Plane 12 Microsoft SideWinder Force Feedback 2 和受支持的 MOZA AB6、AB9、AY210 设备。它以经过签名和公证的 .dmg，因此 Gatekeeper 接受它，而无需右键单击“打开”解决方法。

下载并安装

使用与其他平台相同的注册流程 - 单击电子邮件中的 macOS 链接下载版本化的 DMG，例如 FfbBridge-1.4.0-arm64.dmg。然后：

双击 DMG 以安装它。将打开一个窗口，显示 FFB-Bridge 应用程序和 应用程序 快捷方式。
拖动 FFB-Bridge 到 应用程序 安装快捷方式。
弹出 DMG，然后从 Launchpad 或应用程序文件夹启动 FFB-Bridge。

由于该版本已通过 Rohsam Inc. 开发者 ID 进行公证，因此 macOS 会在首次通过网络启动时对其进行验证并正常打开。如果您的 Mac 首次启动时处于离线状态，请连接到互联网，以便 Gatekeeper 可以完成检查。

卸载

拖动 FFB-Bridge 来自 应用程序 到回收站。下列位置中的配置文件和偏好设置 ~/.config/ffb-bridge 保留在原处以便稍后重新安装；手动删除该文件夹以获得干净的状态。

验证安装

启动 FFB-Bridge。您应该看到的第一件事是欢迎对话框（下一节将介绍）。如果应用程序根本无法启动，或者启动时崩溃，请直接跳至故障排除.