FFB Probe Diagnostic
Idioma atual do site Português (Brasil)
Download
Documentation · v0.9.0-beta.1

Como funciona o FFB Probe

Um guia do assistente focado no testador, as seções de feedback de força ao vivo, os dois arquivos de relatório locais, problemas conhecidos e exatamente o que é enviado quando você clica em Share.

Guia de interface

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.

Tela de boas-vindas do FFB Probe com um SideWinder FFB2 detectado.

Cabeçalho

O cabeçalho mantém a identidade FFB Probe visível enquanto a etapa atual possui a área de trabalho principal. Os controles de execução aparecem dentro da tela ativa, próximos à ação que afetam.

Progresso

O assistente mostra o progresso no contexto: contagem da lista de verificação antes da sondagem, cartões de seção e contagens de efeitos enquanto as forças estão ativas e um estado de resultado claro quando a execução termina.

Área de trabalho

O corpo é completo e muda com a fase: visualização do stick ao vivo, lista de verificação, diagramas de sinais, chips de resposta ou relatório final/painel de compartilhamento.

FFB Probe Land screen
Etapa 01

Terra

O primeiro lançamento explica o que é FFB Probe, o que o teste exige e por que o banco de dados de hardware público é importante antes que o testador faça qualquer coisa.

FFB Probe Detect screen
Etapa 02

Detectar

A próxima tela identifica o joystick, VID:PID e a capacidade de feedback de força – e mostra uma leitura ao vivo do stick – antes que qualquer força seja executada.

FFB Probe Prepare screen
Etapa 03

Preparar

A lista de verificação faz com que o testador feche os simuladores, libere espaço na mesa, mantenha a mão no stick e lide com as peculiaridades do sensor de aderência FFB2.

FFB Probe Feel screen
Etapa 04

Sentir

A visualização em execução mostra a seção ao vivo, o sinal esperado, a contagem regressiva e o efeito atual sem ocultar o controle Stop.

FFB Probe Answer screen
Etapa 05

Responder

Após cada efeito, duas superfícies capturam a resposta do testador: uma grade de chip (seleção múltipla, pública — esses rótulos aparecem na página do banco de dados de hardware do dispositivo) e uma caixa opcional de notas de texto livre (privada — mantida no lado do servidor, nunca na página pública).

FFB Probe Keep or share screen
Etapa 06

Mantenha ou compartilhe

A página de resultados mantém os relatórios locais por padrão. O compartilhamento envia a carga útil de hardware editada e um campo de e-mail opcional permite que você solicite um aviso se FFB-Bridge começar a oferecer suporte ao seu stick.

As seções ao vivo

O que a sonda pede ao hardware para fazer

A bateria Windows padrão apresenta quatro seções ativas visíveis pela GUI: Constant, Periodic, Condition e Ramp. As contagens podem variar porque a investigação respeita o que cada driver realmente enumera.

Diagrama vetorial de força Constant em FFB Probe.
Os efeitos Constant são renderizados como vetores direcionais.
Diagrama de campo da mola Condition em FFB Probe.
Conditions são renderizados como campos reativos.
Constante

Varredura de polaridade

Um puxão constante por cerca de cinco segundos. Relate a direção física em que o stick se moveu.

Fichas úteis: Esquerda, Direita, Frente, Trás, Não fiz nada

Constante

Diagonal de dois eixos

Uma tração diagonal usando motores X e Y ao mesmo tempo. Não deve deixar o aparelho fraco depois.

Fichas úteis: Diagonal, apenas um eixo, fraco, não fez nada

Periódico

Seno

Uma vibração suave e repetida ou movimento de balanço por cerca de cinco segundos.

Fichas úteis: Oscilação lenta, oscilação rápida, zumbido

Periódico

Quadrado

Uma vibração liga/desliga mais nítida ou batidas repetidas por cerca de cinco segundos.

Fichas úteis: Oscilação rápida, zumbido, um empurrão

Periódico

Triângulo

Um movimento repetido de vaivém, geralmente mais suave que o quadrado, mas mais mecânico que o senoidal.

Fichas úteis: Oscilação lenta, oscilação rápida

Periódico

Dente de serra

Um movimento repetido de rampa ou zumbido. Pode parecer assimétrico.

Fichas úteis: Ramping, zumbido, fraco

Doença

Primavera

Mova suavemente o stick: ele deve empurrar de volta para o centro.

Fichas úteis: Centrado, amortecido, não fez nada

Doença

Amortecedor

Mova suavemente o palito: ele deve resistir ao movimento, como passar por uma calda.

Fichas úteis: Amortecido, Friction, não fez nada

Doença

Inércia

Comece e pare suavemente de mover o stick: ele pode resistir às mudanças de movimento.

Fichas úteis: Inertia, pesado, não fez nada

Doença

Atrito

Mova suavemente o stick: ele pode parecer mais pesado ou pegajoso.

Fichas úteis: Friction, amortecido, não fez nada

Rampa

Varredura Ramp

Uma força que vai de zero até a magnitude configurada em cada atuador testado.

Fichas úteis: Ramping, Esquerda, Trás, Não fez nada

Pós-ao vivo

Sonda de saturação

Múltiplas constantes codirecionais caracterizam como o dispositivo corta quando os efeitos são empilhados.

Fichas úteis: Forte, fraco, cortado, não fez nada

Arquivos de saída

Os dois arquivos que cada execução grava

Os relatórios são salvos em %LOCALAPPDATA%\Programs\ffb-probe\Results\FFB-Probe-<timestamp>\ em Windows e ~/.local/share/ffb-probe/Results/FFB-Probe-<timestamp>/ em Linux. Dois arquivos por execução; o HTML incorpora o JSON em um <pre> bloco para que o relatório local e a carga útil de upload tenham a garantia de serem os mesmos bytes - nenhum segundo artefato oculto.

