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.
Documentação da versão atual FFB-Bridge 1.5.1 Encontrou algo desatualizado? 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:

  • O hardware compatível inclui MOZA AB6, AB9, AY90 e AY210; Microsoft SideWinder Force Feedback 2; Logitech G940, Force 3D Pro e WingMan Force 3D; dispositivos Brunner DirectX compatíveis; e adaptadores selecionados de SideWinder Force Feedback Pro. Os recursos e as evidências de testes físicos variam conforme o modelo exato e a plataforma. Consulte o guia de hardware antes de considerar um recurso específico validado. Joysticks não listados que atendam aos requisitos exigem a ativação explícita do suporte experimental. página de hardware.
  • 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 11.
    • Qualquer distribuição Linux moderna com evdev – que é essencialmente toda distribuição de desktop convencional.
    • macOS em Apple Silicon (M1 ou mais recente), com X-Plane e um dispositivo compatível. Macs Intel não são compatíveis. Consulte o guia de hardware para as evidências e limitações de cada modelo.
Atualizações automáticas

As instalações Windows e Linux AppImage empacotadas podem baixar, verificar, instalar e reiniciar após sua aprovação. macOS verifica automaticamente e abre o download assinado.

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 ffb-bridge-setup-1.5.1-x64.exe .

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 (replace the · with an @) so we can investigate.

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.5.1-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.5.1-x86_64.AppImage && ./FfbBridge-1.5.1-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
Figure 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)

O Linux precisa de permissões para o nó /dev/input/event* selecionado e para o canal TTY de política do firmware usado pelas bases MOZA compatíveis. Support → Health checks mostra a regra canônica dos dispositivos compatíveis e pode instalá-la após uma solicitação do polkit. Se um joystick elegível não listado estiver conectado e habilitado explicitamente, sua linha de entrada será acrescentada durante a instalação.

# /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}=="c2a8", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c286", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c283", TAG+="uaccess"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess"
SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess"
SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1001", TAG+="uaccess"
SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1001", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="00d2", TAG+="uaccess"
Uma regra existente também pode estar desatualizada

Uma regra mais antiga é relatada como AVISO quando falta permissão atual do dispositivo, como as linhas TTY MOZA ou o acesso gravável hidraw que o caminho de protocolo de força Logitech G940 precisa. Use Corrigir mesmo que o arquivo já exista; o aplicativo o substitui pela regra completa gerada.

Após uma correção bem-sucedida, a regra está ativa e o app recomenda reiniciar. Reiniciar agora reabre o joystick com as novas permissões e descarta qualquer fallback da inicialização; Reiniciar depois é seguro se for preciso continuar primeiro.

A caixa de diálogo de correção do Linux mostra a regra canônica de entrada e TTY da MOZA para dispositivos compatíveis antes de solicitar permissão. Um joystick não listado, conectado e habilitado explicitamente é acrescentado durante a instalação. A caixa de diálogo de correção do Linux mostra a regra canônica de entrada e TTY da MOZA para dispositivos compatíveis antes de solicitar permissão. Um joystick não listado, conectado e habilitado explicitamente é acrescentado durante a instalação.
Figure 2. A caixa de diálogo de correção do Linux mostra a regra canônica de entrada e TTY da MOZA para dispositivos compatíveis antes de solicitar permissão. Um joystick não listado, conectado e habilitado explicitamente é acrescentado durante a instalação.
Após uma correção bem-sucedida, a regra está ativa e o app recomenda reiniciar. Reiniciar agora reabre o joystick com as novas permissões e descarta qualquer fallback da inicialização; Reiniciar depois é seguro se for preciso continuar primeiro. Após uma correção bem-sucedida, a regra está ativa e o app recomenda reiniciar. Reiniciar agora reabre o joystick com as novas permissões e descarta qualquer fallback da inicialização; Reiniciar depois é seguro se for preciso continuar primeiro.
Figure 3. Após uma correção bem-sucedida, a regra está ativa e o app recomenda reiniciar. Reiniciar agora reabre o joystick com as novas permissões e descarta qualquer fallback da inicialização; Reiniciar depois é seguro se for preciso continuar primeiro.
NixOS

NixOS lê regras do udev da configuração do sistema. Ele ignora arquivos colocados diretamente em /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}=="046d", ATTRS{idProduct}=="c287", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c2a8", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c286", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="046d", ATTRS{idProduct}=="c283", TAG+="uaccess"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess"
  SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1000", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess"
  SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1002", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
  SUBSYSTEM=="input", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1001", TAG+="uaccess"
  SUBSYSTEM=="tty", ATTRS{idVendor}=="346e", ATTRS{idProduct}=="1001", TAG+="uaccess", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
  SUBSYSTEM=="input", ATTRS{idVendor}=="25bb", ATTRS{idProduct}=="00d2", 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 para macOS se conecta ao X-Plane. Ela funciona em Apple Silicon (M1 ou mais recente) e se conecta a X-Plane 12 com hardware de force feedback compatível. Consulte o guia de hardware para conhecer a cobertura exata de dispositivos e recursos. A distribuição tem assinatura e notarização e usa o formato .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.5.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. Confirme o aviso de segurança e conclua as verificações de inicialização; depois siga a orientação 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