MPROG - Módulo TAGS

INTRODUÇÃO

O módulo TAGS é um módulo genérico para criação de mensagens/payloads configuráveis. O módulo MQTT, por exemplo, usa este módulo para definir um formato customizado de payload. 

BLOCOS TAGS 

Os blocos TAGS permitem definir nomes (tags) para variáveis da lógica. Existe um bloco TAG para cada formato de dado suportado. 

Estes blocos são criados livremente na lógica para associar um valor ao nome do tag. 

LISTA DE TAGS  

Na estrutura do projeto, em Módulos/TAGs, são mostrados todos os tags criados na lógica. 

PAYLOADS   

Na aba de payloads, o formato da mensagem pode ser criado livremente. 

O payload possui um formato texto, que pode ser criado livremente para definir mensagens em JSON, XML, etc. Isto permite a integração dos controladores com diversas plataformas de nuvem. 

Dentro do payload os valores dos tags previamente definidos são inseridos usando o seguinte formato: 

%NOME%, onde NOME é o nome definido anteriormente para o TAG. 

A maioria dos TAGs suporta parâmetros de formatação, como mostrados no tópico a seguir. Para definir parâmetros, o seguinte formato é usado: 

%NOME[parametros]%. Para inclusão de um caractere ‘%’, usar um tag vazio (%%). 

FORMATAÇÃO DOS TAGS 

Quando ocorre a substituição de um tag, é possível informar alguns parâmetros de formatação (dentro de colchetes). Caso os parâmetros não sejam incluídos, a formatação é feita com os parâmetros padrões, conforme indicado. 

Os parâmetros são uma lista no formato: 

parametro1=valor1, parametro2=valor2, ... 

TAG BOOL 

As tags booleanas permitem os seguintes parâmetros: 

true - define um texto para valor true. Padrão é “1”. 

false - define um texto para o valor false. Padrão é “0”. 

Exemplo: 

%TAG_BOOL[true=LIGADO, false=DESLIGADO]% 

TAG INT 

A tag INT atualmente não tem parâmetros. 

Exemplo: 

%TAG_INT% 

TAG FLOAT 

As tags float possuem o seguinte parâmetro: 

dec - define o número de decimais. Padrão é 1. 

Exemplo: 

%TAG_FLOAT[dec=3]% 

TAGS ESPECIAIS  

As seguintes tags são definidas no firmware: 

DATE 

Permite inserir a data do controlador na mensagem. Possui os seguintes parâmetros: 

fmt - define o formato da data: 

Exemplo:

%DATE% -> 12/05/2023 

%DATE[fmt=day] -> 12 

TIME 

Permite inserir a hora do controlador na mensagem. Possui os seguintes parâmetros: 

fmt - define o formato da hora: 

Exemplo: 

%TIME% -> 16:15:30 

%TIME[fmt=second] -> 30