Primeiro lançamento
A primeira execução confirma a segurança da saída, mostra uma orientação de 30 segundos e verifica a prontidão do dispositivo local. Simulador e rede ficam fora da verificação automática de inicialização.
Após o reconhecimento de boas-vindas e segurança, selecione o dispositivo físico, defina seu limite de força, calibre as direções e atribua controles em Hardware. Em seguida, use o Tuning apenas para sentir a aeronave. Abra o guia de hardware.
Reconhecimento de segurança
A primeira tela é um modal de segurança. A ponte aciona um motor físico que move o manche por conta própria, portanto, antes de mais nada, você deve reconhecer o resumo do risco físico. O modal bloqueia o fechamento até que você marque a caixa de seleção “Eu entendo”.
Isso aparece uma vez, sempre, no primeiro lançamento. Ele é armazenado separadamente da caixa de diálogo de boas-vindas, portanto, a atualização de uma versão pré-segurança ainda o aciona uma vez.


Desarmado significa nenhuma força: abertura do dispositivo, Disarm repetido, falha de inicialização e encerramento comandam ganho zero mais STOPALL; nenhuma mola ou outro efeito é reproduzido, e os dois bloqueios de saída do firmware MOZA permanecem inibidos até um Arm explícito.
Diálogo de boas-vindas
Após a segurança, um painel de 30 segundos explica o fluxo principal. Open Support guide fecha o painel e abre Support → Resources; Got it apenas fecha. Don't show again controla as próximas execuções.
Para repetir a orientação, abra Settings → General, ative Show welcome on next launch e reinicie o FFB-Bridge.
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.


A janela principal
Depois que a caixa de diálogo de boas-vindas fechar, você verá o Painel. O layout é o mesmo em todas as páginas: largura total faixa de status na parte superior, um trilho de navegação à esquerda abaixo dele, a própria página preenchendo o centro e uma fina fita de telemetria de voo na parte inferior. Neste ponto, o dispositivo é detectado, mas desarmado — nenhuma força alcançará o manche até que você o arme explicitamente.
A janela usa os controles normais do sistema operacional para minimizar, maximizar, fechar e redimensionar. A ação de fechar ainda segue o comportamento da bandeja descrito abaixo.


