Documentatie in bèta. Sommige tekst en afbeeldingen zullen worden herwerkt naarmate de app zich nestelt in 1.0. Als een sectie verouderd is, markeer deze dan via de feedbackformulier.

FFB-Bridge installeren

FFB-Bridge wordt geleverd als een op zichzelf staand Windows-installatieprogramma en een Linux AppImage. Beide bundelen de .NET 10-runtime. Er is geen stuurprogramma om te downloaden; uw SideWinder Force Feedback 2 werkt al op HID-niveau op elke moderne Windows- of Linux-kernel.

Voordat je begint

Je hebt nodig:

  • A Microsoft SideWinder Force Feedback 2 joystick (USB VID 045E, PID 001B). The bridge is currently hardcoded to this specific stick.
  • Een ondersteunde simulator: Microsoft Flight Simulator 2024, X-Plane 11 of X-Plane 12. MSFS 2020 is niet getest. DCS, Prepar3D en eerdere Flight Simulators worden niet ondersteund.
  • Windows 10 (version 1809 or newer) or any modern Linux distribution with evdev — which is essentially every mainstream desktop distro.

Ramen Installateur

Download

Nadat u zich heeft aangemeld op de startpagina, we email you a tokenised download link. Click the Windows installer link to save FfbBridge-Setup-x64.exe (about 34 MB).

Voer het installatieprogramma uit

Dubbelklik op het installatieprogramma. Je ziet een of twee aanwijzingen:

  1. SmartScreen “Niet-herkende app”. Het installatieprogramma is nog niet ondertekend met een code; ondertekenen staat op de routekaart 1.0. Klik Meer informatie, dan Toch maar rennen.
  2. Inno Setup-installatiewizard. Klik Volgende through the two pages. The default install location is %LOCALAPPDATA%\Programs\FfbBridge — a per-user install, no administrator permission required.
Windows 11 Smart App Control blokkeert niet-ondertekende apps volledig

Als u Windows 11 gebruikt met Slimme app-bediening (SAC) ingeschakeld in de actieve modus, start het installatieprogramma eenvoudigweg niet: geen SmartScreen-prompt, geen optie "Toch uitvoeren", er gebeurt gewoon niets. SAC weigert elke app zonder een vertrouwde handtekening voor code-ondertekening, en de bètaversies zijn nog niet ondertekend.

De enige manier om dit vandaag de dag te omzeilen, is door Smart App Control lang genoeg uit te schakelen om te installeren. De eigen richtlijnen van Microsoft hebben betrekking op de stroom (inclusief hoe u deze kunt omschakelen via Instellingen → Privacy en beveiliging → Windows-beveiliging → App- en browserbeheer → Instellingen voor Smart App-beheer):

Microsoft: Veelgestelde vragen over Smart App Control

Goed nieuws versus vroege Windows 11: Met recente cumulatieve updates kunt u SAC opnieuw inschakelen vanuit de Windows Security-app zodra de installatie is voltooid. Vroeger vereiste Microsoft een volledige herinstallatie van Windows, maar die beperking is verdwenen. De FFB-Bridge-app zelf blijft normaal werken nadat SAC weer is ingeschakeld; SAC controleert bij het opstarten alleen op apps die het nog niet eerder heeft gezien.

Code-ondertekende installatieprogramma's bevinden zich op de routekaart 1.0 en zullen deze stap volledig verwijderen.

Lancering

Een snelkoppeling in het Startmenu met de naam FFB-Bridge lands in the FFB-Bridge program group. You can also launch directly from %LOCALAPPDATA%\Programs\FfbBridge\FfbBridge.Desktop.exe.

Let op: antivirusprogramma

Some antivirus products flag unsigned binaries. If yours quarantines the installer outright (rather than just warning), please email the flagged sample to feedback·ffb-bridge.com (replace the · with an @) so we can investigate.

Verwijderen

Openen Apps en functies in Windows-instellingen, zoek naar FFB-Bridge, en kies Verwijderen. Your profiles and preferences under %APPDATA%\ffb-bridge are left in place so a reinstall picks them up again; remove that folder by hand if you want a clean slate.

Linux AppAfbeelding

Download

Same signup flow as Windows — click the Linux link in the email and you'll get FfbBridge-x86_64.AppImage (about 40 MB).

Maak het uitvoerbaar en installeer het

AppImages need the executable bit set and, on most distros, to be registered in the application menu so the desktop launcher picks them up. The included install.sh script does both; the long form is:

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

The --install flag registers a .desktop file and icon into your XDG data directories. After that, a FFB-Bridge item verschijnt in uw applicatiemenu naast andere GUI-apps.

FFB-Bridge-vermelding in het KDE Plasma-toepassingsopstartprogramma na installatie
Figure 1. The installed menu entry on KDE Plasma. GNOME, Xfce, and other XDG-compatible environments pick it up identically.

udev-regel (aanbevolen)

Out of the box, only the user whose login session owns the joystick can open its /dev/input/eventN node. For the bridge to keep working after a fast-user-switch, or simply to avoid polkit prompts on some distributions, the Dokter pagina biedt een installatie met één klik van de volgende udev-regel:

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

NixOS reads udev rules from the system config, not /etc/udev/rules.d. Add the equivalent to your configuration.nix:

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

Then sudo nixos-rebuild switch and replug the stick.

Verwijderen

Either delete ~/Applications/FfbBridge-x86_64.AppImage and run the bundled uninstaller, or run the AppImage with the --uninstall flag to reverse the menu/icon registration automatically. Profiles and preferences under ~/.config/ffb-bridge are kept for a later reinstall.

De installatie verifiëren

Start FFB-Bridge. Het eerste dat u zou moeten zien is het welkomstvenster (behandeld in de volgende sectie). Als de app helemaal niet start of crasht bij het opstarten, ga dan direct naar Problemen oplossen.