@whois-homebridge/homebridge-aranet4 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## 0.1.0 (Unreleased)
+
+Initial release.
+
+- BLE communication with Aranet4 devices via `@homebridge/noble`
+- HomeKit services: CO2, temperature, humidity, air quality (CO2-derived), battery, atmospheric pressure (Eve custom)
+- Local SQLite data persistence with configurable retention
+- Eve app historical graphs via fakegato-history
+- Device onboard history sync (opt-in, requires BLE pairing)
+- Multi-device auto-discovery and manual MAC address configuration
+- Exponential backoff reconnection and robust error handling
+- Cross-platform: macOS (Core Bluetooth) and Linux/Raspberry Pi (BlueZ)

package/README.md

@@ -0,0 +1,218 @@
+# homebridge-aranet4-advanced
+
+Homebridge plugin for the [Aranet4](https://aranet.com/products/aranet4/) CO2 and environment sensor. Exposes CO2, temperature, humidity, atmospheric pressure, air quality, and battery level to Apple HomeKit via passive BLE advertisement scanning.
+
+Supports [Eve](https://apps.apple.com/app/eve-for-matter-homekit/id917695792) app history graphs via FakeGato.
+
+## Features
+
+- **Passive BLE scanning** -- reads sensor data from Aranet4 advertisements without connecting, minimizing battery drain and BLE contention
+- **Minimal dependencies** -- passive BLE scanning, no database or heavy native modules required
+- **Multi-device support** -- monitor multiple Aranet4 sensors simultaneously
+- **Auto-discovery** -- finds Aranet4 devices in range automatically (or configure explicit MAC addresses)
+- **Eve history** -- temperature, humidity, and CO2 graphs in the Eve app
+- **HomeKit services**: CO2 Sensor, Temperature, Humidity, Air Quality, Atmospheric Pressure (Eve-compatible), Battery
+
+## Prerequisites
+
+- Homebridge v1.8+ or v2.0+
+- Node.js 20 or 22
+- A Bluetooth adapter (built-in or USB) supported by your OS
+- Aranet4 with **"Smart Home integrations"** enabled in the Aranet4 Home app
+
+### Enabling Smart Home Integrations
+
+The Aranet4 only broadcasts sensor data in BLE advertisements when this setting is enabled:
+
+1. Open the **Aranet4 Home** app on your phone
+2. Connect to your Aranet4 device
+3. Go to **Settings** > **Smart Home integrations**
+4. Toggle it **on**
+
+Without this, the plugin will detect the device by name but won't receive sensor data.
+
+## Installation
+
+Install via the Homebridge UI (search for `homebridge-aranet4-advanced`) or manually:
+
+```bash
+npm install -g homebridge-aranet4-advanced
+```
+
+### Bluetooth Permissions
+
+**macOS** -- Bluetooth works out of the box via Core Bluetooth. If running Homebridge via Terminal, grant Terminal Bluetooth permission in System Settings > Privacy & Security > Bluetooth.
+
+**Linux / Raspberry Pi** -- Install BlueZ and grant the Node.js binary BLE capabilities:
+
+```bash
+sudo apt-get install bluetooth bluez libbluetooth-dev libudev-dev
+sudo setcap cap_net_raw+eip $(eval readlink -f $(which node))
+```
+
+## Configuration
+
+### Minimal (auto-discovery)
+
+```json
+{
+  "platforms": [
+    {
+      "platform": "Aranet4",
+      "name": "Aranet4"
+    }
+  ]
+}
+```
+
+The plugin will discover any Aranet4 in range and create accessories automatically.
+
+### Explicit device configuration
+
+```json
+{
+  "platforms": [
+    {
+      "platform": "Aranet4",
+      "name": "Aranet4",
+      "devices": [
+        {
+          "name": "Living Room CO2",
+          "address": "AA:BB:CC:DD:EE:FF",
+          "pollingInterval": 120,
+          "co2AlertThreshold": 1000,
+          "lowBatteryThreshold": 15,
+          "enableHistory": true
+        }
+      ]
+    }
+  ]
+}
+```
+
+### Device options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `name` | string | `"Aranet4"` | Friendly name shown in HomeKit |
+| `address` | string | *(auto)* | Bluetooth MAC address (`AA:BB:CC:DD:EE:FF`). Recommended for multi-device setups. |
+| `pollingInterval` | integer | `60` | Seconds between HomeKit updates (60--3600). The Aranet4 broadcasts every ~1s; this throttles how often the plugin pushes updates. |
+| `co2AlertThreshold` | integer | `1000` | CO2 ppm level that triggers `CarbonDioxideDetected` in HomeKit (400--5000). |
+| `lowBatteryThreshold` | integer | `15` | Battery % below which low-battery alert triggers (5--50). |
+| `enableHistory` | boolean | `true` | Enable Eve app history graphs (via FakeGato). |
+
+### Finding your Aranet4 MAC address
+
+The plugin logs the MAC address of each discovered device at startup. Check your Homebridge logs for:
+
+```
+[Aranet4] Discovered Aranet4: "Aranet4 Home" [aabbccddeeff] via advertisement
+```
+
+Use that address (formatted as `AA:BB:CC:DD:EE:FF`) in your config.
+
+## HomeKit Services
+
+Each Aranet4 device exposes these services:
+
+| Sensor Data | HomeKit Service | Details |
+|-------------|----------------|---------|
+| CO2 (ppm) | CarbonDioxideSensor | Level + alert at configurable threshold |
+| Temperature (C) | TemperatureSensor | |
+| Humidity (%) | HumiditySensor | |
+| Air Quality | AirQualitySensor | Derived from CO2 level (see below) |
+| Pressure (hPa) | Eve custom characteristic | Visible in the Eve app |
+| Battery (%) | BatteryService | Low-battery alert at configurable threshold |
+
+### Air Quality Mapping
+
+| CO2 (ppm) | Air Quality |
+|-----------|-------------|
+| 0--600 | Excellent |
+| 601--800 | Good |
+| 801--1000 | Fair |
+| 1001--1500 | Inferior |
+| >1500 | Poor |
+
+## Troubleshooting
+
+### "No sensor data in advertisement"
+
+The Aranet4 was detected by name but isn't broadcasting sensor data. Enable **Smart Home integrations** in the Aranet4 Home app (see Prerequisites above).
+
+### Plugin starts but no devices found
+
+- Verify your Bluetooth adapter is working: `hciconfig` (Linux) or check System Settings (macOS)
+- Check Homebridge logs for `Bluetooth adapter state: poweredOn`
+- Ensure no other process is monopolizing the BLE adapter
+- On Linux, verify BLE capabilities are set (see Bluetooth Permissions above)
+
+### Readings appear stale or intermittent
+
+- The Aranet4 measures every 1--10 minutes (configurable on device). Between measurements, it broadcasts the last known reading.
+- BLE range is typically 10--20m. Move the Homebridge host closer to the sensor.
+- Other BLE devices can cause interference. A dedicated USB Bluetooth adapter may help.
+
+### "Bluetooth access denied" (macOS)
+
+On macOS, Bluetooth requires explicit permission per executable. The plugin logs a clear error when this happens. This affects both the main bridge and child bridge setups.
+
+**Fix — grant Bluetooth permission to the Node.js binary:**
+
+1. Open **System Settings → Privacy & Security → Bluetooth**
+2. Click the **+** button to add an application
+3. Press **Cmd+Shift+G** to open the path input dialog
+4. Type the path to your Node.js binary and press Enter:
+   - Homebrew: `/opt/homebrew/bin/node` (Apple Silicon) or `/usr/local/bin/node` (Intel)
+   - hb-service default: check the path shown in `sudo hb-service status` or in your Homebridge startup logs (look for the `Node.js` line)
+5. Select the binary and click **Open**
+6. Make sure the toggle next to `node` is **ON**
+7. Restart Homebridge
+
+This works for both the main bridge and child bridges because Homebridge child bridges use the same `node` binary (via `child_process.fork()`), and macOS tracks Bluetooth permission by executable path.
+
+**Caveats:**
+- If you update Node.js (e.g., via Homebrew), the binary path may change and you'll need to re-add it
+- If `node` is a symlink, you may need to add the resolved path instead (e.g., `/opt/homebrew/Cellar/node/24.14.1/bin/node`)
+
+### "BLE scan start failed"
+
+Make sure Bluetooth is enabled and the Node.js process has the necessary permissions (see Bluetooth Permissions above).
+
+### Sensor shows as inactive / "No data received"
+
+The plugin automatically marks sensors as inactive when no BLE advertisement is received for several minutes. This typically means:
+
+- The Aranet4 is out of BLE range (move it closer, typically within 10m)
+- The device is powered off or battery is dead
+- BLE interference from other devices
+
+The sensor will automatically recover when advertisements resume -- no restart required.
+
+## Development
+
+```bash
+git clone https://github.com/RobSim/homebridge-aranet4-advanced.git
+cd homebridge-aranet4-advanced
+npm install
+npm run build
+npm test
+```
+
+### Project structure
+
+```
+src/
+  index.ts              -- Plugin registration
+  platform.ts           -- Dynamic platform plugin (lifecycle, accessory management)
+  platformAccessory.ts  -- HomeKit service/characteristic setup per device
+  bleManager.ts         -- BLE scanning and advertisement parsing
+  aranet4Parser.ts      -- Binary protocol parser for Aranet4 data
+  settings.ts           -- Constants, types, UUIDs
+test/
+  *.test.ts             -- Jest test suites
+```
+
+## License
+
+MIT

package/config.schema.json

@@ -0,0 +1,88 @@
+{
+  "pluginAlias": "Aranet4",
+  "pluginType": "platform",
+  "singular": true,
+  "headerDisplay": "Connect your Aranet4 CO2 sensor to HomeKit with full history support.",
+  "footerDisplay": "For help, see the [README](https://github.com/RobSim/homebridge-aranet4-advanced#readme).",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "title": "Platform Name",
+        "type": "string",
+        "default": "Aranet4",
+        "required": true,
+        "description": "Display name for this platform instance."
+      },
+      "devices": {
+        "title": "Devices",
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "title": "Device Name",
+              "type": "string",
+              "default": "Aranet4",
+              "description": "A friendly name for this sensor."
+            },
+            "address": {
+              "title": "MAC Address",
+              "type": "string",
+              "description": "Bluetooth MAC address of the Aranet4 device (e.g., AA:BB:CC:DD:EE:FF). Leave blank for auto-discovery.",
+              "pattern": "^([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$"
+            },
+            "pollingInterval": {
+              "title": "Polling Interval (seconds)",
+              "type": "integer",
+              "default": 60,
+              "minimum": 60,
+              "maximum": 3600,
+              "description": "How often to read sensor data, in seconds. Minimum 60s."
+            },
+            "co2AlertThreshold": {
+              "title": "CO2 Alert Threshold (ppm)",
+              "type": "integer",
+              "default": 1000,
+              "minimum": 400,
+              "maximum": 5000,
+              "description": "CO2 level (ppm) at which CarbonDioxideDetected triggers."
+            },
+            "lowBatteryThreshold": {
+              "title": "Low Battery Threshold (%)",
+              "type": "integer",
+              "default": 15,
+              "minimum": 5,
+              "maximum": 50,
+              "description": "Battery percentage below which low-battery alert triggers."
+            },
+            "enableHistory": {
+              "title": "Enable Eve History",
+              "type": "boolean",
+              "default": true,
+              "description": "Enable historical graphs in the Eve app."
+            }
+          },
+          "required": ["name"]
+        }
+      },
+      "supabase": {
+        "title": "Supabase",
+        "type": "object",
+        "properties": {
+          "url": {
+            "title": "Project URL",
+            "type": "string",
+            "placeholder": "https://yourproject.supabase.co"
+          },
+          "key": {
+            "title": "Secret API Key",
+            "type": "string",
+            "placeholder": "your-secret-api-key",
+            "secret": true
+          }
+        }
+      }
+    }
+  }
+}

