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

Página de soporte

La página de soporte es el hogar único para documentación, controles de estado, diagnósticos, registros y exportación de paquetes de soporte. La configuración del dispositivo físico ahora se encuentra en 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.
Figure 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.

La selección de dispositivos, la calibración de dirección, la representación validada, los límites de resistencia y las asignaciones de control se encuentran en vivo bajo 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.

Comprobación automática del dispositivo al iniciar

Al iniciarse, FFB-Bridge comprueba silenciosamente el backend del dispositivo en Windows, Linux y macOS. En Linux también revisa el acceso de lectura y escritura a un nodo de eventos compatible y que la regla udev instalada cubra todos los permisos actuales. WARN o FAIL muestra un aviso no bloqueante de Revisar y corregir que identifica cada problema.

  • Si todas las comprobaciones se superan, no se abre nada.
  • El inicio no sondea el simulador ni la red; que el simulador esté cerrado es normal y se trata durante la ejecución.
  • Mientras el diálogo está abierto, Auto-arm espera. Es posible revisar y corregir el problema, o descartarlo si el dispositivo está desconectado intencionadamente; tras descartarlo, Auto-arm solo puede continuar si se cumplen los demás requisitos.
Support → Health muestra PASS para un nodo de eventos compatible, WARN con Fix para una regla udev obsoleta y FAIL para el dispositivo físico. Support → Health muestra PASS para un nodo de eventos compatible, WARN con Fix para una regla udev obsoleta y FAIL para el dispositivo físico.
Figure 2. Support → Health muestra PASS para un nodo de eventos compatible, WARN con Fix para una regla udev obsoleta y FAIL para el dispositivo físico.

Hardware

Los antiguos controles de hardware de la página de soporte ahora tienen un área dedicada. Utilice Flight Check para pruebas de efectos aislados y utilice Hardware para configuraciones persistentes de dispositivos físicos. Abra la guía 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. 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.
Figure 3. 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

Health checks comprueba que /etc/udev/rules.d/99-ffb-bridge.rules cubra todas las líneas de entrada actuales de dispositivos compatibles y los permisos TTY de MOZA. Fix muestra la regla canónica mantenida, la instala mediante pkexec, recarga udev y activa los dispositivos de entrada y TTY. Durante la instalación se añade cualquier joystick no catalogado que esté conectado y habilitado de forma explícita.

Una regla antigua limitada a eventos aparece como WARN porque no contiene los permisos TTY actuales de MOZA. Use Fix aunque el archivo ya exista; la aplicación lo reemplaza por la regla completa generada.

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; 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 4. 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; 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; Reiniciar más tarde es seguro si necesita continuar primero.
Figure 5. 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; Reiniciar más tarde es seguro si necesita continuar primero.
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.
Figure 6. 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.