Doutor

A página do Médico é uma verificação de saúde completa. Ele executa vários testes no dispositivo, no SIM e no ambiente host e, onde há uma solução óbvia, oferece uma ação em linha para aplicá-la. Comece aqui sempre que algo não estiver funcionando - provavelmente o médico já sabe o que é.

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

Compatibilidade de hardware

O primeiro cartão na página do Doutor é um compatibilidade de hardware painel. Ele hospeda dois controles relacionados: um Inverter polaridade do eixo alternar e um drag-pad ao vivo teste de polaridade. 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.

Teste de polaridade ao vivo

Clique Começar e um pequeno drag-pad XY torna-se ativo. Mova o disco, o stick segue em tempo real - a ponte é armada automaticamente no modo Mock durante o teste para que a verificação de pré-requisitos passe sem uma conexão sim. Clique Pare quando terminar. Um modal de confirmação pergunta “O stick seguiu o disco?”:

Sim — a polaridade está correta, nenhuma alteração foi feita.
Não — a alternância muda automaticamente e todas as forças subsequentes nos eixos de inclinação e rotação são negadas na borda de saída do dispositivo.

Navegar para fora da página Doctor no meio do teste o interrompe silenciosamente e restaura sua fonte de entrada anterior (ativa ou inativa) - sem necessidade de parada explícita.

Inverter polaridade do eixo (manual)

A alternância à esquerda do cartão é a mesma configuração que o teste escreveria. Use-o diretamente se você já sabe que seu stick precisa ser virado - por exemplo, você já passou por isso em uma instalação anterior e deseja configurá-lo antes de testar. A configuração é no nível de instalação, não por perfil: ela reside nas preferências da ponte, aplica-se aos eixos de inclinação e rotação juntos e sobrevive às reinicializações.

Por que os dois eixos juntos

As versões anteriores permitiam que o tom fosse invertido independentemente da rotação. Isso não correspondia à forma como as peculiaridades do firmware do FFB2 realmente se apresentam – quando um eixo é invertido, ambos o são. A alternância agora os vira como um par. As configurações existentes por pitch são migradas na primeira inicialização.

Periódicos combinados com software

A ponte tem duas maneiras de enviar efeitos periódicos e únicos (rumble, buffets, tremores…) para o FFB2. Modo de hardware - o padrão de instalação nova - usa efeitos de hardware DirectInput, e o beta.11 mantém essa topologia deliberadamente pequena: uma constante vetorial, uma mola de dois eixos e um pool periódico preguiçoso de três slots. O firmware ainda controla as formas de onda periódicas na taxa nativa; a ponte simplesmente reutiliza esses slots físicos para a pista atual, motor, bufê e pistas únicas. Periódicos combinados com software, a alternância na mesma linha Doctor, mantém apenas o caminho de hardware de força/centralização contínua e sintetiza sugestões periódicas e únicas em C# a 200 Hz, dobrando o resultado nas saídas de força constante.

O modo de hardware é mais nítido e tem menor latência nos efeitos de frequência mais alta porque o firmware os conduz mais rápido do que a taxa de tick da ponte. A combinação de software é o substituto de compatibilidade para pilhas de drivers que ainda travam no modo de hardware, para resultados de testes com falha ou para usuários que preferem deliberadamente. Uma saída genérica e impura não força a combinação de software por si só. Ambos os modos usam os mesmos quatorze efeitos com os mesmos controles deslizantes de ajuste por efeito – a escolha é um detalhe de envio, não uma alternância de recurso. Requer reinicialização de qualquer maneira; o despachante lê o modo na inicialização.

Clique Testar efeitos de hardware para testar a topologia de hardware compacta com segurança. O Doutor inicia um processo de trabalho separado, aloca a mesma constante vetorial, mola de dois eixos e conjunto periódico que a ponte usa em voo e depois a desmonta. Se a pilha DirectInput/PID do Windows falhar, apenas o trabalhador morre e a ponte permanece aberta. Se o teste for aprovado, o Doctor e o tempo de execução mudarão para o mesmo estado de modo de hardware na próxima inicialização, de modo que o status do Doctor e o modo real do despachante coincidam.

Como os cheques são dispostos

Cada linha de verificação tem quatro partes:

Ponto de status — verde (aprovado), âmbar (aviso), vermelho (reprovado), cinza (não aplicável nesta plataforma).
Título - o que está sendo verificado.
Detalhe - um resumo de uma linha do que foi encontrado. Passe o mouse (ou toque no toque) para ver todos os detalhes.
Botão de ação – presente apenas quando há algo acionável. Exemplos: Instalar regra do udev, Usar porta: 5111, Corrigir….

Os cheques

Dispositivo

Confirma que o Sidewinder Force Feedback 2 está visível para o sistema operacional e que a ponte pode abri-lo exclusivamente. Falha se o VID/PID não estiver presente ou se outro processo estiver segurando o identificador.

Linux regra do udev

Checks whether /etc/udev/rules.d/99-ffb-bridge.rules is present and matches the canonical content. When absent, the action is Instalar regra do udev — this triggers a pkexec prompt to write the file into a privileged location.

Exceção 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 o trecho.

Configuração do 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:

Entrada correspondente encontrada. Verde – nada para fazer.
Entrada em um porto diferente. Âmbar – oferece um Usar porta:X botão para adotar essa porta.
Nenhuma entrada utilizável (ou arquivo não analisável). Vermelho – oferece um Corrigir… botão que abre a caixa de diálogo de instalação (veja abaixo).

Acessibilidade do SimConnect

Testa a porta TCP configurada. Envia um pacote SimConnect OPEN real e inspeciona o cabeçalho de resposta para poder distinguir MSFS está ouvindo de outra coisa está ouvindo.

Acessibilidade do 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”.

Tempo de execução

Verifica se o circuito de controle está funcionando em seu alvo de 50 Hz. Avisa se a média dos últimos 60 s cair abaixo de 45 Hz.

Registro de falhas

Se houver um log de falhas da última sessão, a linha ficará âmbar e oferecerá Revelar para ir até ele em seu gerenciador de arquivos e Enviar via formulário de feedback que preenche previamente um envio de feedback com o log anexado.

Caixa de diálogo de correção

Corrigir… os botões não aplicam as alterações diretamente - eles abrem uma caixa de diálogo que mostra exatamente o que está prestes a ser alterado, onde e (no Linux) o que o prompt de autenticação solicitará que você aprove.

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.

O diálogo é sempre aditivo: as entradas existentes nunca são substituídas. Se o arquivo de destino não puder ser analisado, a caixa de diálogo explica que um backup com registro de data e hora será feito primeiro. Cancelar é sempre a escolha segura.

Comportamento do Linux pkexec

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:

Sair	Significado	Relatórios médicos
`0`	Sucesso	Cheque verde; linha é reavaliada.
`126`	O usuário dispensou o prompt de autenticação	Âmbar “Cancelado” – tente novamente quando estiver pronto.
`127`	Nenhum agente polkit/falha de autenticação	Vermelho “Falha na autenticação”.

Dica

Executar a ponte em um ambiente mínimo (Linux sem cabeça, sway sem um agente polkit) é bom - você simplesmente não pode usar as correções privilegiadas do Doctor. Instale os arquivos necessários manualmente ou inicie um agente polkit antes de iniciar a ponte.

Quando o Doutor é verde em todos os lugares

O aplicativo deve funcionar. Caso contrário, o log de eventos do Diagnóstico mostrará mais detalhes do que o status de uma linha do Médico. Vá para lá a seguir ou pule para Solução de problemas para sintomas e soluções comuns.