Huidige release. FFB-Bridge v1.2.1 is live. Deze documentatie volgt de huidige app zoals beschreven door het releasemanifest. Als een onderdeel verouderd lijkt, meld dat via het feedbackformulier.

Ondersteuningspagina

De ondersteuningspagina (gelabeld Ondersteuning in de zijbalk) is de enige plek voor alles wat je opent als er iets mis is, als je een referentie nodig hebt of als je een ondersteuningsbundel voor de ontwikkelaar wilt exporteren. Drie tabbladen: Bronnen, Gezondheidscontroles, en Diagnostiek. De hardwarecompatibiliteitsinstellingen die hier vroeger stonden, zijn verplaatst naar Instellingen → Hardware.

Ondersteuningspagina. Het standaard tabblad Health checks toont één rij per probe, met de status PASS / INFO / WARN / FAIL en contextuele actieknoppen wanneer er een oplossing beschikbaar is. Ondersteuningspagina. Het standaard tabblad Health checks toont één rij per probe, met de status PASS / INFO / WARN / FAIL en contextuele actieknoppen wanneer er een oplossing beschikbaar is.
Figuur 1. Ondersteuningspagina. Het standaard tabblad Health checks toont één rij per probe, met de status PASS / INFO / WARN / FAIL en contextuele actieknoppen wanneer er een oplossing beschikbaar is.

Tabstrook

De ondersteuningspagina wordt geopend op de Bronnen tabblad — documenten + handleidinglinks + de herhaling van de welkomstrondleiding staan daar als een vriendelijke eerste landing. De andere twee tabbladen zijn slechts één klik verwijderd:

  • Bronnen (opent eerst) — links naar de documenten en handleiding die hier worden gehost, plus de herhaling van de welkomstrondleiding en de uitgevers-/juridische pagina's.
  • Gezondheidscontroles — het alledaagse triage-oppervlak (apparaat, udev-regel op Linux, sim-bereikbaarheid, runtime-status). Klik Controles uitvoeren om te onderzoeken.
  • Diagnostiek — runtime-statistieken, het doorzoekbare gebeurtenislogboek en export van ondersteuningsbundels met één klik. Afzonderlijk gedocumenteerd op de Diagnosetab pagina.

Hardwarecompatibiliteit (astest met omkeren + pitch/roll swap, effectweergave, de Windows-apparaatbackend, de apparaatkiezer en de Hardware-effecten testen -sonde) is niet langer een tabblad Ondersteuning – het leeft voort Instellingen → Hardware.

Tabblad Gezondheidscontroles

Gezondheidscontroles zijn het pad dat de meeste testers nodig hebben als er iets niet klopt. Klik Controles uitvoeren om de toestand van de brug te onderzoeken. Rijen worden onafhankelijk bijgewerkt, zodat een langzame sim-probe niet blokkeert dat het apparaat of het runtime-resultaat verschijnt.

  • GESLAAGD betekent dat de bridge dat deel van de installatie heeft geverifieerd.
  • INFO betekent dat er niets aan de hand is, maar dat de rij een nuttige context heeft. Er wordt bijvoorbeeld verwacht dat X-Plane niet luistert wanneer u met MSFS vliegt of de Mock-modus gebruikt.
  • WAARSCHUWING betekent dat de installatie kan worden voortgezet, maar dat er iets is dat de moeite waard is om te repareren of te melden.
  • FOUT betekent dat de brug een blokkeringsprobleem heeft gevonden. Wanneer Health Checks een veilige oplossing kent, biedt de rij een actieknop.
  • KLAAR en CONTROLEREN zijn neutrale toestanden die vóór en tijdens een run worden gebruikt.

Hardwarebediening verplaatst naar Instellingen

De hardwarecompatibiliteitsknoppen waren vroeger een tabblad Ondersteuning. Ze leven nu voort Instellingen → Hardware: het leven astest (met Keer de aspolariteit om en Pitch/roll-assen verwisselen), de Effectweergave radio (hardware-effecten versus software-compatibiliteitsmodus), de backend van Windows-apparaten, de apparaatkiezer voor meerdere aangesloten sticks, de experimentele aanmelding voor niet-vermelde apparaten en de Hardware-effecten testen sonde. Zie de Pagina Instellingen voor de volledige uitleg.

Instellingen → Hardware — de astest (omkeren + pitch/roll-wisseling), effectweergave, de Windows-apparaatbackend en de probe om hardware-effecten te testen. Instellingen → Hardware — de astest (omkeren + pitch/roll-wisseling), effectweergave, de Windows-apparaatbackend en de probe om hardware-effecten te testen.
Figuur 2. Instellingen → Hardware — de astest (omkeren + pitch/roll-wisseling), effectweergave, de Windows-apparaatbackend en de probe om hardware-effecten te testen.

Hoe controles zijn ingericht

Elke controlerij bestaat uit vier delen:

  • Status — PASS (groen), INFO (blauw), WARN (oranje), FAIL (rood), READY / CHECKING (neutraal), of N.v.t. wanneer de rij niet van toepassing is op dit platform.
  • Titel – wat wordt gecontroleerd.
  • Details — een samenvatting van één regel van wat er is gevonden. Beweeg de muis (of tik op aanraking) om alle details te zien.
  • Actieknop - alleen aanwezig als er iets actiegerichts is. Voorbeelden: Installeer udev-regel, Gebruik poort :5111, Repareren….

De cheques

Apparaat

Bevestigt dat een ondersteunde joystick met forcefeedback zichtbaar is voor het besturingssysteem en dat de bridge deze exclusief kan openen. Mislukt als er geen ondersteunde VID/PID aanwezig is, of als een ander proces de hendel vasthoudt.

Linux udev-regel

