Versione attuale. FFB-Bridge v1.2.1 è disponibile. Questa documentazione segue l'app attuale descritta dal manifesto di rilascio. Se una sezione sembra superata, segnalala tramite il modulo di feedback.

Pagina di supporto

La pagina di supporto (etichettata Supporto nella barra laterale) è la sede unica per tutto ciò che dovresti aprire quando qualcosa non va, quando hai bisogno di un riferimento o quando desideri esportare un pacchetto di supporto per lo sviluppatore. Tre schede: Risorse, Controlli di integrità, e Diagnostica. I controlli di compatibilità hardware che vivevano qui sono stati spostati Impostazioni → Hardware.

Pagina di supporto. La scheda predefinita dei controlli di integrità mostra una riga per sonda, con lo stato PASSATO / INFO / AVVISO / FALLITO e pulsanti di azione contestuale quando è disponibile una correzione. Pagina di supporto. La scheda predefinita dei controlli di integrità mostra una riga per sonda, con lo stato PASSATO / INFO / AVVISO / FALLITO e pulsanti di azione contestuale quando è disponibile una correzione.
Figura 1. Pagina di supporto. La scheda predefinita dei controlli di integrità mostra una riga per sonda, con lo stato PASSATO / INFO / AVVISO / FALLITO e pulsanti di azione contestuale quando è disponibile una correzione.

Striscia di schede

La pagina di Supporto si apre sul Risorse scheda: documenti, collegamenti al manuale e replay del tour di benvenuto si trovano qui come primo approdo amichevole. Le altre due schede sono a un clic di distanza:

  • Risorse (si apre per primo): collegamenti ai documenti e al manuale ospitati qui, oltre al replay del tour di benvenuto e alle pagine dell'editore/legale.
  • Controlli di integrità — la superficie di triage quotidiana (dispositivo, regola udev su Linux, raggiungibilità della sim, stato di runtime). Fare clic Eseguire i controlli sondare.
  • Diagnostica — parametri di runtime, registro eventi ricercabile ed esportazione del pacchetto di supporto con un clic. Documentato separatamente su Scheda Diagnostica pagina.

Compatibilità hardware (test degli assi con inversione + scambio beccheggio/rollio, rendering degli effetti, backend del dispositivo su Windows, selezione del dispositivo e Testare gli effetti hardware sonda) non è più una scheda Supporto: continua a vivere Impostazioni → Hardware.

Scheda Controlli di integrità

I controlli di integrità sono il percorso di cui la maggior parte dei tester ha bisogno quando qualcosa non quadra. Fare clic Eseguire i controlli per sondare lo stato del bridge. Le righe si aggiornano in modo indipendente, quindi una sonda lenta del sim non blocca la visualizzazione del risultato del dispositivo o del runtime.

  • PASS significa che il bridge ha verificato quella parte della configurazione.
  • INFORMAZIONI significa che non c'è niente di sbagliato, ma la riga ha un contesto utile. Ad esempio, è previsto che X-Plane non ascolti quando si vola su MSFS o si utilizza la modalità Mock.
  • AVVISO significa che la configurazione può continuare, ma c'è qualcosa che vale la pena correggere o segnalare.
  • FALLIMENTO significa che il bridge ha riscontrato un problema di blocco. Quando i controlli di integrità rilevano una soluzione sicura, la riga offre un pulsante di azione.
  • PRONTO e VERIFICA IN CORSO sono stati neutri utilizzati prima e durante una corsa.

I controlli hardware sono stati spostati in Impostazioni

