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.

medico

La página Doctor es un control de salud integral. Ejecuta una serie de sondas en el dispositivo, el sim y el entorno del host, y cuando hay una solución obvia, ofrece una acción en línea para aplicarla. Comience aquí cuando algo no funcione; lo más probable es que el doctor ya sepa qué es.

Página del médico. Cada fila es una verificación: ícono de estado, título, detalle en línea y un botón de acción contextual.
Figure 1. Página del médico. Cada fila es una verificación: ícono de estado, título, detalle en línea y un botón de acción contextual.

Compatibilidad de hardware

La primera tarjeta en la página del Doctor es una compatibilidad de hardware panel. Alberga dos controles relacionados: un Invertir polaridad del eje alternar y un panel de arrastre en vivo prueba de polaridad. Ambos existen porque las diferentes series de producción del Sidewinder Force Feedback 2 interpretan la polaridad de la retroalimentación de fuerza de manera diferente: en algunos palos, lo que el puente piensa que está "hacia adelante" físicamente retrocede, y viceversa. La palanca es la solución a nivel de instalación; la prueba es cómo saber si darle la vuelta.

Tarjeta de compatibilidad de hardware en la parte superior de la página Doctor: alternar inversión de polaridad del eje, prueba de polaridad del panel de arrastre y fila de compatibilidad de publicaciones periódicas de hardware con su botón Probar efectos de hardware.
Figure 2. Tarjeta de compatibilidad de hardware en la parte superior de la página Doctor: alternar inversión de polaridad del eje, prueba de polaridad del panel de arrastre y fila de compatibilidad de publicaciones periódicas de hardware con su botón Probar efectos de hardware.

Prueba de polaridad en vivo

Haga clic Empezar y se activa una pequeña almohadilla de arrastre X-Y. Mueva el disco, la palanca lo sigue en tiempo real: el puente se arma automáticamente en modo simulado durante la prueba para que la verificación de requisitos previos pase sin una conexión SIM. Haga clic Detener cuando hayas terminado. Un modal de confirmación pregunta "¿El palo siguió al disco?":

  • si — la polaridad es correcta, no se realizó ningún cambio.
  • No — la palanca se gira automáticamente y cada fuerza posterior en los ejes de cabeceo y balanceo se anula en el borde de salida del dispositivo.

Al salir de la página del Doctor a mitad de la prueba, la detiene silenciosamente y restaura su fuente de entrada anterior (activa o inactiva); no se requiere una parada explícita.

Invertir polaridad del eje (manual)

El interruptor a la izquierda de la tarjeta es la misma configuración que escribiría la prueba. Úselo directamente si ya sabe que su dispositivo necesita girarse; por ejemplo, ya pasó por esto en una instalación anterior y desea configurarlo antes de realizar la prueba. La configuración es a nivel de instalación, no por perfil: vive en las preferencias del puente, se aplica a los ejes de cabeceo y balanceo juntos y sobrevive a los reinicios.

¿Por qué ambos ejes juntos?

Las versiones anteriores permitían invertir el cabeceo independientemente del balanceo. Eso no coincidía con la forma en que realmente se presentan las peculiaridades del firmware del FFB2: cuando se invierte un eje, ambos lo están. El interruptor ahora los voltea como un par. Las configuraciones existentes por lanzamiento se migran hacia adelante en el primer lanzamiento.

Periódicos combinados con software

El puente tiene dos formas de enviar efectos periódicos y únicos (retumbar, golpes, estremecimientos...) al FFB2. modo hardware (el valor predeterminado de instalación nueva) utiliza efectos de hardware DirectInput, y beta.11 mantiene esa topología deliberadamente pequeña: un vector constante, un resorte de dos ejes y un grupo periódico lento de tres ranuras. El firmware aún controla las formas de onda periódicas a su velocidad nativa; el puente simplemente reutiliza esas ranuras físicas para la pista actual, el motor, el buffet y las señales de un solo disparo. Periódicos combinados con software, el interruptor en la misma fila del Doctor, mantiene solo la ruta continua del hardware de fuerza/centrado y sintetiza señales periódicas y de un solo disparo en C# a 200 Hz, integrando el resultado en las salidas de fuerza constante.

El modo de hardware es más nítido y tiene menor latencia en los efectos de frecuencia más alta porque el firmware los impulsa más rápido que la velocidad de tick del puente. La combinación de software es la alternativa de compatibilidad para pilas de controladores que aún fallan en el modo de hardware, para resultados de prueba fallidos o para usuarios que deliberadamente lo prefieren. Una salida genérica sucia no obliga a la combinación de software por sí sola. Ambos modos utilizan los mismos catorce efectos con los mismos controles deslizantes de ajuste por efecto: la elección es un detalle de envío, no un cambio de función. Se requiere reinicio en cualquier sentido; el despachador lee el modo al inicio.

Haga clic Probar efectos de hardware para probar la topología de hardware compacta de forma segura. El doctor inicia un proceso de trabajo separado, asigna la misma constante vectorial, resorte de dos ejes y grupo periódico que el puente usa en vuelo, luego lo derriba. Si la pila DirectInput/PID de Windows falla, solo el trabajador muere y el puente permanece abierto. Si la prueba pasa, Doctor y el tiempo de ejecución cambian al mismo estado de modo de hardware en el siguiente lanzamiento, por lo que el estado de Doctor y el modo de despachador real coinciden.

Cómo se distribuyen los cheques

Cada fila de verificación tiene cuatro partes:

  • Punto de estado — verde (aprobado), ámbar (advertencia), rojo (reprobado), gris (no aplicable 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 Sidewinder Force Feedback 2 es visible para el sistema operativo y que el puente puede abrirlo exclusivamente. Falla si el VID/PID no está presente o si otro proceso mantiene el identificador.

linux regla udev

Checks whether /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 — this triggers a pkexec Solicite que escriba el archivo en una ubicación privilegiada.

Excepción de NixOS

El médico detecta NixOS (buscando /etc/NIXOS) y reemplaza la fila udev-rule con una instrucción para agregar la regla a configuration.nix instead. See Instalar para el fragmento.

Configuración de SimConnect

Looks for MSFS's 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).

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

Sends a tiny RREF probe to 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 revelar 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.
Figure 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 udev, cualquier cosa bajo /etc) route through pkexec. Verás el mensaje polkit normal de tu distribución, el mismo que aparece para gparted o una GUI de administrador de paquetes. Códigos de salida El médico interpreta:

SalirSignificadoInformes médicos
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 Doctor. Instale los archivos necesarios manualmente o inicie un agente polkit antes de iniciar el puente.

Cuando el Doctor está verde en todas partes

La aplicación debería funcionar. Si no es así, el registro de eventos de Diagnóstico mostrará más detalles que el estado de una sola línea del Doctor. Dirígete allí a continuación o salta a Solución de problemas para síntomas y soluciones comunes.