Documentazione della versione corrente FFB-Bridge 1.4.0 Hai trovato un’indicazione obsoleta? Segnalala nel modulo di feedback.

Installare FFB-Bridge

FFB-Bridge viene fornito come programma di installazione Windows autonomo, AppImage Linux e DMG macOS (Apple Silicon). Tutti e tre raggruppano il runtime .NET 10. Non è disponibile alcun driver da scaricare per i joystick USB con feedback forzato supportati sui moderni Windows, Linux o macOS.

Prima di iniziare

Avrai bisogno di:

  • Convalidati su Windows, Linux e macOS: MOZA AB6, AB9 e AY210, Microsoft SideWinder Force Feedback 2, Logitech G940, Force 3D Pro e WingMan Force 3D, oltre a Brunner FFB-G. I joystick idonei non elencati rimangono un’opzione sperimentale sicura. pagina hardware.
  • Un simulatore supportato: Microsoft Flight Simulator 2024, Microsoft Flight Simulator 2020, X-Plane 11 o X-Plane 12. DCS, Prepar3D e i simulatori di volo precedenti non sono supportati. Su macOS è supportato solo X-Plane – MSFS si connette solo su Windows e Linux.
  • Uno tra:
    • Windows 11.
    • Qualsiasi distribuzione Linux moderna con evdev - che è essenzialmente ogni distribuzione desktop tradizionale.
    • macOS su Apple Silicon (M1 o successivo). La build macOS è limitata a X-Plane 12 con SideWinder Force Feedback 2 e le basi MOZA AB6, AB9 e AY210 supportate; i Mac Intel non sono supportati.
Aggiornamenti automatici

Le installazioni Windows e Linux AppImage possono essere scaricate, verificate, installate e riavviate previa approvazione. macOS controlla automaticamente e apre il download firmato.

Windows Installatore

Scarica

Dopo esserti registrato su home page, ti invieremo via email un collegamento per il download tokenizzato. Fare clic sul collegamento del programma di installazione di Windows per salvare ffb-bridge-setup-1.4.0-x64.exe .

Esegui il programma di installazione

Fare doppio clic sul programma di installazione. Vedrai la procedura guidata Inno Setup e Windows potrebbe anche mostrare una richiesta di reputazione SmartScreen sulle build firmate nuove di zecca:

  1. Verifica dell'editore. Il programma di installazione di Windows è firmato in codice dall'identità dell'editore Rohsam. Prima di continuare, conferma che Windows sia visualizzato Rohsam Inc. o Rohsam Inc come editore.
  2. Richiesta di reputazione SmartScreen. Le nuove build firmate potrebbero comunque essere contrassegnate come non riconosciute fino a quando il file esatto non acquisirà la cronologia dei download. Se la fonte è FFB-Bridge.com, l'hash corrisponde e l'editore è Rohsam, fare clic Maggiori informazioni, quindi Esegui comunque.
  3. 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.
Windows 11 Controllo intelligente delle app e nuove build firmate

Se utilizzi Windows 11 con Controllo intelligente delle app (SAC) abilitato in modalità attiva, Windows potrebbe comunque bloccare una nuova build firmata mentre la reputazione viene recuperata. La firma del codice dimostra l'identità dell'editore Rohsam; non garantisce che ogni nuovo hash di file abbia la reputazione SmartScreen o SAC il primo giorno.

Le indicazioni di Microsoft riguardano il comportamento di Smart App Control e dove esaminarne le impostazioni (Impostazioni → Privacy e sicurezza → Sicurezza di Windows → Controllo app e browser → Impostazioni Controllo app intelligente):

Microsoft: domande frequenti su Smart App Control

Se SAC blocca completamente una nuova build sul computer, attendere che la build accumuli reputazione oppure utilizzare un altro dispositivo Windows dove sia possibile verificare la firma Rohsam e fare una scelta informata.

Avvio

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 segnalano file binari nuovi o con bassa reputazione. 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 support·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. 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 otterrai un'AppImage con versione come FfbBridge-1.4.0-x86_64.AppImage.

Rendilo eseguibile e installalo

Gli AppImage necessitano del bit eseguibile impostato prima che Linux possa eseguirli. Successivamente, l'AppImage di FFB-Bridge può installarsi nelle directory desktop XDG con ambito utente:

chmod +x FfbBridge-1.4.0-x86_64.AppImage && ./FfbBridge-1.4.0-x86_64.AppImage --install

Il --install Il flag copia l'AppImage in ~/Applications, scrive A .desktop launcher, installa l'icona in bundle e aggiorna le cache del desktop quando sono disponibili gli strumenti di supporto. Dopodiché, a FFB-Bridge La voce dovrebbe essere visualizzata nel menu dell'applicazione insieme ad altre app della 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 la rilevano dopo il passaggio --install dell'AppImage.

