Documentación en beta. Algunos textos e imágenes se modificarán a medida que la aplicación se instale en la versión 1.0. Si una sección se lee obsoleta, márquela mediante el formulario de comentarios.

Instalar FFB-Bridge

FFB-Bridge se envía como un instalador de Windows autónomo y una AppImage de Linux. Ambos incluyen el tiempo de ejecución .NET 10. No es necesario descargar ningún controlador; Su SideWinder Force Feedback 2 ya funciona en el nivel HID en cualquier kernel moderno de Windows o Linux.

Antes de empezar

Necesitarás:

  • A Microsoft SideWinder Force Feedback 2 joystick (USB VID 045E, PID 001B). The bridge is currently hardcoded to this specific stick.
  • Un simulador compatible: Microsoft Flight Simulator 2024, X-Plane 11 o X-Plane 12. MSFS 2020 no está probado. DCS, Prepar3D y simuladores de vuelo anteriores no son compatibles.
  • Windows 10 (version 1809 or newer) or any modern Linux distribution with evdev — which is essentially every mainstream desktop distro.

ventanas Instalador

Descarga

Después de registrarse en el pagina de inicio, we email you a tokenised download link. Click the Windows installer link to save FfbBridge-Setup-x64.exe (about 34 MB).

Ejecute el instalador

Haga doble clic en el instalador. Verás uno o dos mensajes:

  1. SmartScreen “Aplicación no reconocida”. El instalador aún no tiene el código firmado; la firma está en la hoja de ruta 1.0. Haga clic Más información, entonces Corre de todos modos.
  2. Asistente de configuración de Inno Setup. Haga clic Siguiente through the two pages. The default install location is %LOCALAPPDATA%\Programs\FfbBridge — a per-user install, no administrator permission required.
ventanas 11 Smart App Control bloquea completamente las aplicaciones no firmadas

Si estás en Windows 11 con Control inteligente de aplicaciones (SAC) habilitado en modo Activo, el instalador simplemente no se inicia: no hay mensaje de SmartScreen, no hay opción "Ejecutar de todos modos", simplemente no sucede nada. SAC rechaza cualquier aplicación sin una firma de código confiable y las versiones beta aún no están firmadas.

La única forma de evitarlo hoy es desactivar Smart App Control el tiempo suficiente para instalarlo. La propia guía de Microsoft cubre el flujo (incluido cómo alternarlo a través de Configuración → Privacidad y seguridad → Seguridad de Windows → Control de aplicaciones y navegador → Configuración de Smart App Control):

Microsoft: preguntas frecuentes sobre Smart App Control

Buenas noticias frente a las primeras versiones de Windows 11: Las actualizaciones acumulativas recientes le permiten volver a habilitar SAC desde la aplicación de seguridad de Windows una vez finalizada la instalación; Microsoft solía exigir una reinstalación completa de Windows, pero esa restricción ya no existe. La aplicación FFB-Bridge seguirá funcionando normalmente después de que SAC se vuelva a activar; SAC solo busca en el inicio aplicaciones que no haya visto antes.

Los instaladores firmados con código están en la hoja de ruta 1.0 y eliminarán este paso por completo.

Lanzamiento

Un acceso directo al menú Inicio llamado FFB-Bridge lands in the FFB-Bridge program group. You can also launch directly from %LOCALAPPDATA%\Programs\FfbBridge\FfbBridge.Desktop.exe.

Atención: antivirus

Some antivirus products flag unsigned binaries. If yours quarantines the installer outright (rather than just warning), please email the flagged sample to feedback·ffb-bridge.com (replace the · with an @) so we can investigate.

Desinstalar

Abierto Aplicaciones y características en Configuración de Windows, busque FFB-Bridgey elige Desinstalar. Your profiles and preferences under %APPDATA%\ffb-bridge are left in place so a reinstall picks them up again; remove that folder by hand if you want a clean slate.

linux Imagen de aplicación

Descarga

Same signup flow as Windows — click the Linux link in the email and you'll get FfbBridge-x86_64.AppImage (about 40 MB).

Hazlo ejecutable e instálalo.

AppImages need the executable bit set and, on most distros, to be registered in the application menu so the desktop launcher picks them up. The included install.sh script does both; the long form is:

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

The --install flag registers a .desktop file and icon into your XDG data directories. After that, a FFB-Bridge La entrada aparece en el menú de su aplicación junto con otras aplicaciones GUI.

Entrada FFB-Bridge en el iniciador de aplicaciones KDE Plasma después de la instalación
Figure 1. The installed menu entry on KDE Plasma. GNOME, Xfce, and other XDG-compatible environments pick it up identically.

regla udev (recomendado)

Out of the box, only the user whose login session owns the joystick can open its /dev/input/eventN node. For the bridge to keep working after a fast-user-switch, or simply to avoid polkit prompts on some distributions, the medico La página ofrece una instalación con un solo clic de la siguiente regla udev:

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

NixOS reads udev rules from the system config, not /etc/udev/rules.d. Add the equivalent to your configuration.nix:

services.udev.extraRules = ''
  SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
'';

Then sudo nixos-rebuild switch and replug the stick.

Desinstalar

Either delete ~/Applications/FfbBridge-x86_64.AppImage and run the bundled uninstaller, or run the AppImage with the --uninstall flag to reverse the menu/icon registration automatically. Profiles and preferences under ~/.config/ffb-bridge are kept for a later reinstall.

Verificando la instalación

Inicie FFB-Bridge. Lo primero que debería ver es el cuadro de diálogo de bienvenida (cubierto en la siguiente sección). Si la aplicación no se inicia en absoluto o falla al iniciarse, vaya directamente a Solución de problemas.