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.
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. Beide existieren, weil verschiedene Produktionsläufe des Sidewinder Force Feedback 2 die Force-Feedback-Polarität unterschiedlich interpretieren – bei manchen Sticks zieht sich das, was die Brücke für „vorwärts“ hält, physisch nach hinten und umgekehrt. Der Schalter ist der Fix auf Installationsebene. Der Test besteht darin, wie Sie wissen, ob Sie es umdrehen müssen.
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.
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
vorhanden ist und mit dem kanonischen Inhalt übereinstimmt. Bei Abwesenheit ist die Aktion Installieren Sie die udev-Regel — this
triggers a pkexec Sie werden aufgefordert, die Datei an einen privilegierten Speicherort zu schreiben.
Der Arzt erkennt NixOS (indem er sucht). /etc/NIXOS) und ersetzt die Zeile „udev-rule“ durch eine Anweisung zum Hinzufügen der Regel configuration.nix instead. See
Installieren für den Ausschnitt.
SimConnect-Konfiguration
Looks for MSFS's 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.
- 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 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 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.
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
Aktionen, die in Systempfade schreiben (udev-Regeln, alles darunter).
/etc) route through pkexec. Sie sehen die normale Polkit-Eingabeaufforderung Ihrer Distribution – dieselbe, die auch erscheint gparted oder eine Paketmanager-GUI. Exit-Codes Der Arzt interpretiert:
| Ausstieg | Bedeutung | Arztberichte |
|---|---|---|
0 | Erfolg | Grüner Scheck; 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.“ |
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.