Dokumentation zur aktuellen Version FFB-Bridge 1.4.0 Etwas Veraltetes gefunden? Melde es über das Feedback-Formular.

FFB-Bridge installieren

FFB-Bridge wird als eigenständiges Windows-Installationsprogramm, als Linux-AppImage und als macOS-DMG (Apple Silicon) ausgeliefert. Alle drei bündeln die .NET-10-Laufzeitumgebung. Für unterstützte USB-Force-Feedback-Joysticks unter modernen Windows-, Linux- oder macOS-Systemen gibt es keinen Treiber zum Herunterladen.

Bevor Sie beginnen

Sie benötigen:

  • Unter Windows, Linux und macOS validiert: MOZA AB6, AB9 und AY210, Microsoft SideWinder Force Feedback 2, Logitech G940, Force 3D Pro und WingMan Force 3D sowie Brunner FFB-G. Geeignete nicht gelistete Joysticks bleiben eine sichere experimentelle Opt-in-Funktion. Hardware-Seite.
  • Ein unterstützter Simulator: Microsoft Flight Simulator 2024, Microsoft Flight Simulator 2020, X-Plane 11 oder X-Plane 12. DCS, Prepar3D und frühere Flugsimulatoren werden nicht unterstützt. Unter macOS wird nur X-Plane unterstützt – MSFS stellt nur unter Windows und Linux eine Verbindung her.
  • Einer von:
    • Windows 10 (Version 1809 oder neuer) oder Windows 11.
    • Jede moderne Linux-Distribution mit evdev – das ist im Wesentlichen jede Mainstream-Desktop-Distribution.
    • macOS auf Apple Silicon (M1 oder neuer). Der macOS-Build ist auf X-Plane 12 mit dem SideWinder Force Feedback 2 und den unterstützten MOZA-Basen AB6, AB9 und AY210 beschränkt; Intel-Macs werden nicht unterstützt.
Automatische Updates

Windows- und gepackte Linux AppImage-Installationen können nach Ihrer Genehmigung heruntergeladen, überprüft, installiert und neu gestartet werden. macOS prüft automatisch und öffnet den signierten Download.

Windows Installationsprogramm

Download

Nachdem Sie sich angemeldet haben Homepage, senden wir Ihnen per E-Mail einen tokenisierten Download-Link. Klicken Sie zum Speichern auf den Link zum Windows-Installationsprogramm ffb-bridge-setup-1.4.0-x64.exe (ca. 34 MB).

Führen Sie das Installationsprogramm aus

Doppelklicken Sie auf das Installationsprogramm. Sie sehen den Inno-Setup-Assistenten und Windows zeigt möglicherweise auch eine SmartScreen-Reputationsaufforderung bei brandneuen signierten Builds an:

  1. Herausgeberprüfung. Das Windows-Installationsprogramm ist mit der Herausgeberidentität Rohsam codesigniert. Bevor Sie fortfahren, überprüfen Sie, ob Windows angezeigt wird Rohsam Inc. oder RohsamInc als Herausgeber.
  2. SmartScreen-Reputationsaufforderung. Neue signierte Builds werden möglicherweise immer noch als nicht erkannt markiert, bis genau diese Datei in den Download-Verlauf gelangt. Wenn die Quelle ist FFB-Bridge.com, der Hash stimmt überein und der Herausgeber ist Rohsam, klicken Sie Weitere Informationen, dann Lauf trotzdem.
  3. Inno Setup-Setup-Assistent. Klicken Sie Als nächstes durch die beiden Seiten. Der Standardinstallationsort ist %LOCALAPPDATA%\Programs\FfbBridge – eine Installation pro Benutzer, keine Administratorberechtigung erforderlich.
Windows 11 Smart App Control und neue signierte Builds

Wenn Sie Windows 11 mit verwenden Intelligente App-Steuerung (SAC) im aktiven Modus aktiviert, blockiert Windows möglicherweise immer noch einen brandneuen signierten Build, während die Reputation aufholt. Die Code-Signierung beweist die Identität des Herausgebers Rohsam; sie garantiert nicht, dass jeder neue Datei-Hash vom ersten Tag an über eine SmartScreen- oder SAC-Reputation verfügt.

Die eigenen Leitlinien von Microsoft behandeln das Verhalten von Smart App Control und zeigen, wo die Einstellungen überprüft werden können (Einstellungen → Datenschutz und Sicherheit → Windows-Sicherheit → App- und Browsersteuerung → Smart App Control-Einstellungen):

