安裝 FFB-Bridge

FFB-Bridge 以獨立的 Windows 安裝程式、Linux AppImage 和 macOS DMG (Apple Silicon) 形式提供。三者都捆綁了 .NET 10 執行時。在現代 Windows、Linux 或 macOS 上，受支援的 USB 力回饋搖桿無需下載任何驅動程式。

開始之前

你需要：

受支援的硬體包括 MOZA AB6, AB9, AY90, AY210；Microsoft SideWinder Force Feedback 2；Logitech G940、Force 3D Pro 和 WingMan Force 3D；受支援的 Brunner DirectX 裝置；以及部分 SideWinder Force Feedback Pro 介面卡。功能與實機測試證據因確切型號和平台而異。認定某項功能已驗證前，請先檢視硬體指南。符合條件但未列出的搖桿需要主動啟用實驗性支援。硬體頁面.
受支援的模擬器：Microsoft Flight Simulator 2024、Microsoft Flight Simulator 2020、X-Plane 11 或 X-Plane 12。 在 macOS 上，僅支援 X-Plane — MSFS 僅在 Windows 和 Linux 上連線。
其中之一：
- Windows 11.
- 任何具有以下功能的現代 Linux 發行版 evdev ——這基本上涵蓋了所有主流桌面發行版。
- 使用 Apple Silicon（M1 或更新晶片）的 macOS，配合 X-Plane 和受支援的裝置。不支援 Intel Mac。各型號的測試證據與限制請參閱硬體指南。

自動更新

Windows 和打包的 Linux AppImage 安裝可以在您批准後下載、驗證、安裝和重新啟動。 macOS 自動檢查並開啟已簽名的下載。

Windows 安裝程式

下載

當您註冊後主頁，我們會透過電子郵件向您傳送標記化的下載連結。單擊 Windows 安裝程式連結進行儲存 ffb-bridge-setup-1.6.6-x64.exe (74 MB)

執行安裝程式

Windows 安裝程式會檢查 Free 或 Pro 是否正在執行。關閉正在執行的版本（包括系統系統匣中的例項），然後重試。安裝程式不會代您關閉應用或中斷力輸出。

雙擊安裝程式。您將看到 Inno Setup 嚮導，對於全新簽名的版本，Windows 還可能顯示 SmartScreen 信譽提示：

釋出者檢查。 Windows 安裝程式由 Rohsam 釋出者身份進行程式碼簽名。在繼續之前，請確認 Windows 顯示 Rohsam Inc. 或 Rohsam Inc 作為釋出者。
SmartScreen 信譽提示。 新簽名的版本可能仍會被標記為無法識別，直到該確切檔案獲得下載歷史記錄。如果來源是 ffb-bridge.com，雜湊相符，釋出者為Rohsam，點選 更多資訊，那麼 仍然執行.
安裝程式語言。 安裝程式會首先詢問語言，並預先選中您的 Windows 顯示語言。安裝程式的每個介面都提供全部十六種應用介面語言，包括加拿大法語。許可協議和第三方宣告保留原始語言。
Inno Setup 設定嚮導。 點選 下一頁 透過兩頁。預設安裝位置是 %LOCALAPPDATA%\Programs\ffb-bridge — 按使用者安裝，無需管理員許可權。

Windows 11 智慧應用程式控制和新簽名版本

如果您使用的是 Windows 11 智慧應用程式控制 (SAC) 在主動模式下啟用時，在信譽積累期間，Windows 仍可能阻止全新的已簽名版本。程式碼簽名可證明 Rohsam 釋出者身份；但它不保證每個新檔案雜湊在第一天就擁有 SmartScreen 或 SAC 信譽。

Microsoft 自己的指南涵蓋了智慧應用程式控制行為以及在何處檢視其設定（設定 → 隱私和安全 → Windows 安全 → 應用程式和瀏覽器控制 → 智慧應用程式控制設定):

Microsoft：智慧應用程式控制常見問題解答

如果 SAC 在您的機器上直接阻止新版本，請等待該版本積累信譽，或改用其他 Windows 裝置，在那裡您可以驗證 Rohsam 簽名並做出明智的選擇。

啟動中

一個名為下列名稱的「開始」選單快捷方式 FFB-Bridge 登陸 FFB-Bridge 程式組。您也可以直接從 %LOCALAPPDATA%\Programs\ffb-bridge\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.6.6-x86_64.AppImage.

使其可執行並安裝

AppImage 需要先設定可執行位，Linux 才會執行它們。設定之後，FFB-Bridge 的 AppImage 可以將自身安裝到您使用者範圍的 XDG 桌面目錄中：

chmod +x 'FfbBridge-1.6.6-x86_64.AppImage' && ./'FfbBridge-1.6.6-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 通道以及 Logitech G940 和 Brunner 基座使用的 hidraw 介面的許可權。「支援 → 執行檢查」會顯示受支援裝置的標準規則，並可透過 polkit 提示安裝。如果符合條件的未列出操縱桿已明確啟用並連線，其輸入行會在安裝時追加。

