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.

Dottore

La pagina Dottore è un controllo sanitario unico. Esegue una manciata di sondaggi sul dispositivo, sulla sim e sull'ambiente host e, dove c'è una soluzione ovvia, offre un'azione in linea per applicarla. Inizia da qui ogni volta che qualcosa non funziona: è probabile che il dottore sappia già di cosa si tratta.

Pagina del dottore. Ogni riga è un controllo: icona di stato, titolo, dettagli in linea e un pulsante di azione contestuale.
Figure 1. Pagina del dottore. Ogni riga è un controllo: icona di stato, titolo, dettagli in linea e un pulsante di azione contestuale.

Compatibilità hardware

La prima carta nella pagina Dottore è a compatibilità hardware pannello. Ospita due controlli correlati: an Invertire la polarità dell'asse attiva/disattiva e un drag-pad live prova di polarità. Entrambi esistono perché diversi cicli di produzione del Sidewinder Force Feedback 2 interpretano la polarità del force feedback in modo diverso: su alcune bacchette, ciò che il ponte pensa sia "avanti" si tira fisicamente indietro e viceversa. L'interruttore è la correzione a livello di installazione; il test è come sapere se capovolgerlo.

Scheda di compatibilità hardware nella parte superiore della pagina Dottore: attiva/disattiva la polarità dell'asse, verifica la polarità del drag-pad e la riga di compatibilità dei periodici hardware con il pulsante Test degli effetti hardware.
Figure 2. Scheda di compatibilità hardware nella parte superiore della pagina Dottore: attiva/disattiva la polarità dell'asse, verifica la polarità del drag-pad e la riga di compatibilità dei periodici hardware con il pulsante Test degli effetti hardware.

Test di polarità in tempo reale

Fare clic Inizia e un piccolo drag-pad X-Y diventa attivo. Muovi il disco, la levetta segue in tempo reale: il bridge si attiva automaticamente in modalità Mock per tutta la durata del test in modo che il controllo dei prerequisiti venga superato senza una connessione sim. Fare clic Fermare quando hai finito. Chiede una modale di conferma "Il bastone ha seguito il disco?":

  • — la polarità è corretta, non è stata apportata alcuna modifica.
  • No — la levetta si ribalta automaticamente e ogni forza successiva su entrambi gli assi di beccheggio e rollio viene annullata sul bordo di uscita del dispositivo.

L'allontanamento dalla pagina Dottore durante il test intermedio la interrompe silenziosamente e ripristina la sorgente di input precedente (attiva o inattiva), senza necessità di arresto esplicito.

Inversione polarità asse (manuale)

L'interruttore a sinistra della scheda è la stessa impostazione che il test scriverebbe. Usalo direttamente se sai già che il tuo stick ha bisogno del ribaltamento, ad esempio, lo hai eseguito in un'installazione precedente e desideri impostarlo prima del test. L'impostazione è a livello di installazione, non per profilo: risiede nelle preferenze del ponte, si applica insieme agli assi di beccheggio e rollio e sopravvive ai riavvii.

Perché entrambi gli assi insieme

Le versioni precedenti consentivano di invertire il passo indipendentemente dal rollio. Ciò non corrispondeva al modo in cui effettivamente si presentano le stranezze del firmware dell'FFB2: quando un asse è invertito, lo sono entrambi. L'interruttore ora li capovolge in coppia. Le impostazioni esistenti per campo vengono trasferite al primo avvio.

Periodici combinati con software

Il bridge ha due modi per inviare effetti periodici e one-shot (rimbombo, colpi, brividi...) al FFB2. Modalità hardware - l'impostazione predefinita di nuova installazione - utilizza gli effetti hardware DirectInput e beta.11 mantiene quella topologia deliberatamente piccola: una costante vettoriale, una molla a due assi e un pool periodico pigro a tre slot. Il firmware gestisce ancora le forme d'onda periodiche alla velocità nativa; il bridge riutilizza semplicemente quegli slot fisici per la pista corrente, il motore, il buffet e gli spunti one-shot. Periodici combinati con software, l'interruttore sulla stessa riga Doctor, mantiene solo il percorso hardware di forza continua/centratura e sintetizza segnali periodici e one-shot in C# a 200 Hz, ripiegando il risultato negli output a forza costante.

La modalità hardware è più nitida e ha una latenza inferiore sugli effetti a frequenza più alta perché il firmware li guida più velocemente del tick rate del bridge. La fusione del software è il fallback di compatibilità per gli stack di driver che continuano a bloccarsi in modalità hardware, per risultati di sonda non riusciti o per utenti che lo preferiscono deliberatamente. Un'uscita generica non pulita non forza di per sé la fusione del software. Entrambe le modalità utilizzano gli stessi quattordici effetti con gli stessi cursori di regolazione per effetto: la scelta è un dettaglio di invio, non un'attivazione/disattivazione di una funzione. In ogni caso è necessario il riavvio; il dispatcher legge la modalità all'avvio.

Fare clic Testare gli effetti hardware per provare la topologia hardware compatta in sicurezza. Il dottore avvia un processo di lavoro separato, assegna la stessa costante vettoriale, molla a due assi e pool periodico che il ponte utilizza in volo, quindi lo demolisce. Se lo stack DirectInput/PID di Windows si blocca, muore solo il lavoratore e il bridge rimane aperto. Se il test viene superato, Doctor e il runtime passano allo stesso stato di modalità hardware al successivo avvio, quindi lo stato Doctor e la modalità dispatcher effettiva concordano.

Come sono disposti i controlli

Ogni riga di controllo è composta da quattro parti:

  • Punto di stato — verde (superato), giallo (avvertimento), rosso (fallito), grigio (non applicabile 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 Sidewinder Force Feedback 2 è visibile al sistema operativo e che il bridge può aprirlo esclusivamente. Fallisce se il VID/PID non è presente o se un altro processo detiene l'handle.

Linux regola udev

Checks whether /etc/udev/rules.d/99-ffb-bridge.rules è presente e corrisponde al contenuto canonico. Quando assente, l'azione è Installa la regola udev — this triggers a pkexec richiede di scrivere il file in una posizione privilegiata.

Eccezione NixOS

Il medico rileva NixOS (cercando /etc/NIXOS) e sostituisce la riga udev-rule con un'istruzione a cui aggiungere la regola configuration.nix instead. See Installa per lo snippet.

Configurazione SimConnect

Looks for MSFS's 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).

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

Sends a tiny RREF probe to 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".

Durata

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 direttamente le modifiche: aprono una finestra di dialogo che mostra esattamente cosa sta per cambiare, dove e (su Linux) cosa il prompt di autenticazione ti 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.
Figure 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) route through pkexec. Vedrai il normale prompt polkit della tua distribuzione, lo stesso che appare gparted o una GUI di gestione pacchetti. Codici di uscita Il medico interpreta:

EsciSignificatoIl medico riferisce
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 puoi utilizzare le soluzioni privilegiate di Doctor. Installa manualmente i file richiesti o avvia un agente polkit prima di avviare il bridge.

Quando il Dottore è verde ovunque

L'app dovrebbe funzionare. In caso contrario, il registro eventi di Diagnostica mostrerà più dettagli rispetto allo stato su una riga del Dottore. Dirigiti lì dopo o salta lì Risoluzione dei problemi per sintomi comuni e soluzioni.