FFB-Bridge

Capítulo 1Sobre este manual

Este manual cobre o FFB-Bridge, uma ponte em espaço de usuário que aciona joysticks de force feedback a partir do Microsoft Flight Simulator (2024 e 2020) e do X-Plane 11 / 12 no Windows 10+, Linux moderno e macOS (Apple Silicon). O MSFS se conecta por SimConnect TCP; o X-Plane se conecta por UDP; o simulador ativo é detectado automaticamente na inicialização. Cinco famílias de sticks estão validadas e funcionam plug-and-play onde foram testadas: Microsoft SideWinder Force Feedback 2, MOZA AB9 + MH16 no Windows, Linux e macOS, Logitech Flight System G940, Logitech Force 3D Pro e Logitech WingMan Force 3D. Outros joysticks com force feedback podem ser habilitados experimentalmente (capítulo 2). A build do macOS é limitada ao X-Plane 12 com SideWinder FFB2 e MOZA AB9 + MH16; Windows e Linux continuam sendo as plataformas do MSFS. Esta é a edição em arquivo único do manual por página em FFB-Bridge.com/docs — mesmo conteúdo, preparado para leitura de ponta a ponta e para impressão em PDF.

Os chips do sistema operacional Windows, Linuxe Ambos marque os parágrafos que se aplicam a apenas uma plataforma. Menus e botões estão em ousado; nomes de arquivos e atalhos estão em code.

Capítulo 2Instalar

Joysticks de force feedback validados e plug-and-play em v1.2.1: Microsoft SideWinder Force Feedback 2 (045E:001B), MOZA AB9 + MH16 (346E:1000 / 346E:1002, Windows, Linux, and macOS), Logitech Flight System G940 (046D:C287), Logitech Force 3D Pro (046D:C286), e Logitech WingMan Force 3D (046D:C283). Se você tem um stick MOZA ou Logitech, execute as verificações de saúde na página Support após instalar e envie feedback se aparecer alguma peculiaridade específica do dispositivo.

O modo de telemetria do MOZA Cockpit é destinado ao caminho de telemetria próprio da MOZA alimentado pelo simulador. Ele não é o modo padrão normal e pode deixar a base inativa durante testes de hardware independentes. Se o AB9 for detectado mas não fizer nada, volte o MOZA Cockpit para o modo normal/padrão e tente novamente.

Além desses dispositivos validados, outros joysticks de force feedback podem ser ativados ao optar por isso em Configurações → Hardware → Permitir dispositivos não listados (experimental). A ponte então aciona um dispositivo da classe joystick elegível com padrões seguros, uma calibração ao vivo de inversão e troca de arfagem/rolagem para corrigir a direção, e recuperação de falha como rede de segurança. Volantes, gamepads e dispositivos de eixo único não podem ser acionados como manches de voo e são roteados para o FFB Probe em ffb-probe.com em vez disso.

2.1 Instalador do Windows

Após se inscrever na página inicial, clique no link do Windows no download enviado por e-mail. Salvar FfbBridge-Setup-x64.exe e clique duas vezes nele. O instalador é assinado em código pela identidade do editor Rohsam. Novas compilações assinadas ainda podem mostrar um prompt de reputação do SmartScreen; verifique se o editor está Rohsam Inc. ou RohsamInc antes de continuar.

O assistente Inno Setup é instalado em %LOCALAPPDATA%\Programs\FfbBridge por padrão. Não é necessária permissão de administrador — esta é uma instalação por usuário. Um atalho do menu Iniciar chega ao grupo FFB-Bridge.

Para desinstalar, abra Aplicativos e recursos, encontre FFB-Bridge e escolha Desinstalar. Seus perfis em %APPDATA%\ffb-bridge são mantidos para uma reinstalação posterior; remova essa pasta para começar do zero.

2.2 Imagem do aplicativo Linux

Salve o AppImage do link enviado por e-mail, torne-o executável e deixe o AppImage instalar sua entrada na área de trabalho no escopo do usuário:

chmod +x FfbBridge-1.0.0-x86_64.AppImage
./FfbBridge-1.0.0-x86_64.AppImage --install

O --install O sinalizador copia o AppImage para ~/Applications, escreve o .desktop inicializador e ícones em seus diretórios de dados XDG e atualiza os caches da área de trabalho quando possível. Desinstale o inicializador e os ícones com --uninstall; exclua o AppImage manualmente se não quiser mais o arquivo.

2.3 macOS (Apple Silicon)

macOS FFB-Bridge envia um DMG assinado e autenticado para Apple Silicon (M1 e mais recente). Abra o DMG e arraste FFB-Bridge para a pasta Aplicativos. A build é assinada pelo Developer ID da Rohsam Inc. e stapled, então o Gatekeeper a abre sem aviso de “desenvolvedor não identificado”. A build do macOS é limitada ao X-Plane 12 com Microsoft SideWinder Force Feedback 2 e MOZA AB9 + MH16.

Regra udev 2.4 (Linux)

Para que a ponte possa abrir o manche sem um prompt do polkit a cada inicialização, instale a seguinte regra do udev. O Suporte está ativado. Ligado: a compensação alivia a força mantida e o manche se acomoda na posição compensada. pkexec para escrevê-lo; você também pode instalar manualmente:

