node-red-contrib-dmx-for-ha 0.1.0

package/nodes/ha-mqtt-button.html

@@ -0,0 +1,326 @@
+<!-- ============================================================
+     ha-mqtt-button — Button Node Editor
+     Package: node-red-contrib-dmx-for-ha
+     Author:  DeSwaggy — Discord: @deswaggy
+     ============================================================ -->
+
+<script type="text/javascript">
+
+    RED.nodes.registerType('ha-mqtt-button', {
+        category:     'DMX for HA',
+        color:        '#27ae60',
+        icon:         'font-awesome/fa-hand-pointer-o',
+        inputs:       1,
+        outputs:      0,
+        inputLabels:  ['Input'],
+        paletteLabel: 'Button',
+
+        defaults: {
+            name:           { value: '' },
+            config:         { value: '', type: 'ha-mqtt-config', required: true },
+            // Identity
+            uid:            { value: '',    required: true },
+            uidPostfix:     { value: '' },
+            // Location
+            area:           { value: 'Area 52' },
+            situation:      { value: 'in' },
+            subLocation:    { value: '' },
+            // Button specifics
+            buttonPosition: { value: '' },
+            buttonPayload:  { value: '',    required: true },
+            subscribeTopic: { value: 'buttons' },
+            // Options
+            haIcon:         { value: 'mdi:gesture-tap-button' },
+            ledColor:       { value: 'Blue' },
+            holdTime:       { value: '0.5' },
+        },
+
+        label: function () {
+            if (this.name) return this.name;
+            const id      = this.uid        || '?';
+            const postfix = this.uidPostfix || '';
+            return 'S-' + id + postfix;
+        },
+
+        labelStyle: function () {
+            return this.name ? 'node_label_italic' : '';
+        },
+
+        oneditprepare: function () {
+            const node = this;
+            const areas = [
+                { v: 'Area 52',             l: 'TBC' },
+                { v: 'Attic Roof',          l: 'Attic Roof' },
+                { v: 'Backyard',            l: 'Backyard' },
+                { v: 'Balcony',             l: 'Balcony' },
+                { v: 'Bathroom',            l: 'Bathroom' },
+                { v: 'Bedroom 1',           l: 'Bedroom 1' },
+                { v: 'Bedroom 2',           l: 'Bedroom 2' },
+                { v: 'Bedroom 3',           l: 'Bedroom 3' },
+                { v: 'Bedroom 4',           l: 'Bedroom 4' },
+                { v: 'Carport',             l: 'Carport' },
+                { v: 'Cellar',              l: 'Cellar' },
+                { v: 'Dining',              l: 'Dining' },
+                { v: 'Driveway',            l: 'Driveway' },
+                { v: 'Entry',               l: 'Entry' },
+                { v: 'Garage',              l: 'Garage' },
+                { v: 'Gym',                 l: 'Gym' },
+                { v: 'Hallway',             l: 'Hallway' },
+                { v: 'Kitchen',             l: 'Kitchen' },
+                { v: 'Laundry',             l: 'Laundry' },
+                { v: 'Link Bridge (Upper)', l: 'Link Bridge Upper' },
+                { v: 'Link Bridge (Lower)', l: 'Link Bridge Lower' },
+                { v: 'Living',              l: 'Living' },
+                { v: 'Media',               l: 'Media' },
+                { v: 'Office',              l: 'Office' },
+                { v: 'Pantry',              l: 'Pantry' },
+                { v: 'Pass Over',           l: 'Pass Over' },
+                { v: 'Pass Under',          l: 'Pass Under' },
+                { v: 'Passageway',          l: 'Passageway' },
+                { v: 'Pool',                l: 'Pool' },
+                { v: 'Portico',             l: 'Portico' },
+                { v: 'PowderRoom',          l: 'PowderRoom' },
+                { v: 'Reading',             l: 'Reading' },
+                { v: 'Rumpus',              l: 'Rumpus' },
+                { v: 'Spa',                 l: 'Spa' },
+                { v: 'Stairs',              l: 'Stairs' },
+                { v: 'Store',               l: 'Store' },
+                { v: 'SubFloor',            l: 'SubFloor' },
+                { v: 'Terrace',             l: 'Terrace' },
+            ];
+            const subAreas = [
+                { v: '',              l: 'None' },
+                { v: 'Balcony',       l: 'Balcony' },
+                { v: 'Bed (North)',   l: 'Bed North' },
+                { v: 'Bed (South)',   l: 'Bed South' },
+                { v: 'Bed (East)',    l: 'Bed East' },
+                { v: 'Bed (West)',    l: 'Bed West' },
+                { v: 'Ceiling',       l: 'Ceiling' },
+                { v: 'Dress',         l: 'Dress' },
+                { v: 'Ensuite',       l: 'Ensuite' },
+                { v: 'Exterior',      l: 'Exterior' },
+                { v: 'Ground Floor',  l: 'Ground Floor' },
+                { v: '1st Floor',     l: '1st Floor' },
+                { v: 'Landing',       l: 'Landing' },
+                { v: 'Office',        l: 'Office' },
+                { v: 'Stairs',        l: 'Stairs' },
+                { v: 'WIR',           l: 'WIR' },
+                { v: '(North)',        l: 'North' },
+                { v: '(South)',        l: 'South' },
+                { v: '(East)',         l: 'East' },
+                { v: '(West)',         l: 'West' },
+                { v: 'Void',          l: 'Void' },
+            ];
+
+            const areaEl = $('#node-input-area');
+            areaEl.empty();
+            areas.forEach(function (a) {
+                areaEl.append($('<option>').val(a.v).text(a.l)
+                    .prop('selected', a.v === node.area));
+            });
+
+            const subEl = $('#node-input-subLocation');
+            subEl.empty();
+            subAreas.forEach(function (s) {
+                subEl.append($('<option>').val(s.v).text(s.l)
+                    .prop('selected', s.v === node.subLocation));
+            });
+        },
+    });
+
+</script>
+
+<script type="text/html" data-template-name="ha-mqtt-button">
+
+    <div class="form-row">
+        <label for="node-input-name">
+            <i class="fa fa-tag"></i> Name
+        </label>
+        <input type="text" id="node-input-name"
+               placeholder="Optional — defaults to S-10-A on canvas" />
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-config">
+            <i class="fa fa-cog"></i> Config
+        </label>
+        <input type="text" id="node-input-config" />
+    </div>
+
+    <hr/>
+
+    <!-- ── BUTTON (* Required) ───────────────────────────────── -->
+    <div class="form-row">
+        <label style="width:100%; font-weight:bold; color:#999; font-size:0.85em; text-transform:uppercase; letter-spacing:0.05em;">
+            <i class="fa fa-hand-pointer-o"></i> Button &nbsp;<span style="color:#e74c3c">* Required</span>
+        </label>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-uid">
+            <i class="fa fa-tv"></i> Cable ID
+        </label>
+        <span style="margin-right:4px; font-weight:bold;">S -</span>
+        <input type="text" id="node-input-uid"
+               placeholder="10" style="width:70px" />
+        &nbsp;
+        <select id="node-input-uidPostfix" style="width:65px">
+            <option value="">(none)</option>
+            <option value="-A">-A</option>
+            <option value="-B">-B</option>
+            <option value="-C">-C</option>
+            <option value="-D">-D</option>
+        </select>
+        <span style="margin-left:8px; color:#999; font-size:0.85em;">
+            Plan ID — Button letter
+        </span>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-area">
+            <i class="fa fa-map-marker"></i> Area
+        </label>
+        <select id="node-input-area" style="width:55%"></select>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-situation">
+            <i class="fa fa-compass"></i> Situation
+        </label>
+        <select id="node-input-situation" style="width:55%">
+            <option value="in">in</option>
+            <option value="above">above</option>
+            <option value="below">below</option>
+            <option value="outside">outside</option>
+            <option value="throughout">throughout</option>
+            <option value="under">under</option>
+            <option value="over">over</option>
+        </select>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-subLocation">
+            <i class="fa fa-map-marker"></i> Sub-Area
+        </label>
+        <select id="node-input-subLocation" style="width:55%"></select>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-buttonPosition">
+            <i class="fa fa-hand-pointer-o"></i> Position
+        </label>
+        <select id="node-input-buttonPosition" style="width:55%">
+            <option value="Top Left">Top Left</option>
+            <option value="Top Right">Top Right</option>
+            <option value="Bottom Left">Bottom Left</option>
+            <option value="Bottom Right">Bottom Right</option>
+            <option value="Top">Top</option>
+            <option value="Bottom">Bottom</option>
+            <option value="Left">Left</option>
+            <option value="Right">Right</option>
+            <option value="Centre">Centre</option>
+            <option value="Single">Single</option>
+        </select>
+    </div>
+
+    <hr/>
+
+    <!-- ── CONTROLLER ────────────────────────────────────────── -->
+    <div class="form-row">
+        <label style="width:100%; font-weight:bold; color:#999; font-size:0.85em; text-transform:uppercase; letter-spacing:0.05em;">
+            <i class="fa fa-exchange"></i> Controller
+        </label>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-buttonPayload">
+            <i class="fa fa-hand-pointer-o"></i> Payload
+        </label>
+        <input type="text" id="node-input-buttonPayload"
+               placeholder="e.g. 10-54" style="width:120px" />
+        <span style="margin-left:8px; color:#999; font-size:0.85em;">
+            panelId-GPIOpin
+        </span>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-subscribeTopic">
+            <i class="fa fa-exchange"></i> Subscribe topic
+        </label>
+        <input type="text" id="node-input-subscribeTopic"
+               placeholder="buttons" style="width:55%" />
+    </div>
+
+    <hr/>
+
+    <!-- ── OPTIONS ───────────────────────────────────────────── -->
+    <div class="form-row">
+        <label style="width:100%; font-weight:bold; color:#999; font-size:0.85em; text-transform:uppercase; letter-spacing:0.05em;">
+            <i class="fa fa-sliders"></i> Options
+        </label>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-haIcon">
+            <i class="fa fa-image"></i> HA Icon
+        </label>
+        <input type="text" id="node-input-haIcon"
+               placeholder="mdi:gesture-tap-button" style="width:55%" />
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-ledColor">
+            <i class="fa fa-circle"></i> LED Colour
+        </label>
+        <select id="node-input-ledColor" style="width:120px">
+            <option value="Blue">Blue</option>
+            <option value="Red">Red</option>
+            <option value="Green">Green</option>
+            <option value="White">White</option>
+            <option value="Orange">Orange</option>
+            <option value="None">None</option>
+        </select>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-holdTime">
+            <i class="fa fa-clock-o"></i> Hold time (s)
+        </label>
+        <input type="number" id="node-input-holdTime"
+               min="0.1" step="0.1" style="width:80px" />
+        <span style="margin-left:8px; color:#999; font-size:0.85em;">
+            HA auto-clears binary_sensor after this delay
+        </span>
+    </div>
+
+</script>
+
+<script type="text/html" data-help-name="ha-mqtt-button">
+    <p>
+        Wall button receiver. Listens for hardware controller MQTT payloads
+        and publishes to HA as a <code>binary_sensor</code> (for automations)
+        and a <code>button</code> entity (dashboard UI mirror).
+    </p>
+
+    <h3>Setup</h3>
+    <ol>
+        <li>Select your <strong>Config</strong> node</li>
+        <li>Set <strong>Cable ID</strong> and button letter — matches electrical plan</li>
+        <li>Set <strong>Payload</strong> — the <code>{panelId}-{GPIOpin}</code> string your controller publishes</li>
+        <li>Set <strong>Subscribe topic</strong> — the MQTT topic your controller publishes to</li>
+        <li>Deploy — two HA entities appear: a binary_sensor and a UI button mirror</li>
+    </ol>
+
+    <h3>Payload format</h3>
+    <p>
+        The controller publishes a plain string — e.g. <code>10-54</code>
+        meaning panel 10, GPIO pin 54. This node filters for its own
+        payload and silently ignores all others on the shared topic.
+    </p>
+
+    <h3>HA entities created</h3>
+    <ul>
+        <li><code>binary_sensor.s_10_a</code> — automation trigger, auto-clears via hold time</li>
+        <li><code>button.s_10_a_btn</code> — dashboard UI mirror, triggers same code path</li>
+    </ul>
+</script>

