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.

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 :

  • Un joystick à force feedback. Cinq familles de manches sont validées et fonctionnent en plug-and-play là où elles ont été testées : Microsoft SideWinder Force Feedback 2 (045E:001B), MOZA AB9 + MH16 (346E:1000 / 346E:1002, Windows, Linux, and macOS), Logitech Flight System G940 (046D:C287), Logitech Force 3D Pro (046D:C286), et Logitech WingMan Force 3D (046D:C283). D'autres joysticks à force feedback peuvent être activés à titre expérimental avec Paramètres → Matériel → « Autoriser les appareils non répertoriés »; les roues à retour de force, les manettes de jeu et les appareils à axe unique sont hors de portée et sont pointés vers le FFB Probe à la place. Voir le page Matériel pour l'histoire complète de la compatibilité.
  • 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 10 (version 1809 ou plus récente) ou 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). Le build macOS est limité à X-Plane 12 avec le SideWinder Force Feedback 2 et le MOZA AB9 + MH16; les Mac Intel ne sont pas pris en charge.

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 FfbBridge-Setup-x64.exe (environ 34 Mo).

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 (remplacez le · par un @) pour qu'on puisse enquêter.

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.0.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.0.0-x86_64.AppImage
./FfbBridge-1.0.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)

Dès l'installation, seul l'utilisateur dont la session de connexion possède le manche peut ouvrir son /dev/input/eventN nœud. Pour que le pont continue de fonctionner après un changement rapide d'utilisateur, ou simplement pour éviter les invites polkit sur certaines distributions, le Page Support (dans la barre latérale) propose une installation en un clic de la règle udev suivante pour chaque joystick USB pris en charge :

# /etc/udev/rules.d/99-ffb-bridge.rules
SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c286", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c283", TAG+="uaccess"
NixOS

NixOS lit les règles udev à partir de la configuration du système, pas /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}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c286", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c283", 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 nouvelle et étendue : elle s'exécute sur Apple Silicon (M1 ou plus récent) et se connecte à X-Plane 12 with the Microsoft SideWinder Force Feedback 2 and MOZA AB9 + MH16. It ships as a signed and notarized .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.1.1-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.