Por qué existe este nodo

node-red-contrib-modbus (el paquete más usado) y el node-red-contrib-serial-modbus original no exponen ninguna forma de controlar la línea RTS del puerto serie. Muchos adaptadores USB-RS485 half-duplex (sin auto-detección de dirección) necesitan RTS forzado en alto para habilitar su transmisor — sin esto, el maestro nunca llega a poner nada en el bus físico, aunque el puerto abra sin ningún error y todo parezca configurado bien.

Esto se confirmó de forma empírica contra hardware real (adaptador USB-RS485 basado en FTDI + ESP32 corriendo Modbus RTU esclavo) antes de escribir este nodo: con RTS en su estado por defecto, cero bytes llegaban al esclavo; forzándolo en alto, la comunicación funcionó de inmediato.

Fork de node-red-contrib-serial-modbus (originalmente de IBM Corp., mantenido por tyrrellsystems / leifnel), con dependencias actualizadas y esta opción agregada.

Instalación

Desde el gestor de paletas de Node-RED (menú → Manage palette → Install), buscar node-red-contrib-serial-modbus-energiam. O por línea de comandos:

cd ~/.node-red
npm install node-red-contrib-serial-modbus-energiam

Reiniciar Node-RED después de instalar.

Nodos incluidos

| Nodo | E/S | Uso | |---|---|---| | Modbus-Serial In | solo salida | Poll automático a intervalo fijo de una lista de esclavos | | Modbus-Serial Out | solo entrada | Escribe en el esclavo en cada mensaje recibido | | Modbus-Serial Request | entrada y salida | Cada mensaje que llega dispara una lectura o escritura puntual y devuelve el resultado por la salida |

Los tres comparten un nodo de configuración modbusSerialConfig (puerto, baudrate, data/parity/stop bits, y el checkbox Forzar RTS).

Ejemplo funcionando: Modbus-Serial Request

Flujo mínimo inject → Modbus-Serial Request → debug, probado contra un esclavo Modbus RTU real (medidor de energía por PZEM-004T detrás de un ESP32), leyendo 6 holding registers desde la dirección 1:

[inyectar] → [Modbus-Serial Request] → [debug]

Payload del inject (tipo JSON):

{
  "unitid": 30,
  "fc": 3,
  "address": 1,
  "quantity": 6
}

Salida real obtenida (msg.payload, array de 6 valores):

[21420, 0, 0, 0, 0, 5000]

En este caso: voltaje = 214.20 V, frecuencia = 50.00 Hz (los registros vienen multiplicados x100 desde el firmware del esclavo).

Flow JSON para importar

Copiar, y en Node-RED: menú → Import → pegar.

[
    {
        "id": "46961f40413ba442",
        "type": "inject",
        "z": "",
        "name": "",
        "props": [ { "p": "payload" } ],
        "repeat": "",
        "crontab": "",
        "once": false,
        "onceDelay": 0.1,
        "topic": "",
        "payload": "{\"unitid\":30,\"fc\":3,\"address\":1,\"quantity\":6}",
        "payloadType": "json",
        "x": 210,
        "y": 280,
        "wires": [ [ "644a0d806285d0c6" ] ]
    },
    {
        "id": "644a0d806285d0c6",
        "type": "modbusSerial request",
        "z": "",
        "name": "",
        "port": "",
        "x": 460,
        "y": 280,
        "wires": [ [ "debug-node" ] ]
    },
    {
        "id": "debug-node",
        "type": "debug",
        "z": "",
        "name": "",
        "active": true,
        "tosidebar": true,
        "console": false,
        "tostatus": false,
        "complete": "payload",
        "x": 730,
        "y": 280,
        "wires": []
    }
]

Nota: hay que asignarle el nodo modbusSerialConfig correspondiente al nodo Modbus-Serial Request después de importar (puerto serie, baudrate, y Forzar RTS si tu adaptador lo necesita).

msg.payload de entrada (Modbus-Serial Request)

Lectura:

{ "unitid": 30, "fc": 3, "address": 1, "quantity": 6 }

Escritura (un valor o un array):

{ "unitid": 30, "fc": 6, "address": 1, "value": 123 }

fc (function code):

| fc | Operación | |----|-----------| | 1 | Read Coils | | 2 | Read Discrete Inputs | | 3 | Read Holding Registers | | 4 | Read Input Registers | | 5 / 15 | Write Coil(s) | | 6 / 16 | Write Holding Register(s) |

Licencia

Apache-2.0 (heredada del proyecto original — ver LICENSE).