Documentation en version bêta. Certains textes et images seront retravaillés au fur et à mesure que l'application s'installera dans la version 1.0. Si une section est obsolète, signalez-la via le formulaire de commentaires.

X-Plane 11 / 12

X-Plane ne nécessite aucune configuration particulière. FFB-Bridge s'abonne au protocole de référence de données UDP intégré de X-Plane (RREF) sur le port 49000. Rien à installer côté X-Plane, pas de plugin, pas de fichier XML style SimConnect. Si X-Plane est en cours d'exécution lorsque vous lancez le pont, vous êtes connecté.

Comportement de détection automatique

Au démarrage, le pont exécute deux sondes en parallèle : une sonde SimConnect TCP (pour MSFS) et une sonde X-Plane UDP. Le premier à renvoyer une vraie réponse gagne. En pratique, cela signifie :

  • Si seul X-Plane est en cours d'exécution, il gagne en quelques millisecondes.
  • Si MSFS et X-Plane sont en cours d'exécution, la première réponse est utilisée - et vous pouvez forcer un choix depuis la CLI si jamais cela pose un problème.
  • Si aucun des deux ne fonctionne, le pont entre en Inactif mode jusqu'à ce qu'un apparaisse.

Lorsque X-Plane est en cours d'exécution et que le pont s'est abonné avec succès, le voyant SIM dans la bande supérieure devient vert (« SimConnecté ») et le voyant MODE indique « Live ». Le voyant DEVICE est indépendant – vert tant que le FFB2 est branché.

Assurez-vous que X-Plane n'est pas protégé par un pare-feu

UDP 49000 est le seul port que le pont touche du côté X-Plane. Les règles par défaut du pare-feu Windows sur une nouvelle installation de X-Plane le permettent généralement automatiquement ; Postes de travail Linux avec firewalld ou ufw ne bloque presque jamais le bouclage. Si rien n'apparaît dans le journal des événements du pont après le démarrage de X-Plane, ouvrez Docteur — le Accessibilité du X-Plane row tente une sonde et vous indique ce qui est revenu (délai d'expiration, connexion refusée ou paquets réels).

Références de données lues par le pont

Le pont s'abonne à 24 références de données qui reflètent l'ensemble de variables MSFS aussi fidèlement que X-Plane les expose. Vous n'avez rien à configurer - répertorié ici pour référence et débogage :

  • sim/flightmodel/position/indicated_airspeed
  • sim/flightmodel/position/true_airspeed
  • sim/flightmodel/position/vh_ind (vitesse verticale)
  • sim/flightmodel/position/theta (pas)
  • sim/flightmodel/position/phi (banque)
  • sim/flightmodel/position/psi (titre)
  • sim/flightmodel/forces/g_nrml (facteur de charge)
  • 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 (altitude barométrique)
  • sim/operation/override/override_throttles (pour la détection de poussée inverse)

Obsolescence et reconnexion

UDP n'a pas de signal de déconnexion, donc le pont exécute son propre chien de garde : si aucune référence de données n'arrive pendant trois secondes, il traite la session comme morte et le Sim la puce devient rouge. Relancer X-Plane ou charger un nouveau vol rétablit automatiquement la connexion — vous n'avez pas besoin de redémarrer le pont.

Pause ou chargement

La pause X-Plane continue d'envoyer des références de données (juste des valeurs gelées), donc le pont reste connecté mais le chien de garde de l'obsolescence ne se déclenche pas. Pendant les écrans de niveau menu (sélection de l'avion, boîte de dialogue de localisation), X-Plane arrête brièvement d'émettre ; le pont ramènera le voyant SIM au gris ("pas de sim en cours d'exécution") et redeviendra vert lorsque le vol reprendra.

Installation X-Plane autre que par défaut

Les binaires X-Plane gratuits et payants lient UDP 49000 par défaut. Si vous avez modifié le port UDP de X-Plane (Paramètres → Réseau → Ports UDP), le pont n'expose actuellement pas d'interface utilisateur pour le port alternatif — utilisez le port par défaut de X-Plane ou dites-nous afin que nous puissions lui donner la priorité.