/** * Encapsulates all node logic in a reusable class. In future updates we can split this into multiple generic classes and use the config to specifiy which ones to use. * This allows us to keep the Node-RED node clean and focused on wiring up the UI and event handlers. */ const { outputUtils, configManager } = require('generalFunctions'); const Specific = require("./specificClass"); class nodeClass { /** * Create a MeasurementNode. * @param {object} uiConfig - Node-RED node configuration. * @param {object} RED - Node-RED runtime API. * @param {object} nodeInstance - The Node-RED node instance. * @param {string} nameOfNode - The name of the node, used for */ constructor(uiConfig, RED, nodeInstance, nameOfNode) { // Preserve RED reference for HTTP endpoints if needed this.node = nodeInstance; this.RED = RED; this.name = nameOfNode; this.source = null; // Will hold the specific class instance this.config = null; // Will hold the merged configuration // Load default & UI config this._loadConfig(uiConfig,this.node); // Instantiate core Measurement class this._setupSpecificClass(uiConfig); // Wire up event and lifecycle handlers this._bindEvents(); this._registerChild(); this._startTickLoop(); this._attachInputHandler(); this._attachCloseHandler(); } /** * Load and merge default config with user-defined settings. * @param {object} uiConfig - Raw config from Node-RED UI. */ _loadConfig(uiConfig,node) { // Merge UI config over defaults this.config = { general: { name: uiConfig.name, id: node.id, // node.id is for the child registration process unit: uiConfig.unit, // add converter options later to convert to default units (need like a model that defines this which units we are going to use and then conver to those standards) logging: { enabled: uiConfig.enableLog, logLevel: uiConfig.logLevel } }, asset: { uuid: uiConfig.assetUuid, //need to add this later to the asset model tagCode: uiConfig.assetTagCode, //need to add this later to the asset model supplier: uiConfig.supplier, category: uiConfig.category, //add later to define as the software type type: uiConfig.assetType, model: uiConfig.model, unit: uiConfig.unit }, functionality: { positionVsParent: uiConfig.positionVsParent || 'atEquipment', // Default to 'atEquipment' if not specified } }; // Utility for formatting outputs this._output = new outputUtils(); } /** * Instantiate the core logic and store as source. */ _setupSpecificClass(uiConfig) { const vconfig = this.config; // need extra state for this const stateConfig = { general: { logging: { enabled: vconfig.eneableLog, logLevel: vconfig.logLevel } }, movement: { speed: Number(uiConfig.speed) }, time: { starting: Number(uiConfig.startup), warmingup: Number(uiConfig.warmup), stopping: Number(uiConfig.shutdown), coolingdown: Number(uiConfig.cooldown) } }; this.source = new Specific(vconfig, stateConfig); //store in node this.node.source = this.source; // Store the source in the node instance for easy access } /** * Bind Measurement events to Node-RED status updates. Using internal emitter. --> REMOVE LATER WE NEED ONLY COMPLETE CHILDS AND THEN CHECK FOR UPDATES */ _bindEvents() { } _updateNodeStatus() { const v = this.source; try { const mode = v.currentMode; // modus is bijv. auto, manual, etc. const state = v.state.getCurrentState(); //is bijv. operational, idle, off, etc. // check if measured flow is available otherwise use predicted flow const flow = Math.round(v.measurements.type("flow").variant("predicted").position("downstream").getCurrentValue()); let deltaP = v.measurements.type("pressure").variant("predicted").position("delta").getCurrentValue(); if (deltaP !== null) { deltaP = parseFloat(deltaP.toFixed(0)); } //afronden op 4 decimalen indien geen "null" if(isNaN(deltaP)) { deltaP = "∞"; } const roundedPosition = Math.round(v.state.getCurrentPosition() * 100) / 100; let symbolState; switch(state){ case "off": symbolState = "⬛"; break; case "idle": symbolState = "⏸️"; break; case "operational": symbolState = "⏵️"; break; case "starting": symbolState = "⏯️"; break; case "warmingup": symbolState = "🔄"; break; case "accelerating": symbolState = "⏩"; break; case "stopping": symbolState = "⏹️"; break; case "coolingdown": symbolState = "❄️"; break; case "decelerating": symbolState = "⏪"; break; } let status; switch (state) { case "off": status = { fill: "red", shape: "dot", text: `${mode}: OFF` }; break; case "idle": status = { fill: "blue", shape: "dot", text: `${mode}: ${symbolState}` }; break; case "operational": status = { fill: "green", shape: "dot", text: `${mode}: ${symbolState} | ${roundedPosition}% | 💨${flow}m³/h | ΔP${deltaP} mbar`}; //deltaP toegevoegd break; case "starting": status = { fill: "yellow", shape: "dot", text: `${mode}: ${symbolState}` }; break; case "warmingup": status = { fill: "green", shape: "dot", text: `${mode}: ${symbolState} | ${roundedPosition}% | 💨${flow}m³/h | ΔP${deltaP} mbar`}; //deltaP toegevoegd break; case "accelerating": status = { fill: "yellow", shape: "dot", text: `${mode}: ${symbolState} | ${roundedPosition}% | 💨${flow}m³/h | ΔP${deltaP} mbar` }; //deltaP toegevoegd break; case "stopping": status = { fill: "yellow", shape: "dot", text: `${mode}: ${symbolState}` }; break; case "coolingdown": status = { fill: "yellow", shape: "dot", text: `${mode}: ${symbolState}` }; break; case "decelerating": status = { fill: "yellow", shape: "dot", text: `${mode}: ${symbolState} - ${roundedPosition}% | 💨${flow}m³/h | ΔP${deltaP} mbar`}; //deltaP toegevoegd break; default: status = { fill: "grey", shape: "dot", text: `${mode}: ${symbolState}` }; } return status; } catch (error) { node.error("Error in updateNodeStatus: " + error.message); return { fill: "red", shape: "ring", text: "Status Error" }; } } /** * Register this node as a child upstream and downstream. * Delayed to avoid Node-RED startup race conditions. */ _registerChild() { setTimeout(() => { this.node.send([ null, null, { topic: 'registerChild', payload: this.node.id , positionVsParent: this.config?.functionality?.positionVsParent || 'atEquipment' }, ]); }, 100); } /** * Start the periodic tick loop. */ _startTickLoop() { setTimeout(() => { this._tickInterval = setInterval(() => this._tick(), 1000); // Update node status on nodered screen every second ( this is not the best way to do this, but it works for now) this._statusInterval = setInterval(() => { const status = this._updateNodeStatus(); this.node.status(status); }, 1000); }, 1000); } /** * Execute a single tick: update measurement, format and send outputs. */ _tick() { //this.source.tick(); const raw = this.source.getOutput(); const processMsg = this._output.formatMsg(raw, this.config, 'process'); const influxMsg = this._output.formatMsg(raw, this.config, 'influxdb'); // Send only updated outputs on ports 0 & 1 this.node.send([processMsg, influxMsg]); } /** * Attach the node's input handler, routing control messages to the class. */ _attachInputHandler() { this.node.on('input', (msg, send, done) => { const v = this.source; switch(msg.topic) { case 'registerChild': const childId = msg.payload; const childObj = this.RED.nodes.getNode(childId); v.childRegistrationUtils.registerChild(childObj.source ,msg.positionVsParent); break; case 'setMode': v.setMode(msg.payload); break; case 'execSequence': const { source: seqSource, action: seqAction, parameter } = msg.payload; v.handleInput(seqSource, seqAction, parameter); break; case 'execMovement': const { source: mvSource, action: mvAction, setpoint } = msg.payload; v.handleInput(mvSource, mvAction, Number(setpoint)); break; case 'emergencystop': const { source: esSource, action: esAction } = msg.payload; v.handleInput(esSource, esAction); break; case 'showcurve': v.showCurve(); send({ topic : "Showing curve" , payload: v.showCurve() }); break; case 'updateFlow': //Als nieuwe flow van header node dan moet deltaP weer opnieuw worden berekend en doorgegeven aan header node v.updateFlow(msg.payload.variant, msg.payload.value, msg.payload.position); } done(); }); } /** * Clean up timers and intervals when Node-RED stops the node. */ _attachCloseHandler() { this.node.on('close', (done) => { clearInterval(this._tickInterval); clearInterval(this._statusInterval); done(); }); } } module.exports = nodeClass;