Documentación de la versión actual FFB-Bridge 1.6.0 ¿Has encontrado algo desactualizado? Cuéntanoslo en el formulario de comentarios.

Instalar FFB-Bridge

FFB-Bridge se envía como un instalador de Windows autónomo, una AppImage de Linux y un DMG de macOS (Apple Silicon). Los tres incluyen el tiempo de ejecución .NET 10. No es necesario descargar ningún controlador para los joysticks con Force Feedback USB compatibles en Windows, Linux o macOS modernos.

Antes de empezar

Necesitará:

  • El hardware compatible incluye MOZA AB6, AB9, AY90, AY210; Microsoft SideWinder Force Feedback 2; Logitech G940, Force 3D Pro y WingMan Force 3D; dispositivos Brunner DirectX compatibles; y determinados adaptadores de SideWinder Force Feedback Pro. Las capacidades y las pruebas físicas disponibles varían según el modelo y la plataforma. Consulte la guía de hardware antes de dar por validada una función concreta. Los joysticks no incluidos que cumplen los requisitos necesitan activar expresamente la compatibilidad experimental. página de hardware.
  • Un simulador compatible: Microsoft Flight Simulator 2024, Microsoft Flight Simulator 2020, X-Plane 11 o X-Plane 12. DCS, Prepar3D y simuladores de vuelo anteriores no son compatibles. En macOS, solo se admite X-Plane — MSFS se conecta solo en Windows y Linux.
  • Uno de:
    • Windows 10 (versión 1809 o posterior) o Windows 11.
    • Cualquier distribución moderna de Linux con evdev – que es esencialmente todas las distribuciones de escritorio convencionales.
    • macOS en Apple Silicon (M1 o posterior), con X-Plane y un dispositivo compatible. Los Mac con Intel no son compatibles. Consulte la guía de hardware para conocer las pruebas y limitaciones de cada modelo.
Actualizaciones automáticas

Windows y las instalaciones empaquetadas de Linux AppImage pueden descargarse, verificarse, instalarse y reiniciarse después de su aprobación. macOS comprueba automáticamente y abre la descarga firmada.

Windows Instalador

Descarga

Después de registrarse en el página de inicio, le enviamos por correo electrónico un enlace de descarga tokenizado. Haga clic en el enlace del instalador de Windows para guardar ffb-bridge-setup-1.6.0-x64.exe (54 MB)

Ejecute el instalador

Haga doble clic en el instalador. Verá el asistente de configuración de Inno y Windows también puede mostrar un mensaje de reputación de SmartScreen en compilaciones firmadas nuevas:

  1. Verificación del editor. El instalador de Windows está firmado en código por la identidad del editor Rohsam. Antes de continuar, confirme que Windows muestra Rohsam Inc. o Rohsam Inc. como editor.
  2. Mensaje de reputación de SmartScreen. Es posible que las nuevas compilaciones firmadas aún se marquen como no reconocidas hasta que ese archivo exacto obtenga el historial de descargas. Si la fuente es FFB-Bridge.com, el hash coincide y el editor es Rohsam, haga clic en Más información, entonces Ejecutar de todos modos.
  3. Idioma del instalador. El instalador pide primero el idioma en que se mostrará y preselecciona el idioma de visualización de Windows. Todas las pantallas del instalador están disponibles en los dieciséis idiomas de interfaz de la aplicación, incluido el francés de Canadá. La licencia y los avisos de terceros conservan su idioma original.
  4. 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\ffb-bridge — una instalación por usuario, no se requiere permiso de administrador.
Windows 11 Control inteligente de aplicaciones y nuevas compilaciones firmadas

Si estás en Windows 11 con Control inteligente de aplicaciones (SAC) habilitado en modo Activo, Windows aún puede bloquear una compilación firmada nueva mientras la reputación se pone al día. La firma del código prueba la identidad del editor de Rohsam; no garantiza que cada nuevo hash de archivo tenga reputación SmartScreen o SAC desde el primer día.

