Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- server:schnittstelle:droniq [14.10.2025 09:42] – Patrick Vogel
+++ server:schnittstelle:droniq [30.09.2026 05:45] (aktuell) – Externe Bearbeitung 127.0.0.1
@@ Zeile 1: / Zeile 1: @@
-==== Schnittstelle "Droniq" ====
+====== Schnittstelle "Droniq" ======
-Über die Schnittstelle zu Droniq können Positionsmeldungen von Drohnen und anderen Luftfahrzeugen sowie ein Layer "Luftlagebild" in EDP übernommen und eingespielt werden. Die Schnittstelle verbindet sich mit dem VISX-Service von Droniq und empfängt Echtzeit-Positionsdaten über eine WebSocket-Verbindung.
+Über die Schnittstelle zu Droniq übernehmen Sie Positionsmeldungen von Drohnen und anderen Luftfahrzeugen sowie einen Layer "Luftlagebild" in EDP. Diese Seite beschreibt Voraussetzungen, Konfiguration, Funktionsweise und typische Fehlerbilder.
+{{:server:schnittstelle:droniq_luftlagebild.png?1000|}}
+===== Allgemein =====
+Die Schnittstelle verbindet sich mit dem VISX-Service von Droniq und empfängt Echtzeit-Positionsdaten über eine WebSocket-Verbindung.
 ^ Funktion ^ Daten senden ^ Daten empfangen |
 | Positionsmeldungen | | ✔ |
 | Luftlagebild | | ✔ |
-| Einsatzmittel-Positionen | ✔ | |
-✔ = Die Schnittstelle unterstützt diese Funktion. ✘ = die Schnittstelle unterstützt diese Funktion nicht. (Leer) = Entfällt.
+✔ = Die Schnittstelle unterstützt diese Funktion. ✘ = Die Schnittstelle unterstützt diese Funktion nicht. (Leer) = Entfällt.
-=== Voraussetzungen ===
+===== Voraussetzungen =====
   * Gültiger API-Token von Droniq (VISX-Service)
-  * Internetverbindung zum Droniq-Server (visx.droniq.io, Port 443)
+  * Internetverbindung zum Droniq-Server (''visx.droniq.io'', Port ''443'')
-  * In EDPmap muss eine Heimatposition (HOME) definiert sein
+  * In **edp:**map muss eine Heimatposition definiert sein
-  * Die Schnittstelle benötigt die Lizenz "Schnittstelle" im EDP-Server
+  * Wenn eigene Drohnen getrackt werden sollen, ein Transponder von Droniq
+===== Konfiguration =====
-=== Konfiguration ===
+Die Schnittstelle wird über den folgenden Konfigurationsdialog eingerichtet.
 {{:server:schnittstelle:droniq_konfig.png?300|}}
@@ Zeile 23: / Zeile 31: @@
 ^ Parameter ^ Beschreibung ^ Standardwert ^
-| **API-Token** | Der API-Token für den Zugriff auf den VISX-Service von Droniq. Dieser Token muss bei Droniq beantragt werden. | (leer) |
+| **API-Token** | Der API-Token für den Zugriff auf den VISX-Service von Droniq. Dieser Token muss bei Droniq beauftragt werden. | (leer) |
-| **Radius um Heimatposition** | Der Radius in Kilometern um die in EDPmap definierte Heimatposition, für den Luftfahrzeugdaten abgefragt werden. | 10 km |
+| **Radius um Heimatposition** | Der Radius in Kilometern um die in **edp:**map definierte Heimatposition, für den Luftfahrzeugdaten abgefragt werden. | 10 km |
 | ::: | **Maximum:** 50 km (wird automatisch begrenzt) | ::: |
 | ::: | **Minimum:** 1 km | ::: |
@@ Zeile 30: / Zeile 38: @@
 ==== Höhenfilter ====