# /etc/udev/rules.d/99-ffb-bridge.rules
SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c286", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c283", TAG+="uaccess"

No NixOS, adicione-o ao configuration.nix em services.udev.extraRules, então sudo nixos-rebuild switch e reconecte o stick.

Capítulo 3Primeiro lançamento

O fluxo do primeiro lançamento é composto por três modais consecutivos: um risco físico Reconhecimento de segurança, então o Tour de boas-vindase, em seguida, o Painel. O modal de segurança bloqueia o fechamento até que você marque a caixa de seleção “Eu entendo”; as boas-vindas podem ser ignoradas e reproduzidas posteriormente na página de Ajuda.

O painel abre com o dispositivo detectado e o medidor do braço na faixa superior lendo DESARMADO. As forças não chegam ao manche até que você o arme explicitamente. A faixa na parte superior da janela é o cockpit operacional: bloco da marca, medidor ARM (centro, o herói visual), lâmpadas Sim · Dispositivo · Modo e o seletor de Perfil + botão Ajustar / Salvar à direita. Os números de voo ao vivo (IAS, G, Mach, força de arfagem/rolagem, idade dos dados, taxa de tick) ficam em uma fita fina na parte inferior da área de conteúdo.

A janela usa os controles normais do sistema operacional para minimizar, maximizar, fechar e redimensionar. A ação de fechamento ainda segue o comportamento da bandeja abaixo.

Clique no medidor ARM na faixa para armar. O medidor tem três estados: DESARMADO (borda quente em repouso, glifo neutro), ARMADO (gradiente âmbar + glifo brilhante), FALHA (vermelho — ver § 3.4). Esc cancela a caixa de diálogo de confirmação do braço se você mudar de ideia antes de confirmar. Não existem outros atalhos de teclado globais; a ponte é acionada por mouse / bandeja por design.

Segurança. O primeiro armamento leva o manche à posição central compensada. Certifique-se de que nada — mãos, cabos, qualquer coisa solta na mesa — esteja apoiado ou encostado no manche quando você armar.

3.4 Recuperando-se de uma falha

Se um pré-requisito cair enquanto você estiver armado – na maioria das vezes o stick é desconectado ou o sim trava – o medidor muda para FALHA e as forças param. A lâmpada correspondente fica vermelha, então a causa é inequívoca: DISPOSITIVO para desconectar, SIM para queda do sim. Clique no medidor para reconhecer e redefinir de volta para DESARMADO; restaurar o pré-requisito ausente permite que você se rearme. 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 antes da redefinição.

Fechar a janela (botão X) oferece ocultação na bandeja; a ponte continua funcionando se você escolher Minimizar para bandeja. Use o menu da bandeja para armar/desarmar/mostrar/sair. Em desktops sem uma bandeja utilizável, como o GNOME Wayland padrão, a ponte avisa que fechar a janela vai encerrar diretamente em vez de ocultar.

Capítulo 4Conectando MSFS (2024 e 2020)

Tanto o Microsoft Flight Simulator 2024 quanto o 2020 se comunicam com o FFB-Bridge pelo SimConnect TCP, e a mesma configuração se aplica a ambos. No Windows, isso funciona imediatamente; no Linux no Proton, a porta padrão (500) não pode ser vinculada e uma correção com um clique na guia Verificações de integridade da página Suporte adiciona uma porta paralela sem privilégios. (Os caminhos abaixo são do MSFS 2024; o MSFS 2020 usa o equivalente Microsoft Flight Simulator , que a ponte também detecta.)

4.1 Onde reside o SimConnect.xml

A localização do arquivo depende da fonte de instalação do MSFS:

• Windows Steam %APPDATA%\Microsoft Flight Simulator 2024\SimConnect.xml
• Windows Store/Xbox %LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\SimConnect.xml
• Linux Steam + Proton ~/.steam/steam/steamapps/compatdata/2537590/pfx/drive_c/users/steamuser/AppData/Roaming/Microsoft Flight Simulator 2024/SimConnect.xml

O FFB-Bridge detecta o caminho correto automaticamente. Substituir por FFB_BRIDGE_MSFS_CONFIG ou FFB_BRIDGE_MSFS_PREFIX se você executar o MSFS em um local não padrão.

4.2 Correção com um clique na página de suporte

Abra Página de suporte → Guia Verificações de integridade. O Configuração do SimConnect A linha mostra o caminho XML detectado e a porta que a ponte está direcionando. Três resultados:

• Verde — entrada correspondente encontrada, nada a fazer.
• Âmbar Usar porta:X — entrada num porto diferente; o botão o adota.
• Vermelho Corrigir… — nenhuma entrada utilizável; a caixa de diálogo mostra exatamente o que será adicionado.

Todas as operações de correção são aditivas — as entradas existentes nunca são substituídas. Se o XML não for analisável, um backup com registro de data e hora será feito primeiro.

Capítulo 5Conectando o X-Plane 11/12

Configuração zero. X-Plane aceita assinaturas UDP RREF em 127.0.0.1:49000 por padrão; o FFB-Bridge se inscreve ao iniciar e os dados fluem. Se o X-Plane estiver em execução quando você iniciar a ponte, a lâmpada do SIM na faixa superior fica verde em milissegundos.

