Documentatie voor de huidige versie FFB-Bridge 1.4.0 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:

  • Gevalideerd op Windows, Linux en macOS: MOZA AB6, AB9 en AY210, Microsoft SideWinder Force Feedback 2, Logitech G940, Force 3D Pro en WingMan Force 3D, plus Brunner FFB-G. Geschikte niet-vermelde joysticks blijven een veilige experimentele opt-in. 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). De macOS-build is beperkt tot X-Plane 12 met de SideWinder Force Feedback 2 en ondersteunde MOZA-bases AB6, AB9 en AY210; Intel Macs worden niet ondersteund.
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.4.0-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.4.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.4.0-x86_64.AppImage && ./FfbBridge-1.4.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
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 met alleen events wordt als WARN gemeld, omdat de actuele MOZA TTY-machtigingen ontbreken. Gebruik Fix ook wanneer het bestand al bestaat; de app vervangt het door de volledige 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-build is beperkt tot X-Plane 12. Deze draait op Apple Silicon (M1 of nieuwer) en maakt verbinding met X-Plane 12 met de Microsoft SideWinder Force Feedback 2 en ondersteunde MOZA-bases AB6, AB9 en AY210. Deze wordt geleverd als een ondertekend en genotariseerd .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.4.0-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.