Página de suporte
A página de suporte (rotulada Suporte na barra lateral) é o único local para tudo que você abre quando algo está errado, quando precisa de uma referência ou quando deseja exportar um pacote de suporte para o desenvolvedor. Três guias: Recursos, Verificações de integridadee Diagnóstico. Os controles de compatibilidade de hardware que existiam aqui foram movidos para Configurações → 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.
Compatibilidade de hardware (teste de eixo com inversão + troca de arfagem/rolagem, renderização de efeitos, o back-end de dispositivo do Windows, o seletor de dispositivo, e o Testar efeitos de hardware probe) não é mais uma guia do Suporte — ela fica em Configurações → 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.
Controles de hardware movidos para Configurações
Os controles de compatibilidade de hardware costumavam ser uma guia Suporte. Eles agora vivem Configurações → Hardware: ao vivo teste do eixo (com Inverter polaridade do eixo e Trocar eixos de arfagem/rolagem), o Renderização de efeito rádio (efeitos de hardware versus modo de compatibilidade de software), o back-end do dispositivo Windows, o seletor de dispositivos para vários sticks conectados, a aceitação experimental de dispositivos não listados e o Testar efeitos de hardware probe. Veja o Página de configurações para o passo a passo completo.
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
Verifica se /etc/udev/rules.d/99-ffb-bridge.rules
está presente e corresponde ao conteúdo canônico. Quando ausente, a ação é Instalar regra do udev - isso desencadeia um pkexec prompt para gravar o arquivo em um local privilegiado.
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).
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”. |
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.