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.

Doctor page. Each row is one check: status icon, title, inline detail, and a contextual action button.
Figure 1. Doctor page. Each row is one check: status icon, title, inline detail, and a contextual action button.

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à. Both exist because different production runs of the Sidewinder Force Feedback 2 interpret force-feedback polarity differently — on some sticks, what the bridge thinks is “forward” physically pulls back, and vice-versa. The toggle is the install-level fix; the test is how you know whether to flip it.

Hardware compatibility card at the top of the Doctor page — Invert axis polarity toggle, drag-pad polarity test, and the hardware-periodics compatibility row with its Test hardware effects button.
Figure 2. Hardware compatibility card at the top of the Doctor page — Invert axis polarity toggle, drag-pad polarity test, and the hardware-periodics compatibility row with its Test hardware effects button.

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 is present and matches the canonical content. When absent, the action is Installa la regola udev — this triggers a pkexec prompt to write the file into a privileged location.

Eccezione NixOS

Doctor detects NixOS (by looking for /etc/NIXOS) and replaces the udev-rule row with an instruction to add the rule to configuration.nix instead. See Installa per lo snippet.

Configurazione SimConnect

Looks for MSFS's SimConnect.xml in the platform-appropriate location, parses it, and compares any enabled IPv4 entries against the port the bridge is using. Three possible outcomes:

  • 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 and waits briefly for a dataref in response. Maps both timeout and Winsock's WSAECONNRESET (received when an ICMP port-unreachable was delivered) to “not running”.

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.

Fix dialog for SimConnect config install. The exact XML snippet to be added is shown, along with a preview of the resulting file.
Figure 3. Fix dialog for SimConnect config install. The exact XML snippet to be added is shown, along with a preview of the resulting file.

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

Actions that write to system paths (udev rules, anything under /etc) route through pkexec. You'll see your distro's normal polkit prompt — the same one that pops up for gparted or a package manager GUI. Exit codes Doctor interprets:

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.