La propia guía de Microsoft cubre el comportamiento de Smart App Control y dónde revisar su configuración (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

Si SAC bloquea directamente una nueva compilación en su máquina, espere a que la compilación acumule reputación o use otro dispositivo Windows donde pueda verificar la firma Rohsam y tomar una decisión informada.

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\ffb-bridge\FfbBridge.Desktop.exe.

Atención: antivirus

Algunos productos antivirus señalan archivos binarios nuevos o de baja reputación. Si el suyo pone en cuarentena al instalador directamente (en lugar de simplemente advertir), envíe por correo electrónico la muestra marcada a support·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. 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 AppImage

Descarga

El mismo flujo de registro que Windows: haga clic en el enlace de Linux en el correo electrónico y obtendrá una AppImage versionada como FfbBridge-1.6.0-x86_64.AppImage.

Hágalo ejecutable e instálelo.

AppImages necesita el bit ejecutable configurado antes de que Linux los ejecute. Después de eso, AppImage de FFB-Bridge puede instalarse en los directorios de escritorio XDG de su usuario:

chmod +x 'FfbBridge-1.6.0-x86_64.AppImage' && ./'FfbBridge-1.6.0-x86_64.AppImage' --install

el --install el indicador copia la AppImage a ~/Applications, escribe un .desktop lanzador, instala el ícono incluido y actualiza los cachés del escritorio cuando esas herramientas auxiliares están disponibles. Después de eso, un FFB-Bridge La entrada debería aparecer 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 seleccionan después del paso de instalación de AppImage.

regla udev (recomendado)

Linux necesita permisos para el nodo /dev/input/event* seleccionado y para el canal TTY de políticas de firmware que usan las bases MOZA compatibles, así como para las interfaces hidraw que usan el Logitech G940 y las bases Brunner. Soporte → Comprobaciones de estado muestra la regla canónica para dispositivos compatibles y puede instalarla mediante una solicitud de polkit. Si hay un joystick no catalogado apto, conectado y habilitado de forma explícita, su línea de entrada se añade durante la instalación.

# /etc/udev/rules.d/71-ffb-bridge.rules
SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
SUBSYSTEM=="hidraw", 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}=="cafe", ATTRS{idProduct}=="4004", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="204e", 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}=="346e", ATTRS{idProduct}=="1003", TAG+="uaccess"
SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1003", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="00d2", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="0120", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="0121", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="00ca", TAG+="uaccess"
# Brunner CAN-over-HID vendor interface (USB interface 1), any grip and USB mode.
SUBSYSTEM=="hidraw", KERNEL=="hidraw*", ATTRS{modalias}=="usb:v25BBp*in01", TAG+="uaccess"
# G940 signed 10-bit stick axes; preserve other calibration fields.
ACTION!="remove", SUBSYSTEM=="input", KERNEL=="event*", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", ENV{EVDEV_ABS_00}="-512:511", ENV{EVDEV_ABS_01}="-512:511", RUN{builtin}+="keyboard"
Una regla existente también puede estar desactualizada

Se informa una regla antigua como AVISO cuando carece de un permiso de dispositivo actual, como las líneas TTY del MOZA o el acceso a hidraw que usan el Logitech G940 y las bases Brunner, o cuando su nombre de archivo hace que se ejecute demasiado tarde para el acceso de la sesión de escritorio, como ocurría con el antiguo 99-ffb-bridge.rules. Use Corregir… incluso si el archivo ya existe; la aplicación instala la regla completa generada como 71-ffb-bridge.rules y elimina el archivo antiguo.

Tras una reparación correcta, la regla queda activa y la aplicación recomienda reiniciar. «Reiniciar ahora» vuelve a abrir el joystick con los permisos nuevos y descarta cualquier modo alternativo del inicio; elegir «Reiniciaré más tarde» es seguro si necesita continuar primero.

