IoT DevKit - 13. Recebimento de Dados por MQTT
This tutorial is not available in English
Introdução
No tutorial anterior aprendemos como enviar dados para a PROIoT utilizando a conectividade Wi-Fi e o protocolo MQTT. Porém, assim como o protocolo LoRaWAN, também é possível receber informações da plataforma com a conectividade Wi-Fi.
Neste tutorial iremos aprender como enviar mensagens da plataforma para o ESP32 utilizando o protocolo MQTT, e então alterar o estado do LED quando uma determinada mensagem for recebida.
Lista de Materiais
Lista completa de produtos
comprarIoT DevKit - LoRaWAN
Configuração da Plataforma
Para esse tutorial aproveitaremos toda a configuração que fizemos na plataforma para o tutorial anterior. A única coisa que adicionaremos é um "Widget". Para isso, acesse o painel que criamos para o ESP32 anteriormente, pressione o botão "+ Widget" e selecione a opção "Requisição", como na imagem a seguir.
Feito isso, será aberta uma janela para a configuração do "Widget", como na imagem abaixo.
Com essa janela aberta, selecione corretamente a sua "Organização" e a sua "Aplicação" na seção lateral, então dê um nome e uma descrição para o "Widget". Em seguida altere o campo "Tipo de Requisição" de "HTTP", pré selecionada pela plataforma, para "MQTT". Isso fará com que os campos de configuração se alterem um pouco na janela. Neste momento, digite no campo "Porta" o valor "1883" e no campo "Host" o link "http://mqtt.proiot.network". Feito isso, agora temos que configurar alguns parâmetros que foram gerados na plataforma. No campo "Usuário", digite o Token API gerado anteriormente, e no campo "Tópico", digite "device/ID_DISPOSITIVO", lembrando de alterar a parte "ID_DISPOSITIVO" pelo código gerado pela plataforma anteriormente. Por fim, digite no campo "Payload" a mensagem "L", que será utilizada para alterar o estado do LED. Deste modo o seu "Widget" deve ficar configurado como o da próxima imagem.
Com isso, altere a cor do botão se desejar, e então pressione o botão de confirmação verde. Assim o "Widget" será adicionado ao painel do ESP32, como na imagem a seguir.
Vale lembrar que você pode alterar o tamanho e a posição do "Widget" no painel, se desejar.
Código
Com a plataforma configurada, carregue o código a seguir para a sua placa, lembrando de alterar as variáveis que armazenam o nome e a senha da sua rede Wi-Fi (REDE
e SENHA
respectivamente), juntamente com as variáveis que armazenam o ID único do seu dispositivo (ID_DISPOSITIVO
) e o Token API (TOKEN_API
), que foram gerados pela plataforma.
Entendendo o Código
O código deste projeto é parecido com o utilizado no tutorial anterior, porém não utilizamos as bibliotecas "ArduinoJson" e "DHT", pois não enviaremos as leituras do sensor para a plataforma. Além disso, ao invés de declararmos variáveis e objetos para o sensor DHT11, apenas declaramos a variável PINO_LED
, que armazena o pino do ESP32 que está conectado ao LED do DevKit, e a variável estado
, que armazena o estado de acionamento do LED (alto - HIGH
- ou baixo- LOW
). Inicialmente a variável de estado é mantida com nível baixo, pois ainda não recebemos a mensagem da plataforma. Por fim, nas declarações globais do código, nós não declaramos as variáveis responsáveis por realizar o intervalo de tempo entre envio de mensagens, já que neste código apenas receberemos as mensagens da plataforma.
Já nas configurações do código, como não vamos utilizar o sensor DHT, não precisamos iniciá-lo com o comando dht.begin()
. Ao invés disso, definimos o pino conectado ao LED como uma saída do sistema (pinMode(PINO_LED, OUTPUT)
). Além disso, nós atribuímos ao objeto MQTT
a função mqtt_callback
, do final do código, através do comando MQTT.setCallback(mqtt_callback)
. Isso faz com que essa função seja executada quando o ESP32 receber uma mensagem no tópico inscrito.
A repetição do código é bem parecida com a do tutorial anterior, porém não temos a lógica de conversão e envio das leituras do sensor. Neste código, caso o ESP32 não esteja conectado ao servidor, repetimos todas as verificações e a reconexão do tutorial anterior. Porém, além disso, nos inscrevemos no tópico do nosso dispositivo, que está armazenado na variável TOPICO
, através da condição if(!MQTT.subscribe(TOPICO))
, que também verifica se a inscrição foi feita com sucesso. Caso a inscrição não foi feita com sucesso, informamos isso no monitor serial e desconectamos o ESP32 do servidor para tentarmos a reconexão após 5 segundos. Entretanto, caso a inscrição tenha sido feita com sucesso, apenas mantemos a conexão com o servidor ativa.
A maior diferença deste código para o do tutorial anterior é justamente a função mqtt_callback
, que é declarada juntamente com as variáveis topico
, payload
e comprimento
, que são responsáveis por armazenar o tópico, o conteúdo e o comprimento da mensagem recebida, respectivamente. Dentro da função, declaramos a variável mensagem
, que armazenará a mensagem completa recebida pela placa.
Com isso, utilizamos o laço for(int i = 0; i < comprimento; i++)
para repetir o processo de cópia dos caracteres da mensagem na variável mensagem
enquanto a variável auxiliar i
for menor que a variável comprimento
. Esse processo de salvamento da mensagem é realizado graças à variável auxiliar c
, que armazena um a um os caracteres da variável payload
por meio do comando char c = (char)payload[i]
. Deste modo, todos os caracteres são adicionados em sequência na variável mensagem
pelo comando mensagem += c
. Quando toda a mensagem estiver salva, utilizamos a condição if(mensagem == "L")
para verificar se a mensagem recebida é igual a "L". Caso essa condição seja verdadeira, invertemos o estado da variável estado
por meio do comando estado = !estado
, que então é utilizada para acionar o LED através do comando digitalWrite(PINO_LED, estado)
.
O Que Deve Acontecer
Assim que o código for carregado para a placa, abra o monitor serial e, assim que a placa se inscrever ao tópico do protocolo, pressione o botão do "Widget" criado na plataforma. Isso fará com que a mensagem que configuramos seja enviada para o ESP32, apresentando um símbolo de confirmação verde, como na imagem a seguir.
Feito isso, será possível observar a mensagem sendo exibida no monitor serial, como na imagem abaixo.
E com isso, o LED do IoT DevKit irá se acender, como na próxima imagem.
Se você quiser apagar o LED depois de aceso, basta pressionar novamente o botão da plataforma, pois ele atua basicamente como um botão virtual.
É interessante observar a diferença entre o protocolo LoRaWAN e o MQTT. Como vimos no tutorial de recebimento de mensagens com LoRaWAN, o LoRaWAN Bee só recebe as mensagens da plataforma após enviar uma mensagem para a mesma, enquanto com o protocolo MQTT não precisamos enviar uma mensagem para a plataforma para autorizar o recebimento de outra. Essa pode ser uma característica fundamental para algumas aplicações que exigem uma resposta rápida para o dispositivo.
Conclusão
Neste tutorial vimos a diferença no funcionamento entre as conectividades Wi-Fi por MQTT e LoRaWAN do IoT DevKit para o recebimento de mensagens, aprendendo como receber dados da PROIoT e como tratá-los para tomar uma decisão.
Solução de Problemas
Se mesmo seguindo as soluções propostas abaixo você não conseguir solucionar o seu problema, encaminhe um e-mail para suporte@robocore.net para que possamos te ajudar da melhor maneira possível.
Arduino IDE Retornou a Mensagem "#error Use this example with the ESP32"
Como vimos anteriormente, esta é uma mensagem personalizada que criamos no início do código para quando o modelo de placa selecionado não está corretamente selecionado, portanto certifique-se que o modelo da placa nas "Ferramentas" da IDE está como "ESP32 Dev Module".
Monitor Serial Apresenta Pontos Infinitamente e Não se Conecta
Se isso acontecer, verifique as variáveis REDE
e SENHA
do código carregado, pois é possível que elas não estejam exatamente iguais aos parâmetros configurados no roteador. Além disso, certifique-se que tanto a rede quanto a senha não possuem caracteres especiais, como acentos, pois o ESP32 não deve estar os interpretando corretamente.
Monitor Serial Apresentou a Mensagem "Falha na conexao com o servidor."
Se esta mensagem for exibida no monitor serial, verifique as variáveis ID_DISPOSITIVO
e TOKEN_API
, pois é possível que elas não sejam exatamente iguais aos parâmetros gerados na plataforma. Além disso, verifique se o seu dispositivo está com a opção "Conectado" selecionada na plataforma, como na imagem abaixo. Se não estiver selecionado, selecione esta opção e observe o resultado ao tentar novamente.