Um watchdog de desatualização de 3 segundos cobre o problema de não desconexão do UDP: se nenhum dataref chegar por três segundos, a lâmpada do SIM ficará vermelha. O carregamento de um novo voo é restabelecido automaticamente.

Os firewalls raramente interferem no loopback, mas se a sonda X-Plane da página de suporte estiver vermelha e o X-Plane estiver realmente em execução, verifique se há um firewall bloqueando o UDP 49000. Consulte o capítulo 14 para obter o fluxo de recuperação.

Capítulo 6Painel

O estado operacional — armado, simulador, dispositivo, modo, perfil — não está mais nesta página. Ele foi movido para a faixa superior persistente, então permanece visível enquanto você está nos Ajustes, no Diagnóstico ou em qualquer outro lugar. O painel é a superfície de explicação ao vivo: o que o simulador está relatando, quais canais dinâmicos estão ativos e qual estado básico de mola o manche está mantendo.

Painel esquerdo: estado de voo. Uma fileira de três leituras numéricas — velocidade no ar (kt), carga G (g, ficando âmbar fora da faixa normal), Mach — sobre um par de BiBars para a deflexão do profundor e do aileron. Abaixo das barras, leituras menores para o compensador do profundor, o estado no solo e o aviso de estol. A interface é atualizada a aproximadamente 20 Hz — uma visão dizimada do loop de controle de 50 Hz.

A parte inferior do painel esquerdo é uma lista de alterna grupo de efeitos: Sensação do manche, Ronco do motor, Tremor aerodinâmico da fuselagem, Rolagem no solo, Ombros mecânicos, Carga do eixo e Acompanhamento do piloto automático. Cada linha possui uma caixa de seleção, um status ativo e uma barra de nível compacta. Use-os como silenciamentos rápidos para comparações A/B durante o voo; os ganhos por efeito permanecem na página Ajustes. O estado de alternância faz parte do perfil ativo.

Painel direito: atividade do manche. O título nomeia os contribuidores dinâmicos mais fortes, a barra empilhada os agrupa por família e os chips de canal ativo mostram valores individuais quando são importantes. A mola de centragem é tratada como a sensação de base, portanto a lista ativa concentra-se nas alterações acima dessa base: centro de compensação, alterações na mola de carga G, carga do eixo, ronco do motor, rolagem no solo, tremores e disparos mecânicos. As barras de carga do eixo usam um azul distinto da contribuição da carga da mola; a seção da mola de centragem mostra o coeficiente, a zona morta e o centro de arfagem/rolagem.

Capítulo 7Ajustes

Cada alteração no controle deslizante se aplica no próximo tick de 50 Hz; você pode voar com a página Ajustes fixada em um segundo monitor e ajustar os efeitos enquanto eles acontecem.

7.1 Ganho mestre

Um único multiplicador aplicado na borda de saída do dispositivo, exibido como uma porcentagem de 0% a 100%. 100% é o nível projetado (e o padrão); valores mais baixos atenuam tudo o que a ponte envia, incluindo o coeficiente da mola de centragem, forças de velocidade no ar, roncos, tremores aerodinâmicos, arrasto sustentado e disparos únicos. 0% não envia saída de força. Não há "impulso" acima de 100% — esse teto é aquele até o qual os controles deslizantes de ganho por efeito trabalham. Abaixo do controle deslizante, a ponte aciona o dispositivo a 95% de sua autoridade total, deixando 5% de margem.

7.2 Grupos de controles deslizantes

De cima para baixo: Mola de centragem (base, piso de baixa velocidade, ganho G, limites mín/máx, zona morta) · Carga aerodinâmica (ganho de arfagem, ganho de rolagem) · Compensador (um Ativar compensador interruptor, profundor primeiro) · Sensação do manche (sensação do sistema de controle Seletor , amortecimento de taxa, bônus de borda de controle, queda do manche) · Efeitos de solo (estrondo na pista, impacto na aterrissagem, solavancos do trem de pouso, tremor nos freios, tremulação da roda do nariz, sugestão de tom de aceleração do soloe um tipo de trem de pouso Seletor de Rodas/Esquis/Flutuadores) · Tremores aerodinâmicos (estol, excesso de velocidade, Mach, spoiler, turbulência, além de um estol stick-shaker) · Motor (ronco do motor, ronco do reverso) · Disparos únicos (recolhimento do trem de pouso, passo do flape) · Piloto automático (sugestão de AP de baixa autoridade). Consulte o capítulo 12 para a referência completa.

7.3 Queda do manche

O stick drop modela o viés da gravidade em um profundor descarregado a baixa velocidade no ar — o que faz o manche de uma aeronave GA estacionada ficar ligeiramente à frente do centro. Dois controles deslizantes: Força (quão forte o viés puxa) e Desvanecer a velocidade no ar (os kt nos quais o viés decaiu até zero). Os padrões são da classe Cessna — reduza a Força para 0 para silenciar em perfis de jato ou fly-by-wire.

7.4 Compensador

