Aktuelle Version. FFB-Bridge v1.2.1 ist live. Diese Dokumentation beschreibt die aktuelle App gemäß dem Release-Manifest. Wenn ein Abschnitt veraltet wirkt, melde ihn über das Feedback-Formular.

Supportseite

Die Support-Seite (mit der Bezeichnung Support in der Seitenleiste) ist die zentrale Startseite für alles, was Sie öffnen, wenn etwas nicht stimmt, wenn Sie eine Referenz benötigen oder wenn Sie ein Support-Paket für den Entwickler exportieren möchten. Drei Registerkarten: Ressourcen, Integritätsprüfungen, und Diagnose. Die früher hier vorhandenen Hardwarekompatibilitätskontrollen wurden verschoben Einstellungen → Hardware.

Support-Seite. Die Standardregisterkarte „Integritätsprüfungen“ zeigt eine Zeile pro Probe mit den Status „PASS“, „INFO“, „WARN“, „FAIL“ und kontextbezogenen Aktionsschaltflächen, wenn ein Fix verfügbar ist. Support-Seite. Die Standardregisterkarte „Integritätsprüfungen“ zeigt eine Zeile pro Probe mit den Status „PASS“, „INFO“, „WARN“, „FAIL“ und kontextbezogenen Aktionsschaltflächen, wenn ein Fix verfügbar ist.
Abbildung 1. Support-Seite. Die Standardregisterkarte „Integritätsprüfungen“ zeigt eine Zeile pro Probe mit den Status „PASS“, „INFO“, „WARN“, „FAIL“ und kontextbezogenen Aktionsschaltflächen, wenn ein Fix verfügbar ist.

Registerkartenleiste

Die Support-Seite wird geöffnet Ressourcen Registerkarte – Dokumente + manuelle Links + die Wiederholung der Willkommenstour sind dort als freundliche erste Landung zu sehen. Die anderen beiden Registerkarten sind nur einen Klick entfernt:

  • Ressourcen (wird zuerst geöffnet) – Links zu den hier gehosteten Dokumenten und dem Handbuch sowie zur Aufzeichnung der Willkommenstour und zu den Herausgeber-/Rechtsseiten.
  • Integritätsprüfungen – die alltägliche Triage-Oberfläche (Gerät, udev-Regel unter Linux, Sim-Erreichbarkeit, Laufzeitstatus). Klicken Sie Führen Sie Prüfungen durch zu sondieren.
  • Diagnose – Laufzeitmetriken, das durchsuchbare Ereignisprotokoll und Support-Bundle-Export mit einem Klick. Separat dokumentiert auf der Diagnose-Tab Seite.

Hardwarekompatibilität (Achsentest mit Invertieren + Pitch/Roll-Swap, Effekt-Rendering, das Windows-Geräte-Backend, die Geräteauswahl und die Testen Sie Hardwareeffekte Probe) ist keine Support-Registerkarte mehr – sie lebt weiter Einstellungen → Hardware.

Registerkarte „Gesundheitsprüfungen“.

Integritätsprüfungen sind der Weg, den die meisten Tester benötigen, wenn etwas nicht stimmt. Klicken Sie Führen Sie Prüfungen durch 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.

  • PASS 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 Mock-Modus verwenden.
  • WARNUNG bedeutet, dass die Einrichtung fortgesetzt werden kann, es jedoch etwas gibt, das behoben oder gemeldet werden sollte.
  • FEHLGESCHLAGEN bedeutet, dass die Bridge ein blockierendes Problem festgestellt hat. Wenn die Integritätsprüfung eine sichere Lösung kennt, wird in der Zeile eine Aktionsschaltfläche angezeigt.
  • BEREIT und ÜBERPRÜFEN sind neutrale Zustände, die vor und während eines Laufs verwendet werden.

Hardware-Steuerelemente wurden in die Einstellungen verschoben

