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

Page de 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 → Health checks affiche une ligne par vérification, avec PASS / INFO / WARN / FAIL et une action lorsqu’une réparation est disponible. L’onglet Resources s’ouvre en premier. Support → Health checks affiche une ligne par vérification, avec PASS / INFO / WARN / FAIL et une action lorsqu’une réparation est disponible. L’onglet Resources s’ouvre en premier.
Figure 1. Support → Health checks affiche une ligne par vérification, avec PASS / INFO / WARN / FAIL et une action lorsqu’une réparation est disponible. L’onglet Resources s’ouvre en premier.

Bande d'onglets

Dans Support, l’onglet Ressources (Resources) 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 Settings → General.
  • Vérifications de l'état — la surface de tri quotidienne (périphérique, règle udev sous Linux, accessibilité du simulateur, état d'exécution). Cliquez Effectuer des contrôles à sonder.
  • Diagnostics - les métriques d'exécution, le journal des événements consultable et l'exportation du package 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 Bilans de santé

Les vérifications de l'état sont la voie dont la plupart des testeurs ont besoin lorsque quelque chose ne va pas. Cliquez Effectuer des contrôles 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.
  • INFORMATIONS 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.
  • AVERTIR 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 de blocage. Lorsque les contrôles de santé connaissent 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. WARN ou FAIL affiche une bannière non bloquante de vérification et de correction qui nomme chaque problème.

  • 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.
  • Auto-arm 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, Auto-arm ne peut continuer que si les autres conditions sont remplies.
Support → Health affiche PASS pour un nœud event pris en charge, WARN avec Fix pour une règle udev obsolète et FAIL pour le périphérique physique. Support → Health affiche PASS pour un nœud event pris en charge, WARN avec Fix pour une règle udev obsolète et FAIL pour le périphérique physique.
Figure 2. Support → Health affiche PASS pour un nœud event pris en charge, WARN avec Fix pour une règle udev obsolète et FAIL 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 Hardware pour les paramètres de périphérique physique persistants. Ouvrir le guide du matériel.

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

Comment les vérifications sont disposées

Chaque ligne de contrôle comporte quatre parties :

  • Statut — PASS (vert), INFO (bleu), WARN (orange), FAIL (rouge), READY / CHECKING (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 la règle udev, Utiliser le port :5111, Corriger….

Les vérifications

Appareil

Confirme qu'un manche à retour de force pris en charge est visible par le système d'exploitation et que le pont peut l'ouvrir en exclusivité. É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

Health checks vérifie que /etc/udev/rules.d/99-ffb-bridge.rules couvre toutes les lignes d’entrée actuelles des appareils pris en charge et les autorisations TTY MOZA. Fix présente la règle canonique gérée, l’installe avec pkexec, recharge udev et déclenche les appareils d’entrée et TTY. Un joystick non répertorié connecté et activé explicitement est ajouté pendant l’installation.

Une règle plus ancienne est signalée comme WARN lorsqu’elle n’a pas l’autorisation actuelle de l’appareil, comme les lignes TTY MOZA ou l’accès hidraw inscriptible dont le chemin du protocole de force Logitech G940 a besoin. Utilisez Fix même si le fichier existe déjà ; l’application le remplace par la règle complète générée.

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; Redémarrer 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; Redémarrer 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; Redémarrer 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; Redémarrer plus tard est sans risque si vous devez d'abord continuer.
Exception NixOS

Les contrôles de santé détectent 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

SimConnect est le chemin MSFS, cette vérification s'exécute donc sous Windows et Linux. Il recherche les MSFS SimConnect.xml à l'emplacement approprié à la plate-forme, 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 Corriger… 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 sur Linux, un processus dans un espace de noms utilisateur ne peut pas lier les ports inférieurs à 1024 ; le pont installe et utilise donc une entrée parallèle sur un port non privilégié (5111 par défaut) que MSFS sous 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 SimConnect

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 une dataref en réponse. Cartographie à 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 ».

Durée d'exécution

Vérifie que la boucle de contrôle tourne à sa cible de 50 Hz. Avertit si la moyenne des 60 dernières secondes descend sous 45 Hz.

Journal des incidents

S'il existe un journal de plantage de la dernière session, la ligne devient orange et propose Révéler pour y accéder dans votre gestionnaire de fichiers, et Envoyer via le formulaire de commentaires qui pré-remplit une soumission de commentaires avec le journal joint.

Boîte de dialogue Corriger

Corriger… les boutons n'appliquent pas directement les modifications - 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.

Correction de la boîte de dialogue pour l'installation de la configuration SimConnect. L'extrait XML exact à ajouter est affiché, ainsi qu'un aperçu du fichier résultant. Correction de la boîte de dialogue 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. Correction de la boîte de dialogue 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 apparaît pour gparted ou une interface graphique de gestionnaire de paquets. Codes de sortie Les contrôles de santé interprètent :

QuitterSignificationRapports de contrôle de santé
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 interface graphique, sway sans agent polkit) fonctionne très bien — vous ne pourrez 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 des contrôles de santé. 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. Settings → Session détermine le simulateur que Bridge sélectionnera au prochain démarrage.