Traducido del English por IA ·
Tengo un pequeño sensor ESP32 y quiero enviar temperatura y humedad a Hermetry por MQTT. ¿Qué dirección de broker, credenciales y topic debo usar, y cómo es el payload JSON?
I have a small ESP32 sensor and want to send temperature and humidity to Hermetry over MQTT. Which broker address, credentials and topic do I use, and what does the JSON payload look like?
Traducido del English por IA ·
Conexión
- Host: use el host del broker que aparece en la tarjeta Detalles de conexión del dispositivo. También puede leerlo desde la API REST:
GET /api/iot/devices/{deviceId}/connectiondevuelve el host y puerto MQTT, la base HTTPS y los topics. - Puerto: use
8883(TLS).- El puerto sin cifrar
1883solo funciona si el perfil del dispositivo activa Plain MQTT. - Esa opción está desactivada por defecto, así que un inicio de sesión en 1883 se rechaza hasta que alguien la active.
- El puerto sin cifrar
- Protocolo: MQTT 3.1.1. Un CONNECT de MQTT 5 se rechaza con CONNACK 1.
- Ajustes de sesión: envíe clean session = true y use keepalive de MQTT.
- TLS:
- TLS 1.2 como mínimo, 1.3 preferido.
- SNI es obligatorio, así que conéctese por nombre de host y no por dirección IP.
- Verifique el certificado del servidor con su paquete de CA habitual y el nombre de host.
- Los dispositivos pequeños como un ESP32 pueden pedir registros TLS de 4 KB (
max_fragment_length).
Credenciales (token de acceso, el inicio de sesión por defecto)
- Client ID: cualquier ID válido: de 1 a 64 caracteres de
A–Z a–z 0–9 . _ : - - Nombre de usuario: el token de acceso del dispositivo
- Contraseña: vacía
Un CONNECT sin nombre de usuario se rechaza. Cuando se crea un dispositivo mediante POST /api/iot/devices, el token de acceso se devuelve solo una vez, así que guárdelo en ese momento.
Topic
Publique la telemetría en v1/telemetry. Cualquier otro topic bajo v1/ que no sea conocido se rechaza. Tres topics rechazados en un minuto cierran la sesión.
Payload
Cualquiera de estas formas funciona:
- Un objeto plano:
{"temperature": 21.5, "humidity": 40}- Un objeto con una marca de tiempo en milisegundos:
{"ts": 1759572000000, "values": {"temperature": 21.5, "humidity": 40}}- Un array de cualquiera de las dos formas.
Si la conexión se rechaza
- 4 (usuario o contraseña incorrectos): espere al menos 5 minutos
- 5 (no autorizado): espere según la programación larga
El motivo del código 5 no se envía al dispositivo. Se escribe en el Registro del dispositivo.
Fuentes
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
Escrito por IA a partir de la documentación y de los temas resueltos. Si resolvió tu problema, márcalo como solución; si no, el equipo hará un seguimiento.
- Debes estar registrado para responder a este debate.
Únete a la conversación
Inicia sesión para preguntar y responder, dar me gusta a las publicaciones útiles y marcar la respuesta que resolvió tu problema. Cada aportación suma puntos y niveles.