Herunterladen Inhalt Inhalt
Teilen
Diese Seite drucken
Siemens SIMATIC RTLS Applikationshandbuch
  1. Anleitungen
  2. Marken
  3. Siemens Anleitungen
  4. Industrielle Ausrüstung
  5. SIMATIC RTLS
  6. Applikationshandbuch
Siemens SIMATIC RTLS Applikationshandbuch

Siemens SIMATIC RTLS Applikationshandbuch

Lokalisierungssysteme/datenexportdienst
Vorschau ausblenden Andere Handbücher für SIMATIC RTLS:
Inhaltsverzeichnis

Werbung

Quicklinks

Diese Anleitung herunterladen
SIMATIC RTLS
Lokalisierungssysteme
SIMATIC RTLS Datenexportdienst
Applikationshandbuch
03/2024
C79000-G8900-C531-08
Einleitung
Cybersecurity-
Empfehlungen
Übersicht
Installation des
"Datenexportdienst"
Konfiguration des
"Datenexportdienst"
Fehlersuche
1
2
3
4
5
6

Werbung

Inhaltsverzeichnis
loading

Verwandte Anleitungen für Siemens SIMATIC RTLS

Inhaltszusammenfassung für Siemens SIMATIC RTLS

  • Seite 1 Einleitung Cybersecurity- Empfehlungen Übersicht SIMATIC RTLS Installation des "Datenexportdienst" Lokalisierungssysteme SIMATIC RTLS Datenexportdienst Konfiguration des "Datenexportdienst" Fehlersuche Applikationshandbuch 03/2024 C79000-G8900-C531-08...

  • Seite 2: Qualifiziertes Personal

    Beachten Sie Folgendes: WARNUNG Siemens-Produkte dürfen nur für die im Katalog und in der zugehörigen technischen Dokumentation vorgesehenen Einsatzfälle verwendet werden. Falls Fremdprodukte und -komponenten zum Einsatz kommen, müssen diese von Siemens empfohlen bzw. zugelassen sein. Der einwandfreie und sichere Betrieb der Produkte setzt sachgemäßen Transport, sachgemäße Lagerung, Aufstellung, Montage, Installation, Inbetriebnahme, Bedienung und...

  • Seite 3: Inhaltsverzeichnis

    Exportmodul "ExportEpaperAPI" ..................53 5.7.1 Übersicht ........................... 53 5.7.2 Kommunikation über die Programmierschnittstelle............. 54 5.7.3 RPC-Aufrufe ........................57 5.7.4 Event-Meldungen ......................59 5.7.5 Code-Beispiele ........................60 5.7.6 Weiterführende Information....................64 BatteryLevelEvents......................64 Fehlersuche ............................65 SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 4 Inhaltsverzeichnis SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 5: Einleitung

    Datenexportdienst" (kurz: "Datenexportdienst"), der Bestandteil der Lokalisierungssoftware "SIMATIC RTLS Locating Manager" (kurz: Locating Manager) ist. Gültigkeitsbereich dieser Dokumentation Diese Dokumentation ist gültig für die Version 3.0 des "SIMATIC RTLS Locating Manager". Weiterführende Informationen Weitere Informationen zu den in dieser Dokumentation genannten SIMATIC RTLS-Produkten erhalten Sie in der Liesmich-Datei oder auf den Siemens-Support-Seiten.
  • Seite 6 Cybersecurity finden Sie unter: (https://www.siemens.com/global/en/products/automation/ topic-areas/industrial-cybersecurity.html) Die Produkte und Lösungen von Siemens werden ständig weiterentwickelt, um sie noch sicherer zu machen. Siemens empfiehlt ausdrücklich, Produkt-Updates anzuwenden, sobald sie zur Verfügung stehen und immer nur die aktuellen Produktversionen zu verwenden. Die Verwendung veralteter oder nicht mehr unterstützter Versionen kann das Risiko von Cyber-Bedrohungen erhöhen.

  • Seite 7: Recycling Und Entsorgung

    Einleitung Um stets über Produkt-Updates informiert zu sein, abonnieren Sie den Siemens Industrial Cybersecurity RSS Feed unter: (https://new.siemens.com/global/en/products/ services/cert.html) Hinweis zum Firmware-/Software-Support Informieren Sie sich regelmäßig über neue Firmware-/Software-Versionen oder Sicherheits- Updates und wenden Sie diese an. Ab der Veröffentlichung einer neuen Version werden Vorgängerversionen nicht mehr unterstützt und nicht gewartet.
  • Seite 8 Einleitung SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 9: Cybersecurity-Empfehlungen

    • Definieren Sie Regeln für die Nutzung der Software und die Vergabe von Passwörtern. Konfigurieren Sie diese Rollen über die Komponente "RTLS-LM-IAM" und Active Directory. • Aktualisieren Sie regelmäßig die Passwörter, um die Sicherheit zu erhöhen. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 10: Physischer Zugang

    Cybersecurity-Empfehlungen • Ändern Sie Nutzernamen und Standardpasswörter der Datenbanken, bevor Sie die Software verwenden. Beim SIMATIC RTLS Locating Manager werden für jede Installation ein änderbarer Nutzer und ein änderbares Passwort verwendet. Eine Änderung des Passwortes ist über die jeweilige DBMS-Version möglich. Die Nutzerdaten sind in der RTLS-LM-IAM- Datenbank gespeichert.

  • Seite 11: Sichere Und Unsichere Protokolle

    • Authentifizierung Gibt an, ob eine Authentifizierung des Kommunikationspartners stattfindet. – Ja: Die Authentifizierung findet statt. – Nein: Die Authentifizierung findet nicht statt. – Optional: Die Authentifizierung findet standardmäßig statt, kann aber deaktiviert werden. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 12 Offen Nein Nein ePaper Manager TCP/8083 Offen Nein Nein Client-Verbin‐ TCP/9500 Offen Optional dung WAMP-Router TCP/12344 Offen Nein Nein Optional Prometheus TCP/40492 Offen Nein WindowsExpor‐ TCP/40493 Offen Nein (Prometheus) GatewayPosition‐ TCP/40494 Offen Nein IntegrityExporter SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 13 Cybersecurity-Empfehlungen Dienst Protokoll/ Voreingestell‐ Port konfigu‐ Authentifizie‐ Verschlüsse‐ Extern verfüg‐ Portnummer ter Portstatus rierbar rung lung gRPC-ClientCom‐ TCP/50051 Offen Nein Nein munication gRPC-Logging‐ TCP/50052 Offen Nein Nein Service SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 14 Cybersecurity-Empfehlungen SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 15: Übersicht

    ExportAVT TCP-Server Bereitstellung von Transponder- und Gatewaydaten Der "Datenexportdienst" wird über die Datei "RTLS_LM_DataExport.ini" konfiguriert. Diese ist standardmäßig im Verzeichnis "C:\ProgramData\Siemens\SIMATIC RTLS Locating Manager\Config" abgelegt. Die Konfiguration müssen Sie vor dem Start des Diensts "Datenexportdienst" vornehmen. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 16 Übersicht Client starten Der "Datenexportdienst" (RTLS_LM_DataExportService.exe) wird automatisch beim Hochfahren des PCs gestartet. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 17: Installation Des "Datenexportdienst

    Installationsverzeichnis des Locating Manager wird der "Datenexportdienst" im automatisch angelegten Unterordner "DataExport" installiert, wenn Sie das voreingestellte Installationsverzeichnis gewählt haben. Um den "Datenexportdienst" jetzt zu starten, müssen Sie das Optionskästchen aktivieren, bevor Sie die Schaltfläche "Fertigstellen" am Ende der Installation klicken. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 18 Installation des "Datenexportdienst" SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 19: Konfiguration Des "Datenexportdienst

    Anpassungen können Parameter angepasst werden. Die Konfiguration starten Sie über die Konfigurationsdatei "RTLS_LM_DataExport.ini", die sich im Ordner "%ProgramData% \Siemens\SIMATIC RTLS Locating Manager\Config\" befindet. Durch einen Doppelklick auf die Datei öffnet sich diese im Texteditor. Speichern Sie in dieser Datei vorgenommene Einträge vor dem Schließen des Editors, damit diese wirksam werden.
  • Seite 20 ;Konfiguration der Einklinkung des Dienstes in die Diensteüberwachung des Locating Manager-Servers. Aktivierung durch Angabe einer Zahl größer als 5 (Default: 7) (0 steht für inaktiv) ;ServiceMonitoringID=0 [ExportAVT] Active=1 Port=810 PosDataMsg=P1 [Module.AVT2] Active=1 Port=820 ExportType=ExportAVT PosDataMsg=P1 StateDataMsg=S1 PositionFormate=LatLon SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 21 Wenn der "Datenexportdienst" auf einem anderen PC installiert ist, muss eine Kopie der Konfigurationsdatei des Servers "RTLS_LM_Global.ini" im Ordner "%ProgramData%\Siemens\SIMATIC RTLS Locating Manager\Config\" neben der Konfigurationsdatei "RTLS_LM_DataExport.ini" des "Datenexportdienst" liegen, um die Datenverbindung herzustellen. Den Host und Port des Locating Managers können Sie in der Konfigurationsdatei des Diensts "Datenexportdienst"...

  • Seite 22: Unterstützte Framing-Verfahren Im Rtls-Lokalisierungsnetzwerk

    In der folgenden Tabelle sind alle unterstützten Framing-Verfahren aufgelistet: Framing-Verfahren Beschreibung LineFeedFraming Dieses Framing-Verfahren kennzeichnet eine Nachricht durch einen Zeilen‐ umbruch (0x0a). LineFeedFramingCR Dieses Framing-Verfahren kennzeichnet eine Nachricht durch einen Zeilen‐ umbruch mit Zeilenvorschub (0x0d0a). SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 23: Protokollierung Interner Ereignisse Und Der Datenübertragung

    Protokollierung interner Ereignisse und der Datenübertragung Protokollierung interner Ereignisse Der "Datenexportdienst" protokolliert den Verbindungsaufbau, das Trennen von Verbindungen und Fehlermeldungen in internen Protokollen. Diese Protokolle können in der SIMATIC RTLS Web-App über die Eventlog-Seite gelesen und angezeigt werden. SIMATIC RTLS Datenexportdienst...

  • Seite 24: Protokollierung Der Datenübertragung

    Standardwert: 500 ProtocolFile.sFilePath Dieser Parameter gibt den Pfad zu den Protokolldateien an. Wenn kein Pfad angegeben ist, wird der Ordner "%ProgramData%\Siemens\SIMA‐ TIC RTLS Locating Manager\Logs\DataExport" verwendet. In jedem Exportmodul-Block können Sie dann die Protokollierung über den folgenden Parameter aktivieren oder deaktivieren. Wenn Sie diesen aktivieren, wird die Datenübertragung dieses Exportmoduls in Log-Dateien exportiert.

  • Seite 25: Aufbau Der Protokollmeldungen

    Serverdatenbankverbindung in der Datei "RTLS_LM_Global.ini" > Abschnitt [DataBase]. Die Parameter sind identisch aufgebaut. Zudem müssen Sie den Wert des Parameters "Active" von "0" auf "1" setzen, um den Export über die Datenbankschnittstelle zu aktivieren. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 26: Exportierte Daten In Der Datenbank

    Der Dienst unterstützt SLMP-Telegramme (Simple Location Message Protocol), die entsprechend der Norm ISO/IEC 24730-1:2014 aufgebaut sind und über TCP/IP übermittelt werden. Diese Funktionalität muss wie in Kapitel "Allgemeine Konfigurationen (Seite 19)" beschrieben in der Konfigurationsdatei "RTLS_LM_DataExport.ini" des "Datenexportdienst" aktiviert werden. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 27: Verbindungsaufbau, Daten- Und Telegrammdefinition

    Wert "1" konfiguriert ist. Die konfigurierte Zeit wird in Sekunden angegeben. Folgende Werte sind möglich: 5: minimaler Wert 3600: maximaler Wert WelcomeField SIMATIC RTLS LM Der Parameter dient zur Modifikation der Begrüßungsnachricht beim Verbinden. Es ist eine Textlänge von 256 Zeichen erlaubt. Appliance_ID LM01...

  • Seite 28: Telegramm Für Positionsübermittlung

    TCP-Server. Den dafür verwendeten Port können Sie konfigurieren und dürfen ihn nur 1 Mal im gesamten RTLS‑Lokalisierungssystem verwenden. Wenn Sie die Verbindung zwischen dem "Datenexportdienst" und dem Locating Manager‑Server beenden, wird der Port geschlossen und die bestehende Verbindung zu den Gegenseiten getrennt. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 29: Verhalten Bei Befehlen (Ab "Exportavt" V1.2)

    Wenn mehrere Gegenseiten solche Befehle senden, werden die Befehle gemäß Reihenfolge des Eintreffens am Locating Manager ausgeführt. Hinweis Gerätespezifische Befehle werden nicht von allen Geräten unterstützt. Welches Gerät welche Funktionen unterstützt, können Sie der Betriebsanleitung des Geräts entnehmen. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 30: Verhalten In Abhängigkeit Der Version Der Gegenseite Bei Allen Eingehenden Befehlen

    Dieser Parameter erkennt das Ende einer Nachricht. Folgende Framing-Typen sind möglich: LineFeedFraming (0x0A) LineFeedFramingCR (0x0D0A) Framing7f8f BSCFraming LengthEncodingFraming SendInitialData Dieser Parameter überträgt die initialen Daten während dem Verbindungsaufbau. Folgende Werte sind möglich: Nicht senden Senden SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 31 BatteryStateMsg Dieser Parameter gibt an, welche Nachrichten für Batterie‐ stände übertragen werden sollen. Folgender Wert ist mög‐ lich:  BattState1 KeepAliveMsg Dieser Parameter gibt an, welche Lebenszeichen-Nachrichten übertragen werden sollen. Folgender Wert ist möglich: KeepAlive1 SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 32: Abschnitt "[Orientation]" In Der Konfigurationsdatei

    Positionsdaten als "Latitude" und "Longitude" übertragen werden sollen. Die lokalisierte Position eines Transponders wird in kartesischen x‑, y‑ und z‑Koordinaten relativ zu einem Punkt, wie z. B. dem Koordinatenursprung, angegeben. Die Koordinatenwerte können positiv oder negativ sein. Die Position des Koordinatenursprungs SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 33 ;Eine Koordinate des Bereichs in x-, y- und z-Koordinaten (in cm) RTLSHQ.LocRef.X = -434 RTLSHQ.LocRef.Y = 1564 RTLSHQ.LocRef.Z = 0 ;Die entsprechenden GPS-Koordinaten (in Grad) RTLSHQ.Latitude = 50.857745 RTLSHQ.Longitude = 12.929436 RTLSHQ.HeightCM = 35000 SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 34: Ausgabedaten Des Exportmoduls "Exportavt

    Dieser Parameter gibt die ID des Telegramms an. Zeitstempel DateTime Dieser Parameter gibt den Zeitpunkt an, zu dem das Tele‐ gramm versendet wurde. Bei Nachrichten von einer externen Software zum Loca‐ ting Manager‑Server ist die Angabe eines Zeitstempels optio‐ nal. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 35 Gegenseite sind Fehler aufgetreten. SetOutputs1 Ausgänge schalten 1.2 / 2.12   Schalten des Zu‐ standes der Aus‐ gänge von Trans‐ pondern. Bestäti‐ gung über Tele‐ gramm-ID "CMD_Ack1". Feh‐ ler über Tele‐ gramm-ID "Error1". SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 36 1.2 / 2.12   Umschalten des AMA-Betriebszu‐ AMA-Betriebszus‐ stand tands eines Trans‐ ponders. Fehler über Telegramm- ID "Error1". * Alle Telegramme, die in einer älteren ExportAVT-Version unterstützt werden, werden auch in neueren ExportAVT-Versionen unterstützt. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 37: Parameter "Nodeident

    Versionsnachricht von einer externen Gegenseite (kundenspezifische Managementsoftware) empfängt. Wenn das Exportmodul "ExportAVT" das Telegramm gesendet hat, startet der "Datenexportdienst" die Übertragung der Daten. Wenn die empfangene Version nicht unterstützt wird, dann wird die Verbindung getrennt. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 38: Telegrammtyp I1: Initialübertragung Erledigt

    Mal eine Position sendet oder wenn eine Position ungültig wird. Feld Parameter Datentyp Beschreibung Telegramm-ID String Dieser Parameter gibt die ID des Telegramms an. Beispiel: P1 Zeitstempel DateTime Dieser Parameter gibt den Zeitpunkt an, zu dem das Tele‐ gramm versendet wurde. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 39 Digitale Ausgän‐ Integer Dieser Parameter gibt den Zustand der digitalen Ausgänge 1 bis 8 an. Bitfeld Spannung Double Dieser Parameter gibt die Spannung in Volt an. Akkustand Integer Dieser Parameter gibt den Akkustand in Prozent an. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 40: Telegrammtyp H1: Lebenszeichen

    Dieser Parameter gibt die ID des Telegramms an. Beispiel: N1 Zeitstempel DateTime Dieser Parameter gibt den Zeitpunkt an, zu dem das Telegramm versendet wurde. NodeIdent HexBinary, Dieser Parameter gibt den Identifikator für den Trans‐ String oder In‐ ponder an. teger SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 41 Text5 String Dieser Parameter ist der Beschreibungstext 5 für Trans‐ ponder. Bei Infrastrukturgeräten ist dieses Feld leer. Beispiele: Telegramm vom Locating Manager-Server (Gerätedaten eines Gateways): N1;2020-04-01T10:45:50.783Z;17:c5:00:00:19:ae;17:c5:00:00:19:ae;6574 G01.27;10.1.2.3:1010;A01085;Gateway;3.03;2.50;3.00;GateGroup3;0;;;;; Telegramm vom Locating Manager-Server (Gerätedaten eines Transponders) SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 42: Telegrammtyp Op1: Positionsnachricht

    Dieser Parameter gibt die ID des Telegramms an.  Der Wert ist immer "CMD_Ack1". Zeitstempel DateTime Dieser Parameter gibt den Zeitpunkt an, zu dem das Tele‐ gramm versendet wurde. Referenz-Tele‐ String Dieser Parameter gibt an, welcher Befehl bestätigt wird. gramm-ID SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 43: Telegramm Error1: Fehlernachricht

    String oder In‐ teger Referrer String Dieser Parameter gibt die Referenz des Befehls an. Zusatzdaten (Variabel) Je nach Fehler-ID wird dieser Parameter unterschiedlich ver‐ wendet, um zusätzliche Informationen zum Fehler zu übertra‐ gen, siehe nachfolgende Tabelle "Fehlercodes". SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 44 Systemprotokoll des Locating Manager protokol‐ liert. Beispiel: Der Befehl "SetOutputs1" zum Setzen des Ausgangs 1 auf den Wert 0 des Gerätes "17:85:00:00:ff:98" mit dem "Referrer"-Wert "MyRef42" wird gesendet. Das Gerät ist nicht erreichbar. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 45: Telegramm Setoutputs1: Ausgänge Schalten

    Fehler 22 "Gerät nicht erreichbar" verweigert bzw. abgebrochen. Beispiel: Der Befehl "SetOutputs1" zum Setzen des Ausgangs 1 auf den Wert 0 des Gerätes "17:85:00:00:ff:98" mit dem "Referrer"-Wert "MyRef42" wird gesendet. Das Gerät ist nicht erreichbar. SetOutputs1;2021-05-17T10:54:58.776Z;17:85:00:00:ff:98;MyRef42;1;0 Error1;2021-05-17T10:54:58.776Z;22;SetOutputs1;17:85:00:00:ff:98;MyR ef42; SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 46: Telegramm Led_Blink1: Starten Eines Blinkmusters

    In der Ausführung auf den Geräten wird die Periodendauer kaufmännisch auf ein Vielfaches von 50 Millisekunden gerun‐ det. Wert Resultat 24 ms 0 ms 25 ms 50 ms 50 ms 50 ms 75 ms 100 ms Wertebereich: 0 ... 12750 Millisekunden SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 47 Der Befehl "LED_Blink1" zur Aktivierung des Blinkmusters wird gesendet. Parameter: • Dauer: 10 Sekunden • Periodendauer: 200 Millisekunden • Impulsdauer: 100 Millisekunden • Erzwingen: nein • Gerät: 17:85:00:00:ff:98 • Referrer: MyRef42 Das Gerät ist nicht erreichbar. LED_Blink1;2021-05-17T10:54:58.776Z;17:85:00:00:ff:98;MyRef42;10;200 ;100;0 SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 48 Wenn das Gerät z. B. über einen Heartbeat-Timeout nicht mehr erreichbar ist, wird der Befehl mit dem Fehler 22 "Gerät nicht erreichbar" verweigert bzw. abgebrochen. Beispiel: Der Befehl "LED_Off1" zur Deaktivierung der LED des Gerätes "17:85:00:00:ff:98" mit dem "Referrer"-Wert "MyRef42" wird gesendet. Das Gerät ist nicht erreichbar. LED_Off1;2021-05-17T10:54:58.776Z;17:85:00:00:ff:98;MyRef42 Error1;2021-05-17T10:54:58.776Z;22;LED_Off1;17:85:00:00:ff:98;MyRef4 SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 49: Telegramm Led_Info1: Status Der Led

    Wenn der Locating Manager neu gestartet wurde, während ein Blinkmuster auf einem Gerät aktiv ist und es konfiguriert wurde, dass das Telegramm während dem Verbindungsaufbau gesendet wird, wird in diesem Telegramm der Parameter "Blinkmuster aktiv" mit dem Wert 1 SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 50: Telegramm Btnstates1: Status Der Taster

    übertragen) L: lang gedrückt D: doppelt gedrückt Beispiel: Die Zustandsänderung der Funktionstaster des Transponders "17:85:00:00:ff:98", bei dem der Funktionstaster 1 lang gedrückt (L) und der Funktionstaster 2 kurz gedrückt (S) wird, wird übertragen: BtnStates1;2021-05-17T10:54:58.776Z;17:85:00:00:ff:98;L;S SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 51 Dieser Parameter gibt den Zeitpunkt an, zu dem das Tele‐ gramm versendet wurde. Intervall Integer Dieser Parameter gibt an, nach wievielen Sekunden ein Le‐ benszeichen über "KeepAliveMsgTime" gesendet werden soll. Beispiel: Das Intervall ist auf 5 Sekunden konfiguriert: KeepAlive1;2021-05-17T10:54:58.776Z;5 SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 52: Telegramm Setamastate1: Umschalten Des Ama-Zustands

    Fehler 25 "Beschäftigt" verweigert bzw. abgebrochen. Beispiel: Der Befehl "SetAMAState1" zum Setzen des AMA-Zustands auf den Wert 132 (AMA 4) des Geräts "17:85:00:00:ff:98" mit dem "Referrer"-Wert "MyRef42" wird gesendet. Das Gerät ist nicht erreichbar: SetAMAState1;2021-05-17T10:54:58.776Z;17:85:00:00:ff:98;MyRef42;132 Error1;2021-05-17T10:54:58.776Z;22;SetAMAState1;17:85:00:00:ff:98;My Ref42; SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 53: Koordinaten Für Das Exportmodul "Exportavt

    Transpondern über den Locating Manager-Server. Die Transponder sind über WAMP (Web Application Messaging Protocol) erreichbar, unabhängig vom Betriebssystem oder der Codesprache des externen Clients. Es ist möglich, mehrere Gegenseiten gleichzeitig über das Exportmodul zu verbinden. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 54: Zusätzliche Funktionen Der Transponder

    Der Abbau einer Verbindung kann zu jedem Zeitpunkt über die WAMP-Client- Anwendung geschehen. Der Port für den WAMP-Router ist standardmäßig nicht außerhalb des PCs erreichbar. Im Client "Netzwerkkonfiguration" steht Ihnen ein Parameter zur Verfügung, mit dem Sie den WAMP-Router-Port öffnen und schließen können. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 55: Eigenschaften Der Codierung

    • Die zu übergebenden Daten für den Datentransport werden im Format "JSON" (JavaScript Object Notation) übertragen • Der anzuzeigende Text wird im Format "UTF-8" (8-Bit UCS Transformation Format) übertragen • Zeilenumbrüche in Textfeldern werden über das Element "\r" verwaltet SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 56: Verhalten Der Programmierschnittstelle

    Die positive Quittierung eines RPC-Aufrufes garantiert bzw. signalisiert nicht die erfolgreiche Übertragung und Anzeige neuer Displayinhalte auf die Transponder. Dies kann vorkommen, wenn die Transponder z. B. währenddessen ausgeschaltet wurden oder sich nicht in der SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 57: Rpc-Aufrufe

    Der Parameter "TransponderID" ist ungültig. 0x0012 Der Parameter "ThemeID" ist ungültig. 0x0013 Der Parameter "FieldID" ist ungültig. 0x0101 Die Textlänge ist ungültig. 0x0102 Der Text beinhaltet unzulässige Zeichen oder die Zeichen werden nicht unterstützt. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 58 ThemeID, Typ: UInt32   Array mit folgenden Parametern: FieldID, Typ: UInt32 Text, Typ: String Rückgabewert Besteht aus: Result, Typ: UInt32   Array mit folgenden Parametern: RPCResult, Typ: UInt32 1 ... n FieldResults, Typ: UInt32 SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 59: Event-Meldungen

    Text ist der Inhalt dieses Formularfeldes. Wenn der Text leer ist, trat ein Problem mit dem Setzen des Textes auf. "agilion.wls.epaper.display_text_changed" Parameter Besteht aus: TransponderID, Typ: UInt64 FieldID, Typ: UInt32 Text, Typ: String SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 60: Code-Beispiele

    Event-Parameter: ButtonDown = 0 Der Standardwert ist 1 in der Konfigurationsdatei "RTLS_LM_DataExport.ini". 5.7.5 Code-Beispiele Code-Beispiel WAMP-Verbindung "wamp": { "url": "ws://127.0.0.1:12344/", "realm": "agilion.wls", "user": "Administrator", "key": Kontaktieren Sie den Siemens-Support, um das aktuelle Passwort zu erhalten. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 61 * 0x0102 Text contains invalid characters or characters not supported console.log("load configuration") try { var config = require('./config.json') } catch (e) { console.error(e) process.exit(1); console.log("load autobahn") try { var autobahn = require('autobahn') } catch (e) { SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 62 (let etag of config.tagwhitelist){ var isin = false for (let epaper of res["args"][1]){ if ( config.debug ) console.log("check epaperadr", epaper[0]); if (epaper[0] == etag.addr){ isin = true break if (isin == false){ SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 63 [12345, 1, [ [0, "text1"], [1, "text2"] ] ] -> Theme 1 with texts 1: text1 and 2: text2 //get_display_theme RPC: agilion.wls.epaper.get_display_theme [TransponderID] agilion.wls.epaper.set_display_theme [12345] -> In return value: [result_code, ThemeID, [ [FieldID, "text1"], [FieldID, "text2"] ] ] SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 64: Weiterführende Information

    Wenn der Parameter nicht konfiguriert ist, wird der Wert "20" angenommen. Weitere Informationen zum Nachrichtencode "40002 Batteriestatus" finden Sie in der Dokumentation der Funktionalität "Meldungsmanagement". Schwelle 1 und Schwelle 2 besitzen typische Standardwerte. Die Werte können Sie im Client "Lokalisierungskonfiguration" gerätespezifisch oder gruppenweise konfigurieren. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

  • Seite 65: Fehlersuche

    Zustand aufgelistet. Wenn ein Exportmodul rot aufgelistet ist, lesen Sie im Client "Protokollbetrachter" im Abschnitt "Auslesen" die Meldungen aus. • Verbindungsprobleme beheben Wenn die Verbindung weiterhin nicht aufgebaut werden kann, prüfen Sie die Konfigurationen für Port, Host und die Konfiguration der Firewall. SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...
  • Seite 66 Fehlersuche SIMATIC RTLS Datenexportdienst Applikationshandbuch, 03/2024, C79000-G8900-C531-08...

Inhaltsverzeichnis