Hermetry nimmt Daten auf mehreren Wegen an. Jeder Weg endet am selben Ort: einem Gerät in Ihrer Liste Devices, mit seiner Telemetrie, seinen Attributen, Alarmen und Dashboards. Welcher Weg passt, hängt davon ab, was das Gerät kann: ob es eine Verbindung offen halten kann, ob es LoRaWAN spricht, ob es hinter einem anderen Gerät sitzt oder ob es nur abgefragt werden kann. Diese Seite hilft Ihnen bei der Wahl.
Kurze Entscheidung
| Ihr Gerät… | Verwenden Sie | Hier beginnen |
|---|---|---|
| kann eine TCP-Verbindung offen halten und hat TLS (eine Steuerung, ein Industrie-PC, eine Mikrocontroller-Platine mit Wi-Fi oder Mobilfunk) | MQTT over TLS | MQTT |
| wacht auf, sendet und schläft wieder, oder sitzt in einem Netzwerk, das MQTT blockiert | HTTPS-Geräte-API | Geräte-HTTP-API |
| ist ein batteriebetriebener LoRaWAN-Sensor (EU868) | LoRaWAN, über ein LoRaWAN-Gateway | Verbinden Sie Ihren ersten LoRaWAN-Sensor |
| spricht Modbus, RS485 oder einen anderen Feldbus oder BLE, hinter einem Router oder Gateway, das für es meldet | Hinter einem Gateway | Geräte hinter einem Gateway |
| kann überhaupt nicht selbst eine Verbindung aufbauen, antwortet aber auf SNMP (eine USV, ein Switch, ein Drucker, ein Server) | Von der Plattform abgefragt (Netzwerkgerät) | Geräte per SNMP abfragen |
| ist eine IP-Kamera oder ein Recorder | Kamera oder Recorder (abgefragt, Live-Ansicht) | Kamera oder Recorder hinzufügen |
| ist ein lizenzierter Router, Gateway oder Controller für Hermetry | Beanspruchen Sie es mit dem Code auf seiner Cloud-Seite | Geräte hinzufügen und beanspruchen |
Alle diese Wege beginnen unter Devices > New device. Das Panel bietet eine Auswahl pro Weg, den Ihre Organisation hat, sowie Other device für MQTT- und HTTP-Geräte.
Die Wege im Vergleich
| MQTT | HTTPS | LoRaWAN | Hinter einem Gateway | Abgefragt | Lizenziertes Gerät | |
|---|---|---|---|---|---|---|
| Gerät öffnet die Verbindung | Ja | Ja, pro Nachricht | Über sein LoRaWAN-Gateway | Das Gateway übernimmt das | Nein: die Plattform fragt ab | Ja (MQTT) |
| Anmeldung | Token, MQTT-Basic oder X.509 | Token (Bearer-Header) | Schlüssel (OTAA oder ABP) auf dem Funkweg; keine Plattform-Anmeldung | Die eigene Anmeldung des Gateways | Zugangsdaten des Geräts, nur schreibbar gespeichert | X.509-Zertifikat |
| Online-Status | Live-Verbindung, letzte Nachricht oder zuletzt gesehen | Letzte Nachricht oder zuletzt gesehen | Letzte Nachricht (integriertes Profil) | Aus den Verbinden- und Trennen-Nachrichten des Gateways | Nur zuletzt gesehen | Live-Verbindung |
| Befehle an das Gerät | Ja | Ja (Long Poll) | Rohe Downlinks | In Entwicklung | Nein | Ja, plus Fernkonfiguration und Fernzugriff |
| Firmware over the air | Ja, wenn die Firmware es unterstützt | Nein | Nein | Nein | Nein | Ja |
| Zählt zum Geräte-Limit | Jedes Gerät | Jedes Gerät | Jedes Gateway und jeder Sensor | Das Gateway und jedes Kindgerät | Jedes abgefragte Gerät | Jedes Gerät |
MQTT
Der Standard und der leistungsfähigste Weg. Das Gerät hält eine Verbindung offen, veröffentlicht Telemetrie und Attribute und empfängt Befehle sowie Änderungen gemeinsamer Attribute sofort. Verwenden Sie TLS auf Port 8883. Einfaches MQTT auf Port 1883 wird abgelehnt, es sei denn, ein Profil erlaubt es für Geräte, die kein TLS können.
Bestehende Firmware, die v1/devices/me/telemetry-Topics verwendet, kann diese mit dem Topic-Schema Legacy compatible beibehalten, und Firmware mit eigenen Topic-Namen kann Custom topics verwenden. Siehe Geräteprofile.
HTTPS
Jede Nachricht ist ein einzelner POST mit dem Token des Geräts im Header Authorization: Bearer. Geeignet für batteriebetriebene Geräte und restriktive Netzwerke. Ein Gerät kann außerdem mit einem Long Poll auf Befehle warten. Geräte, die keine Header senden können, dürfen das Token in die URL setzen, verlieren dafür aber MQTT und Befehle für ihr Profil.
LoRaWAN
Hermetry betreibt einen eigenen LoRaWAN-Netzwerkserver für EU868 mit OTAA- und ABP-Aktivierung, Klasse A und Klasse C. Sie registrieren Gateways (Basics-Station-Gateways oder lizenzierte Router) und Sensoren; ein Codec wandelt jeden Frame in Messwerte um. Siehe LoRaWAN.
Hinter einem Gateway
Ein Gateway meldet sich als es selbst an und meldet für seine Kindgeräte über die v1/gw/*-Topics. Hermetry legt jedes Kindgerät beim ersten Bericht des Gateways an. Standardmäßig bis zu 500 Kindgeräte pro Gateway.
In Entwicklung: Das Senden von Befehlen und Änderungen gemeinsamer Attribute an Geräte hinter einem Gateway ist in Entwicklung. Derzeit meldet das Gateway für seine Kindgeräte; planen Sie Befehle an das Gateway selbst. Siehe Befehle an Geräte hinter einem Gateway.
Von der Plattform abgefragt
Manche Geräte können sich nicht einwählen. Hermetry erreicht sie stattdessen über einen Endpunkt: die öffentliche Adresse des Geräts, seine Einstellungen und seine nur schreibbaren Geheimnisse. Zwei Arten sind verfügbar:
- Netzwerkgerät: ein SNMP-Agent (v3 oder v2c, wenn aktiviert), den die Plattform in einem Intervall mit einer Vorlage abfragt (zum Beispiel USV, Netzwerkschnittstellen, Host-Ressourcen, Drucker).
- Kamera oder Recorder: eine IP-Kamera oder ein Recorder für die Live-Ansicht.
Das Gerät braucht eine öffentliche Adresse, und Ihre Firewall muss die Adressen des Pollers der Plattform durchlassen. Jedes Abfrageergebnis zählt als eine Nachricht. Siehe Protokoll-Endpunkte.
Lizenzierte Geräte
Lizenzierte Router, Gateways und Controller für Hermetry werden mit einer werkseitigen Identität und einem Zertifikat geliefert. Sie beanspruchen sie mit dem Code auf ihrer lokalen Cloud-Seite; danach verbinden sie sich mit ihrem Zertifikat und bieten Fernkonfiguration, Firmware-Updates und bei Routern Fernzugriff auf ihre Weboberfläche. Ein lizenzierter Router kann auch ein LoRaWAN-Gateway und ein Gateway für Feldgeräte sein. Siehe Lizenzierte Geräte.
Fragen, die entscheiden
- Hat das Gerät eine echte Uhr? Wenn nicht, lassen Sie Hermetry den Zeitstempel setzen (senden Sie ohne
ts). Erfinden Sie niemals Zeitstempel. - Müssen Sie Befehle senden? Dann verwenden Sie MQTT (oder HTTPS mit Long Poll), nicht ein abgefragtes Gerät oder ein Kindgerät eines Gateways.
- Hängt es an einer Mobilfunkverbindung? MQTT mit gebündelten Nachrichten kostet am wenigsten. Firmware-Updates über volumenabhängige Verbindungen warten standardmäßig.
- Kann es TLS? Wenn nicht, geben Sie ihm ein eigenes Profil, das einfaches MQTT erlaubt, und fixieren Sie seine Netzwerke. Siehe Transportsicherheit der Geräte.
- Wie viele gleicher Art? Legen Sie sie auf ein Profil und fügen Sie sie per Massenimport, per Selbstbereitstellung oder bei LoRaWAN per Kopplungsmodus hinzu.
Nächster Schritt
Verbinden Sie Ihr erstes Gerät oder Ihren ersten LoRaWAN-Sensor.