@thehighestbit/node-red-contrib-hdc302x 1.0.0

package/README.md

@@ -0,0 +1,43 @@
+# node-red-contrib-hdc302x
+
+A Node-RED node for reading temperature and humidity data from Texas Instruments HDC302x sensors over I2C.
+
+## Supported Sensors
+
+- HDC3020
+- HDC3021
+- HDC3022
+
+## Installation
+
+```bash
+cd ~/.node-red
+npm install @thehighestbit/node-red-contrib-hdc302x
+```
+
+## Configuration
+
+| Property | Description |
+|----------|-------------|
+| I2C Address | Sensor address: 0x44, 0x45, 0x46, or 0x47 |
+| I2C Bus | I2C bus number (default: 1) |
+| Read Interval | Polling interval in ms (minimum 1000ms). Leave blank to disable polling. |
+
+## Usage
+
+The node outputs temperature and humidity readings as a JSON payload:
+
+```json
+{
+    "payload": {
+        "temperature": 25.5,
+        "humidity": 45.2
+    },
+    "topic": "hdc302x/0x44"
+}
+```
+
+### Triggering Reads
+
+- **Automatic polling**: Set a read interval to poll the sensor automatically
+- **Manual trigger**: Send any message to the node input to trigger an immediate read

package/hdc302x.html

@@ -0,0 +1,74 @@
+<script type="text/javascript">
+RED.nodes.registerType('hdc302x', {
+    category: 'input',
+    color: '#d6d6d6',
+    defaults: {
+        name: { value: '' },
+        i2c_address: { value: '0x44', required: true },
+        i2c_bus: { value: 1, required: true, validate: RED.validators.number() },
+        read_interval: {
+            value: '',
+            required: false,
+            validate: function(v) { return v === '' || (!isNaN(v) && Number(v) >= 1000); }
+        }
+    },
+    inputs: 1,
+    outputs: 1,
+    icon: 'font-awesome/fa-thermometer-half',
+    label: function () {
+        return this.name || `HDC302x ${this.i2c_address}`;
+    },
+    oneditprepare: function () {
+        const $address = $('#node-input-i2c_address');
+        $address.typedInput({
+            types: [{
+                value: 'i2c_address',
+                options: [
+                    { value: '0x44', label: '0x44' },
+                    { value: '0x45', label: '0x45' },
+                    { value: '0x46', label: '0x46' },
+                    { value: '0x47', label: '0x47' }
+                ]
+            }]
+        });
+        $address.typedInput('value', this.i2c_address || '0x44');
+    },
+    oneditsave: function () {
+        this.i2c_address = $('#node-input-i2c_address').typedInput('value');
+    }
+});
+</script>
+
+<script type="text/html" data-template-name="hdc302x">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-input-name">
+    </div>
+    <div class="form-row">
+        <label for="node-input-i2c_address"><i class="fa fa-microchip"></i> I2C Address</label>
+        <input type="text" id="node-input-i2c_address">
+    </div>
+    <div class="form-row">
+        <label for="node-input-i2c_bus"><i class="fa fa-plug"></i> I2C Bus</label>
+        <input type="number" id="node-input-i2c_bus" min="0" max="10" value="1">
+    </div>
+    <div class="form-row">
+        <label for="node-input-read_interval"><i class="fa fa-clock-o"></i> Interval (ms)</label>
+        <input type="number" id="node-input-read_interval" min="1000" step="100" placeholder="Not polling">
+    </div>
+</script>
+
+<script type="text/markdown" data-help-name="hdc302x">
+Enables reading of Texas Instruments HDC302x temperature and humidity sensor data over I2C.
+
+### Outputs
+: payload (JSON) : Temperature (°C) and humidity (%) readings.
+
+### Configuration
+- **I2C Address**: Address of the sensor (0x44, 0x45, 0x46, or 0x47).
+- **I2C Bus**: I2C bus number (default: 1).
+- **Read Interval**: Polling interval in milliseconds (>= 1000). Leave blank to disable polling.
+
+### Triggering Reads
+Send any message to the input to trigger an immediate sensor read.
+</script>

