Traducción automática. Este sitio web ha sido traducido automáticamente y lamentamos cualquier error. La aplicación de escritorio FFB-Bridge está actualmente en inglés; Se puede agregar traducción de aplicaciones si hay suficiente demanda para un idioma en particular. Envíe correcciones o solicitudes de idioma a través de la página de comentarios.
Versión actual. FFB-Bridge v1.2.1 ya está disponible. Estos documentos siguen la app actual descrita por el manifiesto de versión. Si una sección parece obsoleta, avísanos mediante el formulario de comentarios.

Página de soporte

La página de soporte (etiquetada Soporte en la barra lateral) es el hogar único para todo lo que abrirías cuando algo anda mal, cuando necesitas una referencia o cuando quieres exportar un paquete de soporte para el desarrollador. Tres pestañas: Recursos, Comprobaciones de estado, y Diagnóstico. Los controles de compatibilidad de hardware que solían vivir aquí se trasladaron a Configuración → Hardware.

Página de soporte. La pestaña de comprobaciones de estado predeterminada muestra una fila por sonda, con estado PASA / INFORMACIÓN / ADVERTENCIA / FALLA y botones de acción contextuales cuando hay una solución disponible. Página de soporte. La pestaña de comprobaciones de estado predeterminada muestra una fila por sonda, con estado PASA / INFORMACIÓN / ADVERTENCIA / FALLA y botones de acción contextuales cuando hay una solución disponible.
Figura 1. Página de soporte. La pestaña de comprobaciones de estado predeterminada muestra una fila por sonda, con estado PASA / INFORMACIÓN / ADVERTENCIA / FALLA y botones de acción contextuales cuando hay una solución disponible.

Tira de pestañas

La página de Soporte se abre en la Recursos Pestaña : documentos + enlaces manuales + la repetición del recorrido de bienvenida se encuentran allí como un primer aterrizaje amistoso. Las otras dos pestañas están a un clic de distancia:

  • Recursos (se abre primero): enlaces a los documentos y el manual alojados aquí, además de la repetición del recorrido de bienvenida y las páginas legales/del editor.
  • Comprobaciones de estado — la superficie de clasificación cotidiana (dispositivo, regla udev en Linux, accesibilidad de simulación, estado de tiempo de ejecución). Haga clic Ejecutar comprobaciones para sondear.
  • Diagnóstico — métricas de tiempo de ejecución, registro de eventos con capacidad de búsqueda y exportación de paquetes de soporte con un solo clic. Documentado por separado en el Pestaña Diagnóstico página.

Compatibilidad de hardware (prueba de eje con inversión + intercambio de cabeceo/alabeo, renderizado de efectos, el backend del dispositivo Windows, el selector de dispositivo y el Probar efectos de hardware sonda) ya no es una pestaña de Soporte; ahora vive en Configuración → Hardware.

Pestaña «Comprobaciones de estado»

Las comprobaciones de estado son el camino que la mayoría de los evaluadores necesitan cuando algo parece estar mal. Haga clic Ejecutar comprobaciones para sondear el estado del puente. Las filas se actualizan de forma independiente, por lo que una sonda de simulación lenta no bloquea la aparición del dispositivo o del resultado del tiempo de ejecución.

  • APROBADO significa que el puente verificó esa parte de la configuración.
  • INFORMACIÓN significa que no pasa nada, pero la fila tiene un contexto útil. Por ejemplo, se espera que X-Plane no escuche cuando vuela MSFS o usa el modo simulado.
  • ADVERTENCIA significa que la configuración puede continuar, pero hay algo que vale la pena arreglar o informar.
  • FALLO Significa que el puente encontró un problema de bloqueo. Cuando los controles de salud encuentran una solución segura, la fila ofrece un botón de acción.
  • LISTO y COMPROBANDO son estados neutrales utilizados antes y durante una ejecución.

Controles de hardware movidos a Configuración

Los controles de compatibilidad de hardware solían ser una pestaña de Soporte. Ahora viven Configuración → Hardware: el vivo prueba de eje (con Invertir polaridad del eje y Intercambiar ejes de cabeceo/alabeo), el Representación del efecto radio (efectos de hardware versus modo de compatibilidad de software), el backend del dispositivo Windows, el selector de dispositivos para múltiples dispositivos conectados, la opción experimental de dispositivos no listados y el Probar efectos de hardware sonda. Vea el Página de configuración para ver el tutorial completo.

Configuración → Hardware: la prueba de eje (inversión + intercambio de cabeceo/alabeo), el renderizado de efectos, el backend del dispositivo en Windows y la sonda de prueba de efectos de hardware. Configuración → Hardware: la prueba de eje (inversión + intercambio de cabeceo/alabeo), el renderizado de efectos, el backend del dispositivo en Windows y la sonda de prueba de efectos de hardware.
Figura 2. Configuración → Hardware: la prueba de eje (inversión + intercambio de cabeceo/alabeo), el renderizado de efectos, el backend del dispositivo en Windows y la sonda de prueba de efectos de hardware.

Cómo se distribuyen las comprobaciones

Cada fila de verificación tiene cuatro partes:

  • Estado — PASA (verde), INFORMACIÓN (azul), ADVERTENCIA (ámbar), FALLA (rojo), LISTO / CHECKING (neutral) o N/A cuando la fila no se aplica en esta plataforma.
  • Título — lo que se está controlando.
  • Detalle - un resumen de una línea de lo que se encontró. Pase el cursor (o toque al tocar) para ver todos los detalles.
  • Botón de acción — presente sólo cuando hay algo procesable. Ejemplos: Instalar la regla udev, Usar puerto: 5111, Arreglar….

