Hoe FFB Probe werkt

De begeleide run

FFB Probe is georganiseerd rond één korte testerreis: land op het waardeprop-scherm, detecteer de stick, bevestig de veiligheidschecklist, voel elk live-effect, beantwoord wat er is gebeurd en bewaar of deel vervolgens het resulterende rapport. Elk scherm richt zich op de taak die moet worden uitgevoerd, zodat testers altijd weten wat ze vervolgens moeten doen.

Stap 01

Land

Het eerste scherm legt uit wat FFB Probe test, wat je krijgt en waarom de openbare hardwaredatabase bestaat. Er gebeurt niets met de hardware totdat je doorgaat.

Stap 02

Detecteer

Het welkomstscherm identificeert het forcefeedbackapparaat, de VID:PID en de ondersteunde effecten, en toont een live weergave van de stick voordat er enige kracht wordt afgespeeld.

Stap 03

Voorbereiden

De checklist stelt de teststerkte in, vraagt je de veiligheidsmelding te accepteren en bevestigt dat andere software gesloten is en de stick ruimte heeft om te bewegen.

Stap 04

Gevoel

Elk effect speelt gedurende een vast venster, terwijl het scherm de sectie, het verwachte signaal en een aftelling toont. ‘Stop run’ blijft zichtbaar, en Esc stopt de run op elk moment.

Stap 05

Antwoord

Tik na elk effect elke chip aan die past bij wat je voelde. Chips zijn openbaar; het optionele notitieveld blijft privé. Met ‘Continue’, ‘Run test again’ of ‘Skip’ ga je verder.

Stap 06

Bewaar of deel

Het rapport wordt eerst op je computer opgeslagen. ‘Share my results’ verstuurt de geredigeerde payload; daarna toont de app een supportcode en een link naar de openbare pagina van het apparaat.

Welkom: detectie en andere programma’s

Het welkomstscherm zoekt naar forcefeedbackapparaten en toont het apparaat dat getest wordt, met de VID:PID, het aantal ondersteunde effecten en een live weergave van de stick. Alleen dat apparaat wordt getest. Re-scan herhaalt de detectie nadat je iets hebt aangesloten of een ander programma hebt gesloten.

Als er een programma draait dat het apparaat kan overnemen, zoals een vluchtsimulator, FFB-Bridge, MOZA Cockpit of Pit House, de tools van Brunner of Logitech G HUB, noemt een oranje kaart Other software running dat programma en legt uit hoe je het sluit. De waarschuwing blokkeert de run niet; klik na het sluiten van het programma op Re-check.

Brunner-bases worden geleverd in de CLS2Sim-modus, die geen forcefeedbackinterface heeft. Als er geen forcefeedbackapparaat wordt gevonden, zoekt FFB-Probe naar een Brunner-base en biedt Switch to DirectX mode aan; zonder die klik wordt er niets omgeschakeld. Switch back to CLS2Sim mode when finished is standaard aangevinkt, zodat de base terugkeert naar de CLS2Sim-modus na de run, wanneer je FFB-Probe sluit, of bij de volgende start als FFB-Probe onverwacht werd afgesloten. Alleen de USB-modusinstelling wordt geschreven, nadat je oorspronkelijke modus is vastgelegd, en als een stap mislukt, wordt de base teruggezet zoals hij was.

Als Simux, CLS2Sim, de Brunner USB Config Tool of FFB-Bridge de base bezet, noemt de kaart dat programma en vraagt je het af te sluiten, ook vanuit het systeemvak, voordat je op Re-scan klikt. Firmware zonder DirectX-modus wordt gemeld en er wordt niets geschreven.

Checklist: sterkte, veiligheid en gereedheid