package/dist/aranet4Parser.d.ts

@@ -0,0 +1,57 @@
+import { Aranet4Reading } from './settings';
+/**
+ * Validate parsed sensor values. Returns a human-readable reason string
+ * if the reading should be rejected, or null if it looks valid.
+ */
+export declare function validateReading(reading: {
+    co2: number;
+    temperature: number;
+    pressure: number;
+    humidity: number;
+    battery: number;
+}): string | null;
+/**
+ * Parse a 13-byte extended readings buffer from the Aranet4 BLE characteristic
+ * (UUID suffix 3001) into a typed Aranet4Reading.
+ *
+ * Packet layout (little-endian):
+ *   Offset 0–1  : uint16  CO2 (ppm, raw)
+ *   Offset 2–3  : uint16  Temperature (raw ÷ 20 = °C)
+ *   Offset 4–5  : uint16  Pressure (raw ÷ 10 = hPa)
+ *   Offset 6    : uint8   Humidity (%, raw)
+ *   Offset 7    : uint8   Battery (%, raw)
+ *   Offset 8    : uint8   Status byte
+ *   Offset 9–10 : uint16  Interval (seconds)
+ *   Offset 11–12: uint16  Age (seconds since last measurement)
+ */
+export declare function parseExtendedReadings(buf: Buffer): Aranet4Reading;
+/**
+ * Parse Aranet4 manufacturer-specific advertisement data.
+ *
+ * When "Smart Home integrations" is enabled in the Aranet4 Home app, the
+ * device includes sensor data in its BLE advertisement manufacturer data.
+ *
+ * The manufacturer data starts with a 2-byte company ID (0x0702 for SAF
+ * Tehnika), followed by the payload.  Noble includes this company ID prefix
+ * in the buffer.
+ *
+ * Payload layout (little-endian, after 2-byte company ID):
+ *   Byte  0      : uint8   Flags (bit 5 = integrations enabled)
+ *   Byte  1–3    : uint8×3 Firmware version (patch, minor, major)
+ *   Byte  4–5    : uint16  Device type / padding
+ *   Byte  6–7    : uint16  Additional header
+ *   Byte  8–9    : uint16  CO2 (ppm)
+ *   Byte  10–11  : uint16  Temperature (raw ÷ 20 = °C)
+ *   Byte  12–13  : uint16  Pressure (raw ÷ 10 = hPa)
+ *   Byte  14     : uint8   Humidity (%)
+ *   Byte  15     : uint8   Battery (%)
+ *   Byte  16     : uint8   Status flags
+ *   Byte  17–18  : uint16  Interval (seconds)
+ *   Byte  19–20  : uint16  Age (seconds since last measurement)
+ *
+ * Reference: https://github.com/Anrijs/Aranet4-Python
+ *            https://github.com/Anrijs/Aranet4-ESP32
+ *
+ * Returns null if the buffer doesn't contain valid Aranet4 data.
+ */
+export declare function parseAdvertisement(manufacturerData: Buffer): Aranet4Reading | null;