[] ffb-probe-045E-001B-2026-05-05.html
Relatório independente — abre em um navegador e possui seu próprio botão Share.
~22KB
[] ffb-probe-045E-001B-2026-05-05.json
O SubmissionPayload literal - os mesmos bytes incorporados na parte inferior do HTML, os mesmos bytes dos POSTs da GUI para /submit.
~6KB
Instalando no Windows

Além dos avisos do instalador não assinado

O instalador é feito por usuário – não é necessária senha de administrador nem prompt do UAC. Ele coloca o binário sob %LOCALAPPDATA%\Programs\ffb-probe e escreve um atalho na área de trabalho e uma entrada Start Menu. O seletor de diretório está oculto para que você não possa instalar acidentalmente em algum lugar estranho. Verifique o SHA-256 na página de download corresponde ao arquivo que você tinha antes de executar.

As compilações beta ainda não foram assinadas por código – a assinatura de código está no roteiro da versão 1.0. Dois avisos que você pode receber, ambos esperados:

Windows SmartScreen— "Windows protegeu seu PC"

Você verá uma caixa de diálogo azul com "Aplicativo não reconhecido" ou "Windows protegeu seu PC" e um único Não corra botão. Clique Mais informações no topo, então Corra de qualquer maneira na parte inferior. O mesmo caminho que o instalador da ponte segue.

Windows 11 Smart App Control (SAC)

Se SAC estiver ativado (modo Ativo), o instalador simplesmente não iniciará — nenhum prompt do SmartScreen, não Corra de qualquer maneira opção, nada acontece. SAC recusa completamente qualquer executável não assinado. Solução alternativa até a versão 1.0 enviar binários assinados:

  1. Abrir Configurações → Privacidade e segurança → Segurança Windows → Controle de aplicativo e navegador → Configurações Smart App Control.
  2. Mude SAC para Desligado. Windows avisa que você não pode ligá-lo novamente sem uma instalação limpa - isso só é verdade para a transição OFF → ACTIVE. Indo para Avaliação ou ficar desligado está bem.
  3. Execute o instalador do probe.
  4. Depois de instalado, você pode reativar o SAC se desejar. O binário instalado permanece executável.

Perguntas frequentes sobre SAC da Microsoft cobre a alternância com mais detalhes.

Assim que a versão v1.0 for enviada com um certificado de assinatura de código, ambos os avisos desaparecerão e SAC não bloqueará o instalador. Até então, trate os avisos como esperado e não como evidência de um problema.

Rodando em Linux

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

A detecção pode funcionar com acesso somente leitura, mas os efeitos ao vivo precisam de acesso de gravação ao joystick /dev/input/event* nó. 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 links simbólicos de eventos do joystick:

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

2. Experimente uma permissão temporária

Substituir event2 com o nó para o seu stick. 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 stick e execute o AppImage normalmente. A regra é por dispositivo, por isso é mais seguro do que adicionar seu usuário ao amplo input grupo.

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.

Solução de problemas

Problemas conhecidos e etapas de recuperação

Nenhum dispositivo de feedback forçado detectado

Feche os simuladores de vôo, joy.cpl, Logitech Profiler, e qualquer outra ferramenta que já possua o dispositivo. Desconecte e reconecte o stick e verifique novamente.

O trabalhador caiu no meio da corrida

A GUI continua em execução porque o trabalho perigoso do DirectInput está isolado em um processo de trabalho. Guarde o relatório parcial e envie para o suporte.

A vara continua puxando

Desconecte o USB e a alimentação, aguarde dez segundos, reconecte primeiro a alimentação e depois o USB. O firmware FFB2 pode conter a última força após falhas graves.

SideWinder FFB2 não faz nada

Cubra ou segure frouxamente o sensor de aderência. As chamadas DirectInput podem ser bem-sucedidas enquanto o atuador é controlado pelo sensor óptico.

Permissão Linux negada

Seu usuário pode precisar de acesso de leitura/gravação ao nó /dev/input/event* do stick. Os documentos Linux mostram como testar isso com setfacl e, em seguida, torná-lo persistente com uma regra udev por dispositivo.

Windows SmartScreen“Aplicativo não reconhecido”

O instalador ainda não está assinado por código – a assinatura de código está no roteiro da versão 1.0. Clique em “Mais informações” e depois em “Executar mesmo assim” para continuar. Verifique se o SHA-256 na página de download corresponde ao arquivo que você pegou antes de executar.

Windows 11 Smart App Control bloqueia o instalador

Se SAC estiver ativado, o instalador simplesmente não será iniciado - nenhum prompt, nenhum "Executar mesmo assim". Desative o SAC em Configurações → Privacidade e segurança → Segurança Windows→ Controle de aplicativo e navegador → Configurações do Smart App Control, instale a sonda e ligue o SAC novamente. As compilações beta não são assinadas; assim que enviarmos a assinatura de código para 1.0, esta etapa desaparecerá.

Modelo de privacidade

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

A execução do probe localmente não envia nada — os dois arquivos permanecem no disco. Clicando Share POST o arquivo JSON para /submit neste servidor. Esse JSON são os mesmos bytes incorporados na parte inferior do relatório HTML; você pode lê-lo antes de compartilhar.

O banco de dados de hardware público renderiza uma visualização agregada por VID:PID. O único campo nunca exibido é o por efeito notas de texto livre — o que o testador digitou na caixa de notas opcionais durante a execução. Todo o resto (seleções de chips, sinalizadores de capacidade, efeitos suportados, códigos HRESULT, efeitos com falha, erros de execução) aparece na página do dispositivo exatamente como o teste o escreveu.

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