Avião X 11/12

O X-Plane não precisa de configuração especial. FFB-Bridge assina o protocolo dataref UDP integrado do X-Plane (REF) na porta 49000. Nada para instalar no lado do X-Plane, nenhum plugin, nenhum arquivo XML no estilo SimConnect. Se o X-Plane estiver em execução quando você lançar a ponte, você estará conectado.

Comportamento de detecção automática

Na inicialização, a ponte executa duas sondagens em paralelo: uma sonda SimConnect TCP (para MSFS) e uma sonda X-Plane UDP. O primeiro a retornar uma resposta real vence. Na prática isso significa:

Se apenas o X-Plane estiver em execução, ele vencerá em alguns milissegundos.
Se o MSFS e o X-Plane estiverem em execução, o que responder primeiro será usado - e você poderá forçar uma escolha na CLI se isso for um problema.
Se nenhum deles estiver funcionando, a ponte entra em Inativo modo até que um apareça.

Quando o X-Plane está em execução e a ponte foi inscrita com sucesso, a lâmpada SIM na faixa superior fica verde (“Sim conectado”) e a lâmpada MODE indica “Live”. A lâmpada DEVICE é independente – verde enquanto o FFB2 estiver conectado.

Certifique-se de que o X-Plane não esteja 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 Doutor - o Acessibilidade do X-Plane row tenta uma investigação e informa o que retornou (tempo limite, conexão recusada ou pacotes reais).

Datarefs que a ponte lê

A ponte assina 24 datarefs que espelham o conjunto de variáveis MSFS tão próximo quanto o X-Plane os expõe. Você não precisa configurar nada — listado aqui para referência e depuração:

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)

Estabilidade e reconexão

O UDP não tem sinal de desconexão, então a ponte executa seu próprio watchdog: se nenhum dataref chegar por três segundos, ela trata a sessão como morta e o Sim chip fica vermelho. Reiniciar o X-Plane ou carregar um novo voo restabelece a conexão automaticamente – você não precisa reiniciar a ponte.

Pausar vs carregar

A pausa do X-Plane continua enviando datarefs (apenas valores congelados), então a ponte permanece conectado mas o cão de guarda do envelhecimento não tropeça. Durante as telas de menu (seleção de aeronave, diálogo de localização), o X-Plane para de emitir brevemente; a ponte deixará a lâmpada do SIM de volta à cinza ("sem sim funcionando") e ficará verde novamente quando o vôo for retomado.

Instalação não padrão do X-Plane

Os binários X-Plane gratuitos e pagos vinculam o UDP 49000 por padrão. Se você alterou a porta UDP do X-Plane (Configurações → Rede → Portas UDP), a ponte atualmente não expõe uma UI para a porta alternativa - use o padrão do X-Plane ou diga-nos para que possamos priorizá-lo.