Assinando(recebendo) valores de Tópicos(Dados) de um Conector

Para receber os valores publicados em tópicos de um Conector MQTT cadastrado no Portal, como por exemplo, publicações de escritas em um Dado do Conector através de um controle de um painel Sinótico, deve-se assinar(subscrever) os tópicos associados aos Dados desejados.

Exemplo de assinatura de tópico associado a um Dado de um Conector do Portal de Telemetria:

mosquitto_sub -h "broker.mqtt.hitecnologia.com.br" -p 1883 -u "6f27b6700ede4a0db47560db0cf7d3de" -i "9a3547bc" -t "9a3547bc/temperatura-forno" -q 0'

Parâmetro	Identificação	Valor	Observações
-h	Endereço do BROKER MQTT	broker.mqtt.hitecnologia.com.br	URL do BROKER MQTT do Portal de Telemetria
-p	Porta de comunicação do BROKER MQTT	1883	Porta do BROKER MQTT do Portal de Telemetria
-u	Usuário da conexão MQTT	6f27b6700ede4a0db47560db0cf7d3de	Chave de Acesso obtida no cadastro do Conector ou nas configurações do Contrato
-i	ID de cliente da conexão MQTT	9a3547bc	Identificador de Tópico e ID de Cliente MQTT do Conector em que se deseja realizar a publicação
-t	Tópico a ser assinado	9a3547bc/temperatura-forno	Tópico associado ao Dado cadastrado no Conector e que receberá os valores publicados no mesmo
-q	Qualidade de Serviço(QoS) da publicação	0	Define a confiabilidade da entrega da mensagem de assinatura. O portal aceita os níveis 0(no máximo uma vez) ou 1(pelo menos uma vez)

Conforme explicado na seção de publicação de tópicos, após qualquer publicação em um tópico no BROKER MQTT do Portal, independentemente do formato ou conteúdo utilizado, o valor do tópico no Broker será padronizado para incluir o valor informado e o seu carimbo de data/hora(timestamp em epoch/unix):

{"value": 25.5, "timestamp": 1634213376506}

Ou seja, o cliente MQTT que assinar um determinado tópico associado a um Dado no Portal, deve lidar com o conteúdo neste padrão informado.

Atenção

O equipamento(cliente MQTT) deve enviar um PINGREQ sempre que implemente uma rotina de assinatura ao BROKER MQTT do Portal para evitar que a conexão seja fechada por inatividade.

O tempo máximo permitido para enviá-lo é de até 1 hora, portanto, certifique-se de configurar o parâmetro Keep Alive em seu cliente MQTT para até 60 minutos(3600 segundos).

Para obter mais informações sobre a informação de “Keep Alive” do MQTT, consulte MQTT Keep Alive.