El diálogo de corrección de Linux muestra la regla canónica de entrada y TTY de MOZA para dispositivos compatibles antes de solicitar permiso. Durante la instalación se añade cualquier joystick no catalogado que esté conectado y habilitado de forma explícita. El diálogo de corrección de Linux muestra la regla canónica de entrada y TTY de MOZA para dispositivos compatibles antes de solicitar permiso. Durante la instalación se añade cualquier joystick no catalogado que esté conectado y habilitado de forma explícita.
Figure 2. El diálogo de corrección de Linux muestra la regla canónica de entrada y TTY de MOZA para dispositivos compatibles antes de solicitar permiso. Durante la instalación se añade cualquier joystick no catalogado que esté conectado y habilitado de forma explícita.
Tras una reparación correcta, la regla queda activa y la aplicación recomienda reiniciar. «Reiniciar ahora» vuelve a abrir el joystick con los permisos nuevos y descarta cualquier modo alternativo del inicio; elegir «Reiniciaré más tarde» es seguro si necesita continuar primero. Tras una reparación correcta, la regla queda activa y la aplicación recomienda reiniciar. «Reiniciar ahora» vuelve a abrir el joystick con los permisos nuevos y descarta cualquier modo alternativo del inicio; elegir «Reiniciaré más tarde» es seguro si necesita continuar primero.
Figure 3. Tras una reparación correcta, la regla queda activa y la aplicación recomienda reiniciar. «Reiniciar ahora» vuelve a abrir el joystick con los permisos nuevos y descarta cualquier modo alternativo del inicio; elegir «Reiniciaré más tarde» es seguro si necesita continuar primero.
NixOS

NixOS lee las reglas de udev desde la configuración del sistema. Ignora los archivos colocados directamente en /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"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
  SUBSYSTEM=="hidraw", 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}=="cafe", ATTRS{idProduct}=="4004", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="204e", 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}=="346e", ATTRS{idProduct}=="1003", TAG+="uaccess"
  SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1003", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
  SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="00d2", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="0120", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="0121", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="00ca", TAG+="uaccess"
  # Brunner CAN-over-HID vendor interface (USB interface 1), any grip and USB mode.
  SUBSYSTEM=="hidraw", KERNEL=="hidraw*", ATTRS{modalias}=="usb:v25BBp*in01", TAG+="uaccess"
  # G940 signed 10-bit stick axes; preserve other calibration fields.
  ACTION!="remove", SUBSYSTEM=="input", KERNEL=="event*", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", ENV{EVDEV_ABS_00}="-512:511", ENV{EVDEV_ABS_01}="-512:511", RUN{builtin}+="keyboard"
'';

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

Desinstalar

Ejecute la AppImage instalada con --uninstall para eliminar el iniciador y los íconos, luego elimine AppImage de ~/Applications si ya no lo desea. Perfiles y preferencias en ~/.config/ffb-bridge se guardan para una reinstalación posterior.

macOS DMG (Apple Silicon)

La versión para macOS se conecta a X-Plane. Funciona en Apple Silicon (M1 o más reciente) y se conecta a X-Plano 12 con hardware compatible con Force Feedback. Consulte la guía de hardware para conocer los dispositivos y funciones cubiertos. La distribución firmada y notarizada utiliza el formato .dmg, por lo que Gatekeeper lo acepta sin la solución alternativa "Abrir" con el botón derecho del ratón.

Descargar e instalar

Utilice el mismo flujo de registro que las otras plataformas: haga clic en el enlace de macOS en el correo electrónico para descargar un DMG versionado, como FfbBridge-1.6.0-arm64.dmg. Entonces:

  1. Haga doble clic en el DMG para montarlo. Se abre una ventana que muestra el FFB-Bridge aplicación y un Aplicaciones atajo.
  2. Arrastrar FFB-Bridge sobre el Aplicaciones acceso directo para instalarlo.
  3. Expulse el DMG, luego inicie FFB-Bridge desde Launchpad o la carpeta Aplicaciones.

Debido a que la compilación está certificada por el ID de desarrollador de Rohsam Inc., macOS la verifica en el primer inicio a través de la red y la abre normalmente. Si su Mac está desconectado la primera vez que lo inicia, conéctese a Internet para que Gatekeeper pueda completar su verificación.

Desinstalar

Arrastrar FFB-Bridge de Aplicaciones a la Papelera. Perfiles y preferencias en ~/.config/ffb-bridge se dejan en su lugar para una reinstalación posterior; retire esa carpeta a mano para hacer borrón y cuenta nueva.

Verificando la instalación

Inicie FFB-Bridge. Confirme el aviso de seguridad y complete las comprobaciones de inicio; después siga la orientación 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.