MicroLink Remote Control, MicroLink MQTT Remote Control

Estabelecimento de configurações de conexão para se conectar ou desconectar de um agente MQTT

Um agente MQTT serve essencialmente como um servidor para gerenciar mensagens MQTT. Para se conectar a um agente MQTT, devemos inserir o número da porta e o endereço IP do agente no UDFB RA_MQTT_CONNECT_v2. O agente pode estar hospedado em seu computador (nesse caso, você precisaria instalar e operar um agente MQTT compatível com seu sistema operacional) ou pode ser um servidor remoto, como os mencionados anteriormente.

1.1 Atribua o endereço IP e o número da porta do agente MQTT ao UDFB RA_MQTT_CONNECT_v2.

Este exemplo serve para se conectar ao agente test.mosquitto.org na nuvem.  Uma alternativa para inserir o endereço IP diretamente é ativar o Serviço de nome de domínio (defina “EnableDNS” como TRUE) após inserir o URL do agente MQTT em “MQTTBrokerName” e o endereço IP do servidor DNS local em “DNSIPaddr” na linha 2.

1.2 Insira um “clientName” exclusivo, bem como um “userID” e um “userPass”, se o agente MQTT exigir (muitos agentes MQTT públicos não exigem nome de usuário e senha; portanto, esses campos são opcionais e podem ser deixados em branco se não forem obrigatórios)

1.3 Defina “EnableMQTT” como TRUE para se conectar ao agente MQTT.

Observação:

É preciso se lembrar de algumas coisas para garantir uma conexão bem-sucedida. Em algum momento, MQTTsocketSts deve exibir um 9. Se mostrar um 7 e depois voltar para 0, isso pode significar que o agente não está em execução ou não existe.

Os dados em resultData_Out são úteis para a localização de falhas de diagnóstico. Normalmente, quando você envia um comando de conexão ao servidor, ele responde com uma confirmação. A confirmação é indicada pelo 1º byte, que neste caso é “32”.

Outra resposta frequente que você receberá é uma confirmação de ping, indicada pelo “208” no 1º byte dos dados retornados. O comando ping é enviado ao agente remoto em intervalos de 50 segundos. Esse intervalo é codificado permanentemente no UDFB, mas pode ser modificado, se necessário.

Se os dados de retorno são diferentes de 32 ou 208 na conexão, isso pode sugerir que o cliente assinou um tópico que foi transmitido enquanto estava off-line. A mensagem é retida e enviada ao cliente quando volta a ficar on-line. Se você encontrar isso, processe a mensagem e reinicie a conexão.

1.4 Se você deseja configurar para LWT, precisa acessar estes parâmetros no UDFB:

Assinatura ou cancelamento de assinatura de um tópico

O protocolo MQTT troca dados por meio de métodos de assinatura e publicação. Os clientes se comunicam diretamente apenas com o agente MQTT. Os clientes que assinam um tópico receberão uma mensagem do agente quando outro cliente publicar nesse tópico. Os clientes podem ser de qualquer forma, desde que tenham uma aplicação cliente MQTT em execução. Por exemplo, podem ser um software em um PC, um conector ou uma API para o software, uma aplicação em um telefone ou código de aplicação em um CLP.

2.1. Digite o nome do tópico (“topicName_input”) para assinar ou cancelar a assinatura.

2.2. Defina a qualidade de serviço (“subQos”) para a assinatura. Por padrão, use “0”, pois consome menos largura de banda.

2.3. Defina “subscribe” ou “unsubscribe” como TRUE para assinar ou cancelar a assinatura do tópico.

2.4. Esses bits detectam a borda ascendente; portanto, você pode redefini-los imediatamente.

2.5. Observe que resultData_Out de RA_MQTT_CONNECT_v2 também é copiado para respondData_In.

Observação:

Recomenda-se usar apenas uma (1) instância de cada UDFB.

Publicação de um tópico

