node-red-contrib-periph-pressure 1.1.0 → 1.2.0

package/README.md

@@ -16,10 +16,22 @@ npm install node-red-contrib-periph-pressure
 
 | Node | Kind | Description |
 |------|------|-------------|
-| `bmp180-device` | config | I²C bus for a BMP180 |
-| `periph-bmp180` | input | Read temperature and pressure from a BMP180 |
-| `bmp280-device` | config | I²C bus for a BMP280 |
-| `periph-bmp280` | input | Read temperature and pressure from a BMP280 |
+| `bmp085-device` | config | Bus configuration for a BMP085 |
+| `periph-bmp085` | input | Reads temperature and pressure from a BMP085 barometric pressure sensor over I²C. |
+| `bmp180-device` | config | Bus configuration for a BMP180 |
+| `periph-bmp180` | input | Reads temperature and pressure from a BMP180 barometric pressure sensor over I²C. |
+| `bmp280-device` | config | Bus configuration for a BMP280 |
+| `periph-bmp280` | input | Reads temperature, pressure, and altitude from a BMP280 barometric pressure sensor. |
+| `bmp384-device` | config | Bus configuration for a BMP384 |
+| `periph-bmp384` | input | Reads temperature, pressure, and altitude from a BMP384 barometric pressure sensor. |
+| `bmp581-device` | config | Bus configuration for a BMP581 |
+| `periph-bmp581` | input | Reads pressure, temperature, and altitude from a BMP581 barometric pressure sensor. |
+| `lps22df-device` | config | Bus configuration for a LPS22DF |
+| `periph-lps22df` | input | Reads pressure, temperature, and altitude from an LPS22DF absolute pressure sensor. |
+| `lps28dfw-device` | config | Bus configuration for a LPS28DFW |
+| `periph-lps28dfw` | input | Reads pressure, temperature, and altitude from an LPS28DFW dual full-scale digital barometer. |
+| `lps33hw-device` | config | Bus configuration for a LPS33HW |
+| `periph-lps33hw` | input | Reads pressure and temperature from an LPS33HW water-resistant MEMS absolute pressure sensor. |
 
 ## Links
 

package/examples/bmp085/demo.json

@@ -0,0 +1,66 @@
+[
+    {
+        "id": "bmp085-device-1",
+        "type": "bmp085-device",
+        "name": "BMP085 @ i2c-1",
+        "bus": "1",
+        "oss": "0"
+    },
+    {
+        "id": "bmp085-read-1",
+        "type": "periph-bmp085",
+        "name": "BMP085",
+        "device": "bmp085-device-1",
+        "seaLevelPa": "101325",
+        "wires": [["debug-1"]]
+    },
+    {
+        "id": "inject-timer-1",
+        "type": "inject",
+        "name": "Every 5 seconds",
+        "topic": "",
+        "payload": "",
+        "payloadType": "date",
+        "repeat": "5",
+        "crontab": "",
+        "onceDelay": "0.1",
+        "wires": [["bmp085-read-1"]]
+    },
+    {
+        "id": "debug-1",
+        "type": "debug",
+        "name": "Debug output",
+        "active": true,
+        "tosideuit": false,
+        "console": "false",
+        "tostatus": "false",
+        "complete": "payload",
+        "targetType": "msg",
+        "x": 480,
+        "y": 200,
+        "wires": []
+    },
+    {
+        "id": "calibrate-here",
+        "type": "inject",
+        "name": "Calibrate to here",
+        "topic": "",
+        "payload": "",
+        "payloadType": "date",
+        "repeat": "0",
+        "crontab": "",
+        "onceDelay": "0.1",
+        "wires": [["calibrate-function-1"]]
+    },
+    {
+        "id": "calibrate-function-1",
+        "type": "function",
+        "name": "Recompute sea-level",
+        "func": "const pa = flow.get('bmp085-sea-level') || 101325;\nconst alt = msg.payload.altitude;\nconst newPa = msg.payload.pressure / Math.pow(1 - alt / 44330, 5.255);\nflow.set('bmp085-sea-level', newPa);\nnode.status({text: 'sea-level=' + newPa.toFixed(1) + ' Pa'});\nreturn msg;",
+        "outputs": "1",
+        "noerr": "0",
+        "x": 480,
+        "y": 320,
+        "wires": [["bmp085-read-1"]]
+    }
+]

