Installare FFB-Bridge

FFB-Bridge viene fornito come programma di installazione Windows autonomo e come AppImage Linux. Entrambi raggruppano il runtime .NET 10. Non è necessario scaricare alcun driver; il tuo SideWinder Force Feedback 2 funziona già a livello HID su qualsiasi kernel Windows o Linux moderno.

Prima di iniziare

Avrai bisogno di:

A Microsoft SideWinder Force Feedback 2 joystick (USB VID 045E, PID 001B). The bridge is currently hardcoded to this specific stick.
Un simulatore supportato: Microsoft Flight Simulator 2024, X-Plane 11 o X-Plane 12. MSFS 2020 non è stato testato. DCS, Prepar3D e i simulatori di volo precedenti non sono supportati.
Windows 10 (version 1809 or newer) or any modern Linux distribution with evdev — which is essentially every mainstream desktop distro.

Finestre Installatore

Scarica

Dopo esserti registrato su pagina iniziale, we email you a tokenised download link. Click the Windows installer link to save FfbBridge-Setup-x64.exe (about 34 MB).

Esegui il programma di installazione

Fare doppio clic sul programma di installazione. Vedrai uno o due messaggi:

SmartScreen “App non riconosciuta”. Il programma di installazione non è ancora firmato in codice: la firma è sulla roadmap 1.0. Fare clic Maggiori informazioni, quindi Corri comunque.
Procedura guidata di configurazione di Inno Setup. Fare clic Avanti through the two pages. The default install location is %LOCALAPPDATA%\Programs\FfbBridge — a per-user install, no administrator permission required.

finestre11 Smart App Control blocca completamente le app non firmate

Se utilizzi Windows 11 con Controllo intelligente delle app (SAC) abilitato in modalità attiva, il programma di installazione semplicemente non si avvia: nessun messaggio SmartScreen, nessuna opzione "Esegui comunque", semplicemente non succede nulla. SAC rifiuta qualsiasi app senza una firma di firma del codice attendibile e le build beta non sono ancora firmate.

L'unico modo per aggirare il problema oggi è disattivare Smart App Control per il tempo necessario all'installazione. Le indicazioni di Microsoft coprono il flusso (incluso come attivarlo tramite Impostazioni → Privacy e sicurezza → Sicurezza di Windows → Controllo app e browser → Impostazioni Controllo app intelligente):

Microsoft: domande frequenti su Smart App Control

Buone notizie rispetto ai primi Windows 11: i recenti aggiornamenti cumulativi ti consentono di riattivare SAC dall'app di sicurezza di Windows una volta terminata l'installazione: Microsoft richiedeva una reinstallazione completa di Windows, ma tale restrizione è scomparsa. L'app FFB-Bridge continuerà a funzionare normalmente dopo il riavvio di SAC; SAC controlla solo all'avvio le app che non ha mai visto prima.

Gli installatori con firma codice sono sulla roadmap 1.0 e rimuoveranno completamente questo passaggio.

Lancio

Un collegamento al menu Start denominato FFB-Bridge lands in the FFB-Bridge program group. You can also launch directly from %LOCALAPPDATA%\Programs\FfbBridge\FfbBridge.Desktop.exe.

Attenzione: antivirus

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.

Disinstallazione

Aperto App e funzionalità nelle Impostazioni di Windows, cerca FFB-Bridgee scegli Disinstallare. 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 AppImage

Scarica

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

Rendilo eseguibile e installalo

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 la voce viene visualizzata nel menu dell'applicazione insieme ad altre app GUI.

Voce FFB-Bridge nel lanciatore di applicazioni KDE Plasma dopo l'installazione — Figure 1. The installed menu entry on KDE Plasma. GNOME, Xfce, and other XDG-compatible environments pick it up identically.

regola udev (consigliata)

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 Dottore pagina offre un'installazione con un clic della seguente regola udev:

# /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.

Disinstallazione

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.

Verifica dell'installazione

Avvia il FFB-Bridge. La prima cosa che dovresti vedere è la finestra di dialogo di Benvenuto (trattato nella sezione successiva). Se l'app non si avvia affatto o si blocca all'avvio, vai direttamente a Risoluzione dei problemi.