Geräte – Hermetry

Ein Gerät ist alles, was Daten an Hermetry sendet oder Befehle von Hermetry empfängt: ein Sensor, eine Steuerung, ein Zähler, eine Kamera, ein LoRaWAN-Gateway, ein lizenzierter Router. Jedes Gerät gehört zu genau einer Organisation und verwendet genau ein Geräteprofil. Dieser Abschnitt erklärt, wie Sie Geräte hinzufügen, verbinden, ihre Zugangsdaten sicher aufbewahren, ihren Status auslesen, ihnen Befehle senden, ihre Firmware aktualisieren und ihre Einstellungen ändern.

Das Gerätemodell

Teil	Was es ist	Lesen
Gerät	Ein Datensatz in Geräte: Name (innerhalb Ihrer Organisation eindeutig), Bezeichnung, Typ, Profil, Status, optionale Seriennummer und die Angabe, ob es ein Gateway ist.	Die Geräteliste und die Geräteseite
Geräteprofil	Die Einstellungen, die einer Gerätart gemeinsam sind: Übertragung, Anmeldedaten, Topics, Grenzwerte, Online-Regel, Telemetrie- und Konfigurationsschlüssel, Provisionierung sowie Alarmregeln, Befehle und Firmware.	Geräteprofile
Zugangsdaten	Die Anmeldedaten, mit denen sich das Gerät anmeldet. Pro Gerät gibt es höchstens eine aktive Zugangsdaten-Angabe.	Gerätezugangsdaten
Telemetrie	Zeitgestempelte Messwerte, eine Reihe pro Schlüssel.	Telemetrie und Daten
Attribute	Werte, die das Gerät beschreiben oder konfigurieren: client (die des Geräts selbst), shared (an das Gerät gesendet) und server (auf der Plattform gespeichert).	Attribute
Verbindungsstatus	Online oder offline gemäß der Regel des Profils, zuletzt gesehen, Verbindungsprotokoll.	Verbindungsstatus und Aktivität
Platzierung	Der Standort, das Gebäude, der Raum oder die Maschine, an dem bzw. der sich das Gerät befindet.	Geräte platzieren

Wie Geräte Hermetry erreichen

Weg	Für	Seite
MQTT 3.1.1 über TLS	Geräte, die eine Verbindung dauerhaft offen halten	MQTT, MQTT-Topics und Nutzlast-Referenz
HTTPS	Geräte, die aufwachen, senden und wieder schlafen, oder Netze, die MQTT blockieren	Geräte-HTTP-API
LoRaWAN	Batteriesensoren hinter LoRaWAN-Gateways (EU868)	LoRaWAN
Über ein Gateway	Feldgeräte hinter einem Router oder Gateway, das für sie meldet	Gateways und Geräte hinter einem Gateway
Von der Plattform abgefragt	Geräte, die sich nicht einwählen können: SNMP-Agenten, IP-Kameras und Recorder	Gateways und Geräte hinter einem Gateway

Sie sind unsicher, welcher Weg passt? Lesen Sie Wählen Sie, wie Sie Ihre Geräte verbinden.

Wie Geräte in Ihre Organisation gelangen

Weg	Verwenden für	Seite
Neues Gerät (manuell)	Einige wenige Geräte, die Sie selbst einrichten	Geräte hinzufügen und beanspruchen
Import aus einer CSV-Datei	Zehn bis Hunderte Geräte auf einmal (bis zu 1.000 Zeilen pro Datei)	Geräte in Massen importieren
Selbstprovisionierung mit einem Profilschlüssel	Viele identische Geräte, die sich beim ersten Start selbst registrieren	Geräte hinzufügen und beanspruchen, Quarantäne
Beanspruchen	Lizenzierte Geräte, mit dem Code auf ihrer Cloud-Seite	Lizenzierte Geräte
Ein Gateway meldet ein neues untergeordnetes Gerät	Feldgeräte hinter einem Gateway	Geräte hinter einem Gateway
LoRaWAN-Registrierung oder Kopplungsmodus	LoRaWAN-Sensoren	Ein OTAA-Gerät hinzufügen, Kopplungsmodus

Wie Geräte ihre Identität nachweisen

Zugangsdaten	Anmeldung
Zugriffstoken	MQTT-Benutzername = Token, Passwort leer. HTTP: `Authorization: Bearer <token>`.
MQTT-Basis	Benutzername und Passwort, optional an eine Client-ID gebunden.
X.509-Zertifikat	Ein Client-Zertifikat, ausgestellt von der Gerätezertifizierungsstelle von Hermetry. Wird von lizenzierten Geräten verwendet.

Geheimnisse werden nur einmal angezeigt, wenn sie ausgestellt oder rotiert werden. Hermetry speichert nur Hashwerte. LoRaWAN-Sensoren, untergeordnete Gateway-Geräte und abgefragte Geräte haben keine eigenen Zugangsdaten: Ihr Gateway, der Netzwerkserver oder der Abfrager liefert ihre Daten.

Gerätestatus

Status	Bedeutung
Aktiv	Das Gerät darf sich verbinden und seine Daten werden gespeichert.
Deaktiviert	Das Gerät wird bei der Verbindung abgewiesen. Eine bestehende Live-Verbindung endet, wenn Sie es deaktivieren.
In Quarantäne	Das Gerät hat sich selbst registriert und wartet auf Freigabe. Es darf sich verbinden, aber seine Daten werden verworfen, bis ein Administrator es aktiviert. Es zählt zu Ihrem Gerätelimit.

Der Status ist vom Verbindungsstatus getrennt. Ein aktives Gerät kann je nach Online-Regel seines Profils Online, Offline, Nie verbunden sein oder nur Zuletzt gesehen anzeigen.

Berechtigungen

Berechtigung	Standardmindestrolle
Geräte anzeigen	Benutzer
Geräte erstellen	Administrator
Geräte bearbeiten und deaktivieren	Administrator
Geräte löschen	Administrator
Gerätezugangsdaten verwalten	Administrator
Geräteattribute anzeigen	Benutzer
Server- und Shared-Geräteattribute schreiben	Administrator

Andere IoT-Module fügen eigene Berechtigungen hinzu (Befehle, Firmware, Alarme, LoRaWAN, Einstellungen). Siehe Berechtigungsreferenz.

Grenzwerte

Ihr Tarif legt fest, wie viele Geräte Sie haben dürfen. Jedes Gerät zählt mit: Geräte in Quarantäne, LoRaWAN-Gateways und -Sensoren, untergeordnete Gateway-Geräte und abgefragte Geräte. Wenn Sie das Limit erreichen, werden neue Geräte mit der Meldung abgewiesen, dass das Gerätelimit des Tarifs erreicht ist. Siehe Tarife und das IoT-Add-on.

In diesem Abschnitt

Grundlagen

Verbinden

Geräte aus der Ferne verwalten