Inicio rápido: crear el primer bucle de estrategia de EMS Builder

Esta guía utiliza un entorno de pruebas para completar el bucle mínimo «leer puntos adquiridos → evaluar una expresión de agregación → crear un punto agregado → verificar el resultado». No ejecutes escrituras sin revisar directamente en equipos de producción.

1. Requisitos previos

• Edge-EMS Builder está instalado y funciona correctamente.
• CommBridge está conectado al menos a un dispositivo de pruebas o simulador.
• Dispones de una cuenta de administrador de pruebas de Edge-EMS Builder.
• Has confirmado la dirección de Edge-EMS Builder:
  • Conexión directa por red local: http://<IP-del-dispositivo>:8988.
  • Proxy de JelinaCloud: https://<UUID-del-dispositivo>.proxy.jelina.wise-iot-cloud.com/api.

Utiliza la dirección, el puerto y la cuenta de tu propio entorno de pruebas. No guardes contraseñas reales, tokens ni UUID de dispositivos en el repositorio de código.

2. Comprobar los datos de EMS Builder y CommBridge

1. Inicia sesión en la página de administración de Edge-EMS Builder.
2. Abre la lista Datos adquiridos.
3. Confirma que existen al menos dos puntos numéricos, por ejemplo:
   • voltage_a
   • voltage_b
4. Comprueba que los valores están actualizados y que la comunicación es normal.

Si no hay puntos adquiridos, revisa:

• Si el proyecto, los nodos y las tareas de adquisición de CommBridge están habilitados.
• Si la URL WebSocket de CommBridge configurada en Edge-EMS Builder es correcta.
• Si el dispositivo o simulador está conectado.
• Si los registros de Edge-EMS Builder y CommBridge muestran errores de conexión o configuración.

3. Evaluar una expresión de agregación

En Datos agregados, selecciona Evaluar e introduce:

if ${voltage_a} == "__Null__" or ${voltage_b} == "__Null__" then
    return 0
end

local a = tonumber(${voltage_a}) or 0
local b = tonumber(${voltage_b}) or 0
return (a + b) / 2

Sustituye voltage_a y voltage_b por valores de dataKey que existan en el entorno de pruebas.

Resultado esperado:

• La expresión supera la validación de sintaxis.
• Devuelve un número.
• El valor devuelto equivale a la media de los dos puntos adquiridos.

4. Crear el primer punto agregado

Una vez evaluada la expresión correctamente, crea un punto agregado:

Campo	Ejemplo
dataKey	voltage_avg
Nombre	Tensión media
Tipo de datos	float
Expresión	Lua validado en el paso anterior
Periodo de adquisición/cálculo	Según el entorno de pruebas

Después de guardar:

1. Vuelve a la lista de datos agregados.
2. Confirma que se ha creado voltage_avg.
3. Cambia voltage_a o voltage_b en el simulador.
4. Comprueba que voltage_avg se actualiza en consecuencia.

5. Realizar las mismas operaciones mediante la API

Las interfaces correspondientes de Edge-EMS Builder son:

• POST /account/login
• GET /collection-data-config/list
• POST /aggregation-data-config/calculate
• POST /aggregation-data-config/add
• GET /aggregation-data-config/list

Ejemplo de solicitud de inicio de sesión:

{
  "mail": "<cuenta-de-pruebas>",
  "password": "<contraseña-de-pruebas>"
}

Las solicitudes posteriores utilizan el token devuelto por el inicio de sesión. Consulta las cabeceras, los campos y la estructura de respuesta en la documentación de la API HTTP de Edge-EMS Builder. No dejes credenciales reales en documentos, scripts ni capturas.

6. Siguiente paso: crear un esquema de disparadores

Después de crear el punto agregado, continúa con:

• Esquemas de disparadores
• Motor de expresiones Lua
• Coordinación entre nube y borde mediante MQTT
• Actualizaciones en tiempo real y control directo desde la interfaz

Empieza en el entorno de pruebas con una alarma de temperatura alta o un registro de cambios de puntos de prueba, sin riesgo de control sobre equipos, antes de pasar a escrituras en dispositivos reales.

7. Criterios de finalización

• Se visualizan los puntos adquiridos que envía CommBridge.
• La evaluación de la expresión de agregación es correcta.
• El punto agregado se ha creado y se actualiza.
• El script no produce errores cuando la entrada es __Null__.
• Todo el procedimiento se realiza en un entorno de pruebas.
• Los documentos, scripts y capturas no contienen credenciales reales.