Dispositivos MQTT

Este guia descreve os passos necessários para integração de dispositivos gerais através do MQTT.

1 Broker

Abaixo os dados para conexão com o broker:

• ip/link: mhocloud.com
• porta MQTT: 1883
• porta MQTTs: 8883

2 Credenciais

No MQTT para conexão com o broker, o dispositivo precisa de até 3 configurações, sendo elas:

• deviceID/clientID: Identificação do dispositivo para o broker;
• user: Usuário de conexão;
• password: Senha do usuário.

Para se conectar ao Broker MHO Cloud o dispositivo terá uma credencial única vinculada a sua licença MHO Cloud. Essa credencial/licença será preenchida no campo user do MQTT. O campo password deve ficar em branco e o campo clientID pode ficar em branco ou com qualquer valor. Portanto, o setup para conexão será o seguinte:

• deviceID/clientID: Em branco ou qualquer valor;
• user: Licença MHO Cloud;
• password: Em branco.

3 Envio de Telemetria

Os dados de telemetria devem ser enviados no seguinte tópico:

mho/v1/gen/telemetry

3.1 Timestamp do Servidor

A referência de horário será obtida pelo servidor no momento que o dado chega. Os payloads devem ser enviados no formato JSON, padronizados da seguinte forma:

{"key1":"value1"}

ou para mais chaves

{"var1": value1, "var2": value2, ...}

Sendo os campos value1, value2, ... , valueN podendo ser qualquer valor em formato válido JSON:

• boolean: true;
• int number: 10;
• precision number: 10.555;
• string: "valor"

3.2 Timestamp do Dispositivo

A referência de horário será disponibilizada pelo equipamento através do Unix timestamp em milissegundos. Os payloads devem ser enviados no formato JSON, padronizados da seguinte forma:

{"ts":1709656216318, "values":{"var1": value1}}

ou para mais chaves

{"ts":1709656216318, "values":{"var1": value1, "var2": value2, ...}}

Sendo os campos value1, value2, ... , valueN podendo ser qualquer valor em formato válido JSON:

• boolean: true;
• int number: 10;
• precision number: 10.555;
• string: "valor"