Documentation de la version actuelle FFB-Bridge 1.6.0 Vous avez trouvé une indication obsolète? Signalez-la dans le formulaire de commentaires.

Page Support

La page Support est la page d'accueil unique pour la documentation, les vérifications de l'état, les diagnostics, les journaux et l'exportation des packages de support. La configuration du périphérique physique se trouve désormais sous Matériel.

Support → Contrôles d’état affiche une ligne par vérification, avec RÉUSSI / INFO / AVERT. / ÉCHEC et une action lorsqu’une réparation est disponible. L’onglet Ressources s’ouvre en premier. Support → Contrôles d’état affiche une ligne par vérification, avec RÉUSSI / INFO / AVERT. / ÉCHEC et une action lorsqu’une réparation est disponible. L’onglet Ressources s’ouvre en premier.
Figure 1. Support → Contrôles d’état affiche une ligne par vérification, avec RÉUSSI / INFO / AVERT. / ÉCHEC et une action lorsqu’une réparation est disponible. L’onglet Ressources s’ouvre en premier.

Bande d'onglets

Dans Support, l’onglet Ressources s’ouvre en premier. Il contient des liens vers la documentation en ligne et le PDF fourni. Les deux autres onglets sont accessibles en un clic :

  • Ressources (ouvert en premier) — documentation officielle et manuel PDF. Relancez le guide de bienvenue depuis Paramètres → Général.
  • Contrôles d’état — la surface de tri quotidienne (appareil, règle udev sous Linux, accessibilité de la simulation, état d'exécution). Cliquez sur Lancer les vérifications pour sonder.
  • Diagnostics — les métriques d'exécution, le journal des événements consultable et l'exportation de l'ensemble de support en un clic. Documenté séparément sur le Onglet Diagnostics page.

La sélection des appareils, l'étalonnage de la direction, le rendu validé, les limites de résistance et les affectations de contrôle se trouvent sous Matériel.

Onglet Contrôles d’état

Contrôles d’état est la voie dont la plupart des testeurs ont besoin lorsque quelque chose ne va pas. Cliquez sur Lancer les vérifications pour sonder l'état du pont. Les lignes sont mises à jour indépendamment, de sorte qu'une sonde de simulation lente n'empêche pas l'apparition du périphérique ou du résultat d'exécution.

  • RÉUSSI signifie que le pont a vérifié cette partie de la configuration.
  • INFO signifie que tout va bien, mais que la ligne a un contexte utile. Par exemple, X-Plane n'écoute pas lorsque vous pilotez MSFS ou utilisez le mode Mock Sim.
  • AVERT. signifie que la configuration peut continuer, mais qu'il y a quelque chose qui mérite d'être corrigé ou signalé.
  • ÉCHEC signifie que le pont a trouvé un problème bloquant. Lorsque Contrôles d’état connaît une solution sûre, la ligne propose un bouton d'action.
  • PRÊT et VÉRIFICATION sont des états neutres utilisés avant et pendant une exécution.

Contrôle automatique de l’appareil au démarrage

Au lancement, FFB-Bridge vérifie silencieusement le moteur de l’appareil sous Windows, Linux et macOS. Sous Linux, il contrôle aussi l’accès en lecture et en écriture à un nœud d’événement pris en charge et la couverture de toutes les autorisations actuelles par la règle udev installée. AVERT. ou ÉCHEC ouvre une boîte de dialogue qui nomme chaque problème, avec « Examiner et corriger maintenant » et « Ignorer pour l’instant ».

  • Si tous les contrôles réussissent, aucune fenêtre ne s’ouvre.
  • Le démarrage ne sonde ni le simulateur ni le réseau ; un simulateur fermé est normal et relève de l’exécution.
  • L’armement automatique attend tant que la boîte de dialogue reste ouverte. Le problème peut être examiné et corrigé, ou la boîte fermée lorsque l’appareil est volontairement débranché ; après cette fermeture, l’armement automatique ne peut continuer que si les autres conditions sont remplies.
Support → Contrôles d’état affiche RÉUSSI pour un nœud event pris en charge, AVERT. avec Réparer… pour une règle udev obsolète et ÉCHEC pour le périphérique physique. Support → Contrôles d’état affiche RÉUSSI pour un nœud event pris en charge, AVERT. avec Réparer… pour une règle udev obsolète et ÉCHEC pour le périphérique physique.
Figure 2. Support → Contrôles d’état affiche RÉUSSI pour un nœud event pris en charge, AVERT. avec Réparer… pour une règle udev obsolète et ÉCHEC pour le périphérique physique.

Matériel

Les anciennes commandes matérielles de la page Support disposent désormais d’une zone dédiée. Utilisez Flight Check pour les tests d’effets isolés et utilisez Matériel pour les paramètres de périphérique physique persistants. Ouvrir le guide du matériel.

Matériel → Étalonnage — vérifiez le sens du tangage et du roulis, la polarité des forces et toute permutation d’axes nécessaire. Matériel → Étalonnage — vérifiez le sens du tangage et du roulis, la polarité des forces et toute permutation d’axes nécessaire.
Figure 3. Matériel → Étalonnage — vérifiez le sens du tangage et du roulis, la polarité des forces et toute permutation d’axes nécessaire.

Comment sont disposées les vérifications

Chaque ligne de contrôle comporte quatre parties :

  • Statut — RÉUSSI (vert), INFO (bleu), AVERT. (orange), ÉCHEC (rouge), PRÊT / VÉRIFICATION (neutre) ou N/A lorsque la ligne ne s'applique pas sur cette plateforme.
  • Titre - ce qui est vérifié.
  • Détail — un résumé d'une ligne de ce qui a été trouvé. Passez la souris (ou appuyez sur le toucher) pour voir tous les détails.
  • Bouton d'action - présent uniquement lorsqu'il y a quelque chose d'actionnable. Exemples : Installer une entrée locale, Utiliser le port 5111, Réparer….

Les vérifications

Périphérique joystick FFB

Confirme qu'un joystick à retour de force pris en charge est visible par le système d'exploitation et que le pont peut l'ouvrir exclusivement. Échoue si aucun VID/PID pris en charge n’est présent ou si un autre processus détient le handle.

Linux règle udev

Contrôles d’état vérifie que /etc/udev/rules.d/71-ffb-bridge.rules couvre toutes les lignes d’entrée actuelles des appareils pris en charge, les autorisations TTY MOZA et l’accès hidraw utilisé par le Logitech G940 et les bases Brunner. Réparer… présente la règle canonique gérée, l’installe avec pkexec, supprime l’ancien 99-ffb-bridge.rules, recharge udev et déclenche les appareils d’entrée, TTY et hidraw. Un joystick non répertorié connecté et activé explicitement est ajouté pendant l’installation.

Une ancienne règle est signalée comme AVERT. lorsqu'elle manque d'une autorisation actuelle de l'appareil, comme les lignes TTY MOZA ou l'accès hidraw utilisé par le Logitech G940 et les bases Brunner, ou lorsque son nom de fichier la fait s'exécuter trop tard pour l'accès de la session de bureau, comme l'ancien 99-ffb-bridge.rules. Utilisez Réparer… même si le fichier existe déjà ; l'application installe la règle complète générée sous le nom 71-ffb-bridge.rules et supprime l'ancien fichier.

Après une correction réussie, la règle est active et l'application recommande un redémarrage. Redémarrer maintenant rouvre le manche avec les nouvelles autorisations et abandonne tout mode de repli du démarrage; choisir « Je redémarrerai plus tard » est sans risque si vous devez d'abord continuer.

La boîte de dialogue de correction Linux présente la règle canonique d’entrée et TTY MOZA des appareils pris en charge avant de demander l’autorisation. Un joystick non répertorié connecté et activé explicitement est ajouté pendant l’installation. La boîte de dialogue de correction Linux présente la règle canonique d’entrée et TTY MOZA des appareils pris en charge avant de demander l’autorisation. Un joystick non répertorié connecté et activé explicitement est ajouté pendant l’installation.
Figure 4. La boîte de dialogue de correction Linux présente la règle canonique d’entrée et TTY MOZA des appareils pris en charge avant de demander l’autorisation. Un joystick non répertorié connecté et activé explicitement est ajouté pendant l’installation.
Après une correction réussie, la règle est active et l'application recommande un redémarrage. Redémarrer maintenant rouvre le manche avec les nouvelles autorisations et abandonne tout mode de repli du démarrage; choisir « Je redémarrerai plus tard » est sans risque si vous devez d'abord continuer. Après une correction réussie, la règle est active et l'application recommande un redémarrage. Redémarrer maintenant rouvre le manche avec les nouvelles autorisations et abandonne tout mode de repli du démarrage; choisir « Je redémarrerai plus tard » est sans risque si vous devez d'abord continuer.
Figure 5. Après une correction réussie, la règle est active et l'application recommande un redémarrage. Redémarrer maintenant rouvre le manche avec les nouvelles autorisations et abandonne tout mode de repli du démarrage; choisir « Je redémarrerai plus tard » est sans risque si vous devez d'abord continuer.
Exception NixOS

Contrôles d’état détecte NixOS (en recherchant /etc/NIXOS) et remplace la ligne udev-rule par une instruction pour ajouter la règle à configuration.nix à la place. Voir Installer pour l'extrait.

WindowsLinux Configuration SimConnect de MSFS

SimConnect est le chemin de MSFS, cette vérification s'exécute donc sous Windows et Linux. Elle recherche les SimConnect.xml à l'emplacement approprié à la plateforme, l'analyse et compare toutes les entrées IPv4 activées avec le port utilisé par le pont. Trois résultats possibles :

  • Entrée correspondante trouvée. Vert : rien à faire.
  • Entrée dans un autre port. Ambre — offre un Utiliser le port :X bouton pour adopter ce port.
  • Aucune entrée utilisable (ou fichier non analysable). Rouge — offre un Réparer… bouton qui ouvre la boîte de dialogue d'installation (voir ci-dessous).
Linux utilise un port non privilégié

MSFS expédie son entrée SimConnect d'origine sur le port 500. Sous Windows, la liaison fonctionne correctement et le pont l'utilise. Sous Proton sous Linux, un processus d'espace de noms utilisateur ne peut pas lier les ports inférieurs à 1024, donc le pont installe et utilise une entrée parallèle sur un port non privilégié (5111 par défaut) que MSFS-in-Proton peut réellement lier — c'est pourquoi le correctif Linux et le Utiliser le port point d'action sur ce port supérieur.

Accessibilité de MSFS

Sonde le port TCP configuré. Envoie un vrai paquet SimConnect OPEN et inspecte l'en-tête de réponse afin qu'il puisse distinguer MSFS est à l'écoute de quelque chose d'autre écoute.

Accessibilité de X-Plane

La connexion à X-Plane est disponible sous Windows, Linux et macOS sur Apple Silicon. Cette vérification envoie une sonde RREF à 127.0.0.1:49000 et attend brièvement un dataref en réponse. Mappe à la fois le délai d'attente et celui de Winsock WSAECONNRESET (reçu lorsqu'un port ICMP inaccessible a été livré) sur « ne fonctionne pas ».

