node-red-contrib-s2 0.1.3 → 0.2.0

package/dist/nodes/s2-ombc/index.js

@@ -0,0 +1,153 @@
+"use strict";
+const messages_1 = require("../../lib/s2/messages");
+const PERSISTED_STATUS_KEY_PREFIX = 's2OmbcStatus:';
+module.exports = function (RED) {
+    function S2OmbcNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+        const ombcConfigNode = RED.nodes.getNode(config.ombcConfig);
+        if (!ombcConfigNode) {
+            node.error('s2-ombc-config node is missing - please configure an OMBC System Description');
+            node.status({ fill: 'red', shape: 'dot', text: 'config missing' });
+            return;
+        }
+        let systemDescription = { operationModes: [], transitions: [], timers: [] };
+        if (ombcConfigNode.systemDescription) {
+            try {
+                systemDescription = JSON.parse(ombcConfigNode.systemDescription);
+            }
+            catch (e) {
+                node.error('Invalid OMBC System Description JSON: ' + e.message);
+            }
+        }
+        const cemStates = new Map();
+        function getOrCreateState(cemId) {
+            let state = cemStates.get(cemId);
+            if (!state) {
+                state = { selectedControlType: null };
+                cemStates.set(cemId, state);
+            }
+            return state;
+        }
+        function getPersistedStatus(cemId) {
+            return node.context().get(PERSISTED_STATUS_KEY_PREFIX + cemId) || null;
+        }
+        function setPersistedStatus(cemId, status) {
+            node.context().set(PERSISTED_STATUS_KEY_PREFIX + cemId, status);
+        }
+        function resolveMode(rawInstr) {
+            var _a;
+            const modeId = (rawInstr.operation_mode_id || rawInstr.operation_mode);
+            if (!modeId)
+                return null;
+            const factor = typeof rawInstr.operation_mode_factor === 'number' ? rawInstr.operation_mode_factor : 1;
+            const modes = systemDescription.operationModes;
+            const modeIndex = (_a = modes === null || modes === void 0 ? void 0 : modes.findIndex(m => m.id === modeId)) !== null && _a !== void 0 ? _a : -1;
+            const mode = modeIndex >= 0 ? modes[modeIndex] : undefined;
+            return {
+                id: modeId,
+                index: modeIndex,
+                label: (mode === null || mode === void 0 ? void 0 : mode.diagnostic_label) || modeId,
+                factor,
+                powerRanges: (mode === null || mode === void 0 ? void 0 : mode.power_ranges) || []
+            };
+        }
+        function handleInstruction(msg) {
+            if (msg.controlType !== messages_1.ControlType.OMBC) {
+                node.status({ fill: 'yellow', shape: 'ring', text: `ignoring ${String(msg.controlType)} instruction` });
+                node.send([msg, null]);
+                return;
+            }
+            const rawInstr = (msg.ombc || msg.payload);
+            const resolved = resolveMode(rawInstr);
+            const outMsg = { ...msg };
+            if (resolved) {
+                outMsg.topic = resolved.label;
+                outMsg.ombc = { ...(msg.ombc || {}), operationMode: resolved };
+                node.status({ fill: 'green', shape: 'dot', text: resolved.label });
+            }
+            node.send([outMsg, null]);
+        }
+        function handleSelectControlType(msg) {
+            const cemId = msg.cemId;
+            if (!cemId)
+                return;
+            const payload = msg.payload;
+            const controlType = payload.control_type;
+            getOrCreateState(cemId).selectedControlType = controlType;
+            if (controlType !== messages_1.ControlType.OMBC)
+                return;
+            node.send([null, { payload: { command: 'SystemDescription', cemId, controlType: messages_1.ControlType.OMBC, ombc: systemDescription } }]);
+            const persisted = getPersistedStatus(cemId);
+            if (persisted) {
+                node.send([null, { payload: { command: 'UpdateStatus', cemId, controlType: messages_1.ControlType.OMBC, ombc: persisted } }]);
+            }
+        }
+        function handleConfirm(msg, done) {
+            const cemId = msg.cemId;
+            const payload = msg.payload;
+            const modeId = payload.confirmedOperationModeId;
+            if (!cemId || !modeId) {
+                done(new Error('Confirm message requires cemId and payload.confirmedOperationModeId'));
+                return;
+            }
+            const state = getOrCreateState(cemId);
+            if (state.selectedControlType !== messages_1.ControlType.OMBC) {
+                node.status({ fill: 'yellow', shape: 'ring', text: 'OMBC not selected - confirm ignored' });
+                done();
+                return;
+            }
+            const factor = payload.operationModeFactor;
+            const previous = getPersistedStatus(cemId);
+            let status = {
+                activeOperationModeId: modeId,
+                operationModeFactor: typeof factor === 'number' ? factor : 1
+            };
+            if (previous && previous.activeOperationModeId !== modeId) {
+                status = {
+                    ...status,
+                    previousOperationModeId: previous.activeOperationModeId,
+                    transitionTimestamp: new Date().toISOString()
+                };
+            }
+            setPersistedStatus(cemId, status);
+            node.status({ fill: 'green', shape: 'dot', text: `confirmed: ${modeId}` });
+            node.send([null, { payload: { command: 'UpdateStatus', cemId, controlType: messages_1.ControlType.OMBC, ombc: status } }]);
+            done();
+        }
+        node.status({ fill: 'grey', shape: 'ring', text: 'idle' });
+        node.on('input', (msg, _send, done) => {
+            const cemId = msg.cemId;
+            const topic = msg.topic;
+            if (topic === 'Disconnected' && cemId) {
+                const state = cemStates.get(cemId);
+                if (state)
+                    state.selectedControlType = null;
+                done();
+                return;
+            }
+            const payload = msg.payload;
+            if (!payload || typeof payload !== 'object') {
+                done();
+                return;
+            }
+            if ('confirmedOperationModeId' in payload) {
+                handleConfirm(msg, done);
+                return;
+            }
+            if ('controlType' in msg) {
+                handleInstruction(msg);
+                done();
+                return;
+            }
+            if (payload.message_type === messages_1.MessageType.SELECT_CONTROL_TYPE) {
+                handleSelectControlType(msg);
+                done();
+                return;
+            }
+            done();
+        });
+    }
+    RED.nodes.registerType('s2-ombc', S2OmbcNode);
+};
+//# sourceMappingURL=index.js.map

