Pagina di supporto

La pagina Supporto è l'unica home page per documentazione, controlli di integrità, diagnostica, registri ed esportazione di pacchetti di supporto. La configurazione del dispositivo fisico ora si trova in 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.

Selezione del dispositivo, calibrazione della direzione, rendering convalidato, limiti di resistenza e assegnazioni di controllo si trovano sotto 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.

Controllo automatico del dispositivo all’avvio

All’avvio, FFB-Bridge controlla silenziosamente il backend del dispositivo in Windows, Linux e macOS. In Linux verifica anche l’accesso in lettura e scrittura a un nodo eventi supportato e che la regola udev installata copra tutte le autorizzazioni correnti. WARN o FAIL mostra un banner non bloccante Rivedi e correggi che identifica ogni problema.

Se tutti i controlli riescono, non si apre alcuna finestra.
L’avvio non interroga il simulatore o la rete; un simulatore chiuso è normale e viene gestito durante l’esecuzione.
Finché la finestra rimane aperta, Auto-arm attende. È possibile esaminare e correggere il problema oppure chiudere la finestra quando il dispositivo è intenzionalmente scollegato; dopo la chiusura, Auto-arm può continuare solo se sono soddisfatti gli altri prerequisiti.

Figure 2. Support → Health mostra PASS per un nodo eventi supportato, WARN con Fix per una regola udev obsoleta e FAIL per il dispositivo fisico.

Hardware

I precedenti controlli hardware della pagina di supporto ora hanno un'area dedicata. Utilizza Flight Check per test di effetti isolati e utilizza l'hardware per impostazioni persistenti del dispositivo fisico. Apri la guida dell'hardware.

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

Health checks verifica che /etc/udev/rules.d/99-ffb-bridge.rules copra tutte le righe di input correnti dei dispositivi supportati e le autorizzazioni TTY MOZA. Fix mostra la regola canonica gestita, la installa tramite pkexec, ricarica udev e attiva i dispositivi di input e TTY. Durante l’installazione viene aggiunto un joystick non elencato collegato e abilitato esplicitamente.

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.

Figure 4. 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 5. 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.

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.

Figure 6. 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:

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

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.