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

Installer FFB-Bridge

FFB-Bridge est livré sous la forme d'un programme d'installation Windows autonome, d'une AppImage Linux et d'un DMG macOS (Apple Silicon). Les trois regroupent le runtime .NET 10. Il n'y a aucun pilote à télécharger pour les manches à retour de force USB pris en charge sur Windows, Linux ou macOS modernes.

Avant de commencer

Vous aurez besoin de :

  • Validés sous Windows, Linux et macOS : les MOZA AB6, AB9 et AY210, le Microsoft SideWinder Force Feedback 2, les Logitech G940, Force 3D Pro et WingMan Force 3D, ainsi que le Brunner FFB-G. Les joysticks admissibles non répertoriés restent une option expérimentale sûre. page Matériel.
  • Un simulateur pris en charge : Microsoft Flight Simulator 2024, Microsoft Flight Simulator 2020, X-Plane 11 ou X-Plane 12. DCS, Prepar3D et les simulateurs de vol antérieurs ne sont pas pris en charge. Sur macOS, seul X-Plane est pris en charge — MSFS se connecte uniquement sous Windows et Linux.
  • L'un des :
    • Windows 11.
    • Toute distribution Linux moderne avec evdev – qui correspond essentiellement à toutes les distributions de bureau grand public.
    • macOS sur Apple Silicon (M1 ou plus récent). La version macOS est limitée à X-Plane 12 avec le SideWinder Force Feedback 2 et les bases MOZA AB6, AB9 et AY210 prises en charge; les Mac Intel ne sont pas pris en charge.
Mises à jour automatiques

Les installations Windows et Linux AppImage packagées peuvent être téléchargées, vérifiées, installées et redémarrées après votre approbation. macOS vérifie automatiquement et ouvre le téléchargement signé.

Windows Installateur

Télécharger

Après vous être inscrit sur le page d'accueil, nous vous envoyons par courriel un lien de téléchargement tokenisé. Cliquez sur le lien du programme d'installation Windows pour enregistrer ffb-bridge-setup-1.4.0-x64.exe .

Exécutez le programme d'installation

Double-cliquez sur le programme d'installation. Vous verrez l'assistant de configuration Inno, et Windows peut également afficher une invite de réputation SmartScreen sur les toutes nouvelles versions signées :

  1. Vérification de l'éditeur. Le programme d'installation Windows est signé par le code de l'identité de l'éditeur Rohsam. Avant de continuer, confirmez que Windows affiche Rohsam Inc. ou RohsamInc en tant qu'éditeur.
  2. Invite de réputation SmartScreen. Les nouvelles versions signées peuvent toujours être marquées comme non reconnues jusqu'à ce que ce fichier exact obtienne l'historique de téléchargement. Si la source est ffb-bridge.com, le hachage correspond et l'éditeur est Rohsam, cliquez sur Plus d'informations, alors Exécuter quand même.
  3. Assistant de configuration Inno Setup. Cliquez Suivant à travers les deux pages. L'emplacement d'installation par défaut est %LOCALAPPDATA%\Programs\FfbBridge - une installation par utilisateur, aucune autorisation d'administrateur requise.
Windows 11 Smart App Control et nouvelles versions signées

Si vous êtes sous Windows 11 avec Contrôle intelligent des applications (SAC) activé en mode actif, Windows peut toujours bloquer une toute nouvelle version signée pendant que la réputation rattrape son retard. La signature du code prouve l'identité de l'éditeur Rohsam ; cela ne garantit pas que chaque nouveau hachage de fichier aura une réputation SmartScreen ou SAC dès le premier jour.

Les propres conseils de Microsoft couvrent le comportement de Smart App Control et l'endroit où consulter ses paramètres (Paramètres → Confidentialité et sécurité → Sécurité Windows → Contrôle des applications et du navigateur → Paramètres de Smart App Control):

Microsoft : Questions fréquemment posées sur Smart App Control

Si SAC bloque complètement une nouvelle version sur votre ordinateur, attendez que la version accumule de la réputation ou utilisez un autre appareil Windows sur lequel vous pourrez vérifier la signature Rohsam et faire un choix éclairé.

Lancement

Un raccourci du menu Démarrer nommé FFB-Bridge débarque dans le groupe programme FFB-Bridge. Vous pouvez aussi lancer directement à partir de %LOCALAPPDATA%\Programs\FfbBridge\FfbBridge.Desktop.exe.

Attention : antivirus

Certains produits antivirus signalent les binaires nouveaux ou de mauvaise réputation. Si le vôtre met carrément l'installateur en quarantaine (plutôt qu'un simple avertissement), veuillez envoyer l'échantillon signalé à support·ffb-bridge.com (replace the · with an @) so we can investigate.

Désinstallation

