Documentación de la versión actual FFB-Bridge 1.4.0 ¿Has encontrado algo desactualizado? Cuéntanoslo en el formulario de comentarios.

X-Plane 11 / 12

X-Plane no necesita ninguna configuración especial. FFB-Bridge se suscribe al protocolo de dataref 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.

El único simulador en macOS

X-Plane es el simulador compatible con la nueva versión de macOS (Apple Silicon): la misma ruta UDP de configuración cero que se describe aquí. MSFS es solo para Windows y Linux.

Comportamiento de detección automática

Al iniciarse, el bridge ejecuta dos sondas en paralelo: una sonda SimConnect TCP (para MSFS) y una sonda X-Plane UDP. La primera 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 DISPOSITIVO es independiente: verde siempre que un joystick compatible esté enchufado y abierto.

Asegúrese de que X-Plane no esté bloqueado por el firewall

UDP 49000 es el único puerto que toca el puente en el lado de X-Plane. Las reglas predeterminadas del Firewall de Windows en una instalación nueva de X-Plane generalmente lo permiten automáticamente; Escritorios Linux con firewalld o ufw casi nunca bloquea el loopback. Si no aparece nada en el registro de eventos del puente después de iniciar X-Plane, abra el Página de soporte (barra lateral → Soporte → Controles de estado) — 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

  • 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

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 datarefs 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 el simulador 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.