Solução de problemas

Os sintomas primeiro, corrigem por baixo. Na maioria dos casos o Doutor página já sabe o que há de errado - verifique antes de trabalhar nesta lista manualmente. Se nada aqui ajudar, exporte um pacote de suporte de Diagnóstico e abrir um relatório de feedback.

Janelas 11 O aplicativo não inicia de jeito nenhum

Se o instalador do Windows funcionou bem, mas clicando duas vezes no FFB-Bridge o atalho não faz absolutamente nada – nenhuma janela, nenhum erro, nenhum prompt do SmartScreen – é quase certo que você está executando o Windows 11 com Controle inteligente de aplicativos (SAC) habilitado. O SAC bloqueia silenciosamente qualquer aplicativo que não seja assinado por um editor confiável. As compilações beta ainda não foram assinadas (está no roteiro 1.0), então o SAC se recusa a lançá-las.

A solução é desligar o Smart App Control por tempo suficiente para instalar e executar o aplicativo pela primeira vez. As atualizações cumulativas recentes do Windows 11 também permitem que você reative o SAC posteriormente, sem reinstalar o Windows – uma melhoria em relação às versões anteriores, onde a desativação era permanente. Orientação da própria Microsoft:

Microsoft: Perguntas frequentes sobre o Smart App Control

Assim que o SAC estiver desligado, o aplicativo FFB-Bridge será iniciado e, criticamente, continua lançando depois de reativar o SAC – o SAC verifica apenas aplicativos que nunca viu antes. Portanto, a solução alternativa é única. Assim que os instaladores assinados por código forem fornecidos com a versão 1.0, esta seção desaparecerá.

Stick não se move

Está armado?

O medidor ARM da cabine na faixa superior deve indicar ARMADO (gradiente âmbar). Se lê DESARMADO (glifo cinza, borda quente), clique nele e confirme. Se lê FALHA (vermelho), consulte "O stick estava funcionando, parou de repente" abaixo - um pré-requisito acabou de ser eliminado.

O dispositivo foi detectado?

A lâmpada DEVICE na faixa superior deve estar verde (“Pronto”). Se estiver vermelho ("Desconectado"):

Desconecte e reconecte o stick; a ponte detecta novamente em um ou dois segundos.
Confirm the VID/PID in your OS device manager (045E / 001B).
Linux A linha da regra udev do médico deve ser verde; se estiver vermelho, execute o instalador com um clique.
Janelas Feche qualquer outro aplicativo que reivindique feedback de força – testadores DIY, alguns utilitários de diagnóstico de joystick terão acesso exclusivo.

Um sim está conectado?

A lâmpada do SIM na faixa superior deve estar verde (“Sim conectado”). Se não, veja o Guia de configuração do MSFS ou o Guia de configuração do X-Plane para o seu sim. Entretanto, o Simulação SimConnect página permitirá que você confirme se o restante do pipeline está funcionando.

MSFS se conecta, mas nenhuma força parece certa

Se o manche estiver se movendo, mas as forças parecerem erradas, o problema geralmente é uma incompatibilidade de perfil ou fuselagem:

Comece com o starter integrado mais próximo de sua aeronave: Cessna 172 Skyhawk (G1000), Daher TBM 930, Beechcraft King Air 350i, Airbus A320neo ou Boeing 747-8 Intercontinental. A maioria das sensações “erradas” vem de um perfil que foi ajustado para uma classe de aeronave diferente.
Verifique o painel de atividades do stick do Dashboard. Ele separa a mola da linha de base dos canais dinâmicos, como carga do eixo, ruído do motor, rotação no solo, turbulência e disparos mecânicos. Se os efeitos que você não esperava aparecerem como ativos, o sim está relatando a telemetria que os está impulsionando.
Aeronaves de terceiros ocasionalmente ignoram a implementação de SimVars padrão. A ponte tolera isso (o padrão de vars ausente é zero), mas alguns efeitos não serão acionados como resultado. Esta é uma limitação conhecida que não podemos contornar facilmente na ponte – informe a aeronave específica para que possamos caracterizá-la.

O ícone da bandeja não aparece (Linux)

Alguns ambientes de desktop não vêm com um host na bandeja do sistema pronto para uso – o GNOME Wayland é o grande problema. Quando a ponte detecta isso, ela mostra um banner na parte superior da janela explicando que fechar encerrará o aplicativo diretamente (em vez de ocultar silenciosamente) e o botão Fechar se comportará de acordo. No GNOME, instale a extensão AppIndicator Support para recuperar um ícone da bandeja; no KDE, Xfce, Cinnamon, MATE e Budgie, a bandeja funciona imediatamente.

O médico diz que o SimConnect está acessível, mas não há fluxo de dados

A ponte está se conectando (TCP hello é aceito), mas o fluxo de dados não está iniciando. No MSFS 2024, isso geralmente significa que a assinatura do SimVar está falhando – normalmente porque o MSFS ainda não terminou de inicializar seu servidor SimConnect interno. Aguarde até que o MSFS chegue ao menu principal (não apenas à tela de introdução) e tente novamente.