package/dist/aranet4Parser.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateReading = validateReading;
+exports.parseExtendedReadings = parseExtendedReadings;
+exports.parseAdvertisement = parseAdvertisement;
+// ---------------------------------------------------------------------------
+// Plausible sensor value ranges for sanity checking.
+// Values outside these ranges indicate sensor warmup, malfunction, or bad data.
+// ---------------------------------------------------------------------------
+/** CO2 0 or 65535 = sensor warmup / invalid. Valid range: 0–10000 ppm. */
+const CO2_MIN = 1;
+const CO2_MAX = 10_000;
+/** Temperature valid range: −40 °C to +60 °C (Aranet4 spec: 0–50 °C). */
+const TEMP_MIN = -40;
+const TEMP_MAX = 60;
+/** Humidity valid range: 0–100 %. */
+const HUMIDITY_MAX = 100;
+/** Pressure valid range: 300–1200 hPa (covers Dead Sea to Everest). */
+const PRESSURE_MIN = 300;
+const PRESSURE_MAX = 1200;
+/**
+ * Validate parsed sensor values. Returns a human-readable reason string
+ * if the reading should be rejected, or null if it looks valid.
+ */
+function validateReading(reading) {
+    if (reading.co2 < CO2_MIN || reading.co2 > CO2_MAX) {
+        return `CO2 out of range: ${reading.co2} ppm`;
+    }
+    if (reading.temperature < TEMP_MIN || reading.temperature > TEMP_MAX) {
+        return `Temperature out of range: ${reading.temperature} °C`;
+    }
+    if (reading.humidity > HUMIDITY_MAX) {
+        return `Humidity out of range: ${reading.humidity}%`;
+    }
+    if (reading.pressure !== 0 && (reading.pressure < PRESSURE_MIN || reading.pressure > PRESSURE_MAX)) {
+        return `Pressure out of range: ${reading.pressure} hPa`;
+    }
+    if (reading.battery > 100) {
+        return `Battery out of range: ${reading.battery}%`;
+    }
+    return null;
+}
+/**
+ * Parse a 13-byte extended readings buffer from the Aranet4 BLE characteristic
+ * (UUID suffix 3001) into a typed Aranet4Reading.
+ *
+ * Packet layout (little-endian):
+ *   Offset 0–1  : uint16  CO2 (ppm, raw)
+ *   Offset 2–3  : uint16  Temperature (raw ÷ 20 = °C)
+ *   Offset 4–5  : uint16  Pressure (raw ÷ 10 = hPa)
+ *   Offset 6    : uint8   Humidity (%, raw)
+ *   Offset 7    : uint8   Battery (%, raw)
+ *   Offset 8    : uint8   Status byte
+ *   Offset 9–10 : uint16  Interval (seconds)
+ *   Offset 11–12: uint16  Age (seconds since last measurement)
+ */
+function parseExtendedReadings(buf) {
+    if (buf.length < 13) {
+        throw new Error(`Expected at least 13 bytes for extended readings, got ${buf.length}`);
+    }
+    const co2 = buf.readUInt16LE(0);
+    const temperatureRaw = buf.readUInt16LE(2);
+    const pressureRaw = buf.readUInt16LE(4);
+    const humidity = buf.readUInt8(6);
+    const battery = buf.readUInt8(7);
+    const status = buf.readUInt8(8);
+    const interval = buf.readUInt16LE(9);
+    const age = buf.readUInt16LE(11);
+    const reading = {
+        co2,
+        temperature: temperatureRaw / 20,
+        pressure: pressureRaw / 10,
+        humidity,
+        battery,
+        status,
+        interval,
+        age,
+        timestamp: Date.now(),
+    };
+    const invalid = validateReading(reading);
+    if (invalid) {
+        throw new Error(`Invalid sensor data: ${invalid}`);
+    }
+    return reading;
+}
+/**
+ * Parse Aranet4 manufacturer-specific advertisement data.
+ *
+ * When "Smart Home integrations" is enabled in the Aranet4 Home app, the
+ * device includes sensor data in its BLE advertisement manufacturer data.
+ *
+ * The manufacturer data starts with a 2-byte company ID (0x0702 for SAF
+ * Tehnika), followed by the payload.  Noble includes this company ID prefix
+ * in the buffer.
+ *
+ * Payload layout (little-endian, after 2-byte company ID):
+ *   Byte  0      : uint8   Flags (bit 5 = integrations enabled)
+ *   Byte  1–3    : uint8×3 Firmware version (patch, minor, major)
+ *   Byte  4–5    : uint16  Device type / padding
+ *   Byte  6–7    : uint16  Additional header
+ *   Byte  8–9    : uint16  CO2 (ppm)
+ *   Byte  10–11  : uint16  Temperature (raw ÷ 20 = °C)
+ *   Byte  12–13  : uint16  Pressure (raw ÷ 10 = hPa)
+ *   Byte  14     : uint8   Humidity (%)
+ *   Byte  15     : uint8   Battery (%)
+ *   Byte  16     : uint8   Status flags
+ *   Byte  17–18  : uint16  Interval (seconds)
+ *   Byte  19–20  : uint16  Age (seconds since last measurement)
+ *
+ * Reference: https://github.com/Anrijs/Aranet4-Python
+ *            https://github.com/Anrijs/Aranet4-ESP32
+ *
+ * Returns null if the buffer doesn't contain valid Aranet4 data.
+ */
+function parseAdvertisement(manufacturerData) {
+    // Company ID (2) + header (8) + CO2 (2) + temperature (2) = 14 bytes minimum
+    if (manufacturerData.length < 14) {
+        return null;
+    }
+    // Skip 2-byte company ID — remaining bytes are the payload
+    const d = manufacturerData.subarray(2);
+    // Need at least 12 bytes: 8-byte header + CO2 (2) + temperature (2)
+    if (d.length < 12) {
+        return null;
+    }
+    // Sensor data starts at byte 8, after the 8-byte header
+    const co2 = d.readUInt16LE(8);
+    const temperatureRaw = d.readUInt16LE(10);
+    // Remaining fields may not be present in shorter advertisements
+    const pressure = d.length >= 14 ? d.readUInt16LE(12) / 10 : 0;
+    const humidity = d.length >= 15 ? d.readUInt8(14) : 0;
+    const battery = d.length >= 16 ? d.readUInt8(15) : 0;
+    const status = d.length >= 17 ? d.readUInt8(16) : 0;
+    const interval = d.length >= 19 ? d.readUInt16LE(17) : 0;
+    const age = d.length >= 21 ? d.readUInt16LE(19) : 0;
+    const reading = {
+        co2,
+        temperature: temperatureRaw / 20,
+        pressure,
+        humidity,
+        battery,
+        status,
+        interval,
+        age,
+        timestamp: Date.now(),
+    };
+    const invalid = validateReading(reading);
+    if (invalid) {
+        return null; // Silently skip — advertisements can contain stale/warmup data
+    }
+    return reading;
+}
+//# sourceMappingURL=aranet4Parser.js.map

