Documentación en beta. Algunos textos e imágenes se modificarán a medida que la aplicación se instale en la versión 1.0. Si una sección se lee obsoleta, márquela mediante el formulario de comentarios.

X-Plane 11 / 12

X-Plane no necesita ninguna configuración especial. FFB-Bridge se suscribe al protocolo de referencia de datos UDP integrado de X-Plane (RREF) en el puerto 49000. Nada que instalar en X-Plane, ningún complemento, ningún archivo XML estilo SimConnect. Si X-Plane se está ejecutando cuando inicias el puente, estás conectado.

Comportamiento de detección automática

Al iniciarse, el puente ejecuta dos sondas en paralelo: una sonda SimConnect TCP (para MSFS) y una sonda X-Plane UDP. El primero en devolver una respuesta real gana. En la práctica esto significa:

  • Si sólo se está ejecutando X-Plane, gana en unos pocos milisegundos.
  • Si se están ejecutando MSFS y X-Plane, se utilizará el que responda primero, y puede forzar una elección desde la CLI si alguna vez surge un problema.
  • Si ninguno de los dos está funcionando, el puente entra en inactivo modo hasta que aparezca uno.

Cuando X-Plane está funcionando y el puente se ha suscrito exitosamente, la lámpara SIM en la franja superior se vuelve verde (“Sim conectada”) y la lámpara MODE dice “En vivo”. La lámpara DEVICE es independiente: verde siempre que el FFB2 esté enchufado.

Asegúrate de que X-Plane no esté protegido por firewall

UDP 49000 is the only port the bridge touches on the X-Plane side. Default Windows Firewall rules on a fresh X-Plane install usually allow this automatically; Linux desktops with firewalld or ufw almost never block loopback. If nothing is showing up in the bridge's event log after X-Plane boots, open medico — el Accesibilidad de X-Plane La fila intenta realizar un sondeo y le indica lo que devolvió (tiempo de espera, conexión rechazada o paquetes reales).

Datarefs que lee el puente

El puente se suscribe a 24 referencias de datos que reflejan el conjunto de variables MSFS tan fielmente como X-Plane los expone. No necesita configurar nada; se enumeran aquí para referencia y depuración:

  • sim/flightmodel/position/indicated_airspeed
  • sim/flightmodel/position/true_airspeed
  • sim/flightmodel/position/vh_ind (vertical speed)
  • sim/flightmodel/position/theta (pitch)
  • sim/flightmodel/position/phi (bank)
  • sim/flightmodel/position/psi (heading)
  • sim/flightmodel/forces/g_nrml (load factor)
  • 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 (barometric altitude)
  • sim/operation/override/override_throttles (for reverse thrust detection)

Estancamiento y reconexión

UDP no tiene señal de desconexión, por lo que el puente ejecuta su propio perro guardián: si no llegan datos durante tres segundos, trata la sesión como muerta y el Sim el chip se vuelve rojo. Al reiniciar X-Plane o cargar un nuevo vuelo se restablece la conexión automáticamente; no es necesario reiniciar el puente.

Pausa vs carga

La pausa de X-Plane continúa enviando referencias de datos (solo valores congelados), por lo que el puente permanece conectado pero el perro guardián del estancamiento no se dispara. Durante las pantallas a nivel de menú (selección de avión, diálogo de ubicación), X-Plane deja de emitir brevemente; el puente hará que la luz de la SIM vuelva a ponerse gris ("no hay ninguna SIM en funcionamiento") y volverá a ponerse verde cuando se reanude el vuelo.

Instalación de X-Plane no predeterminada

Tanto los binarios gratuitos como los de pago de X-Plane vinculan UDP 49000 de forma predeterminada. Si ha cambiado el puerto UDP de X-Plane (Configuración → Red → Puertos UDP), el puente actualmente no expone una interfaz de usuario para el puerto alternativo; use el puerto predeterminado de X-Plane o cuéntanos para que podamos priorizarlo.