regola udev (consigliata)

Linux richiede autorizzazioni per il nodo /dev/input/event* selezionato e per il canale TTY della politica firmware usato dalle basi MOZA supportate. Support → Health checks mostra la regola canonica per i dispositivi supportati e può installarla tramite una richiesta polkit. Se un joystick idoneo non elencato è abilitato esplicitamente e collegato, la relativa riga di input viene aggiunta durante l’installazione.

# /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"
Anche una regola esistente può essere obsoleta

Una vecchia regola limitata agli eventi viene segnalata come WARN perché non contiene le autorizzazioni TTY MOZA correnti. Usare Fix anche se il file esiste già; l’applicazione lo sostituisce con la regola completa generata.

Dopo una correzione riuscita, la regola è attiva e l'app consiglia un riavvio. Riavvia ora riapre il joystick con le nuove autorizzazioni ed elimina l'eventuale fallback di avvio; Riavvia più tardi è sicuro se devi prima continuare.

La finestra di correzione Linux mostra la regola canonica di input e TTY MOZA per i dispositivi supportati prima di richiedere l’autorizzazione. Durante l’installazione viene aggiunto un joystick non elencato collegato e abilitato esplicitamente. La finestra di correzione Linux mostra la regola canonica di input e TTY MOZA per i dispositivi supportati prima di richiedere l’autorizzazione. Durante l’installazione viene aggiunto un joystick non elencato collegato e abilitato esplicitamente.
Figure 2. La finestra di correzione Linux mostra la regola canonica di input e TTY MOZA per i dispositivi supportati prima di richiedere l’autorizzazione. Durante l’installazione viene aggiunto un joystick non elencato collegato e abilitato esplicitamente.
Dopo una correzione riuscita, la regola è attiva e l'app consiglia un riavvio. Riavvia ora riapre il joystick con le nuove autorizzazioni ed elimina l'eventuale fallback di avvio; Riavvia più tardi è sicuro se devi prima continuare. Dopo una correzione riuscita, la regola è attiva e l'app consiglia un riavvio. Riavvia ora riapre il joystick con le nuove autorizzazioni ed elimina l'eventuale fallback di avvio; Riavvia più tardi è sicuro se devi prima continuare.
Figure 3. Dopo una correzione riuscita, la regola è attiva e l'app consiglia un riavvio. Riavvia ora riapre il joystick con le nuove autorizzazioni ed elimina l'eventuale fallback di avvio; Riavvia più tardi è sicuro se devi prima continuare.
NixOS

NixOS legge le regole udev dalla configurazione del sistema. Ignora i file inseriti direttamente in /etc/udev/rules.d. Aggiungi l'equivalente al tuo 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"
'';

Allora sudo nixos-rebuild switch e ricollegare la chiavetta.

Disinstallazione

Esegui l'AppImage installata con --uninstall per rimuovere il programma di avvio e le icone, quindi eliminare l'AppImage da ~/Applications se non lo desideri più. Profili e preferenze sotto ~/.config/ffb-bridge vengono conservati per una successiva reinstallazione.

macOS DMG (Apple Silicon)

La build macOS è limitata a X-Plane 12. Funziona su Apple Silicon (M1 o successivo) e si connette a X-Plane 12 con Microsoft SideWinder Force Feedback 2 e le basi MOZA AB6, AB9 e AY210 supportate. Viene distribuita come file firmato e autenticato .dmg, quindi Gatekeeper lo accetta senza la soluzione alternativa "Apri" facendo clic con il pulsante destro del mouse.

Scaricare e installare

Utilizzare lo stesso flusso di iscrizione delle altre piattaforme: fare clic sul collegamento macOS nell'email per scaricare un DMG con versione come FfbBridge-1.4.0-arm64.dmg. Quindi:

  1. Fare doppio clic sul DMG per montarlo. Si apre una finestra che mostra il FFB-Bridge app e un Applicazioni scorciatoia.
  2. Resistenza aerodinamica FFB-Bridge sul Applicazioni collegamento per installarlo.
  3. Espellere il DMG, quindi avviare FFB-Bridge dal Launchpad o dalla cartella Applicazioni.

Poiché la build è autenticata dall'ID sviluppatore Rohsam Inc., macOS la verifica al primo avvio sulla rete e la apre normalmente. Se il tuo Mac è offline al primo avvio, connettiti a Internet in modo che Gatekeeper possa completare il controllo.

Disinstallazione

Resistenza aerodinamica FFB-Bridge da Applicazioni nel Cestino. Profili e preferenze sotto ~/.config/ffb-bridge vengono lasciati sul posto per una successiva reinstallazione; rimuovi quella cartella manualmente per una lavagna pulita.

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 arresta in modo anomalo all'avvio, andare direttamente a Risoluzione dei problemi.