Microsoft: Häufig gestellte Fragen zu Smart App Control

Wenn SAC einen neuen Build auf Ihrem Computer vollständig blockiert, warten Sie, bis der Build Reputation aufgebaut hat, oder verwenden Sie ein anderes Windows-Gerät, auf dem Sie die Rohsam-Signatur überprüfen und eine fundierte Entscheidung treffen können.

Start

Eine Startmenü-Verknüpfung mit dem Namen FFB-Bridge landet in der Programmgruppe FFB-Bridge. Sie können auch direkt von starten %LOCALAPPDATA%\Programs\FfbBridge\FfbBridge.Desktop.exe.

Achtung – Antivirus

Einige Antivirenprodukte kennzeichnen neue oder minderwertige Binärdateien. Wenn Ihr Installer das Installationsprogramm komplett unter Quarantäne stellt (und nicht nur eine Warnung), senden Sie das markierte Beispiel bitte per E-Mail an support·ffb-bridge.com (replace the · with an @) so we can investigate.

Deinstallation

Offen Apps und Funktionen Suchen Sie in den Windows-Einstellungen nach FFB-Bridge, und wählen Sie Deinstallieren. Ihre Profile und Präferenzen unten %APPDATA%\ffb-bridge bleiben an Ort und Stelle, sodass sie bei einer Neuinstallation wieder aktiviert werden; entfernen Sie diesen Ordner manuell, wenn Sie einen sauberen Neustart wünschen.

Linux AppImage

Download

Gleicher Anmeldevorgang wie bei Windows – klicken Sie auf den Linux-Link in der E-Mail und Sie erhalten ein versioniertes AppImage, z. B FfbBridge-1.4.0-x86_64.AppImage.

Machen Sie es ausführbar und installieren Sie es

Für AppImages muss das ausführbare Bit gesetzt sein, bevor Linux sie ausführen kann. Danach kann sich AppImage von FFB-Bridge selbst in Ihren benutzerbezogenen XDG-Desktopverzeichnissen installieren:

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

Die --install Flag kopiert das AppImage nach ~/Applications, schreibt eine .desktop Launcher, installiert das mitgelieferte Symbol und aktualisiert die Desktop-Caches, wenn diese Hilfstools verfügbar sind. Danach a FFB-Bridge Der Eintrag sollte in Ihrem Anwendungsmenü neben anderen GUI-Apps erscheinen.

FFB-Bridge-Eintrag im KDE Plasma-Anwendungsstarter nach der Installation
Figure 1. Der installierte Menüeintrag auf KDE Plasma. GNOME, Xfce und andere XDG-kompatible Umgebungen übernehmen es nach dem Schritt AppImage --install.

udev-Regel (empfohlen)

Linux benötigt Berechtigungen für den ausgewählten Knoten /dev/input/event* sowie für den Firmware-Richtlinienkanal über TTY, den unterstützte MOZA-Basen verwenden. Support → Health checks zeigt die kanonische Regel für unterstützte Geräte und kann sie nach einer polkit-Abfrage installieren. Wenn ein geeignetes nicht gelistetes Joystick-Gerät per Opt-in aktiviert und verbunden ist, wird seine Eingabezeile bei der Installation angefügt.

# /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"
Auch eine vorhandene Regel kann veraltet sein

Eine ältere, ausschließlich auf Event-Knoten ausgelegte Regel wird als WARN gemeldet, da ihr die aktuellen MOZA-TTY-Berechtigungen fehlen. Fix auch dann verwenden, wenn die Datei bereits vorhanden ist; die App ersetzt sie durch die vollständige erzeugte Regel.

Nach erfolgreicher Korrektur ist die Regel aktiv und die App empfiehlt einen Neustart. „Jetzt neu starten“ öffnet den Joystick mit den neuen Berechtigungen erneut und verwirft den Start-Fallback; „Später neu starten“ ist sicher, wenn Sie zunächst fortfahren müssen.

