Dokumentation in Beta. Einige Texte und Bilder werden überarbeitet, wenn die App auf Version 1.0 umgestellt wird. Wenn ein Abschnitt veraltet ist, kennzeichnen Sie ihn über Feedback-Formular.

Doktor

Die Arztseite ist ein zentraler Gesundheitscheck. Es führt eine Handvoll Tests für das Gerät, die Simulation und die Host-Umgebung durch und bietet dort, wo es eine offensichtliche Lösung gibt, eine Inline-Aktion zur Anwendung an. Beginnen Sie hier, wenn etwas nicht funktioniert – die Chancen stehen gut, dass der Arzt bereits weiß, was es ist.

Doctor page. Each row is one check: status icon, title, inline detail, and a contextual action button.
Figure 1. Doctor page. Each row is one check: status icon, title, inline detail, and a contextual action button.

Hardwarekompatibilität

Die erste Karte auf der Arztseite ist eine Hardwarekompatibilität Panel. Es beherbergt zwei verwandte Steuerelemente: ein Achsenpolarität umkehren Umschalter und ein Live-Drag-Pad Polaritätstest. Both exist because different production runs of the Sidewinder Force Feedback 2 interpret force-feedback polarity differently — on some sticks, what the bridge thinks is “forward” physically pulls back, and vice-versa. The toggle is the install-level fix; the test is how you know whether to flip it.

Hardware compatibility card at the top of the Doctor page — Invert axis polarity toggle, drag-pad polarity test, and the hardware-periodics compatibility row with its Test hardware effects button.
Figure 2. Hardware compatibility card at the top of the Doctor page — Invert axis polarity toggle, drag-pad polarity test, and the hardware-periodics compatibility row with its Test hardware effects button.

Live-Polaritätstest

Klicken Sie Starten und ein kleines X-Y-Dragpad wird aktiv. Bewegen Sie den Puck, der Schläger folgt in Echtzeit – die Brücke schaltet sich für die Dauer des Tests automatisch in den Mock-Modus, sodass die Prüfung der Voraussetzungen ohne SIM-Verbindung erfolgreich ist. Klicken Sie Stopp wenn du fertig bist. Ein Bestätigungsmodal fragt „Ist der Schläger dem Puck gefolgt?“:

  • Ja — Polarität stimmt, keine Änderung vorgenommen.
  • Nein — Der Umschalter schaltet automatisch um und jede nachfolgende Kraft auf die Nick- und Rollachse wird an der Ausgangskante des Geräts aufgehoben.

Wenn Sie die Doctor-Seite während des Tests verlassen, wird sie stillschweigend gestoppt und Ihre vorherige Eingabequelle (Live oder Idle) wiederhergestellt – kein expliziter Stopp erforderlich.

Achsenpolarität umkehren (manuell)

Der Schalter auf der linken Seite der Karte ist die gleiche Einstellung, die der Test schreiben würde. Verwenden Sie es direkt, wenn Sie bereits wissen, dass Ihr Stick den Flip benötigt – Sie haben dies beispielsweise bei einer früheren Installation durchgemacht und möchten es vor dem Testen einstellen. Die Einstellung ist auf Installationsebene und nicht pro Profil: Sie bleibt in den Einstellungen der Brücke, gilt für Nick- und Rollachsen zusammen und überlebt Neustarts.

Warum beide Achsen zusammen

Bei früheren Builds konnte die Neigung unabhängig vom Rollen umgekehrt werden. Das stimmte nicht mit den tatsächlichen Besonderheiten der Firmware des FFB2 überein – wenn eine Achse umgekehrt ist, sind es beide. Durch den Schalter werden sie nun als Paar umgedreht. Vorhandene Einstellungen pro Tonhöhe werden beim ersten Start nach vorne migriert.

Softwarebasierte Periodika

Die Brücke verfügt über zwei Möglichkeiten, periodische und einmalige Effekte (Rumpeln, Stöße, Schauder usw.) an den FFB2 zu senden. Hardwaremodus – die Standardeinstellung bei der Neuinstallation – nutzt DirectInput-Hardwareeffekte, und Beta.11 hält diese Topologie bewusst klein: eine Vektorkonstante, eine zweiachsige Feder und ein verzögerter periodischer Pool mit drei Schlitzen. Die Firmware treibt die periodischen Wellenformen weiterhin mit nativer Rate an; Die Brücke verwendet diese physischen Steckplätze einfach für die aktuellen Start- und Landebahn-, Triebwerks-, Buffet- und One-Shot-Hinweise. Softwarebasierte Periodika, der Schalter in derselben Doctor-Reihe, behält nur den kontinuierlichen Kraft-/Zentrier-Hardwarepfad bei und synthetisiert periodische und einmalige Hinweise in C# bei 200 Hz, wobei das Ergebnis in die Ausgaben mit konstanter Kraft gefaltet wird.

