Documentatie voor de huidige versie FFB-Bridge 1.5.1 Iets verouderds gevonden? Meld het 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:

  • Ondersteunde hardware omvat MOZA AB6, AB9, AY90 en AY210; Microsoft SideWinder Force Feedback 2; Logitech G940, Force 3D Pro en WingMan Force 3D; ondersteunde Brunner DirectX-apparaten; en geselecteerde SideWinder Force Feedback Pro-adapters. Mogelijkheden en fysieke testresultaten verschillen per exact model en platform. Raadpleeg de hardwaregids voordat je aanneemt dat een bepaalde functie is gevalideerd. Geschikte joysticks die niet in de lijst staan, vereisen expliciete inschakeling van experimentele ondersteuning. hardwarepagina.
  • 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 11.
    • Elke moderne Linux-distributie met evdev – wat in wezen elke reguliere desktopdistributie is.
    • macOS op Apple Silicon (M1 of nieuwer), met X-Plane en een ondersteund apparaat. Intel-Macs worden niet ondersteund. Bekijk de hardwaregids voor modelspecifieke testresultaten en beperkingen.
Automatische updates

Windows- en verpakte Linux AppImage-installaties kunnen na je goedkeuring downloaden, verifiëren, installeren en opnieuw starten. macOS controleert automatisch en opent de ondertekende download.

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 ffb-bridge-setup-1.5.1-x64.exe .

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 (replace the · with an @) so we can investigate.

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.5.1-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.5.1-x86_64.AppImage && ./FfbBridge-1.5.1-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
Figure 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)

Linux vereist machtigingen voor het gekozen /dev/input/event*-knooppunt en voor het TTY-kanaal voor firmwarebeleid dat ondersteunde MOZA-bases gebruiken. Support → Health checks toont de canonieke regel voor ondersteunde apparaten en kan deze na een polkit-melding installeren. Als een geschikte niet-vermelde joystick expliciet is ingeschakeld en aangesloten, wordt de invoerregel tijdens installatie toegevoegd.

# /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"
Een bestaande regel kan toch verouderd zijn

Een oudere regel wordt als WAARSCHUWING gemeld wanneer deze geen actuele apparaatmachtiging heeft, zoals de MOZA TTY-lijnen of de schrijfbare hidraw-toegang die het Logitech G940 krachtprotocolpad nodig heeft. Gebruik Fix zelfs als het bestand al bestaat; de app vervangt het door de volledig gegenereerde regel.

Na succesvol herstel is de regel actief en raadt de app een herstart aan. Nu herstarten opent de joystick opnieuw met de nieuwe machtigingen en laat een startfallback los; Later herstarten is veilig als je eerst wilt doorgaan.

Het Linux-herstelvenster toont vóór de toestemmingsvraag de canonieke invoer- en MOZA TTY-regel voor ondersteunde apparaten. Een aangesloten, expliciet ingeschakelde, niet-vermelde joystick wordt tijdens installatie toegevoegd. Het Linux-herstelvenster toont vóór de toestemmingsvraag de canonieke invoer- en MOZA TTY-regel voor ondersteunde apparaten. Een aangesloten, expliciet ingeschakelde, niet-vermelde joystick wordt tijdens installatie toegevoegd.
Figure 2. Het Linux-herstelvenster toont vóór de toestemmingsvraag de canonieke invoer- en MOZA TTY-regel voor ondersteunde apparaten. Een aangesloten, expliciet ingeschakelde, niet-vermelde joystick wordt tijdens installatie toegevoegd.
Na succesvol herstel is de regel actief en raadt de app een herstart aan. Nu herstarten opent de joystick opnieuw met de nieuwe machtigingen en laat een startfallback los; Later herstarten is veilig als je eerst wilt doorgaan. Na succesvol herstel is de regel actief en raadt de app een herstart aan. Nu herstarten opent de joystick opnieuw met de nieuwe machtigingen en laat een startfallback los; Later herstarten is veilig als je eerst wilt doorgaan.
Figure 3. Na succesvol herstel is de regel actief en raadt de app een herstart aan. Nu herstarten opent de joystick opnieuw met de nieuwe machtigingen en laat een startfallback los; Later herstarten is veilig als je eerst wilt doorgaan.
NixOS

NixOS leest udev-regels uit de systeemconfiguratie. Het negeert bestanden die er rechtstreeks in zijn geplaatst /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}=="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"
'';

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-versie maakt verbinding met X-Plane. Deze draait op Apple Silicon (M1 of nieuwer) en maakt verbinding met X-Plane 12 met ondersteunde hardware voor force feedback. Raadpleeg de hardwaregids voor de precieze apparaat- en functieondersteuning. De app wordt ondertekend en genotariseerd geleverd in het formaat .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.5.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. Bevestig de veiligheidsmelding en rond de opstartcontroles af. Volg daarna de welkomstgids (behandeld in de volgende sectie). Als de app helemaal niet start of crasht bij het opstarten, ga dan direct naar Problemen oplossen.