node-red-contrib-sht41 1.0.0

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "node-red-contrib-sht41",
+  "version": "1.0.0",
+  "description": "Node-RED node to read temperature and humidity from Sensirion SHT41 sensors over I2C",
+  "keywords": ["node-red", "sht41", "temperature", "humidity", "i2c", "sensor"],
+  "author": "Your Name <youremail@example.com>",
+  "license": "MIT",
+  "dependencies": {
+    "i2c-bus": "^5.2.2"
+  },
+  "node-red": {
+    "nodes": {
+      "sht41": "sht41.js"
+    }
+  }
+}

package/sht41.html

@@ -0,0 +1,99 @@
+<script type="text/javascript">
+    RED.nodes.registerType('SHT41', {
+        category: 'input',
+        color: '#1f77b4',
+        defaults: {
+            name: { value: "" },
+            busNum: { value: "1", required: true, validate: RED.validators.number() },
+            address: { value: "0x44", required: true, validate: function(v) {
+                return /^0x[0-9a-fA-F]+$|^[0-9]+$/.test(v);
+                    }
+                },
+            precision: { value: "high" },
+            unit: { value: "C" }
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: "font-awesome/fa-thermometer-half",
+        label: function() {
+            return this.name || "SHT41";
+        },
+        oneditprepare: function() {
+                if (this.busNum === undefined) {
+                        $("#node-input-busNum").val(1);
+                }
+                $("#node-input-busNum").spinner({
+                        min:0,
+                        max:7
+                });
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="SHT41">
+
+    <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="Name">
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-busNum">
+            <i class="fa fa-random"></i> I2C Bus
+        </label>
+        /dev/i2c-<input id="node-input-busNum" class="I2C-in-address" min=0 max=7 style="width:40px; height:16px;">
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-address">
+            <i class="fa fa-map-marker"></i> I2C Address
+        </label>
+        <input type="text" id="node-input-address">
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-precision">
+            <i class="fa fa-tachometer"></i> Precision
+        </label>
+        <select id="node-input-precision">
+            <option value="high">High</option>
+            <option value="medium">Medium</option>
+            <option value="low">Low</option>
+        </select>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-unit">
+            <i class="fa fa-thermometer-half"></i> Unit
+        </label>
+        <select id="node-input-unit">
+            <option value="C">°C</option>
+            <option value="F">°F</option>
+        </select>
+    </div>
+
+</script>
+
+<script type="text/html" data-help-name="SHT41">
+    <p>
+        Reads temperature and humidity from a Sensirion SHT41 sensor over I2C.
+    </p>
+    <p>
+        Inputs:
+    </p>
+    <ul>
+    <li><b>I2C Bus</b> - I2C bus number, default is 1. This is not common to change.</li>
+    <li><b>I2C Address</b> - Address of I2C device to poll. SHT41 is 0x44 in hex, or 68 in decimal.</li>
+    <li><b>Precision</b> - Lower precision can be polled more frequently. Refer to data sheet for more information.</li>
+    <li><b>Unit</b> - Return values in Celcius or Fahrenheit.</li>
+    </ul>
+    <p>
+        Outputs:
+    </p>
+    <ul>
+        <li><code>msg.payload.temperature</code> – Temperature (°C or °F)</li>
+        <li><code>msg.payload.humidity</code> – Relative Humidity (%)</li>
+    </ul>
+</script>

package/sht41.js

@@ -0,0 +1,112 @@
+module.exports = function(RED) {
+
+    const i2c = require('i2c-bus');
+
+    function SHT41Node(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+
+        node.busNumber = parseInt(config.busNum) || 1;
+        node.address = parseInt(config.address) || 0x44;
+        node.precision = config.precision || "high";
+        node.unit = config.unit || "F";       // C or F
+
+        const COMMANDS = {
+            high: 0xFD,
+            medium: 0xF6,
+            low: 0xE0
+        };
+
+        let bus;
+
+        try {
+            bus = i2c.openSync(node.busNumber);
+            node.status({fill:"green",shape:"dot",text:"I2C Ready"});
+        } catch (err) {
+            node.status({fill:"red",shape:"ring",text:"I2C Error"});
+            node.error("Failed to open I2C bus: " + err.message);
+            return;
+        }
+
+        // CRC-8 check (polynomial 0x31)
+        function checkCRC(data, crc) {
+            let calculated = 0xFF;
+            for (let i = 0; i < 2; i++) {
+                calculated ^= data[i];
+                for (let bit = 8; bit > 0; --bit) {
+                    if (calculated & 0x80) {
+                        calculated = (calculated << 1) ^ 0x31;
+                    } else {
+                        calculated <<= 1;
+                    }
+                }
+            }
+            calculated &= 0xFF;
+            return calculated === crc;
+        }
+
+        node.on('input', function(msg) {
+
+            const command = COMMANDS[node.precision] || 0xFD;
+
+            try {
+                const cmdBuffer = Buffer.from([command]);
+                bus.i2cWriteSync(node.address, 1, cmdBuffer);
+            } catch (err) {
+                node.status({fill:"red",shape:"ring",text:"Write Error"});
+                node.error("Write Error: " + err.message, msg);
+                return;
+            }
+
+            setTimeout(() => {
+                try {
+                    const buf = Buffer.alloc(6);
+                    bus.i2cReadSync(node.address, 6, buf);
+
+                    // CRC validation
+                    if (!checkCRC([buf[0], buf[1]], buf[2]) ||
+                        !checkCRC([buf[3], buf[4]], buf[5])) {
+
+                        node.status({fill:"yellow",shape:"ring",text:"CRC Fail"});
+                        node.error("CRC Validation Failed", msg);
+                        return;
+                    }
+
+                    const rawT = (buf[0] << 8) | buf[1];
+                    const rawRH = (buf[3] << 8) | buf[4];
+
+                    let temperature = -45 + 175 * (rawT / 65535);
+                    const humidity = -6 + 125 * (rawRH / 65535);
+
+                    if (node.unit === "F") {
+                        temperature = (temperature * 9/5) + 32;
+                    }
+
+                    msg.payload = {
+                        temperature: parseFloat(temperature.toFixed(2)),
+                        humidity: parseFloat(humidity.toFixed(2)),
+                        unit: node.unit
+                    };
+
+                    node.status({fill:"green",shape:"dot",text:"T: " + msg.payload.temperature + ", H: " + msg.payload.humidity});
+                    node.send(msg);
+
+                } catch (err) {
+                    node.status({fill:"red",shape:"ring",text:"Read Error"});
+                    node.error("Read Error: " + err.message, msg);
+                }
+
+            }, 15);
+        });
+
+        node.on('close', function() {
+            if (bus) {
+                try {
+                    bus.closeSync();
+                } catch (err) {}
+            }
+        });
+    }
+
+    RED.nodes.registerType("SHT41", SHT41Node);
+}