CMe3100 Stream Plugin
Im Bereich des Meterings gibt es zahlreiche Anwendungen sowohl für Wired M-Bus als auch für Wireless M-Bus. Das Stream-Plugin wurde speziell entwickelt, um eine effiziente Lösung für die Messung in großen kabellosen M-Bus-Systemen zu bieten, bei denen es der Empfangsstelle nicht auf die Herkunft des Zählers ankommt, sondern auf die Schaffung einer ausreichenden Gesamtabdeckung eines Bereichs.
Das Stream-Plugin ist eines der für CMe3100 erhältlichen Add-ons und ist ab Werk vorinstalliert. Das Stream-Plugin erweitert die CMe3100-Kerndienste um die Unterstützung von Stream über TCP/IP und bietet eine leistungsstarke und vielseitige Suite von Tools für die Integration von Head-End-Systemen (HES) sowie die Möglichkeit, jeden WM-Bus-Zähler auszulesen und zu überwachen.
In einem Zählersystem, das den Stream-Modus verwendet, werden mehrere Stream-Modus-Produkte (Empfänger) an geeigneten Orten platziert, um die Abdeckung des gewünschten geografischen Gebiets zu gewährleisten. Mit allen Empfängern kann jeder Zähler in Reichweite erfasst werden. Die wichtigsten Vorteile dieses Ansatzes sind:
-
Geringerer Aufwand für die Projektplanung im Vorfeld. Es ist keine Funkplanung erforderlich, um festzulegen, welche Zähler von welchem Empfänger erfasst werden sollen.
-
Geringerer Wartungsaufwand. Bei Hinzufügung, Entfernung oder Austausch von Zählern ist keine Neukonfiguration der Empfangsgeräte erforderlich.
-
Erhöhte Robustheit. Ein System kann redundant ausgelegt werden, sodass jeder Zähler von mehreren Empfängern empfangen wird. Dies macht das System robust gegenüber sich im Laufe der Zeit ändernden Funkbedingungen, da z. B. neue Gebäude oder andere Veränderungen in der Umgebung die Funkleistung für bestimmte Zähler beeinträchtigen können.
Um Upstream-Daten von empfangenen Zählern, die nicht von Interesse sind (z. B. nicht zum System gehören), zu begrenzen, verwendet das Stream-Plugin Filtereinstellungen.
Um das zuletzt gesendete Telegramm von einem Wireless M-Bus Zähler auslesen zu können, leitet CMeX50 das Telegramm über die USB-Schnittstelle an CMe3100 weiter. CMe3100 übernimmt die gesamte Logik, die Filterung und den Push der Zählerdaten an das HES in einem zeitlich festgelegten Intervall. Nach jedem Push von Zählerdaten wird der Speicher bereinigt, sodass CMe3100 nur die letzten Werte sendet, die zwischen den einzelnen Push-Berichtsintervallen gesammelt wurden. Wenn ein Zähler häufiger sendet als das vorgesehene Push-Intervall, wird CMe3100 nur das zuletzt empfangene Zählertelegramm pushen.
Stream-Plugin – Überblick über die Lösung
Bei der Planung von Abdeckung und Redundanz ist es sehr ratsam, sicherzustellen, dass jeder Zähler einen Redundanzfaktor von mindestens 2 hat. Das bedeutet, dass jeder Zähler in der effektiven Reichweite von mindestens zwei Empfängern liegt. Die effektive Reichweite sollte so interpretiert werden, dass die Anforderungen an eine >X %-Erfassung der Zählerwerte für die gewählte Auflösung erfüllt werden. Ein solcher Systementwurf macht es robust gegenüber Änderungen der Funkbedingungen und verringert die Anforderung an den Empfang einzelner Zähler.
Es ist wichtig zu verstehen, dass die effektive Reichweite des Empfangsbereichs auch eine Funktion der Auflösung ist. In der Praxis bedeutet dies, dass bei einer Anforderung von >98 % Empfang von Zählerwerten alle 15 Minuten die effektive Reichweite geringer ist als bei einer Anforderung von >98 % Empfang von Zählerwerten alle 24 Stunden. Dies ist keine Eigenschaft der Lösung, sondern ergibt sich aus der Funktionsweise des Wireless M-Bus-Funks. D. h. die Wahrscheinlichkeit, einen weit entfernten Zähler richtig zu empfangen, nimmt mit der Zeit zu, sodass eine geringere erforderliche Auflösung die effektive Reichweite erhöht.
Die Installation des Plugins erfolgt durch Hochladen einer Lizenzdatei und Aktivierung der Lizenz.
-
Melden Sie sich auf der Webschnittstelle an.
-
Gehen Sie zu System>Lizenzen.
-
Wählen Sie Datei wählen im Abschnitt Neue Lizenzen hochladen.
-
Suchen Sie die Lizenzdatei, die Sie hochladen möchten.
-
Wählen Sie Hochladen.
-
Wählen Sie Speichern.
Die Lizenz ist nun im Fenster Aktuelle Lizenz(en) sichtbar.
-
Wählen Sie System> Gerät neu starten, um die Installation des Plugins abzuschließen.
Anmerkung
Wichtig! Starten Sie CMe3100 neu, um das BACnet-Plugin zu verwenden.
Tabelle 150.
|
Parameter |
Beschreibung |
Beispiel |
|
|---|---|---|---|
|
filter.device.type |
Filter nach Gerätetyp (HEX) aus M-Bus Standard. |
1B (Raumsensor) |
|
|
filter.manufacturer |
Filter nach Hersteller-DLMS-Beschreibung (vom Hersteller registriertes Akronym) |
ELV (Elvaco) |
|
|
radio.mode |
Filtern Sie nach den Funkmodi, die der Zähler verwendet. |
T1_C1A_C1B |
S1 T1 T1_C1A T1_C1B T1_C1A_C1B C1A C1B C1A_C1B C1A_WIDE C1B_WIDE C1A_C1B_WIDE |
|
usb.baud.rate |
Baudrate zwischen Funkempfänger und CMe3100 USB-Schnittstelle |
115200 |
3600 4800 7200 9600 14400 19200 28800 38400 57600 76800 115200 |
|
receiving.server.url |
URI, an die Daten gesendet werden sollen |
http://evo.elvaco.se |
|
|
receiving.server.push.cron |
Zeitintervall zwischen den einzelnen Push-Berichten |
*/15 * * * * (Push-Bericht für jede 15 min) |
*/15 * * * * |
|
service.enabled |
Plugin aktivieren oder deaktivieren |
true |
wahr/falsch |
|
sync.enabled |
Automatische Konfugration aktivieren |
true |
wahr/falsch |
|
show.only.filtered |
Nur gefilterte Zähler in UI anzeigen |
true |
wahr/falsch |
|
configuration.server.cron |
Zeitintervall zwischen den einzelnen Autokonfigurationsversuchen |
30 0 * * * (Synchronisierung jede Nacht 00:30) |
|
|
configuration.server.url |
URI, von der die Konfiguration abgerufen wird |
http://middleware.elvaco.se |
Sync-Mode: server Sync-Id: sm_elv Sync-Config-0: receiving.server.url=http://evo.elvaco.se/sp/| /currentpluginconfig/stream.cfg Sync-Config-1: receiving.server.push.cron=*/5 * * * *| /currentpluginconfig/stream.cfg Sync-Config-2: configuration.server.cron=15 0 * * *| /currentpluginconfig/stream.cfg Sync-Config-3: filter.manufacturer=ELV,ABB|/currentpluginconfig/stream.cfg Sync-Config-4: filter.device.type=1B,02|/currentpluginconfig/stream.cfg
Die standardmäßig ausgewählte Registerkarte in den Einstellungen für das Stream-Plugin ist die Seite Übersicht, die allgemeine Informationen über das Stream-Plugin anzeigt.
Verfügbare Seiten sind:
-
Einstellungen
Allgemeine Stream-Konfiguration für das Plugin.
-
Serveradresse empfangen
Adresse des Servers, der die Push-Berichte vom Stream-Plugin erhält.
-
Push-Zeitplan
Zeitplan für den Push-Bericht an den Empfänger-Server.
-
Filtern nach Hersteller
Filtern nach Hersteller-DLMS-Kurzname, z. B. ELV.
-
Filtern nach Geräteart
Filtern nach Geräteart. Dieser Filter verwendet die M-Bus-Standard-Medienbeschreibung (13757-3 2004), z. B. ist 07 Wasser.
-
Freigabeliste
Filtern Sie nach Geräteidentitäten, listen Sie die Geräteidentitäten auf, die akzeptiert werden sollen. Die nicht aufgelisteten Geräteidentitäten werden nicht akzeptiert.
-
-
Analysator
Analyse der eingehenden Daten von CMeX50 mit der Stream-Modus-Software.
Das Analysetool zeigt an, welche Geräte auf der Grundlage von eingestellten Filtern empfangen wurden, was die Analyse der geografischen Platzierung von Empfängern verbessern kann, je nachdem, von welchem Gerät Sie Daten empfangen möchten. Angezeigt werden Zähler-ID, Anzahl der empfangenen Telegramme, Signalstärke, Hersteller und Zählertyp.
Es gibt eine Option, mit der im Analysewerkzeug nur Geräte angezeigt werden, die auf der Freigabeliste stehen. Wenn diese Option ausgewählt ist, aber auf der Registerkarte Einstellungen keine Geräte auf der Whitelist stehen, wird dieser Filter nicht angewendet, und alle empfangenen Geräte werden aufgelistet. Es gibt auch Optionen für den Export der Analysestatistiken in das CSV-Format und das Zurücksetzen der Analysestatistiken.
Das Analysegerät wird alle 24 Stunden zurückgesetzt oder wenn der Benutzer die Funktion manuell in der Benutzeroberfläche zurücksetzt.
-
Hilfe
Beschreibungen des Stream-Plugins, die auf dieses Dokument verweisen.
-
Endnutzerlizenzvereinbarung (EULA)
Die Produktfunktion zur Verwaltung von Konfigurationen und Backups umfasst auch Einstellungen für das Stream Plugin (siehe Abschnitt Konfigurationen verwalten auf der Benutzeroberfläche des Produkts).
Die Konfiguration enthält alle Eigenschaften, die im Produkt bearbeitet werden können. Diese können verwendet werden, um die Konfiguration für mehrere Geräte zu duplizieren, da sie keine gerätespezifischen Einstellungen enthalten.
-
Gehen Sie zu Konfiguration > Konfigurationen verwalten.
-
Wählen Sie Konfiguration als Dateityp.
-
Wählen Sie Ausführen.
Der Abschnitt Dateiablage enthält nun die neu erstellte Konfigurationsdatei. Dies kann dann dazu verwendet werden, ein Gerät zu aktualisieren und/oder fehlerhafte Konfigurationen rückgängig zu machen.
Das Backup enthält sowohl die Konfiguration als auch eine Kopie der Produktdatenbanken und der Betriebssystemeinstellungen.
Dieses Backup enthält gerätespezifische Einstellungen und ist daher nicht geeignet, um die Konfiguration auf ein anderes Gerät zu übertragen. Es sollte ausschließlich verwendet werden, um die Einstellungen eines Geräts nach einem physischen Austausch wiederherzustellen.
-
Erstellen Sie ein Backup der Konfiguration des Geräts, das ersetzt werden soll.
-
Importieren Sie die gesicherte Konfiguration auf das Ersatzgerät.
Anmerkung
Der Systemtitel des Ersatzgeräts wird neu sein, da er von der Seriennummer des Geräts abgeleitet ist. Der HES muss möglicherweise entsprechend aktualisiert werden.
In diesem Abschnitt wird beschrieben, wie Sie eine Verbindung zu einem Produktkonfigurationsserver herstellen (HTTP-Protokoll). Die Synchronisierung beginnt damit, dass das CMe-Produkt eine Synchronisierungsdatei anfordert. Die Synchronisierungsdatei enthält Parameter zum Synchronisieren von Dateien und Konfigurationsschlüssel, die im Produkt eingestellt werden müssen. Wenn die Synchronisierung der Dateien und der Konfiguration abgeschlossen (oder unvollständig) ist, sendet das Produkt ein Ergebnis an einen angegebenen Ergebnisserver. Der Ergebnisserver kann in der cad-Datei angegeben werden.
Wenn ein Webdienst verwendet wird, der die cad-Datei erzeugt, oder wenn ein Ergebnisserver verwendet wird, muss der Server mit HTTP Response Code = 200 und OK im http-Body antworten (der Body darf nicht leer sein).
Um das Produkt zu identifizieren, wird der HTTP-Header User-Agent mit den folgenden Informationen gefüllt:
User-Agenet=TC65i/<imei> Profile/IMP-NG Configuration/CLDC-1.1 Model/<model> Hardware/<hw> Firmware/<fw> Application/<sw> Serial/<serial>
|
Parameter |
Beschreibung |
|---|---|
|
<imei> |
15-stellige IMEI-Nummer des Produktmoduls |
|
<model> |
Produktmodell, d. h. CMe1000, CMe1100, CMe2000, CMe2100 |
|
<hw> |
Hardware-Version des Produkts, z. B. R4A |
|
<fw> |
Version der Produktmodul-Firmware, z. B. 01.100 |
|
<sw> |
Version der Produktsoftware, z. B.. 1.1.0 |
|
<serial> |
10-stellige Produkt-Seriennummer, z. B. 0006000000 |
Die cad-Datei enthält die tatsächlich zu synchronisierenden Informationen. Siehe die folgende Tabelle für Synchronisationsparameter. Alle cad-Dateien müssen die Endung .cad haben.
|
Parameter |
Beschreibung |
|---|---|
|
Sync-Mode |
Synchronisationsmodus, muss auf Server gesetzt werden Syntax: Sync-Mode: server |
|
Sync-Notify-URL |
URL des Ergebnisservers. Die Benachrichtigungen werden an diese Serveradresse gesendet. Kann weggelassen werden. Syntax: Sync-Notify-URL: <notify url> |
|
Sync-File-[0..n]-URL |
Zu synchronisierende Dateien. Der Index muss bei 0 beginnen und fortlaufend sein. Kann weggelassen werden. Syntax: Sync-File-[0..n]-URL: <remoteur>,<local file> |
|
Sync-Config-[0..n] |
Zu synchronisierende Konfigurationsschlüssel und -werte. Der Index muss bei 0 beginnen und fortlaufend sein. Kann weggelassen werden. Syntax: Sync- Config-[0..n]:<key>=<value> |
|
Sync-Id |
Identifikation, die in die Ergebnisbenachrichtigung eingefügt wird. Kann weggelassen werden. Syntax: Sync-Id: <id> |
|
<notify url> |
URL für die Veröffentlichung von Benachrichtigungen |
|
<remote file> |
URL, unter der die Remote-Datei abgerufen werden kann |
|
<local file> |
Lokaler Pfad und Dateiname, wo die heruntergeladene Datei abgelegt werden soll |
|
<key> |
Einzustellender Konfigurationsschlüssel |
|
<value> |
Wert des Konfigurationsschlüssels |
|
<id> |
Benutzerspezifische Identifikation für diese Synchronisation |
Wenn der Parameter Sync-Notify-Url in der cad-Datei gesetzt ist, wird das Produkt die Ergebnisinformationen an die angegebene URL senden. Der Post ist ein Standard-HTTP-Post mit einem Body, der die Ergebnisinformationen enthält. Mögliche Ergebnisse sind in der folgenden Tabelle aufgeführt.
|
Ergebnis |
Beschreibung |
|---|---|
|
900 |
Erfolg – die Synchronisierung wurde erfolgreich abgeschlossen. |
|
920 |
Inkompatibler Synchronisationsmodus Der Sync-Mode wurde nicht auf Server gesetzt. |
|
921 |
Fehler beim Synchronisieren von Dateien. <error> Allgemeiner Synchronisationsfehler. |
Während Stream-Modus-Einheiten einen effektiven Erfassungsdienst bereitstellen, muss das empfangende System Folgendes berücksichtigen:
-
Umgang mit Redundanz
Da mehrere Zähler von mehreren Empfängern empfangen werden können, muss das HES mit Duplikaten und der Tatsache umgehen, dass Zählerwerte desselben Zählers von mehreren Empfängern empfangen werden können.
-
Dekodierung, Schlüsselverwaltung und Entschlüsselung (wenn verschlüsselte Zähler verwendet werden)
Die Zählerdaten aus dem Stream-Modus werden als Rohdaten über den M-Bus gesendet. Das bedeutet, dass von Zählern übermittelte verschlüsselte Daten mit der entsprechenden Schlüsselverwaltung entschlüsselt werden müssen, bevor die M-Bus-Zählerdaten entschlüsselt werden können.
HTTP (Hypertext Transfer Protocol) ist in der ganzen Welt weit verbreitet. Dieses Protokoll kann verwendet werden, wenn die Integrationsplattform über einen externen Webserver verfügt. Das Produkt verwendet HTTP POST, um Daten an den Server zu senden.
Das Produkt entspricht dem Standard für einen HTTP-Server. Es ist wichtig, dass die Authentifizierungseinstellungen auf dem Produkt und dem Empfangsserver übereinstimmen.
Das Produkt muss so konfiguriert werden, dass festgelegt wird, wohin die HTTP-Berichte gesendet werden sollen. Dies kann mit dem Befehl qset http eingestellt werden, siehe Benutzerhandbuch der CMe-Serie Benutzername, Passwort, Port und URL können auch mit dem Befehl qset http festgelegt werden. Zur Sicherung der Verbindung kann HTTPS verwendet werden, indem in der URL des Webservers https statt http eingegeben wird.
Die vom Produkt an den Webserver gesendeten Berichte werden im laufenden Betrieb erstellt, sodass die Länge des Inhalts beim Senden der HTTP-Header nicht bekannt ist. Daher muss der empfangende Webserver die Chunked-Transfer-Codierung verarbeiten können (dies stellt in der Regel kein Problem dar, wenn Microsoft IIS oder Apache Webserver verwendet werden, da die Chunked-Transfer-Codierung dort automatisch verarbeitet wird).
Das Format des Stream-Modus-Berichts ist der M-Bus-Norm EN13757 entnommen. In der folgenden Tabelle werden die Eigenschaften des Berichtsformats beschrieben:
Tabelle 151. Eigenschaften des Stream-Modus-Berichtsformats
|
Name |
Beschreibung |
|---|---|
|
Seriennummer des Produkts |
Die Seriennummer des Produkts, das den Wert eines Zählers ausgelesen und gespeichert hat. |
|
Gerätekennung |
Die sekundäre M-Bus-Slave-Kennung, zu der ein Wert gehört. |
|
Datum |
Das Erstellungsdatum eines Wertes |
|
Wertdatenanzahl |
Das M-Bus-Telegramm, in dem ein Wert gefunden wurde. |
|
Telegramm |
Zählerwerte (M-Bus-Rohdaten) |
Tabelle 152. Beispiel für das Format des Stream-Modus-Berichts
|
(Produktseriennummer;Gerätekennung;Datum;Wertdatenanzahl;Telegramm) |
|||
|---|---|---|---|
|
|
Dieser Abschnitt beschreibt, wie Daten aus dem empfangenen Wireless M-Bus-Telegramm auf das Wired M-Bus-Telegramm abgebildet werden. Die kabelgebundene Sekundäradresse wird aus dem M-Feld und das A-Feld aus dem kabellosen M-Bus-Telegramm übernommen. Das kabelgebundene A-Feld wird bei der Installation automatisch zugewiesen. Die im kabellosen M-Bus-Telegramm empfangenen kurzen Header-Informationen werden auf der kabelgebundenen M-Bus-Schnittstelle nicht verwendet.
Die DIF/VIF-Container-Beschreibung wird durch die folgenden DIF/VIF-Daten identifiziert:
|
0x0D 0xFD 0x3B 0xnn |
Wobei 0xnn die Länge des vollständigen kabellosen M-Bus-Telegramms ist (Länge des Containers). |
Das Wireless M-Bus-Telegramm wird in einen M-Bus-Container gelegt, wenn eines oder mehrere der folgenden Kriterien erfüllt sind:
C- und CI-Feld sind dem Produkt unbekannt
Tabelle 153. Kabelloses M-Bus-Telegramm
|
|
Tabelle 154. Kabelgebundenes M-Bus-Telegramm
|
C-Feld 0x08 |
A-Feld 0xnn |
CI-Feld 0x72 |
Lange Kopfzeile ID, Man (Hersteller), Version, Device (Gerät) 0x000000000000000000000000 |
DIF/VIF RSSI 0xFD7178NN |
DIF/VIF-Behälter 0x0DFD3BNN |
Nutzlast kabelloses M-Bus-Telegramm |
Beispiel 1. Beispiel
Filename=0016002896_valuereport_20190924185507_9102.csv Content encoding: System.Text.UTF8Encoding Content type: application/octet-stream Content length: 27741 Body: 0016002896;18400910;2019-09-24 18:52:42;00;0800721009401897A60016190000A004130E000000066D2C385278290044130E000000426C5F2C047F0700060C027F852A0E79100940180000 0016002896;61000134;2019-09-24 18:51:35;00;080072340100619615011B8B0400202F2F0265EE084265DD08820165F1082265D6081265EE086265B20852656A0902FB1AC30142FB1AC3018201FB1A8D0122FB1AC30112FB1AC30162FB1A660152FB1AC30102FD1B60430DFD0F05302E302E310F
Beispiel 2. Beispiel in CSV
00000161;05047168;2009-12-17 00:00:00;00; 080072640100619615011B000000000C787217006201FD711C0DFD3B61604496156401006 1011B7A970400202F2F02653607426534078201652C072265320712653607626516075265 560702FB1A0E0242FB1A0E028201FB1A0E0222FB1A0E0212FB1A0E0262FB1A090252FB1A0 F0202FD1B20C30DFD0F05322E302E310F
Kommentare (0 Kommentare)