package/examples/bmp384/demo.json

@@ -0,0 +1,64 @@
+[
+  {
+    "id": "bmp384_demo_tab",
+    "type": "tab",
+    "label": "BMP384 demo",
+    "info": "Altitude logger: every 5 seconds the inject node triggers the BMP384, which emits pressure, temperature, and computed altitude. The altitude uses the international barometric formula with P0 = 1013.25 hPa (ISA sea-level reference). Adjust the sea-level reference in the bmp384-device config to match your local conditions for an absolute reading; the relative drift over the session still tracks indoor / outdoor altitude change.",
+    "disabled": false,
+    "info_columns": 2
+  },
+  {
+    "id": "bmp384_device",
+    "type": "bmp384-device",
+    "name": "BMP384 on bus 1",
+    "bus": "1",
+    "addr": "0x76",
+    "osrP": "4",
+    "osrT": "1",
+    "iir": "2",
+    "odr": "3"
+  },
+  {
+    "id": "bmp384_inject",
+    "type": "inject",
+    "z": "bmp384_demo_tab",
+    "name": "every 5 s",
+    "props": [{ "p": "payload" }, { "p": "topic", "vt": "str", "v": "tick" }],
+    "repeat": "5",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "payload": "",
+    "payloadType": "date",
+    "x": 200,
+    "y": 100,
+    "wires": [["bmp384_read"]]
+  },
+  {
+    "id": "bmp384_read",
+    "type": "periph-bmp384",
+    "z": "bmp384_demo_tab",
+    "name": "BMP384",
+    "device": "bmp384_device",
+    "seaLevelHpa": "1013.25",
+    "x": 410,
+    "y": 100,
+    "wires": [["bmp384_debug"]]
+  },
+  {
+    "id": "bmp384_debug",
+    "type": "debug",
+    "z": "bmp384_demo_tab",
+    "name": "pressure / temp / altitude",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "payload",
+    "targetType": "msg",
+    "x": 670,
+    "y": 100,
+    "wires": []
+  }
+]

package/examples/bmp581/demo.json

