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 désuète, signalez-la avec le formulaire de commentaires.

Page Support

La page Support (étiquetée Support dans la barre latérale) est le foyer unique pour tout ce que vous ouvrez en cas de problème, lorsque vous avez besoin d'une référence ou lorsque vous souhaitez exporter un ensemble de support pour le développeur. Trois onglets : Ressources, Vérifications de santé, et Diagnostics. Les contrôles de compatibilité matérielle qui se trouvaient ici ont été déplacés vers Paramètres → Matériel.

Page Support. L'onglet Vérifications 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 Support. L'onglet Vérifications 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 Support. L'onglet Vérifications 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 santé — la surface de tri quotidienne (appareil, règle udev sous Linux, accessibilité de la simulation, é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 de l'ensemble de support en un clic. Documenté séparément sur le Onglet Diagnostics page.

Compatibilité matérielle (test d'axe avec inversion + pitch/roll swap, rendu des effets, backend des appareils Windows, sélecteur de périphériques et Tester les effets du matériel sonde) n'est plus un onglet Support — il vit sur Paramètres → Matériel.

Onglet Bilans de santé

Les vérifications de santé 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ÉUSSITE 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 bloquant. Lorsque les vérifications 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ôles matériels déplacés vers Paramètres

Les contrôles de compatibilité matérielle étaient auparavant un onglet Support. Ils vivent désormais Paramètres → Matériel: le direct test d'axe (avec Inverser la polarité de l'axe et Permuter les axes tangage/roulis), le Rendu d'effet radio (effets matériels et mode de compatibilité logicielle), le backend du périphérique Windows, le sélecteur de périphérique pour plusieurs clés connectées, l'opt-in expérimental pour les périphériques non répertoriés et le Tester les effets du matériel sonde. Voir le Page de paramètres pour la procédure pas à pas complète.

Paramètres → Matériel — le test d'axe (inversion + échange tangage/roulis), le rendu des effets, le backend de périphérique Windows et la sonde Tester les effets matériels. Paramètres → Matériel — le test d'axe (inversion + échange tangage/roulis), le rendu des effets, le backend de périphérique Windows et la sonde Tester les effets matériels.
Figure 2. Paramètres → Matériel — le test d'axe (inversion + échange tangage/roulis), le rendu des effets, le backend de périphérique Windows et la sonde Tester les effets matériels.

Comment sont disposées les vérifications

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

Vérifie si /etc/udev/rules.d/99-ffb-bridge.rules est présent et correspond au contenu canonique. En cas d'absence, l'action est Installer la règle udev - cela déclenche un pkexec invite à écrire le fichier dans un emplacement privilégié.

Exception NixOS

Les vérifications 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 Installateur pour l'extrait.

WindowsLinux Configuration SimConnect

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

Durée d'exécution

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

Journal de plantage

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 rétroaction avec le journal joint.

Boîte de dialogue Corriger

Corriger… 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.

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 3. 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 s'affiche pour gparted ou une interface graphique de gestionnaire de paquets. Codes de sortie que les vérifications de santé interprètent :

QuitterSignificationRapports des vérifications 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 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 des contrôles de santé. Ou passez à Dépannage pour les symptômes courants et les solutions.