Diese Seite beantwortet die Fragen, die neue Kunden und Firmware-Entwickler am häufigsten stellen. Jede Antwort ist kurz und verlinkt auf die Seite mit allen Einzelheiten.
Einstieg
Was brauche ich, um mein erstes Gerät anzuschließen?
Eine Organisation, ein Mitglied mit der Rolle Admin (zum Anlegen von Geräten standardmäßig erforderlich) sowie ein Gerät oder ein Computer, auf dem ein MQTT-Client oder curl laufen kann. Das Netzwerk muss ausgehendes TCP 8883 (MQTT über TLS) oder 443 (HTTPS) zulassen. Siehe Erstes Gerät anschließen.
Wo finde ich den Hostnamen, mit dem sich meine Geräte verbinden?
In der Karte Verbindungsdetails auf der Geräteseite. Dort werden der Broker-Host, der Port und die HTTPS-Adresse für dieses Gerät angezeigt. Siehe Hostnamen, Ports und IP-Adressen.
Welche Ports muss unsere Firewall freigeben?
Ausgehend TCP 8883 für MQTT über TLS sowie 443 für die App und die HTTP-API der Geräte. LoRaWAN-Gateways verwenden den Port in ihrer Netzwerkserver-Adresse, bei fehlender Angabe 443. Es muss nichts eingehend erlaubt werden, außer für Geräte, die Hermetry abfragt, etwa SNMP-Agenten und Kameras. Siehe Hostnamen, Ports und IP-Adressen.
Welche Browser können wir verwenden?
Chrome, Edge und Firefox 111 oder neuer sowie Safari 16.4 oder neuer. Passkeys, Push-Benachrichtigungen, 3D-Ansichten und Kamera-Video haben zusätzliche Anforderungen. Siehe Unterstützte Browser.
Geräte anbinden
Welche Protokolle können meine Geräte verwenden?
MQTT über TLS, die HTTPS-Geräte-API und LoRaWAN über den Netzwerkserver von Hermetry. Geräte, die sich nicht selbst verbinden können, können abgefragt werden (SNMP, Kameras) oder über ein Gateway melden. Siehe Verbindungsart wählen.
Wird MQTT 5 unterstützt?
Nein. Hermetry spricht MQTT 3.1.1 (Protokollstufe 4). Ein CONNECT für MQTT 5 wird mit dem CONNACK-Rückgabecode 1 abgelehnt. Siehe MQTT.
Kann sich ein Gerät ohne TLS verbinden?
Nur, wenn sein Geräteprofil unverschlüsseltes MQTT auf Port 1883 erlaubt. Profile sind standardmäßig nur TLS (Port 8883), und ein Gerät, das sich auf Port 1883 anmeldet, wird dann abgelehnt. Siehe Transportsicherheit der Geräte.
Wie weist ein Gerät seine Identität nach?
Mit einem Zugriffstoken (dem MQTT-Benutzernamen oder einem Bearer-Token über HTTPS), einem MQTT-Benutzernamen und Passwort oder einem X.509-Zertifikat. Jedes Gerät sollte eine eigene Zugangsdaten haben. Siehe Gerätezugangsdaten.
Mit welchem Topic und Payload sende ich Telemetrie?
Senden Sie ein JSON-Objekt an v1/telemetry, zum Beispiel {"temperature": 21.5}, oder ein Objekt mit ts und values. Siehe Referenz zu MQTT-Topics und Payloads.
Unsere Firmware veröffentlicht bereits an v1/devices/me/telemetry. Müssen wir das ändern?
Nein, wenn Sie dem Profil das Topic-Schema Legacy-kompatibel zuweisen. Dieses Schema überträgt nur Telemetrie und Attribute, ohne Befehls-Topics. Siehe Referenz zu MQTT-Topics und Payloads.
Wie groß kann eine einzelne Nachricht sein?
Standardmäßig 64 KiB. Ein Profil kann die Payload-Obergrenze zwischen 1 KiB und 64 KiB festlegen. Siehe Geräteprofile.
Was passiert mit Messwerten mit falschem Zeitstempel?
Ein Messwert, der mehr als 10 Minuten in der Zukunft liegt, wird verworfen, nicht korrigiert; die Telemetrie-Einstellungen der Organisation können dieses Zeitfenster ändern. Ein Messwert ohne Zeitstempel erhält die Zeit seines Eingangs, daher sollte ein Gerät ohne synchronisierte Uhr den Zeitstempel weglassen. Siehe Zeitstempel, verspätete und doppelte Messwerte.
Firmware und Fernzugriff
Wie gelangen Firmware-Updates auf ein Gerät?
Hermetry schreibt das Update als gemeinsame Attribute, einschließlich fw_url, eines kurzlebigen HTTPS-Download-Links (standardmäßig 15 Minuten). Das Gerät lädt das Image herunter, prüft und installiert es und meldet seinen Fortschritt in fw_state. Ein unsigniertes Image kann nicht zugewiesen werden, sofern das Profil unsignierte Images nicht erlaubt. Siehe Firmware-Updates (OTA).
Können wir die Weboberfläche eines Routers ohne feste IP-Adresse öffnen?
Ja, für beanspruchte lizenzierte Router, deren Firmware dies unterstützt. Der Router baut die Verbindung nach außen auf, wenn Sie Oberfläche öffnen auswählen, daher muss vor Ort kein Port geöffnet sein. Ein Router erlaubt höchstens 3 offene Sitzungen. Siehe Fernzugriff auf die Oberfläche eines Routers.
Organisation und Sicherheit
Können wir unsere eigene Domain verwenden?
Jede Organisation erhält eine kostenlose Adresse unter der Domain der Plattform. Eine eigene Domain wie iot.example.com ist verfügbar, wenn Ihr Tarif eigene Domains enthält; die DNS-Einträge legen Sie selbst an, das Zertifikat wird für Sie verwaltet. Siehe Web-Adressen und eigene Domains.
Warum kommen die Anmelde-E-Mails vom Absender der Plattform und nicht von unserem?
Anmeldecodes, Passwort-Zurücksetzungen, Bestätigungs- und Einladungslinks werden immer über den eigenen E-Mail-Dienst der Plattform versendet, sodass kein anderer Mailserver sie lesen kann. Sie tragen dennoch das Branding Ihrer Organisation. Siehe Konto- und Sicherheits-E-Mails.
Wie können wir die Anmeldung unserer Mitglieder absichern?
Mitglieder können Passkeys, eine Authenticator-App oder E-Mail- bzw. SMS-Codes hinzufügen, und ein Inhaber kann die Zwei-Faktor-Bestätigung für jedes Mitglied verpflichtend machen. Siehe Zwei-Faktor-Anmeldung und Passkeys.

