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.


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.


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.
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).
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.


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:
| Esci | Significato | Rapporti sui controlli sanitari |
|---|---|---|
0 | Successo | Segno di spunta verde; la riga viene rivalutata. |
126 | L'utente ha ignorato la richiesta di autenticazione | Ambra "Annullato": riprova quando sei pronto. |
127 | Nessun agente polkit/errore di autenticazione | Rosso "Autenticazione fallita." |
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.