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.

Figure 1. Doctor page. Each row is one check: status icon, title, inline detail, and a contextual action button.

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. Both exist because different production runs of the Sidewinder Force Feedback 2 interpret force-feedback polarity differently — on some sticks, what the bridge thinks is “forward” physically pulls back, and vice-versa. The toggle is the install-level fix; the test is how you know whether to flip it.

Figure 2. Hardware compatibility card at the top of the Doctor page — Invert axis polarity toggle, drag-pad polarity test, and the hardware-periodics compatibility row with its Test hardware effects button.

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 is present and matches the canonical content. When absent, the action is Instalar la regla udev — this triggers a pkexec prompt to write the file into a privileged location.

Excepción de NixOS

Doctor detects NixOS (by looking for /etc/NIXOS) and replaces the udev-rule row with an instruction to add the rule to configuration.nix instead. See Instalar para el fragmento.

Configuración de SimConnect

Looks for MSFS's SimConnect.xml in the platform-appropriate location, parses it, and compares any enabled IPv4 entries against the port the bridge is using. Three possible outcomes:

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 and waits briefly for a dataref in response. Maps both timeout and Winsock's WSAECONNRESET (received when an ICMP port-unreachable was delivered) to “not running”.

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.

Figure 3. Fix dialog for SimConnect config install. The exact XML snippet to be added is shown, along with a preview of the resulting file.

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

Actions that write to system paths (udev rules, anything under /etc) route through pkexec. You'll see your distro's normal polkit prompt — the same one that pops up for gparted or a package manager GUI. Exit codes Doctor interprets:

Salir	Significado	Informes médicos
`0`	Éxito	Cheque verde; la fila se reevalúa.
`126`	El usuario descartó el mensaje de autenticación	Ámbar “Cancelado”: inténtelo de nuevo cuando esté listo.
`127`	Sin agente polkit/fallo de autenticación	Rojo "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.