Documentation de la version actuelle FFB-Bridge 1.4.0 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.

Page d'assistance. L'onglet Contrôles de santé par défaut affiche une ligne par sonde, avec l'état PASS / INFO / WARN / FAIL et des boutons d'action contextuels lorsqu'un correctif est disponible. Page d'assistance. L'onglet Contrôles de santé par défaut affiche une ligne par sonde, avec l'état PASS / INFO / WARN / FAIL et des boutons d'action contextuels lorsqu'un correctif est disponible.
Figure 1. Page d'assistance. L'onglet Contrôles de santé par défaut affiche une ligne par sonde, avec l'état PASS / INFO / WARN / FAIL et des boutons d'action contextuels lorsqu'un correctif est disponible.

Bande d'onglets

La page Support s'ouvre sur le Ressources Onglet — documents + liens manuels + la rediffusion de la visite de bienvenue est là comme un premier atterrissage convivial. Les deux autres onglets sont accessibles en un clic :

  • Ressources (s'ouvre en premier) — liens vers les documents et le manuel hébergés ici, ainsi que la rediffusion de la visite de bienvenue et les pages éditeur/juridiques.
  • 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 ancienne règle limitée aux événements est signalée WARN, car elle ne contient pas les autorisations TTY MOZA actuelles. Utiliser 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

Le chemin X-Plane fonctionne sur toutes les plates-formes – et sur macOS (Apple Silicon), X-Plane 12 avec un SideWinder FFB2 est la combinaison prise en charge. Ce contrôle envoie une petite 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.