package/dist/nodes/s2-ombc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/nodes/s2-ombc/index.ts"],"names":[],"mappings":"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"}

package/dist/nodes/s2-ombc-config/index.d.ts

@@ -0,0 +1,3 @@
+import { NodeRedApp } from '../../types/node-red';
+declare const _default: (RED: NodeRedApp) => void;
+export = _default;

package/dist/nodes/s2-ombc-config/index.html

@@ -0,0 +1,428 @@
+<script src="resources/node-red-contrib-s2/s2-common.js"></script>
+<script type="text/javascript">
+  (function () {
+    function generateUuid () {
+      return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+        var r = Math.random() * 16 | 0
+        return (c === 'x' ? r : (r & 0x3 | 0x8)).toString(16)
+      })
+    }
+
+    // Every configured mode able to transition to every other configured mode,
+    // with no timers - the fully-connected graph friendly mode always assumes.
+    function buildTransitions (modeIds) {
+      var transitions = []
+      for (var i = 0; i < modeIds.length; i++) {
+        for (var j = 0; j < modeIds.length; j++) {
+          if (i === j) continue
+          transitions.push({
+            id: generateUuid(),
+            from: modeIds[i],
+            to: modeIds[j],
+            start_timers: [],
+            blocking_timers: [],
+            abnormal_condition_only: false
+          })
+        }
+      }
+      return transitions
+    }
+
+    function friendlyStateToSystemDescription (modes) {
+      var operationModes = modes.map(function (m) {
+        var powerRanges
+        if (m.symmetric) {
+          powerRanges = [{
+            commodity_quantity: 'ELECTRIC.POWER.3_PHASE_SYMMETRIC',
+            start_of_range: m.valueSymmetric,
+            end_of_range: m.valueSymmetric
+          }]
+        } else {
+          powerRanges = [
+            { commodity_quantity: 'ELECTRIC.POWER.L1', start_of_range: m.valueL1, end_of_range: m.valueL1 },
+            { commodity_quantity: 'ELECTRIC.POWER.L2', start_of_range: m.valueL2, end_of_range: m.valueL2 },
+            { commodity_quantity: 'ELECTRIC.POWER.L3', start_of_range: m.valueL3, end_of_range: m.valueL3 }
+          ]
+        }
+        return {
+          id: m.id,
+          diagnostic_label: m.label,
+          power_ranges: powerRanges,
+          abnormal_condition_only: !!m.abnormalConditionOnly
+        }
+      })
+      return {
+        operationModes: operationModes,
+        transitions: buildTransitions(operationModes.map(function (m) { return m.id })),
+        timers: []
+      }
+    }
+
+    function isFriendlyPowerRanges (ranges) {
+      if (!Array.isArray(ranges)) return false
+      if (ranges.length === 1) {
+        var r = ranges[0]
+        return !!r && r.commodity_quantity === 'ELECTRIC.POWER.3_PHASE_SYMMETRIC' &&
+          typeof r.start_of_range === 'number' && r.start_of_range === r.end_of_range
+      }
+      if (ranges.length === 3) {
+        var byCq = {}
+        for (var i = 0; i < ranges.length; i++) {
+          var rr = ranges[i]
+          if (!rr || typeof rr.start_of_range !== 'number' || rr.start_of_range !== rr.end_of_range) return false
+          byCq[rr.commodity_quantity] = rr.start_of_range
+        }
+        return ('ELECTRIC.POWER.L1' in byCq) && ('ELECTRIC.POWER.L2' in byCq) && ('ELECTRIC.POWER.L3' in byCq)
+      }
+      return false
+    }
+
+    // Strict structural check: true only when systemDescription is exactly what
+    // friendly mode itself would produce, so switching modes never silently
+    // narrows something Advanced mode expresses that friendly mode can't.
+    function isFriendlyRepresentable (sysDesc) {
+      if (!sysDesc || typeof sysDesc !== 'object') return false
+      var modes = sysDesc.operationModes
+      if (!Array.isArray(modes) || modes.length === 0) return false
+
+      var modeIds = []
+      for (var i = 0; i < modes.length; i++) {
+        var m = modes[i]
+        if (!m || typeof m.id !== 'string' || !m.id || modeIds.indexOf(m.id) !== -1) return false
+        if (!isFriendlyPowerRanges(m.power_ranges)) return false
+        modeIds.push(m.id)
+      }
+
+      var transitions = sysDesc.transitions
+      if (!Array.isArray(transitions) || transitions.length !== modeIds.length * (modeIds.length - 1)) return false
+
+      var seenPairs = {}
+      for (var j = 0; j < transitions.length; j++) {
+        var t = transitions[j]
+        if (!t || modeIds.indexOf(t.from) === -1 || modeIds.indexOf(t.to) === -1 || t.from === t.to) return false
+        if (!Array.isArray(t.start_timers) || t.start_timers.length !== 0) return false
+        if (!Array.isArray(t.blocking_timers) || t.blocking_timers.length !== 0) return false
+        if (t.abnormal_condition_only) return false
+        var key = t.from + '>' + t.to
+        if (seenPairs[key]) return false
+        seenPairs[key] = true
+      }
+      for (var a = 0; a < modeIds.length; a++) {
+        for (var b = 0; b < modeIds.length; b++) {
+          if (a === b) continue
+          if (!seenPairs[modeIds[a] + '>' + modeIds[b]]) return false
+        }
+      }
+
+      var timers = sysDesc.timers
+      return Array.isArray(timers) && timers.length === 0
+    }
+
+    // Only called after isFriendlyRepresentable has passed.
+    function systemDescriptionToFriendlyState (sysDesc) {
+      return sysDesc.operationModes.map(function (m) {
+        var ranges = m.power_ranges
+        if (ranges.length === 1) {
+          return {
+            id: m.id,
+            protected: false,
+            label: m.diagnostic_label || '',
+            abnormalConditionOnly: !!m.abnormal_condition_only,
+            symmetric: true,
+            valueSymmetric: ranges[0].start_of_range,
+            valueL1: 0,
+            valueL2: 0,
+            valueL3: 0
+          }
+        }
+        var byCq = {}
+        ranges.forEach(function (r) { byCq[r.commodity_quantity] = r.start_of_range })
+        return {
+          id: m.id,
+          protected: false,
+          label: m.diagnostic_label || '',
+          abnormalConditionOnly: !!m.abnormal_condition_only,
+          symmetric: false,
+          valueSymmetric: 0,
+          valueL1: byCq['ELECTRIC.POWER.L1'],
+          valueL2: byCq['ELECTRIC.POWER.L2'],
+          valueL3: byCq['ELECTRIC.POWER.L3']
+        }
+      })
+    }
+
+    function defaultStandbyMode () {
+      return {
+        id: generateUuid(),
+        protected: true,
+        label: 'Standby/off',
+        abnormalConditionOnly: false,
+        symmetric: true,
+        valueSymmetric: 0,
+        valueL1: 0,
+        valueL2: 0,
+        valueL3: 0
+      }
+    }
+
+    RED.nodes.registerType('s2-ombc-config', {
+      category: 'config',
+      defaults: {
+        name: { value: '' },
+        systemDescription: { value: '' }
+      },
+      label: function () {
+        return this.name || 's2-ombc-config'
+      },
+      oneditprepare: function () {
+        var listSel = '#s2-ombc-mode-list'
+        var currentMode = 'friendly'
+
+        $('#node-config-input-systemDescription').typedInput({ types: ['json'] })
+
+        function addModeItem (container, index, opt) {
+          opt = opt || {}
+          if (!opt.id) opt.id = generateUuid()
+          // Node-RED's default editableList item content is `display:grid;
+          // grid-template-columns:50% 50%`, which grid-places our two rows into
+          // separate 50%-wide columns instead of stacking them - override back
+          // to a normal block flow (core nodes like `switch` do the same thing
+          // to get their own single-row flex layout instead of the grid default).
+          container.css({ overflow: 'visible', display: 'block' })
+
+          var row1 = $('<div/>', { class: 's2-ombc-mode-row' }).appendTo(container)
+          $('<input/>', { type: 'text', class: 's2-ombc-mode-label', placeholder: 'Mode label' })
+            .val(opt.label || '')
+            .appendTo(row1)
+
+          var row1b = $('<div/>', { class: 's2-ombc-mode-row' }).appendTo(container)
+          var abnormalLabel = $('<label/>', { class: 's2-ombc-mode-checkbox-label' }).appendTo(row1b)
+          $('<input/>', { type: 'checkbox', class: 's2-ombc-mode-abnormal' })
+            .prop('checked', !!opt.abnormalConditionOnly)
+            .appendTo(abnormalLabel)
+          abnormalLabel.append(' Abnormal only')
+
+          var row2 = $('<div/>', { class: 's2-ombc-mode-row' }).appendTo(container)
+          var symLabel = $('<label/>', { class: 's2-ombc-mode-checkbox-label' }).appendTo(row2)
+          var symCheckbox = $('<input/>', { type: 'checkbox', class: 's2-ombc-mode-symmetric' })
+            .prop('checked', opt.symmetric !== false)
+            .appendTo(symLabel)
+          symLabel.append(' Same value on all phases')
+
+          var row3 = $('<div/>', { class: 's2-ombc-mode-row' }).appendTo(container)
+          var symWrap = $('<span/>', { class: 's2-ombc-mode-value-wrap' }).appendTo(row3)
+          var symValue = $('<input/>', { type: 'number', class: 's2-ombc-mode-value-sym', step: '1' })
+            .val(opt.valueSymmetric != null ? opt.valueSymmetric : 0)
+            .appendTo(symWrap)
+          symWrap.append($('<span/>', { class: 's2-unit-label' }).text('W'))
+
+          var phaseWrap = $('<span/>', { class: 's2-ombc-mode-value-wrap' }).appendTo(row3)
+          phaseWrap.append('L1 ')
+          var l1 = $('<input/>', { type: 'number', class: 's2-ombc-mode-value-l1', step: '1' }).val(opt.valueL1 || 0).appendTo(phaseWrap)
+          phaseWrap.append(' L2 ')
+          var l2 = $('<input/>', { type: 'number', class: 's2-ombc-mode-value-l2', step: '1' }).val(opt.valueL2 || 0).appendTo(phaseWrap)
+          phaseWrap.append(' L3 ')
+          var l3 = $('<input/>', { type: 'number', class: 's2-ombc-mode-value-l3', step: '1' }).val(opt.valueL3 || 0).appendTo(phaseWrap)
+          phaseWrap.append($('<span/>', { class: 's2-unit-label' }).text('W'))
+
+          function updateSymVisibility () {
+            if (symCheckbox.prop('checked')) {
+              symWrap.show()
+              phaseWrap.hide()
+            } else {
+              symWrap.hide()
+              phaseWrap.show()
+            }
+          }
+          symCheckbox.on('change', updateSymVisibility)
+          updateSymVisibility()
+
+          if (opt.protected) {
+            $('<div/>', { class: 's2-ombc-mode-protected-note' }).text('Always present - remove via Advanced mode if not needed.').appendTo(container)
+          }
+        }
+
+        $(listSel).css('min-height', '320px').css('min-width', '480px').editableList({
+          addItem: addModeItem,
+          removeItem: function (opt) {
+            // Protected rows can't be removed through the list's own control -
+            // restore it. (Still removable by hand-editing Advanced/JSON mode.)
+            if (opt && opt.protected) {
+              $(listSel).editableList('addItem', opt)
+            }
+          },
+          removable: true,
+          sortable: true
+        })
+
+        function getFriendlyModes () {
+          var modes = []
+          $(listSel).editableList('items').each(function () {
+            var $item = $(this)
+            var data = $item.data('data') || {}
+            modes.push({
+              id: data.id,
+              protected: !!data.protected,
+              label: $item.find('.s2-ombc-mode-label').val(),
+              abnormalConditionOnly: $item.find('.s2-ombc-mode-abnormal').prop('checked'),
+              symmetric: $item.find('.s2-ombc-mode-symmetric').prop('checked'),
+              valueSymmetric: Number($item.find('.s2-ombc-mode-value-sym').val()) || 0,
+              valueL1: Number($item.find('.s2-ombc-mode-value-l1').val()) || 0,
+              valueL2: Number($item.find('.s2-ombc-mode-value-l2').val()) || 0,
+              valueL3: Number($item.find('.s2-ombc-mode-value-l3').val()) || 0
+            })
+          })
+          return modes
+        }
+
+        function showFriendlySection () {
+          currentMode = 'friendly'
+          $('#s2-ombc-friendly-section').show()
+          $('#s2-ombc-advanced-section').hide()
+          $('#s2-ombc-advanced-warning').hide()
+          $('#s2-ombc-tab-friendly').addClass('s2-ombc-tab-active')
+          $('#s2-ombc-tab-advanced').removeClass('s2-ombc-tab-active')
+        }
+
+        function showAdvancedSection (warningText) {
+          currentMode = 'advanced'
+          $('#s2-ombc-friendly-section').hide()
+          $('#s2-ombc-advanced-section').show()
+          if (warningText) {
+            $('#s2-ombc-advanced-warning').text(warningText).show()
+          } else {
+            $('#s2-ombc-advanced-warning').hide()
+          }
+          $('#s2-ombc-tab-advanced').addClass('s2-ombc-tab-active')
+          $('#s2-ombc-tab-friendly').removeClass('s2-ombc-tab-active')
+        }
+
+        $('#s2-ombc-tab-advanced').on('click', function (e) {
+          e.preventDefault()
+          if (currentMode === 'advanced') return
+          var sysDesc = friendlyStateToSystemDescription(getFriendlyModes())
+          $('#node-config-input-systemDescription').typedInput('value', JSON.stringify(sysDesc, null, 2))
+          showAdvancedSection()
+        })
+
+        $('#s2-ombc-tab-friendly').on('click', function (e) {
+          e.preventDefault()
+          if (currentMode === 'friendly') return
+          var raw = $('#node-config-input-systemDescription').typedInput('value')
+          var parsed
+          try {
+            parsed = JSON.parse(raw)
+          } catch (err) {
+            showAdvancedSection('Invalid JSON - fix it before switching to the friendly editor.')
+            return
+          }
+          if (!isFriendlyRepresentable(parsed)) {
+            showAdvancedSection('This system description uses something only Advanced mode supports (a genuine power range, a non-standard commodity, a blocked transition, or a timer) - continue editing it here.')
+            return
+          }
+          $(listSel).editableList('empty')
+          systemDescriptionToFriendlyState(parsed).forEach(function (m) {
+            $(listSel).editableList('addItem', m)
+          })
+          showFriendlySection()
+        })
+
+        var raw = this.systemDescription
+        var parsed = null
+        if (raw) {
+          try { parsed = JSON.parse(raw) } catch (e) { parsed = null }
+        }
+
+        if (!raw) {
+          $(listSel).editableList('addItem', defaultStandbyMode())
+          showFriendlySection()
+        } else if (parsed && isFriendlyRepresentable(parsed)) {
+          systemDescriptionToFriendlyState(parsed).forEach(function (m) {
+            $(listSel).editableList('addItem', m)
+          })
+          showFriendlySection()
+        } else {
+          $('#node-config-input-systemDescription').typedInput('value', raw)
+          showAdvancedSection()
+        }
+
+        window.__s2Common.initializeTooltips()
+      },
+      oneditsave: function () {
+        // Only friendly mode needs an explicit save step - Advanced mode's JSON
+        // typedInput already holds the value that gets read automatically.
+        var $list = $('#s2-ombc-mode-list')
+        if ($('#s2-ombc-tab-friendly').hasClass('s2-ombc-tab-active') && $list.length) {
+          var modes = []
+          $list.editableList('items').each(function () {
+            var $item = $(this)
+            var data = $item.data('data') || {}
+            modes.push({
+              id: data.id,
+              label: $item.find('.s2-ombc-mode-label').val(),
+              abnormalConditionOnly: $item.find('.s2-ombc-mode-abnormal').prop('checked'),
+              symmetric: $item.find('.s2-ombc-mode-symmetric').prop('checked'),
+              valueSymmetric: Number($item.find('.s2-ombc-mode-value-sym').val()) || 0,
+              valueL1: Number($item.find('.s2-ombc-mode-value-l1').val()) || 0,
+              valueL2: Number($item.find('.s2-ombc-mode-value-l2').val()) || 0,
+              valueL3: Number($item.find('.s2-ombc-mode-value-l3').val()) || 0
+            })
+          })
+          var sysDesc = friendlyStateToSystemDescription(modes)
+          $('#node-config-input-systemDescription').typedInput('value', JSON.stringify(sysDesc, null, 2))
+        }
+      }
+    })
+  })()
+</script>
+
+<script type="text/html" data-template-name="s2-ombc-config">
+  <div class="s2-form">
+
+    <div class="form-row">
+      <label for="node-config-input-name"><i class="fa fa-tag"></i> Name</label>
+      <input type="text" id="node-config-input-name" placeholder="Name (optional)">
+    </div>
+
+    <div class="form-row">
+      <label class="s2-section-label"><i class="fa fa-list"></i> System Description<i class="fa fa-info-circle tooltip-icon" data-tooltip="OMBC.SystemDescription: the operation modes this device can be in, and how it can transition between them. Sent to the CEM by s2-ombc once OMBC is the selected control type. Friendly mode covers the common case (fixed-power modes, every mode able to transition to every other); switch to Advanced for anything else - a genuine power range, a non-standard commodity, a blocked transition, or a timer."></i></label>
+    </div>
+
+    <div class="form-row s2-full-row">
+      <div class="s2-ombc-tabs">
+        <a href="#" id="s2-ombc-tab-friendly" class="s2-ombc-tab s2-ombc-tab-active">Friendly</a>
+        <a href="#" id="s2-ombc-tab-advanced" class="s2-ombc-tab">Advanced (JSON)</a>
+      </div>
+    </div>
+
+    <div id="s2-ombc-friendly-section" class="form-row s2-full-row">
+      <ol id="s2-ombc-mode-list"></ol>
+    </div>
+
+    <div id="s2-ombc-advanced-section" class="form-row s2-full-row" style="display:none;">
+      <div id="s2-ombc-advanced-warning" class="s2-ombc-advanced-warning" style="display:none;"></div>
+      <input type="text" id="node-config-input-systemDescription">
+    </div>
+
+  </div>
+</script>
+
+<script type="text/html" data-help-name="s2-ombc-config">
+  <p>Configuration for <b>s2-ombc</b>: the OMBC system description (operation modes and how the device can transition between them). Sent to the CEM by <b>s2-ombc</b> once the CEM has selected Operation Mode Based Control.</p>
+
+  <h3>Friendly mode</h3>
+  <p>Covers the common case: a list of operation modes, each with a diagnostic label, an optional "abnormal condition only" flag, and a fixed power level (the same value on all three phases, or a separate value per phase). Every mode is assumed able to transition to every other mode - there is no separate step to define transitions.</p>
+  <p>A "Standby/off" mode is always present and can't be removed from the list itself (use Advanced mode if you genuinely don't want one). Add further modes with the "add" button below the list.</p>
+
+  <h3>Advanced (JSON) mode</h3>
+  <p>The raw <code>OMBC.SystemDescription</code> JSON (<code>operationModes</code>, <code>transitions</code>, <code>timers</code>), for anything friendly mode doesn't cover:</p>
+  <ul>
+    <li>a genuine power range (a mode whose lower and upper bound differ, rather than one fixed value)</li>
+    <li>a commodity quantity other than 3-phase-symmetric or per-phase L1/L2/L3</li>
+    <li>blocking a specific transition, rather than every mode being able to reach every other mode</li>
+    <li>a timer (<code>start_timers</code>/<code>blocking_timers</code> on a transition)</li>
+  </ul>
+  <p>Switching from Friendly to Advanced converts the current modes to JSON. Switching back only works if the JSON still matches what friendly mode can represent (fixed-power modes, every mode transitioning to every other, no timers) - otherwise the editor stays in Advanced mode and explains why, rather than discarding anything.</p>
+</script>
+
+<link rel="stylesheet" href="resources/node-red-contrib-s2/s2-styles.css">

