kst4contest/docs/superpowers/specs/2026-10-16-so2r-design.md

Entwurf — SO2R: zwei Funkgeräte, eine Instanz (#46)

Freigegeben vom Maintainer am 2026-10-16 (Gespräch). Erster Schritt zu #46; MO2R und Multi-Operator über mehrere Rechner sind eigene Vorhaben mit eigenem Entwurf.

Warum

KST4Contest kennt heute genau ein Funkgerät:

• Jede RadioInfo-Meldung aus dem Logprogramm (N1MM, DXLog, UCXLog) überschreibt MYQRG. Das Feld RadioNr wird nicht gelesen. Wer mit zwei Geräten arbeitet, sieht MYQRG bei jedem Gerätewechsel springen, und die Makros tragen die QRG des zuletzt gemeldeten Geräts.
• Win-Test kennt einen einzigen Stationsnamen-Filter, also ebenfalls ein Gerät.
• Es gibt einen PSTRotator-Client, also nur „Antenne 1 drehen".

Ein SO2R-Platz (ein Operator, ein Rechner, eine ON4KST-Anmeldung, zwei Geräte mit je eigener Antenne) braucht pro Gerät eine eigene QRG und einen eigenen Rotor.

Umfang

Drin:

• Pro Gerät eine eigene QRG: Gerät 1 schreibt MYQRG, Gerät 2 schreibt SECONDQRG.
• Zuordnung über RadioNr (N1MM, DXLog, UCXLog) und über je einen Win-Test-Stationsnamen.
• Ein zweiter PSTRotator mit Button „Antenne 2 drehen" und eigenem QTF-Feld.
• Ein Schalter „SO2R", standardmäßig aus. Aus heißt: alles wie heute.

Bewusst nicht drin:

• Ein eigenes Rechenband pro Gerät (Pfadanalyse, Tropo-Spalte, Karte bleiben wie heute).
• Ein „aktiver Platz", auf den sich Gearbeitet, Skeds und Makros beziehen.
• Strahlrichtung beider Antennen auf der Karte.
• Mehr als zwei Geräte.
• MO2R und Multi-Operator. Das Modell schließt sie nicht aus (siehe unten), wird aber nicht dafür ausgebaut.

Modell

RadioSlot (core)

Genau zwei Instanzen, Platz 1 und Platz 2. Ein Platz bündelt:

	Platz 1	Platz 2
QRG-Ziel	getMYQRGFirstCat() (MYQRG)	getMYQRGSecondCat() (SECONDQRG)
Rotor	RotatorControl über stn_pstRotator*	RotatorControl über stn_pstRotator2*
gemeldete Richtung	getActualQTF()	neu getActualQTF2()
Win-Test-Stationsname	vorhandener Filter logsynch_wintestNetworkStationNameOfWintestClient1	neu logsynch_wintestNetworkStationNameOfWintestClient2

Platz 2 existiert nur bei eingeschaltetem SO2R. Ohne SO2R gibt es keinen Rotor 2 und kein QTF2.

RadioSlot ist die Einheit, an die ein späteres MO2R einen Operator oder eine Arbeitsfläche hängen kann. Für SO2R wird nichts davon gebaut.

RotatorControl (core, herausgezogen)

Drehbefehl, Wiederholung und die Toleranz „erreicht" (1°, ROTATOR_REACHED_TOLERANCE_DEGREES) liegen heute im ChatController. Sie ziehen unverändert in eine eigene Klasse, die einmal pro Platz instanziert wird: eigener PstRotatorClient, eigener Wiederholungs-Scheduler, eigene zuletzt gemeldete Richtung. Das Verhalten bleibt bitgenau gleich, einschließlich der vorhandenen Kompatibilitäts-Wiederholung; der ChatController delegiert nur noch.

PSTRotator antwortet auf Port+1. Eine zweite PSTRotator-Instanz braucht also eigene Ports; die Vorgabe für Rotor 2 ist 12010 (Antwort auf 12011).

RadioSlotRouter (core, rein)

Entscheidet, zu welchem Platz eine Meldung gehört. Rein und ohne Abhängigkeiten, damit die Regel ohne Netz testbar ist.

RadioInfo:

SO2R	RadioNr	Platz
aus	beliebig, auch fehlend	1
an	1	1
an	2	2
an	fehlend	1
an	anderer Wert oder nicht lesbar	verworfen, geloggt

Win-Test STATUS:

SO2R	Stationsname	Platz
aus	wie heute: Filter leer oder passt	1, sonst verworfen
an	passt auf Name von Platz 2	2
an	Name von Platz 1 leer oder passt	1
an	sonst	verworfen

Namensvergleich wie heute beim Filter (equalsIgnoreCase). Die Filterung der ADDQSO-Pakete nach Stationsname bleibt unberührt.

Datenfluss und Fäden

• ReadUDPbyUCXMessageThread liest zusätzlich RadioNr, fragt den Router und schreibt die QRG über uiDispatcher.runOnUi in das QRG-Ziel des Platzes. Der Weg für eine RadioInfo ohne Freq oder Mode bleibt unverändert (Paket verwerfen, weiter empfangen).
• ReadUDPByWintestThread fragt den Router mit dem Stationsnamen; Passfrequenz-Option und Formatierung bleiben, nur das Ziel hängt vom Platz ab.
• Rotor-Rückmeldungen laufen im Empfangsfaden des jeweiligen Rotors und schreiben die Richtung des Platzes, wie heute bei Rotor 1. Nichts wartet auf dem AWT-Ereignisfaden.

Einstellungen

Reiter TRX-Abgleich

• Neuer Schalter „SO2R: zwei Geräte getrennt führen" (trxSynch_so2rEnabled, Vorgabe aus).
• Bei SO2R an wird der vorhandene Win-Test-Stationsnamen-Filter zum Namen für Platz 1; ein neues Feld nimmt den Namen für Platz 2 auf. Bei SO2R aus ist das neue Feld ausgegraut.
• Hinweistext: N1MM, DXLog und UCXLog werden über RadioNr zugeordnet, dafür ist nichts einzustellen.

Reiter Station, Abschnitt PSTRotator

• Zweiter Block „PSTRotator 2 (SO2R)": Schalter, Host, Port (Vorgaben aus, 127.0.0.1, 12010).
• Nur aktiv bei SO2R an. Der Hinweis „antwortet auf Port+1" gilt auch hier.
• Gleicher Port wie Rotor 1 wird beim Übernehmen abgelehnt, mit Meldung, wie andere ungültige Eingaben.

Übernehmen

Wie seit dem Entwurf vom 2026-10-16 (Einstellungen mit „Übernehmen"): alles wirkt erst mit Übernehmen/Schließen oder Speichern.

• Ändern sich SO2R oder ein Wert von Rotor 2, wird Rotor 2 einmal neu gestartet oder gestoppt — ein eigener Effekt-Schlüssel neben dem von Rotor 1.
• SO2R aus stoppt Rotor 2 und leert QTF2.

preferences.xml

Neue Elemente: trxSynch_so2rEnabled, logsynch_wintestNetworkStationNameOfWintestClient2, stn_pstRotator2Enabled, stn_pstRotator2Host, stn_pstRotator2Port. Fehlen sie in einer älteren Datei, gelten die Vorgaben; keine Migration. Alles gilt pro Profil.

Oberfläche

Stationspanel

• Neben „Antenne 1 Richtung {0} drehen" steht „Antenne 2 Richtung {0} drehen" (selected.turnAntenna2, de/en).
• Sichtbar nur bei SO2R an und aktiviertem Rotor 2. Ausgegraut nach derselben Regel wie canTurnAntenna bei Rotor 1 (Rotor nicht verbunden, Station ohne Locator).
• Überall, wo heute „Antenne 1 drehen" angeboten wird, kommt „Antenne 2 drehen" dazu.

Sendezeile

• Reihenfolge MYQRG | SECONDQRG | QTF | QTF2. QTF2 zeigt die Richtung von Rotor 2, nur zur Anzeige, und ist nur bei SO2R sichtbar.
• Bei SO2R an lautet der Tooltip von SECONDQRG „QRG Gerät 2 (aus RadioNr 2 bzw. Win-Test-Station 2)".
• Bei SO2R aus sieht die Zeile aus wie heute.

Statusleiste

Rotor 2 meldet seinen Zustand wie Rotor 1 über ThreadStatusCallback, aber unter eigenem Thread-Namen, und bekommt so einen eigenen Knopf in der Statusleiste. Ein Ausfall von Rotor 2 berührt Rotor 1 nicht.

Unverändert

QTF-Filter der Stationsliste (Rotor 1), Karte, Pfadanalyse, Gearbeitet-Logik. Die Makros MYQRG und SECONDQRG tragen bei SO2R die Frequenzen der beiden Geräte.

Dokumentation

• Changelog-Eintrag de/en.
• Handbuch: kurzer Abschnitt „SO2R" — N1MM/DXLog/UCXLog brauchen nichts, Win-Test braucht zwei Stationsnamen, die zweite PSTRotator-Instanz braucht einen anderen Port.

Tests

Core:

• RadioSlotRouterTest: alle Zeilen der beiden Tabellen oben.
• RotatorControlTest: Toleranz „erreicht", keine Wiederholung bei Bewegung, die vorhandene Wiederholung bei Stillstand — mit Fake-Client und Fake-Scheduler. Die bisherigen Rotor-Tests bleiben unverändert grün; sie sichern das Herausziehen ab.
• Empfänger: ein echtes RadioInfo-Paket mit RadioNr 2 bzw. ein Win-Test-STATUS mit Stationsname 2 setzt SECONDQRG, MYQRG bleibt unverändert. Bei SO2R aus setzt dasselbe Paket MYQRG.
• ChatPreferences: Roundtrip der fünf neuen Elemente; eine alte Datei ohne sie ergibt die Vorgaben (SO2R aus, Port 12010).

App:

• Einstellungen (DraftedSettingsTableTest-Gerüst): Übernehmen startet bzw. stoppt Rotor 2 genau einmal; gleicher Port wie Rotor 1 wird abgelehnt; SO2R aus stoppt Rotor 2 und leert QTF2.
• Oberfläche (Compose-UI-Tests wie beim Stationspanel): Button Antenne 2 und QTF2 nur bei SO2R sichtbar; Button ohne Rotor 2 ausgegraut; ohne SO2R ist die Sendezeile wie heute.
• i18n: neue Schlüssel de/en, vom Erzeuger beim Bau geprüft.

Live, durch den Maintainer:

• N1MM oder DXLog mit zwei Geräten: Gerätewechsel bewegt MYQRG und SECONDQRG getrennt.
• Zwei PSTRotator-Instanzen auf verschiedenen Ports: beide Buttons drehen die richtige Antenne, QTF und QTF2 folgen.
• Win-Test mit zwei Stationen, falls verfügbar.