-Mit dem Höhenfilter können eingehende Positionsmeldungen nach Flughöhe gefiltert werden. Dies ist nützlich, um z.B. nur niedrig fliegende Luftfahrzeuge anzuzeigen.
+Mit dem Höhenfilter filtern Sie eingehende Positionsmeldungen nach Flughöhe. Das ist nützlich, wenn z.B. nur niedrig fliegende Luftfahrzeuge angezeigt werden sollen.
 ^ Parameter ^ Beschreibung ^ Standardwert ^
@@ Zeile 37: / Zeile 45: @@
 | **min Flughöhe (in ft)** | Minimale Flughöhe in Fuß. Luftfahrzeuge unter dieser Höhe werden ignoriert. | 0 ft |
-<note>Wenn der Höhenfilter deaktiviert ist, werden alle Luftfahrzeuge unabhängig von ihrer Flughöhe angezeigt.</note>
+Ist der Höhenfilter deaktiviert, werden alle Luftfahrzeuge unabhängig von ihrer Flughöhe angezeigt.
-=== Luftlagebild ===
+===== Luftlagebild =====
-Die Schnittstelle erstellt automatisch einen Layer "Luftlagebild" in EDPmap, auf dem alle empfangenen Luftfahrzeuge dargestellt werden. Die Positionsmeldungen werden in Echtzeit aktualisiert.
+Die Schnittstelle legt in **edp:**map automatisch einen Layer "Luftlagebild" an, auf dem alle empfangenen Luftfahrzeuge dargestellt werden. Die Positionsmeldungen werden in Echtzeit aktualisiert.
-==== Angezeigt werden: ====
+==== Dargestellte Luftfahrzeuge ====
   * **Drohnen (UAV)** - Darstellung mit Drohnen-Symbol
@@ Zeile 56: / Zeile 64: @@
   * **Ultraleichtflugzeuge** (AIRSHIP, HANGGLIDER)
-==== Angezeigte Informationen: ====
+==== Angezeigte Informationen ====
 Für jedes Luftfahrzeug werden folgende Informationen angezeigt:
@@ Zeile 66: / Zeile 74: @@
   * **Zeitstempel** der letzten Positionsmeldung
