Supportseite

Die Support-Seite ist die zentrale Startseite für Dokumentation, Zustandsprüfungen, Diagnosen, Protokolle und den Support-Paket-Export. Die physische Gerätekonfiguration befindet sich jetzt unter „Hardware“.

Abbildung 1. Support → Zustandsprüfungen zeigt eine Zeile je Prüfung mit BESTANDEN / INFO / WARNUNG / FEHLER und einer Aktion, wenn eine Reparatur verfügbar ist. Zuerst wird die Registerkarte Materialien geöffnet.

Registerkartenleiste

Die Support-Seite öffnet zunächst die Registerkarte Materialien mit Links zur Online-Dokumentation und zur mitgelieferten PDF-Datei. Die beiden anderen Registerkarten sind nur einen Klick entfernt:

Materialien (wird zuerst geöffnet) — offizielle Dokumentation und PDF-Handbuch. Die Einführung lässt sich über Einstellungen → Allgemein erneut anzeigen.
Zustandsprüfungen – die alltägliche Triage-Oberfläche (Gerät, udev-Regel unter Linux, Sim-Erreichbarkeit, Laufzeitstatus). Klicken Sie Prüfungen starten zu sondieren.
Diagnose – Laufzeitmetriken, das durchsuchbare Ereignisprotokoll und Support-Bundle-Export mit einem Klick. Separat dokumentiert auf der Diagnose-Tab Seite.

Geräteauswahl, Richtungskalibrierung, validiertes Rendering, Stärkegrenzen und Steuerungszuweisungen finden Sie hier Hardware.

Registerkarte „Zustandsprüfungen“.

Zustandsprüfungen sind der Weg, den die meisten Tester benötigen, wenn etwas nicht stimmt. Klicken Sie Prüfungen starten um den Brückenzustand zu prüfen. Zeilen werden unabhängig voneinander aktualisiert, sodass ein langsamer Sim-Probe nicht die Anzeige des Geräte- oder Laufzeitergebnisses blockiert.

BESTANDEN bedeutet, dass die Brücke diesen Teil des Setups überprüft hat.
INFO bedeutet, dass nichts falsch ist, aber die Zeile einen nützlichen Kontext hat. Beispielsweise wird erwartet, dass X-Plane nicht zuhört, wenn Sie MSFS fliegen oder den Testmodus verwenden.
WARNUNG bedeutet, dass die Einrichtung fortgesetzt werden kann, es jedoch etwas gibt, das behoben oder gemeldet werden sollte.
FEHLER bedeutet, dass die Bridge ein blockierendes Problem festgestellt hat. Wenn die Zustandsprüfungen eine sichere Lösung kennen, wird in der Zeile eine Aktionsschaltfläche angezeigt.
BEREIT und PRÜFUNG LÄUFT sind neutrale Zustände, die vor und während eines Laufs verwendet werden.

Automatische Geräteprüfung vor dem Start

Beim Start prüft FFB-Bridge im Hintergrund das Geräte-Backend unter Windows, Linux und macOS. Unter Linux werden zusätzlich der Lese-/Schreibzugriff auf einen unterstützten Event-Knoten und die vollständige Abdeckung aller aktuellen Geräteberechtigungen durch die installierte udev-Regel geprüft. WARNUNG oder FEHLER öffnet einen Dialog, der jedes Problem nennt, mit „Jetzt prüfen und beheben“ und „Vorerst ausblenden“.

Wenn alle Prüfungen bestanden werden, öffnet sich nichts.
Beim Start werden weder Simulator noch Netzwerk geprüft. Ein geschlossener Simulator ist normal und bleibt ein Laufzeitthema.
Solange der Dialog geöffnet ist, wartet das automatische Aktivieren. Das Problem kann geprüft und behoben oder bei absichtlich getrenntem Gerät verworfen werden. Nach dem Verwerfen kann das automatische Aktivieren nur fortfahren, wenn alle übrigen Voraussetzungen erfüllt sind.

Abbildung 2. Support → Zustandsprüfungen zeigt BESTANDEN für einen unterstützten Event-Knoten, WARNUNG mit „Reparieren…“ für eine veraltete udev-Regel und FEHLER für das physische Gerät.

Hardware

Die früheren Hardware-Steuerelemente auf der Support-Seite verfügen jetzt über einen eigenen Bereich. Verwenden Sie den Funktionstest für isolierte Effekttests und Hardware für dauerhafte Einstellungen für physische Geräte. Öffnen Sie die Hardware-Anleitung.

Wie die Prüfungen aufgebaut sind

Jede Prüfzeile besteht aus vier Teilen:

Status – BESTANDEN (grün), INFO (blau), WARNUNG (gelb), FEHLER (rot), BEREIT / PRÜFUNG LÄUFT (neutral) oder N/A, wenn die Zeile auf dieser Plattform nicht zutrifft.
Titel — was überprüft wird.
Detailliert – eine einzeilige Zusammenfassung dessen, was gefunden wurde. Bewegen Sie den Mauszeiger (oder tippen Sie auf Touch), um alle Details anzuzeigen.
Aktionsschaltfläche – nur vorhanden, wenn es etwas Umsetzbares gibt. Beispiele: Lokalen Eintrag installieren, Port 5111 verwenden, Reparieren….

Die Schecks

FFB-Joystick-Gerät

Bestätigt, dass ein unterstützter Force-Feedback-Joystick für das Betriebssystem sichtbar ist und die Bridge ihn ausschließlich öffnen kann. Schlägt fehl, wenn keine unterstützte VID/PID vorhanden ist oder wenn ein anderer Prozess das Handle hält.

Linux udev-Regel

Die Zustandsprüfungen prüfen, ob /etc/udev/rules.d/71-ffb-bridge.rules alle aktuellen Eingabezeilen unterstützter Geräte, die MOZA-TTY-Berechtigungen und den hidraw-Zugriff abdeckt, den der Logitech G940 und Brunner-Basen verwenden. „Reparieren…“ zeigt die kanonische, gepflegte Regel, installiert sie über pkexec, entfernt die frühere Datei 99-ffb-bridge.rules, lädt udev neu und löst Eingabe-, TTY- und hidraw-Geräte aus. Ein verbundenes, per Opt-in aktiviertes, nicht gelistetes Joystick-Gerät wird bei der Installation angefügt.

Eine ältere Regel wird als WARNUNG gemeldet, wenn ihr eine aktuelle Geräteberechtigung fehlt, etwa die MOZA-TTY-Zeilen oder der hidraw-Zugriff, den der Logitech G940 und Brunner-Basen verwenden, oder wenn sie wegen ihres Dateinamens für den Zugriff aus der Desktop-Sitzung zu spät ausgeführt wird, wie bei der früheren Datei 99-ffb-bridge.rules. Verwenden Sie „Reparieren…“ auch dann, wenn die Datei bereits vorhanden ist; die App installiert die vollständige erzeugte Regel als 71-ffb-bridge.rules und entfernt die frühere Datei.

Nach erfolgreicher Korrektur ist die Regel aktiv und die App empfiehlt einen Neustart. „Jetzt neu starten“ öffnet den Joystick mit den neuen Berechtigungen erneut und verwirft den Start-Fallback; „Später neu starten“ zu wählen ist sicher, wenn Sie zunächst fortfahren müssen.

Abbildung 5. Nach erfolgreicher Korrektur ist die Regel aktiv und die App empfiehlt einen Neustart. „Jetzt neu starten“ öffnet den Joystick mit den neuen Berechtigungen erneut und verwirft den Start-Fallback; „Später neu starten“ zu wählen ist sicher, wenn Sie zunächst fortfahren müssen.

NixOS-Ausnahme

Zustandsprüfungen erkennen NixOS (durch die Suche nach /etc/NIXOS) und ersetzt die Zeile „udev-rule“ durch eine Anweisung zum Hinzufügen der Regel configuration.nix stattdessen. Siehe Installieren für den Ausschnitt.

WindowsLinux MSFS-SimConnect-Konfiguration

SimConnect ist der MSFS-Pfad, daher wird diese Prüfung unter Windows und Linux ausgeführt. Es sucht nach MSFSs SimConnect.xml am plattformgerechten Speicherort, analysiert es und vergleicht alle aktivierten IPv4-Einträge mit dem Port, den die Bridge verwendet. Drei mögliche Ergebnisse:

Passender Eintrag gefunden. Grün – nichts zu tun.
Eintrag an einem anderen Port. Amber – bietet a Port :X verwenden Klicken Sie auf die Schaltfläche, um diesen Port zu übernehmen.
Kein verwendbarer Eintrag (oder nicht analysierbare Datei). Rot – bietet a Reparieren… Klicken Sie auf die Schaltfläche, die den Installationsdialog öffnet (siehe unten).

Linux verwendet einen unprivilegierten Port

MSFS versendet seinen Standard-SimConnect-Eintrag auf Port 500. Unter Windows funktioniert das einwandfrei und die Bridge verwendet ihn. Unter Proton unter Linux kann ein Benutzernamespace-Prozess keine Ports unter 1024 binden, daher installiert und verwendet die Bridge einen parallelen Eintrag auf einem unprivilegierten Port (standardmäßig 5111), den MSFS-in-Proton tatsächlich binden kann – weshalb der Linux-Fix und der Port verwenden Aktionspunkt an diesem höheren Port.