Test strength bepaalt hoe krachtig elk effect het apparaat aanstuurt, van 0% tot 75% in stappen van 5%. Sticks waarop de tests zijn gevalideerd, beginnen op 75%: de SideWinder Force Feedback 2, de SideWinder FFB Pro USB-adapters (03EB:2056, CAFE:4004), de Logitech G940, Force 3D Pro en WingMan Force 3D, en de Brunner FFB-G Joystick, herkend aan het basetype dat hij via het configuratiekanaal van Brunner meldt, welke greep er ook op zit. Alle andere apparaten, waaronder andere Brunner-bases, MOZA-vliegbases en hardware die FFB-Probe nog niet kent, beginnen op 35%. Als Simux, CLS2Sim, de Brunner USB Config Tool of FFB-Bridge dat kanaal bezet, kan het basetype niet worden gelezen; de base begint dan op 35% en de checklist vraagt je het programma te sluiten en op Re-scan te klikken. FFB-Probe onthoudt per apparaat de sterkte die je het laatst hebt gekozen.

De melding Safety wordt altijd getoond: forcefeedbackapparaten kunnen plotseling en met echte kracht bewegen, dus laat een hand licht op de greep rusten, houd vingers, kabels en voorwerpen uit de buurt, en stop op elk moment met Esc of ‘Stop run’. Arm probe blijft uitgeschakeld totdat je I understand and accept responsibility aanvinkt en elk checklistitem bevestigt. Als je de sterkte boven de standaardwaarde van het apparaat zet, verschijnt een extra waarschuwing dat krachtige direct-drive-bases hard tegen hun eindaanslagen kunnen slaan.

De checklist past zich aan het apparaat aan. Bij de SideWinder FFB2 en de Logitech G940 komt er een item voor handdetectie bij, omdat hun gripsensor de motoruitvoer onderbreekt wanneer niemand de stick vasthoudt. Bij een VID:PID die niet in de hardwaretabel van de app staat, wordt gevraagd naar de echte fabrikant en het model.

MOZA-vliegbases

Voor een MOZA AB9, AY210, AB6 of AY90 voegt de checklist een kaart MOZA BASE toe. Die leest, zonder iets te wijzigen, of de base effecten echt zal afspelen: een base in de Telemetry-modus van MOZA Cockpit, of met forcefeedback uitgeschakeld, koppeluitvoer geblokkeerd of de game-versterking op 0, accepteert elk effect en beweegt niets.

Als de base niet klaar is, somt de kaart de redenen op en biedt Prepare base for testing aan, dat je instellingen opslaat, de base in de DirectInput-modus zet en de blokkades voor krachtuitvoer opent. Restore my MOZA settings when finished is standaard aangevinkt en zet ze terug na de run of wanneer je FFB-Probe sluit. Uitslaglimieten, kalibratie en Force Sensing worden nooit aangeraakt. Als MOZA Cockpit, MOZA Pit House of FFB-Bridge de instellingenpoort bezet, noemt de kaart dat programma; sluit het en klik op Re-check.

Uitvoeren: voelen, antwoorden, stoppen

De run is verdeeld in vier secties: Constant, Periodic, Condition en Ramp. Elk effect speelt gedurende een vast venster, vijf seconden op Windows en tweeënhalve seconde op Linux, en wordt gestopt zodra dat venster eindigt. Daarna vraagt de antwoordkaart wat je voelde: tik elke chip aan die past, voeg eventueel een privénotitie toe en kies Continue, Run test again of Skip.

Stop run is zichtbaar in de kopbalk en naast het aftellen, en Esc stopt de run op elk moment. Als je het venster tijdens een run sluit, worden eerst de effecten gestopt en wordt het apparaat vrijgegeven. Wat vóór het stoppen is gemeten, wordt lokaal opgeslagen.

Resultaat: bewaren, delen en opvolgen