package/dist/nodes/s2-ombc-config/index.js

@@ -0,0 +1,9 @@
+"use strict";
+module.exports = function (RED) {
+    function S2OmbcConfigNodeConstructor(config) {
+        RED.nodes.createNode(this, config);
+        this.systemDescription = config.systemDescription;
+    }
+    RED.nodes.registerType('s2-ombc-config', S2OmbcConfigNodeConstructor);
+};
+//# sourceMappingURL=index.js.map

package/dist/nodes/s2-ombc-config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/nodes/s2-ombc-config/index.ts"],"names":[],"mappings":";AAGA,iBAAS,UAAU,GAAe;IAChC,SAAS,2BAA2B,CAA0B,MAAkB;QAC9E,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAClC,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,iBAA2B,CAAA;IAC7D,CAAC;IAED,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,gBAAgB,EAAE,2BAA2B,CAAC,CAAA;AACvE,CAAC,CAAA"}

package/dist/nodes/s2-pebc/icons/s2-logo.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 1042 1042" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;">
+    <g transform="matrix(1,0,0,1,-312,-142)">
+        <g transform="matrix(1038.75,-1038.75,-1038.75,-1038.75,314.531,1181.19)">
+            <path d="M0.75,0.251C0.739,0.262 0.727,0.272 0.715,0.281C0.708,0.286 0.701,0.291 0.694,0.296C0.65,0.325 0.6,0.344 0.549,0.351C0.516,0.356 0.482,0.356 0.449,0.351C0.398,0.344 0.348,0.325 0.303,0.296C0.284,0.283 0.265,0.268 0.248,0.251C0.22,0.223 0.22,0.178 0.248,0.15C0.276,0.123 0.321,0.123 0.348,0.15C0.366,0.168 0.386,0.182 0.407,0.192C0.465,0.22 0.533,0.22 0.591,0.192C0.612,0.182 0.632,0.168 0.649,0.15L0.758,0.042C0.773,0.027 0.789,0.015 0.806,0.006C0.821,-0.003 0.837,-0.009 0.853,-0.013C0.902,-0.026 0.954,-0.022 1,-0L0.75,0.251ZM0.525,0.115C0.499,0.112 0.482,0.097 0.474,0.088C0.465,0.078 0.466,0.062 0.477,0.052C0.487,0.043 0.503,0.044 0.513,0.054C0.515,0.057 0.521,0.063 0.531,0.064C0.541,0.065 0.551,0.061 0.557,0.052C0.564,0.042 0.564,0.026 0.556,0.016C0.549,0.008 0.538,0.006 0.535,0.005L0.33,-0.014L0.447,-0.132C0.457,-0.142 0.474,-0.142 0.483,-0.132C0.493,-0.122 0.493,-0.106 0.483,-0.096L0.443,-0.055L0.541,-0.045C0.551,-0.044 0.577,-0.039 0.596,-0.015C0.618,0.013 0.619,0.052 0.599,0.081C0.596,0.085 0.593,0.089 0.59,0.092C0.573,0.109 0.549,0.118 0.525,0.115ZM0.649,-0.15C0.632,-0.168 0.612,-0.182 0.591,-0.192C0.533,-0.22 0.465,-0.22 0.407,-0.192C0.386,-0.182 0.366,-0.168 0.348,-0.15L0.24,-0.042C0.225,-0.027 0.209,-0.015 0.192,-0.006C0.177,0.003 0.161,0.009 0.145,0.013C0.096,0.026 0.044,0.022 -0.003,0L0.248,-0.251C0.259,-0.262 0.271,-0.272 0.282,-0.281C0.289,-0.286 0.296,-0.291 0.303,-0.296C0.348,-0.325 0.398,-0.344 0.449,-0.351C0.482,-0.356 0.516,-0.356 0.549,-0.351C0.6,-0.344 0.65,-0.325 0.694,-0.296C0.714,-0.283 0.732,-0.268 0.75,-0.251C0.777,-0.223 0.777,-0.178 0.75,-0.15C0.722,-0.123 0.677,-0.123 0.649,-0.15Z" style="fill:url(#s2logo-gradient);fill-rule:nonzero;"/>
+        </g>
+    </g>
+    <defs>
+        <linearGradient id="s2logo-gradient" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(1,0,0,-1,0,3.73045e-07)">
+            <stop offset="0" style="stop-color:rgb(45,19,75);stop-opacity:1"/>
+            <stop offset="0.37" style="stop-color:rgb(25,38,101);stop-opacity:1"/>
+            <stop offset="1" style="stop-color:rgb(17,88,163);stop-opacity:1"/>
+        </linearGradient>
+    </defs>
+</svg>