O compensador é uma única opção: Ativar compensador, próximo ao topo da página Ajustes. Com isso ligado, a compensação alivia a força mantida carregada pela velocidade do ar (calculada em relação (profundor − compensador)) e desloca o alvo de centragem para a posição compensada, de modo que, em um estado estabilizado e compensado com manche neutro, você sente força próxima de zero e o manche se acomoda na posição compensada ao soltar — da mesma forma que um manche real acionado por cabos se comporta. Com ele desligado, o compensador não faz nada com o manche. O profundor é o comando principal; a força de compensação do aileron fica sob um Avançado divulgação. (As versões anteriores tinham um segundo caminho de compensação oculto, apenas no centro, que continuava movendo o manche mesmo com a compensação desativada — isso foi removido, então “Ativar compensação” desativado agora realmente desativa a compensação.)

7.5 Sensação do sistema de controle

Um seletor por aeronave na parte superior do Sensação do manche Grupo com três configurações: Manual, Impulsionado hidraulicamentee Fly-by-wire. Ele modula as forças de centralização e carga aerodinâmica existentes para corresponder à sensação dos controles da aeronave real:

• Manual (padrão) — controles mecânicos/cabo; nenhuma mudança na sensação da linha de base.
• Impulsionado hidraulicamente — suaviza a carga aerodinâmica da mesma forma que um sistema de sensação artificial, sem removê-la.
• Fly-by-wire — suprime a carga aerodinâmica e o enrijecimento por carga G, combinando com um manche lateral centrado por mola.

Os starters integrados definem isso por fuselagem — os starters de GA e turboélice são Manuais, o 747-8 é com reforço hidráulico e o A320neo é Fly-by-wire — então um starter é uma boa referência para escolher.

7.6 Interação dos controles deslizantes

Arraste o cursor, clique em qualquer ponto da trilha para saltar até lá, ou clique uma vez para focar e então use a roda do mouse / teclas de seta. Passar o mouse e rolar faz não capturam a roda — o controle deslizante precisa estar em foco primeiro — para que você possa rolar a página passando por controles deslizantes sob o cursor sem deslocá-los.

7.7 Indicadores de modificação e redefinições

Quando um controle deslizante difere do perfil carregado, uma seta para trás redefinir glifo aparece ao lado do seu valor; clique nele para reverter apenas esse controle deslizante. Cada cabeçalho de seção carrega um glifo correspondente que redefine todos os controles deslizantes da seção. Um Descartar no cartão de perfil reverte tudo de uma vez. O ponto âmbar no seletor de perfil resume “este perfil tem alterações não salvas”. As redefinições são apenas locais – elas não afetam o perfil salvo.

7.8 Salvando

Salvar substitui o perfil ativo. Salvar como… abre uma caixa de diálogo para salvar com um novo nome. As predefinições iniciais são somente leitura; Salvar como cria o perfil editável da aeronave que você manterá.

Capítulo 8Perfis

Perfis salvos são arquivos JSON em %APPDATA%\ffb-bridge\profiles\ (Windows) ou ~/.config/ffb-bridge/profiles/ (Linux, homenageando $XDG_CONFIG_HOME; macOS usa o mesmo caminho). Cada arquivo é um perfil. Copie-os entre máquinas ou compartilhe-os com outras pessoas enviando o arquivo por e-mail.

Também existe uma comunidade gratuita Biblioteca de perfis em FFB-Bridge.com/profiles: navegue e baixe perfis que outros usuários publicaram (não é necessária uma conta) e publique o seu próprio com o globo Compartilhar Ação na página Perfis. Compartilhar entrega o perfil à biblioteca com o formulário de envio pré-preenchido; você faz login apenas no momento da publicação, nada é enviado silenciosamente e os perfis iniciais integrados não podem ser compartilhados. Perfis compartilhados trafegam em um formato compatível com versões futuras que carrega metadados descritivos e migra de forma limpa para versões mais recentes do aplicativo; arquivos simples copiados à mão ainda funcionam como antes. Um fórum da comunidade fica em FFB-Bridge.com/community.

Perfis iniciais e perfis salvos compartilham uma lista. Ações: Usar perfil selecionado, Duplicar selecionado, Excluir selecionadoe Atualizar. As predefinições iniciais são somente leitura; use Duplicar ou Salvar como para obter uma cópia editável.

Os perfis iniciais integrados têm o nome das aeronaves do MSFS: Cessna 172 Skyhawk (G1000), Daher TBM 930, Beechcraft King Air 350i, Airbus A320neo e Boeing 747-8 Intercontinental. A troca de perfis se aplica no próximo tick de 50 Hz sem desarmar. O seletor de perfil em Ajustes mostra um ponto âmbar para alterações não salvas — salve antes de carregar outro perfil ou você descartará as alterações.

Capítulo 9Página de suporte — guia Diagnóstico

A guia Diagnóstico é a superfície de triagem mais profunda. As quatro cartas do topo mostram Dispositivo, Fonte de dados, Saída de forçae Integridade do log antes de se aprofundar nos detalhes. O painel de tempo de execução mostra o tempo de atividade da sessão atual, a idade dos dados, a taxa de telemetria da IU, a taxa do loop de controle, a taxa alvo, os efeitos ativos/alocados, as reafirmações e a contagem de exceções.

