Neu: Die KI-Firewall überwacht die gesamte Plattform und erklärt jeden Vorfall in einfachen Worten. So funktioniert es

Geräte hinter einem Gateway

Wie ein Gateway Feldgeräte als Child-Geräte über die v1/gw-Topics meldet – Payloads, Anlage von Child-Geräten, Profile, Namen und Limits.

Ein Gateway sammelt Daten von Feldgeräten, die Hermetry nicht selbst erreichen können (Modbus-Zähler, RS485-Controller, BLE-Sensoren und andere), und sendet sie über seine eigene Verbindung. Hermetry macht aus jedem Feldgerät ein Child-Gerät: ein eigenständiges Gerät mit Messwerten, Attributen, Alarmen und Dashboards. Diese Seite ist die vollständige Referenz für die Gateway-Seite. Eine kurze Zusammenfassung finden Sie unter Gateways und Geräte hinter einem Gateway.

Ein lizenziertes Gateway mit Hermetry Edge übernimmt all das für Sie; siehe Lizenzierte Gateways und Hermetry Edge. Lesen Sie weiter, wenn Sie selbst Gateway-Software schreiben oder wissen möchten, was mit den Daten geschieht.

In der Hermetry-Cloud werden Feldgeräte über Hermetry Edge gelesen; eigene Gateway-Software ist für On-Premises-Installationen gedacht.