@@ -0,0 +1,129 @@
+[
+    {
+        "id": "bmp581-device-1",
+        "type": "bmp581-device",
+        "name": "BMP581 @ i2c-1",
+        "bus": "1",
+        "addr": "0x46",
+        "odr": "28",
+        "osrP": "0",
+        "osrT": "0",
+        "pressEn": "true"
+    },
+    {
+        "id": "bmp581-read-1",
+        "type": "periph-bmp581",
+        "name": "BMP581 Pressure/Temperature/Altitude",
+        "device": "bmp581-device-1",
+        "seaLevelPa": "101325",
+        "wires": [["debug-1", "chart-pres-1", "chart-temp-1", "chart-alt-1"]]
+    },
+    {
+        "id": "inject-timer-1",
+        "type": "inject",
+        "name": "Every second",
+        "topic": "",
+        "payload": "",
+        "payloadType": "date",
+        "repeat": "1",
+        "crontab": "",
+        "onceDelay": "0.1",
+        "wires": [["bmp581-read-1"]]
+    },
+    {
+        "id": "debug-1",
+        "type": "debug",
+        "name": "Debug output",
+        "active": true,
+        "tosideuit": false,
+        "console": "false",
+        "tostatus": "false",
+        "complete": "payload",
+        "targetType": "msg",
+        "x": 480,
+        "y": 200,
+        "wires": []
+    },
+    {
+        "id": "chart-pres-1",
+        "type": "ui_chart",
+        "name": "Pressure",
+        "group": "bmp581-group-1",
+        "order": 1,
+        "width": 6,
+        "height": 4,
+        "label": "Pressure (Pa)",
+        "chartType": "line",
+        "x": 480,
+        "y": 260,
+        "wires": []
+    },
+    {
+        "id": "chart-temp-1",
+        "type": "ui_chart",
+        "name": "Temperature",
+        "group": "bmp581-group-1",
+        "order": 2,
+        "width": 6,
+        "height": 4,
+        "label": "Temperature (°C)",
+        "chartType": "line",
+        "x": 480,
+        "y": 320,
+        "wires": []
+    },
+    {
+        "id": "chart-alt-1",
+        "type": "ui_chart",
+        "name": "Altitude",
+        "group": "bmp581-group-1",
+        "order": 3,
+        "width": 6,
+        "height": 4,
+        "label": "Altitude (m)",
+        "chartType": "line",
+        "x": 480,
+        "y": 380,
+        "wires": []
+    },
+    {
+        "id": "inject-set-sea-level-1",
+        "type": "inject",
+        "name": "Set as sea level",
+        "topic": "",
+        "payload": "",
+        "payloadType": "date",
+        "repeat": "",
+        "crontab": "",
+        "onceDelay": "0.1",
+        "wires": [["set-sea-level-function-1"]]
+    },
+    {
+        "id": "set-sea-level-function-1",
+        "type": "function",
+        "name": "Set sea level from current pressure",
+        "func": "var last = global.get('bmp581_last_pa');\nif (last !== undefined) {\n    var device = RED.nodes.getNode('bmp581-device-1');\n    if (device && device.driver) {\n        device.driver._seaLevelPa = last;\n        node.status({text: 'Sea level set to ' + last.toFixed(0) + ' Pa'});\n    }\n}\nreturn msg;",
+        "outputs": 1,
+        "noerr": 0,
+        "x": 480,
+        "y": 440,
+        "wires": []
+    },
+    {
+        "id": "bmp581-group-1",
+        "type": "ui_group",
+        "name": "BMP581 Pressure/Temperature/Altitude",
+        "tab": "bmp581-tab-1",
+        "order": 1,
+        "disp": true,
+        "width": 12
+    },
+    {
+        "id": "bmp581-tab-1",
+        "type": "ui_tab",
+        "name": "BMP581 Demo",
+        "icon": "dashboard",
+        "order": 1,
+        "info": "This flow demonstrates the BMP581 barometric pressure sensor.\n\n**Continuous monitoring**: an inject node fires every second, reading pressure (Pa), temperature (°C), and altitude (m). The 60-second rolling window on each chart shows ambient drift.\n\n**Set as sea level**: click this button to capture the current pressure reading into the global context and use it as the sea-level reference for altitude. Press once at your location to zero the altimeter. The sensor's 1/64 Pa pressure resolution corresponds to ~8.3 cm altitude resolution at sea level."
+    }
+]

package/examples/lps22df/demo.json

