Ondersteuningspagina

De ondersteuningspagina is de centrale plek voor documentatie, statuscontroles, diagnostiek, logboeken en export van ondersteuningsbundels. Configuratie van fysieke apparaten staat nu onder Hardware.

Figure 1. Ondersteuning → Statuscontroles toont één rij per controle, met GESLAAGD / INFO / WAARSCH. / MISLUKT en een actie als reparatie beschikbaar is. Het tabblad Hulpbronnen wordt als eerste geopend.

Tabstrook

De ondersteuningspagina opent op het tabblad Hulpbronnen met links naar de online documentatie en de meegeleverde PDF. De andere twee tabbladen zijn één klik verder:

Hulpbronnen (opent als eerste) — officiële documentatie en de PDF-handleiding. Start de welkomstgids opnieuw via Instellingen → Algemeen.
Statuscontroles — 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 Tabblad Diagnostiek pagina.

Apparaatselectie, richtingskalibratie, gevalideerde weergave, sterktelimieten en besturingstoewijzingen leven onder Hardware.

Tabblad Statuscontroles

Statuscontroles 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.
WAARSCH. betekent dat de installatie kan worden voortgezet, maar dat er iets is dat de moeite waard is om te repareren of te melden.
MISLUKT betekent dat de brug een blokkeringsprobleem heeft gevonden. Wanneer Statuscontroles een veilige oplossing kent, biedt de rij een actieknop.
GEREED en CONTROLE LOOPT zijn neutrale toestanden die vóór en tijdens een run worden gebruikt.

Automatische apparaatcontrole bij het opstarten

Bij het starten controleert FFB-Bridge stil de apparaatbackend op Windows, Linux en macOS. Op Linux worden ook lees- en schrijftoegang tot een ondersteund event-knooppunt en de dekking van alle actuele apparaatmachtigingen door de geïnstalleerde udev-regel gecontroleerd. WAARSCH. of MISLUKT opent een venster dat elk probleem noemt, met ‘Nu bekijken en oplossen’ en ‘Voorlopig negeren’.

Als alle controles slagen, wordt niets geopend.
Bij het opstarten worden simulator en netwerk niet gecontroleerd. Een gesloten simulator is normaal en wordt tijdens uitvoering behandeld.
Automatisch activeren wacht zolang het venster geopend is. Het probleem kan worden beoordeeld en opgelost, of het venster kan worden gesloten als het apparaat bewust is losgekoppeld. Daarna kan automatisch activeren alleen doorgaan wanneer de overige voorwaarden zijn geslaagd.

Figure 2. Ondersteuning → Statuscontroles toont GESLAAGD voor een ondersteund event-node, WAARSCH. met ‘Herstellen…’ voor een verouderde udev-regel en MISLUKT voor het fysieke apparaat.

Hardware

De voormalige hardwarebedieningen op de ondersteuningspagina hebben nu een speciaal gebied. Gebruik Flight Check voor tests van geïsoleerde effecten en gebruik Hardware voor permanente instellingen van fysieke apparaten. Open de hardwaregids.

Hoe controles zijn ingericht

Elke controlerij bestaat uit vier delen:

Status — GESLAAGD (groen), INFO (blauw), WAARSCH. (oranje), MISLUKT (rood), GEREED / CONTROLE LOOPT (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: Lokale vermelding installeren, Poort 5111 gebruiken, Herstellen….

De cheques

FFB-joystickapparaat

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

Statuscontroles controleren of /etc/udev/rules.d/71-ffb-bridge.rules alle actuele invoerregels van ondersteunde apparaten, de MOZA TTY-machtigingen en de hidraw-toegang die de Logitech G940 en Brunner-bases gebruiken, bevat. ‘Herstellen…’ toont de canonieke beheerde regel, installeert deze via pkexec, verwijdert het vroegere 99-ffb-bridge.rules, herlaadt udev en triggert invoer-, TTY- en hidraw-apparaten. Een aangesloten, expliciet ingeschakelde, niet-vermelde joystick wordt tijdens installatie toegevoegd.

Een oudere regel wordt als WAARSCH. gemeld wanneer deze geen actuele apparaatmachtiging heeft, zoals de MOZA TTY-lijnen of de hidraw-toegang die de Logitech G940 en Brunner-bases gebruiken, of wanneer de bestandsnaam ervoor zorgt dat de regel te laat wordt uitgevoerd voor toegang vanuit de bureaubladsessie, zoals bij het vroegere 99-ffb-bridge.rules. Gebruik ‘Herstellen…’ zelfs als het bestand al bestaat; de app installeert de volledige gegenereerde regel als 71-ffb-bridge.rules en verwijdert het vroegere bestand.

Na succesvol herstel is de regel actief en raadt de app een herstart aan. ‘Nu opnieuw starten’ opent de joystick opnieuw met de nieuwe machtigingen en laat een startfallback los; ‘Ik start later opnieuw’ kiezen is veilig als je eerst wilt doorgaan.

Figure 4. Het Linux-herstelvenster toont vóór de toestemmingsvraag de canonieke invoer- en MOZA TTY-regel voor ondersteunde apparaten. Een aangesloten, expliciet ingeschakelde, niet-vermelde joystick wordt tijdens installatie toegevoegd.

Figure 5. Na succesvol herstel is de regel actief en raadt de app een herstart aan. ‘Nu opnieuw starten’ opent de joystick opnieuw met de nieuwe machtigingen en laat een startfallback los; ‘Ik start later opnieuw’ kiezen is veilig als je eerst wilt doorgaan.

NixOS-uitzondering

Statuscontroles 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 MSFS 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 Herstellen… 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 MSFS

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 van X-Plane

De X-Plane-verbinding is beschikbaar op Windows, Linux en macOS met Apple Silicon. Deze controle stuurt een RREF-verzoek 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".

Runtimestatus

Vat de huidige status van apparaat, gegevensbron, telemetrie en uitzonderingen samen. GESLAAGD betekent dat het apparaat geopend is en dat live sim- of Mock Sim-gegevens de pijplijn aansturen; INFO betekent dat het apparaat geopend is zonder live sim-gegevens, wat te verwachten is zolang de sim gesloten is; MISLUKT betekent dat het apparaat niet geopend is.

Crashrapport

Als de vorige sessie is gecrasht, toont FFB-Bridge bij de volgende start een crashrapportvenster in plaats van een rij in Statuscontroles. Gebruik Kopiëren om de opgeslagen stacktrace te kopiëren, en Feedbackformulier openen om de feedbackpagina in uw browser te openen, waar u de log kunt plakken en een ondersteuningsbundel kunt toevoegen.

Dialoogvenster Herstellen

Herstellen… 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.

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 die Statuscontroles interpreteren:

Afsluiten	Betekenis	Rapporten over Statuscontroles
`0`	Succes	Groen vinkje; rij wordt opnieuw geëvalueerd.
`126`	De gebruiker heeft de verificatieprompt afgewezen	Amber “Geannuleerd” – probeer het opnieuw als u klaar bent.
`127`	Geen polkit-agent/authenticatiefout	Rood “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 Tabblad Diagnostiek — het gebeurtenislogboek zal meer details tonen dan de éénregelige statussen van Statuscontroles. Of spring naar Problemen oplossen voor veel voorkomende symptomen en oplossingen.

Als MSFS 2020 en 2024 of meerdere installaties aanwezig zijn, controleer dan elk benoemd configuratiedoel voordat je het repareert. Een reparatie werkt de configuratie van de geselecteerde simulator bij; start die simulator daarna opnieuw. Instellingen → Sessie bepaalt welke simulator Bridge bij de volgende start kiest.