feat(mgc): editor defaults, compact status badge, mode-case fix, real example flows + dashboard
Editor (mgc.html)
- Drag-in defaults now expose mode (optimalControl) and scaling (normalized)
via dropdowns in the edit dialog. Was: no control fields in the UI at all,
so users had to send set.mode/set.scaling after deploy or live with the
hidden schema defaults.
Wire-up (src/nodeClass.js)
- buildDomainConfig now bridges the flat editor fields (mode, scaling) into
the nested schema shape (mode.current, scaling.current). Was: returned {}
so the editor's mode/scaling never reached the runtime.
Mode-case bug fix (src/specificClass.js)
- Schema enum values are camelCase (optimalControl, priorityControl) but the
runtime switch in _runDispatch matched lowercase only. With the default
config, dispatch silently fell through to the warning branch and nothing
ran. Normalise via String(this.mode).toLowerCase() so both forms work.
Status badge (src/io/output.js)
- Compacted from ~80 chars (mode | Ⓝ: 💨=Q/Qmax | ⚡=P | N machine(s)) to
~50 chars (mode | norm | Q=Q/Qmax m³/h | P=P kW | active/total x).
Drops emoji glyphs that rendered inconsistently across themes; uses the
same dot+fill convention as pumpingStation.
Output extension (src/io/output.js)
- getOutput() now also emits flowCapacityMin/Max, machineCount,
machineCountActive. Was: only group-level totals + dist-from-peak +
mode/scaling, so dashboards couldn't show capacity / active count
without subscribing to each rotatingMachine individually.
Examples
- Drop pre-refactor stubs (basic.flow.json, integration.flow.json,
edge.flow.json). They had a single MGC + inject + debug, no children,
and never dispatched anything.
- 01-Basic.json: 1 MGC + 3 rotatingMachine pumps + Setup once-fires
virtualControl + cmd.startup on all pumps via fan-out function. Numbered
driver groups for Control mode / Scaling / Operator demand. Pumps
register with MGC via Port 2 (child.register, automatic).
- 02-Dashboard.json: same plumbing + FlowFuse Dashboard 2.0 page with
Controls (mode + scaling buttons, demand slider 0–100, stop + init
buttons), Status (7 ui-text rows), Trends (3 charts: flow + capacity,
power, BEP rel %), and a raw-output ui-template dumping every Port 0
field. Fan-out function caches last-known values so deltas don't blank.
Wiki + README
- examples/README.md rewritten for the two-file set with canonical command
surface table and "what to try" recipes.
- wiki/Home.md §11 (Examples) updated; §14 #4 (TODO flow item) replaced
with the actual current limitation (no per-pump fan-out on Port 0).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
677
examples/01-Basic.json
Normal file
677
examples/01-Basic.json
Normal file
@@ -0,0 +1,677 @@
|
||||
[
|
||||
{
|
||||
"id": "tab_mgc_basic",
|
||||
"type": "tab",
|
||||
"label": "MGC - Basic",
|
||||
"disabled": false,
|
||||
"info": "Tier 1: one machineGroupControl (MGC) coordinating three rotatingMachine pumps. Setup once-fires virtualControl + cmd.startup on all three pumps; then operator demand drives the MGC, which dispatches per-pump flow setpoints."
|
||||
},
|
||||
{
|
||||
"id": "grp_mgc_unit",
|
||||
"type": "group",
|
||||
"z": "tab_mgc_basic",
|
||||
"name": "Machine Group (Unit)",
|
||||
"style": {
|
||||
"label": true,
|
||||
"stroke": "#000000",
|
||||
"fill": "#50a8d9",
|
||||
"fill-opacity": "0.10"
|
||||
},
|
||||
"nodes": [
|
||||
"mgc_basic_node"
|
||||
],
|
||||
"x": 974,
|
||||
"y": 359,
|
||||
"w": 152,
|
||||
"h": 122
|
||||
},
|
||||
{
|
||||
"id": "grp_pump_a",
|
||||
"type": "group",
|
||||
"z": "tab_mgc_basic",
|
||||
"name": "Pump A (Equipment)",
|
||||
"style": {
|
||||
"label": true,
|
||||
"stroke": "#000000",
|
||||
"fill": "#86bbdd",
|
||||
"fill-opacity": "0.10"
|
||||
},
|
||||
"nodes": [
|
||||
"rm_basic_pump_a"
|
||||
],
|
||||
"x": 694,
|
||||
"y": 199,
|
||||
"w": 142,
|
||||
"h": 82
|
||||
},
|
||||
{
|
||||
"id": "grp_pump_b",
|
||||
"type": "group",
|
||||
"z": "tab_mgc_basic",
|
||||
"name": "Pump B (Equipment)",
|
||||
"style": {
|
||||
"label": true,
|
||||
"stroke": "#000000",
|
||||
"fill": "#86bbdd",
|
||||
"fill-opacity": "0.10"
|
||||
},
|
||||
"nodes": [
|
||||
"rm_basic_pump_b"
|
||||
],
|
||||
"x": 694,
|
||||
"y": 379,
|
||||
"w": 142,
|
||||
"h": 82
|
||||
},
|
||||
{
|
||||
"id": "grp_pump_c",
|
||||
"type": "group",
|
||||
"z": "tab_mgc_basic",
|
||||
"name": "Pump C (Equipment)",
|
||||
"style": {
|
||||
"label": true,
|
||||
"stroke": "#000000",
|
||||
"fill": "#86bbdd",
|
||||
"fill-opacity": "0.10"
|
||||
},
|
||||
"nodes": [
|
||||
"rm_basic_pump_c"
|
||||
],
|
||||
"x": 694,
|
||||
"y": 559,
|
||||
"w": 142,
|
||||
"h": 82
|
||||
},
|
||||
{
|
||||
"id": "grp_drv_mode",
|
||||
"type": "group",
|
||||
"z": "tab_mgc_basic",
|
||||
"name": "1. Control mode",
|
||||
"style": {
|
||||
"stroke": "#666666",
|
||||
"fill": "#ffdf7f",
|
||||
"fill-opacity": "0.15",
|
||||
"label": true,
|
||||
"color": "#333333"
|
||||
},
|
||||
"nodes": [
|
||||
"inj_mode_optimal",
|
||||
"inj_mode_priority"
|
||||
],
|
||||
"x": 94,
|
||||
"y": 99,
|
||||
"w": 312,
|
||||
"h": 122
|
||||
},
|
||||
{
|
||||
"id": "grp_drv_scaling",
|
||||
"type": "group",
|
||||
"z": "tab_mgc_basic",
|
||||
"name": "2. Scaling",
|
||||
"style": {
|
||||
"stroke": "#666666",
|
||||
"fill": "#ffdf7f",
|
||||
"fill-opacity": "0.15",
|
||||
"label": true,
|
||||
"color": "#333333"
|
||||
},
|
||||
"nodes": [
|
||||
"inj_scaling_norm",
|
||||
"inj_scaling_abs"
|
||||
],
|
||||
"x": 94,
|
||||
"y": 259,
|
||||
"w": 312,
|
||||
"h": 122
|
||||
},
|
||||
{
|
||||
"id": "grp_drv_demand",
|
||||
"type": "group",
|
||||
"z": "tab_mgc_basic",
|
||||
"name": "3. Operator demand (% of group capacity)",
|
||||
"style": {
|
||||
"stroke": "#666666",
|
||||
"fill": "#ffdf7f",
|
||||
"fill-opacity": "0.15",
|
||||
"label": true,
|
||||
"color": "#333333"
|
||||
},
|
||||
"nodes": [
|
||||
"inj_demand_25",
|
||||
"inj_demand_50",
|
||||
"inj_demand_75",
|
||||
"inj_demand_100",
|
||||
"inj_demand_0"
|
||||
],
|
||||
"x": 94,
|
||||
"y": 419,
|
||||
"w": 312,
|
||||
"h": 222
|
||||
},
|
||||
{
|
||||
"id": "grp_setup",
|
||||
"type": "group",
|
||||
"z": "tab_mgc_basic",
|
||||
"name": "Setup — once on deploy",
|
||||
"style": {
|
||||
"stroke": "#666666",
|
||||
"fill": "#dddddd",
|
||||
"fill-opacity": "0.20",
|
||||
"label": true,
|
||||
"color": "#333333"
|
||||
},
|
||||
"nodes": [
|
||||
"inj_setup_start",
|
||||
"fn_setup_fanout"
|
||||
],
|
||||
"x": 94,
|
||||
"y": 679,
|
||||
"w": 532,
|
||||
"h": 82
|
||||
},
|
||||
{
|
||||
"id": "grp_dbg",
|
||||
"type": "group",
|
||||
"z": "tab_mgc_basic",
|
||||
"name": "Debug outputs (sidebar)",
|
||||
"style": {
|
||||
"stroke": "#666666",
|
||||
"fill": "#d1d1d1",
|
||||
"fill-opacity": "0.2",
|
||||
"label": true,
|
||||
"color": "#333333"
|
||||
},
|
||||
"nodes": [
|
||||
"dbg_port0",
|
||||
"dbg_port1",
|
||||
"dbg_port2"
|
||||
],
|
||||
"x": 1234,
|
||||
"y": 339,
|
||||
"w": 232,
|
||||
"h": 202
|
||||
},
|
||||
{
|
||||
"id": "cmt_title",
|
||||
"type": "comment",
|
||||
"z": "tab_mgc_basic",
|
||||
"name": "MGC — Basic (Tier 1)",
|
||||
"info": "One machineGroupControl coordinating three rotatingMachine pumps.\n\nDefaults: mode=optimalControl, scaling=normalized.\n\nSETUP — fires once on deploy\n- Switches all 3 pumps to virtualControl mode\n- Sends cmd.startup to all 3 pumps\nPumps register with the MGC automatically via Port 2 (child.register).\n\nHOW TO USE\n1. Deploy — the Setup group auto-runs after ~1.5 s, putting pumps in virtual + started.\n2. Click any \"set.demand = N %\" — MGC dispatches per-pump flow setpoints by BEP-gravitation (default) or priority list, depending on the mode.\n3. Switch scaling to `absolute` to interpret set.demand as m³/h instead of %.\n4. Switch mode to `priorityControl` for sequential equal-flow control; `optimalControl` (default) picks the best combination automatically.\n5. Send `set.demand = 0` to drain the group (turnOffAllMachines).\n\nPORTS (MGC)\n- Port 0: process output (mode, scaling, totals, dist-from-peak)\n- Port 1: InfluxDB-shaped payload\n- Port 2: parent-registration handshake (when wired into a pumpingStation)",
|
||||
"x": 1100,
|
||||
"y": 280,
|
||||
"wires": []
|
||||
},
|
||||
{
|
||||
"id": "inj_mode_optimal",
|
||||
"type": "inject",
|
||||
"z": "tab_mgc_basic",
|
||||
"g": "grp_drv_mode",
|
||||
"name": "set.mode = optimalControl",
|
||||
"props": [
|
||||
{ "p": "topic", "vt": "str" },
|
||||
{ "p": "payload", "v": "optimalControl", "vt": "str" }
|
||||
],
|
||||
"repeat": "",
|
||||
"crontab": "",
|
||||
"once": false,
|
||||
"onceDelay": "",
|
||||
"topic": "set.mode",
|
||||
"x": 260,
|
||||
"y": 140,
|
||||
"wires": [
|
||||
[
|
||||
"mgc_basic_node"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "inj_mode_priority",
|
||||
"type": "inject",
|
||||
"z": "tab_mgc_basic",
|
||||
"g": "grp_drv_mode",
|
||||
"name": "set.mode = priorityControl",
|
||||
"props": [
|
||||
{ "p": "topic", "vt": "str" },
|
||||
{ "p": "payload", "v": "priorityControl", "vt": "str" }
|
||||
],
|
||||
"repeat": "",
|
||||
"crontab": "",
|
||||
"once": false,
|
||||
"onceDelay": "",
|
||||
"topic": "set.mode",
|
||||
"x": 260,
|
||||
"y": 180,
|
||||
"wires": [
|
||||
[
|
||||
"mgc_basic_node"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "inj_scaling_norm",
|
||||
"type": "inject",
|
||||
"z": "tab_mgc_basic",
|
||||
"g": "grp_drv_scaling",
|
||||
"name": "set.scaling = normalized",
|
||||
"props": [
|
||||
{ "p": "topic", "vt": "str" },
|
||||
{ "p": "payload", "v": "normalized", "vt": "str" }
|
||||
],
|
||||
"repeat": "",
|
||||
"crontab": "",
|
||||
"once": false,
|
||||
"onceDelay": "",
|
||||
"topic": "set.scaling",
|
||||
"x": 260,
|
||||
"y": 300,
|
||||
"wires": [
|
||||
[
|
||||
"mgc_basic_node"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "inj_scaling_abs",
|
||||
"type": "inject",
|
||||
"z": "tab_mgc_basic",
|
||||
"g": "grp_drv_scaling",
|
||||
"name": "set.scaling = absolute",
|
||||
"props": [
|
||||
{ "p": "topic", "vt": "str" },
|
||||
{ "p": "payload", "v": "absolute", "vt": "str" }
|
||||
],
|
||||
"repeat": "",
|
||||
"crontab": "",
|
||||
"once": false,
|
||||
"onceDelay": "",
|
||||
"topic": "set.scaling",
|
||||
"x": 260,
|
||||
"y": 340,
|
||||
"wires": [
|
||||
[
|
||||
"mgc_basic_node"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "inj_demand_0",
|
||||
"type": "inject",
|
||||
"z": "tab_mgc_basic",
|
||||
"g": "grp_drv_demand",
|
||||
"name": "set.demand = 0 (stop)",
|
||||
"props": [
|
||||
{ "p": "topic", "vt": "str" },
|
||||
{ "p": "payload", "v": "0", "vt": "num" }
|
||||
],
|
||||
"repeat": "",
|
||||
"crontab": "",
|
||||
"once": false,
|
||||
"onceDelay": "",
|
||||
"topic": "set.demand",
|
||||
"x": 260,
|
||||
"y": 460,
|
||||
"wires": [
|
||||
[
|
||||
"mgc_basic_node"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "inj_demand_25",
|
||||
"type": "inject",
|
||||
"z": "tab_mgc_basic",
|
||||
"g": "grp_drv_demand",
|
||||
"name": "set.demand = 25 %",
|
||||
"props": [
|
||||
{ "p": "topic", "vt": "str" },
|
||||
{ "p": "payload", "v": "25", "vt": "num" }
|
||||
],
|
||||
"repeat": "",
|
||||
"crontab": "",
|
||||
"once": false,
|
||||
"onceDelay": "",
|
||||
"topic": "set.demand",
|
||||
"x": 260,
|
||||
"y": 500,
|
||||
"wires": [
|
||||
[
|
||||
"mgc_basic_node"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "inj_demand_50",
|
||||
"type": "inject",
|
||||
"z": "tab_mgc_basic",
|
||||
"g": "grp_drv_demand",
|
||||
"name": "set.demand = 50 %",
|
||||
"props": [
|
||||
{ "p": "topic", "vt": "str" },
|
||||
{ "p": "payload", "v": "50", "vt": "num" }
|
||||
],
|
||||
"repeat": "",
|
||||
"crontab": "",
|
||||
"once": false,
|
||||
"onceDelay": "",
|
||||
"topic": "set.demand",
|
||||
"x": 260,
|
||||
"y": 540,
|
||||
"wires": [
|
||||
[
|
||||
"mgc_basic_node"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "inj_demand_75",
|
||||
"type": "inject",
|
||||
"z": "tab_mgc_basic",
|
||||
"g": "grp_drv_demand",
|
||||
"name": "set.demand = 75 %",
|
||||
"props": [
|
||||
{ "p": "topic", "vt": "str" },
|
||||
{ "p": "payload", "v": "75", "vt": "num" }
|
||||
],
|
||||
"repeat": "",
|
||||
"crontab": "",
|
||||
"once": false,
|
||||
"onceDelay": "",
|
||||
"topic": "set.demand",
|
||||
"x": 260,
|
||||
"y": 580,
|
||||
"wires": [
|
||||
[
|
||||
"mgc_basic_node"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "inj_demand_100",
|
||||
"type": "inject",
|
||||
"z": "tab_mgc_basic",
|
||||
"g": "grp_drv_demand",
|
||||
"name": "set.demand = 100 %",
|
||||
"props": [
|
||||
{ "p": "topic", "vt": "str" },
|
||||
{ "p": "payload", "v": "100", "vt": "num" }
|
||||
],
|
||||
"repeat": "",
|
||||
"crontab": "",
|
||||
"once": false,
|
||||
"onceDelay": "",
|
||||
"topic": "set.demand",
|
||||
"x": 260,
|
||||
"y": 620,
|
||||
"wires": [
|
||||
[
|
||||
"mgc_basic_node"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "inj_setup_start",
|
||||
"type": "inject",
|
||||
"z": "tab_mgc_basic",
|
||||
"g": "grp_setup",
|
||||
"name": "Auto-start pumps",
|
||||
"props": [
|
||||
{ "p": "payload", "v": "go", "vt": "str" }
|
||||
],
|
||||
"repeat": "",
|
||||
"crontab": "",
|
||||
"once": true,
|
||||
"onceDelay": "1.5",
|
||||
"topic": "",
|
||||
"x": 220,
|
||||
"y": 720,
|
||||
"wires": [
|
||||
[
|
||||
"fn_setup_fanout"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "fn_setup_fanout",
|
||||
"type": "function",
|
||||
"z": "tab_mgc_basic",
|
||||
"g": "grp_setup",
|
||||
"name": "fan-out: virtualControl + startup → A/B/C",
|
||||
"func": "// Fire two messages per pump: set.mode = virtualControl, then cmd.startup.\n// Each output is a message array — Node-RED dispatches them sequentially.\nconst setMode = { topic: 'set.mode', payload: 'virtualControl' };\nconst startup = { topic: 'cmd.startup', payload: {} };\nreturn [\n [setMode, startup], // → Pump A\n [setMode, startup], // → Pump B\n [setMode, startup], // → Pump C\n];\n",
|
||||
"outputs": 3,
|
||||
"timeout": 0,
|
||||
"noerr": 0,
|
||||
"initialize": "",
|
||||
"finalize": "",
|
||||
"libs": [],
|
||||
"x": 480,
|
||||
"y": 720,
|
||||
"wires": [
|
||||
[
|
||||
"rm_basic_pump_a"
|
||||
],
|
||||
[
|
||||
"rm_basic_pump_b"
|
||||
],
|
||||
[
|
||||
"rm_basic_pump_c"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "rm_basic_pump_a",
|
||||
"type": "rotatingMachine",
|
||||
"z": "tab_mgc_basic",
|
||||
"g": "grp_pump_a",
|
||||
"name": "Pump A",
|
||||
"speed": "1",
|
||||
"startup": "2",
|
||||
"warmup": "1",
|
||||
"shutdown": "2",
|
||||
"cooldown": "1",
|
||||
"movementMode": "staticspeed",
|
||||
"machineCurve": "",
|
||||
"uuid": "mgc-basic-pump-a",
|
||||
"supplier": "hidrostal",
|
||||
"category": "pump",
|
||||
"assetType": "pump-centrifugal",
|
||||
"model": "hidrostal-H05K-S03R",
|
||||
"unit": "m3/h",
|
||||
"curvePressureUnit": "mbar",
|
||||
"curveFlowUnit": "m3/h",
|
||||
"curvePowerUnit": "kW",
|
||||
"curveControlUnit": "%",
|
||||
"enableLog": false,
|
||||
"logLevel": "info",
|
||||
"positionVsParent": "atEquipment",
|
||||
"positionIcon": "",
|
||||
"hasDistance": false,
|
||||
"distance": "",
|
||||
"distanceUnit": "m",
|
||||
"distanceDescription": "",
|
||||
"x": 760,
|
||||
"y": 240,
|
||||
"wires": [
|
||||
[],
|
||||
[],
|
||||
[
|
||||
"mgc_basic_node"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "rm_basic_pump_b",
|
||||
"type": "rotatingMachine",
|
||||
"z": "tab_mgc_basic",
|
||||
"g": "grp_pump_b",
|
||||
"name": "Pump B",
|
||||
"speed": "1",
|
||||
"startup": "2",
|
||||
"warmup": "1",
|
||||
"shutdown": "2",
|
||||
"cooldown": "1",
|
||||
"movementMode": "staticspeed",
|
||||
"machineCurve": "",
|
||||
"uuid": "mgc-basic-pump-b",
|
||||
"supplier": "hidrostal",
|
||||
"category": "pump",
|
||||
"assetType": "pump-centrifugal",
|
||||
"model": "hidrostal-H05K-S03R",
|
||||
"unit": "m3/h",
|
||||
"curvePressureUnit": "mbar",
|
||||
"curveFlowUnit": "m3/h",
|
||||
"curvePowerUnit": "kW",
|
||||
"curveControlUnit": "%",
|
||||
"enableLog": false,
|
||||
"logLevel": "info",
|
||||
"positionVsParent": "atEquipment",
|
||||
"positionIcon": "",
|
||||
"hasDistance": false,
|
||||
"distance": "",
|
||||
"distanceUnit": "m",
|
||||
"distanceDescription": "",
|
||||
"x": 760,
|
||||
"y": 420,
|
||||
"wires": [
|
||||
[],
|
||||
[],
|
||||
[
|
||||
"mgc_basic_node"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "rm_basic_pump_c",
|
||||
"type": "rotatingMachine",
|
||||
"z": "tab_mgc_basic",
|
||||
"g": "grp_pump_c",
|
||||
"name": "Pump C",
|
||||
"speed": "1",
|
||||
"startup": "2",
|
||||
"warmup": "1",
|
||||
"shutdown": "2",
|
||||
"cooldown": "1",
|
||||
"movementMode": "staticspeed",
|
||||
"machineCurve": "",
|
||||
"uuid": "mgc-basic-pump-c",
|
||||
"supplier": "hidrostal",
|
||||
"category": "pump",
|
||||
"assetType": "pump-centrifugal",
|
||||
"model": "hidrostal-H05K-S03R",
|
||||
"unit": "m3/h",
|
||||
"curvePressureUnit": "mbar",
|
||||
"curveFlowUnit": "m3/h",
|
||||
"curvePowerUnit": "kW",
|
||||
"curveControlUnit": "%",
|
||||
"enableLog": false,
|
||||
"logLevel": "info",
|
||||
"positionVsParent": "atEquipment",
|
||||
"positionIcon": "",
|
||||
"hasDistance": false,
|
||||
"distance": "",
|
||||
"distanceUnit": "m",
|
||||
"distanceDescription": "",
|
||||
"x": 760,
|
||||
"y": 600,
|
||||
"wires": [
|
||||
[],
|
||||
[],
|
||||
[
|
||||
"mgc_basic_node"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "mgc_basic_node",
|
||||
"type": "machineGroupControl",
|
||||
"z": "tab_mgc_basic",
|
||||
"g": "grp_mgc_unit",
|
||||
"name": "Machine Group",
|
||||
"processOutputFormat": "process",
|
||||
"dbaseOutputFormat": "influxdb",
|
||||
"mode": "optimalControl",
|
||||
"scaling": "normalized",
|
||||
"uuid": "",
|
||||
"supplier": "",
|
||||
"category": "",
|
||||
"assetType": "",
|
||||
"model": "",
|
||||
"unit": "",
|
||||
"enableLog": false,
|
||||
"logLevel": "info",
|
||||
"positionVsParent": "atEquipment",
|
||||
"positionIcon": "",
|
||||
"hasDistance": false,
|
||||
"distance": "",
|
||||
"distanceUnit": "m",
|
||||
"distanceDescription": "",
|
||||
"x": 1050,
|
||||
"y": 420,
|
||||
"wires": [
|
||||
[
|
||||
"dbg_port0"
|
||||
],
|
||||
[
|
||||
"dbg_port1"
|
||||
],
|
||||
[
|
||||
"dbg_port2"
|
||||
]
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "dbg_port0",
|
||||
"type": "debug",
|
||||
"z": "tab_mgc_basic",
|
||||
"g": "grp_dbg",
|
||||
"name": "Port 0: Process",
|
||||
"active": true,
|
||||
"tosidebar": true,
|
||||
"console": false,
|
||||
"tostatus": false,
|
||||
"complete": "payload",
|
||||
"targetType": "msg",
|
||||
"x": 1340,
|
||||
"y": 380,
|
||||
"wires": []
|
||||
},
|
||||
{
|
||||
"id": "dbg_port1",
|
||||
"type": "debug",
|
||||
"z": "tab_mgc_basic",
|
||||
"g": "grp_dbg",
|
||||
"name": "Port 1: InfluxDB",
|
||||
"active": true,
|
||||
"tosidebar": true,
|
||||
"console": false,
|
||||
"tostatus": false,
|
||||
"complete": "true",
|
||||
"targetType": "full",
|
||||
"x": 1340,
|
||||
"y": 440,
|
||||
"wires": []
|
||||
},
|
||||
{
|
||||
"id": "dbg_port2",
|
||||
"type": "debug",
|
||||
"z": "tab_mgc_basic",
|
||||
"g": "grp_dbg",
|
||||
"name": "Port 2: Parent reg",
|
||||
"active": true,
|
||||
"tosidebar": true,
|
||||
"console": false,
|
||||
"tostatus": false,
|
||||
"complete": "true",
|
||||
"targetType": "full",
|
||||
"x": 1350,
|
||||
"y": 500,
|
||||
"wires": []
|
||||
},
|
||||
{
|
||||
"id": "mgc_global_cfg",
|
||||
"type": "global-config",
|
||||
"env": [],
|
||||
"modules": {
|
||||
"EVOLV": "1.0.29"
|
||||
}
|
||||
}
|
||||
]
|
||||
1205
examples/02-Dashboard.json
Normal file
1205
examples/02-Dashboard.json
Normal file
File diff suppressed because it is too large
Load Diff
@@ -1,8 +1,51 @@
|
||||
# machineGroupControl Example Flows
|
||||
# machineGroupControl - Example Flows
|
||||
|
||||
Import-ready Node-RED examples for machineGroupControl.
|
||||
Import-ready Node-RED examples for `machineGroupControl` (MGC). MGC is not a standalone node — it needs at least one `rotatingMachine` child to dispatch demand to. Both flows below ship three child pumps.
|
||||
|
||||
## Files
|
||||
- basic.flow.json
|
||||
- integration.flow.json
|
||||
- edge.flow.json
|
||||
|
||||
| File | Tier | What it shows |
|
||||
|---|---|---|
|
||||
| `01-Basic.json` | 1 | One MGC + three `rotatingMachine` pumps driven by inject buttons. Setup once-fires `virtualControl` + `cmd.startup` on all three pumps; mode / scaling / demand are then driven by buttons. |
|
||||
| `02-Dashboard.json` | 2 | Same command surface driven by a FlowFuse Dashboard 2.0 page — mode + scaling buttons, demand slider, live status rows, three trend charts, and a raw-output table. |
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- Node-RED with the EVOLV package installed (`machineGroupControl` and `rotatingMachine` registered).
|
||||
- For `02-Dashboard.json`: `@flowfuse/node-red-dashboard` (Dashboard 2.0).
|
||||
|
||||
## Load a flow
|
||||
|
||||
```bash
|
||||
curl -X POST -H 'Content-Type: application/json' \
|
||||
--data @nodes/machineGroupControl/examples/01-Basic.json \
|
||||
http://localhost:1880/flows
|
||||
```
|
||||
|
||||
Or in the editor: Menu → Import → drag the file → Import.
|
||||
|
||||
## Canonical command surface
|
||||
|
||||
| Topic | Aliases | Payload | What it does |
|
||||
|---|---|---|---|
|
||||
| `set.mode` | `setMode` | `"optimalControl"`, `"priorityControl"`, `"prioritypercentagecontrol"`, `"maintenance"` | Switch dispatch strategy |
|
||||
| `set.scaling` | `setScaling` | `"normalized"`, `"absolute"` | Interpret demand as 0–100 % vs m³/h |
|
||||
| `set.demand` | `Qd` | number | Operator demand setpoint |
|
||||
| `child.register` | `registerChild` | child node id (string) | Manually register a child (Port 2 wiring does this automatically) |
|
||||
|
||||
## 01-Basic — what to try
|
||||
|
||||
1. Deploy. After ~1.5 s the Setup group auto-fires, putting all three pumps in `virtualControl` mode + sending `cmd.startup` to each.
|
||||
2. Click `set.demand = 50 %` — MGC's `optimalControl` picks the best pump combination by BEP-gravitation and dispatches `flowmovement` to the selected pumps.
|
||||
3. Click `set.demand = 100 %` — MGC switches to a higher combination, possibly engaging an extra pump.
|
||||
4. Switch mode to `priorityControl` and try the same demands — pumps now run equal-flow by priority order.
|
||||
5. Switch scaling to `absolute` — set.demand is now interpreted as m³/h (capped at the group min / max).
|
||||
6. `set.demand = 0` — MGC calls `turnOffAllMachines`, all pumps shut down.
|
||||
|
||||
## 02-Dashboard — what to try
|
||||
|
||||
1. Deploy → open `http://localhost:1880/dashboard/mgc-basic`.
|
||||
2. The dashboard auto-initialises the pumps; the `Initialize pumps` button on the page re-runs the setup manually.
|
||||
3. Drag the **Demand** slider — MGC dispatches and the Flow / Power / BEP charts react.
|
||||
4. Switch modes and scalings via the buttons; the Mode / Scaling rows in the Status panel reflect the change.
|
||||
5. Inspect the **Raw output** table for the full Port 0 surface (every field MGC emits, including `flowCapacityMax`, `machineCountActive`, `absDistFromPeak`, `relDistFromPeak`).
|
||||
|
||||
@@ -1,6 +0,0 @@
|
||||
[
|
||||
{"id":"machineGroupControl_basic_tab","type":"tab","label":"machineGroupControl basic","disabled":false,"info":"machineGroupControl basic example"},
|
||||
{"id":"machineGroupControl_basic_node","type":"machineGroupControl","z":"machineGroupControl_basic_tab","name":"machineGroupControl basic","x":420,"y":180,"wires":[["machineGroupControl_basic_dbg"]]},
|
||||
{"id":"machineGroupControl_basic_inj","type":"inject","z":"machineGroupControl_basic_tab","name":"basic trigger","props":[{"p":"topic","vt":"str"},{"p":"payload","vt":"str"}],"topic":"ping","payload":"1","payloadType":"str","x":160,"y":180,"wires":[["machineGroupControl_basic_node"]]},
|
||||
{"id":"machineGroupControl_basic_dbg","type":"debug","z":"machineGroupControl_basic_tab","name":"machineGroupControl basic debug","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","x":660,"y":180,"wires":[]}
|
||||
]
|
||||
@@ -1,6 +0,0 @@
|
||||
[
|
||||
{"id":"machineGroupControl_edge_tab","type":"tab","label":"machineGroupControl edge","disabled":false,"info":"machineGroupControl edge example"},
|
||||
{"id":"machineGroupControl_edge_node","type":"machineGroupControl","z":"machineGroupControl_edge_tab","name":"machineGroupControl edge","x":420,"y":180,"wires":[["machineGroupControl_edge_dbg"]]},
|
||||
{"id":"machineGroupControl_edge_inj","type":"inject","z":"machineGroupControl_edge_tab","name":"unknown topic","props":[{"p":"topic","vt":"str"},{"p":"payload","vt":"str"}],"topic":"doesNotExist","payload":"x","payloadType":"str","x":170,"y":180,"wires":[["machineGroupControl_edge_node"]]},
|
||||
{"id":"machineGroupControl_edge_dbg","type":"debug","z":"machineGroupControl_edge_tab","name":"machineGroupControl edge debug","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","x":660,"y":180,"wires":[]}
|
||||
]
|
||||
@@ -1,6 +0,0 @@
|
||||
[
|
||||
{"id":"machineGroupControl_int_tab","type":"tab","label":"machineGroupControl integration","disabled":false,"info":"machineGroupControl integration example"},
|
||||
{"id":"machineGroupControl_int_node","type":"machineGroupControl","z":"machineGroupControl_int_tab","name":"machineGroupControl integration","x":420,"y":180,"wires":[["machineGroupControl_int_dbg"]]},
|
||||
{"id":"machineGroupControl_int_inj","type":"inject","z":"machineGroupControl_int_tab","name":"registerChild","props":[{"p":"topic","vt":"str"},{"p":"payload","vt":"str"}],"topic":"registerChild","payload":"example-child-id","payloadType":"str","x":170,"y":180,"wires":[["machineGroupControl_int_node"]]},
|
||||
{"id":"machineGroupControl_int_dbg","type":"debug","z":"machineGroupControl_int_tab","name":"machineGroupControl integration debug","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","x":680,"y":180,"wires":[]}
|
||||
]
|
||||
Reference in New Issue
Block a user