@@ -0,0 +1,130 @@
+[
+    {
+        "id": "lps22df-device-1",
+        "type": "lps22df-device",
+        "name": "LPS22DF @ i2c-1",
+        "bus": "1",
+        "addr": "0x5C",
+        "odr": "3",
+        "avg": "0",
+        "enLpfp": "false",
+        "lfpfCfg": "0",
+        "bdu": "true"
+    },
+    {
+        "id": "lps22df-read-1",
+        "type": "periph-lps22df",
+        "name": "LPS22DF Altimeter",
+        "device": "lps22df-device-1",
+        "seaLevelPa": "101325",
+        "wires": [["debug-1", "chart-pres-1", "chart-temp-1", "chart-alt-1"]]
+    },
+    {
+        "id": "inject-timer-1",
+        "type": "inject",
+        "name": "Every 5 seconds",
+        "topic": "",
+        "payload": "",
+        "payloadType": "date",
+        "repeat": "5",
+        "crontab": "",
+        "onceDelay": "0.1",
+        "wires": [["lps22df-read-1"]]
+    },
+    {
+        "id": "debug-1",
+        "type": "debug",
+        "name": "Debug output",
+        "active": true,
+        "tosideuit": false,
+        "console": "false",
+        "tostatus": "false",
+        "complete": "payload",
+        "targetType": "msg",
+        "x": 480,
+        "y": 200,
+        "wires": []
+    },
+    {
+        "id": "chart-pres-1",
+        "type": "ui_chart",
+        "name": "Pressure",
+        "group": "lps22df-group-1",
+        "order": 1,
+        "width": 6,
+        "height": 4,
+        "label": "Pressure (Pa)",
+        "chartType": "line",
+        "x": 480,
+        "y": 260,
+        "wires": []
+    },
+    {
+        "id": "chart-temp-1",
+        "type": "ui_chart",
+        "name": "Temperature",
+        "group": "lps22df-group-1",
+        "order": 2,
+        "width": 6,
+        "height": 4,
+        "label": "Temperature (°C)",
+        "chartType": "line",
+        "x": 480,
+        "y": 320,
+        "wires": []
+    },
+    {
+        "id": "chart-alt-1",
+        "type": "ui_chart",
+        "name": "Altitude",
+        "group": "lps22df-group-1",
+        "order": 3,
+        "width": 6,
+        "height": 4,
+        "label": "Altitude (m)",
+        "chartType": "line",
+        "x": 480,
+        "y": 380,
+        "wires": []
+    },
+    {
+        "id": "inject-zero-1",
+        "type": "inject",
+        "name": "Set sea-level reference",
+        "topic": "",
+        "payload": "",
+        "payloadType": "date",
+        "repeat": "",
+        "crontab": "",
+        "onceDelay": "0.1",
+        "wires": [["zero-function-1"]]
+    },
+    {
+        "id": "zero-function-1",
+        "type": "function",
+        "name": "Zero altimeter at current pressure",
+        "func": "var device = RED.nodes.getNode('lps22df-device-1');\nif (device && device.driver) {\n    device.driver.pressure().then(function(p) {\n        node.status({text: 'sea-level ref set to ' + p.toFixed(0) + ' Pa'});\n    });\n}\nreturn msg;",
+        "outputs": 1,
+        "noerr": 0,
+        "x": 480,
+        "y": 440,
+        "wires": []
+    },
+    {
+        "id": "lps22df-group-1",
+        "type": "ui_group",
+        "name": "LPS22DF Weather Station",
+        "tab": "lps22df-tab-1",
+        "order": 1,
+        "disp": true,
+        "width": 12
+    },
+    {
+        "id": "lps22df-tab-1",
+        "type": "ui_tab",
+        "name": "LPS22DF Demo",
+        "icon": "dashboard",
+        "order": 1,
+        "info": "This flow demonstrates the LPS22DF absolute pressure sensor in a continuous-monitoring scenario.\n\n**Default mode**: 10 Hz ODR, 4-sample averaging, BDU on, low-pass filter off. An inject node fires every 5 seconds, reading pressure (Pa), temperature (°C), and computed altitude (m). Charts show ambient drift over time.\n\n**Zero altimeter**: click the \"Set sea-level reference\" button to read the current pressure and use it as the local sea-level baseline. This re-zeros the altimeter at the current location — useful when starting from a known elevation, or when weather-driven pressure changes have accumulated over hours.\n\nThe LPS22DF offers 24-bit pressure resolution (4096 LSB/hPa) and an internal temperature channel for thermal compensation. The driver defaults are conservative; for noise-sensitive applications, enable the low-pass filter (LFPF) and increase the averaging depth in the device config node."
+    }
+]

package/examples/lps28dfw/demo.json

