Como funciona o FFB Probe

A corrida guiada

FFB Probe é organizado em torno de uma curta jornada de teste: chegar à tela de proposta de valor, detectar o stick, confirmar a lista de verificação de segurança, sentir cada efeito ao vivo, responder o que aconteceu e, em seguida, manter ou compartilhar o relatório resultante. Cada tela se concentra na tarefa em questão para que os testadores sempre saibam o que fazer a seguir.

Etapa 01

Terra

A primeira tela explica o que o FFB Probe testa, o que você recebe e por que o banco de dados público de hardware existe. Nada mexe no hardware até você continuar.

Etapa 02

Detectar

A tela de boas-vindas identifica o dispositivo de force feedback, seu VID:PID e os efeitos compatíveis, e mostra uma leitura ao vivo do joystick antes de qualquer força ser reproduzida.

Etapa 03

Preparar

A lista de verificação define a intensidade do teste, pede que você aceite o aviso de segurança e confirma que outros softwares estão fechados e que o joystick tem espaço para se mover.

Etapa 04

Sentir

Cada efeito é reproduzido por uma janela fixa enquanto a tela mostra a seção, o sinal esperado e uma contagem regressiva. “Stop run” continua visível, e Esc interrompe o teste a qualquer momento.

Etapa 05

Responder

Depois de cada efeito, toque em todos os chips que correspondem ao que você sentiu. Os chips são públicos; o campo opcional de notas permanece privado. “Continue”, “Run test again” ou “Skip” avança.

Etapa 06

Mantenha ou compartilhe

O relatório é salvo primeiro no seu computador. “Share my results” envia o payload sem dados sensíveis; em seguida, o aplicativo mostra um código de suporte e um link para a página pública do dispositivo.

Boas-vindas: detecção e outros programas

A tela de boas-vindas procura dispositivos de force feedback e mostra aquele que será testado, com seu VID:PID, o número de efeitos compatíveis e uma leitura ao vivo do joystick. Só esse dispositivo é testado. Re-scan repete a detecção depois que você conecta algo ou fecha outro programa.

Se houver em execução um programa que possa tomar o dispositivo, como um simulador de voo, o FFB-Bridge, o MOZA Cockpit ou o Pit House, as ferramentas da Brunner ou o Logitech G HUB, um cartão âmbar Other software running informa qual é e explica como fechá-lo. O aviso não bloqueia o teste; clique em Re-check depois de fechar o programa.

As bases Brunner saem de fábrica no modo CLS2Sim, que não tem interface de force feedback. Quando nenhum dispositivo de force feedback é encontrado, o FFB-Probe procura uma base Brunner e oferece Switch to DirectX mode; nada é alterado sem esse clique. Switch back to CLS2Sim mode when finished vem marcado por padrão, então a base volta ao modo CLS2Sim depois do teste, quando você fecha o FFB-Probe ou na próxima inicialização, se o FFB-Probe tiver sido fechado inesperadamente. Só a configuração de modo USB é gravada, depois que o seu modo original é registrado, e, se alguma etapa falhar, a base volta a ficar como estava.

Se o Simux, o CLS2Sim, o Brunner USB Config Tool ou o FFB-Bridge estiver ocupando a base, o cartão informa qual é e pede que você o encerre, inclusive pela bandeja do sistema, antes de clicar em Re-scan. Firmware sem modo DirectX é informado e nada é gravado.

Lista de verificação: intensidade, segurança e preparação

Test strength define a intensidade com que cada efeito aciona o dispositivo, de 0% a 75% em passos de 5%. Os joysticks em que os testes foram validados começam em 75%: o SideWinder Force Feedback 2, os adaptadores USB para SideWinder FFB Pro (03EB:2056, CAFE:4004), o Logitech G940, o Force 3D Pro e o WingMan Force 3D, além do Brunner FFB-G Joystick, reconhecido pelo tipo de base que ele informa pelo canal de configuração da Brunner, qualquer que seja a empunhadura instalada. Todos os outros dispositivos, incluindo as demais bases Brunner, as bases de voo MOZA e hardware que o FFB-Probe ainda não conhece, começam em 35%. Se o Simux, o CLS2Sim, o Brunner USB Config Tool ou o FFB-Bridge estiver ocupando esse canal, o tipo de base não pode ser lido; a base então começa em 35% e a lista de verificação pede que você feche o programa e clique em Re-scan. O FFB-Probe lembra a última intensidade que você escolheu para cada dispositivo.

O aviso Safety é sempre exibido: dispositivos de force feedback podem se mover de repente e com força real, então mantenha uma mão apoiada levemente na empunhadura, mantenha dedos, cabos e objetos afastados e pare com Esc ou “Stop run” a qualquer momento. Arm probe fica desativado até você marcar I understand and accept responsibility e confirmar todos os itens da lista de verificação. Aumentar a intensidade acima do padrão do dispositivo acrescenta um aviso de que bases direct drive potentes podem bater com força nos batentes.

