Tradução automática. Este site foi traduzido automaticamente e lamentamos quaisquer erros. O aplicativo de desktop FFB-Bridge está atualmente em inglês; a tradução de aplicativos pode ser adicionada se houver demanda suficiente para um idioma específico. Por favor, envie correções ou solicitações de idioma através da página de feedback.
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.

Instalar FFB-Bridge

O FFB-Bridge é fornecido como um instalador autossuficiente do Windows, um AppImage do Linux e um DMG do macOS (Apple Silicon). Os três incluem o runtime do .NET 10. Não há driver para baixar para os joysticks USB com force feedback compatíveis no Windows, Linux ou macOS modernos.

Antes de começar

Você precisará de:

  • Um joystick de force feedback. Cinco famílias de sticks estão validadas e funcionam como plug-and-play onde foram testadas: 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). Outros joysticks de force feedback podem ser ativados experimentalmente por meio de Configurações → Hardware → “Permitir dispositivos não listados”; volantes com force feedback, gamepads e dispositivos de eixo único estão fora do escopo e são direcionados para o FFB Probe em vez disso. Veja o página de hardware para ver a história completa de compatibilidade.
  • Um simulador compatível: Microsoft Flight Simulator 2024, Microsoft Flight Simulator 2020, X-Plane 11 ou X-Plane 12. DCS, Prepar3D e Flight Simulators anteriores não são suportados. No macOS, apenas o X-Plane é compatível — MSFS se conecta apenas em Windows e Linux.
  • Um de:
    • Windows 10 (versão 1809 ou mais recente) ou Windows 11.
    • Qualquer distribuição Linux moderna com evdev – que é essencialmente toda distribuição de desktop convencional.
    • macOS no Apple Silicon (M1 ou mais recente). A build do macOS é limitada ao X-Plane 12 com SideWinder Force Feedback 2 e MOZA AB9 + MH16; Macs Intel não são suportados.

Windows Instalador

Baixar

Depois de se inscrever no página inicial, enviaremos por e-mail um link de download tokenizado. Clique no link do instalador do Windows para salvar FfbBridge-Setup-x64.exe (cerca de 34MB).

Execute o instalador

Clique duas vezes no instalador. Você verá o assistente do Inno Setup, e o Windows também poderá mostrar um prompt de reputação do SmartScreen em compilações assinadas totalmente novas:

  1. Verificação do editor. O instalador do Windows é assinado por código pela identidade do editor Rohsam. Antes de continuar, confirme os programas do Windows Rohsam Inc. ou RohsamInc como editor.
  2. Prompt de reputação do SmartScreen. Novas compilações assinadas ainda podem ser marcadas como não reconhecidas até que o arquivo exato obtenha histórico de download. Se a fonte for FFB-Bridge.com, o hash corresponde e o editor é Rohsam, clique em Mais informações, então Executar mesmo assim.
  3. Assistente de instalação do Inno Setup. Clique Próximo pelas duas páginas. O local de instalação padrão é %LOCALAPPDATA%\Programs\FfbBridge — uma instalação por usuário, sem necessidade de permissão de administrador.
Windows 11 Smart App Control e novas versões assinadas

Se você estiver no Windows 11 com Smart App Control (SAC) habilitado no modo Ativo, o Windows ainda pode bloquear uma nova compilação assinada enquanto a reputação se atualiza. A assinatura do código prova a identidade do editor Rohsam; isso não garante que cada novo hash de arquivo tenha reputação de SmartScreen ou SAC no primeiro dia.

A própria orientação da Microsoft cobre o comportamento do Smart App Control e onde revisar suas configurações (Configurações → Privacidade e segurança → Segurança do Windows → Controle de aplicativos e navegador → Configurações do Smart App Control):

Microsoft: Perguntas frequentes sobre o Smart App Control

Se o SAC bloquear uma nova compilação em sua máquina, espere que a compilação acumule reputação ou use outro dispositivo Windows onde você possa verificar a assinatura Rohsam e fazer uma escolha informada.

Lançamento

Um atalho do menu Iniciar chamado FFB-Bridge pousa no grupo de programas FFB-Bridge. Você também pode iniciar diretamente de %LOCALAPPDATA%\Programs\FfbBridge\FfbBridge.Desktop.exe.

Atenção – antivírus

