Documentazione in versione beta. Alcuni testi e immagini verranno rielaborati man mano che l'app si installa nella versione 1.0. Se una sezione risulta obsoleta, segnalala tramite il file modulo di feedback.

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). Il bridge è attualmente codificato su questo stick specifico.
  • 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 (versione 1809 o successiva) o qualsiasi distribuzione Linux moderna con evdev - che è essenzialmente ogni distribuzione desktop tradizionale.

Finestre Installatore

Scarica

Dopo esserti registrato su pagina iniziale, ti invieremo via email un collegamento per il download tokenizzato. Fare clic sul collegamento del programma di installazione di Windows per salvare FfbBridge-Setup-x64.exe (about 34 MB).

Esegui il programma di installazione

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

  1. 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.
  2. Procedura guidata di configurazione di Inno Setup. Fare clic Avanti attraverso le due pagine. Il percorso di installazione predefinito è %LOCALAPPDATA%\Programs\FfbBridge - un'installazione per utente, non è richiesta alcuna autorizzazione di amministratore.
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 approda nel gruppo di programmi FFB-Bridge. Puoi anche avviarlo direttamente da %LOCALAPPDATA%\Programs\FfbBridge\FfbBridge.Desktop.exe.

Attenzione: antivirus

Alcuni prodotti antivirus contrassegnano i file binari non firmati. Se il tuo mette in quarantena il programma di installazione in modo definitivo (anziché solo avvisarlo), invia un'e-mail con l'esempio contrassegnato a feedback·ffb-bridge.com (sostituisci il · con un @) così possiamo indagare.

Disinstallazione

Aperto App e funzionalità nelle Impostazioni di Windows, cerca FFB-Bridgee scegli Disinstallare. I tuoi profili e preferenze sotto %APPDATA%\ffb-bridge vengono lasciati sul posto in modo che una reinstallazione li riprenda; rimuovi quella cartella manualmente se vuoi una tabula rasa.

Linux AppImage

Scarica

Stesso flusso di registrazione di Windows: fai clic sul collegamento Linux nell'e-mail e riceverai FfbBridge-x86_64.AppImage (about 40 MB).

Rendilo eseguibile e installalo

AppImages necessita del set di bit eseguibili e, sulla maggior parte delle distribuzioni, deve essere registrato nel menu dell'applicazione in modo che il launcher del desktop li raccolga. L'incluso install.sh lo script fa entrambe le cose; la forma lunga è:

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

Il --install flag registers a .desktop file e icona nelle directory dei dati XDG. Dopodiché, 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. La voce di menu installata su KDE Plasma. GNOME, Xfce e altri ambienti compatibili con XDG lo rilevano in modo identico.

regola udev (consigliata)

Per impostazione predefinita, solo l'utente la cui sessione di accesso possiede il joystick può aprirlo /dev/input/eventN nodo. Affinché il bridge continui a funzionare dopo un cambio rapido di utente o semplicemente per evitare richieste di polkit su alcune distribuzioni, il comando 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 legge le regole udev dalla configurazione di sistema, no /etc/udev/rules.d. Aggiungi l'equivalente al tuo configuration.nix:

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

Then sudo nixos-rebuild switch e ricollegare la chiavetta.

Disinstallazione

Either delete ~/Applications/FfbBridge-x86_64.AppImage ed esegui il programma di disinstallazione in bundle oppure esegui AppImage con il file --uninstall flag per invertire automaticamente la registrazione del menu/icona. Profili e preferenze sotto ~/.config/ffb-bridge vengono conservati per una successiva reinstallazione.

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.