O log de eventos é pesquisável e filtrado por nível. Informações, Aviso e Erro alternam o corte por gravidade, a caixa de pesquisa corresponde a qualquer substring e Cópia visível exporta exatamente as linhas mostradas atualmente. Usar Copiar log completo ou Exportar registro completo... quando o suporte precisar de todo o log da sessão em disco.

O Pacote de suporte O botão produz um único ZIP para relatórios de feedback. Após a exportação, a guia mostra o nome do arquivo, o tamanho, um link para o formulário de feedback e Revelar arquivo onde a área de trabalho pode abrir o local do pacote. Consulte o capítulo 15 para obter a lista completa do conteúdo.

Capítulo 10Verificações de integridade e configurações de hardware

10.1 Verificações de integridade

A página de suporte é aberta na Verificações de integridade guia . Clique Executar verificações para testar o joystick suportado, configuração e acessibilidade do MSFS SimConnect, acessibilidade do X-Plane e o estado do tempo de execução. As linhas são atualizadas de forma independente e usam os estados PASS, INFO, WARN, FAIL, READY, CHECKING e N/A para que um simulador que não esteja em execução não seja confundido com um quebrado.

Onde uma correção é óbvia, a linha oferece uma ação embutida – Instalar regra do udev, Usar porta:X, Corrigir…, ou Revelar. A caixa de diálogo Corrigir mostra exatamente o que será alterado antes de ser aplicado e nunca substitui as entradas existentes.

10.2 Configurações de hardware

A página Configurações Hardware hosts de guias Inverter polaridade do eixo e o drag-pad ao vivo teste de polaridade. Diferentes lotes de produção do FFB2 leem a polaridade de maneira diferente; o teste verifica em qual direção o seu funciona acionando o manche a partir de um drag-pad de 2 eixos em tempo real. Clique em Iniciar, mova o disco, clique em Parar e responda “O manche seguiu o disco?” — Sim não faz alterações, Não inverte automaticamente a opção. A opção é de nível de instalação e inverte os eixos de arfagem e rolagem juntos.

10.3 Periódicos combinados por software

A ponte tem duas maneiras de enviar efeitos periódicos e únicos para o FFB2. Modo de hardware — o padrão de instalação nova — usa saída de força HID/PID bruta diretamente no SideWinder FFB2, com DirectInput mantido como substituto de compatibilidade quando necessário. As compilações atuais do Windows mantêm essa topologia deliberadamente pequena: uma constante vetorial, uma mola de dois eixos e um conjunto periódico de três slots com alocação tardia. O firmware ainda controla formas de onda periódicas na taxa nativa; a ponte reutiliza esses slots físicos para pista, motor, tremor aerodinâmico e efeitos pontuais. Periódicos combinados por software, na mesma guia Configurações → Hardware, mantém apenas o caminho de hardware de força/centralização contínua e sintetiza dicas periódicas/únicas em C# a 200 Hz, dobrando o resultado nas saídas de força constante.

O modo de hardware é mais nítido e tem menor latência nos efeitos de frequência mais alta porque o firmware os conduz mais rápido do que a taxa de tick da ponte. A combinação de software é a alternativa de compatibilidade para testes de hardware com falha, falhas classificadas com efeitos de hardware ou usuários que a preferem deliberadamente; uma saída genérica e impura não força a combinação de software por si só. Suas bordas de alta frequência podem parecer um pouco mais suaves. Requer reinicialização de qualquer maneira — o despachante lê o modo na inicialização. Usar Testar efeitos de hardware para testar a topologia de hardware compacta com segurança em um processo de trabalho separado.

Ações do Linux que gravam rotas do sistema pkexec. Códigos de saída: 0 = sucesso, 126 = usuário ignorou o prompt, 127 = falha de autenticação/sem agente polkit.

Capítulo 11Mock Sim

Mock Sim é um modo de bancada de testes para o pipeline de forças. Ative o Mock Sim na linha destacada no topo da página e use o botão Arm normal na faixa superior. O Dashboard e a faixa de status identificam a fonte como demo, não como simulador ao vivo.

Os cenários são intencionalmente exagerados para que cada família de forças fique clara no manche: corrida de decolagem, trepidação dos freios, turbulência, tremor de flapes, tremor de spoiler, tremor de estol, tremor de overspeed e amortecimento de taxa. São demonstrações, não perfis de aeronave ajustados.

O teste direto do manche move o centro da mola diretamente: arraste o ponto e o manche físico deve persegui-lo mesmo a 0 KIAS. Esta é a maneira mais rápida de comprovar o caminho da força, a mola de centragem e a polaridade antes de voar.

Desativar o Mock Sim interrompe a saída de força, redefine todas as entradas simuladas e retorna a ponte para Live. Se um simulador real estiver conectado, a página fica bloqueada com um banner explicativo, para que a telemetria ao vivo continue sendo a única fonte.

AjudaAjuda e tour

A página de Ajuda não está na barra lateral — ela abre automaticamente na primeira inicialização e pode ser reproduzida a qualquer momento via Suporte → Recursos → Repetir o tour de boas-vindas. É um centro de ação com guias. Começar mostra o estado de configuração, a lista de verificação inicial, a ordem de ajuste recomendada e o caminho do pacote de suporte. Solução de problemas agrupa sintomas comuns e aponta para a página que possui cada correção. Suporte vincula a exportação do pacote de suporte da guia Diagnóstico ao formulário de feedback. Recursos abre os documentos on-line, manual para impressão, feedback, privacidade e recursos legais/do editor. O aplicativo de desktop usa o manual em PDF incluído quando está presente e recorre ao manual on-line quando o arquivo local não está disponível.

