Página de suporte

A página de suporte é o único local para documentação, verificações de integridade, diagnósticos, registros e exportação de pacotes de suporte. A configuração do dispositivo físico agora reside em Hardware.

Faixa de guias

A página de suporte é aberta na Recursos Guia - documentos + links manuais + o replay do tour de boas-vindas ficam lá como uma primeira aterrissagem amigável. As outras duas guias estão a um clique de distância:

Recursos (abre primeiro) — links para os documentos e manuais hospedados aqui, além do replay do tour de boas-vindas e das páginas do editor/jurídico.
Verificações de integridade — a superfície de triagem do dia a dia (dispositivo, regra do udev no Linux, acessibilidade do simulador, estado de tempo de execução). Clique Executar verificações para sondar.
Diagnóstico — métricas de tempo de execução, log de eventos pesquisável e exportação de pacote de suporte com um clique. Documentado separadamente no Aba Diagnóstico página.

Seleção de dispositivos, calibração de direção, renderização validada, limites de força e atribuições de controle estão sob Hardware.

Guia Verificações de integridade

As verificações de integridade são o caminho que a maioria dos testadores precisa quando algo parece errado. Clique Executar verificações para sondar o estado da ponte. As linhas são atualizadas de forma independente, portanto uma sonda lenta do simulador não bloqueia a exibição do resultado do dispositivo ou do runtime.

APROVADO significa que a ponte verificou essa parte da configuração.
INFORMAÇÕES significa que nada está errado, mas a linha tem um contexto útil. Por exemplo, o X-Plane não escuta é esperado quando você está voando no MSFS ou usando o modo Mock.
AVISO significa que a configuração pode continuar, mas há algo que vale a pena consertar ou relatar.
FALHA significa que a ponte encontrou um problema de bloqueio. Quando as verificações de integridade conhecem uma solução segura, a linha oferece um botão de ação.
PRONTO e VERIFICANDO são estados neutros usados antes e durante uma execução.

Verificação automática do dispositivo na inicialização

Na inicialização, o FFB-Bridge verifica silenciosamente o backend do dispositivo no Windows, Linux e macOS. No Linux, também verifica o acesso de leitura e gravação a um nó de eventos compatível e se a regra udev instalada cobre todas as permissões atuais do dispositivo. WARN ou FAIL mostra um banner não bloqueante Revisar e corrigir que identifica cada problema.

Se todas as verificações forem aprovadas, nada será aberto.
A inicialização não sonda o simulador nem a rede; um simulador fechado é normal e será tratado durante a execução.
Enquanto a caixa de diálogo estiver aberta, Auto-arm aguarda. É possível revisar e corrigir o problema ou fechar a caixa quando o dispositivo estiver intencionalmente desconectado; depois disso, Auto-arm só poderá continuar se os outros pré-requisitos forem atendidos.

Figure 2. Support → Health mostra PASS para um event node compatível, WARN com Fix para uma regra udev antiga e FAIL para o dispositivo físico.

Hardware

Os antigos controles de hardware da página de suporte agora possuem uma área dedicada. Use Flight Check para testes de efeitos isolados e use Hardware para configurações persistentes de dispositivos físicos. Abra o guia de hardware.

Como as verificações são dispostas

Cada linha de verificação tem quatro partes:

Status — PASS (verde), INFO (azul), WARN (âmbar), FAIL (vermelho), READY / CHECKING (neutro) ou N/A quando a linha não se aplica nesta plataforma.
Título - o que está sendo verificado.
Detalhe — um resumo de uma linha do que foi encontrado. Passe o mouse (ou toque em telas sensíveis ao 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 um joystick de feedback de força compatível está visível para o sistema operacional e que a ponte pode abri-lo exclusivamente. Falha se nenhum VID/PID compatível estiver presente ou se outro processo estiver segurando o identificador.

Linux regra do udev

Health checks verifica se /etc/udev/rules.d/99-ffb-bridge.rules cobre todas as linhas de entrada atuais dos dispositivos compatíveis e as permissões TTY da MOZA. Fix mostra a regra canônica mantida, instala-a por meio do pkexec, recarrega o udev e aciona os dispositivos de entrada e TTY. Um joystick não listado, conectado e habilitado explicitamente é acrescentado durante a instalação.

Uma regra antiga somente de eventos é informada como WARN porque não inclui as permissões TTY atuais da MOZA. Use Fix mesmo se o arquivo já existir; o aplicativo o substitui pela regra completa gerada.

Após uma correção bem-sucedida, a regra está ativa e o app recomenda reiniciar. Reiniciar agora reabre o joystick com as novas permissões e descarta qualquer fallback da inicialização; Reiniciar depois é seguro se for preciso continuar primeiro.

Figure 4. A caixa de diálogo de correção do Linux mostra a regra canônica de entrada e TTY da MOZA para dispositivos compatíveis antes de solicitar permissão. Um joystick não listado, conectado e habilitado explicitamente é acrescentado durante a instalação.

Figure 5. Após uma correção bem-sucedida, a regra está ativa e o app recomenda reiniciar. Reiniciar agora reabre o joystick com as novas permissões e descarta qualquer fallback da inicialização; Reiniciar depois é seguro se for preciso continuar primeiro.

Exceção NixOS

As verificações de integridade detectam o NixOS (procurando por /etc/NIXOS) e substitui a linha udev-rule por uma instrução para adicionar a regra ao configuration.nix em vez disso. Veja Instalar para o trecho.

WindowsLinux Configuração do SimConnect

SimConnect é o caminho do MSFS, portanto esta verificação é executada no Windows e no Linux. Ele procura o do MSFS SimConnect.xml no local apropriado da plataforma, analisa-o e compara quaisquer entradas IPv4 habilitadas com a porta que a ponte está usando. Três resultados possíveis:

Entrada correspondente encontrada. Verde – nada para fazer.
Entrada em uma porta 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).

Linux usa uma porta sem privilégios

O MSFS envia sua entrada SimConnect padrão na porta 500. No Windows, isso se liga perfeitamente e a ponte a utiliza. No Proton no Linux, um processo de namespace de usuário não pode vincular portas abaixo de 1024, então a ponte instala e usa uma entrada paralela em uma porta sem privilégios (5111 por padrão) que o MSFS-in-Proton pode realmente vincular - e é por isso que a correção do Linux e o Usar porta ponto de ação naquela porta superior.

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

O caminho X-Plane funciona em todas as plataformas - e no macOS (Apple Silicon), X-Plane 12 com SideWinder FFB2 é a combinação suportada. Esta verificação envia uma pequena sonda RREF para 127.0.0.1:49000 e espera brevemente por um dataref em resposta. Mapeia o tempo limite e o Winsock WSAECONNRESET (recebido quando uma porta ICMP inacessível foi entregue) para “não em execução”.

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 falha da última sessão, a linha fica âmbar e oferece 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.

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

Ações que gravam em caminhos do sistema (regras do udev, qualquer coisa abaixo /etc) percorrer pkexec. Você verá o prompt normal do polkit da sua distribuição - o mesmo que aparece para gparted ou uma GUI do gerenciador de pacotes. Códigos de saída As verificações de integridade interpretam:

Sair	Significado	Relatórios de verificações de integridade
`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 headless, sway sem um agente polkit) é bom - você simplesmente não pode usar as correções privilegiadas da página de suporte. Instale os arquivos necessários manualmente ou inicie um agente polkit antes de iniciar a ponte.

Quando todos os cheques estão verdes

O aplicativo deve funcionar. Se isso não acontecer, mude para o Aba Diagnóstico — seu log de eventos mostrará mais detalhes do que os status de uma linha das verificações de integridade. Ou pule para Solução de problemas para sintomas e soluções comuns.