-<note tip>Positionsmeldungen, die älter als 3 Minuten sind, werden automatisch aus dem Luftlagebild entfernt.</note>
+> **Hinweis:** Positionsmeldungen, die älter als 3 Minuten sind, werden automatisch aus dem Luftlagebild entfernt.
-=== Zuordnung von Einsatzmitteln ===
+===== Zuordnung von Einsatzmitteln =====
-Die Schnittstelle kann Positionsdaten bestimmter Luftfahrzeuge direkt den Einsatzmitteln in EDP zuordnen. Dies ermöglicht die automatische Aktualisierung der Position von eigenen Drohnen oder Hubschraubern im Einsatzmittelsystem.
+Die Schnittstelle kann Positionsdaten bestimmter Luftfahrzeuge direkt den Einsatzmitteln in EDP zuordnen. So wird die Position von eigenen Drohnen oder hinterlegten Hubschraubern in **edp:** automatisch aktualisiert.
+Eigene Drohnen können über einen Transponder von Droniq geortet werden. Weitere Informationen dazu finden Sie bei Droniq unter [[https://droniq.de/produkte/verkehrsmanagement/transponder-antikollision/|Droniq Transponder]].
 ==== Konfiguration der Zuordnung ====
-Im Textfeld "Zuordnung von EM" können Luftfahrzeug-Kennungen den Rufnamen von Einsatzmitteln zugeordnet werden.
+Im Textfeld "Zuordnung von EM" ordnen Sie Luftfahrzeug-Kennungen den Rufnamen von Einsatzmitteln zu. Jede Zuordnung hat das Format ''Kennung=Rufname'', zum Beispiel:
-**Format:**
+  * ''CHX17=Chr. 17''
-Kennung=Rufname
+  * ''D-HEMS=RTH Christoph 1''
+  * ''DRONE123=Drohne 1''
-**Beispiele:**
+Die **Kennung** entspricht dem Callsign (fid) oder der ICAO Mode-S Adresse (icx) des Luftfahrzeugs aus den Droniq-Daten. Der **Rufname** muss exakt mit dem Rufnamen des Einsatzmittels in der EDP-Datenbank übereinstimmen.
-CHX17=Chr. 17
-D-HEMS=RTH Christoph 1
-DRONE123=Drohne 1
+===== Funktionsweise =====
-<note important>
+  - Die Schnittstelle verbindet sich beim Start mit dem EDP-Server.
-  * Die **Kennung** entspricht dem Callsign (fid) oder der ICAO Mode-S Adresse (icx) des Luftfahrzeugs aus den Droniq-Daten
+  - In **edp:**map wird automatisch ein Layer "Luftlagebild" angelegt, falls er noch nicht vorhanden ist.
-  * Der **Rufname** muss exakt mit dem Rufnamen des Einsatzmittels in der EDP-Datenbank übereinstimmen
+  - Die WebSocket-Verbindung zum Droniq-Server (''visx.droniq.io'') wird aufgebaut.
-  * Pro Zeile eine Zuordnung
+  - Als Mittelpunkt wird die in **edp:**map definierte HOME-Position verwendet.
-</note>
+  - Die Schnittstelle authentifiziert sich mit dem konfigurierten API-Token.
+  - Eingehende Positionsmeldungen werden empfangen und verarbeitet.
+  - Die gefilterten Daten werden im Layer "Luftlagebild" angezeigt.
+  - Alle 3 Minuten werden veraltete Positionsmeldungen automatisch entfernt.
-==== Aktualisierte Felder im Einsatzmittel ====
+===== Keine Verbindung zum Droniq-Server =====
-Wenn eine Positionsmeldung für ein zugeordnetes Luftfahrzeug empfangen wird, werden folgende Felder in der Tabelle EINSATZMITTEL automatisch aktualisiert:
+Die Schnittstelle kann keine Verbindung zum Droniq-Server aufbauen.
-  * **KOORDX** - Longitude (Längengrad)
+**Ursache**
-  * **KOORDY** - Latitude (Breitengrad)
-  * **GPS_HEIGHT** - Flughöhe in Metern (automatische Umrechnung von Fuß)
-  * **LASTGEOPOS** - Zeitstempel der letzten Positionsaktualisierung
-  * **LASTGEOUSER** - Wird auf "Schn_Droniq" gesetzt
-Nach der Aktualisierung wird automatisch ein Telegramm ''UPDATE|EMGEOPOS|<Rufname>'' gesendet, um andere Komponenten über die Positionsänderung zu informieren.
+Mögliche Ursachen sind eine fehlende Internetverbindung, ein blockierter Port 443 oder ein ungültiger API-Token.
-=== Funktionsweise ===
+**Lösung**
-  - Die Schnittstelle verbindet sich beim Start mit dem EDP-Server
+  * Prüfen Sie die Internetverbindung.
-  - Es wird automatisch ein Layer "Luftlagebild" in EDPmap angelegt (falls nicht vorhanden)
+  * Stellen Sie sicher, dass Port ''443'' (HTTPS) nicht blockiert ist.
-  - Die WebSocket-Verbindung zum Droniq-Server (visx.droniq.io) wird aufgebaut
+  * Überprüfen Sie den API-Token.
-  - Als Mittelpunkt wird die in EDPmap definierte HOME-Position verwendet
-  - Die Schnittstelle authentifiziert sich mit dem konfigurierten API-Token
-  - Eingehende Positionsmeldungen werden empfangen und verarbeitet
-  - Gefilterte Daten werden im Luftlagebild-Layer angezeigt
-  - Alle 3 Minuten werden veraltete Positionsmeldungen automatisch entfernt
-  - Bei Verbindungsabbruch wird die Schnittstelle automatisch neu gestartet
-=== Fehlerbehebung ===
+===== Keine HOME-Position definiert =====
-==== Keine Verbindung zum Droniq-Server ====
+Die Schnittstelle meldet, dass keine HOME-Position definiert ist.
-  * Prüfen Sie die Internetverbindung
+**Ursache**
-  * Stellen Sie sicher, dass Port 443 (HTTPS) nicht blockiert ist
-  * Überprüfen Sie den API-Token
-==== Keine HOME-Position definiert ====
+In **edp:**map ist keine HOME-Position (Heimatposition) festgelegt.
-  * Öffnen Sie EDPmap
+**Lösung**
-  * Definieren Sie eine HOME-Position (Heimatposition) in den Karteneinstellungen
-==== Luftfahrzeuge werden nicht angezeigt ====
+  - Öffnen Sie **edp:**map.
+  - Definieren Sie in den Karteneinstellungen eine HOME-Position (Heimatposition).
-  * Prüfen Sie, ob der konfigurierte Radius ausreichend groß ist
+===== Luftfahrzeuge werden nicht angezeigt =====
-  * Überprüfen Sie die Höhenfilter-Einstellungen
-  * Kontrollieren Sie im Log, ob Daten empfangen werden (LogRAW aktivieren)
-  * Stellen Sie sicher, dass in Ihrem Umkreis tatsächlich Luftfahrzeuge unterwegs sind
-==== Einsatzmittel-Position wird nicht aktualisiert ====
+Im Luftlagebild erscheinen keine Luftfahrzeuge.
-  * Prüfen Sie die Schreibweise der Kennung und des Rufnamens
+**Ursache**
-  * Stellen Sie sicher, dass das Einsatzmittel in EDP existiert
-  * Überprüfen Sie das Log auf Meldungen wie "Prüfe: <Kennung>" und "Rufname: <Rufname>"
-  * Die Kennung muss exakt dem Callsign oder der ICAO-Adresse des Luftfahrzeugs entsprechen
-=== Technische Details ===
+Mögliche Ursachen sind ein zu kleiner Radius, ein Höhenfilter, der die Luftfahrzeuge ausschließt, oder es sind in Ihrem Umkreis tatsächlich keine Luftfahrzeuge unterwegs.
-  * **Protokoll:** WebSocket über TLS (wss://)
+**Lösung**
-  * **Server:** visx.droniq.io:443
-  * **Datenformat:** JSON
-  * **Heartbeat-Intervall:** 30 Sekunden
-  * **Reconnect:** Automatisch bei Verbindungsabbruch
-  * **Datenaktualisierung:** Echtzeit
-  * **Veraltungszeit:** 3 Minuten
-=== Weiterführende Links ===
+  * Prüfen Sie, ob der konfigurierte Radius ausreichend groß ist.
+  * Überprüfen Sie die Einstellungen des Höhenfilters.
+  * Stellen Sie sicher, dass in Ihrem Umkreis tatsächlich Luftfahrzeuge unterwegs sind.
+===== Einsatzmittel-Position wird nicht aktualisiert =====
+Die Position eines zugeordneten Einsatzmittels wird nicht aktualisiert.
+**Ursache**
+Mögliche Ursachen sind eine abweichende Schreibweise von Kennung oder Rufname in der Zuordnung oder ein Einsatzmittel, das in EDP nicht existiert.
+**Lösung**
+  * Prüfen Sie die Schreibweise der Kennung und des Rufnamens.
+  * Stellen Sie sicher, dass das Einsatzmittel in EDP existiert.
+  * Überprüfen Sie das Log auf Meldungen wie "Prüfe: <Kennung>" und "Rufname: <Rufname>".
+  * Die Kennung muss exakt dem Callsign oder der ICAO-Adresse des Luftfahrzeugs entsprechen.
+===== Weiterführende Links =====
   * [[https://www.droniq.de/|Droniq Website]]
-  * [[https://visx.droniq.io/|VISX Service]]