los cheques

Dispositivo

Confirma que un joystick con Force Feedback compatible es visible para el sistema operativo y que el puente puede abrirlo exclusivamente. Falla si no hay ningún VID/PID compatible o si otro proceso mantiene el identificador.

Linux regla udev

Comprueba si /etc/udev/rules.d/99-ffb-bridge.rules está presente y coincide con el contenido canónico. Cuando está ausente, la acción es Instalar la regla udev — esto desencadena una pkexec Solicite que escriba el archivo en una ubicación privilegiada.

Excepción de NixOS

Los controles de salud detectan NixOS (buscando /etc/NIXOS) y reemplaza la fila udev-rule con una instrucción para agregar la regla a configuration.nix en su lugar. Ver Instalar para el fragmento.

WindowsLinux Configuración de SimConnect

SimConnect es la ruta MSFS, por lo que esta verificación se ejecuta en Windows y Linux. Busca MSFS SimConnect.xml en la ubicación apropiada para la plataforma, lo analiza y compara cualquier entrada IPv4 habilitada con el puerto que está utilizando el puente. Tres posibles resultados:

  • Se encontró una entrada coincidente. Verde: nada que hacer.
  • Entrada en un puerto diferente. Ámbar: ofrece una Usar puerto :X para adoptar ese puerto.
  • No hay entrada utilizable (o archivo no analizable). Rojo: ofrece una Arreglar… que abre el cuadro de diálogo de instalación (ver más abajo).
Linux usa un puerto sin privilegios

MSFS envía su entrada SimConnect estándar en el puerto 500. En Windows, eso se vincula bien y el puente lo usa. En Proton en Linux, un proceso de espacio de nombres de usuario no puede vincular puertos por debajo de 1024, por lo que el puente instala y utiliza una entrada paralela en un puerto sin privilegios (5111 por defecto) que MSFS-in-Proton realmente puede vincular, razón por la cual la corrección de Linux y la Usar puerto punto de acción en ese puerto superior.

Accesibilidad de SimConnect

Sondea el puerto TCP configurado. Envía un paquete SimConnect OPEN real e inspecciona el encabezado de respuesta para que pueda distinguir MSFS está escuchando de algo más está escuchando.

Accesibilidad de X-Plane

La ruta X-Plane funciona en todas las plataformas, y en macOS (Apple Silicon), X-Plane 12 con un SideWinder FFB2 es la combinación admitida. Esta verificación envía una pequeña sonda RREF a 127.0.0.1:49000 y espera brevemente una referencia de datos en respuesta. Asigna tanto el tiempo de espera como el de Winsock. WSAECONNRESET (recibido cuando se entregó un puerto ICMP inalcanzable) a "no en ejecución".

Tiempo de ejecución

Comprueba que el bucle de control funciona en su objetivo de 50 Hz. Advierte si la media de los últimos 60 s cae por debajo de 45 Hz.

Registro de fallos

Si hay un registro de fallos de la última sesión, la fila se vuelve ámbar y ofrece Mostrar para saltar a él en su administrador de archivos, y Enviar a través del formulario de comentarios que rellena previamente un envío de comentarios con el registro adjunto.

Reparar cuadro de diálogo

Arreglar… Los botones no aplican cambios directamente: abren un cuadro de diálogo que muestra exactamente qué está a punto de cambiar, dónde y (en Linux) qué le pedirá que apruebe el mensaje de autenticación.

Reparar cuadro de diálogo para la instalación de configuración de SimConnect. Se muestra el fragmento XML exacto que se agregará, junto con una vista previa del archivo resultante. Reparar cuadro de diálogo para la instalación de configuración de SimConnect. Se muestra el fragmento XML exacto que se agregará, junto con una vista previa del archivo resultante.
Figura 3. Reparar cuadro de diálogo para la instalación de configuración de SimConnect. Se muestra el fragmento XML exacto que se agregará, junto con una vista previa del archivo resultante.

El diálogo es siempre aditivo: las entradas existentes nunca se sobrescriben. Si el archivo de destino no se puede analizar, el cuadro de diálogo explica que primero se realizará una copia de seguridad con marca de tiempo. Cancelar es siempre la opción segura.

Comportamiento de pkexec de Linux

Acciones que escriben en rutas del sistema (reglas de udev, cualquier cosa bajo /etc) ruta a través pkexec. Verá el mensaje normal de polkit de su distribución, el mismo que aparece para gparted o una GUI del administrador de paquetes. Códigos de salida Las comprobaciones de estado interpretan:

SalirSignificadoInformes de controles de salud
0ÉxitoCheque verde; la fila se reevalúa.
126El usuario descartó el mensaje de autenticaciónÁmbar “Cancelado”: inténtelo de nuevo cuando esté listo.
127Sin agente polkit/fallo de autenticaciónRojo "Error de autenticación".
Consejo

Ejecutar el puente en un entorno mínimo (Linux sin cabeza, sway sin un agente polkit) está bien; simplemente no se pueden usar las correcciones privilegiadas de la página de soporte. Instale los archivos necesarios manualmente o inicie un agente polkit antes de iniciar el puente.

Cuando cada cheque es verde

La aplicación debería funcionar. Si no es así, cambie al Pestaña Diagnóstico — su registro de eventos mostrará más detalles que los estados de una sola línea de los controles de salud. O saltar a Solución de problemas para síntomas y soluciones comunes.

Anterior Mock Sim Siguiente Pestaña Diagnóstico