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). De brug is momenteel hardgecodeerd voor deze specifieke 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 (versie 1809 of nieuwer) of een andere moderne Linux-distributie met evdev – wat in wezen elke reguliere desktopdistributie is.

Ramen Installateur

Download

Nadat u zich heeft aangemeld op de startpagina, e-mailen wij u een getokeniseerde downloadlink. Klik op de Windows Installer-link om op te slaan 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 via de twee pagina's. De standaardinstallatielocatie is %LOCALAPPDATA%\Programs\FfbBridge — installatie per gebruiker, geen beheerderstoestemming vereist.
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 belandt in de programmagroep FFB-Bridge. U kunt ook rechtstreeks starten vanuit %LOCALAPPDATA%\Programs\FfbBridge\FfbBridge.Desktop.exe.

Let op: antivirusprogramma

Sommige antivirusproducten markeren niet-ondertekende binaire bestanden. Als de jouwe het installatieprogramma volledig in quarantaine plaatst (in plaats van alleen maar te waarschuwen), stuur dan het gemarkeerde voorbeeld per e-mail naar feedback·ffb-bridge.com (vervang de · door een @) zodat we het kunnen onderzoeken.

Verwijderen

Openen Apps en functies in Windows-instellingen, zoek naar FFB-Bridge, en kies Verwijderen. Uw profielen en voorkeuren onder %APPDATA%\ffb-bridge blijven op hun plaats, zodat een herinstallatie ze weer oppikt; verwijder die map met de hand als je een schone lei wilt.

Linux AppAfbeelding

Download

Zelfde aanmeldingsproces als Windows: klik op de Linux-link in de e-mail en u ontvangt FfbBridge-x86_64.AppImage (about 40 MB).

Maak het uitvoerbaar en installeer het

AppImages hebben de uitvoerbare bitset nodig en moeten, op de meeste distributies, worden geregistreerd in het applicatiemenu, zodat de desktoplauncher ze oppikt. De inbegrepen install.sh script doet beide; de lange vorm is:

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

De --install flag registers a .desktop bestand en pictogram in uw XDG-gegevensmappen. Daarna wordt een FFB-Bridge item verschijnt in uw applicatiemenu naast andere GUI-apps.

FFB-Bridge-vermelding in het KDE Plasma-toepassingsopstartprogramma na installatie
Figure 1. Het geïnstalleerde menu-item op KDE Plasma. GNOME, Xfce en andere XDG-compatibele omgevingen pikken het op dezelfde manier op.

udev-regel (aanbevolen)

Standaard kan alleen de gebruiker wiens inlogsessie eigenaar is van de joystick deze openen /dev/input/eventN knooppunt. Om ervoor te zorgen dat de bridge blijft werken na een snelle gebruikerswisseling, of eenvoudigweg om polkit-prompts op sommige distributies te vermijden, moet de 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 leest udev-regels uit de systeemconfiguratie, niet /etc/udev/rules.d. Voeg het equivalent toe aan uw configuration.nix:

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

Then sudo nixos-rebuild switch en sluit de stick opnieuw aan.

Verwijderen

Either delete ~/Applications/FfbBridge-x86_64.AppImage en voer het meegeleverde verwijderprogramma uit, of voer AppImage uit met de --uninstall vlag om de menu-/pictogramregistratie automatisch om te keren. Profielen en voorkeuren onder ~/.config/ffb-bridge worden bewaard voor een latere herinstallatie.

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.