安装 FFB-Bridge

FFB-Bridge 作为独立的 Windows 安装程序和 Linux AppImage 提供。两者都捆绑了 .NET 10 运行时。无需下载驱动程序；您的 SideWinder 力反馈 2 已经可以在任何现代 Windows 或 Linux 内核上以 HID 级别运行。

开始之前

你需要：

A Microsoft SideWinder Force Feedback 2 joystick (USB VID 045E, PID 001B）。该桥目前已硬编码到该特定棒上。
支持的模拟器：Microsoft Flight Simulator 2024、X-Plane 11 或 X-Plane 12。MSFS 2020 未经测试。不支持 DCS、Prepar3D 和早期的飞行模拟器。
Windows 10（版本 1809 或更高版本）或任何现代 Linux 发行版 evdev - 这基本上是每个主流桌面发行版。

窗户安装人员

下载

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

运行安装程序

双击安装程序。您会看到一两个提示：

SmartScreen“无法识别的应用程序”。 安装程序尚未进行代码签名 - 签名已在 1.0 路线图上。点击 更多信息，那么 无论如何都要跑.
Inno Setup 设置向导。 点击 下一页 通过两页。默认安装位置是 %LOCALAPPDATA%\Programs\FfbBridge — 按用户安装，无需管理员权限。

视窗11 智能应用程序控制完全阻止未签名的应用程序

如果您使用的是 Windows 11 智能应用程序控制 (SAC) 在活动模式下启用，安装程序根本不会启动 — 没有 SmartScreen 提示，没有“仍然运行”选项，什么也没有发生。 SAC 拒绝任何没有可信代码签名签名的应用程序，并且 Beta 版本尚未签名。

今天解决这个问题的唯一方法是关闭智能应用程序控制足够长的时间来安装。微软自己的指南涵盖了流程（包括如何通过 设置 → 隐私和安全 → Windows 安全 → 应用程序和浏览器控制 → 智能应用程序控制设置):

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

与早期 Windows 11 相比的好消息： 最近的累积更新允许您在安装完成后从 Windows 安全应用程序重新启用 SAC - Microsoft 过去要求完全重新安装 Windows，但该限制已消失。 SAC恢复后，FFB-Bridge应用程序本身将继续正常运行； SAC 仅在启动时检查以前未见过的应用程序。

代码签名安装程序位于 1.0 路线图上，并将完全删除此步骤。

启动中

名为“开始”菜单的快捷方式 FFB-Bridge 登陆 FFB-Bridge 程序组。您也可以直接从 %LOCALAPPDATA%\Programs\FfbBridge\FfbBridge.Desktop.exe.

注意——防病毒软件

一些防病毒产品会标记未签名的二进制文件。如果您完全隔离安装程序（而不仅仅是警告），请将标记的示例通过电子邮件发送至 feedback·ffb-bridge.com （将·替换为@）以便我们进行调查。

卸载

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

Linux 应用程序图像

下载

与 Windows 相同的注册流程 — 单击电子邮件中的 Linux 链接，您将获得 FfbBridge-x86_64.AppImage (about 40 MB).

使其可执行并安装

AppImages 需要设置可执行位，并且在大多数发行版上，需要在应用程序菜单中注册，以便桌面启动器能够拾取它们。所包含的 install.sh 脚本同时执行这两个操作；长形式是：

chmod +x FfbBridge-x86_64.AppImage
mkdir -p ~/Applications
mv FfbBridge-x86_64.AppImage ~/Applications/
~/Applications/FfbBridge-x86_64.AppImage --install

的 --install flag registers a .desktop 文件和图标放入您的 XDG 数据目录中。之后，一个 FFB-Bridge 条目与其他 GUI 应用程序一起显示在您的应用程序菜单中。

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

udev规则（推荐）

开箱即用，只有登录会话拥有操纵杆的用户才能打开其 /dev/input/eventN 节点。为了使网桥在快速用户切换后继续工作，或者只是为了避免某些发行版上出现 polkit 提示，医生页面提供以下 udev 规则的一键安装：

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

尼克斯操作系统

NixOS 从系统配置中读取 udev 规则，而不是 /etc/udev/rules.d。将等效项添加到您的 configuration.nix:

services.udev.extraRules = ''
  SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
'';

Then sudo nixos-rebuild switch 并重新插入棒。

卸载

Either delete ~/Applications/FfbBridge-x86_64.AppImage 并运行捆绑的卸载程序，或使用以下命令运行 AppImage --uninstall 标志自动反转菜单/图标注册。下的个人资料和偏好 ~/.config/ffb-bridge 保留供以后重新安装。

验证安装

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