From 641c9bdbc36510aaaa7d30845652460791dc1e15 Mon Sep 17 00:00:00 2001 From: Marc Froehlich Date: Sun, 16 Aug 2026 01:41:17 +0200 Subject: [PATCH] manual: updated AirScout settings description --- github_docs/de-Konfiguration.md | 123 +++++++++++++++++++++++++++++++- github_docs/en-Configuration.md | 123 +++++++++++++++++++++++++++++++- 2 files changed, 244 insertions(+), 2 deletions(-) diff --git a/github_docs/de-Konfiguration.md b/github_docs/de-Konfiguration.md index d807b6e..ad5e4d3 100644 --- a/github_docs/de-Konfiguration.md +++ b/github_docs/de-Konfiguration.md @@ -191,7 +191,128 @@ Nach Abschluss der Konfiguration **Save Settings** verwenden. ## AirScout-Einstellungen -Konfiguration der Schnittstelle zu AirScout für die Flugzeug-Scatter-Erkennung. Details: [AirScout-Integration](de-AirScout-Integration). +Im Reiter **AirScout** wird die UDP-Verbindung zwischen KST4Contest und AirScout eingerichtet. KST4Contest fordert dort keine allgemeinen Flugzeugdaten an, sondern übermittelt die aktuell relevanten Stationspfade. AirScout berechnet die dazu passenden Flugzeuge und sendet das Ergebnis an die anfragende KST4Contest-Instanz zurück. + +Vorausgesetzt wird AirScout `0.9.9.5` oder neuer. + +![AirScout-Einstellungen in KST4Contest](as_plane_feed_3.png){ width=85% } + +### Einstellungen der UDP-Verbindung + +| Einstellung | Standardwert | Verwendung | +|---|---:|---| +| **Enable AirScout UDP integration** | deaktiviert | Aktiviert das Senden von AirScout-Anfragen und die Verarbeitung der Antworten | +| **AirScout server identifier** | `AS` | Logischer Name der angesprochenen AirScout-Instanz | +| **KST4Contest client identifier** | `KST` | Logischer Name dieser KST4Contest-Instanz | +| **AirScout UDP port** | `9872` | Gemeinsamer UDP-Port für Anfragen und Antworten | +| **Select AirScout frequency automatically per station** | aktiviert | Ermittelt Band und Frequenz für jede Gegenstation aus dem aktuellen Stationskontext | +| **Forced AirScout band value** | `1440000` | Verwendet bei deaktivierter Automatik einen festen AirScout-Bandwert für alle Stationen | + +Ist **Enable AirScout UDP integration** deaktiviert, sendet KST4Contest keine AirScout-Anfragen und verwirft eingehende AirScout-Antworten. Der UDP-Empfänger kann trotzdem gebunden bleiben, damit sich die Funktion während einer laufenden Verbindung wieder einschalten lässt. + +KST4Contest verwendet für ausgehende AirScout-Pakete die Broadcast-Adresse `255.255.255.255`. Eine Ziel-IP wird deshalb nicht separat konfiguriert. AirScout und KST4Contest müssen den verwendeten UDP-Broadcast empfangen können; Router leiten einen solchen Broadcast normalerweise nicht in ein anderes Netz weiter. Bei Problemen sollten daher zuerst der UDP-Port, die lokale Firewall und die Netzzuordnung geprüft werden. + +### Automatische Bandauswahl pro Station + +**Auto per station** ist die empfohlene Einstellung. KST4Contest verwendet dann nicht einen festen Bandwert für alle Gegenstationen, sondern leitet eine geeignete Frequenz aus den verfügbaren Informationen ab. + +Die Quellen werden in folgender Reihenfolge ausgewertet: + +1. die zuletzt erkannte, höchstens 30 Minuten alte QRG der Gegenstation, +2. eine eindeutige vollständige QRG im Namensfeld eines aktiven Chat-Eintrags, +3. eindeutige Bandangaben im Namensfeld, +4. 432 MHz, wenn dieselbe Station gleichzeitig in der VHF/UHF- und Microwave-Kategorie aktiv ist und 432 MHz für die eigene Station aktiviert wurde, +5. das niedrigste für die eigene Station aktivierte Band, das zur unterstützten Chat-Kategorie passt. + +Aktive Chat-Varianten desselben Basisrufzeichens werden gemeinsam ausgewertet. Die Einträge `CALLSIGN`, `CALLSIGN-2` und `CALLSIGN-432` können dadurch gemeinsam zur Bandherleitung beitragen, bleiben für die Nachrichtenverarbeitung aber getrennte Chat-Teilnehmer. + +Nur Bänder, die unter **My station uses …** aktiviert wurden, kommen für die automatische Auswahl infrage. Ein manuell gesetztes NOT-QRV-Kennzeichen schließt das betreffende Band aus und hat Vorrang vor automatisch erkannten QRG- oder Namensinformationen. + +Unterstützt werden die Chat-Kategorien für 50/70 MHz, VHF/UHF, Microwave und EME/JT65. Andere ON4KST-Kategorien werden für die AirScout-Bandherleitung ignoriert. Kann keine ausreichend belastbare Frequenz bestimmt werden, sendet KST4Contest für diese Station keine Anfrage. Ein beliebiger Rückfall auf 144 MHz würde zwar ein syntaktisch vollständiges Paket erzeugen, aber nicht zwangsläufig eine sinnvolle Berechnung. + +Die automatische AirScout-Auswahl verwendet dieselbe Herleitung wie die interne Streckenanalyse. Damit bewerten beide Funktionen den Stationspfad auf derselben fachlichen Grundlage. + +### Festes AirScout-Band + +Wird **Auto per station** deaktiviert, verwendet KST4Contest den unter **Forced AirScout band value** eingetragenen Wert für alle Stationen. + +Der Wert wird in der von der AirScout-UDP-Schnittstelle verwendeten Einheit eingetragen: + +| Band | AirScout-Wert | +|---|---:| +| 50 MHz | `500000` | +| 70 MHz | `700000` | +| 144 MHz | `1440000` | +| 432 MHz | `4320000` | +| 1296 MHz | `12960000` | +| 2320 MHz | `23200000` | +| 3400 MHz | `34000000` | +| 5760 MHz | `57600000` | +| 10368 MHz | `103680000` | +| 24048 MHz | `240480000` | + +Im festen Modus wird weder die zuletzt erkannte QRG noch das im Namen genannte Band der Gegenstation berücksichtigt. Diese Einstellung ist deshalb hauptsächlich für einen eindeutig auf ein Band begrenzten Stationsbetrieb oder zur Fehlersuche sinnvoll. + +### Server- und Client-Identifier + +Die Identifier gehören zum AirScout-Protokoll und sind keine DNS-Namen oder IP-Adressen. + +Ausgehende Anfragen enthalten zunächst den Client- und anschließend den Server-Identifier: + +```text +"KST" "AS" +``` + +AirScout antwortet in umgekehrter Reihenfolge: + +```text +"AS" "KST" +``` + +KST4Contest verarbeitet eine Antwort nur, wenn beide Identifier exakt mit der aktuellen Konfiguration übereinstimmen. Der Vergleich unterscheidet zwischen Groß- und Kleinschreibung. + +Die Identifier dürfen nicht leer sein und keine Anführungszeichen oder Zeilenumbrüche enthalten. + +Werden mehrere KST4Contest-Instanzen im selben Netz betrieben, sollte jede einen eigenen Client-Identifier erhalten, beispielsweise: + +```text +KST-144 +KST-432 +``` + +Bei mehreren AirScout-Instanzen müssen zusätzlich unterschiedliche Server-Identifier verwendet werden. Dadurch wird verhindert, dass die Antwort für einen Arbeitsplatz von einer anderen KST4Contest-Instanz verarbeitet wird. + +### Welche Stationen werden angefragt? + +KST4Contest startet die erste periodische AirScout-Abfrage ungefähr zehn Sekunden nach dem Aufbau der Chat-Verbindung. Weitere Abfragen folgen im Abstand von 60 Sekunden. + +Eine aktive Station wird nur berücksichtigt, wenn: + +- ein verwendbares Rufzeichen vorhanden ist, +- ein Locator vorhanden ist, +- die Entfernung berechnet werden konnte, +- die Entfernung kleiner als das konfigurierte **Maximum-QRB** ist und +- ein verwendbares Band bestimmt werden konnte. + +Mehrere aktive Chat-Einträge desselben Basisrufzeichens erzeugen nicht für jeden Suffix eine eigene identische Pfadberechnung. Die zurückgegebenen AirScout-Informationen werden anschließend wieder den passenden aktiven Chat-Varianten zugeordnet. + +Die Auswahl begrenzt nicht nur den Netzwerkverkehr. Sie verhindert außerdem, dass AirScout dauerhaft Pfade berechnet, die außerhalb des für die eigene Station vorgesehenen Arbeitsbereichs liegen. + +### Übernahme geänderter Einstellungen + +Folgende Änderungen werden nach Verlassen des Eingabefeldes beziehungsweise Betätigen der Checkbox sofort für neue Pakete verwendet: + +- Aktivierung oder Deaktivierung der AirScout-Integration, +- Server-Identifier, +- Client-Identifier, +- automatische oder feste Bandauswahl und +- fester Bandwert. + +Nach einer Änderung des UDP-Ports muss die Chat-Verbindung getrennt und neu aufgebaut oder KST4Contest neu gestartet werden. Der bereits laufende UDP-Empfänger bleibt sonst weiterhin an den vorherigen Port gebunden. + +Zum dauerhaften Speichern anschließend **Save Settings** verwenden. + +Die Einrichtung der AirScout-Seite, die Anzeige der Flugzeuge und die Bedeutung der AP-Daten sind unter [AirScout-Integration](de-AirScout-Integration) beschrieben. --- diff --git a/github_docs/en-Configuration.md b/github_docs/en-Configuration.md index 76db659..1261e22 100644 --- a/github_docs/en-Configuration.md +++ b/github_docs/en-Configuration.md @@ -234,7 +234,128 @@ Click **Save Settings** after completing the configuration. ## AirScout Settings -Configuration of the interface to AirScout for aircraft scatter detection. Details: [AirScout Integration](en-AirScout-Integration). +The **AirScout** tab configures the UDP connection between KST4Contest and AirScout. KST4Contest does not request a general aircraft feed. It submits the station paths which are currently relevant, while AirScout calculates the matching aircraft and returns the result to the requesting KST4Contest instance. + +AirScout `0.9.9.5` or newer is required. + +![AirScout settings in KST4Contest](as_plane_feed_3.png){ width=85% } + +### UDP Connection Settings + +| Setting | Default | Use | +|---|---:|---| +| **Enable AirScout UDP integration** | disabled | Enables AirScout requests and the processing of returned information | +| **AirScout server identifier** | `AS` | Logical name of the AirScout instance being addressed | +| **KST4Contest client identifier** | `KST` | Logical name of this KST4Contest instance | +| **AirScout UDP port** | `9872` | Shared UDP port for requests and responses | +| **Select AirScout frequency automatically per station** | enabled | Derives a suitable band and frequency from the current context of each remote station | +| **Forced AirScout band value** | `1440000` | Uses one fixed AirScout band value for every station when automatic selection is disabled | + +When **Enable AirScout UDP integration** is disabled, KST4Contest neither sends AirScout requests nor processes incoming AirScout responses. The UDP receiver may remain bound so that the integration can be enabled again during the current connection. + +KST4Contest sends AirScout packets to the broadcast address `255.255.255.255`. No separate destination IP address is therefore configured. AirScout and KST4Contest must be able to receive the same UDP broadcast; routers do not normally forward this type of broadcast into another network. If communication fails, check the UDP port, local firewall and network assignment first. + +### Automatic Band Selection per Station + +**Auto per station** is the recommended setting. Instead of using one fixed band value for every remote station, KST4Contest derives a suitable frequency from the available operating context. + +The sources are evaluated in this order: + +1. the most recently detected QRG of the remote station, provided that it is no more than 30 minutes old, +2. one unambiguous complete QRG in the name field of an active chat entry, +3. unambiguous band designators in the name field, +4. 432 MHz if the same station is active in both the VHF/UHF and Microwave categories and 432 MHz is enabled for the local station, +5. the lowest locally enabled band belonging to the supported chat category. + +Active chat variants of the same base callsign are evaluated together. Entries such as `CALLSIGN`, `CALLSIGN-2` and `CALLSIGN-432` can therefore contribute to the same band decision while remaining separate chat members for message processing. + +Only bands enabled under **My station uses …** are eligible for automatic selection. A manually assigned NOT-QRV mark excludes the corresponding band and takes precedence over automatically detected QRG or name information. + +The 50/70 MHz, VHF/UHF, Microwave and EME/JT65 chat categories are supported. Other ON4KST categories do not participate in AirScout band resolution. If no sufficiently reliable frequency can be determined, KST4Contest omits the request for that station. An arbitrary fallback to 144 MHz would produce a syntactically complete packet, but not necessarily a useful calculation. + +Automatic AirScout selection uses the same propagation-frequency resolver as the internal path analysis. Both functions therefore evaluate the station path from the same technical basis. + +### Fixed AirScout Band + +When **Auto per station** is disabled, KST4Contest uses the value entered under **Forced AirScout band value** for every station. + +Enter the value in the unit used by the AirScout UDP interface: + +| Band | AirScout value | +|---|---:| +| 50 MHz | `500000` | +| 70 MHz | `700000` | +| 144 MHz | `1440000` | +| 432 MHz | `4320000` | +| 1296 MHz | `12960000` | +| 2320 MHz | `23200000` | +| 3400 MHz | `34000000` | +| 5760 MHz | `57600000` | +| 10368 MHz | `103680000` | +| 24048 MHz | `240480000` | + +In fixed mode, neither the remote station's recently detected QRG nor a band stated in its name is considered. This option is therefore mainly useful for a station setup which is clearly limited to one band, or for troubleshooting. + +### Server and Client Identifiers + +The identifiers belong to the AirScout protocol. They are not DNS names or IP addresses. + +Outgoing requests contain the client identifier followed by the server identifier: + +```text +"KST" "AS" +``` + +AirScout returns them in the opposite order: + +```text +"AS" "KST" +``` + +KST4Contest processes a response only if both identifiers exactly match the current configuration. The comparison is case-sensitive. + +Identifiers must not be empty and must not contain quotation marks or line breaks. + +If several KST4Contest instances operate in the same network, assign a distinct client identifier to each one, for example: + +```text +KST-144 +KST-432 +``` + +If several AirScout instances are present, use distinct server identifiers as well. This prevents a response intended for one operating position from being processed by another KST4Contest instance. + +### Which Stations Are Requested? + +KST4Contest starts the first periodical AirScout request approximately ten seconds after the chat connection has been established. Further requests follow every 60 seconds. + +An active station is included only if: + +- a usable callsign is available, +- a locator is available, +- its distance has been calculated, +- its distance is below the configured **Maximum QRB**, and +- a usable band can be determined. + +Several active chat entries of the same base callsign do not create a separate identical path calculation for every suffix. The returned AirScout information is subsequently assigned to the corresponding active chat variants. + +This selection does more than reduce network traffic. It also prevents AirScout from continuously calculating paths outside the intended working range of the local station. + +### Applying Changed Settings + +The following changes are used for new packets immediately after leaving the input field or changing the checkbox: + +- enabling or disabling the AirScout integration, +- server identifier, +- client identifier, +- automatic or fixed band selection, and +- the forced band value. + +After changing the UDP port, disconnect and reconnect the chat or restart KST4Contest. The existing UDP receiver otherwise remains bound to the previous port. + +Click **Save Settings** afterwards to retain the configuration. + +AirScout setup, aircraft display and the meaning of the returned AP information are described under [AirScout Integration](en-AirScout-Integration). ---