État du moteur d’exécution

Résume l’état actuel du périphérique, de la source de données, de la télémétrie et des exceptions. RÉUSSI signifie que le périphérique est ouvert et que des données de simulateur en direct ou de Mock Sim alimentent le pipeline ; INFO signifie que le périphérique est ouvert sans données de simulateur en direct, ce qui est normal lorsque le simulateur est fermé ; ÉCHEC signifie que le périphérique n’est pas ouvert.

Rapport de plantage

Si la session précédente a planté, FFB-Bridge affiche une boîte de dialogue de rapport de plantage au démarrage suivant plutôt qu’une ligne dans Contrôles d’état. Utilisez Copier pour copier la trace de pile enregistrée, et Ouvrir le formulaire de rétroaction pour ouvrir la page de rétroaction dans votre navigateur, où vous pouvez coller le journal et joindre un ensemble de support.

Boîte de dialogue Réparer

Réparer… les boutons n'appliquent pas les modifications directement — ils ouvrent une boîte de dialogue qui montre exactement ce qui est sur le point de changer, où, et (sous Linux) ce que l'invite d'authentification vous demandera d'approuver.

Boîte de dialogue Réparer pour l'installation de la configuration SimConnect. L'extrait XML exact à ajouter est affiché, ainsi qu'un aperçu du fichier résultant. Boîte de dialogue Réparer pour l'installation de la configuration SimConnect. L'extrait XML exact à ajouter est affiché, ainsi qu'un aperçu du fichier résultant.
Figure 6. Boîte de dialogue Réparer pour l'installation de la configuration SimConnect. L'extrait XML exact à ajouter est affiché, ainsi qu'un aperçu du fichier résultant.

