Huidige release. FFB-Bridge v1.2.1 is live. Deze documentatie volgt de huidige app zoals beschreven door het releasemanifest. Als een onderdeel verouderd lijkt, meld dat via het feedbackformulier.

FFB-Bridge installeren

FFB-Bridge wordt geleverd als een op zichzelf staand Windows-installatieprogramma, een Linux AppImage en een macOS DMG (Apple Silicon). Alle drie bundelen ze de .NET 10-runtime. Er hoeft geen stuurprogramma te worden gedownload voor ondersteunde USB-forcefeedback-joysticks op moderne Windows, Linux of macOS.

Voordat je begint

Je hebt nodig:

  • Een force-feedback-joystick. Vijf stickfamilies zijn gevalideerd en werken plug-and-play waar getest: Microsoft SideWinder Force Feedback 2 (045E:001B), MOZA AB9 + MH16 (346E:1000 / 346E:1002, Windows, Linux, and macOS), Logitech Flight System G940 (046D:C287), Logitech Force 3D Pro (046D:C286), en Logitech WingMan Force 3D (046D:C283). Andere force-feedback-joysticks kunnen experimenteel worden ingeschakeld via Instellingen → Hardware → “Niet-vermelde apparaten toestaan”; force-feedbackwielen, gamepads en apparaten met één as vallen buiten het bereik en worden verwezen naar de FFB Probe in plaats daarvan. Zie de hardwarepagina voor het volledige compatibiliteitsverhaal.
  • Een ondersteunde simulator: Microsoft Flight Simulator 2024, Microsoft Flight Simulator 2020, X-Plane 11 of X-Plane 12. DCS, Prepar3D en eerdere Flight Simulators worden niet ondersteund. Op macOS wordt alleen X-Plane ondersteund — MSFS maakt alleen verbinding op Windows en Linux.
  • Een van:
    • Windows 10 (versie 1809 of nieuwer) of Windows 11.
    • Elke moderne Linux-distributie met evdev – wat in wezen elke reguliere desktopdistributie is.
    • macOS op Apple Silicon (M1 of nieuwer). De macOS-build is beperkt tot X-Plane 12 met de SideWinder Force Feedback 2 en MOZA AB9 + MH16; Intel-Macs worden niet ondersteund.

Windows Installatieprogramma

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 (ongeveer 34 MB).

Voer het installatieprogramma uit

Dubbelklik op het installatieprogramma. U ziet de Inno Setup-wizard en Windows toont mogelijk ook een SmartScreen-reputatieprompt bij gloednieuwe ondertekende builds:

  1. Uitgeverscontrole. Het Windows-installatieprogramma is ondertekend met de uitgeversidentiteit Rohsam. Voordat je doorgaat, bevestig je dat Windows het volgende weergeeft Rohsam Inc. of RohsamInc als uitgever.
  2. SmartScreen-reputatieprompt. Nieuwe ondertekende builds kunnen nog steeds als niet-herkend worden gemarkeerd totdat het exacte bestand de downloadgeschiedenis krijgt. Als de bron dat is FFB-Bridge.com, de hash komt overeen en de uitgever is Rohsam, klik Meer informatie, dan Toch uitvoeren.
  3. 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 en nieuwe ondertekende builds

Als u Windows 11 gebruikt met Slimme app-bediening (SAC) ingeschakeld in de actieve modus, kan Windows nog steeds een gloednieuwe, ondertekende build blokkeren terwijl de reputatie een inhaalslag maakt. Code-ondertekening bewijst de identiteit van de Rohsam-uitgever; het garandeert niet dat elke nieuwe bestandshash op de eerste dag een SmartScreen- of SAC-reputatie heeft.

De eigen richtlijnen van Microsoft hebben betrekking op het gedrag van Smart App Control en waar u de instellingen ervan kunt bekijken (Instellingen → Privacy en beveiliging → Windows-beveiliging → App- en browserbeheer → Instellingen voor Smart App-beheer):

Microsoft: Veelgestelde vragen over Smart App Control

