Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- server:schnittstelle:lardis [2021/09/16 15:25] – dominik
+++ server:schnittstelle:lardis [2024/12/20 14:21] (aktuell) – admin
@@ Zeile 3: / Zeile 3: @@
 ===== Einführung =====
-Über die Schnittstelle "funk_lardis" können Sie EDP mit einem an einer Lardis-Box angebundenen Funkgerät verbinden. Die Schnittstellen kann ebenso für die im Industrieumfeld verwendete Lösung "RDC" genutzt werden.
+Über die Schnittstelle "funk_lardis" können Sie EDP mit __einem__ an einer Lardis-Box angebundenen Funkgerät verbinden. Die Schnittstellen kann ebenso für die im Industrieumfeld verwendete Lösung "RDC" genutzt werden.
 Die Schnittstelle unterstützt folgende Funktionen:
-  * Empfangen von Tetra-Statusmeldungen
-  * Empfangen von Tetra-LIP-Positionsmeldungen
-  * Empfangen von Tetra-SDS
-  * Versenden von SDS und Flash-SDS
-  * Versenden von Tetra-Callout
-  * Versenden von POCSAG-Alarmen (vornehmlich im Zusammenhang von RDC)
-  * Versenden von 5-Tonfolgen
+^ Funktion ^ Daten senden ^ Daten empfangen |
+| SDS und Flash SDS | ✔ | ✔ |
+| Tetra Statusmeldungen| | ✔ |
+| Callout | ✔ | ✔ |
+|Eingehende LIP Positionsmeldung| | ✔ |
+| LIP Positionsabfragen | ✔  Siehe dazu: [[elp:tetra|]] | |
+|POCSAG-Alarmierungen | ✔ Vornehmlich in Zusammenhang mit RDC | ✘|
+|Fünftonfolgen | ✔ | ✘|
+|Telefonnummer wählen | ✔ |  |
+| Telefonnummer aus aktivem Telefonat übernehmen| | ✔ |
+✔ = Die Schnittstelle unterstützt diese Funktion. ✘ = die Schnittstelle unterstützt diese Funktion nicht. (Leer) = Entfällt.
 Die Schnittstelle kommuniziert per TCP-IP mit der Lardis-Box, auf der für jedes angebundene Funkgerät ein eigener TCP-Socket mit einem eigenen Port vorhanden ist.
@@ Zeile 33: / Zeile 37: @@
 Die Kanalnummer dient der Zuordnung von Aufgaben zur Auslösung von 5-Ton-Alarmierungen sowie dem Versand von FMS Fernwanweisungen zur richtigen Lardisbox.
-Die Kanalnummer kann ignoriert werden nur Tetra angebunden ist.
+Die Kanalnummer kann ignoriert werden, wenn nur Tetra angebunden ist.
+==== Sondereinstellungen / DMR ====
+Wenn unter "Sondereinstellungen" der Haken "DMR Nachricht als Status auswerten" gesetzt ist, verarbeitet die Schnittstelle eingehende DMR-Nachrichten als Status, wenn die DMR-Nachricht wie folgt aufgebaut ist:
+Status {STATUSNUMMER}.
+Ein eingehende DMR-Nachricht mit dem Text "Status 1" würde dann als Status 1 über die Telegrammverarbeitung Tetra verarbeitet werden. Dazu muss dann die Kennung des Funkgeräts als Tetra-Gerät mit dem Haken "Statusmeldungen auswerten" zu dem Einsatzmittel hinterlegt sein.
+Hintergrund dieser Funktion ist die Tatsache, dass im DMR Funk keine Statusmeldungen vorgesehen sind und daher die Tasten 0 - 9 des FuGs mit einer Schnellwahl zum Versand einer Nachricht mit einem definierten Text ("Status X") versehen sind.
@@ Zeile 43: / Zeile 57: @@
 ===== Anbindung Telefonie =====
-Die Schnittstellen-DLL "Lardis" verarbeitet die zentrale Anbindung von Lardis an den EDP-Server. Darüber hinaus ist das Wählen von Telefonnummern über den jeweiligen EDP Einsatzleitplatz auf einer definierten Leitung innerhalb des Lardis-Desks möglich. Da hierfür der jeweilige Einsatzleitplatz an Lardis angebunden werden muss, betrifft dies nicht unmittelbar die hier dokumentierte Schnittstellen-DLL, soll aber der Vollständigkeit halber an dieser Stelle erläutert werden.
+Die Schnittstellen-Exe "Lardis" verarbeitet die zentrale Anbindung von Lardis an den EDP-Server. Darüber hinaus ist das Wählen von Telefonnummern über den jeweiligen EDP Einsatzleitplatz auf einer definierten Leitung innerhalb des Lardis-Desks möglich. Da hierfür der jeweilige Einsatzleitplatz an Lardis angebunden werden muss, betrifft dies nicht unmittelbar die hier dokumentierte Schnittstellen-Exe, soll aber der Vollständigkeit halber an dieser Stelle erläutert werden.
 In der Konfigurationsdatei des Einsatzleitplatzes (ELP.ini) ist folgender Teil zu ergänzen:
@@ Zeile 53: / Zeile 67: @@
 Host=1.2.3.4
 ;Port auf der Masterbox
-Port=2000
+Port=2998
 ;IP Adresse des Lardis-Desks, auf dem gewählt werden soll
 IP-Desk=1.2.3.4
@@ Zeile 63: / Zeile 77: @@
 "Aktiv=1" schaltet die Schnittstelle Telefonie des Einsatzleitplatzes zu Lardis aktiv.
-Unter "Host" und "Port" geben Sie bitte die TCP-Verbindungsdaten zur Lardis-Box an (nicht zur Telefonanlage).
+Unter "Host" und "Port" geben Sie bitte die TCP-Verbindungsdaten zur Lardis-Box an (nicht zur Telefonanlage). **Typischerweise müsste hier die IP-Adresse der Masterbox sowie der Port 2998 angegeben werden.**
-Als IP-Desk geben Sie an, an welchem Lardis-Desk die Telefonnummer gewählt werden soll. SIP-Index ist die Nummer der SIP-Leitung, auf der das Telefonat gestartet werden soll.
+Als **IP-Desk** geben Sie an, an welchem Lardis-Desk die Telefonnummer gewählt werden soll.
+**SIP-Index** ist die Nummer der SIP-Leitung, auf der das Telefonat gestartet werden soll. Index 1-4 = Am Arbeitsplatz (DESK) konfiguriertes Telefon 1-4 (Arbeitsplatzbezogen), Index 100 = Privates SIP-Telefon des aktuell angemeldeten Benutzers (Benutzerbezogen).
 EDP kann für die Wahl von Telefonnummern bei Bedarf ein Prefix (klassischer Weise eine 0) an die zu wählende Nummer voranstellen. D.h. wenn für die korrekte Bedienung die Vorwahl einer Null erforderlich ist, sollte an dieser Stelle bei "Prefix" der Wert "0" angegeben werden. Ansonsten kann dieser Wert leer bleiben.
+====== SDS an Lardis One ======
+Dieser Punkt betrifft nicht unmittelbar die Lardis-Schnittstelle, wird der Vollständigkeit halber aber auch hier aufgeführt. Wenn von EDP eine SDS mit Einsatzdaten an Lardis One gesendet werden soll, muss die SDS als erstes die Koordinate in einem speziellen Format übertragen werden.
+Dazu sollte der Protokolltag <%LARDISONE%> verwendet werden.
+Dabei muss für den Protokolltag folgende SQL-Abfrage verwendet werden:
+<code>
+SELECT CASE WHEN KOORDX < 10 THEN REPLACE(CONCAT('0', LEFT(FORMAT(KOORDX, 7, 0),7)),'.','') ELSE REPLACE(LEFT(FORMAT(KOORDX, 8, 0),8),'.','') END AS KOORDX,LEFT(REPLACE(FORMAT(KOORDY,8,0),'.',''), 8) AS KOORDY FROM EINSAETZE WHERE EINSATZNUMMER=<%EINSATZNUMMER%></code>
+Als Wert des Protokolltags sollte folgendes eingetragen sein:
+<code>
+#K01;N<%KOORDY%>E<%KOORDX%>;
+</code>
+In der SDS sollte dann als erstes der Tag <%LARDISONE%> angegeben sein. Danach können flexibel weitere Felder folgen.
+====== Aussenden eines Callouts ======
+Über die Schnittstelle zu Lardis kann sowohl ein Tetra-Callout nach dem Standard TLV als auch nach dem Standard Hessen ausgesendet werden.
+In der Konfiguration von Lardis für das jeweilige Funkgerät muss dort eingestellt werden, welche Variante ausgesendet werden soll. Innerhalb von EDP muss der Callout mit dem jeweiligen Zahlenwert und einem vorangestellten &-Symbol eingetragen werden.
+Auch bei einem TLV-Callout für mehr als eine Subadresse müssten hier die jeweiligen Subadressen mit einem &-Zeichen verknüpft eingegeben werden.
+Für den Callout von nur einer Subadresse ist auch die Eingabe des reinen Zahlenwerts in der jeweiligen Aufgabe ausreichend. Sollte ein Multipart-Callout ausgesendet werden, erfolgt dies auch automatisiert auf Ebene von Lardis.