node-red-dashboard-2-state-inspector-energiam 0.1.0

Native Dashboard 2.0 widget for Node-RED — capture variable snapshots at different machine states and compare them side-by-side in a live table. Data-source agnostic, designed for IIoT state machine debugging.

npm install node-red-dashboard-2-state-inspector-energiam

State Inspector

node-red-dashboard-2-state-inspector-energiam

Native Dashboard 2.0 widget for Node-RED — freeze variable snapshots at different machine states and compare them side-by-side in a live dark-theme table. Built for IIoT state machine debugging.

What it does

Each message adds or updates a column in the table. Each key in valores becomes a row. Send one message per machine state and get an instant side-by-side comparison.

Inhabilitado   Habilitado   Rampa↑   Régimen
─────────────────────────────────────────────
enable   false      true      true     true
start    false     false      true     true
rampa    false     false      true    false
valorAct     0         0        43       50

Values are color-coded by type — no configuration required:

New variable keys are auto-discovered and added as rows on arrival. Columns accumulate up to the configured maximum, dropping the oldest (FIFO).

Requirements

Installation

Via Palette Manager — search for node-red-dashboard-2-state-inspector-energiam in
Menu → Manage Palette → Install.

Via npm:

cd ~/.node-red
npm install node-red-dashboard-2-state-inspector-energiam
# then restart Node-RED

Quick start

1. Place the node

Drag state inspector (category: EnergIAM) onto the canvas and assign it a Dashboard 2.0 group.

2. Send a snapshot

// Function node example
msg.payload = {
    nombre: "Habilitado",          // column header
    valores: {
        enable:      true,
        start:       false,
        objetivo:    50,
        valorActual: flow.get("valorActual")
    }
}
return msg

Each call to the node with a different nombre adds a new column.
Calling it again with the same nombre updates that column in-place.

3. Reset or remove columns

// Clear the whole table
msg.topic = "state-inspector/reset"

// Remove one column by name
msg.topic   = "state-inspector/remove"
msg.payload = { nombre: "Habilitado" }

// Same via payload.action
msg.payload = { action: "reset" }
msg.payload = { action: "remove", nombre: "Habilitado" }

Node configuration

Runtime settings — ⚙ gear panel

Click the ⚙ button in the widget toolbar to open the settings panel. Changes apply instantly and persist in localStorage.

Input message reference

Add / update a column
─────────────────────────────────────────────
msg.payload = {
    nombre:  string    // column label (required)
    valores: object    // flat key → value map (required)
}

Control messages
─────────────────────────────────────────────
msg.topic = "state-inspector/reset"           // clear all columns
msg.topic = "state-inspector/remove"          // remove column
msg.payload = { nombre: "ColumnName" }        //   ↑ column to remove

// Equivalent via payload.action:
msg.payload = { action: "reset" }
msg.payload = { action: "remove", nombre: "ColumnName" }

Node status indicators

Example flow

Import examples/flows_state_inspector_test.json via Menu → Import.

The example simulates a variable-speed drive cycling through four states:
Inhabilitado → Habilitado → Rampa↑ → Régimen — one inject button per state plus a RESET button.

Architecture

This is a first-class native Dashboard 2.0 widget, not a ui-template workaround.

Contributing

Issues and PRs are welcome at
github.com/energiamEcoTouch/node-red-dashboard-2-state-inspector-energiam

License

MIT © 2026 EnergIAM EcoTouch

Made with ☕ and monospace fonts by Adrian Iskow