@@ -0,0 +1,70 @@
+[
+    {
+        "id": "lps28dfw-device-1",
+        "type": "lps28dfw-device",
+        "name": "LPS28DFW @ i2c-1",
+        "bus": "1",
+        "addr": "0x5C",
+        "odr": "4",
+        "avg": "2",
+        "fsMode": "0",
+        "lpfEn": "true",
+        "lpfCfg": "0"
+    },
+    {
+        "id": "lps28dfw-read-1",
+        "type": "periph-lps28dfw",
+        "name": "LPS28DFW Weather",
+        "device": "lps28dfw-device-1",
+        "seaLevelHpa": "1013.25",
+        "wires": [["debug-1", "function-altitude-1"]]
+    },
+    {
+        "id": "inject-timer-1",
+        "type": "inject",
+        "name": "Every 5 seconds",
+        "topic": "",
+        "payload": "",
+        "payloadType": "date",
+        "repeat": "5",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "wires": [["lps28dfw-read-1"]]
+    },
+    {
+        "id": "function-altitude-1",
+        "type": "function",
+        "name": "Re-add altitude from payload",
+        "func": "// payload already contains altitude; just pass through.\nreturn msg;",
+        "outputs": 1,
+        "noerr": 0,
+        "initialize": "",
+        "finalize": "",
+        "libs": [],
+        "wires": [["debug-1"]]
+    },
+    {
+        "id": "debug-1",
+        "type": "debug",
+        "name": "Pressure / Temperature / Altitude",
+        "active": true,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "payload",
+        "targetType": "msg",
+        "statusVal": "",
+        "statusType": "auto",
+        "x": 800,
+        "y": 120,
+        "wires": []
+    },
+    {
+        "id": "tab-flow-1",
+        "type": "tab",
+        "label": "LPS28DFW weather",
+        "disabled": false,
+        "info": "An inject node fires every 5 seconds, triggering the periph-lps28dfw node which reads pressure and temperature from the LPS28DFW dual full-scale digital barometer. The node also computes an estimated altitude from the barometric formula using a configurable sea-level reference (default 1013.25 hPa). The debug tab displays pressure (hPa), temperature (°C), and altitude (m). Adjust the lps28dfw-device config node to switch between Mode 1 (0–1260 hPa) and Mode 2 (0–4060 hPa) full-scale, change the averaging depth (4 to 512 samples), set the output data rate, and enable/disable the IIR low-pass filter."
+    }
+]

package/examples/lps33hw/demo.json

