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.

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.

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 ponte 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é l'FFB2 è collegato.

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 viene visualizzato nulla nel registro eventi del bridge dopo l'avvio di X-Plane, apri Dottore - 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 (altezza)
  • sim/flightmodel/position/phi (banca)
  • 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 della spinta inversa)

Stabilità e riconnessione

UDP non ha segnale di disconnessione, quindi il bridge esegue il proprio watchdog: se non arriva alcun dataref per tre secondi, considera la sessione come morta e il 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 guardiano della stagnazione non inciampa. 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 della SIM sul grigio ("nessuna sim in esecuzione") e diventerà nuovamente 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à.