Le dialogue est toujours additif: les entrées existantes ne sont jamais écrasées. Si le fichier cible n'est pas analysable, la boîte de dialogue explique qu'une sauvegarde horodatée sera effectuée en premier. Annuler est toujours le choix sûr.

Comportement de Linux pkexec

Actions qui écrivent dans les chemins système (règles udev, tout ce qui se trouve sous /etc) itinéraire à travers pkexec. Vous verrez l'invite polkit normale de votre distribution - la même qui s'affiche pour gparted ou une interface graphique de gestionnaire de paquets. Codes de sortie que Contrôles d’état interprète :

QuitterSignificationRapports de Contrôles d’état
0SuccèsChèque vert ; la ligne est réévaluée.
126L'utilisateur a rejeté l'invite d'authentificationAmbre « Annulé » – réessayez lorsque vous êtes prêt.
127Pas d'agent polkit / échec d'authentificationRouge « Échec de l’authentification ».
Astuce

Exécuter le pont dans un environnement minimal (Linux sans tête, influence sans agent polkit) est très bien – vous ne pouvez tout simplement pas utiliser les correctifs privilégiés de la page Support. Installez les fichiers requis manuellement ou démarrez un agent polkit avant de lancer le pont.

Quand toutes les vérifications sont vertes

L'application devrait fonctionner. Si ce n'est pas le cas, passez au Onglet Diagnostics - son journal des événements affichera plus de détails que les statuts sur une ligne de Contrôles d’état. Ou passez à Dépannage pour les symptômes courants et les solutions.

Si MSFS 2020 et 2024 ou plusieurs installations sont présents, vérifiez chaque cible de configuration nommée avant de la réparer. Une réparation met à jour la configuration du simulateur sélectionné ; redémarrez ensuite ce simulateur. Paramètres → Session détermine le simulateur que Bridge sélectionnera au prochain démarrage.