Version actuelle. FFB-Bridge v1.2.1 est disponible. Cette documentation suit l'application actuelle décrite par le manifeste de version. Si une section semble 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 dataref 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é.

Le seul simulateur sur macOS

X-Plane est le simulateur pris en charge sur la nouvelle version de macOS (Apple Silicon) – le même chemin UDP sans configuration décrit ici. MSFS est uniquement Windows et Linux.

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. La première à renvoyer une vraie réponse l'emporte. En pratique, cela signifie :

  • Si seul X-Plane est en cours d'exécution, il l'emporte 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 qu'un manche pris en charge est branché et ouvert.

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 le Page de support (barre latérale → Support → Bilans de santé) — le Accessibilité de 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 (tangage)
  • sim/flightmodel/position/phi (roulis)
  • 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 l'inversion de poussée)

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