A faixa de status
A faixa na parte superior é o painel operacional da ponte – tudo o que você precisa saber o que a ponte está fazendo agora vive em uma fileira. Da esquerda para a direita:
- Bloco de marca — o logotipo + nome da FFB-Bridge, alinhado com o trilho de navegação abaixo.
- Medidor ARM da cabine - indicador emoldurado que é o herói visual da tira. Três estados: desarmado (glifo cinza, borda quente em repouso), ARMADO (gradiente âmbar, glifo brilhante), FALHA (vermelho — consulte "Recuperando-se de uma falha" abaixo). Clique no medidor para armar ou desarmar.
- Lâmpadas SIM · DISPOSITIVO · MODO — status de uma palavra codificado por cores por pré-requisito. Verde = saudável, âmbar = atenção (por exemplo, fonte de demonstração), vermelho = falha (por exemplo, manche desconectado), cinza = inativo.
- Seletor de perfil — gatilho suspenso mostrando o nome do perfil ativo com um ponto destacado quando os parâmetros ajustáveis ao vivo diferem do arquivo salvo.
- Botão Ajustar/Salvar — delineado, "Ajustar →" navega para a página Ajustes; "Ajustar" preenchido indica que você já está lá; o "Salvar" âmbar preenchido aparece sempre que você tem alterações de ajuste não salvas — clicar nele confirma e vai para a página Ajustes para que você veja a confirmação.
A fita de telemetria de voo
A fita fina na parte inferior da área de conteúdo é uma leitura rápida dos números ativos com os quais o pipeline está trabalhando. Da esquerda para a direita:
- IAS — velocidade indicada no ar em nós.
- G — fator de carga.
- MACH — Número Mach.
- PASSO F — a força que o pipeline está enviando atualmente no eixo de arfagem (fração da autoridade total, com sinal).
- ROLO F — o mesmo no eixo de rolagem.
- IDADE — milissegundos desde a chegada do último snapshot.
—quando nenhum dado foi recebido ainda. - MARQUE O ciclo de controle opera normalmente com alvo de 50 Hz e passa para 200 Hz quando o renderizador ativo precisa combinar formas de onda no host ou usar um ciclo de resposta acoplado ao dispositivo.
Armando o manche
Clique no medidor ARM do cockpit na faixa para abrir a caixa de diálogo de confirmação de armação. Confirme e o medidor muda para
ARMADO com o gradiente âmbar — as forças estão agora chegando ao manche. Clique novamente para desarmar. Esc
cancela a caixa de diálogo de confirmação se você mudar de ideia antes de confirmar.
Antes de armar, certifique-se de que nada — incluindo você — esteja apoiado no manche ou próximo a ele. Quando as forças entram em ação pela primeira vez, a mola de centragem leva o manche à posição central compensada. Trate cada armar como um momento de “mãos livres”, da mesma forma que faria com a reinicialização de um manche no simulador.
Confirmação do primeiro braço
Na primeira vez que você armar, uma caixa de diálogo de confirmação explica o que está prestes a acontecer. Verifique Não mostre isso de novo se você preferir ir direto para armado a partir de agora.
Recuperando-se de uma falha
Se um pré-requisito cair enquanto você está armado — na maioria das vezes o manche é desconectado ou o simulador trava no meio do voo — o medidor muda para FALHA (vermelho), as forças param e a lâmpada correspondente fica vermelha para que você possa ver exatamente o que falhou (DISPOSITIVO para uma desconexão, SIM para uma queda do simulador). Clique no medidor para reconhecer e redefinir para Desarmado; restaurar o pré-requisito ausente permite que você rearme normalmente. O abra o Diagnóstico O link ao lado do medidor leva você ao log de eventos da guia Diagnóstico da página de suporte, se desejar a história completa.
Fechar a janela
O fechamento segue Settings → General: Ask, Minimize to tray ou Quit. Em Ask, o primeiro fechamento oferece Minimize e Quit. Sem suporte à bandeja, fechar encerra o app.
Com Minimize to tray selecionado e uma bandeja disponível, a janela fica oculta e o FFB-Bridge continua em execução. Quit interrompe a saída e libera o dispositivo.
- Mostrar janela — traga a IU de volta da bandeja.
- Armar/Desarmar — mesmo efeito da alternância do Dashboard.
- Sair - feche a ponte de verdade.



Alguns desktops Linux, especialmente o GNOME Wayland padrão, não expõem um host de bandeja. Quando a ponte detecta isso, ela informa que o fechamento será encerrado diretamente, em vez de ocultar o aplicativo em execução. Instale o AppIndicator Support ou use uma área de trabalho com uma bandeja se desejar um comportamento oculto na bandeja.
Atalhos de teclado
A ponte é controlada por mouse/bandeja por design – não há teclas de atalho globais para armar ou navegar entre páginas. Compilações anteriores tentadas Space= Braço e D1–D8
para trocar de página, mas elas sequestravam a barra de espaço e as teclas numéricas enquanto uma TextBox detinha o foco (ao salvar um nome de perfil, por exemplo), e só disparavam quando a janela do bridge estava em primeiro plano — o que é raro na prática porque o simulador costuma estar em primeiro plano enquanto você voa. Use o menu da bandeja para armar / desarmar / sair quando a janela estiver oculta.
O único pressionamento de tecla que a janela intercepta é Esc, que cancela a caixa de diálogo de confirmação de braço aberto (no-op quando nenhuma caixa de diálogo está aberta).
Próximas etapas
Se o seu sim já estava rodando, o FFB-Bridge deveria tê-lo encontrado - verifique o SIM lâmpada na faixa de status superior. Caso contrário, consulte o guia de conexão daquele que você usa:
- Microsoft Flight Simulator 2024/2020 (Windows e Linux)
- X-Plane 11 / 12 (Windows, Linux e macOS)
No macOS o simulador suportado é o X-Plane; o MSFS conecta apenas no Windows e no Linux.