Documentação da versão atual FFB-Bridge 1.4.0 Encontrou algo desatualizado? Avise pelo formulário de feedback.

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.

A versão 1.4 mantém a configuração do dispositivo em um só lugar

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.

Modal de reconhecimento de segurança. Marque a caixa de seleção e clique em “Reconheço” para continuar. Modal de reconhecimento de segurança. Marque a caixa de seleção e clique em “Reconheço” para continuar.
Figure 1. Modal de reconhecimento de segurança. Marque a caixa de seleção e clique em “Reconheço” para continuar.
desarmado

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.
O banner da inicialização mostra somente as verificações de dispositivo ou configuração que exigem atenção e abre Support → Health checks já preenchido ao escolher Revisar e corrigir. O banner da inicialização mostra somente as verificações de dispositivo ou configuração que exigem atenção e abre Support → Health checks já preenchido ao escolher Revisar e corrigir.
Figure 2. O banner da inicialização mostra somente as verificações de dispositivo ou configuração que exigem atenção e abre Support → Health checks já preenchido ao escolher Revisar e corrigir.

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.

O painel em seu estado inicial. Acima: a faixa de status — bloco da marca à esquerda, depois o medidor ARM do cockpit centralizado, as lâmpadas Sim · Dispositivo · Modo e o seletor de perfil + botão Ajustes à direita. Abaixo disso, a navegação da página à esquerda e o conteúdo da página. Na parte inferior: a fita de telemetria de voo (IAS, G, MACH, saídas de força, idade, tick). O painel em seu estado inicial. Acima: a faixa de status — bloco da marca à esquerda, depois o medidor ARM do cockpit centralizado, as lâmpadas Sim · Dispositivo · Modo e o seletor de perfil + botão Ajustes à direita. Abaixo disso, a navegação da página à esquerda e o conteúdo da página. Na parte inferior: a fita de telemetria de voo (IAS, G, MACH, saídas de força, idade, tick).
Figure 3. O painel em seu estado inicial. Acima: a faixa de status — bloco da marca à esquerda, depois o medidor ARM do cockpit centralizado, as lâmpadas Sim · Dispositivo · Modo e o seletor de perfil + botão Ajustes à direita. Abaixo disso, a navegação da página à esquerda e o conteúdo da página. Na parte inferior: a fita de telemetria de voo (IAS, G, MACH, saídas de força, idade, tick).

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.

Segurança em primeiro lugar

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.
O comportamento ao fechar segue Settings → General: Ask, Minimize to tray ou Quit. No modo Ask, a caixa de diálogo oferece Minimize e Quit; sem suporte à bandeja, fechar encerra o app. O comportamento ao fechar segue Settings → General: Ask, Minimize to tray ou Quit. No modo Ask, a caixa de diálogo oferece Minimize e Quit; sem suporte à bandeja, fechar encerra o app.
Figure 4. O comportamento ao fechar segue Settings → General: Ask, Minimize to tray ou Quit. No modo Ask, a caixa de diálogo oferece Minimize e Quit; sem suporte à bandeja, fechar encerra o app.
Menu da bandeja do sistema. Mostrar/Armar/Desarmar/Sair. No Linux, isso fica em qualquer bandeja fornecida pela sua área de trabalho; no Windows é a área de notificação padrão.
Figure 5. Menu da bandeja do sistema. Mostrar/Armar/Desarmar/Sair. No Linux, isso fica em qualquer bandeja fornecida pela sua área de trabalho; no Windows é a área de notificação padrão.
Desktops sem bandeja

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 D1D8 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:

No macOS o simulador suportado é o X-Plane; o MSFS conecta apenas no Windows e no Linux.