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). The bridge is currently hardcoded to this specific stick.
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 (version 1809 or newer) or any modern Linux distribution with evdev — which is essentially every mainstream desktop distro.

Janelas Instalador

Baixar

Depois de se inscrever no página inicial, we email you a tokenised download link. Click the Windows installer link to save 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 through the two pages. The default install location is %LOCALAPPDATA%\Programs\FfbBridge — a per-user install, no administrator permission required.

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 lands in the FFB-Bridge program group. You can also launch directly from %LOCALAPPDATA%\Programs\FfbBridge\FfbBridge.Desktop.exe.

Atenção – antivírus

Some antivirus products flag unsigned binaries. If yours quarantines the installer outright (rather than just warning), please email the flagged sample to feedback·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. Your profiles and preferences under %APPDATA%\ffb-bridge are left in place so a reinstall picks them up again; remove that folder by hand if you want a clean slate.

Linux AppImage

Baixar

Same signup flow as Windows — click the Linux link in the email and you'll get FfbBridge-x86_64.AppImage (about 40 MB).

Torne-o executável e instale

AppImages need the executable bit set and, on most distros, to be registered in the application menu so the desktop launcher picks them up. The included install.sh script does both; the long form is:

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

The --install flag registers a .desktop file and icon into your XDG data directories. After that, a 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. The installed menu entry on KDE Plasma. GNOME, Xfce, and other XDG-compatible environments pick it up identically.

regra do udev (recomendado)

Out of the box, only the user whose login session owns the joystick can open its /dev/input/eventN node. For the bridge to keep working after a fast-user-switch, or simply to avoid polkit prompts on some distributions, the 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 reads udev rules from the system config, not /etc/udev/rules.d. Add the equivalent to your configuration.nix:

services.udev.extraRules = ''
  SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
'';

Then sudo nixos-rebuild switch and replug the stick.

Desinstalando

Either delete ~/Applications/FfbBridge-x86_64.AppImage and run the bundled uninstaller, or run the AppImage with the --uninstall flag to reverse the menu/icon registration automatically. Profiles and preferences under ~/.config/ffb-bridge are kept for a later reinstall.

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.