X-Plane detectado, mas sem fluxo de dados

Se a lâmpada do SIM ficar verde brevemente e depois voltar para "sem execução do SIM" sem que a telemetria realmente flua, um firewall geralmente está consumindo nossos pacotes UDP. Experimente:

Desative o firewall temporariamente para confirmar.
Coloque UDP 49000 na lista de permissões de saída no processo de ponte.

Janelas Crash logo após armar ou decolar

Pre-beta.10 issue. Earlier Windows hardware-mode builds created a large retained DirectInput effect table — one physical effect for each logical simulator cue. On some Sidewinder FFB2 / Windows pid.dll stacks, that call pattern could crash during active flight, often around CreateEffect, SetPeriodic, or native ACCESS_VIOLATION breadcrumbs. This is not an MSFS issue and not a sign that your stick's firmware is bad.

Janelas As forças desaparecem após uma pausa no MSFS ou uma longa gagueira

Beta.11 visa especificamente esta classe de bug. A pausa MSFS e a pausa ativa agora suprimem os efeitos dinâmicos imediatamente, enquanto o stick mantém uma mola padrão neutra. Ao retomar, os parâmetros de mola DirectInput são recarregados antes da repetição dos efeitos, para que a centralização de pitch e roll se recupere.

Se a força de rotação ainda parecer ausente após a retomada na versão beta.11 ou posterior, exporte um pacote de suporte imediatamente após reproduzi-lo e descreva se o Dashboard mostrou carga do eixo, mola de linha de base ou canais dinâmicos naquele momento. Isso nos diz se o pipeline ficou silencioso ou se o driver do dispositivo perdeu um eixo.

Beta.10 corrige a arquitetura: o modo de hardware agora usa uma constante vetorial, uma mola de dois eixos e um pequeno pool periódico lento em vez de uma grande tabela retida. Se você ainda vê isso na versão beta.10 ou posterior, abra Médico → Compatibilidade de hardware, execute Testar efeitos de hardware, depois mude para Periódicos combinados com software se o teste falhar ou se a ponte oferecer essa recuperação na próxima inicialização. Envie também um pacote de suporte para que possamos caracterizar a pilha de drivers restante.

Os efeitos continuam tocando por cerca de 30 segundos após sair

Pre-beta.9 issue. On Win11 + the FFB2 driver, the bridge's per-effect cleanup on quit was, on this stack, blocking each call for the effect's full firmware playback duration — so in-flight rumble or buffet effects ran out their natural ~32 second timer after the bridge closed, leaving the stick audibly active on the desktop with no app driving it. Fixed in beta.9 — the shutdown path now skips per-effect work entirely and uses two device-level commands (halt-all + reset firmware effect table) that return immediately. Same fix applies on a native crash via the Vectored Exception Handler. If you're seeing this on beta.9 or later, please file a feedback report.

Janelas Crash on quit citing `0x80131506`

Pre-beta.9 issue. On a fraction of installs, the bridge would crash with a Windows Error Reporting popup citing coreclr.dll and exception code 0x80131506 the moment you clicked Quit or closed the window. Root cause: the UI thread and the runtime's control loop were both calling into DirectInput at the same time on shutdown, and the COM marshaller eventually noticed and tore the process down. Fixed in beta.9 — all DirectInput access now serialises through a single lock at the device boundary so the two threads can never race the marshaller. If you're seeing a 0x80131506 on quit on beta.9 or later, please file a feedback report.

Falha no lançamento

Fluxo de recuperação da próxima inicialização: se a inicialização anterior travou, a ponte mostra uma caixa de diálogo de relatório de falha na próxima inicialização, com o rastreamento de pilha e um Enviar via formulário de feedback botão. Clique nele; o formulário é pré-preenchido com o log de falhas.

Se o aplicativo travar antes da caixa de diálogo aparecer, você precisará diretamente do arquivo de log de travamento:

Janelas %LOCALAPPDATA%\ffb-bridge\crashes\
Linux ~/.local/share/ffb-bridge/crashes/

Attach the most recent .log file to a feedback report.

Avisos “A ponte não consegue acompanhar”

O diagnóstico avisa quando a taxa do circuito de controle cai. Causas que vimos:

Outro processo no mesmo núcleo é o estouro da CPU – uma guia do navegador, uma compilação.
On Linux, a cpufreq governor is clocking down the CPU. Switch to performance or schedutil.
Executando em um ambiente virtualizado que não oferece ao convidado intervalos de tempo confiáveis de 20 ms.

Vários sticks FFB2 conectados

Vitórias encontradas pela primeira vez - a ponte pega o primeiro VID/PID correspondente e o impulsiona. Uma UI para desambiguar está na lista; por enquanto, desconecte fisicamente todos, exceto aquele que você deseja.

Ainda preso?

Exportar um pacote de suporte de Diagnóstico e abrir um relatório de feedback. The bundle contains the session log, crash log (if any), Doctor output, and system info — it's exactly what we need to reproduce without shipping you test builds.