ConfiguraçõesConfigurações

Configurações guarda preferências da instalação, não ajustes da aeronave. Geral controla o comportamento do botão fechar, tema, Contraste visual (um Padrão / Alto contraste escolha que aumenta o contraste em todo o aplicativo - superfícies, texto, bordas, botões, lâmpadas de status e cores de grupos de efeitos - sem alterar qualquer saída de força) e redefinições da interface do usuário na primeira inicialização. Sessão controla o armamento automático opcional (quando um dispositivo compatível e um sim ao vivo estão prontos) e desarme automático (quando o sim sai); ambos estão desativados por padrão. Hardware contém o seletor de dispositivo de force feedback, o modo de renderização de efeitos, o back-end de dispositivo do Windows, o Permitir dispositivos não listados (experimental) opt-in e o teste de eixo de polaridade / troca de arfagem-rolagem. Privacidade e diagnósticos abre as pastas locais de configuração e diagnóstico e limpa relatórios de falha ou arquivos de log nesta máquina.

Capítulo 12Referência de efeitos de força

Efeitos incluídos com v1.2.1:

1. Mola de centragem — enrijece com a carga G, a zona morta escala com a velocidade no ar, o centro se desloca com o compensador.
2. Força de inclinação carregada pela velocidade do ar — força constante no eixo de arfagem escalonada pela velocidade no ar² × deslocamento do profundor.
3. Força de rolagem carregada pela velocidade do ar — mesmo modelo no eixo de rotação, ajustado de forma independente.
4. Amortecimento de taxa — força oposta proporcional às taxas de rotação do eixo do corpo (p, q); amortecimento viscoso.
5. Queda do manche — polarização gravitacional no profundor em baixa velocidade no ar; puxa o manche para frente quando estacionado, desaparece na velocidade no ar de Fade (padrão 30 kts).
6. Acompanhamento do piloto automático — sinal de mola opcional de baixa autoridade em direção à referência do diretor de voo do piloto automático. Desativado por padrão nas versões atuais.
7. Ronco da pista — força periódica contínua dimensionada pela velocidade do solo e tipo de superfície (grama 1,5–1,9×, gelo 0,3–0,5×).
8. Impacto na aterrissagem — impulso único na transição para o solo; amplitude dimensionada pela velocidade vertical e pico de carga do pneu (de modo que um pouso suave parece mais leve do que uma chegada firme).
9. Tremor de frenagem — ruído de baixa frequência proporcional à deflexão do freio, controlado no solo.
10. Solavancos do trem de pouso — impulsos discretos durante o táxi abaixo de ~40 kt.
11. Tremores aerodinâmicos — sete subefeitos (estol, excesso de velocidade, Mach, spoiler, flape, trem de pouso, turbulência) compartilhando um gerador de tremor.
12. Ronco do motor — usa o valor de vibração por motor do simulador quando reportado (turboélices, jatos); recorre a uma rampa de RPM sintetizada quando o simulador não o informa.
13. Ronco do reverso — ronco de rolagem quando o reverso é acionado, dimensionado pela velocidade no solo.
14. One-shots mecânicos — tremores de extensão do trem de pouso e de etapa de flape em qualquer transição, em ambas as direções.
15. Forças de arfagem sustentadas por arrasto aerodinâmico — arrasto de flapes, arrasto de spoiler, arrasto do trem de pouso e arfagem por propwash. Vieses constantes de arfagem que espelham a descompensação que um piloto sente quando a configuração muda.
16. Stick-shaker de estol — um zumbido agudo e contínuo controlado pelo aviso de estol do próprio simulador, separado e complementar ao tremor de estol sintetizado. Desativado por padrão no perfil inicial GA; ativado para os perfis iniciais mais rápidos.
17. Shimmy da roda do nariz — uma vibração rápida de um lado para o outro (eixo de rolagem) durante a corrida no solo, ajustada por aeronave.
18. Sinal de arfagem por aceleração no solo — uma sugestão no eixo de arfagem vinculada à aceleração durante o rolamento no solo.

Dois por aeronave moduladores aproveite os efeitos acima em vez de adicionar novos canais próprios. O sensação do sistema de controle O seletor (Manual / Com reforço hidráulico / Fly-by-wire) dimensiona a carga aerodinâmica e o enrijecimento da mola por carga G para corresponder ao sistema de comandos da aeronave (§ 7.5). O tipo de trem de pouso O seletor (Rodas / Esquis / Flutuadores) dimensiona os roncos contínuos de rolagem no solo — ronco da pista, solavancos do trem de pouso e oscilação da roda de nariz.

