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). Actualmente, el puente está codificado para este dispositivo específico.
  • 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 (versión 1809 o posterior) o cualquier distribución moderna de Linux con evdev – que es esencialmente todas las distribuciones de escritorio convencionales.

ventanas Instalador

Descarga

Después de registrarse en el pagina de inicio, le enviamos por correo electrónico un enlace de descarga tokenizado. Haga clic en el enlace del instalador de Windows para guardar 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 a través de las dos páginas. La ubicación de instalación predeterminada es %LOCALAPPDATA%\Programs\FfbBridge — una instalación por usuario, no se requiere permiso de administrador.
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 aterriza en el grupo de programas FFB-Bridge. También puede iniciar directamente desde %LOCALAPPDATA%\Programs\FfbBridge\FfbBridge.Desktop.exe.

Atención: antivirus

Algunos productos antivirus marcan archivos binarios sin firmar. Si el suyo pone en cuarentena al instalador directamente (en lugar de simplemente advertir), envíe por correo electrónico la muestra marcada a feedback·ffb-bridge.com (reemplace el · con una @) para que podamos investigar.

Desinstalar

Abierto Aplicaciones y características en Configuración de Windows, busque FFB-Bridgey elige Desinstalar. Tus perfiles y preferencias en %APPDATA%\ffb-bridge se dejan en su lugar para que una reinstalación los recupere nuevamente; retire esa carpeta a mano si desea hacer borrón y cuenta nueva.

linux Imagen de aplicación

Descarga

El mismo flujo de registro que Windows: haga clic en el enlace de Linux en el correo electrónico y obtendrá FfbBridge-x86_64.AppImage (about 40 MB).

Hazlo ejecutable e instálalo.

AppImages necesita que el bit ejecutable esté configurado y, en la mayoría de las distribuciones, debe estar registrado en el menú de la aplicación para que el iniciador del escritorio los seleccione. el incluido install.sh el guión hace ambas cosas; la forma larga es:

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

el --install flag registers a .desktop archivo e icono en sus directorios de datos XDG. Después de eso, un 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. La entrada del menú instalado en KDE Plasma. GNOME, Xfce y otros entornos compatibles con XDG lo utilizan de manera idéntica.

regla udev (recomendado)

Fuera de la caja, sólo el usuario cuya sesión de inicio de sesión posee el joystick puede abrir su /dev/input/eventN nodo. Para que el puente siga funcionando después de un cambio rápido de usuario, o simplemente para evitar mensajes de polkit en algunas distribuciones, el 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 lee las reglas de udev desde la configuración del sistema, no /etc/udev/rules.d. Añade el equivalente a tu configuration.nix:

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

Then sudo nixos-rebuild switch y vuelva a enchufar la palanca.

Desinstalar

Either delete ~/Applications/FfbBridge-x86_64.AppImage y ejecute el desinstalador incluido, o ejecute AppImage con el --uninstall para invertir el registro del menú/icono automáticamente. Perfiles y preferencias en ~/.config/ffb-bridge se guardan para una reinstalación posterior.

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.