Controleert of /etc/udev/rules.d/99-ffb-bridge.rules aanwezig is en overeenkomt met de canonieke inhoud. Bij afwezigheid is de actie Installeer udev-regel – dit veroorzaakt een pkexec gevraagd om het bestand naar een bevoorrechte locatie te schrijven.

NixOS-uitzondering

Gezondheidscontroles detecteren NixOS (door te zoeken naar /etc/NIXOS) en vervangt de rij udev-regels door een instructie waaraan u de regel kunt toevoegen configuration.nix in plaats daarvan. Zie Installeren voor het fragment.

WindowsLinux SimConnect-configuratie

SimConnect is het MSFS-pad, dus deze controle wordt uitgevoerd op Windows en Linux. Er wordt gezocht naar MSFS's SimConnect.xml op de voor het platform geschikte locatie, ontleedt het en vergelijkt eventuele ingeschakelde IPv4-vermeldingen met de poort die de bridge gebruikt. Drie mogelijke uitkomsten:

  • Overeenkomende vermelding gevonden. Groen – niets te doen.
  • Ingang op een andere poort. Amber — biedt een Gebruik poort:X knop om die poort over te nemen.
  • Geen bruikbare vermelding (of niet-parseerbaar bestand). Rood — biedt een Repareren… knop waarmee het installatiedialoogvenster wordt geopend (zie hieronder).
Linux gebruikt een poort zonder privileges

MSFS verzendt zijn standaard SimConnect-item op poort 500. Op Windows bindt dat prima en de bridge gebruikt het. Onder Proton op Linux kan een gebruikersnaamruimteproces geen betaalmuuren onder 1024 binden, dus installeert en gebruikt de bridge een parallelle ingang op een niet-bevoorrechte poort (standaard 5111) die MSFS-in-Proton daadwerkelijk kan binden - en dat is de reden waarom de Linux-fix en de Gebruik poort actiepunt op die hogere poort.

Bereikbaarheid van SimConnect

Onderzoekt de geconfigureerde TCP-poort. Verzendt een echt SimConnect OPEN-pakket en inspecteert de antwoordheader zodat deze onderscheid kan maken MSFS luistert van er luistert iets anders.

Bereikbaarheid X-Plane

Het X-Plane-pad werkt op elk platform - en op macOS (Apple Silicon) is X-Plane 12 met een SideWinder FFB2 de ondersteunde combinatie. Deze controle stuurt een kleine RREF-sonde naar 127.0.0.1:49000 en wacht kort op een dataref als antwoord. Brengt zowel de time-out als die van Winsock in kaart WSAECONNRESET (ontvangen toen een ICMP-poort die niet bereikbaar was, werd afgeleverd) naar "niet actief".

Looptijd

Controleert of de regellus tikt op de beoogde 50 Hz. Waarschuwt als het gemiddelde van de afgelopen 60 seconden onder de 45 Hz daalt.

Crashlogboek

Als er een crashlogboek van de laatste sessie is, wordt de rij oranje en wordt er een aanbieding weergegeven Onthullen om ernaar te springen in uw bestandsbeheerder, en Verzenden via feedbackformulier waarmee een feedbackinzending vooraf wordt ingevuld met het bijgevoegde logboek.

Dialoog repareren

Repareren… knoppen passen de wijzigingen niet rechtstreeks toe; ze openen een dialoogvenster waarin precies wordt weergegeven wat er gaat veranderen, waar en (op Linux) wat de auth-prompt je zal vragen goed te keuren.

Dialoogvenster voor installatie van SimConnect-configuratie repareren. Het exacte XML-fragment dat moet worden toegevoegd, wordt weergegeven, samen met een voorbeeld van het resulterende bestand. Dialoogvenster voor installatie van SimConnect-configuratie repareren. Het exacte XML-fragment dat moet worden toegevoegd, wordt weergegeven, samen met een voorbeeld van het resulterende bestand.
Figuur 3. Dialoogvenster voor installatie van SimConnect-configuratie repareren. Het exacte XML-fragment dat moet worden toegevoegd, wordt weergegeven, samen met een voorbeeld van het resulterende bestand.

De dialoog is altijd additief: bestaande vermeldingen worden nooit overschreven. Als het doelbestand niet kan worden geparseerd, wordt in het dialoogvenster uitgelegd dat er eerst een back-up met tijdstempel wordt gemaakt. Annuleren is altijd de veilige keuze.

Linux pkexec-gedrag

Acties die naar systeempaden schrijven (udev-regels, alles onder /etc) route door pkexec. Je ziet de normale polkit-prompt van je distro – dezelfde die verschijnt voor gparted of een pakketbeheerder GUI. Uitgangscodes Gezondheidscontroles interpreteren:

AfsluitenBetekenisRapporten over gezondheidscontroles
0SuccesGroen vinkje; rij wordt opnieuw geëvalueerd.
126De gebruiker heeft de verificatieprompt afgewezenAmber “Geannuleerd” – probeer het opnieuw als u klaar bent.
127Geen polkit-agent/authenticatiefoutRood “Authenticatie mislukt.”
Tip

Het uitvoeren van de bridge in een minimale omgeving (Linux zonder hoofd, sway zonder een polkit-agent) is prima; je kunt alleen de bevoorrechte oplossingen van de ondersteuningspagina niet gebruiken. Installeer de vereiste bestanden handmatig of start een polkit-agent voordat u de bridge start.

Als elk vinkje groen is

De app zou moeten werken. Als dit niet het geval is, schakelt u over naar de Diagnosetab — het gebeurtenislogboek zal meer details tonen dan de éénregelige statussen van gezondheidscontroles. Of spring naar Problemen oplossen voor veel voorkomende symptomen en oplossingen.