Ondersteuningspagina

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

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.

Apparaatselectie, richtingskalibratie, gevalideerde weergave, sterktelimieten en besturingstoewijzingen leven onder 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.

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. WARN of FAIL toont een niet-blokkerende banner Controleren en oplossen waarin elk probleem wordt genoemd.

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.
Auto-arm 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 Auto-arm alleen doorgaan wanneer de overige voorwaarden zijn geslaagd.

Figure 2. Support → Health toont PASS voor een ondersteund event-node, WARN met Fix voor een verouderde udev-regel en FAIL 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 — 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

Health checks controleert of /etc/udev/rules.d/99-ffb-bridge.rules alle actuele invoerregels van ondersteunde apparaten en de MOZA TTY-machtigingen bevat. Fix toont de canonieke beheerde regel, installeert deze via pkexec, herlaadt udev en triggert invoer- en TTY-apparaten. Een aangesloten, expliciet ingeschakelde, niet-vermelde joystick wordt tijdens installatie toegevoegd.

Een oudere regel met alleen events wordt als WARN gemeld, omdat de actuele MOZA TTY-machtigingen ontbreken. Gebruik Fix ook wanneer het bestand al bestaat; de app vervangt het door de volledige gegenereerde regel.

Na succesvol herstel is de regel actief en raadt de app een herstart aan. Nu herstarten opent de joystick opnieuw met de nieuwe machtigingen en laat een startfallback los; Later herstarten 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 herstarten opent de joystick opnieuw met de nieuwe machtigingen en laat een startfallback los; Later herstarten is veilig als je eerst wilt doorgaan.

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.

Figure 6. 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:

Afsluiten	Betekenis	Rapporten over gezondheidscontroles
`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 Diagnosetab — het gebeurtenislogboek zal meer details tonen dan de éénregelige statussen van gezondheidscontroles. Of spring naar Problemen oplossen voor veel voorkomende symptomen en oplossingen.