Tudo se soma em duas saídas (força de arfagem + rolagem mais os parâmetros da mola). O ganho mestre é aplicado na borda de saída do dispositivo a toda a saída de força, incluindo o coeficiente da mola; uma inversão de polaridade de arfagem / rolagem no nível de instalação (Configurações → Hardware) nega ambos os eixos juntos na borda de saída do dispositivo se o seu hardware ler a polaridade invertida. O painel separa a mola de base dos canais dinâmicos ativos para que você possa ver quais efeitos estão contribuindo a qualquer momento.

Compensador altera a entrada para os efeitos 1 (mola de centragem) e 2/3 (forças de arfagem/rolagem carregadas pela velocidade do ar). Com Ativar compensador ativado, eles fazem referência (manche − compensador) e o alvo de centragem acompanha a posição compensada — em um estado estacionário compensado com o manche neutro, a força retida diminui e o manche se estabiliza na posição compensada ao ser solto. Com ele desligado, o compensador não move o manche de jeito nenhum. O único interruptor fica perto do topo da página de Ajustes (profundor primeiro; força do aileron em Avançado).

Periódicos combinados por software é uma opção de modo de expedição, não uma alternância de recursos. Qualquer um dos modos está totalmente ajustado – mesmo catálogo de efeitos, mesmos controles deslizantes. Em hardware modo (o padrão de instalação nova), a bridge aloca uma constante vetorial, uma mola de dois eixos e um pool periódico lento de Sine / Triangle / Triangle conjunto periódico. Em combinado com software neste modo a ponte mantém apenas o caminho de hardware de força contínua/centragem e sintetiza as sugestões periódicas/de impulso único em C# a 200 Hz. Ative na guia Configurações → Hardware; é necessário reiniciar.

A segurança de pausa e telemetria obsoleta fica fora do catálogo de efeitos. A pausa do Sim é instantânea – no momento em que os relatórios MSFS ou X-Plane são pausados (ou o watchdog do quadro congelado detecta valores que pararam de mudar), cada força dinâmica cai para zero no mesmo tique e o stick mantém uma mola padrão neutra até que os dados ao vivo sejam retomados. O ajustável pelo usuário Cão de guarda controlam o tempo separado de fade do tipo "o simulador desapareceu por completo".

Capítulo 13Guia de ajuste

Verifique a polaridade primeiro através do teste de polaridade do drag-pad em Configurações → Hardware (capítulo 10) - se as forças estiverem invertidas, cada ganho que você definir abaixo combaterá o sinal errado. Em seguida, percorra os estágios em ordem, salvando o perfil após cada estágio para que você possa voltar atrás.

1. Ganho mestre. Comece em 100%. Voe em cruzeiro, procure a saturação do motor; se o manche parecer duro na deflexão total, diminua para 80% e repita. Isso dimensiona todas as forças, incluindo a mola. Não há aumento acima de 100% — esse é o teto projetado.
2. Mola centralizadora. Solte o manche em cruzeiro: ágil versus lento. Depois faça uma curva de 2 G: ela firma? Se a centragem no táxi ou na desconexão do simulador parecer muito fraca, eleve o piso da mola de baixa velocidade antes de perseguir o ganho de G.
3. Queda do manche. Estacione a aeronave com o motor desligado — o manche deve ficar ligeiramente à frente (modelando a gravidade no profundor descarregado). Ajuste a Força para a posição de repouso, e o Fade de velocidade do ar para o momento em que ela desaparece na corrida de decolagem. Defina a Força como 0 para perfis a jato / fly-by-wire.
4. Sensação de sistema de controle. Defina Manual, Reforço hidráulico ou Fly-by-wire no topo da Sensação do manche para combinar com a aeronave antes de ajustar os ganhos — ele dimensiona a carga aerodinâmica e a mola de carga G, então defina-o primeiro ou seus ganhos perseguirão um alvo em movimento.
5. Compensador. Decida se Ativar compensador está ativado. Ligado: a compensação alivia a força mantida e o manche se acomoda na posição compensada — no compensador com manche neutro, força próxima de zero, o manche se mantém ao soltar. Desligado: o compensador não afeta o manche. Configure-o antes de ajustar os carregamentos; mudar no meio do ajuste muda as forças sentidas.
6. Carga aerodinâmica. Empurre o manche sem compensar; deve parecer o ar empurrando de volta. Verifique em todo o envelope de velocidade.
7. Efeitos terrestres. Táxi em pavimentação versus grama. Freio. Plante uma chegada firme.
8. Tremores aerodinâmicos. Estol com motor cortado para o tremor de estol; estenda os spoilers para o tremor dos spoilers.
9. One-shots mecânicos. Recolher / estender trem de pouso e flapes.
10. Motor. Potência em marcha lenta versus potência de decolagem — devem parecer claramente diferentes.
11. Amortecimento de taxa. Se o manche voltar ao centro com oscilação, aumente-o. Demais e o manche parece morto.

Padrões por tipo de aeronave: monomotores leves querem centragem firme e carregamento moderado; acrobáticos querem centragem suave e baixo amortecimento; jatos pesados querem amortecimento pesado e forte back-drive do AP; bush / STOL quer base de centragem baixa, mas alto ganho de G. Comece pelo modelo inicial integrado mais próximo da sua aeronave: Cessna 172 Skyhawk (G1000), Daher TBM 930, Beechcraft King Air 350i, Airbus A320neo ou Boeing 747-8 Intercontinental.

Capítulo 14Solução de problemas

