Dépannage

Symptômes d'abord, correctifs en dessous. Dans la plupart des cas, le Docteur La page sait déjà ce qui ne va pas – vérifiez-y avant de parcourir cette liste manuellement. Si rien ici ne vous aide, exportez un package de support depuis Diagnostic et ouvrir un rapport de commentaires.

Windows 11 L'application ne démarre pas du tout

Si le programme d'installation de Windows a fonctionné correctement mais en double-cliquant sur le FFB-Bridge le raccourci ne fait absolument rien – pas de fenêtre, pas d'erreur, pas d'invite SmartScreen – vous exécutez presque certainement Windows 11 avec Contrôle intelligent des applications (SAC) activé. SAC bloque silencieusement toute application qui n'est pas signée par un éditeur de confiance. Les versions bêta ne sont pas encore signées (c'est sur la feuille de route 1.0), donc SAC refuse de les lancer.

Le correctif consiste à désactiver Smart App Control suffisamment longtemps pour installer et exécuter l’application pour la première fois. Les mises à jour cumulatives récentes de Windows 11 vous permettent également de réactiver SAC par la suite sans réinstaller Windows – une amélioration par rapport aux versions précédentes où la désactivation était permanente. Les propres conseils de Microsoft :

Microsoft : Questions fréquemment posées sur le contrôle intelligent des applications

Une fois SAC désactivé, l'application FFB-Bridge se lance et, surtout, continue de lancer après avoir réactivé SAC – SAC vérifie uniquement les applications qu’il n’a jamais vues auparavant. La solution de contournement est donc unique. Une fois que les installateurs signés par code sont livrés avec la version 1.0, cette section disparaît.

Le bâton ne bouge pas du tout

Est-ce armé ?

La jauge ARM du cockpit dans la bande supérieure doit indiquer ARMÉ (dégradé ambre). S'il lit DÉSARMÉ (glyphe gris, bordure chaude), cliquez dessus et validez. S'il lit DEFAUT (rouge), voir « Stick fonctionnait, s'est soudainement arrêté » ci-dessous — un prérequis vient de tomber.

L'appareil est-il détecté ?

Le voyant DEVICE dans la bande supérieure doit être vert (« Prêt »). S'il est rouge ("Déconnecté") :

Débranchez et rebranchez le stick ; le pont le détecte à nouveau en une seconde ou deux.
Confirmez le VID/PID dans le gestionnaire de périphériques de votre système d'exploitation (045E / 001B).
Linux La ligne des règles udev du médecin doit être verte ; s'il est rouge, exécutez le programme d'installation en un clic.
Fenêtres Fermez toute autre application qui revendique un retour de force – testeurs DIY, certains utilitaires de diagnostic du joystick auront un accès exclusif.

Une carte SIM est-elle connectée ?

Le voyant SIM dans la bande supérieure doit être vert (« SimConnecté »). Sinon, consultez le Guide de configuration MSFS ou le Guide de configuration de X-Plane pour votre sim. En attendant, le Simulation de SimConnect La page vous permettra de confirmer que le reste du pipeline fonctionne.

MSFS se connecte mais aucune force ne se sent bien

Si le manche bouge mais que les forces semblent incorrectes, le problème est généralement une inadéquation du profil ou de la cellule :

Commencez par le démarreur intégré le plus proche de votre avion : Cessna 172 Skyhawk (G1000), Daher TBM 930, Beechcraft King Air 350i, Airbus A320neo ou Boeing 747-8 Intercontinental. La plupart des « mauvaises » sensations proviennent d’un profil adapté à une classe d’avion différente.
Vérifiez le panneau d'activité du stick du tableau de bord. Il sépare le ressort de base des canaux dynamiques tels que la charge sur l'axe, le grondement du moteur, le roulis au sol, les turbulences et les one-shots mécaniques. Si des effets auxquels vous ne vous attendiez pas s'affichent comme actifs, la simulation signale la télémétrie qui les pilote.
Les avions tiers ignorent parfois la mise en œuvre des SimVars standard. Le pont tolère cela (les variables manquantes sont par défaut à zéro), mais certains effets ne se déclencheront pas en conséquence. Il s'agit d'une limitation connue que nous ne pouvons pas contourner facilement sur la passerelle : signalez l'avion spécifique afin que nous puissions le caractériser.

L'icône de la barre d'état n'apparaît pas (Linux)

Certains environnements de bureau ne fournissent pas d'hôte de barre d'état système prêt à l'emploi – GNOME Wayland est le plus important. Lorsque le pont détecte cela, il affiche une bannière en haut de la fenêtre expliquant que la fermeture quittera directement l'application (au lieu de se cacher silencieusement) et que le bouton de fermeture se comporte en conséquence. Sur GNOME, installez l'extension AppIndicator Support pour récupérer une icône de barre d'état ; sur KDE, Xfce, Cinnamon, MATE et Budgie, le plateau fonctionne immédiatement.

Le médecin dit que SimConnect est accessible mais aucun flux de données

Le pont se connecte (TCP hello est accepté) mais le flux de données ne démarre pas. Sur MSFS 2024, cela signifie généralement que l'abonnement SimVar échoue, généralement parce que MSFS n'a pas encore fini de démarrer son serveur SimConnect interne. Attendez que MSFS atteigne le menu principal (pas seulement l'écran d'introduction) et réessayez.

X-Plane détecté mais aucun flux de données

Si le voyant SIM est passé brièvement au vert puis est revenu à « aucune carte SIM en cours d'exécution » sans que la télémétrie ne circule réellement, un pare-feu consomme généralement nos paquets UDP. Essayez :

Désactivez temporairement le pare-feu pour confirmer.
Liste blanche UDP 49000 sortant sur le processus de pont.

Fenêtres Crash peu de temps après l'armement ou le décollage

Problème pré-bêta.10. Les versions antérieures en mode matériel de Windows créaient une grande table d'effets DirectInput conservée : un effet physique pour chaque signal logique du simulateur. Sur certains Sidewinder FFB2 / Windows pid.dll piles, ce modèle d'appel pourrait s'écraser pendant le vol actif, souvent autour CreateEffect, SetPeriodic, or native ACCESS_VIOLATION chapelure. Il ne s'agit pas d'un problème MSFS ni d'un signe que le micrologiciel de votre clé est défectueux.

Fenêtres Les forces disparaissent après une pause MSFS ou un long bégaiement

La bêta.11 cible spécifiquement cette classe de bugs. Les pauses MSFS et Active Pause suppriment désormais immédiatement les effets dynamiques, tandis que le stick contient un ressort neutre par défaut. À la reprise, les paramètres du ressort DirectInput sont rechargés avant la relecture des effets afin que le centrage du tangage et du roulis soit rétabli.

Si la force de roulis semble toujours absente après la reprise sur la version bêta.11 ou ultérieure, exportez un ensemble de support immédiatement après l'avoir reproduit et décrivez si le tableau de bord affichait la charge de l'axe, le ressort de base ou les canaux dynamiques à ce moment-là. Cela nous indique si le pipeline est devenu silencieux ou si le pilote de périphérique a perdu un axe.

La bêta.10 corrige l'architecture : le mode matériel utilise désormais une constante vectorielle, un ressort à deux axes et un petit pool périodique paresseux au lieu d'une grande table conservée. Si vous voyez toujours ce message sur la version bêta.10 ou ultérieure, ouvrez Doctor → Compatibilité matérielle, exécutez Tester les effets du matériel, puis passez à Périodiques mixtes logiciels si le test échoue ou si le pont propose cette récupération au prochain lancement. Veuillez également envoyer un package de support afin que nous puissions caractériser la pile de pilotes restante.

Les effets continuent de jouer pendant environ 30 secondes après avoir quitté

Problème pré-bêta.9. Sur Win11 + le pilote FFB2, le nettoyage par effet du pont à la fermeture bloquait, sur cette pile, chaque appel pendant toute la durée de lecture du micrologiciel de l'effet - de sorte que les effets de grondement ou de buffet en vol ont épuisé leur minuterie naturelle d'environ 32 secondes après la fermeture du pont, laissant le stick actif de manière audible sur le bureau sans aucune application pour le piloter. Corrigé dans la version bêta.9 : le chemin d'arrêt ignore désormais entièrement le travail par effet et utilise deux commandes au niveau de l'appareil (arrêter tout + réinitialiser la table des effets du micrologiciel) qui reviennent immédiatement. Le même correctif s'applique en cas de crash natif via le gestionnaire d'exceptions vectorielles. Si vous constatez ce problème sur la version bêta.9 ou ultérieure, veuillez déposer un rapport de commentaires.

Fenêtres Crash en arrêtant de citer `0x80131506`

Problème pré-bêta.9. Sur une fraction des installations, le pont plantait avec une fenêtre contextuelle de rapport d'erreurs Windows citant coreclr.dll et code d'exception 0x80131506 au moment où vous avez cliqué sur Quitter ou fermé la fenêtre. Cause première : le thread de l'interface utilisateur et la boucle de contrôle du runtime appelaient tous deux DirectInput en même temps à l'arrêt, et le marshaller COM a finalement remarqué et détruit le processus. Corrigé dans la version bêta.9 : tous les accès DirectInput sont désormais sérialisés via un seul verrou à la limite du périphérique afin que les deux threads ne puissent jamais rivaliser avec le marshaller. Si vous voyez un 0x80131506 en quittant la version bêta.9 ou ultérieure, veuillez déposer un rapport de commentaires.

Crash au lancement

Flux de récupération au prochain lancement : si le lancement précédent s'est écrasé, le pont affiche une boîte de dialogue de rapport de crash au prochain démarrage, avec la trace de la pile et un Envoyer via le formulaire de commentaires bouton. Cliquez dessus ; le formulaire est pré-rempli avec le journal des incidents.

Si l'application plante avant que la boîte de dialogue n'apparaisse, vous aurez besoin directement du fichier journal des plantages :

Fenêtres %LOCALAPPDATA%\ffb-bridge\crashes\
Linux ~/.local/share/ffb-bridge/crashes/

Attach the most recent .log déposer dans un rapport de rétroaction.

Avertissements « Le pont ne peut pas suivre le rythme »

Les diagnostics avertissent lorsque le taux de la boucle de contrôle chute. Causes que nous avons vues :

Un autre processus sur le même cœur est l'éclatement du processeur : un onglet de navigateur, une compilation.
On Linux, a cpufreq le gouverneur ralentit le processeur. Passer à performance ou schedutil.
Fonctionnement dans un environnement virtualisé qui ne donne pas à l'invité des tranches de temps fiables de 20 ms.

Plusieurs sticks FFB2 branchés

Victoires des premiers trouvés : le pont récupère le premier VID/PID correspondant et le pilote. Une interface utilisateur pour lever l’ambiguïté est sur la liste ; pour l'instant, déconnectez physiquement tout sauf celui que vous voulez.

Toujours bloqué ?

Exporter un bundle de support depuis Diagnostic et ouvrir un rapport de commentaires. Le bundle contient le journal de session, le journal des crashs (le cas échéant), la sortie du docteur et les informations système - c'est exactement ce que nous devons reproduire sans vous envoyer de versions de test.