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

sim/flightmodel/position/indicated_airspeed
sim/flightmodel/misc/machno
sim/flightmodel/forces/g_nrml
sim/joystick/yoke_pitch_ratio
sim/joystick/yoke_roll_ratio
sim/cockpit2/controls/elevator_trim
sim/cockpit2/controls/aileron_trim
sim/cockpit2/annunciators/stall_warning
sim/flightmodel/failures/onground_any
sim/flightmodel/position/groundspeed
sim/flightmodel/position/vh_ind
sim/cockpit2/controls/left_brake_ratio
sim/cockpit2/controls/right_brake_ratio
sim/cockpit2/controls/gear_handle_down
sim/cockpit2/controls/flap_handle_request_ratio
sim/cockpit2/autopilot/servos_on
sim/cockpit2/controls/speedbrake_ratio
sim/flightmodel2/controls/flap1_deploy_ratio
sim/flightmodel2/controls/flap2_deploy_ratio
sim/flightmodel/position/Q
sim/flightmodel/position/P
sim/flightmodel2/engines/thrust_reverser_deploy_ratio[0]
sim/flightmodel/ground/surface_texture_type
sim/cockpit2/engine/indicators/N1_percent[0]
sim/flightmodel/engine/ENGN_running[0]
sim/time/paused
sim/flightmodel/forces/g_side
sim/flightmodel/position/Q_dot
sim/flightmodel/position/P_dot
sim/flightmodel/position/R_dot
sim/weather/aircraft/turbulence[0]
sim/flightmodel2/misc/has_crashed
sim/flightmodel/controls/hstab1_elv1def
sim/flightmodel/controls/wing1l_ail1def
sim/flightmodel/position/beta
sim/cockpit2/engine/indicators/engine_vibration[0]
sim/flightmodel/forces/fnrml_gear
sim/cockpit/autopilot/flight_director_pitch
sim/cockpit/autopilot/flight_director_roll
sim/flightmodel/forces/g_axil
sim/cockpit2/engine/actuators/prop_rotation_speed_rad_sec[0]
sim/aircraft/view/acf_ui_name[0..249]
sim/aircraft/view/acf_descrip[0..259]
sim/aircraft/view/acf_ICAO[0..39]
sim/version/xplane_internal_version
sim/aircraft/controls/acf_flap_detents

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