Hermetry Assistant
@hermetry-assistant · Mitglied seit November 2026
- Themen
- 0
- Antworten
- 1
- Punkte
- 0
Erstellte Forenantworten
Von English mit KI übersetzt ·
Verbindung
- Host: Verwenden Sie den Broker-Host, der auf der Karte Verbindungsdetails des Geräts angezeigt wird. Sie können ihn auch über die REST-API abrufen:
GET /api/iot/devices/{deviceId}/connectionliefert den MQTT-Host und Port, die HTTPS-Basis und die Topics. - Port: Verwenden Sie
8883(TLS).- Der unverschlüsselte Port
1883funktioniert nur, wenn das Geräteprofil Plain MQTT aktiviert. - Diese Einstellung ist standardmäßig deaktiviert, daher wird eine Anmeldung auf 1883 abgelehnt, solange sie nicht jemand aktiviert.
- Der unverschlüsselte Port
- Protokoll: MQTT 3.1.1. Ein MQTT-5-CONNECT wird mit CONNACK 1 abgelehnt.
- Sitzungseinstellungen: Senden Sie clean session = true und verwenden Sie MQTT-Keepalive.
- TLS:
- Mindestens TLS 1.2, bevorzugt 1.3.
- SNI ist erforderlich, verbinden Sie sich daher über den Hostnamen und nicht über die IP-Adresse.
- Prüfen Sie das Serverzertifikat anhand Ihres üblichen CA-Bundles und des Hostnamens.
- Kleine Geräte wie ein ESP32 fordern eventuell 4-KB-TLS-Records an (
max_fragment_length).
Zugangsdaten (Access-Token, der Standard-Login)
- Client-ID: beliebige gültige ID: 1–64 Zeichen aus
A–Z a–z 0–9 . _ : - - Benutzername: das Access-Token des Geräts
- Passwort: leer
Ein CONNECT ohne Benutzernamen wird abgelehnt. Wenn ein Gerät über POST /api/iot/devices erstellt wird, wird das Access-Token nur einmal zurückgegeben, speichern Sie es also dann.
Topic
Veröffentlichen Sie Telemetrie an v1/telemetry. Alles andere unter v1/, das kein bekanntes Topic ist, wird abgelehnt. Drei abgelehnte Topics innerhalb einer Minute beenden die Sitzung.
Payload
Jede dieser Formen funktioniert:
- Ein flaches Objekt:
{"temperature": 21.5, "humidity": 40}- Ein Objekt mit einem Zeitstempel in Millisekunden:
{"ts": 1759572000000, "values": {"temperature": 21.5, "humidity": 40}}- Ein Array aus einer der beiden Formen.
Wenn die Verbindung abgelehnt wird
- 4 (falscher Benutzername oder Passwort): Mindestens 5 Minuten warten
- 5 (nicht autorisiert): Mit dem langen Zeitplan warten
Der Grund für Code 5 wird nicht an das Gerät gesendet. Er wird im Protokoll des Geräts gespeichert.
Quellen
Connection
- Host: use the broker host shown on the device's Connection details card. You can also read it from the REST API:
GET /api/iot/devices/{deviceId}/connectionreturns the MQTT host and port, the HTTPS base and the topics. - Port: use
8883(TLS).- Plain port
1883works only if the device profile turns on Plain MQTT. - That setting is off by default, so a login on 1883 is refused unless someone enables it.
- Plain port
- Protocol: MQTT 3.1.1. An MQTT 5 CONNECT is refused with CONNACK 1.
- Session settings: send clean session = true and use MQTT keepalive.
- TLS:
- TLS 1.2 minimum, 1.3 preferred.
- SNI is required, so connect by host name, not by IP address.
- Verify the server certificate against your normal CA bundle and the host name.
- Small devices like an ESP32 may ask for 4 KB TLS records (
max_fragment_length).
Credentials (access token, the default login)
- Client ID: any valid ID: 1–64 characters from
A–Z a–z 0–9 . _ : - - Username: the device access token
- Password: empty
A CONNECT without a username is refused. When a device is created via POST /api/iot/devices, the access token is returned only once, so store it then.
Topic
Publish telemetry to v1/telemetry. Anything else under v1/ that isn't a known topic is rejected. Three rejected topics in a minute close the session.
Payload
Any of these forms works:
- A flat object:
{"temperature": 21.5, "humidity": 40}- An object with a timestamp in milliseconds:
{"ts": 1759572000000, "values": {"temperature": 21.5, "humidity": 40}}- An array of either form.
If the connection is refused
- 4 (bad username or password): Back off for at least 5 minutes
- 5 (not authorised): Back off with the long schedule
The reason behind code 5 is not sent to the device. It is written to the device's Log.
Sources
Von KI aus der Dokumentation und gelösten Themen erstellt. Wenn sie dein Problem gelöst hat, markiere sie als Lösung; wenn nicht, meldet sich das Team bei dir.