Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- server:schnittstelle:droniq [14.10.2025 10:06] – 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 |
@@ Zeile 6: / Zeile 13: @@
 | Luftlagebild | | ✔ |
-✔ = 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
-  * Wenn eigene Drohne getracked werden soll: Transponder von Droniq
+  * 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|}}
-== Grundkonfiguration ==
+==== Grundkonfiguration ====
 ^ Parameter ^ Beschreibung ^ Standardwert ^
 | **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 | ::: |
-== Höhenfilter ==
+==== 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 36: / Zeile 45: @@
 | **min Flughöhe (in ft)** | Minimale Flughöhe in Fuß. Luftfahrzeuge unter dieser Höhe werden ignoriert. | 0 ft |
-**Wenn der Höhenfilter deaktiviert ist, werden alle Luftfahrzeuge unabhängig von ihrer Flughöhe angezeigt.**
+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 55: / Zeile 64: @@
   * **Ultraleichtflugzeuge** (AIRSHIP, HANGGLIDER)
-== Angezeigte Informationen: ==
+==== Angezeigte Informationen ====
 Für jedes Luftfahrzeug werden folgende Informationen angezeigt:
@@ Zeile 65: / Zeile 74: @@
   * **Zeitstempel** der letzten Positionsmeldung
-**Positionsmeldungen, die älter als 3 Minuten sind, werden automatisch aus dem Luftlagebild entfernt.**
+> **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 hinterlegten Hubschraubern in edp:. **Eigene Drohnen können über einen Transponder von Droniq geortet werden, weitere Informationen finden Sie dazu bei Droniq: [[https://droniq.de/produkte/verkehrsmanagement/transponder-antikollision/|Droniq Tranponder]]**
+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.
-== Konfiguration der Zuordnung ==
+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]].
-Im Textfeld "Zuordnung von EM" können Luftfahrzeug-Kennungen den Rufnamen von Einsatzmitteln zugeordnet werden.
+==== Konfiguration der Zuordnung ====
-**Format:**
+Im Textfeld "Zuordnung von EM" ordnen Sie Luftfahrzeug-Kennungen den Rufnamen von Einsatzmitteln zu. Jede Zuordnung hat das Format ''Kennung=Rufname'', zum Beispiel:
-Kennung=Rufname
-**Beispiele:**
+  * ''CHX17=Chr. 17''
-CHX17=Chr. 17
+  * ''D-HEMS=RTH Christoph 1''
-D-HEMS=RTH Christoph 1
+  * ''DRONE123=Drohne 1''
-DRONE123=Drohne 1
+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.
-  * Die **Kennung** entspricht dem Callsign (fid) oder der ICAO Mode-S Adresse (icx) des Luftfahrzeugs aus den Droniq-Daten
+===== Funktionsweise =====
-  * Der **Rufname** muss exakt mit dem Rufnamen des Einsatzmittels in der EDP-Datenbank übereinstimmen
+  - Die Schnittstelle verbindet sich beim Start mit dem EDP-Server.
+  - In **edp:**map wird automatisch ein Layer "Luftlagebild" angelegt, falls er noch nicht vorhanden ist.
+  - Die WebSocket-Verbindung zum Droniq-Server (''visx.droniq.io'') wird aufgebaut.
+  - Als Mittelpunkt wird die in **edp:**map definierte HOME-Position verwendet.
+  - 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.
-=== Funktionsweise ===
+===== Keine Verbindung zum Droniq-Server =====
-  - Die Schnittstelle verbindet sich beim Start mit dem EDP-Server
+Die Schnittstelle kann keine Verbindung zum Droniq-Server aufbauen.
-  - Es wird automatisch ein Layer "Luftlagebild" in EDPmap angelegt (falls nicht vorhanden)
-  - Die WebSocket-Verbindung zum Droniq-Server (visx.droniq.io) wird aufgebaut
-  - 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
-=== Fehlerbehebung ===
+**Ursache**
-== Keine Verbindung zum Droniq-Server ==
+Mögliche Ursachen sind eine fehlende Internetverbindung, ein blockierter Port 443 oder ein ungültiger API-Token.
-  * Prüfen Sie die Internetverbindung
+**Lösung**
-  * Stellen Sie sicher, dass Port 443 (HTTPS) nicht blockiert ist
-  * Überprüfen Sie den API-Token
-== Keine HOME-Position definiert ==
+  * Prüfen Sie die Internetverbindung.
+  * Stellen Sie sicher, dass Port ''443'' (HTTPS) nicht blockiert ist.
+  * Überprüfen Sie den API-Token.
-  * Öffnen Sie EDPmap
+===== Keine HOME-Position definiert =====
-  * Definieren Sie eine HOME-Position (Heimatposition) in den Karteneinstellungen
-== Luftfahrzeuge werden nicht angezeigt ==
+Die Schnittstelle meldet, dass keine HOME-Position definiert ist.
-  * Prüfen Sie, ob der konfigurierte Radius ausreichend groß ist
+**Ursache**
-  * Überprüfen Sie die Höhenfilter-Einstellungen
-  * Stellen Sie sicher, dass in Ihrem Umkreis tatsächlich Luftfahrzeuge unterwegs sind
-== Einsatzmittel-Position wird nicht aktualisiert ==
+In **edp:**map ist keine HOME-Position (Heimatposition) festgelegt.
-  * Prüfen Sie die Schreibweise der Kennung und des Rufnamens
+**Lösung**
-  * 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 ===
+  - Öffnen Sie **edp:**map.
+  - Definieren Sie in den Karteneinstellungen eine HOME-Position (Heimatposition).
+===== Luftfahrzeuge werden nicht angezeigt =====
+Im Luftlagebild erscheinen keine Luftfahrzeuge.
+**Ursache**
+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.
+**Lösung**
+  * 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]]