Dokumentation in Beta. Einige Texte und Bilder werden überarbeitet, wenn die App auf Version 1.0 umgestellt wird. Wenn ein Abschnitt veraltet ist, kennzeichnen Sie ihn über Feedback-Formular.

FFB-Bridge installieren

FFB-Bridge wird als eigenständiges Windows-Installationsprogramm und als Linux-AppImage geliefert. Beide bündeln die .NET 10-Laufzeitumgebung. Es gibt keinen Treiber zum Herunterladen; Ihr SideWinder Force Feedback 2 funktioniert bereits auf HID-Ebene auf jedem modernen Windows- oder Linux-Kernel.

Bevor Sie beginnen

Sie benötigen:

  • A Microsoft SideWinder Force Feedback 2 joystick (USB VID 045E, PID 001B). Die Bridge ist derzeit für diesen speziellen Stick fest codiert.
  • Ein unterstützter Simulator: Microsoft Flight Simulator 2024, X-Plane 11 oder X-Plane 12. MSFS 2020 ist ungetestet. DCS, Prepar3D und frühere Flugsimulatoren werden nicht unterstützt.
  • Windows 10 (Version 1809 oder neuer) oder jede moderne Linux-Distribution mit evdev – das ist im Wesentlichen jede Mainstream-Desktop-Distribution.

Windows Installateur

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 FfbBridge-Setup-x64.exe (about 34 MB).

Führen Sie das Installationsprogramm aus

Doppelklicken Sie auf das Installationsprogramm. Es werden ein oder zwei Eingabeaufforderungen angezeigt:

  1. SmartScreen „Unerkannte App“. Das Installationsprogramm ist noch nicht codesigniert – die Signierung steht auf der 1.0-Roadmap. Klicken Sie Weitere Informationen, dann Lauf trotzdem.
  2. 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 blockiert nicht signierte Apps vollständig

Wenn Sie Windows 11 mit verwenden Intelligente App-Steuerung (SAC) im aktiven Modus aktiviert ist, startet das Installationsprogramm einfach nicht – keine SmartScreen-Eingabeaufforderung, keine Option „Trotzdem ausführen“, es passiert einfach nichts. SAC lehnt jede App ohne vertrauenswürdige Codesignatur-Signatur ab und die Beta-Builds sind noch nicht signiert.

Die einzige Möglichkeit, dies zu umgehen, besteht heute darin, Smart App Control lange genug für die Installation auszuschalten. Microsofts eigene Anleitung deckt den Ablauf ab (einschließlich der Vorgehensweise zum Umschalten über). Einstellungen → Datenschutz und Sicherheit → Windows-Sicherheit → App- und Browsersteuerung → Smart App Control-Einstellungen):

Microsoft: Häufig gestellte Fragen zu Smart App Control

Gute Nachrichten im Vergleich zu frühem Windows 11: Mit den jüngsten kumulativen Updates können Sie SAC über die Windows-Sicherheits-App wieder aktivieren, sobald die Installation abgeschlossen ist. Früher verlangte Microsoft eine vollständige Neuinstallation von Windows, aber diese Einschränkung gibt es nicht mehr. Die FFB-Bridge-App selbst läuft normal weiter, nachdem SAC wieder aktiviert ist. SAC sucht beim Start nur nach Apps, die es zuvor noch nicht gesehen hat.

Codesignierte Installationsprogramme sind auf der 1.0-Roadmap enthalten und werden diesen Schritt vollständig entfernen.

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 nicht signierte 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 feedback·ffb-bridge.com (ersetzen Sie das · durch ein @), damit wir es untersuchen können.

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, so dass sie bei einer Neuinstallation wieder aktiviert werden; Entfernen Sie diesen Ordner manuell, wenn Sie eine saubere Übersicht wünschen.

Linux AppImage

Download

Gleicher Anmeldevorgang wie bei Windows – klicken Sie auf den Linux-Link in der E-Mail und Sie erhalten FfbBridge-x86_64.AppImage (about 40 MB).

Machen Sie es ausführbar und installieren Sie es

Für AppImages muss das ausführbare Bit gesetzt sein und bei den meisten Distributionen im Anwendungsmenü registriert werden, damit der Desktop-Launcher sie aufnimmt. Das inklusive install.sh Das Skript macht beides; die Langform ist:

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

Die --install flag registers a .desktop Datei und Symbol in Ihre XDG-Datenverzeichnisse. Danach a FFB-Bridge Der Eintrag wird in Ihrem Anwendungsmenü neben anderen GUI-Apps angezeigt.

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 dies auf die gleiche Weise.

udev-Regel (empfohlen)

Standardmäßig kann nur der Benutzer, dessen Anmeldesitzung den Joystick besitzt, ihn öffnen /dev/input/eventN Knoten. Damit die Bridge nach einem schnellen Benutzerwechsel weiter funktioniert oder einfach um Polkit-Eingabeaufforderungen auf einigen Distributionen zu vermeiden, muss die Doktor Seite bietet eine Ein-Klick-Installation der folgenden udev-Regel:

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

NixOS liest udev-Regeln aus der Systemkonfiguration, nicht /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"
'';

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

Deinstallation

Either delete ~/Applications/FfbBridge-x86_64.AppImage und führen Sie das mitgelieferte Deinstallationsprogramm aus oder führen Sie AppImage mit dem aus --uninstall Flag, um die Menü-/Symbolregistrierung automatisch umzukehren. Profile und Präferenzen unten ~/.config/ffb-bridge werden für eine spätere Neuinstallation aufbewahrt.

Ü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.