node-red-contrib-originalpid 0.2.0

A simple and direct PID controller node for Node-RED, following the original Arduino-style PID implementation with Kp, Ki, Kd, and sampleTime.

npm install node-red-contrib-originalpid

Node-RED Original PID

npm install node-red-contrib-originalpid

A simple, “original” PID controller node for Node-RED — modeled after the classic Arduino PID implementation. Unlike other derived versions, this node exposes Kp, Ki, Kd, and sampleTime directly, giving you full control and predictable behavior.

Features

• True PID — directly uses Kp, Ki, Kd, and sampleTime

• Derivative on input to avoid setpoint kick

• Anti-windup for stable integral term

• Persistent state between restarts (using Node-RED context)

• Manual reset via { "reset": true } or { "restart": true }

• Status indicators:

  • Yellow → state reset / restored
  • Green → normal operation with live output and error

• No dependencies, minimal overhead

Example

Input:

{ "payload": 23.5 }

Output:

{ "payload": 0.62 }

Reset:

{ "reset": true }

When persistent context, called file, is enabled in settings.js:

contextStorage: {
    file: { module: "localfilesystem", config: { dir: "/data/context" } },
    default: { module: "memory" }
}

the node automatically restores its state (outputSum, lastInput, lastTime) after restart of nodered or after change of parameters, to avoid calculating it from clean slate.

Version history

v0.2.0 - Changing setpoint by input. v0.1.0 – Initial version published to github.