Script personalizado para el módulo de operaciones del IG

Esta funcionalidad te permite crear un pequeño algoritmo personalizado que se ejecuta de forma automática cada vez que tu dispositivo IG-7100 recibe una nueva muestra de datos (AI, DI, MODBUS, OPCUA).

Podrás definir reglas según umbrales, tiempos, condiciones y, si lo necesitas, trabajar también con datos históricos.

⚠️ Requisito: Esta configuración requiere conocimientos técnicos avanzados en JavaScript y en la lógica de operación de dispositivos IoT.

1️⃣ Accede a tu dispositivo IG-7100

1. Entra en tu cuenta y localiza el IG-7100 en la lista de dispositivos.
   
   
   
   

2. Haz clic en el nombre del dispositivo para abrir su información.
   
   

3. Ve a la pestaña Operaciones y pulsa el botón Configuración.
   
   

2️⃣ Crea y configura tu script

Sigue estos pasos básicos:

✅ 1. Agrega las entradas necesarias para la operación.
✅ 2. Añade los sensores base que utilizará el script.
✅ 3. Selecciona el tipo de operación que vas a crear.
✅ 4. Configura la descripción y el periodo de ejecución del script.
✅ 5. Inserta el código JavaScript Nespra con tu lógica personalizada.
✅ 6. Guarda la configuración.

3️⃣ Entiende la estructura del script

Cuando se ejecuta, el script utiliza un objeto params que incluye toda la información clave:

let params = {
  deviceID: context.global.ID,    // ID del dispositivo
  logs: [],                       // Lista de logs para depurar
  obj: obj,                       // Datos recibidos, ej: {s1: 0, s2: 0}
  operationName: operationName,   // Nombre de la operación
  operationState: operationState, // Estado interno de la operación
  result: 0,                      // Resultado a calcular
  pendingUpdates: pendingUpdates, // Historial de muestras pasadas
};

4️⃣ Cómo registrar logs

Para seguir paso a paso lo que ocurre en tu script, añade mensajes al log:

params.logs.push("Script ejecutado :::" + new Date().toISOString());
params.logs.push("params.obj:" + JSON.stringify(params.obj));
params.logs.push("params.operationName:" + params.operationName);
params.logs.push("params.result:" + params.result);
params.logs.push("End script");

Ejemplo de salida de logs:

[
  "Script ejecutado :::2025-04-14T07:41:52.666Z",
  "params.obj:{\"s1\":30,\"s2\":0}",
  "params.operationName:op1",
  "params.result:0",
  "End script"
]

5️⃣ Define tus reglas personalizadas

Puedes trabajar con variables propias:

var threshold = 40; // Umbral mínimo
var requiredTimeMs = 2 * 60 * 1000; // Tiempo mínimo (ms)
var dataReturnTimeMs = 2 * 60 * 1000; // Rango de datos históricos (ms)

Y aplicar condiciones:

if (obj.s1 >= threshold) {
  // Acción si supera el umbral
}

if (obj.s1 >= threshold && obj.s3 < otroUmbral) {
  // Acción con doble condición
}

6️⃣ Trabaja con datos históricos

Puedes consultar hasta los últimos 20 registros previos:

[
  { op1: 0, op2: 0, TimeStamp: 1744616512 },
  { op1: 0, op2: 0, TimeStamp: 1744616572 },
  { op1: 0, op2: 0, TimeStamp: 1744616632 },
]

• TimeStamp:  marca de tiempo en segundos UNIX.

• op1, op2:  señales de operaciones enviadas.

7️⃣ Publica resultados procesados

Envía nuevos datos desde tu script usando params.msgPublish:

msg = {
  topic: "nespra/ig/data/" + params.deviceID + "/operations",
  payload: {
    TimeStamp: 1713100060,
    s1: 45,
  }
};
params.msgPublish.push(msg);

Estos mensajes pueden ser MQTT u otros mensajes internos para reenviar, corregir o complementar datos.

✅ ¡Y listo! Ahora tu dispositivo ejecutará automáticamente tu lógica cada vez que reciba nuevos datos.