package/hdc302x.js

@@ -0,0 +1,73 @@
+const { HDC302x } = require('hdc302x');
+
+module.exports = function (RED) {
+    function HDC302xNode(config) {
+        RED.nodes.createNode(this, config);
+
+        var node = this;
+        this.i2c_address = parseInt(config.i2c_address, 16);
+        this.i2c_bus = Number(config.i2c_bus);
+        const intervalMs = Number(config.read_interval);
+        this.read_interval = Number.isFinite(intervalMs) && intervalMs >= 1000 ? intervalMs : null;
+
+        const MAX_ATTEMPTS = 3;
+        let timer = null;
+        let active = true;
+        let sensor = null;
+
+        try {
+            sensor = new HDC302x({
+                i2cBusNumber: node.i2c_bus,
+                address: node.i2c_address
+            });
+        } catch (err) {
+            node.error(`Failed to initialize HDC302x sensor: ${err.message}`);
+            node.status({ fill: "red", shape: "ring", text: "init failed" });
+            return;
+        }
+
+        function scheduleNext(delayMs) {
+            if (!active || node.read_interval === null) {
+                return;
+            }
+            clearTimeout(timer);
+            timer = setTimeout(() => readSensor(), delayMs);
+        }
+
+        async function readSensor(attempt = 1, msg = {}) {
+            try {
+                const { temperature, humidity } = await sensor.read();
+
+                node.status({ fill: "green", shape: "dot", text: `${temperature.toFixed(1)}°C, ${humidity.toFixed(1)}%` });
+                node.send({
+                    payload: {
+                        temperature: temperature,
+                        humidity: humidity
+                    },
+                    topic: msg.topic || node.name || `hdc302x/0x${node.i2c_address.toString(16)}`
+                });
+
+                scheduleNext(node.read_interval);
+            } catch (err) {
+                if (attempt < MAX_ATTEMPTS) {
+                    node.status({ fill: "yellow", shape: "ring", text: `retry ${attempt}` });
+                    setTimeout(() => readSensor(attempt + 1, msg), 1000);
+                    return;
+                }
+                node.status({ fill: "red", shape: "ring", text: "read failed" });
+                node.warn(`Failed to read HDC302x sensor at 0x${node.i2c_address.toString(16)}: ${err.message}`);
+                scheduleNext(node.read_interval);
+            }
+        }
+
+        node.on("input", (msg) => readSensor(1, msg));
+        node.on("close", () => {
+            active = false;
+            clearTimeout(timer);
+        });
+
+        scheduleNext(0);
+    }
+
+    RED.nodes.registerType("hdc302x", HDC302xNode);
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+    "name": "@thehighestbit/node-red-contrib-hdc302x",
+    "version": "1.0.0",
+    "publishConfig": {
+    "access": "public"
+    },
+    "description": "Node-RED node for Texas Instruments HDC302x temperature and humidity sensor",
+    "main": "hdc302x.js",
+    "scripts": {
+        "test": "echo \"Error: no test specified\" && exit 1"
+    },
+    "node-red": {
+        "version": ">=2.0.0",
+        "nodes": {
+            "hdc302x": "hdc302x.js"
+        },
+        "dependencies": {
+            "hdc302x": "1.0.0"
+        }
+    },
+    "keywords": [
+        "node-red",
+        "hdc302x",
+        "hdc3020",
+        "hdc3021",
+        "hdc3022",
+        "temperature",
+        "humidity",
+        "i2c",
+        "raspberry",
+        "iot"
+    ],
+    "author": "TheHighestBit",
+    "license": "ISC",
+    "files": [
+        "hdc302x.js",
+        "hdc302x.html"
+    ],
+    "dependencies": {
+        "hdc302x": "1.0.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/TheHighestBit/node-red-contrib-hdc302x.git"
+    }
+}