@lv426/homebridge-systemair-enhanced 1.0.5 → 2.0.0

package/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+## 2.0.0
+
+A rewrite: faster, a switch for every mode, timers, and the fan's real level.
+
+### New
+
+- **A switch per mode** for scenes and automations: Auto, Visitors (the unit's Crowded), Refresh, Fireplace, Away and Holiday. Only one is on at a time; turning the one that's on off goes back to what it interrupted (Auto, or the manual level you had), as the unit itself does when a mode's time is up.
+- **Refresh and Fireplace timers**: set how long the mode lasts from the Home app, and watch it count down.
+- **The fan shows the level it really runs at**, Auto included: Low 16%, Normal 50%, High 83%, Maximum 100%. The top of the slider starts Refresh, the only way to Maximum. The fan's Auto setting switches back to Auto.
+- **Outdoor temperature** and **filter life** tiles.
+- **Settings in Homebridge's web interface**: which modes and timers to show, your own names for the modes, how often the unit is read.
+
+### Changed
+
+- **The unit is read in one request every 10 seconds** and HomeKit is told about each change. 1.x asked the unit separately for every value the Home app wanted, waiting up to 20 seconds each, so tiles could show "No Response".
+- **The Refresh switch stays on while Refresh runs**, and turning it off ends Refresh. In 1.x it turned itself off after a second.
+- **The thermostat's range is the unit's**, 12–30 °C in half degrees.
+- The Timer tile (time left shown as a battery level) is gone: the timers count down instead.
+- Written in TypeScript, with tests; needs Homebridge 1.8 or 2.x and Node 20 or newer.
+
+### Fixed
+
+- **Refresh no longer changes your settings.** 1.x sent the unit's whole Home form to start it, which also set the temperature to 18 °C, the manual level to Low and ECO mode off.
+- **During Refresh the fan showed 16%** (the manual Low setting) while the unit ran at Maximum.
+
+## 1.0.6 and earlier
+
+See [npm](https://www.npmjs.com/package/@lv426/homebridge-systemair-enhanced?activeTab=versions).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 foxhoundn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,94 +1,134 @@
-# Homebridge Systemair Ventilator Plugin
+<p align="center">
+  <img src="icon.png" width="120" alt="Systemair Ventilator for Homebridge" />
+</p>
+
+<h1 align="center">Systemair Ventilator for Homebridge</h1>
 
-This is a Homebridge plugin for controlling a Systemair Ventilator through its web interface then into HomeKit. You must have a SAVEConnect WIFI module connected for this to work. You will need the IP address of the SAVEConnect device and include it in the plugin settings.
+<p align="center">
+  Your Systemair SAVE ventilation in Apple Home: modes for scenes, timers, the fan's real level,<br />
+  temperature, humidity, the outdoor temperature and the filter.
+</p>
 
-This plugin provides comprehensive control of your Systemair ventilator including:
+<p align="center">
+  <a href="https://www.npmjs.com/package/@lv426/homebridge-systemair-enhanced"><img src="https://img.shields.io/npm/v/@lv426/homebridge-systemair-enhanced?label=npm" alt="npm version" /></a>
+  <a href="https://github.com/Foxhoundn/homebridge-systemair-enhanced/actions/workflows/ci.yml"><img src="https://github.com/Foxhoundn/homebridge-systemair-enhanced/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+  <img src="https://img.shields.io/badge/homebridge-1.8%20%7C%202.x-blueviolet" alt="Homebridge 1.8 and 2.x" />
+  <a href="LICENSE"><img src="https://img.shields.io/npm/l/@lv426/homebridge-systemair-enhanced" alt="MIT licence" /></a>
+</p>
 
-- **Fan Speed Control**: Adjust ventilation speeds with multiple settings
-- **Temperature Control**: Set target temperature and view current temperature
-- **Humidity Monitoring**: Monitor current humidity levels
-- **Thermostat Interface**: Control heating/cooling/auto modes through HomeKit's thermostat interface
+---
 
-# Installation:
+It talks to the unit's **SAVE Connect** module the same way the module's own web page does, so there's no cloud, no account and no Modbus wiring: if you can open the unit's web page in a browser, this plugin can run it.
 
-If Homebridge is not already installed, use the following command to install it globally:
+## What you get in the Home app
 
-1. Install Homebridge:
+| Tile | What it does |
+| --- | --- |
+| **Fan** | Shows the level the fans really run at, Auto included. Drag it to run them manually at Low, Normal or High; drag it to the top to start Refresh; switch it back to Auto, or off. |
+| **Auto, Visitors, Refresh, Fireplace, Away, Holiday** | A switch per mode, for scenes and automations. Only one is on at a time. Turning the one that's on off goes back to what it interrupted: Auto, or the manual level you had. |
+| **Refresh timer, Fireplace timer** | Set how long the mode lasts (the tile's Duration), turn it on, and watch it count down. |
+| **Thermostat** | The temperature in the house and the setpoint (12–30 °C). |
+| **Eco Mode** | The unit's ECO mode. |
+| **Humidity** | Relative humidity of the extract air. |
+| **Outdoor** | The unit's outdoor temperature sensor. |
+| **Filter** | How much filter life is left; the Home app tells you when it's time to change it. |
 
-   ```bash
-   npm install -g homebridge
+The unit is read in one request every 10 seconds, and HomeKit is told about each change, so the Home app opens straight away and automations see changes within seconds.
 
-   ```
+### The fan slider
 
-2. Install the Plugin
+The slider shows and sets the unit's airflow levels:
 
-   ```bash
-   npm install -g @lv426/homebridge-systemair-enhanced
-   Run the following command to install the Homebridge Systemair Ventilator plugin:
+| Slider | The unit runs | Shown as |
+| --- | --- | --- |
+| 0% | Off (Manual) | 0% |
+| 1–33% | Manual, **Low** | 16% |
+| 34–66% | Manual, **Normal** | 50% |
+| 67–91% | Manual, **High** | 83% |
+| 92–100% | **Refresh**, at Maximum for its set time, then back to what it was doing | 100% |
 
-   ```
+Manual mode can't go above High: Maximum is reached only by modes like Refresh. Turning the fans off needs **Manual fan stop** allowed on the unit.
 
-3. Configure the Plugin
-   Edit the Homebridge config.json file to include the plugin. Add the following under "accessories":
+### The modes
 
-   ```yaml
-   {
-     "accessories": [
-       {
-         "accessory": "SystemairVentilatorEnhanced",
-         "name": "Living Room Ventilator",
-         "ip": "x.x.x.x"
-       }
-     ]
-   }
-   Replace add your Systemair IP with the actual IP address of your Systemair SAVEConnect device.
+| Mode | What the unit does | How long |
+| --- | --- | --- |
+| **Auto** | Follows its week schedule and demand control. | — |
+| **Visitors** (the unit's *Crowded*) | More air for a full house. | 1–8 hours |
+| **Refresh** | As much air as it can, to air the house out. | 1–240 minutes |
+| **Fireplace** | Slight overpressure, so the fireplace draws well. | 1–60 minutes |
+| **Away** | Less air while you're out. | 1–72 hours |
+| **Holiday** | Less air for longer, while you're away for days. | 1–365 days |
 
-   ```
+How long each mode lasts is the unit's own setting: the timer tiles change it for Refresh and Fireplace, and the unit's web page for the rest. When a mode's time is up, the unit goes back to the mode it interrupted. Changing a timer's minutes while its mode runs saves them for next time; the running mode keeps its countdown.
 
-4. Restart Homebridge
-   Restart Homebridge for the changes to take effect:
-   ```bash
-   sudo systemctl restart homebridge
-   ```
+*Cooker hood* and *Vacuum cleaner* modes are started by switches wired to the unit, so HomeKit can't start them.
 
-# Features:
+## Install
 
-Control fan speeds with three settings: Low, Medium, and High.
-Adjust the target temperature directly from HomeKit.
-View current temperature and humidity readings.
-Control heating/cooling/auto modes through the thermostat interface.
-Automatically handles fan activation and speed synchronization.
-Create scenes for Low, Normal, and High with the following mappings:
+Search for **Systemair Ventilator** under **Plugins** in Homebridge's web interface and install it, or:
 
-speed === 1 maps to 0% (Off)
-speed === 2 maps to 16% (Low)
-speed === 3 maps to 50% (Normal)
-speed === 4 maps to 83% (High)
+```bash
+npm install -g @lv426/homebridge-systemair-enhanced
+```
 
-# Troubleshooting:
+You need a Systemair SAVE unit with a **SAVE Connect** module on your network, and its address (the one you open its web page at). Give it a fixed address in your router so it doesn't move.
 
-If the ventilator doesn't respond, check the following:
+## Settings
 
-Ensure the IP address in the configuration is correct.
-Verify that the SAVEConnect WIFI module is online.
-Check Homebridge logs for error messages.
+Fill them in under the plugin's **Settings** in Homebridge's web interface, or add this to `config.json`:
 
-**Note**: The plugin creates multiple HomeKit accessories:
+```json
+{
+  "accessories": [
+    {
+      "accessory": "SystemairVentilatorEnhanced",
+      "name": "Ventilation",
+      "ip": "192.168.1.50"
+    }
+  ]
+}
+```
 
-- **Fan**: Controls ventilation speed and on/off state
-- **Thermostat**: Controls target temperature and heating/cooling modes
-- **Humidity Sensor**: Displays current humidity levels
-- **Refresh Switch**: Triggers refresh mode
-- **Timer Display**: Shows remaining timer (displayed as battery level)
+| Setting | What it does | Default |
+| --- | --- | --- |
+| `name` | Each tile is named after it: "Ventilation Fan", "Ventilation Refresh". | `Ventilation` |
+| `ip` | The SAVE Connect module's address. | — |
+| `modeSwitches` | The modes shown as switches: `auto`, `crowded`, `refresh`, `fireplace`, `away`, `holiday`. | all six |
+| `timers` | The modes with a timer tile: `refresh`, `fireplace`. | both |
+| `modeNames` | Your own names, for example `{ "refresh": "Air out" }`. | Crowded is `Visitors`; the rest as on the unit |
+| `eco` | Show the ECO mode switch. | `true` |
+| `outdoorTemperature` | Show the outdoor temperature. | `true` |
+| `filter` | Show the filter. | `true` |
+| `pollSeconds` | How often the unit is read (at least 5). | `10` |
 
-## Parameter IDs:
+## Upgrading from 1.x
 
-The plugin uses the following Systemair SAVEConnect parameter IDs:
+The accessory and the tiles 1.x had (the fan, the Refresh and Eco Mode switches, the thermostat and humidity) stay the same to HomeKit, so scenes and automations that use them keep working. The new tiles appear next to them. See the [changelog](CHANGELOG.md) for what changed.
 
-- **1130**: Fan speed control (0=off, 2=low, 3=medium, 4=high)
-- **1110**: Timer remaining time
-- **1120**: Current temperature sensor reading
-- **2000**: Target temperature setting
-- **1125**: Current humidity sensor reading
+## How it talks to the unit
 
-**Important**: These parameter IDs are based on common Systemair configurations but may vary by device model. If temperature or humidity readings are not working correctly, you may need to modify the parameter IDs in the code to match your specific device's API configuration.
+Like the unit's own web page: `GET /mread?{"1160":1}` reads registers and `GET /mwrite?{"1161":4}` writes them, one request at a time. The registers and modes are listed in [`src/registers.ts`](src/registers.ts) and [`src/modes.ts`](src/modes.ts), each as the web page names it.
+
+## Development
+
+```bash
+npm install
+npm run check   # typecheck and tests
+npm run build
+```
+
+The tests cover the register mapping (from a real unit's replies), the client and the accessory on Homebridge's own HomeKit library.
+
+**Releasing:** bump the version and push to `master`; GitHub Actions publishes it to npm, tags it, creates the GitHub release from the [changelog](CHANGELOG.md) and posts to Discord.
+
+```bash
+npm version patch   # or minor, major, or prerelease --preid beta
+git push --follow-tags
+```
+
+A prerelease (`2.1.0-beta.1`) is published under npm's `beta` tag.
+
+## Licence
+
+[MIT](LICENSE)

package/config.schema.json

@@ -0,0 +1,98 @@
+{
+  "pluginAlias": "SystemairVentilatorEnhanced",
+  "pluginType": "accessory",
+  "singular": false,
+  "headerDisplay": "Systemair SAVE ventilation through its SAVE Connect module: the fan, a switch per mode for scenes, timers for Refresh and Fireplace, temperature, humidity and the filter.",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "title": "Name",
+        "type": "string",
+        "default": "Ventilation",
+        "required": true,
+        "description": "Each tile is named after it: \"Ventilation Fan\", \"Ventilation Refresh\"…"
+      },
+      "ip": {
+        "title": "SAVE Connect address",
+        "type": "string",
+        "required": true,
+        "placeholder": "192.168.68.57",
+        "description": "The address you open the unit's web page at."
+      },
+      "pollSeconds": {
+        "title": "Read the unit every (seconds)",
+        "type": "integer",
+        "default": 10,
+        "minimum": 5
+      },
+      "modeSwitches": {
+        "title": "Modes to show as switches",
+        "description": "For scenes and automations. Only one is on at a time; turning the one that's on off goes back to Auto.",
+        "type": "array",
+        "uniqueItems": true,
+        "default": ["auto", "crowded", "refresh", "fireplace", "away", "holiday"],
+        "items": {
+          "type": "string",
+          "enum": ["auto", "crowded", "refresh", "fireplace", "away", "holiday"],
+          "enumNames": ["Auto", "Visitors (Crowded)", "Refresh", "Fireplace", "Away", "Holiday"]
+        }
+      },
+      "timers": {
+        "title": "Modes with a timer",
+        "description": "A timer tile sets how long the mode lasts (the Home app's Duration, up to an hour) and counts down while it runs.",
+        "type": "array",
+        "uniqueItems": true,
+        "default": ["refresh", "fireplace"],
+        "items": {
+          "type": "string",
+          "enum": ["refresh", "fireplace"],
+          "enumNames": ["Refresh", "Fireplace"]
+        }
+      },
+      "modeNames": {
+        "title": "Your own names for the modes",
+        "type": "object",
+        "properties": {
+          "auto": { "title": "Auto", "type": "string", "placeholder": "Auto" },
+          "crowded": { "title": "Crowded", "type": "string", "placeholder": "Visitors" },
+          "refresh": { "title": "Refresh", "type": "string", "placeholder": "Refresh" },
+          "fireplace": { "title": "Fireplace", "type": "string", "placeholder": "Fireplace" },
+          "away": { "title": "Away", "type": "string", "placeholder": "Away" },
+          "holiday": { "title": "Holiday", "type": "string", "placeholder": "Holiday" }
+        }
+      },
+      "eco": {
+        "title": "Show the ECO mode switch",
+        "type": "boolean",
+        "default": true
+      },
+      "outdoorTemperature": {
+        "title": "Show the outdoor temperature",
+        "type": "boolean",
+        "default": true
+      },
+      "filter": {
+        "title": "Show the filter (time to change it)",
+        "type": "boolean",
+        "default": true
+      }
+    }
+  },
+  "layout": [
+    "name",
+    "ip",
+    {
+      "type": "fieldset",
+      "title": "Modes",
+      "expandable": true,
+      "items": ["modeSwitches", "timers", "modeNames"]
+    },
+    {
+      "type": "fieldset",
+      "title": "More",
+      "expandable": true,
+      "items": ["eco", "outdoorTemperature", "filter", "pollSeconds"]
+    }
+  ]
+}

package/dist/config.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TIMER_MAX_SECONDS = exports.DEFAULT_MODE_NAMES = exports.DEFAULT_TIMERS = exports.DEFAULT_MODE_SWITCHES = void 0;
+exports.readConfig = readConfig;
+const modes_js_1 = require("./modes.js");
+exports.DEFAULT_MODE_SWITCHES = [
+    'auto',
+    'crowded',
+    'refresh',
+    'fireplace',
+    'away',
+    'holiday',
+];
+exports.DEFAULT_TIMERS = ['refresh', 'fireplace'];
+/** What people call the unit's Crowded mode. */
+exports.DEFAULT_MODE_NAMES = { crowded: 'Visitors' };
+/** The Home app counts a valve's duration down from at most an hour. */
+exports.TIMER_MAX_SECONDS = 3600;
+const MIN_POLL_SECONDS = 5;
+const isRecord = (value) => Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+function modeList(value, allowed, fallback) {
+    if (!Array.isArray(value))
+        return fallback;
+    return allowed.filter((id) => value.includes(id));
+}
+/** The plugin's settings from Homebridge's config, with defaults for what's left out. */
+function readConfig(raw) {
+    const config = isRecord(raw) ? raw : {};
+    const ip = typeof config.ip === 'string' ? config.ip.trim() : '';
+    if (!ip)
+        throw new Error('Set "ip" to the SAVE Connect module\'s address in the plugin settings');
+    const poll = Number(config.pollSeconds);
+    const names = isRecord(config.modeNames) ? config.modeNames : {};
+    const settable = modes_js_1.SETTABLE_MODES.map((mode) => mode.id).filter((id) => id !== 'manual');
+    const timed = modes_js_1.MODES.filter((mode) => mode.duration?.unit === 'minutes').map((mode) => mode.id);
+    return {
+        name: typeof config.name === 'string' && config.name.trim() ? config.name.trim() : 'Ventilation',
+        ip,
+        pollSeconds: Number.isFinite(poll) && poll >= MIN_POLL_SECONDS ? poll : 10,
+        modeSwitches: modeList(config.modeSwitches, settable, exports.DEFAULT_MODE_SWITCHES),
+        timers: modeList(config.timers, timed, exports.DEFAULT_TIMERS),
+        modeNames: {
+            ...exports.DEFAULT_MODE_NAMES,
+            ...Object.fromEntries(modes_js_1.MODES.flatMap((mode) => {
+                const name = names[mode.id];
+                return typeof name === 'string' && name.trim() ? [[mode.id, name.trim()]] : [];
+            })),
+        },
+        eco: config.eco !== false,
+        outdoorTemperature: config.outdoorTemperature !== false,
+        filter: config.filter !== false,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.js

@@ -0,0 +1,8 @@
+"use strict";
+const ventilator_js_1 = require("./ventilator.js");
+/** The accessory's name in Homebridge's config (`"accessory": "SystemairVentilatorEnhanced"`). */
+const ACCESSORY_NAME = 'SystemairVentilatorEnhanced';
+module.exports = (api) => {
+    api.registerAccessory(ACCESSORY_NAME, ventilator_js_1.SystemairVentilator);
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,mDAAsD;AAEtD,kGAAkG;AAClG,MAAM,cAAc,GAAG,6BAA6B,CAAC;AAErD,iBAAS,CAAC,GAAQ,EAAQ,EAAE;IAC1B,GAAG,CAAC,iBAAiB,CAAC,cAAc,EAAE,mCAAmB,CAAC,CAAC;AAC7D,CAAC,CAAC"}

package/dist/modes.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SETTABLE_MODES = exports.MODES = void 0;
+exports.modeById = modeById;
+exports.modeByCurrent = modeByCurrent;
+exports.durationSeconds = durationSeconds;
+exports.durationValue = durationValue;
+/**
+ * The unit's modes. Requests and durations are the web page's own (its mode menu and timer
+ * pop-up); Cooker hood and Vacuum cleaner come from Systemair's Modbus list: they're started by
+ * switches wired to the unit, so they can be seen but not set.
+ */
+exports.MODES = [
+    { id: 'auto', name: 'Auto', current: 0, request: 1 },
+    { id: 'manual', name: 'Manual', current: 1, request: 2 },
+    {
+        id: 'crowded',
+        name: 'Crowded',
+        current: 2,
+        request: 3,
+        duration: { register: 1104, unit: 'hours', min: 1, max: 8 },
+    },
+    {
+        id: 'refresh',
+        name: 'Refresh',
+        current: 3,
+        request: 4,
+        duration: { register: 1103, unit: 'minutes', min: 1, max: 240 },
+    },
+    {
+        id: 'fireplace',
+        name: 'Fireplace',
+        current: 4,
+        request: 5,
+        duration: { register: 1102, unit: 'minutes', min: 1, max: 60 },
+    },
+    {
+        id: 'away',
+        name: 'Away',
+        current: 5,
+        request: 6,
+        duration: { register: 1101, unit: 'hours', min: 1, max: 72 },
+    },
+    {
+        id: 'holiday',
+        name: 'Holiday',
+        current: 6,
+        request: 7,
+        duration: { register: 1100, unit: 'days', min: 1, max: 365 },
+    },
+    { id: 'cookerHood', name: 'Cooker hood', current: 7 },
+    { id: 'vacuumCleaner', name: 'Vacuum cleaner', current: 8 },
+];
+function modeById(id) {
+    const mode = exports.MODES.find((item) => item.id === id);
+    if (!mode)
+        throw new Error(`Unknown mode ${id}`);
+    return mode;
+}
+function modeByCurrent(value) {
+    return exports.MODES.find((mode) => mode.current === value);
+}
+/** The modes HomeKit can switch on (everything but those only a wired input starts). */
+exports.SETTABLE_MODES = exports.MODES.filter((mode) => mode.request !== undefined);
+const UNIT_SECONDS = {
+    minutes: 60,
+    hours: 3600,
+    days: 86_400,
+};
+/** A duration in the unit's own terms (35 minutes) as seconds. */
+function durationSeconds(duration, value) {
+    return value * UNIT_SECONDS[duration.unit];
+}
+/** Seconds as the unit keeps the duration: whole minutes, hours or days, within its limits. */
+function durationValue(duration, seconds) {
+    const value = Math.round(seconds / UNIT_SECONDS[duration.unit]);
+    return Math.min(duration.max, Math.max(duration.min, value));
+}
+//# sourceMappingURL=modes.js.map

package/dist/modes.js.map

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

package/dist/registers.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SETPOINT_RANGE = exports.FAN_LEVELS = exports.REGISTER = void 0;
+exports.fanLevel = fanLevel;
+/**
+ * Systemair SAVE Connect registers, as the unit's own web page uses them (its `scripts.js`):
+ * `GET /mread?{"1160":1}` reads (register → how many registers), `GET /mwrite?{"1161":4}` writes.
+ * Temperatures are tenths of a degree; a time split over two registers is seconds (low, high).
+ */
+exports.REGISTER = {
+    /** Write to change the mode: see `MODES[].request`. */
+    modeRequest: 1161,
+    /** The mode it's in now: see `MODES[].current`. */
+    modeCurrent: 1160,
+    /** Manual mode's airflow: 0 off, 2 low, 3 normal, 4 high. */
+    manualLevel: 1130,
+    /** Time left in a timed mode, seconds (with 1111). */
+    remaining: 1110,
+    /** Whether Manual may stop the fans altogether (1 yes). */
+    manualStopAllowed: 1352,
+    /** What the fans actually run at, percent. */
+    supplyFanOutput: 14000,
+    extractFanOutput: 14001,
+    /** Each airflow level's supply and extract percentages, Minimum to Maximum (1400–1409). */
+    fanLevelPercents: 1400,
+    /** Extract air temperature (what the house is at), tenths of °C. */
+    extractTemperature: 12543,
+    outdoorTemperature: 12101,
+    supplyTemperature: 12102,
+    /** Temperature setpoint, tenths of °C (12–30 °C on the unit). */
+    setpoint: 2000,
+    /** Relative humidity, percent. */
+    humidity: 12135,
+    /** ECO mode: 1 on. */
+    eco: 2504,
+    /** How often the filter is changed, months. */
+    filterPeriod: 7000,
+    /** Time left until the filter change, seconds (with 7005). */
+    filterRemaining: 7004,
+};
+/** The unit's airflow levels, lowest first. */
+exports.FAN_LEVELS = [
+    { id: 'off', name: 'Off', value: 0, speed: 0, manual: true },
+    { id: 'minimum', name: 'Minimum', value: 1, speed: 8, supplyRegister: 1400, manual: false },
+    { id: 'low', name: 'Low', value: 2, speed: 16, supplyRegister: 1402, manual: true },
+    { id: 'normal', name: 'Normal', value: 3, speed: 50, supplyRegister: 1404, manual: true },
+    { id: 'high', name: 'High', value: 4, speed: 83, supplyRegister: 1406, manual: true },
+    { id: 'maximum', name: 'Maximum', value: 5, speed: 100, supplyRegister: 1408, manual: false },
+];
+function fanLevel(id) {
+    const level = exports.FAN_LEVELS.find((item) => item.id === id);
+    if (!level)
+        throw new Error(`Unknown fan level ${id}`);
+    return level;
+}
+/** The unit's setpoint range, °C. */
+exports.SETPOINT_RANGE = { min: 12, max: 30 };
+//# sourceMappingURL=registers.js.map

package/dist/registers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registers.js","sourceRoot":"","sources":["../src/registers.ts"],"names":[],"mappings":";;;;AAAA;;;;GAIG;AACU,QAAA,QAAQ,GAAG;IACtB,uDAAuD;IACvD,WAAW,EAAE,IAAI;IACjB,mDAAmD;IACnD,WAAW,EAAE,IAAI;IACjB,6DAA6D;IAC7D,WAAW,EAAE,IAAI;IACjB,sDAAsD;IACtD,SAAS,EAAE,IAAI;IACf,2DAA2D;IAC3D,iBAAiB,EAAE,IAAI;IACvB,8CAA8C;IAC9C,eAAe,EAAE,KAAK;IACtB,gBAAgB,EAAE,KAAK;IACvB,2FAA2F;IAC3F,gBAAgB,EAAE,IAAI;IACtB,oEAAoE;IACpE,kBAAkB,EAAE,KAAK;IACzB,kBAAkB,EAAE,KAAK;IACzB,iBAAiB,EAAE,KAAK;IACxB,iEAAiE;IACjE,QAAQ,EAAE,IAAI;IACd,kCAAkC;IAClC,QAAQ,EAAE,KAAK;IACf,sBAAsB;IACtB,GAAG,EAAE,IAAI;IACT,+CAA+C;IAC/C,YAAY,EAAE,IAAI;IAClB,8DAA8D;IAC9D,eAAe,EAAE,IAAI;CACb,CAAC;AAgBX,+CAA+C;AAClC,QAAA,UAAU,GAAyB;IAC9C,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;IAC5D,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE;IAC3F,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACnF,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACzF,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACrF,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE;CAC9F,CAAC;AAEF,kBAAyB,EAAa;IACpC,MAAM,KAAK,GAAG,QAAA,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,qCAAqC;AACxB,QAAA,cAAc,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAW,CAAC"}

package/dist/saveConnect.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SaveConnect = exports.SaveConnectError = void 0;
+class SaveConnectError extends Error {
+}
+exports.SaveConnectError = SaveConnectError;
+/**
+ * Talks to a SAVE Connect module the way its own web page does. Requests go one at a time: the
+ * module answers one request at a time, and a read racing a write could return the old value.
+ */
+class SaveConnect {
+    options;
+    queue = Promise.resolve();
+    fetch;
+    timeoutMs;
+    constructor(options) {
+        this.options = options;
+        this.fetch = options.fetch ?? globalThis.fetch;
+        this.timeoutMs = options.timeoutMs ?? 8000;
+    }
+    /** Reads registers (register → how many) in one request. */
+    async read(registers) {
+        const text = await this.request('mread', registers);
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            throw new SaveConnectError(`The unit's answer wasn't JSON: ${text.slice(0, 80)}`);
+        }
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+            throw new SaveConnectError(`The unit's answer wasn't a set of registers: ${text.slice(0, 80)}`);
+        const values = {};
+        for (const [register, raw] of Object.entries(parsed)) {
+            const number = typeof raw === 'number' ? raw : Number(raw);
+            if (Number.isFinite(number))
+                values[register] = number;
+        }
+        return values;
+    }
+    /** Writes registers in one request (lowest register first, as JSON orders them). */
+    async write(values) {
+        await this.request('mwrite', values);
+    }
+    request(path, body) {
+        const run = async () => {
+            const url = `http://${this.options.host}/${path}?${JSON.stringify(body)}`;
+            let response;
+            try {
+                response = await this.fetch(url, { signal: AbortSignal.timeout(this.timeoutMs) });
+            }
+            catch (error) {
+                throw new SaveConnectError(`Couldn't reach the unit at ${this.options.host}: ${error.message}`);
+            }
+            if (!response.ok)
+                throw new SaveConnectError(`The unit answered ${path} with HTTP ${response.status}`);
+            return response.text();
+        };
+        const next = this.queue.then(run, run);
+        this.queue = next.catch(() => undefined);
+        return next;
+    }
+}
+exports.SaveConnect = SaveConnect;
+//# sourceMappingURL=saveConnect.js.map