Het resultaatscherm toont waar het rapport is opgeslagen, met Show in folder en See my results. Share my results verstuurt de geredigeerde payload; anders wordt er niets geüpload. Na het delen toont de app een supportcode en een link naar de openbare pagina van het apparaat, en de Share-knop in het HTML-rapport toont ze ook. Bewaar de code als je later misschien iets over de inzending wilt vragen of haar wilt laten verwijderen. Via een optioneel e-mailveld kun je je aanmelden voor nieuws, onder meer wanneer FFB-Bridge je stick ondersteunt.

Als een ander programma het apparaat exclusief bezette, noemt het resultaat dat programma en legt uit dat de run niets van het apparaat heeft gemeten. Een Brunner-base die voor de test is omgeschakeld, of een MOZA-base die ervoor is voorbereid, wordt hersteld zodra de probe-engine is afgesloten.

Wat de sonde van de hardware vraagt

Windows groepeert de livebatterij in de secties Constant, Periodic, Condition en Ramp. Linux toont de gelijkwaardige evdev-effecten die elk apparaat meldt. De precieze aantallen verschillen op beide platforms per stuurprogramma en hardware.

Teststerkte en de limiet van 75%

Elk effect speelt op de teststerkte die op de checklist is gekozen. Niets wat FFB-Probe afspeelt, komt boven 75% van de volle schaal, op geen enkel apparaat en in geen enkele test, ook niet via de opdrachtregeloptie --magnitude of de diagnostische modi. Effecten die tegelijk spelen, delen de sterkte, zodat ze samen nooit hoger uitkomen. Elk rapport legt de sterkte vast en of je die hebt gewijzigd.

Autocentrering en stoptiming

De eigen autocentreerveer van het apparaat wordt tijdens de live tests uitgeschakeld en daarna hersteld, zodat hij het geteste effect niet tegenwerkt of maskeert. Elk effect wordt gestopt zodra het afspeelvenster eindigt, in plaats van wanneer je antwoordt. De Logitech G940 op Linux is de uitzondering: het stuurprogramma negeert de autocentreerinstelling, dus FFB-Probe laat die ongemoeid en vermeldt dat de hardware-autocentrering actief was.

Gemeten beweging

Terwijl elk effect speelt, bemonstert de probe op Windows en Linux de X- en Y-as van de stick en legt de piekuitslag vast als percentage met teken van het halve bereik van elke as, bijvoorbeeld X peak +25.1%, Y peak -0.8%. Het teken geeft de richting aan, waardoor een richtingsantwoord controleerbaar bewijs wordt. De beweging wordt gemeten vanaf de positie waarin de stick rustte toen het effect begon, dus een stick die buiten het midden rust, kan meer dan 100% tonen. Condition-effecten zoals veer en demper bewegen een gecentreerde stick niet, dus daarbij wordt in rust geen beweging verwacht. De meting blijft in het privéveld met antwoordnotities en wordt niet op openbare apparaatpagina’s getoond.

Brunner-bases

Een Brunner-base vermenigvuldigt elk DirectX-effect met versterkingen die hij zelf opslaat, af fabriek 50%. Voor de live tests zet FFB-Probe FX master en de effectversterkingen op 100%, nooit hoger en zonder de globale demping aan te raken, en herstelt daarna je eigen waarden, ook als je een run stopt. In de DirectX-modus wijst de base zijn assen 90° gedraaid toe: 0° trekt naar rechts, 90° naar voren, 180° naar links en 270° naar achteren. Dat is firmwaregedrag van Brunner; FFB-Probe legt het vast zoals gemeten en corrigeert het niet.

De twee bestanden die elke run schrijft

Rapporten worden op Windows opgeslagen in %LOCALAPPDATA%\Programs\ffb-probe\Results\FFB-Probe-<timestamp>\ en op Linux in ~/.local/share/ffb-probe/Results/FFB-Probe-<timestamp>/. Elke run schrijft twee bestanden: het HTML-rapport en de JSON om te delen. De HTML bevat de JSON in een <pre>-blok, zodat het lokale rapport en de uploadpayload exact dezelfde bytes zijn. De oudere tekst-, README- en support-ZIP-bestanden worden alleen geschreven als FFB_PROBE_KEEP_LEGACY=1 is ingesteld.