package/nodes/ha-mqtt-button.js

@@ -0,0 +1,158 @@
+// ============================================================
+// ha-mqtt-button — Wall Button Node Runtime
+// Package: node-red-contrib-dmx-for-ha
+// Author:  DeSwaggy — Discord: @deswaggy
+// ============================================================
+
+module.exports = function (RED) {
+
+    function HaMqttButtonNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+
+        // ── Config & broker ───────────────────────────────────────
+        const cfg = RED.nodes.getNode(config.config);
+        if (!cfg) { node.error('Button: no config node selected'); return; }
+
+        const broker = RED.nodes.getNode(cfg.broker);
+        if (!broker) { node.error('Button: no MQTT broker in config'); return; }
+
+        broker.register(node);
+
+        // ── Node settings ─────────────────────────────────────────
+        const S = {
+            uid:            config.uid             || '',
+            uidPostfix:     config.uidPostfix       || '',
+            area:           config.area             || '',
+            situation:      config.situation         || 'in',
+            subLocation:    config.subLocation       || '',
+            buttonPosition: config.buttonPosition    || 'Single',
+            buttonPayload:  String(config.buttonPayload || ''),
+            subscribeTopic: config.subscribeTopic    || 'buttons',
+            haIcon:         config.haIcon            || 'mdi:gesture-tap-button',
+            ledColor:       config.ledColor          || 'Blue',
+            holdTime:       parseFloat(config.holdTime) || 0.5,
+        };
+
+        const fixtureId    = `S-${S.uid}${S.uidPostfix}`;
+        const objectId     = `s_${S.uid}${S.uidPostfix}`.toLowerCase().replace(/[^a-z0-9_]/g, '_');
+        const fixtureTopic = `${cfg.discoveryPrefix}/binary_sensor/${fixtureId}`;
+        const uiBtnTopic   = `${cfg.discoveryPrefix}/button/${fixtureId}-BTN`;
+        const cfgTopic     = `${fixtureTopic}/${cfg.configTopic}`;
+        const statTopic    = `${fixtureTopic}/${cfg.stateTopic}`;
+        const uiBtnCfgTopic = `${uiBtnTopic}/${cfg.configTopic}`;
+        const uiBtnCmdTopic = `${uiBtnTopic}/${cfg.commandTopic}`;
+
+        // ── Helpers ───────────────────────────────────────────────
+        function pub(topic, payload, retain) {
+            broker.publish({
+                topic,
+                payload: typeof payload === 'object' ? JSON.stringify(payload) : String(payload),
+                qos:    cfg.qos,
+                retain: retain !== undefined ? retain : cfg.retain,
+            });
+        }
+
+        function setStatus(fill, shape, text) {
+            node.status({ fill, shape, text });
+        }
+
+        // ── Press handler ─────────────────────────────────────────
+        function handlePress(source) {
+            pub(statTopic, 'ON', false);
+            setStatus('blue', 'dot', `${fixtureId} pressed — ${S.buttonPosition}`);
+            node.log(`${fixtureId} press — source:${source}  position:${S.buttonPosition}`);
+        }
+
+        // ── Device add ────────────────────────────────────────────
+        function handleDeviceAdd() {
+            // Binary sensor discovery
+            const bsDiscovery = {
+                unique_id:          fixtureId,
+                object_id:          objectId,
+                name:               `${S.buttonPosition} button ${S.situation} the ${cfg.zone} ${S.area} ${S.subLocation}`,
+                stat_t:             statTopic,
+                off_delay:          S.holdTime,
+                enabled_by_default: cfg.enabledDefault,
+                icon:               S.haIcon,
+                device: {
+                    identifiers:    `binary_sensor-${fixtureId}`,
+                    name:           `(${fixtureId}) - Wall Button ${S.situation} the ${cfg.zone} - ${S.area} - ${S.subLocation}`,
+                    model:          `Wall button located ${S.situation} the ${cfg.zone} - ${S.area}`,
+                    model_id:       `referenced on plan as: (${fixtureId}`,
+                    suggested_area: `${cfg.zone} ${S.area} ${S.subLocation}`,
+                    hw_version:     `Wall button — ${S.ledColor} LED. Publishes "${S.buttonPayload}" on topic: ${S.subscribeTopic}`,
+                    serial_number:  `(${fixtureId}) Payload: ${S.buttonPayload}`,
+                    sw_version:     'ha-mqtt-button: 0.1.0',
+                    manufacturer:   'DeSwaggy — Discord: @deswaggy',
+                },
+            };
+
+            // UI button discovery (dashboard mirror)
+            const uiDiscovery = {
+                unique_id:          `${fixtureId}-BTN`,
+                object_id:          `${objectId}_btn`,
+                name:               `${S.buttonPosition} (UI) ${S.situation} the ${cfg.zone} ${S.area} ${S.subLocation}`,
+                cmd_t:              uiBtnCmdTopic,
+                payload_press:      'PRESS',
+                enabled_by_default: cfg.enabledDefault,
+                icon:               S.haIcon,
+                device: { identifiers: `binary_sensor-${fixtureId}` },
+            };
+
+            pub(cfgTopic,     bsDiscovery, true);
+            pub(uiBtnCfgTopic, uiDiscovery, true);
+
+            // Subscribe to controller topic (physical presses)
+            broker.subscribe(S.subscribeTopic, cfg.qos, function (topic, payload) {
+                if (String(payload) === S.buttonPayload) handlePress('physical');
+            }, node.id);
+
+            // Subscribe to HA UI button cmd topic
+            broker.subscribe(uiBtnCmdTopic, cfg.qos, function (topic, payload) {
+                if (String(payload) === 'PRESS') handlePress('HA UI');
+                else node.warn(`${fixtureId} — unexpected UI payload: "${payload}"`);
+            }, node.id);
+
+            setStatus('green', 'ring', `${fixtureId} ready — awaiting press`);
+            node.log(`${fixtureId} device added — payload:${S.buttonPayload}  topic:${S.subscribeTopic}`);
+        }
+
+        // ── Device remove ─────────────────────────────────────────
+        function handleDeviceRemove() {
+            pub(cfgTopic,      '', true);
+            pub(uiBtnCfgTopic, '', true);
+            broker.unsubscribe(S.subscribeTopic, node.id);
+            broker.unsubscribe(uiBtnCmdTopic,    node.id);
+            setStatus('red', 'ring', `${fixtureId} removed`);
+            node.log(`${fixtureId} device removed`);
+        }
+
+        // ── NR input entry point ──────────────────────────────────
+        node.on('input', function (msg, send, done) {
+            const devReq = typeof msg.device === 'string'
+                ? msg.device
+                : (msg.device && msg.device.request);
+
+            if (devReq) {
+                switch (devReq) {
+                    case 'add':    handleDeviceAdd();    break;
+                    case 'remove': handleDeviceRemove(); break;
+                    default: node.warn(`${fixtureId} — unknown device.request: "${devReq}"`);
+                }
+            } else {
+                node.warn(`${fixtureId} — unrecognised message received and dropped. See node documentation.`);
+            }
+            done();
+        });
+
+        // ── Cleanup ───────────────────────────────────────────────
+        node.on('close', function (done) {
+            broker.unsubscribe(S.subscribeTopic, node.id);
+            broker.unsubscribe(uiBtnCmdTopic,    node.id);
+            broker.deregister(node, done);
+        });
+    }
+
+    RED.nodes.registerType('ha-mqtt-button', HaMqttButtonNode);
+};