Quando um tópico com dados é publicado em um agente MQTT, o agente encaminha os dados desse tópico para todos os clientes inscritos nele. O cliente que publica a mensagem não sabe se algum nó remoto está recebendo o tópico, pois essa responsabilidade é do agente, dependendo do nível da QoS. Os tópicos podem ser publicados ou assinados em qualquer nível de QoS, mas serão entregues apenas no menor nível de QoS.

3.1. Insira o tópico para publicar em “pubTopic_In”.

3.2. Insira os dados para o tópico em “pubData_In”.

3.3. Defina a qualidade de serviço em “pubQoS”. Por padrão, use “0”, pois consome menos largura de banda.

3.4. Defina “publish” como TRUE para publicar o tópico com os dados. Ele será automaticamente definido como FALSE quando “publishDN” ficar TRUE.

3.5. Observe que resultData_Out de RA_MQTT_CONNECT_v2 também é copiado para respondData_In.

Recebimento de mensagens de tópicos assinados

O agente MQTT lida com todas as assinaturas de tópicos. Ele envia os dados de qualquer tópico publicado para os clientes assinantes. Quando um tópico é recebido pelo cliente MQTT do Micro800, ele preenche as variáveis de matriz “TopicName” e “TopicData” no UDFB RA_MQTT_CONNECT_v2. Os dados são armazenados na ordem de primeiro a entrar/primeiro a sair, por isso é crucial processar os dados antes que eles sejam substituídos.

Assinatura de uma matriz de tópicos

MQTT_Subscriptions é um programa de texto estruturado opcional que funciona em conjunto com o programa MQTT_Client. Ele permite assinar uma matriz “Subscriptions” de tópicos pré-configurados. Ajuste a dimensão da matriz da variável global “Subscriptions” para o tamanho desejado e modifique o valor inicial da variável local “maxSubscriptions” para corresponder ao tamanho da matriz (o padrão é 10). “Subscriptions” é uma matriz de tipo de dados definido pelo usuário (UDT) que compreende o tópico MQTT “Name”, o tópico mais recente “Data”, a data e hora reais de quando o tópico mais recente “Data” foi recebido e um indicador “Subscribed”. Insira os nomes de tópicos desejados para assinar como valores iniciais para Subscriptions[i]. Name antes de fazer o download do projeto para o controlador.

A variável local “enableSubcriptions” deve ser TRUE para habilitar essa funcionalidade.

Publicação automática de uma matriz de tópicos

MQTT_Publications é um programa de texto estruturado opcional que funciona em conjunto com o programa MQTT_Client. Ele permite publicar toda uma matriz de “Publications” de tópicos pré-configurados. Ajuste a dimensão da matriz da variável global “Publications” para o tamanho desejado e modifique o valor inicial da variável local “maxPublications” para corresponder ao tamanho da matriz (o padrão é 10). “Publications” é uma matriz de tipo de dados definido pelo usuário (UDT) que compreende o tópico MQTT “Name”, o tópico mais recente “Value”, o valor do tópico anterior “Valueprev” e a data e hora reais de quando o tópico mais recente “Value” foi publicado. Insira os nomes de tópicos desejados para publicar como valores iniciais para Publications[i]. Name antes de fazer o download do projeto para o controlador.

Defina a variável local “ChangeOfState” como TRUE para publicar qualquer valor que mude como exceção. Defina a variável local “Interval” como TRUE e “intervalTime” como um valor diferente de zero para publicar todos os valores atuais que não são nulos ('') em intervalos de tempo. Normalmente, alguém escolheria “ChangeOfState” ou “Interval” como o método para publicar atualizações de tópicos. Para uma atualização única, defina a variável local “OnDemanD” como TRUE para publicar todos os valores atuais que não sejam nulos (''). “OnDemanD” é definido como FALSE depois que toda a matriz “Publications” é publicada. A variável local “enablePublications” deve ser definida como TRUE para ativar essa funcionalidade do programa.