Gateway-Gerät einrichten

  1. Erstellen Sie ein Geräteprofil für das Gateway oder wählen Sie ein vorhandenes aus. Es muss das Standard-Topic-Schema v1/ verwenden. Das Schema Legacy compatible enthält keine Gateway-API.
  2. Fügen Sie unter Devices > New device das Gateway hinzu und aktivieren Sie This device is a gateway. Ein Gerät ohne diese Option wird auf jedem v1/gw/*-Topic abgelehnt (forbidden_topic).
  3. Hinterlegen Sie die Zugangsdaten des Gateways (Access Token, MQTT-Basic-Zugangsdaten oder X.509-Zertifikat) wie bei jedem anderen MQTT-Gerät. Siehe Gerätezugangsdaten.
  4. Optional: Legen Sie im Profil des Gateways Profile of new children und Max children of a gateway fest (siehe unten).

Das Gateway meldet sich als es selbst an. Child-Geräte erhalten nie eigene Zugangsdaten und melden sich nie an.

Topics und Payloads

Alle Gateway-Topics verwenden QoS 1.

Topic (Gateway zu Hermetry)PayloadBedeutung
v1/gw/connect{"device": "Meter A", "type": "lorawan-meter"}Das Child-Gerät ist vorhanden. type ist optional und wählt das Profil des Child-Geräts.
v1/gw/disconnect{"device": "Meter A"}Das Child-Gerät ist nicht mehr vorhanden.
v1/gw/telemetrySiehe untenMesswerte eines oder mehrerer Child-Geräte.
v1/gw/attributes{"Meter A": {"lora.rssi": -97}}Client-Attribute eines oder mehrerer Child-Geräte.

Telemetrie ist ein Objekt, dessen Schlüssel der Name des Child-Geräts ist. Jedes Child-Gerät enthält einen Datensatz oder eine Liste von Datensätzen:

{
  "Meter A": [
    {"ts": 1759572000000, "values": {"kwh": 1203.4, "voltage": 229.8}},
    {"ts": 1759572060000, "values": {"kwh": 1203.6, "voltage": 230.1}}
  ],
  "Meter B": {"values": {"flow_m3h": 12.7}}
}
  • ts ist der Zeitpunkt in Millisekunden, zu dem der Wert ermittelt wurde. Lassen Sie es weg, wenn die Uhr des Gateways nicht gestellt ist; Hermetry verwendet dann die Ankunftszeit. Siehe Zeitstempel, verspätete und doppelte Messwerte.
  • values folgt denselben Schlüssel- und Wertregeln wie die Telemetrie jedes Geräts. Siehe Telemetrie-Schlüssel.
  • Ein Datensatz kann ein optionales meta-Objekt mit Angaben zum Messwert enthalten, zum Beispiel "meta": {"lora": {"rssi": -97, "snr": 7.5}}. meta darf höchstens 256 Byte groß sein. Es wird nie als Messwert gespeichert. Nur die Member lora und snmp (jeweils höchstens 8 einfache Werte) werden als Nachrichten-Metadaten an Ihre Flows weitergegeben; alles andere darin wird ignoriert.
  • Ein Datensatz ohne values oder mit einem ts, das keine positive Zahl ist, wird übersprungen. Der Rest der Nachricht bleibt erhalten.

Ein optionales Client-Attribut time_quality am Child-Gerät, {"source": true, "arrival": false, "synced": true}, gibt an, ob Zeitstempel von der eigenen Uhr des Child-Geräts stammen, von der Ankunftszeit am Gateway, und ob die Uhr des Gateways synchronisiert war. Die Angabe dient nur zur Information.

So werden Child-Geräte angelegt

Hermetry legt ein Child-Gerät beim ersten Melden durch das Gateway an, per connect, Telemetrie oder Attribute. Ein Child-Gerät, das in der Telemetrie ohne connect auftaucht, gilt als verbunden.

  • Das Child-Gerät gehört zur Organisation des Gateways. Es wird nie separat beansprucht.
  • Profile, in dieser Reihenfolge: ein Profil in Ihrer Organisation mit genau dem Namen des in connect gesendeten type; sonst das Profile of new children des Gateway-Profils; sonst das eingebaute Generic child profile, das Hermetry beim ersten Bedarf anlegt. Ein Child-Gerät, das ohne type angekündigt wird, überspringt den ersten Schritt.
  • Gerätename: der Name des Child-Geräts auf der Leitung. Existiert in Ihrer Organisation bereits ein Gerät mit diesem Namen, lautet der Name <Leitungsname> · <Gateway-Name>, danach dieser Name mit 2, 3 usw.
  • Das Umbenennen des Child-Geräts in Hermetry ändert seinen Leitungsnamen nicht. Das Gateway spricht es weiterhin unter dem Namen an, den es gesendet hat.
  • Die ersten Datensätze eines brandneuen untergeordneten Geräts können verworfen werden, während es angelegt wird. Hermetry fordert das Gerät einmal an, und die nächste Nachricht findet es.

Child-Namen

RegelWert
Länge1 bis 128 Zeichen
Nicht erlaubtSteuerzeichen, führendes oder nachfolgendes Leerzeichen
Groß-/KleinschreibungGroß-/Kleinschreibung wird beachtet: abc und ABC sind zwei Child-Geräte eines Gateways
EindeutigkeitPro Gateway

Ein Name, der eine Regel verletzt, wird übersprungen und gezählt; die übrigen Child-Geräte der Nachricht bleiben erhalten.

Ein direkt verbundenes Gerät hat Vorrang. Stimmt der Child-Name mit der Seriennummer eines Geräts in Ihrer Organisation überein, das eigene Zugangsdaten hat (ohne Berücksichtigung der Groß-/Kleinschreibung), wird das Child-Gerät abgelehnt (child_conflict_direct) und nicht angelegt. So erscheint ein Gerät, das seine eigene Cloud-Sitzung betreibt, nicht doppelt.

Grenzwerte

GrenzwertWert
Child-Geräte pro GatewayDer Wert Max children of a gateway des Profils (Standard 500), nie über dem Wert Ihres Tarifs (500, wenn der Tarif keinen nennt) oder der Plattformobergrenze von 1.000
GerätelimitJedes Child-Gerät zählt zum Gerätelimit Ihres Tarifs
Eine Gateway-NachrichtHöchstens 64 KiB, oder der Wert Max message payload (bytes) des Gateway-Profils, wenn dieser niedriger ist
Child-Geräte in einer Nachricht500; weitere werden übersprungen
Datensätze pro Child-Gerät in einer Nachricht1.000; weitere werden übersprungen
meta pro Datensatz256 Byte

Ein untergeordnetes Gerät, das das Kindlimit oder das Gerätelimit überschreiten würde, wird abgelehnt (child_limit oder device_limit), und seine Datensätze werden verworfen.

Rate limits gelten zweimal. Zuerst zählen die eigenen Profillimits des Gateways die gesamte Nachricht, einschließlich aller Datenpunkte jedes untergeordneten Geräts. Dann gelten die eigenen Profillimits jedes untergeordneten Geräts für seinen Anteil: Ein untergeordnetes Gerät, das seine Limits überschreitet, verliert nur seine eigenen Datensätze (child_rate_limited). Siehe Device profiles für die Limitfelder und Message quota and usage.

Verbindungsstatus

  • connect und disconnect setzen den Verbindungsstatus des Child-Geräts.
  • Geht das Gateway offline, gehen alle seine Child-Geräte mit ihm offline.
  • Ein deaktiviertes Child-Gerät wird innerhalb von etwa einer Minute verworfen: Seine Datensätze werden nicht mehr angenommen.

Fehlerbehebung

SymptomUrsache und Abhilfe
Das Gateway wird nach einigen v1/gw/*-Nachrichten getrenntDas Gerät ist nicht als Gateway markiert. Drei abgelehnte Topics innerhalb einer Minute beenden die Sitzung. Aktivieren Sie This device is a gateway.
Kein Child-Gerät erscheintDer Child-Name verletzt eine Regel, das Child- oder Gerätelimit ist erreicht, oder ein direktes Gerät verwendet diese Seriennummer. Prüfen Sie Ihre Gerätezahl unter der Nutzung.
Ein Child-Gerät hat das falsche ProfilDer type stimmt mit keinem Profilnamen genau überein. Benennen Sie das Profil um oder legen Sie im Gateway-Profil Profile of new children fest. Das Profil eines bestehenden Child-Geräts ändern Sie auf dessen Geräteseite.
Ein Child-Gerät zeigt zwei NamenEin Gerät mit dem Leitungsnamen existierte bereits, daher wurde das Child-Gerät als <Leitungsname> · <Gateway-Name> benannt.

Verwandte Themen