Die Hardwarekompatibilitätskontrollen waren früher eine Registerkarte „Support“. Sie leben jetzt weiter Einstellungen → Hardware: das Live- Achstest (mit Achsenpolarität umkehren und Nick-/Rollachsen tauschen), die Effekt-Rendering Radio (Hardware-Effekte vs. Software-Kompatibilitätsmodus), das Windows-Geräte-Backend, die Geräteauswahl für mehrere angeschlossene Sticks, das experimentelle Opt-in für nicht gelistete Geräte und das Testen Sie Hardwareeffekte Sonde. Siehe die Einstellungsseite für die vollständige Komplettlösung.

Einstellungen → Hardware – der Achsentest (Invertieren + Pitch/Roll-Swap), Effekt-Rendering, das Windows-Geräte-Backend und die Test-Hardware-Effekt-Sonde. Einstellungen → Hardware – der Achsentest (Invertieren + Pitch/Roll-Swap), Effekt-Rendering, das Windows-Geräte-Backend und die Test-Hardware-Effekt-Sonde.
Abbildung 2. Einstellungen → Hardware – der Achsentest (Invertieren + Pitch/Roll-Swap), Effekt-Rendering, das Windows-Geräte-Backend und die Test-Hardware-Effekt-Sonde.

Wie die Prüfungen aufgebaut sind

Jede Prüfzeile besteht aus vier Teilen:

  • Status – PASS (grün), INFO (blau), WARN (gelb), FAIL (rot), READY / CHECKING (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: Installieren Sie die udev-Regel, Verwenden Sie Port:5111, Beheben….

Die Schecks

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

Überprüft, ob /etc/udev/rules.d/99-ffb-bridge.rules vorhanden ist und mit dem kanonischen Inhalt übereinstimmt. Bei Abwesenheit ist die Aktion Installieren Sie die udev-Regel – Dies löst eine aus pkexec Sie werden aufgefordert, die Datei an einen privilegierten Speicherort zu schreiben.

NixOS-Ausnahme

Integritätsprü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 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 Verwenden Sie Port:X Klicken Sie auf die Schaltfläche, um diesen Port zu übernehmen.
  • Kein verwendbarer Eintrag (oder nicht analysierbare Datei). Rot – bietet a Beheben… 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.

Erreichbarkeit von SimConnect

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.

Erreichbarkeit von X-Plane

Der X-Plane-Pfad funktioniert auf jeder Plattform – und unter macOS (Apple Silicon) ist X-Plane 12 mit einem SideWinder FFB2 die unterstützte Kombination. Diese Prüfung sendet eine winzige RREF-Sonde 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“.

Laufzeit

Überprüft, ob der Regelkreis bei seinen Zielfrequenzen von 50 Hz tickt. Warnt, wenn der Mittelwert der letzten 60 s unter 45 Hz fällt.

Absturzprotokoll

Wenn ein Absturzprotokoll der letzten Sitzung vorhanden ist, wird die Zeile gelb und bietet Enthüllen um in Ihrem Dateimanager dorthin zu springen, und Per Feedback-Formular senden Dadurch wird eine Feedback-Übermittlung mit dem angehängten Protokoll vorab ausgefüllt.

Dialog reparieren

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

Korrekturdialog für die SimConnect-Konfigurationsinstallation. Das genaue XML-Snippet, das hinzugefügt werden soll, wird zusammen mit einer Vorschau der resultierenden Datei angezeigt. Korrekturdialog für die SimConnect-Konfigurationsinstallation. Das genaue XML-Snippet, das hinzugefügt werden soll, wird zusammen mit einer Vorschau der resultierenden Datei angezeigt.
Abbildung 3. Korrekturdialog für die SimConnect-Konfigurationsinstallation. Das genaue XML-Snippet, das hinzugefügt werden soll, wird zusammen mit einer Vorschau der resultierenden Datei angezeigt.

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 Health Checks interpretieren:

BeendenBedeutungGesundheitscheckberichte
0ErfolgGrünes Häkchen; Zeile wird neu ausgewertet.
126Der Benutzer hat die Authentifizierungsaufforderung abgelehntGelb „Abgebrochen“ – versuchen Sie es erneut, wenn Sie bereit sind.
127Kein Polkit-Agent/AuthentifizierungsfehlerRot „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 Statusprüfungen. Oder springen Sie zu Fehlerbehebung für häufige Symptome und Lösungen.