A lista de verificação se adapta ao dispositivo. O SideWinder FFB2 e o Logitech G940 acrescentam um item de presença da mão, porque o sensor da empunhadura corta a saída do motor quando ninguém está segurando o joystick. Um VID:PID que não está na tabela de hardware do aplicativo pede o fabricante e o modelo reais.

Bases de voo MOZA

Para uma MOZA AB9, AY210, AB6 ou AY90, a lista de verificação acrescenta um cartão MOZA BASE. Ele lê, sem alterar nada, se a base vai realmente reproduzir efeitos: uma base no modo Telemetry do MOZA Cockpit, ou com force feedback desativado, saída de torque inibida ou ganho do jogo em 0, aceita todos os efeitos e não move nada.

Se a base não estiver pronta, o cartão lista os motivos e oferece Prepare base for testing, que salva suas configurações, coloca a base no modo DirectInput e libera as travas de saída de força. Restore my MOZA settings when finished vem marcado por padrão e as restaura depois do teste ou quando você fecha o FFB-Probe. Limites de curso, calibração e Force Sensing nunca são alterados. Se o MOZA Cockpit, o MOZA Pit House ou o FFB-Bridge estiver ocupando a porta de configurações, o cartão informa qual é; feche-o e clique em Re-check.

Execução: sentir, responder, parar

O teste é dividido em quatro seções: Constant, Periodic, Condition e Ramp. Cada efeito é reproduzido por uma janela fixa, cinco segundos no Windows e dois segundos e meio no Linux, e é interrompido assim que essa janela termina. Em seguida, o cartão de resposta pergunta o que você sentiu: toque em todos os chips que correspondem, adicione uma nota privada opcional e escolha Continue, Run test again ou Skip.

Stop run fica visível no cabeçalho e ao lado da contagem regressiva, e Esc interrompe o teste a qualquer momento. Fechar a janela durante um teste para os efeitos e libera o dispositivo primeiro. O que foi medido antes da interrupção é salvo localmente.

Resultado: guardar, compartilhar e acompanhar

A tela de resultado mostra onde o relatório foi salvo, com Show in folder e See my results. Share my results envia o payload sem dados sensíveis; fora isso, nada é enviado. Depois do compartilhamento, o aplicativo mostra um código de suporte e um link para a página pública do dispositivo, e o botão “Share” do relatório HTML também os mostra. Guarde o código caso queira perguntar sobre o envio ou removê-lo mais tarde. Um campo de e-mail opcional inscreve você para receber novidades, inclusive quando o FFB-Bridge passar a ser compatível com o seu joystick.

Se outro programa estava usando o dispositivo de forma exclusiva, o resultado informa qual é e explica que o teste não mediu nada do dispositivo. Uma base Brunner alterada para o teste, ou uma base MOZA preparada para ele, é restaurada assim que o mecanismo de teste é encerrado.

O que a sonda pede ao hardware para fazer

O Windows agrupa a bateria ao vivo nas seções Constant, Periodic, Condition e Ramp. O Linux apresenta os efeitos evdev equivalentes anunciados por cada dispositivo. As contagens exatas variam conforme driver e hardware nas duas plataformas.

Intensidade do teste e o limite de 75%

Cada efeito é reproduzido com a intensidade do teste escolhida na lista de verificação. Nada que o FFB-Probe reproduz passa de 75% da escala total, em qualquer dispositivo e em qualquer teste, incluindo a opção de linha de comando --magnitude e os modos de diagnóstico. Efeitos reproduzidos ao mesmo tempo dividem a intensidade, então juntos nunca a ultrapassam. Cada relatório registra a intensidade e se você a alterou.

Autocentralização e momento da parada

A mola de autocentralização do próprio dispositivo é desligada durante os testes ao vivo e restaurada depois, para que ela não combata nem mascare o efeito testado. Cada efeito é interrompido assim que sua janela de reprodução termina, e não quando você responde. O Logitech G940 no Linux é a exceção: seu driver ignora a configuração de autocentralização, então o FFB-Probe não mexe nela e registra que a autocentralização do hardware estava ativa.

Movimento medido

Enquanto cada efeito é reproduzido, a sonda amostra os eixos X e Y do joystick no Windows e no Linux e registra o deslocamento de pico como porcentagem com sinal da meia amplitude de cada eixo, por exemplo X peak +25.1%, Y peak -0.8%. O sinal mostra a direção, o que transforma uma resposta de direção em evidência verificável. O movimento é medido a partir da posição em que o joystick estava parado quando o efeito começou, então um joystick parado fora do centro pode mostrar mais de 100%. Efeitos Condition, como mola e amortecedor, não movem um joystick centralizado, portanto não se espera movimento em repouso para eles. A medição fica no campo privado de notas da resposta e não é exibida nas páginas públicas dos dispositivos.