Der Linux-Korrekturdialog zeigt vor der Berechtigungsabfrage die kanonische Eingabe- und MOZA-TTY-Regel für unterstützte Geräte. Ein verbundenes, per Opt-in aktiviertes, nicht gelistetes Joystick-Gerät wird bei der Installation angefügt. Der Linux-Korrekturdialog zeigt vor der Berechtigungsabfrage die kanonische Eingabe- und MOZA-TTY-Regel für unterstützte Geräte. Ein verbundenes, per Opt-in aktiviertes, nicht gelistetes Joystick-Gerät wird bei der Installation angefügt.
Figure 2. Der Linux-Korrekturdialog zeigt vor der Berechtigungsabfrage die kanonische Eingabe- und MOZA-TTY-Regel für unterstützte Geräte. Ein verbundenes, per Opt-in aktiviertes, nicht gelistetes Joystick-Gerät wird bei der Installation angefügt.
Nach erfolgreicher Korrektur ist die Regel aktiv und die App empfiehlt einen Neustart. „Jetzt neu starten“ öffnet den Joystick mit den neuen Berechtigungen erneut und verwirft den Start-Fallback; „Später neu starten“ ist sicher, wenn Sie zunächst fortfahren müssen. Nach erfolgreicher Korrektur ist die Regel aktiv und die App empfiehlt einen Neustart. „Jetzt neu starten“ öffnet den Joystick mit den neuen Berechtigungen erneut und verwirft den Start-Fallback; „Später neu starten“ ist sicher, wenn Sie zunächst fortfahren müssen.
Figure 3. Nach erfolgreicher Korrektur ist die Regel aktiv und die App empfiehlt einen Neustart. „Jetzt neu starten“ öffnet den Joystick mit den neuen Berechtigungen erneut und verwirft den Start-Fallback; „Später neu starten“ ist sicher, wenn Sie zunächst fortfahren müssen.
NixOS

NixOS liest udev-Regeln aus der Systemkonfiguration. Es ignoriert direkt abgelegte Dateien /etc/udev/rules.d. Fügen Sie das Äquivalent zu Ihrem hinzu 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"
'';

Dann sudo nixos-rebuild switch und den Stick wieder einstecken.

Deinstallation

Führen Sie das installierte AppImage mit aus --uninstall Um den Launcher und die Symbole zu entfernen, löschen Sie dann das AppImage aus ~/Applications wenn Sie es nicht mehr wollen. Profile und Präferenzen unten ~/.config/ffb-bridge werden für eine spätere Neuinstallation aufbewahrt.

macOS DMG (Apple Silicon)

Der macOS-Build ist auf X-Plane 12 beschränkt. Er läuft auf Apple Silicon (M1 oder neuer) und verbindet sich mit X-Plane 12 mit dem Microsoft SideWinder Force Feedback 2 und den unterstützten MOZA-Basen AB6, AB9 und AY210. Er wird als signiertes und notarisiertes .dmg, sodass Gatekeeper es ohne die Problemumgehung „Öffnen“ mit der rechten Maustaste akzeptiert.

Herunterladen und installieren

Verwenden Sie den gleichen Anmeldevorgang wie bei den anderen Plattformen – klicken Sie auf den macOS-Link in der E-Mail, um eine versionierte DMG herunterzuladen, z. B FfbBridge-1.4.0-arm64.dmg. Dann:

  1. Doppelklicken Sie auf die DMG, um sie zu mounten. Es öffnet sich ein Fenster mit der Anzeige FFB-Bridge App und an Anwendungen Verknüpfung.
  2. Ziehen FFB-Bridge auf die Anwendungen Verknüpfung, um es zu installieren.
  3. Werfen Sie die DMG aus und starten Sie dann FFB-Bridge über das Launchpad oder den Anwendungsordner.

Da der Build durch die Entwickler-ID von Rohsam Inc. notariell beglaubigt ist, überprüft macOS ihn beim ersten Start über das Netzwerk und öffnet ihn normal. Wenn Ihr Mac beim ersten Start offline ist, stellen Sie eine Verbindung zum Internet her, damit Gatekeeper die Prüfung abschließen kann.

Deinstallation

Ziehen FFB-Bridge von Anwendungen in den Papierkorb. Profile und Präferenzen unten ~/.config/ffb-bridge bleiben für eine spätere Neuinstallation bestehen; entfernen Sie diesen Ordner von Hand, um neu zu beginnen.

Überprüfung der Installation

Starten Sie FFB-Bridge. Das erste, was Sie sehen sollten, ist das Willkommensdialogfeld (werden im nächsten Abschnitt behandelt). Wenn die App überhaupt nicht startet oder beim Start abstürzt, springen Sie direkt zu Fehlerbehebung.