# /etc/udev/rules.d/71-ffb-bridge.rules
SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
SUBSYSTEM=="hidraw", 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}=="cafe", ATTRS{idProduct}=="4004", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="204e", 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}=="346e", ATTRS{idProduct}=="1003", TAG+="uaccess"
SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1003", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="00d2", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="0120", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="0121", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="00ca", TAG+="uaccess"
# Brunner CAN-over-HID vendor interface (USB interface 1), any grip and USB mode.
SUBSYSTEM=="hidraw", KERNEL=="hidraw*", ATTRS{modalias}=="usb:v25BBp*in01", TAG+="uaccess"
# G940 signed 10-bit stick axes; preserve other calibration fields.
ACTION!="remove", SUBSYSTEM=="input", KERNEL=="event*", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", ENV{EVDEV_ABS_00}="-512:511", ENV{EVDEV_ABS_01}="-512:511", RUN{builtin}+="keyboard"

現有規則也可能已經過時

當較舊的規則缺少目前裝置許可權（例如 MOZA TTY 線路，或 Logitech G940 和 Brunner 基座使用的 hidraw 訪問許可權），或其檔名導致它執行得太晚、無法用於桌面工作階段訪問（如以前的 99-ffb-bridge.rules）時，會被報告為「警告」。即使檔案已存在，也請使用「修復…」；應用會將完整生成的規則安裝為 71-ffb-bridge.rules，並刪除以前的檔案。

修復成功後，規則已生效，應用會建議重啟。「立即重啟」會用新許可權重新開啟操縱桿並結束啟動時的備用路徑；如果需要先繼續使用，選擇「稍後重啟」也是安全的。

Figure 2. Linux 修復對話方塊會在請求許可權之前顯示受支援裝置的標準輸入與 MOZA TTY 規則。已連線且明確啟用的未列出操縱桿會在安裝時追加。

尼克斯作業系統

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=="hidraw", 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}=="cafe", ATTRS{idProduct}=="4004", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="204e", 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}=="346e", ATTRS{idProduct}=="1003", TAG+="uaccess"
  SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1003", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
  SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="00d2", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="0120", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="0121", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="00ca", TAG+="uaccess"
  # Brunner CAN-over-HID vendor interface (USB interface 1), any grip and USB mode.
  SUBSYSTEM=="hidraw", KERNEL=="hidraw*", ATTRS{modalias}=="usb:v25BBp*in01", TAG+="uaccess"
  # G940 signed 10-bit stick axes; preserve other calibration fields.
  ACTION!="remove", SUBSYSTEM=="input", KERNEL=="event*", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", ENV{EVDEV_ABS_00}="-512:511", ENV{EVDEV_ABS_01}="-512:511", RUN{builtin}+="keyboard"
'';

然後 sudo nixos-rebuild switch 並重新插上搖桿。

解除安裝

執行已安裝的 AppImage --uninstall 刪除啟動器和圖示，然後刪除 AppImage ~/Applications 如果您不再需要它。位於以下路徑下的設定檔和偏好設定 ~/.config/ffb-bridge 保留供以後重新安裝。

macOS DMG（蘋果晶片）

macOS 版本連線 X-Plane，運行於 Apple Silicon（M1 或更新版本） 並連線到 X-Plane 12 ，配合受支援的力回饋硬體使用。確切裝置與功能範圍請參閱硬體指南。它以經過簽名和公證的格式提供： .dmg，因此 Gatekeeper 接受它，而無需右鍵單擊「開啟」解決方法。

下載並安裝

使用與其他平台相同的註冊流程 - 單擊電子郵件中的 macOS 連結下載版本化的 DMG，例如 FfbBridge-1.6.6-arm64.dmg。然後：

雙擊 DMG 以安裝它。將開啟一個視窗，顯示 FFB-Bridge 應用程式和 應用程式 快捷方式。
拖動 FFB-Bridge 到 應用程式 安裝快捷方式。
彈出 DMG，然後從 Launchpad 或應用程式資料夾啟動 FFB-Bridge。

由於該版本已透過 Rohsam Inc. 開發者 ID 進行公證，因此 macOS 會在首次透過網路啟動時對其進行驗證並正常開啟。如果您的 Mac 首次啟動時處於離線狀態，請連線到網際網路，以便 Gatekeeper 可以完成檢查。

解除安裝

拖動 FFB-Bridge 來自 應用程式 到垃圾桶。下列位置中的設定檔和偏好設定 ~/.config/ffb-bridge 保留在原處以便稍後重新安裝；手動刪除該資料夾以獲得乾淨的狀態。

驗證安裝

啟動 FFB-Bridge。完成安全確認和啟動檢查，再按照歡迎向導操作（下一節將介紹）。如果應用程式根本無法啟動，或者啟動時當機，請直接跳至故障排除.

Free 1.6.5 要求 Apple silicon Mac 執行 macOS 26 或更高版本。

Windows、Linux AppImage 和更新後的 macOS 應用會在安裝前驗證下載。確認更新並等待正常結束，設定和配置會保留。舊版 Mac 應用可能需要手動安裝已簽名的 DMG。

macOS 現在要求 Apple silicon 裝置執行 13 或更高版本。