e47de87adb
- 5 descriptors -> unit: shorthand (cmd.calibrate.volume/level, set.inflow/ outflow/demand). - setInflow/setOutflow: drop the hand-rolled scalar-vs-object parsing — the registry now normalises every shape to a number in the descriptor unit; the handlers become guarded one-liners (matching setDemand). - Regenerate wiki topic-contract + command-envelope note (msg.origin). 143/143 tests green. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
69 lines
2.2 KiB
JavaScript
69 lines
2.2 KiB
JavaScript
'use strict';
|
|
|
|
// pumpingStation command registry. Consumed by BaseNodeAdapter via
|
|
// `static commands = require('./commands')`. Each descriptor maps a
|
|
// canonical msg.topic to its handler; legacy names are listed under
|
|
// `aliases` and emit a one-time deprecation warning at runtime.
|
|
|
|
const handlers = require('./handlers');
|
|
|
|
module.exports = [
|
|
{
|
|
topic: 'set.mode',
|
|
aliases: ['changemode'],
|
|
payloadSchema: { type: 'string' },
|
|
description: 'Switch the station between auto / manual control modes.',
|
|
handler: handlers.setMode,
|
|
},
|
|
{
|
|
topic: 'child.register',
|
|
aliases: ['registerChild'],
|
|
// payload is the Node-RED id (string) of the child node.
|
|
payloadSchema: { type: 'string' },
|
|
description: 'Register a child node (machine group, measurement, …) with this station.',
|
|
handler: handlers.registerChild,
|
|
},
|
|
{
|
|
topic: 'cmd.calibrate.volume',
|
|
aliases: ['calibratePredictedVolume'],
|
|
// any: payload may be a number, numeric string, or { value, unit } object —
|
|
// the registry normalises all of them to a number in `unit` before the handler.
|
|
payloadSchema: { type: 'any' },
|
|
unit: 'm3',
|
|
description: 'Calibrate the predicted-volume integrator to a known basin volume.',
|
|
handler: handlers.calibrateVolume,
|
|
},
|
|
{
|
|
topic: 'cmd.calibrate.level',
|
|
aliases: ['calibratePredictedLevel'],
|
|
payloadSchema: { type: 'any' },
|
|
unit: 'm',
|
|
description: 'Calibrate the predicted-volume integrator to a known basin level.',
|
|
handler: handlers.calibrateLevel,
|
|
},
|
|
{
|
|
topic: 'set.inflow',
|
|
aliases: ['q_in'],
|
|
payloadSchema: { type: 'any' },
|
|
unit: 'm3/h',
|
|
description: 'Push a measured inflow value into the basin balance.',
|
|
handler: handlers.setInflow,
|
|
},
|
|
{
|
|
topic: 'set.outflow',
|
|
aliases: ['q_out'],
|
|
payloadSchema: { type: 'any' },
|
|
unit: 'm3/h',
|
|
description: 'Push a measured outflow value into the basin balance.',
|
|
handler: handlers.setOutflow,
|
|
},
|
|
{
|
|
topic: 'set.demand',
|
|
aliases: ['Qd'],
|
|
payloadSchema: { type: 'any' },
|
|
unit: 'm3/h',
|
|
description: 'Operator outflow demand setpoint for the station.',
|
|
handler: handlers.setDemand,
|
|
},
|
|
];
|