Versão atual. FFB-Bridge v1.2.1 está disponível. Esta documentação acompanha o app atual descrito pelo manifesto da versão. Se uma seção parecer desatualizada, avise pelo formulário de feedback.

Primeiro lançamento

Na primeira vez que o FFB-Bridge é iniciado, ele faz um breve tour de boas-vindas, procura seu joystick e garante que haja um caminho limpo para um simulador. Esta página percorre todas as telas que você verá, além do comportamento da bandeja e da janela com os quais você contará mais tarde.

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.
Figura 1. Modal de reconhecimento de segurança. Marque a caixa de seleção e clique em “Reconheço” para continuar.

Diálogo de boas-vindas

Depois de reconhecer a segurança, um tour de boas-vindas de sete slides resume o layout do aplicativo, o modelo de segurança para armar/desarmar e onde procurar ajuda. Você pode descartá-lo a qualquer momento com Pular o tour ou Fechar; se você quiser vê-lo novamente mais tarde, o Ajuda página tem um Repetir boas-vindas botão.

Caixa de diálogo de boas-vindas na primeira inicialização. Clique em “Fazer o tour” para percorrer os sete slides ou em “Pular tour” para ir direto para o Dashboard. Caixa de diálogo de boas-vindas na primeira inicialização. Clique em “Fazer o tour” para percorrer os sete slides ou em “Pular tour” para ir direto para o Dashboard.
Figura 2. Caixa de diálogo de boas-vindas na primeira inicialização. Clique em “Fazer o tour” para percorrer os sete slides ou em “Pular tour” para ir direto para o Dashboard.

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).
Figura 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 — a taxa alvo da malha de controle (sempre 50 Hz).

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.

Fechando a bandeja

O FFB-Bridge funciona como um serviço em segundo plano enquanto você voa. Clicando no X botão esconde a janela na bandeja do sistema; ele não fecha o aplicativo. O manche continua recebendo forças enquanto a ponte estiver em execução.

O menu do ícone da bandeja é a maneira mais rápida de armar ou desarmar depois de configurar um perfil. Ele expõe:

  • Mostrar janela — traga a IU de volta da bandeja.
  • Armar/Desarmar — mesmo efeito da alternância do Dashboard.
  • Sair - feche a ponte de verdade.
Confirmação de fechar no X. “Minimizar para a bandeja” mantém a ponte conduzindo o manche enquanto a janela está oculta; “Sair” encerra o aplicativo e libera o dispositivo. Marque “Não mostrar isto novamente” para pular a solicitação em fechamentos futuros. Confirmação de fechar no X. “Minimizar para a bandeja” mantém a ponte conduzindo o manche enquanto a janela está oculta; “Sair” encerra o aplicativo e libera o dispositivo. Marque “Não mostrar isto novamente” para pular a solicitação em fechamentos futuros.
Figura 5. Confirmação de fechar no X. “Minimizar para a bandeja” mantém a ponte conduzindo o manche enquanto a janela está oculta; “Sair” encerra o aplicativo e libera o dispositivo. Marque “Não mostrar isto novamente” para pular a solicitação em fechamentos futuros.
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.
Figura 6. 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.