MPROG - Módulo TAGS

INTRODUCCIÓN 

El módulo TAGS es un módulo genérico para la creación de mensajes/payloads configurables. El módulo MQTT, por ejemplo, utiliza este módulo para definir un formato de payload personalizado. 

BLOQUES TAGS 

Los bloques TAGS permiten definir nombres (tags) para variables de la lógica. Existe un bloque TAG para cada formato de dato soportado. 

Estos bloques se crean libremente en la lógica para asociar un valor al nombre del tag. 

LISTA DE TAGS  

En la estructura del proyecto, en Módulos/TAGs, se muestran todos los tags creados en la lógica. 

PAYLOADS   

En la pestaña de payloads, el formato del mensaje puede crearse libremente. 

El payload tiene un formato de texto, que puede crearse libremente para definir mensajes en JSON, XML, etc. Esto permite la integración de los controladores con diversas plataformas en la nube. 

Dentro del payload, los valores de los tags definidos previamente se insertan utilizando el siguiente formato: 

%NOME%, donde NOME es el nombre definido anteriormente para el TAG. 

La mayoría de los TAGs admite parámetros de formato, como se muestra en el siguiente apartado. Para definir parámetros, se utiliza el siguiente formato: 

%NOME[parametros]%. Para incluir el carácter ‘%’, utilice un tag vacío (%%). 

FORMATO DE LOS TAGS  

Cuando ocurre la sustitución de un tag, es posible informar algunos parámetros de formato (dentro de corchetes). Si los parámetros no se incluyen, el formato se realiza con los parámetros predeterminados, según lo indicado. 

Los parámetros son una lista con el formato: 

parametro1=valor1, parametro2=valor2, ... 

TAG BOOL 

Las tags booleanas permiten los siguientes parámetros: 

true - define un texto para el valor true. El valor predeterminado es “1”. 

false - define un texto para el valor false. El valor predeterminado es “0”. 

Ejemplo: 

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

TAG INT 

La tag INT actualmente no tiene parámetros. 

Ejemplo: 

%TAG_INT% 

TAG FLOAT 

Las tags float tienen el siguiente parámetro:  

dec - define el número de decimales. El valor predeterminado es 1. 

Ejemplo: 

%TAG_FLOAT[dec=3]% 

TAGS ESPECIALES   

Las siguientes tags están definidas en el firmware:  

DATE 

Permite insertar la fecha del controlador en el mensaje. Tiene los siguientes parámetros: 

fmt - define el formato de la fecha: 

Ejemplo:

%DATE% -> 12/05/2023 

%DATE[fmt=day] -> 12 

TIME 

Permite insertar la hora del controlador en el mensaje. Tiene los siguientes parámetros: 

fmt - define el formato de la hora: 

Ejemplo: 

%TIME% -> 16:15:30 

%TIME[fmt=second] -> 30