14.1 O manche não se move

Na faixa superior, confirme na ordem: (1) o medidor ARM indica ARMADO (âmbar) — não desarmado ou com falha; (2) a lâmpada DEVICE está verde (“Pronto”); (3) a lâmpada do SIM está verde ("Sim conectado"). Uma lâmpada vermelha aponta para a linha correspondente na guia Verificações de integridade da página Suporte.

14.2 MSFS conecta, mas as forças parecem erradas

Carregue o perfil inicial mais próximo da sua aeronave. A maioria das sensações “erradas” vem de um perfil que foi ajustado para uma classe de aeronave diferente. Aeronaves de terceiros ocasionalmente deixam de implementar SimVars padrão — a ponte tolera isso (vars ausentes assumem zero por padrão), mas os efeitos que dependem delas ficarão silenciosos.

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

Alguns desktops não vêm com um host de bandeja pronto para uso – o GNOME Wayland é o grande problema. A ponte detecta isso e mostra um banner explicando que fechar encerrará o aplicativo diretamente em vez de ocultar. Instale o suporte AppIndicator no GNOME para recuperar uma bandeja; KDE, Xfce, Cinnamon, MATE, Budgie funcionam imediatamente.

14.4 Falha no modo de hardware do Windows após armar

Compilações anteriores poderiam travar em algumas pilhas do Windows/FFB2 porque o modo de hardware criava uma grande tabela de efeitos DirectInput retida. Este foi um bug de arquitetura de ponte, não MSFS ou firmware ruim. O caminho de hardware atual usa uma constante de vetor, uma mola de dois eixos e um pool periódico preguiçoso de três slots, com HID/PID bruto como caminho SideWinder FFB2 padrão e DirectInput como substituto. A versão 1.0 também redefine a tabela de efeitos HID/PID brutos antes de rearmar após uma desconexão do simulador. Se uma compilação atual ainda travar no modo de hardware, execute o Testar efeitos de hardware na guia Configurações → Hardware e mude para Periódicos combinados por software se a ponte oferecer essa recuperação.

14.5 Falha no lançamento

A próxima inicialização mostra uma caixa de diálogo de relatório de falha com o rastreamento de pilha e um Abrir formulário de feedback botão que pré-anexa o log de falha. Se o aplicativo falhar antes de a caixa de diálogo aparecer, extraia o log manualmente de %LOCALAPPDATA%\ffb-bridge\crashes\ (Windows) ou ~/.local/share/ffb-bridge/crashes/ (Linux).

14.6 As forças desaparecem após uma pausa ou gagueira prolongada

As compilações atuais visam isso diretamente. A pausa do MSFS e a Pausa Ativa suprimem os efeitos dinâmicos imediatamente, mantêm uma mola padrão neutra durante a pausa, deixam as molas tocando ao longo do quiesce quando possível e recarregam os parâmetros da mola antes do replay após o quiesce. Se a força de rolagem ou de arfagem ainda parecer ausente após a retomada, exporte um pacote de suporte imediatamente e anote o que o Dashboard mostrava na atividade do manche.

Capítulo 15Pacotes de suporte

Um pacote de suporte é um único ZIP produzido por Diagnóstico → Pacote de suporte. O ZIP contém, e contém apenas:

• sysinfo.txt — SO, kernel, distribuição, CPU, RAM, versão .NET, localidade.
• session.log — log de eventos completo da sessão atual.
• last-crash.log — log de falha, se existir.
• doctor.json — última verificação da página de suporte em formato legível por máquina.
• tunables.json — o perfil ativo no momento da exportação.
• hardware-settings.json — backend de hardware, suavização, polaridade, troca de eixos e configurações de compatibilidade.
• simconnect.txt — caminho e conteúdo do MSFS SimConnect, com IPs ocultados.

Limites: 50 MB compactados no total, 5 MB por entrada, no máximo 30 entradas, 20 MB no total não compactado, somente texto UTF-8 (mais o XML). Um pacote típico tem menos de um megabyte.

O pacote nunca sai da sua máquina automaticamente – você escolhe quando anexá-lo a um relatório de feedback e se deseja enviá-lo.

Capítulo 16Licença e isenção de responsabilidade

Os binários FFB-Bridge são software proprietário da Rohsam Inc. fornecidos sob os Termos do usuário final do FFB-Bridge e oferecidos no estado em que se encontram, sem garantia. Use por sua conta e risco – a ponte aciona o hardware físico e bugs podem produzir forças inesperadas. Trate cada braço como um momento de “mãos livres”.

FFB-Bridge é publicado pela Rohsam Inc. e é independente da Microsoft e da Laminar Research. “Microsoft Flight Simulator”, “SimConnect”, “Sidewinder” e “X-Plane” são marcas comerciais de seus respectivos proprietários; eles aparecem aqui com o único propósito de identificar produtos compatíveis. Nada nesta página implica o endosso de qualquer uma das empresas.

O FAQ completo e a política de privacidade estão disponíveis em FFB-Bridge.com/#faq e FFB-Bridge.com/privacy.

Fim do manual. Feedback sobre qualquer seção — texto, figuras ou conselhos de ajuste que não ajudaram você — FFB-Bridge.com/feedback.