Als SAC een nieuwe build rechtstreeks op je computer blokkeert, wacht dan tot de build een reputatie heeft opgebouwd of gebruik een ander Windows-apparaat waarop je de Rohsam-handtekening kunt verifiëren en een weloverwogen keuze kunt maken.

Lancering

Een snelkoppeling in het Startmenu met de naam FFB-Bridge belandt in de programmagroep FFB-Bridge. Je kunt ook rechtstreeks starten vanuit %LOCALAPPDATA%\Programs\FfbBridge\FfbBridge.Desktop.exe.

Let op: antivirusprogramma

Sommige antivirusproducten markeren nieuwe binaire bestanden of binaire bestanden met een lage reputatie. 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 support·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. Je 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 AppImage

Download

Hetzelfde aanmeldingsproces als Windows: klik op de Linux-link in de e-mail en u ontvangt een AppImage met versieversie, zoals FfbBridge-1.0.0-x86_64.AppImage.

Maak het uitvoerbaar en installeer het

AppImages hebben de uitvoerbare bitset nodig voordat Linux ze kan uitvoeren. Daarna kan FFB-Bridge's AppImage zichzelf installeren in uw gebruikersgerichte XDG-desktopmappen:

chmod +x FfbBridge-1.0.0-x86_64.AppImage
./FfbBridge-1.0.0-x86_64.AppImage --install

De --install vlag kopieert de AppImage naar ~/Applications, schrijft A .desktop launcher, installeert het gebundelde pictogram en vernieuwt de bureaubladcaches wanneer deze hulpprogramma's beschikbaar zijn. Daarna wordt een FFB-Bridge Het item zou naast andere GUI-apps in uw applicatiemenu moeten verschijnen.

FFB-Bridge-vermelding in het KDE Plasma-toepassingsopstartprogramma na installatie
Figuur 1. Het geïnstalleerde menu-item op KDE Plasma. GNOME, Xfce en andere XDG-compatibele omgevingen pikken het op na de stap AppImage --install.

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 Ondersteuningspagina (in de zijbalk) biedt een installatie met één klik van de volgende udev-regel voor elke ondersteunde USB-joystick:

# /etc/udev/rules.d/99-ffb-bridge.rules
SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c286", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c283", 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"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c286", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c283", TAG+="uaccess"
'';

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

Verwijderen

Voer de geïnstalleerde AppImage uit met --uninstall om het opstartprogramma en de pictogrammen te verwijderen en verwijder vervolgens de AppImage uit ~/Applications als je het niet langer wilt. Profielen en voorkeuren onder ~/.config/ffb-bridge worden bewaard voor een latere herinstallatie.

macOS DMG (Apple Silicon)

De macOS-build is nieuw en uitgebreid: hij draait op Apple Silicon (M1 of nieuwer) en maakt verbinding met X-Plane 12 with the Microsoft SideWinder Force Feedback 2 and MOZA AB9 + MH16. It ships as a signed and notarized .dmg, dus Gatekeeper accepteert het zonder de 'Open'-oplossing met de rechtermuisknop.

Downloaden en installeren

Gebruik hetzelfde aanmeldingsproces als de andere platforms: klik op de macOS-link in de e-mail om een DMG met versiebeheer te downloaden, zoals FfbBridge-1.1.1-arm64.dmg. Dan:

  1. Dubbelklik op de DMG om deze te koppelen. Er wordt een venster geopend met de FFB-Bridge -app en een Toepassingen snelkoppeling.
  2. Sleep FFB-Bridge op de Toepassingen snelkoppeling om het te installeren.
  3. Werp de DMG uit en start vervolgens FFB-Bridge vanuit Launchpad of de map Programma's.

Omdat de build is bekrachtigd door de ontwikkelaars-ID van Rohsam Inc., verifieert macOS deze bij de eerste keer starten via het netwerk en wordt deze normaal geopend. Als uw Mac offline is de eerste keer dat u hem opstart, maakt u verbinding met internet zodat Gatekeeper de controle kan voltooien.

Verwijderen

Sleep FFB-Bridge van Toepassingen naar de prullenbak. Profielen en voorkeuren onder ~/.config/ffb-bridge blijven op hun plaats voor een latere herinstallatie; verwijder die map met de hand voor een schone lei.

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.