node-red-contrib-device-simulator-energiam 0.2.1

Node-RED node to simulate IoT devices (e.g. zigbee2mqtt) injecting configurable JSON objects with variable fields and flexible trigger intervals

npm install node-red-contrib-device-simulator-energiam

node-red-contrib-device-simulator-energiam

EnergIAM — IoT Device Simulator for Node-RED

Nodo custom para Node-RED que simula dispositivos IoT (zigbee2mqtt, sensores Modbus, medidores de energía, etc.) inyectando objetos JSON configurables con campos variables, intervalos flexibles y disparo condicional por cambio de valor.

Diseñado para desarrollo, testing y simulación de entornos productivos sin necesidad de hardware físico.

✨ Características

• 📋 Template JSON libre — pegá cualquier objeto que quieras simular
• 🎲 Campos variables — elegí qué campos numéricos varían y entre qué rangos
• ⏱️ Intervalo fijo o aleatorio — fijo en ms, o random entre un mínimo y máximo
• 🔔 Disparo condicional — configurá por campo si el mensaje se envía solo cuando ese valor cambia
• 🏷️ Topic configurable — compatible con cualquier pipeline MQTT/Node-RED
• 🟢 Status en tiempo real — el nodo muestra en el canvas si envió, si no hubo cambios, o si hay error

📦 Instalación

Desde repositorio git (recomendado)

Accedé al contenedor Docker de Node-RED:

docker exec -it <nombre-contenedor-nodered> bash

Instalá el nodo directamente desde el repositorio:

cd /data
npm install git+https://github.com/<tu-usuario>/node-red-contrib-device-simulator-energiam.git

Reiniciá Node-RED:

# Desde fuera del contenedor
docker restart <nombre-contenedor-nodered>

Actualizar a una nueva versión

docker exec -it <nombre-contenedor-nodered> bash
cd /data
npm install git+https://github.com/<tu-usuario>/node-red-contrib-device-simulator-energiam.git
docker restart <nombre-contenedor-nodered>

🚀 Uso rápido

1. Buscá device simulator en la paleta (categoría simulation)
2. Arrastrá el nodo al canvas
3. Doble click → abrís el editor
4. Pegá tu objeto JSON en Template JSON y presioná Actualizar campos desde JSON
5. Configurá los campos variables, rangos e intervalo
6. Deploy — el nodo empieza a inyectar

⚙️ Configuración del nodo

Template JSON

Pegá el objeto JSON que quieras simular. Ejemplo con un medidor zigbee2mqtt:

{
    "ac_frequency": 50.0,
    "voltage": 220.0,
    "current_a": 1.5,
    "power_a": 330.0,
    "energy_a": 12.4,
    "power_factor_a": 98,
    "linkquality": 105
}

Presioná Actualizar campos desde JSON — la tabla se llena automáticamente con todos los campos numéricos del objeto.

Tabla de campos variables

Si ningún campo tiene Dispara si cambia activo, el nodo siempre envía en cada ciclo.
Si uno o más campos lo tienen activo, el nodo solo envía si al menos uno de ellos cambió respecto al envío anterior.

Intervalo

Topic

Topic del mensaje de salida. Compatible con cualquier nodo MQTT out, función, o switch de Node-RED.

Ejemplo: zigbee2mqtt/medidor_sala_a1

📡 Mensaje de salida

{
    "topic": "zigbee2mqtt/medidor_sala_a1",
    "payload": {
        "ac_frequency": 49.87,
        "voltage": 218.34,
        "current_a": 1.62,
        "power_a": 341.5,
        "energy_a": 12.4,
        "power_factor_a": 97,
        "linkquality": 105
    }
}

Los campos no marcados como Variable conservan siempre el valor del template original.

🗂️ Estructura del repositorio

node-red-contrib-device-simulator-energiam/
│
├── device-simulator.js     # Lógica del nodo (backend Node-RED)
├── device-simulator.html   # UI del editor y help (frontend)
├── package.json
├── icons/
│   └── energiam.png        # Ícono del nodo en la paleta
└── README.md

🛠️ Stack

• Node-RED >= 3.0.0
• Node.js >= 18.0.0
• Sin dependencias externas

🔄 Compatibilidad

Probado con:

• zigbee2mqtt — medidores de energía Tuya, Sonoff, etc.
• Medidores Modbus normalizados
• Cualquier dispositivo que publique JSON plano por MQTT

🔐 Licencia

MIT — libre uso, modificación y distribución.

👤 Autor

EnergIAM by Adrian Iskow
Plataforma de gestión inteligente de energía
Argentina, 2025