Ouvert Applications et fonctionnalités dans les paramètres Windows, recherchez FFB-Bridge, et choisissez Désinstaller. Vos profils et préférences sous %APPDATA%\ffb-bridge sont laissés en place donc une réinstallation les récupère ; supprimez ce dossier à la main si vous voulez une table rase.

Linux AppImage

Télécharger

Même processus d'inscription que sous Windows — cliquez sur le lien Linux dans le courriel et vous obtiendrez une AppImage versionnée telle que FfbBridge-1.4.0-x86_64.AppImage.

Rendez-le exécutable et installez-le

Les AppImage ont besoin que le bit exécutable soit activé avant que Linux ne les exécute. Après cela, l'AppImage de FFB-Bridge peut s'installer dans vos répertoires de bureau XDG définis par l'utilisateur :

chmod +x FfbBridge-1.4.0-x86_64.AppImage && ./FfbBridge-1.4.0-x86_64.AppImage --install

Le --install l'indicateur copie l'AppImage dans ~/Applications, écrit un .desktop lanceur, installe l'icône fournie et actualise les caches du bureau lorsque ces outils d'assistance sont disponibles. Après cela, un FFB-Bridge L'entrée devrait apparaître dans le menu de votre application aux côtés d'autres applications GUI.

Entrée FFB-Bridge dans le lanceur d'applications KDE Plasma après l'installation
Figure 1. L'entrée de menu installée sur KDE Plasma. GNOME, Xfce et d'autres environnements compatibles XDG le récupèrent après l'étape AppImage --install.

règle udev (recommandée)

Linux exige des autorisations pour le nœud /dev/input/event* sélectionné ainsi que pour le canal TTY de politique du micrologiciel utilisé par les bases MOZA prises en charge. Support → Health checks présente la règle canonique des appareils pris en charge et peut l’installer après une demande polkit. Si un joystick admissible non répertorié est activé explicitement et connecté, sa ligne d’entrée est ajoutée pendant l’installation.

# /etc/udev/rules.d/99-ffb-bridge.rules
SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c2a8", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c286", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c283", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess"
SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess"
SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1001", TAG+="uaccess"
SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1001", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="00d2", TAG+="uaccess"
Une règle existante peut tout de même être obsolète

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 2. 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 3. 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.
NixOS

NixOS lit les règles udev à partir de la configuration du système. Il ignore les fichiers placés directement dans /etc/udev/rules.d. Ajoutez l'équivalent à votre configuration.nix:

services.udev.extraRules = ''
  SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c2a8", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c286", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c283", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess"
  SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess"
  SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1001", TAG+="uaccess"
  SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1001", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
  SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="00d2", TAG+="uaccess"
'';

Puis sudo nixos-rebuild switch et rebranchez le manche.

Désinstallation

Exécutez l'AppImage installée avec --uninstall pour supprimer le lanceur et les icônes, puis supprimez l'AppImage de ~/Applications si vous n'en voulez plus. Profils et préférences sous ~/.config/ffb-bridge sont conservés pour une réinstallation ultérieure.

macOS DMG (Apple Silicon)

La version macOS est limitée à X-Plane 12. Elle fonctionne sur Apple Silicon (M1 ou plus récent) et se connecte à X-Plane 12 avec le Microsoft SideWinder Force Feedback 2 et les bases MOZA AB6, AB9 et AY210 prises en charge. Elle est distribuée sous forme de fichier signé et notarié .dmg, donc Gatekeeper l'accepte sans la solution de contournement « Ouvrir » par clic droit.

Télécharger et installer

Utilisez le même processus d'inscription que les autres plates-formes : cliquez sur le lien macOS dans le courriel pour télécharger un DMG versionné tel que FfbBridge-1.4.0-arm64.dmg. Ensuite :

  1. Double-cliquez sur le DMG pour le monter. Une fenêtre s'ouvre montrant le FFB-Bridge une application et un Applications raccourci.
  2. Faites glisser FFB-Bridge sur le Applications raccourci pour l'installer.
  3. Éjectez le DMG, puis lancez FFB-Bridge depuis le Launchpad ou le dossier Applications.

Étant donné que la version est notariée par l'identifiant de développeur de Rohsam Inc., macOS la vérifie au premier lancement sur le réseau et l'ouvre normalement. Si votre Mac est hors ligne au premier lancement, connectez-vous à Internet pour que Gatekeeper puisse terminer sa vérification.

Désinstallation

Faites glisser FFB-Bridge de Applications à la Corbeille. Profils et préférences sous ~/.config/ffb-bridge sont laissés en place pour une réinstallation ultérieure ; supprimez ce dossier à la main pour une table rase.

Vérification de l'installation

Lancez FFB-Bridge. La première chose que vous devriez voir est la boîte de dialogue de bienvenue (abordé dans la section suivante). Si l'application ne démarre pas du tout ou plante au lancement, passez directement à Dépannage.