Alguns produtos antivírus sinalizam binários novos ou de baixa reputação. Se o seu colocar o instalador em quarentena imediatamente (em vez de apenas avisar), envie por e-mail a amostra sinalizada para support·ffb-bridge.com (substitua o · por um @) para que possamos investigar.

Desinstalando

Abrir Aplicativos e recursos nas configurações do Windows, procure por FFB-Bridgee escolha Desinstalar. Seus perfis e preferências em %APPDATA%\ffb-bridge são deixados no lugar para que uma reinstalação os reaproveite; remova essa pasta manualmente se quiser começar do zero.

Linux AppImage

Baixar

O mesmo fluxo de inscrição do Windows – clique no link Linux no e-mail e você obterá um AppImage com versão, como FfbBridge-1.0.0-x86_64.AppImage.

Torne-o executável e instale

AppImages precisam do bit executável definido antes que o Linux possa executá-los. Depois disso, o AppImage do FFB-Bridge pode se instalar nos diretórios da área de trabalho XDG 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 um .desktop inicializador, instala o ícone incluído e atualiza os caches da área de trabalho quando essas ferramentas auxiliares estão disponíveis. Depois disso, um FFB-Bridge A entrada deve aparecer no menu do seu aplicativo junto com outros aplicativos GUI.

Entrada FFB-Bridge no inicializador do aplicativo KDE Plasma após a instalação
Figura 1. A entrada de menu instalada no KDE Plasma. GNOME, Xfce e outros ambientes compatíveis com XDG o selecionam após a etapa AppImage --install.

regra do udev (recomendado)

Pronto para uso, apenas o usuário cuja sessão de login possui o joystick pode abrir seu /dev/input/eventN nó. Para que a ponte continue funcionando após uma troca rápida de usuário, ou simplesmente para evitar prompts do polkit em algumas distribuições, o Página de suporte (na barra lateral) oferece uma instalação com um clique da seguinte regra do udev para cada joystick USB compatível:

# /etc/udev/rules.d/99-ffb-bridge.rules
SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", 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"
NixOS

NixOS lê regras do udev da configuração do sistema, não /etc/udev/rules.d. Adicione o equivalente ao seu configuration.nix: 

services.udev.extraRules = ''
  SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", 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"
'';

Então sudo nixos-rebuild switch e reconecte o stick.

Desinstalando

Execute o AppImage instalado com --uninstall para remover o iniciador e os ícones e, em seguida, exclua o AppImage de ~/Applications se você não quiser mais. Perfis e preferências em ~/.config/ffb-bridge são mantidos para uma reinstalação posterior.

macOS DMG (Apple Silicon)

A versão do macOS é nova e tem escopo definido: ela é executada em Apple Silicon (M1 ou mais recente) e se conecta a X-Plane 12 with the Microsoft SideWinder Force Feedback 2 and MOZA AB9 + MH16. It ships as a signed and notarized .dmg, então o Gatekeeper o aceita sem a solução alternativa “Abrir” do botão direito do mouse.

Baixe e instale

Use o mesmo fluxo de inscrição das outras plataformas — clique no link macOS no e-mail para baixar um DMG com versão, como FfbBridge-1.1.1-arm64.dmg. Então:

  1. Clique duas vezes no DMG para montá-lo. Uma janela será aberta mostrando o FFB-Bridge aplicativo e um Aplicativos atalho.
  2. Arrastar FFB-Bridge no Aplicativos atalho para instalá-lo.
  3. Ejete o DMG e inicie o FFB-Bridge no Launchpad ou na pasta Aplicativos.

Como a compilação é autenticada pelo Rohsam Inc. Developer ID, o macOS a verifica na primeira inicialização pela rede e a abre normalmente. Se o seu Mac estiver off-line na primeira inicialização, conecte-se à Internet para que o Gatekeeper possa concluir a verificação.

Desinstalando

Arrastar FFB-Bridge de Aplicativos para a Lixeira. Perfis e preferências em ~/.config/ffb-bridge são mantidos no lugar para uma reinstalação posterior; remova essa pasta manualmente para começar do zero.

Verificando a instalação

Inicie o FFB-Bridge. A primeira coisa que você deverá ver é a caixa de diálogo de boas-vindas (abordado na próxima seção). Se o aplicativo não iniciar ou travar ao iniciar, vá direto para Solução de problemas.

Anterior Visão geral Próximo Primeiro lançamento