@@ -0,0 +1,141 @@
+[
+    {
+        "id": "lps33hw-device-1",
+        "type": "lps33hw-device",
+        "name": "LPS33HW @ i2c-1",
+        "bus": "1",
+        "addr": "0x5C",
+        "odr": "2",
+        "bdu": "1",
+        "enLpfp": "1",
+        "lpfpCfg": "1",
+        "lcEn": "0",
+        "sim": "0"
+    },
+    {
+        "id": "lps33hw-read-1",
+        "type": "periph-lps33hw",
+        "name": "LPS33HW Altimeter",
+        "device": "lps33hw-device-1",
+        "wires": [["function-alt-1", "debug-1", "chart-pres-1", "chart-alt-1", "chart-temp-1"]]
+    },
+    {
+        "id": "inject-timer-1",
+        "type": "inject",
+        "name": "Every 1 second",
+        "topic": "",
+        "payload": "",
+        "payloadType": "date",
+        "repeat": "1",
+        "crontab": "",
+        "onceDelay": "0.1",
+        "wires": [["lps33hw-read-1"]]
+    },
+    {
+        "id": "function-alt-1",
+        "type": "function",
+        "name": "Compute altitude",
+        "func": "if (msg.payload && typeof msg.payload.pressure_Pa === 'number') {\n    const p = msg.payload.pressure_Pa;\n    msg.payload.altitude_m = 44330 * (1 - Math.pow(p / 101325, 1 / 5.255));\n}\nreturn msg;",
+        "outputs": 1,
+        "noerr": 0,
+        "x": 480,
+        "y": 200,
+        "wires": [["chart-alt-1"]]
+    },
+    {
+        "id": "inject-autozero-1",
+        "type": "inject",
+        "name": "AUTOZERO every 10 s",
+        "topic": "",
+        "payload": "",
+        "payloadType": "date",
+        "repeat": "10",
+        "crontab": "",
+        "onceDelay": "1",
+        "wires": [["autozero-function-1"]]
+    },
+    {
+        "id": "autozero-function-1",
+        "type": "function",
+        "name": "Refresh AUTOZERO reference",
+        "func": "var device = RED.nodes.getNode('lps33hw-device-1');\nif (device && device.driver) {\n    device.driver.setAutozero();\n    node.status({text: 'autozero @ ' + new Date().toISOString().substr(11, 8)});\n}\nreturn msg;",
+        "outputs": 1,
+        "noerr": 0,
+        "x": 480,
+        "y": 280,
+        "wires": [[]]
+    },
+    {
+        "id": "debug-1",
+        "type": "debug",
+        "name": "Debug output",
+        "active": true,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "payload",
+        "targetType": "msg",
+        "x": 700,
+        "y": 200,
+        "wires": []
+    },
+    {
+        "id": "chart-pres-1",
+        "type": "ui_chart",
+        "name": "Pressure",
+        "group": "lps33hw-group-1",
+        "order": 1,
+        "width": 6,
+        "height": 4,
+        "label": "Pressure (Pa)",
+        "chartType": "line",
+        "x": 700,
+        "y": 260,
+        "wires": []
+    },
+    {
+        "id": "chart-alt-1",
+        "type": "ui_chart",
+        "name": "Altitude",
+        "group": "lps33hw-group-1",
+        "order": 2,
+        "width": 6,
+        "height": 4,
+        "label": "Altitude (m)",
+        "chartType": "line",
+        "x": 700,
+        "y": 320,
+        "wires": []
+    },
+    {
+        "id": "chart-temp-1",
+        "type": "ui_chart",
+        "name": "Temperature",
+        "group": "lps33hw-group-1",
+        "order": 3,
+        "width": 6,
+        "height": 4,
+        "label": "Temperature (°C)",
+        "chartType": "line",
+        "x": 700,
+        "y": 380,
+        "wires": []
+    },
+    {
+        "id": "lps33hw-group-1",
+        "type": "ui_group",
+        "name": "LPS33HW Altimeter",
+        "tab": "lps33hw-tab-1",
+        "order": 1,
+        "disp": true,
+        "width": 12
+    },
+    {
+        "id": "lps33hw-tab-1",
+        "type": "ui_tab",
+        "name": "LPS33HW Demo",
+        "icon": "dashboard",
+        "order": 1,
+        "info": "This flow demonstrates the LPS33HW water-resistant MEMS pressure sensor as an altimeter.\n\nThe device config node sets **10 Hz ODR with the ODR/20 low-pass filter enabled** — a fresh pressure sample every 100 ms with the on-chip LPF (~0.5 Hz cutoff) suppressing door-slam and HVAC noise. An inject node fires every second; each tick reads pressure (Pa) and temperature (°C). A function node converts the pressure to relative altitude using the barometric formula `44330 * (1 - (p / 101325)^(1/5.255))`.\n\nBecause atmospheric pressure drifts with the weather (~1 hPa per ~8 m of equivalent altitude), the AUTOZERO reference is refreshed every 10 s via a second inject + function node pair. This makes the altitude chart a true *relative* measurement — climb one floor (~3 m) and watch the trace shift, then return.\n\nAdjust the I²C bus, address (0x5C for SA0=GND, 0x5D for SA0=VDD), ODR, and LPF bandwidth in the device config node. Drop ODR to 1 Hz and disable the LPF for battery-powered weather monitoring instead of altimetry."
+    }
+]