package/dist/aranet4Parser.js.map

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

package/dist/bleManager.d.ts

@@ -0,0 +1,56 @@
+import { Logger } from 'homebridge';
+import { Aranet4Reading, Aranet4DeviceConfig } from './settings';
+/** Callback invoked each time fresh sensor data arrives. */
+export type ReadingCallback = (deviceId: string, reading: Aranet4Reading) => void;
+/** Callback invoked when a device hasn't been heard from in too long. */
+export type StaleCallback = (deviceId: string) => void;
+export declare class BleManager {
+    private readonly log;
+    private readonly deviceConfigs;
+    private readonly devices;
+    private scanning;
+    private readingCallback;
+    private staleCallback;
+    private poweredOn;
+    private shuttingDown;
+    private scanRestartTimer;
+    private scanRetryTimer;
+    private staleCheckTimer;
+    private scanRetryDelay;
+    private loggedUnauthorized;
+    private readonly onStateChange;
+    private readonly onDiscover;
+    private readonly onScanStop;
+    private readonly onWarning;
+    constructor(log: Logger, deviceConfigs: Aranet4DeviceConfig[]);
+    /** Register a callback that will be invoked on every new reading. */
+    onReading(cb: ReadingCallback): void;
+    /** Register a callback for when a device goes stale (no data for too long). */
+    onStale(cb: StaleCallback): void;
+    /** Begin scanning. Call once after Homebridge finishes launching. */
+    start(): void;
+    /** Gracefully shut down — stop scanning, clear all timers. */
+    shutdown(): void;
+    private handleStateChange;
+    private startScan;
+    private stopScan;
+    /**
+     * Handle noble's scanStop event — scanning was interrupted externally
+     * (another app took BLE, adapter reset, etc.).
+     *
+     * Debounced: noble issue #569 documents scanStop firing rapidly after
+     * reboots. We only schedule one restart attempt at a time.
+     */
+    private handleScanStop;
+    /**
+     * Schedule a scan retry with exponential backoff after a startScanning failure.
+     */
+    private scheduleScanRetry;
+    private checkForStaleDevices;
+    private clearTimers;
+    private handleDiscovery;
+    private processAdvertisement;
+    private handleAranet4Advertisement;
+    private findConfigForPeripheral;
+    private buildDefaultConfig;
+}