Instalar FFB-Bridge

O FFB-Bridge é fornecido como um instalador independente do Windows e um AppImage do Linux. Ambos agrupam o tempo de execução do .NET 10. Não há driver para baixar; seu SideWinder Force Feedback 2 já funciona no nível HID em qualquer kernel moderno do Windows ou Linux.

Antes de começar

Você precisará de:

A Microsoft SideWinder Force Feedback 2 joystick (USB VID 045E, PID 001B). A ponte está atualmente codificada para este stick específico.
Um simulador compatível: Microsoft Flight Simulator 2024, X-Plane 11 ou X-Plane 12. MSFS 2020 não foi testado. DCS, Prepar3D e Flight Simulators anteriores não são suportados.
Windows 10 (versão 1809 ou mais recente) ou qualquer distribuição Linux moderna com evdev – que é essencialmente toda distribuição de desktop convencional.

Janelas 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 (about 34 MB).

Execute o instalador

Clique duas vezes no instalador. Você verá um ou dois prompts:

SmartScreen “Aplicativo não reconhecido”. O instalador ainda não está assinado por código – a assinatura está no roteiro 1.0. Clique Mais informações, então Corra de qualquer maneira.
Assistente de configuraçã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.

Janelas 11 O Smart App Control bloqueia aplicativos não assinados imediatamente

Se você estiver no Windows 11 com Controle inteligente de aplicativos (SAC) ativado no modo Ativo, o instalador simplesmente não inicia – nenhum prompt do SmartScreen, nenhuma opção “Executar mesmo assim”, simplesmente nada acontece. O SAC recusa qualquer aplicativo sem uma assinatura de assinatura de código confiável e as versões beta ainda não foram assinadas.

A única maneira de contornar isso hoje é desligar o Smart App Control por tempo suficiente para instalar. A própria orientação da Microsoft cobre o fluxo (incluindo como alterná-lo via 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

Boas notícias em relação ao início do Windows 11: atualizações cumulativas recentes permitem reativar o SAC do aplicativo de segurança do Windows assim que a instalação for concluída – a Microsoft costumava exigir uma reinstalação completa do Windows, mas essa restrição acabou. O próprio aplicativo FFB-Bridge continuará funcionando normalmente após o SAC ser reativado; O SAC verifica apenas no lançamento aplicativos que nunca viu antes.

Os instaladores assinados por código estão no roteiro 1.0 e removerão totalmente esta etapa.

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 não assinados. Se o seu colocar o instalador em quarentena imediatamente (em vez de apenas avisar), envie por e-mail a amostra sinalizada para feedback·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 pegue novamente; remova essa pasta manualmente se quiser uma lousa em branco.

Linux AppImage

Baixar

O mesmo fluxo de inscrição do Windows – clique no link Linux no e-mail e você receberá FfbBridge-x86_64.AppImage (about 40 MB).

Torne-o executável e instale

AppImages precisam do bit executável definido e, na maioria das distros, devem ser registrados no menu do aplicativo para que o inicializador da área de trabalho os selecione. O incluído install.sh o script faz as duas coisas; a forma longa é:

chmod +x FfbBridge-x86_64.AppImage
mkdir -p ~/Applications
mv FfbBridge-x86_64.AppImage ~/Applications/
~/Applications/FfbBridge-x86_64.AppImage --install

O --install flag registers a .desktop arquivo e ícone em seus diretórios de dados XDG. Depois disso, um FFB-Bridge entrada aparece 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 utilizam de forma idêntica.

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 Doutor oferece uma instalação com um clique da seguinte regra do udev:

# /etc/udev/rules.d/99-ffb-bridge.rules
SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", 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"
'';

Then sudo nixos-rebuild switch e reconecte o stick.

Desinstalando

Either delete ~/Applications/FfbBridge-x86_64.AppImage e execute o desinstalador incluído ou execute o AppImage com o --uninstall sinalizador para reverter o registro do menu/ícone automaticamente. Perfis e preferências em ~/.config/ffb-bridge são mantidos para uma reinstalação posterior.

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.