Der Hardware-Modus ist bei den Effekten mit der höchsten Frequenz klarer und weist eine geringere Latenz auf, da die Firmware sie schneller antreibt als die Tick-Rate der Bridge. Software Blending ist der Kompatibilitäts-Fallback für Treiber-Stacks, die im Hardware-Modus immer noch abstürzen, für fehlgeschlagene Prüfergebnisse oder für Benutzer, die es bewusst bevorzugen. Ein generischer unsauberer Exit erzwingt nicht automatisch die Softwaremischung. Beide Modi verwenden die gleichen vierzehn Effekte mit den gleichen Schiebereglern für die Effektabstimmung – die Auswahl ist ein Versanddetail, kein Funktionswechsel. In beiden Fällen ist ein Neustart erforderlich. Der Dispatcher liest den Modus beim Start.

Klicken Sie Testen Sie Hardwareeffekte um die kompakte Hardware-Topologie sicher auszuprobieren. Der Arzt startet einen separaten Arbeitsprozess, weist die gleiche Vektorkonstante, die gleiche zweiachsige Feder und den gleichen periodischen Pool zu, die die Brücke im Flug verwendet, und reißt sie dann ab. Wenn der DirectInput/PID-Stack von Windows abstürzt, stirbt nur der Worker und die Bridge bleibt geöffnet. Wenn der Test bestanden wird, wechseln Doctor und die Laufzeit beim nächsten Start in denselben Hardware-Modus-Status, sodass der Doctor-Status und der tatsächliche Dispatcher-Modus übereinstimmen.

Wie Schecks aufgebaut sind

Jede Prüfzeile besteht aus vier Teilen:

  • Statuspunkt – Grün (bestanden), gelb (Warnung), rot (nicht bestanden), grau (auf dieser Plattform nicht anwendbar).
  • 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 der Sidewinder Force Feedback 2 für das Betriebssystem sichtbar ist und die Bridge ihn ausschließlich öffnen kann. Schlägt fehl, wenn die VID/PID nicht vorhanden ist oder wenn ein anderer Prozess das Handle hält.

Linux udev-Regel

Checks whether /etc/udev/rules.d/99-ffb-bridge.rules is present and matches the canonical content. When absent, the action is Installieren Sie die udev-Regel — this triggers a pkexec prompt to write the file into a privileged location.

NixOS-Ausnahme

Doctor detects NixOS (by looking for /etc/NIXOS) and replaces the udev-rule row with an instruction to add the rule to configuration.nix instead. See Installieren für den Ausschnitt.

SimConnect-Konfiguration

Looks for MSFS's SimConnect.xml in the platform-appropriate location, parses it, and compares any enabled IPv4 entries against the port the bridge is using. Three possible outcomes:

  • Passender Eintrag gefunden. Grün – nichts zu tun.
  • Einfahrt an einem anderen Hafen. 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).

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

Sends a tiny RREF probe to 127.0.0.1:49000 and waits briefly for a dataref in response. Maps both timeout and Winsock's WSAECONNRESET (received when an ICMP port-unreachable was delivered) to “not running”.

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 angeboten 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.

Fix dialog for SimConnect config install. The exact XML snippet to be added is shown, along with a preview of the resulting file.
Figure 3. Fix dialog for SimConnect config install. The exact XML snippet to be added is shown, along with a preview of the resulting file.

Der Dialog ist immer Zusatzstoff: 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

Actions that write to system paths (udev rules, anything under /etc) route through pkexec. You'll see your distro's normal polkit prompt — the same one that pops up for gparted or a package manager GUI. Exit codes Doctor interprets:

AusstiegBedeutungArztberichte
0ErfolgGrüner Scheck; 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 Betreiben der Bridge in einer minimalen Umgebung (Headless Linux, Sway ohne Polkit-Agent) ist in Ordnung – Sie können die privilegierten Fixes von Doctor einfach nicht verwenden. Installieren Sie die erforderlichen Dateien manuell oder starten Sie einen Polkit-Agenten, bevor Sie die Bridge starten.

Wenn der Doktor überall grün ist

Die App sollte funktionieren. Ist dies nicht der Fall, zeigt das Ereignisprotokoll der Diagnose detailliertere Informationen an als der einzeilige Status des Arztes. Gehen Sie als nächstes dorthin oder springen Sie zu Fehlerbehebung für häufige Symptome und Lösungen.