X-Plane 11 / 12

X-Plane non necessita di configurazioni speciali. FFB-Bridge aderisce al protocollo dataref UDP integrato di X-Plane (RREF) sulla porta 49000. Niente da installare lato X-Plane, nessun plugin, nessun file XML in stile SimConnect. Se X-Plane è in esecuzione quando avvii il bridge, sei connesso.

L'unica SIM su macOS

X-Plane è il simulatore supportato sulla nuova build di macOS (Apple Silicon) — lo stesso percorso UDP a configurazione zero descritto qui. MSFS è solo Windows e Linux.

Comportamento di rilevamento automatico

All'avvio il bridge esegue due sonde in parallelo: una sonda TCP SimConnect (per MSFS) e una sonda UDP X-Plane. Vince il primo che restituisce una risposta reale. In pratica questo significa:

Se è in esecuzione solo X-Plane, vince in pochi millisecondi.
Se sono in esecuzione sia MSFS che X-Plane, viene utilizzata quella che ha risposto per prima e puoi forzare una scelta dalla CLI se questo dovesse rappresentare un problema.
Se nessuno dei due è in funzione, il bridge entra Inattivo modalità finché non ne appare uno.

Quando X-Plane è in esecuzione e il bridge si è iscritto con successo, la spia SIM nella striscia superiore diventa verde ("Sim connessa") e la spia MODE indica "Live". La spia DEVICE è indipendente: verde finché un joystick supportato è collegato e aperto.

Assicurati che X-Plane non sia protetto dal firewall

UDP 49000 è l'unica porta che il bridge tocca sul lato X-Plane. Le regole predefinite di Windows Firewall su una nuova installazione di X-Plane di solito lo consentono automaticamente; Desktop Linux con firewalld o ufw non blocca quasi mai il loopback. Se non compare nulla nel log eventi del bridge dopo l'avvio di X-Plane, aprire il Pagina di supporto (barra laterale → Supporto → Controlli sanitari) — il Raggiungibilità X-Plane row tenta un'analisi e ti dice cosa è tornato (timeout, connessione rifiutata o pacchetti effettivi).

Dataref letti dal bridge

Il bridge sottoscrive 24 dataref che rispecchiano il set di variabili MSFS tanto fedelmente quanto X-Plane li espone. Non è necessario configurare nulla, elencato qui per riferimento e debug:

sim/flightmodel/position/indicated_airspeed
sim/flightmodel/position/true_airspeed
sim/flightmodel/position/vh_ind (velocità verticale)
sim/flightmodel/position/theta (beccheggio)
sim/flightmodel/position/phi (inclinazione)
sim/flightmodel/position/psi (intestazione)
sim/flightmodel/forces/g_nrml (fattore di carico)
sim/flightmodel/position/alpha (AoA)
sim/flightmodel2/controls/yoke_pitch_ratio
sim/flightmodel2/controls/yoke_roll_ratio
sim/flightmodel2/controls/pitch_trim
sim/flightmodel2/controls/roll_trim
sim/cockpit/warnings/annunciators/stall_warning
sim/flightmodel/failures/over_vne
sim/flightmodel2/controls/gear_handle_down
sim/flightmodel2/controls/flap_handle_deploy_ratio
sim/flightmodel2/controls/speedbrake_ratio
sim/flightmodel/engine/ENGN_running[0..3]
sim/flightmodel/engine/ENGN_N1_[0..3]
sim/cockpit2/autopilot/autopilot_on
sim/cockpit2/autopilot/heading_dial_deg_mag_pilot
sim/flightmodel2/gear/on_ground_fraction
sim/flightmodel/misc/h_ind (altitudine barometrica)
sim/operation/override/override_throttles (per il rilevamento dell'inversione di spinta)

Stabilità e riconnessione

UDP non ha un segnale di disconnessione, quindi il bridge esegue il proprio watchdog: se per tre secondi non arriva alcun dataref, considera la sessione come terminata e la Sim il chip diventa rosso. Il riavvio di X-Plane o il caricamento di un nuovo volo ristabilisce automaticamente la connessione: non è necessario riavviare il bridge.

Pausa vs caricamento

La pausa di X-Plane continua a inviare dataref (solo valori congelati), quindi il bridge rimane connesso ma il watchdog di obsolescenza non scatta. Durante le schermate a livello di menu (selezione dell'aereo, finestra di dialogo della posizione), X-Plane interrompe brevemente l'emissione; il bridge riporterà la spia SIM sul grigio ("nessuna sim in esecuzione") e tornerà verde quando il volo riprende.

Installazione di X-Plane non predefinita

Sia i binari X-Plane gratuiti che quelli a pagamento associano UDP 49000 per impostazione predefinita. Se hai modificato la porta UDP di X-Plane (Impostazioni → Rete → Porte UDP), il bridge attualmente non espone un'interfaccia utente per la porta alternativa: usa quella predefinita di X-Plane o dicci quindi possiamo dargli la priorità.