安装 FFB-Bridge

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

开始之前

你需要：

一个 Force Feedback 摇杆。五个摇杆系列已完成验证，并在已测试环境中即插即用： Microsoft SideWinder Force Feedback 2 (045E:001B), MOZA AB9 + MH16 (346E:1000 / 346E:1002, Windows, Linux, and macOS), Logitech Flight System G940 (046D:C287), Logitech Force 3D Pro (046D:C286), 和 Logitech WingMan Force 3D (046D:C283). 其他 Force Feedback 摇杆可以通过以下方式实验性启用： 设置 → 硬件 → “允许未列出的设备”；力反馈方向盘、游戏手柄和单轴设备不在范围内，会被指向 FFB Probe 而是。请参阅硬件页面了解完整的兼容性情况。
受支持的模拟器：Microsoft Flight Simulator 2024、Microsoft Flight Simulator 2020、X-Plane 11 或 X-Plane 12。不支持 DCS、Prepar3D 和更早的飞行模拟器。 在 macOS 上，仅支持 X-Plane — MSFS 仅在 Windows 和 Linux 上连接。
其中之一：
- Windows 10（版本 1809 或更高版本）或 Windows 11。
- 任何具有以下功能的现代 Linux 发行版 evdev ——这基本上涵盖了所有主流桌面发行版。
- Apple Silicon（M1 或更新）上的 macOS。macOS 构建范围限定为使用 SideWinder Force Feedback 2 和 MOZA AB9 + MH16 的 X-Plane 12；不支持 Intel Mac。

Windows 安装程序

下载

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

运行安装程序

双击安装程序。您将看到 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 （将·替换为@）以便我们进行调查。

卸载

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

Linux AppImage

下载

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

使其可执行并安装

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

chmod +x FfbBridge-1.0.0-x86_64.AppImage
./FfbBridge-1.0.0-x86_64.AppImage --install

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

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

udev规则（推荐）

开箱即用时，只有其登录会话拥有该摇杆的用户才能打开它的 /dev/input/eventN 节点。为了使网桥在快速用户切换后继续工作，或者只是为了避免某些发行版上出现 polkit 提示， 支持页面 （在侧栏中）为每个受支持的 USB 摇杆提供以下 udev 规则的一键安装：

# /etc/udev/rules.d/99-ffb-bridge.rules
SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c286", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c283", TAG+="uaccess"

尼克斯操作系统

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}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c286", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c283", TAG+="uaccess"
'';

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

卸载

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

macOS DMG（苹果芯片）

macOS 版本是新的并且有范围：它运行在 Apple Silicon（M1 或更新版本） 并连接到 X-Plane 12 with the Microsoft SideWinder Force Feedback 2 and MOZA AB9 + MH16. It ships as a signed and notarized .dmg，因此 Gatekeeper 接受它，而无需右键单击“打开”解决方法。

下载并安装

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

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

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

卸载

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

验证安装

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