Bases Brunner

Uma base Brunner multiplica cada efeito DirectX por ganhos que ela mesma armazena, 50% de fábrica. Nos testes ao vivo, o FFB-Probe ajusta FX master e os ganhos de efeito para 100%, nunca mais que isso e sem mexer no amortecimento global, e restaura seus valores depois, inclusive quando você interrompe um teste. No modo DirectX, a base mapeia seus eixos girados em 90°: 0° puxa para a direita, 90° para a frente, 180° para a esquerda e 270° para trás. Esse é o comportamento do firmware da Brunner; o FFB-Probe o registra como foi medido e não o corrige.

Os dois arquivos que cada execução grava

Os relatórios são salvos em %LOCALAPPDATA%\Programs\ffb-probe\Results\FFB-Probe-<timestamp>\ no Windows e em ~/.local/share/ffb-probe/Results/FFB-Probe-<timestamp>/ no Linux. Cada teste grava dois arquivos, o relatório HTML e o JSON de compartilhamento. O HTML incorpora o JSON em um bloco <pre>, então o relatório local e o payload enviado são exatamente os mesmos bytes. Os arquivos antigos de texto, README e ZIP de suporte só são gravados quando FFB_PROBE_KEEP_LEGACY=1 está definido.

Instalação no Windows e verificações da editora

O FFB Probe é publicado pela Rohsam Inc. O instalador é uma instalação por usuário — sem necessidade de senha de administrador, sem prompt do UAC. Ele coloca o binário em %LOCALAPPDATA%\Programs\ffb-probe e escreve um atalho na área de trabalho e uma entrada no Start Menu. O seletor de diretório está oculto para que você não possa instalar acidentalmente em algum lugar estranho. As versões estáveis do Windows são assinadas; confirme que o Windows mostra a Rohsam Inc. como editora e verifique o SHA-256 na página de download antes de executar.

Se o Windows não mostrar a Rohsam Inc. como a editora verificada do seu instalador, ou se o hash não corresponder ao manifesto publicado, não execute esse arquivo.

O manifesto de lançamento é a fonte da verdade para nomes de arquivos, tamanhos e hashes. O instalador Windows e o AppImage Linux são ambos downloads opcionais; executar o probe ainda mantém os relatórios locais até que você escolha Share.

AppImage mais permissões evdev

A construção Linux é enviada como um AppImage independente. Marque-o como executável, execute-o e mantenha o stick ligado e com espaço para se mover:

chmod +x ./FfbProbe-*.AppImage
./FfbProbe-*.AppImage

O AppImage pode ser executado diretamente, ou ./FfbProbe-*.AppImage --install pode adicionar integração de desktop no escopo do usuário em ~/Applications. Use --uninstall para remover a cópia instalada e sua entrada de menu.

A detecção pode funcionar com acesso somente leitura, mas os efeitos ao vivo precisam de acesso de gravação ao nó /dev/input/event* do joystick. Se o assistente relatar falhas de permissão, corrija as permissões do nó de evento do dispositivo uma vez em vez de executar o AppImage inteiro com sudo.

1. Encontre o nó do evento

O relatório ou texto de erro geralmente o nomeia como algo como event=/dev/input/event2. Você também pode inspecionar os links simbólicos de eventos do joystick:

ls -l /dev/input/by-id/*event-joystick

2. Experimente uma permissão temporária

Substitua event2 pelo nó do seu joystick. Isso dura até que o dispositivo seja desconectado ou a máquina seja reinicializada, portanto é uma forma segura de confirmar o problema:

sudo setfacl -m "u:$USER:rw" /dev/input/event2
./FfbProbe-*.AppImage

3. Torne-o persistente com udev

Peça ao udev os IDs USB do stick:

udevadm info -q property -n /dev/input/event2 | grep -E 'ID_VENDOR_ID|ID_MODEL_ID|NAME'

Use esses IDs hexadecimais em letras minúsculas em uma regra específica do dispositivo. Este exemplo é para um SideWinder FFB2, VID:PID 045e:001b:

sudo tee /etc/udev/rules.d/70-ffb-probe-045e-001b.rules > /dev/null <<'EOF'
# FFB Probe: allow the active desktop user to open this joystick's event node.
SUBSYSTEM=="input", KERNEL=="event*", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
EOF

sudo udevadm control --reload-rules
sudo udevadm trigger --subsystem-match=input

Desconecte e reconecte o joystick e execute o AppImage normalmente. A regra é por dispositivo, por isso é mais seguro do que adicionar seu usuário ao amplo grupo input.

4. Bases Brunner: a interface de configuração

Para alternar uma base Brunner entre os modos CLS2Sim e DirectX, e para elevar seus ganhos durante o teste, o FFB-Probe usa a interface de configuração hidraw da base, que por padrão só é acessível pelo root. Se o acesso for negado, o FFB-Probe mostra a regra a ser adicionada. A regra udev do FFB-Bridge já a inclui; caso contrário, crie este arquivo e reconecte a base:

sudo tee /etc/udev/rules.d/71-ffb-probe-brunner.rules > /dev/null <<'EOF'
SUBSYSTEM=="hidraw", KERNEL=="hidraw*", ATTRS{modalias}=="usb:v25BBp*in01", TAG+="uaccess"
EOF

sudo udevadm control --reload
sudo udevadm trigger

5. Bases MOZA: a porta de configurações

A verificação de prontidão da MOZA e Prepare base for testing se comunicam com a base pela porta serial USB de configurações, /dev/ttyACM*. Se o FFB-Probe não conseguir abrir a porta, ele sugere o grupo dialout; depois de adicioná-lo, saia da sessão e entre novamente:

sudo usermod -aG dialout "$USER"

Uma regra por dispositivo dá o mesmo acesso apenas ao usuário ativo da área de trabalho:

sudo tee /etc/udev/rules.d/70-ffb-probe-moza.rules > /dev/null <<'EOF'
SUBSYSTEM=="tty", KERNEL=="ttyACM*", ATTRS{idVendor}=="346e", TAG+="uaccess"
EOF

sudo udevadm control --reload-rules
sudo udevadm trigger --subsystem-match=tty

Quando outro programa está usando o dispositivo

Antes dos testes, o processo de trabalho do Linux abre o nó de evento uma vez. Se o nó estiver ocupado (EBUSY), o FFB-Probe informa os processos que o mantêm aberto, encontrados por meio de /proc/*/fd. Se o acesso for recusado (EACCES ou EPERM), ele indica as etapas de permissão acima. Processos executados por outros usuários ou pelo root não podem ser listados sem privilégios, e a mensagem avisa isso.

A autocentralização do kernel é desligada enquanto cada efeito é reproduzido e restaurada entre os efeitos. Ela nunca é alterada no Logitech G940, cujo driver para Linux ignora essa configuração e sempre centraliza com força total.

O assistente Linux usa efeitos de feedback de força evdev em vez de DirectInput. O esquema do relatório compartilhado é o mesmo do Windows, portanto, os envios do Linux aparecem no mesmo banco de dados público e no mesmo detalhamento do sistema operacional.

Atualizações mediante consentimento no Windows e Linux

A GUI lê um pequeno manifesto de versão estável na inicialização. Ele não envia ID de instalação, consulta de versão atual, informações do dispositivo ou resultados de investigação; respostas off-line e malformadas permanecem em silêncio.

Uma atualização nunca é oferecida durante um teste em andamento, e nada é instalado sem o seu consentimento. Versões estáveis só recebem ofertas de versões estáveis; uma versão beta recebe ofertas de betas mais novas e da versão estável que as substitui.

Após consentimento explícito, FFB-Probe baixa o instalador, verifica seu comprimento exato e SHA-256, requer uma assinatura Windows válida de Rohsam Inc., executa o instalador por usuário silenciosamente e reinicia a nova compilação.

Um Linux AppImage em execução pode baixar e verificar o novo AppImage, invocar seu manipulador de instalação com escopo de usuário, atualizar a entrada e os ícones da área de trabalho e iniciar a cópia instalada.

Compilações de desenvolvimento, AppDirs extraídos, pacotes de distribuição e outras instalações não AppImage Linux nunca são sobrescritas. O prompt leva à página de download e a essas notas de versão, e cada usuário pode adiar ou pular uma versão.

Problemas conhecidos e etapas de recuperação

Os bytes literais são a superfície de auditoria

Seus arquivos de relatório permanecem locais a menos que você clique em Share. O compartilhamento envia o arquivo JSON por POST para /submit; são os mesmos bytes incorporados no fim do relatório HTML. Separadamente, a GUI faz na inicialização a verificação de manifesto sem identificadores descrita acima, sem nunca enviar dados do relatório ou dispositivo.

O banco de dados público de hardware mostra uma visão agregada por VID:PID. Ele nunca exibe responses[].notes, que pode conter texto opcional de quem testou e o movimento medido pela sonda. Seleções de chips, a classe do dispositivo, a intensidade do teste (run), sinalizadores de capacidade, efeitos compatíveis, códigos de resultado, efeitos com falha e erros de execução podem aparecer na página do dispositivo.

O aviso da tela de boas-vindas sobre outros programas em execução e a mensagem de acesso exclusivo são mostrados só para você; os nomes de programas que aparecem neles nunca são adicionados ao relatório.

Leia o contrato de privacidade completo → · Abra o exemplo de relatório enviado →