Documentation en version bêta. Certains textes et images seront retravaillés au fur et à mesure que l'application s'installera dans la version 1.0. Si une section est obsolète, signalez-la via le formulaire de commentaires.

Installer FFB-Bridge

FFB-Bridge est livré sous la forme d'un programme d'installation Windows autonome et d'une AppImage Linux. Les deux regroupent le runtime .NET 10. Il n'y a pas de pilote à télécharger ; votre SideWinder Force Feedback 2 fonctionne déjà au niveau HID sur n'importe quel noyau Windows ou Linux moderne.

Avant de commencer

Vous aurez besoin de :

  • A Microsoft SideWinder Force Feedback 2 joystick (USB VID 045E, PID 001B). Le pont est actuellement codé en dur sur cette clé spécifique.
  • Un simulateur pris en charge : Microsoft Flight Simulator 2024, X-Plane 11 ou X-Plane 12. MSFS 2020 n'a pas été testé. DCS, Prepar3D et les simulateurs de vol antérieurs ne sont pas pris en charge.
  • Windows 10 (version 1809 ou ultérieure) ou toute distribution Linux moderne avec evdev – qui correspond essentiellement à toutes les distributions de bureau grand public.

Fenêtres 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 (about 34 MB).

Exécutez le programme d'installation

Double-cliquez sur le programme d'installation. Vous verrez une ou deux invites :

  1. SmartScreen « Application non reconnue ». Le programme d'installation n'est pas encore signé par code - la signature est sur la feuille de route 1.0. Cliquez Plus d'informations, alors Courez quand même.
  2. 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 bloque complètement les applications non signées

Si vous êtes sous Windows 11 avec Contrôle intelligent des applications (SAC) activé en mode actif, le programme d'installation ne se lance tout simplement pas : pas d'invite SmartScreen, pas d'option « Exécuter quand même », rien ne se passe. SAC refuse toute application sans signature de signature de code fiable, et les versions bêta ne sont pas encore signées.

La seule façon de contourner ce problème aujourd’hui est de désactiver Smart App Control suffisamment longtemps pour l’installer. Les propres conseils de Microsoft couvrent le flux (y compris comment le basculer via 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 le contrôle intelligent des applications

Bonne nouvelle par rapport aux premiers Windows 11 : les mises à jour cumulatives récentes vous permettent de réactiver SAC à partir de l'application de sécurité Windows une fois l'installation terminée. Microsoft exigeait auparavant une réinstallation complète de Windows, mais cette restriction a disparu. L'application FFB-Bridge elle-même continuera à fonctionner normalement après le redémarrage de SAC ; SAC vérifie uniquement au lancement les applications qu'il n'a jamais vues auparavant.

Les installateurs signés par code figurent sur la feuille de route 1.0 et supprimeront entièrement cette étape.

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 non signés. Si le vôtre met carrément l'installateur en quarantaine (plutôt qu'un simple avertissement), veuillez envoyer l'échantillon signalé à feedback·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 Windows : cliquez sur le lien Linux dans le courriel et vous obtiendrez FfbBridge-x86_64.AppImage (about 40 MB).

Rendez-le exécutable et installez-le

AppImages a besoin que le bit exécutable soit défini et, sur la plupart des distributions, soit enregistré dans le menu de l'application afin que le lanceur de bureau les récupère. Le inclus install.sh le script fait les deux ; la forme longue est :

chmod +x FfbBridge-x86_64.AppImage
mkdir -p ~/Applications
mv FfbBridge-x86_64.AppImage ~/Applications/
~/Applications/FfbBridge-x86_64.AppImage --install

Le --install flag registers a .desktop fichier et icône dans vos répertoires de données XDG. Après ça, un FFB-Bridge L'entrée apparaît 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 de manière identique.

règle udev (recommandée)

Dès la sortie de la boîte, seul l'utilisateur dont la session de connexion possède le joystick 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 Docteur La page propose une installation en un clic de la règle udev suivante :

# /etc/udev/rules.d/99-ffb-bridge.rules
SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", 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"
'';

Then sudo nixos-rebuild switch et rebranchez le stick.

Désinstallation

Either delete ~/Applications/FfbBridge-x86_64.AppImage et exécutez le programme de désinstallation fourni, ou exécutez AppImage avec le --uninstall drapeau pour inverser automatiquement l’enregistrement du menu/icône. Profils et préférences sous ~/.config/ffb-bridge sont conservés pour une réinstallation ultérieure.

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.