Windows-installatie en uitgeverscontroles

FFB Probe wordt uitgegeven door Rohsam Inc. Het installatieprogramma wordt per gebruiker geïnstalleerd: er is geen beheerderswachtwoord vereist, geen UAC-prompt. Het plaatst het binaire bestand onder %LOCALAPPDATA%\Programs\ffb-probe en schrijft een snelkoppeling op het bureaublad en een Start Menu-invoer. De mapkiezer is verborgen, zodat u niet per ongeluk ergens anders kunt installeren. Stabiele Windows-releases zijn ondertekend; controleer of Windows Rohsam Inc. als de uitgever toont en controleer de SHA-256 op de downloadpagina voordat u het uitvoert.

Als Windows Rohsam Inc. niet als de geverifieerde uitgever van uw installatieprogramma toont, of als de hash niet overeenkomt met het gepubliceerde manifest, voer dat bestand dan niet uit.

Het releasemanifest is de gezaghebbende bron voor bestandsnamen, groottes en hashes. Het Windows-installatieprogramma en de Linux AppImage zijn beide opt-in downloads; bij het uitvoeren van de probe blijven rapporten lokaal totdat u Share kiest.

AppImage plus evdev-machtigingen

De Linux bouwt schepen als een op zichzelf staande AppImage. Markeer het uitvoerbaar bestand, voer het uit en houd de stick ingeschakeld met bewegingsruimte:

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

De AppImage kan direct worden uitgevoerd, of ./FfbProbe-*.AppImage --install kan gebruikersgebonden desktopintegratie onder ~/Applications toevoegen. Gebruik --uninstall om die geïnstalleerde kopie en menuvermelding te verwijderen.

Detectie kan werken met alleen-lezen toegang, maar live-effecten hebben schrijftoegang nodig tot het /dev/input/event*-knooppunt van de joystick. Als de wizard toestemmingsfouten rapporteert, repareer dan één keer de machtigingen voor het gebeurtenisknooppunt van het apparaat in plaats van de hele AppImage uit te voeren met sudo.

1. Zoek het gebeurtenisknooppunt

De rapport- of fouttekst noemt het meestal zoiets als event=/dev/input/event2. U kunt ook symbolische koppelingen voor joystickgebeurtenissen bekijken:

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

2. Probeer een tijdelijke toestemming

Vervang event2 door het knooppunt voor uw stick. Dit duurt totdat het apparaat wordt losgekoppeld of de machine opnieuw wordt opgestart, dus het is een veilige manier om het probleem te bevestigen:

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

3. Maak het persistent met udev

Vraag udev naar de USB-ID's van de stick:

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

Gebruik deze hexadecimale ID's in kleine letters in een apparaatspecifieke regel. Dit voorbeeld is voor een 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

Koppel de stick los en sluit deze opnieuw aan, en laat de AppImage normaal draaien. De regel geldt per apparaat, dus het is veiliger dan uw gebruiker toevoegen aan de brede input-groep.

4. Brunner-bases: de configuratie-interface

Om een Brunner-base tussen de CLS2Sim- en DirectX-modus om te schakelen en de versterkingen voor de run te verhogen, gebruikt FFB-Probe de hidraw-configuratie-interface van de base, die standaard alleen voor root toegankelijk is. Als de toegang wordt geweigerd, toont FFB-Probe de regel die je moet toevoegen. De udev-regel van FFB-Bridge bevat die al; maak anders dit bestand aan en sluit de base opnieuw aan:

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. MOZA-bases: de instellingenpoort

De MOZA-gereedheidscontrole en Prepare base for testing communiceren met de base via de seriële USB-instellingenpoort, /dev/ttyACM*. Als FFB-Probe de poort niet kan openen, stelt het de groep dialout voor; meld je na het toevoegen af en weer aan:

sudo usermod -aG dialout "$USER"

Een regel per apparaat geeft dezelfde toegang alleen aan de actieve desktopgebruiker:

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

Als een ander programma het apparaat bezet

Vóór de tests opent de Linux-worker het event-knooppunt één keer. Als het knooppunt bezet is (EBUSY), noemt FFB-Probe de processen die het vasthouden, gevonden via /proc/*/fd. Als de toegang wordt geweigerd (EACCES of EPERM), verwijst het naar de bovenstaande stappen voor machtigingen. Processen van andere gebruikers of van root kunnen zonder extra rechten niet worden opgesomd, en de melding zegt dat ook.

Kernel-autocentrering wordt uitgeschakeld terwijl elk effect speelt en tussen de effecten door hersteld. Op de Logitech G940 wordt er nooit aan gekomen, omdat het Linux-stuurprogramma daarvan de instelling negeert en altijd op volle sterkte centreert.

De Linux-wizard gebruikt evdev force-feedback-effecten in plaats van DirectInput. Het gedeelde rapportschema is hetzelfde als dat van Windows, dus Linux-inzendingen verschijnen in dezelfde openbare database en uitsplitsing van het besturingssysteem.

Updates na toestemming op Windows en Linux

De GUI leest bij het opstarten een klein manifest met stabiele release. Het verzendt geen installatie-ID, query naar de huidige versie, apparaatinformatie of testresultaten; offline en verkeerd opgemaakte reacties blijven stil.

Een update wordt nooit aangeboden terwijl een run bezig is, en er wordt niets geïnstalleerd zonder je toestemming. Stabiele builds krijgen alleen stabiele releases aangeboden; een bètabuild krijgt nieuwere bèta’s aangeboden en de stabiele release die ze vervangt.

Na expliciete toestemming downloadt FFB-Probe het installatieprogramma, verifieert de exacte lengte en SHA-256, vereist een geldige Windows handtekening van Rohsam Inc., voert het installatieprogramma per gebruiker stil uit en start de nieuwe build opnieuw.

Een actieve Linux AppImage kan de nieuwe AppImage downloaden en verifiëren, de gebruikersspecifieke installatiehandler aanroepen, het bureaubladitem en de pictogrammen vernieuwen en de geïnstalleerde kopie starten.

Ontwikkelingsbuilds, uitgepakte AppDirs, distributiepakketten en andere niet-AppImage Linux installaties worden nooit overschreven. De prompt linkt in plaats daarvan naar de downloadpagina en deze release-opmerkingen, en elke gebruiker kan een versie uitstellen of overslaan.

Bekende problemen en herstelstappen

De letterlijke bytes vormen het auditoppervlak

Je rapportbestanden blijven lokaal tenzij je op Share klikt. Bij delen wordt het JSON-bestand via POST naar /submit gestuurd; dit zijn dezelfde bytes die onderaan het HTML-rapport staan. Los daarvan voert de GUI bij het opstarten de hierboven beschreven manifestcontrole zonder identificatoren uit, zonder rapport- of apparaatgegevens te verzenden.

De openbare hardwaredatabase toont een samengevoegde weergave per VID:PID. responses[].notes wordt nooit weergegeven; dit veld kan optionele testertekst en de door de probe gemeten beweging bevatten. Keuzelabels, de apparaatklasse, de teststerkte (run), capaciteitsvlaggen, ondersteunde effecten, resultaatcodes, mislukte effecten en uitvoeringsfouten kunnen op de apparaatpagina verschijnen.

De waarschuwing op het welkomstscherm over andere actieve programma’s en de melding over exclusieve toegang zijn alleen voor jou zichtbaar; de programmanamen daarin worden nooit aan het rapport toegevoegd.

Lees het volledige privacycontract → · Open het geüploade voorbeeldrapport →