MSFS-Erreichbarkeit

Prüft den konfigurierten TCP-Port. Sendet ein echtes SimConnect OPEN-Paket und prüft den Antwortheader, um es unterscheiden zu können MSFS hört zu von etwas anderes hört zu.

X-Plane-Erreichbarkeit

Die X-Plane-Verbindung ist unter Windows, Linux und macOS auf Apple Silicon verfügbar. Diese Prüfung sendet eine RREF-Abfrage an 127.0.0.1:49000 und wartet kurz auf eine Datenreferenz als Antwort. Ordnet sowohl Timeout als auch Winsock zu WSAECONNRESET (empfangen, wenn ein ICMP-Port-unerreichbar übermittelt wurde) auf „nicht ausgeführt“.

Laufzeitstatus

Fasst den aktuellen Zustand von Gerät, Datenquelle, Telemetrie und Ausnahmen zusammen. BESTANDEN bedeutet, dass das Gerät geöffnet ist und Live-Daten aus dem Simulator oder dem Testsimulator die Pipeline speisen; INFO bedeutet, dass das Gerät ohne Live-Simulatordaten geöffnet ist, was bei geschlossenem Simulator zu erwarten ist; FEHLER bedeutet, dass das Gerät nicht geöffnet ist.

Absturzbericht

Wenn die vorherige Sitzung abgestürzt ist, zeigt FFB-Bridge beim nächsten Start einen Absturzbericht-Dialog statt einer Zeile unter Zustandsprüfungen. Verwenden Sie Kopieren um den gespeicherten Stack-Trace zu kopieren, und Feedbackformular öffnen um die Feedbackseite in Ihrem Browser zu öffnen, wo Sie das Protokoll einfügen und ein Supportpaket anhängen können.

Dialog „Reparieren…“

Reparieren… Schaltflächen übernehmen Änderungen nicht direkt – sie öffnen ein Dialogfeld, das genau anzeigt, was geändert werden soll, wo und (unter Linux) was Sie in der Authentifizierungsaufforderung genehmigen müssen.

Der Dialog ist immer additiv: Vorhandene Einträge werden nie überschrieben. Wenn die Zieldatei nicht analysiert werden kann, wird im Dialogfeld erläutert, dass zunächst eine zeitgestempelte Sicherung erstellt wird. Abbrechen ist immer die sichere Wahl.

Linux pkexec-Verhalten

Aktionen, die in Systempfade schreiben (udev-Regeln, alles darunter). /etc) Route durch pkexec. Sie sehen die normale Polkit-Eingabeaufforderung Ihrer Distribution – dieselbe, die auch erscheint gparted oder eine Paketmanager-GUI. Exit-Codes, die Zustandsprüfungen interpretieren:

Beenden	Bedeutung	Meldung in Zustandsprüfungen
`0`	Erfolg	Grünes Häkchen; Zeile wird neu ausgewertet.
`126`	Der Benutzer hat die Authentifizierungsaufforderung abgelehnt	Gelb „Abgebrochen“ – versuchen Sie es erneut, wenn Sie bereit sind.
`127`	Kein Polkit-Agent/Authentifizierungsfehler	Rot „Authentifizierung fehlgeschlagen.“

Tipp

Das Ausführen der Bridge in einer minimalen Umgebung (Headless Linux, Sway ohne Polkit-Agent) ist in Ordnung – Sie können die privilegierten Korrekturen der Support-Seite einfach nicht verwenden. Installieren Sie die erforderlichen Dateien manuell oder starten Sie einen Polkit-Agenten, bevor Sie die Bridge starten.

Wenn jede Prüfung grün ist

Die App sollte funktionieren. Wenn dies nicht der Fall ist, wechseln Sie zu Diagnose-Tab — Das Ereignisprotokoll zeigt detailliertere Informationen als die einzeiligen Statusmeldungen der Zustandsprüfungen. Oder springen Sie zu Fehlerbehebung für häufige Symptome und Lösungen.

Wenn MSFS 2020 und 2024 oder mehrere Installationen vorhanden sind, bestätigen Sie jedes benannte Konfigurationsziel vor der Reparatur. Eine Reparatur aktualisiert die ausgewählte Simulatorkonfiguration. Starten Sie anschließend diesen Simulator neu. Einstellungen → Sitzung legt fest, welchen Simulator Bridge beim nächsten Start auswählt.