I controlli di compatibilità hardware erano una scheda Supporto. Ora si trovano su Impostazioni → Hardware: il vivo prova degli assi (con Invertire la polarità dell'asse e Scambia gli assi di beccheggio/rollio), il Rendering degli effetti radio (effetti hardware vs modalità compatibilità software), il backend del dispositivo Windows, il selettore del dispositivo per più stick collegati, l'attivazione sperimentale di dispositivi non elencati e il Testare gli effetti hardware sonda. Vedi il Pagina Impostazioni per la procedura dettagliata completa.

Impostazioni → Hardware: il test degli assi (inversione + scambio beccheggio/rollio), il rendering degli effetti, il backend del dispositivo Windows e la sonda degli effetti hardware di prova. Impostazioni → Hardware: il test degli assi (inversione + scambio beccheggio/rollio), il rendering degli effetti, il backend del dispositivo Windows e la sonda degli effetti hardware di prova.
Figura 2. Impostazioni → Hardware: il test degli assi (inversione + scambio beccheggio/rollio), il rendering degli effetti, il backend del dispositivo Windows e la sonda degli effetti hardware di prova.

Come sono disposti i controlli

Ogni riga di controllo è composta da quattro parti:

  • Stato — PASS (verde), INFO (blu), WARN (giallo), FAIL (rosso), READY / CHECKING (neutro) o N/A quando la riga non si applica su questa piattaforma.
  • Titolo - cosa viene controllato.
  • Dettaglio - un riepilogo di una riga di ciò che è stato trovato. Passa il mouse (o tocca al tocco) per vedere i dettagli completi.
  • Pulsante di azione - presente solo quando c'è qualcosa di fattibile. Esempi: Installa la regola udev, Utilizza la porta:5111, Correggi….

I controlli

Dispositivo

Conferma che un joystick con feedback forzato supportato è visibile al sistema operativo e che il bridge può aprirlo in modo esclusivo. Ha esito negativo se non è presente alcun VID/PID supportato o se un altro processo detiene l'handle.

Linux regola udev

Verifica se /etc/udev/rules.d/99-ffb-bridge.rules è presente e corrisponde al contenuto canonico. Quando assente, l'azione è Installa la regola udev – questo innesca a pkexec richiede di scrivere il file in una posizione privilegiata.

Eccezione NixOS

I controlli di integrità rilevano NixOS (cercando /etc/NIXOS) e sostituisce la riga udev-rule con un'istruzione a cui aggiungere la regola configuration.nix invece. Vedi Installa per lo snippet.

WindowsLinux Configurazione SimConnect

SimConnect è il percorso MSFS, quindi questo controllo viene eseguito su Windows e Linux. Cerca MSFS SimConnect.xml nella posizione appropriata per la piattaforma, la analizza e confronta tutte le voci IPv4 abilitate con la porta utilizzata dal bridge. Tre possibili esiti:

  • Trovata voce corrispondente. Verde: niente da fare.
  • Ingresso in un porto diverso. Ambra: offre a Usa la porta:X pulsante per adottare quella porta.
  • Nessuna voce utilizzabile (o file non analizzabile). Rosso: offre a Correggi… pulsante che apre la finestra di dialogo di installazione (vedi sotto).
Linux utilizza una porta non privilegiata

MSFS fornisce la voce SimConnect standard sulla porta 500. Su Windows il collegamento avviene correttamente e il bridge lo utilizza. In Proton su Linux, un processo dello spazio dei nomi utente non può associare le porte inferiori a 1024, quindi il bridge installa e utilizza una voce parallela su una porta non privilegiata (5111 per impostazione predefinita) che MSFS-in-Proton può effettivamente associare, motivo per cui la correzione Linux e il Utilizza la porta punto di azione in quel porto più alto.

Raggiungibilità di SimConnect

Esamina la porta TCP configurata. Invia un pacchetto OPEN SimConnect reale e ispeziona l'intestazione della risposta in modo che possa distinguerlo MSFS è in ascolto da qualcos'altro sta ascoltando.

Raggiungibilità X-Plane

Il percorso X-Plane funziona su ogni piattaforma e su macOS (Apple Silicon), X-Plane 12 con SideWinder FFB2 è la combinazione supportata. Questo controllo invia una piccola sonda RREF a 127.0.0.1:49000 e attende brevemente un dataref in risposta. Mappa sia il timeout che quello di Winsock WSAECONNRESET (ricevuto quando è stata consegnata una porta ICMP irraggiungibile) su "non in esecuzione".

Runtime

Verifica che il loop di controllo funzioni ai 50 Hz target. Avvisa se la media degli ultimi 60 s scende sotto i 45 Hz.

Registro degli arresti anomali

Se è presente un registro degli arresti anomali dell'ultima sessione, la riga diventa color ambra e offre Rivela per saltarci sopra nel file manager e Invia tramite modulo di feedback che precompila l'invio di un feedback con il registro allegato.

Correggi la finestra di dialogo

Correggi… i pulsanti non applicano le modifiche direttamente: aprono una finestra di dialogo che mostra esattamente cosa sta per cambiare, dove e (su Linux) cosa il prompt di autenticazione chiederà di approvare.

Correzione della finestra di dialogo per l'installazione della configurazione di SimConnect. Viene mostrato l'esatto frammento XML da aggiungere, insieme a un'anteprima del file risultante. Correzione della finestra di dialogo per l'installazione della configurazione di SimConnect. Viene mostrato l'esatto frammento XML da aggiungere, insieme a un'anteprima del file risultante.
Figura 3. Correzione della finestra di dialogo per l'installazione della configurazione di SimConnect. Viene mostrato l'esatto frammento XML da aggiungere, insieme a un'anteprima del file risultante.

Il dialogo è sempre additivo: le voci esistenti non vengono mai sovrascritte. Se il file di destinazione non è analizzabile, la finestra di dialogo spiega che verrà eseguito prima un backup con timestamp. Annullare è sempre la scelta sicura.

Comportamento pkexec di Linux

Azioni che scrivono su percorsi di sistema (regole udev, qualsiasi cosa sotto /etc) percorso attraverso pkexec. Vedrai il normale prompt polkit della tua distribuzione, lo stesso che appare gparted o una GUI di gestione pacchetti. Codici di uscita I controlli di integrità interpretano:

EsciSignificatoRapporti sui controlli sanitari
0SuccessoSegno di spunta verde; la riga viene rivalutata.
126L'utente ha ignorato la richiesta di autenticazioneAmbra "Annullato": riprova quando sei pronto.
127Nessun agente polkit/errore di autenticazioneRosso "Autenticazione fallita."
Suggerimento

L'esecuzione del bridge in un ambiente minimo (Linux headless, sway senza agente polkit) va bene: semplicemente non è possibile utilizzare le correzioni privilegiate della pagina di supporto. Installa manualmente i file richiesti o avvia un agente polkit prima di avviare il bridge.

Quando ogni controllo è verde

L'app dovrebbe funzionare. In caso contrario, passa a Scheda Diagnostica - il suo registro eventi mostrerà più dettagli rispetto agli stati su una riga dei controlli sanitari. Oppure salta a Risoluzione dei problemi per sintomi comuni e soluzioni.