homebridge-nibe-s320

Homebridge-Plugin für die NIBE VVM S320 über die lokale REST API (NIBE-Firmware ≥ 4.4.7). Kein myUplink-Cloud-Abo nötig, alles bleibt im Heimnetz.

Status: Ausbaustufe 1 — read-only (Temperatursensoren). Steuerung (Warmwasser-Boost, Heiz-Offset) folgt.

1. An der Wärmepumpe vorbereiten

1. Lokale REST API aktivieren: Menü 7.5.15 – Lokal REST API → REST API lokal aktivieren einschalten.
2. Benutzername + Passwort vergeben (merken).
3. IP-Adresse notieren: Menü 5.2 – Netzwerkeinstellungen (oder im Router).

Die API läuft dann unter http://<IP>:8080 (bzw. HTTPS :8443). Tipp: http://<IP>:8443 im Browser öffnen zeigt die eingebaute API-Doku.

2. Datenpunkte auslesen (Discovery)

Damit wir die echten Parameter-IDs deiner Anlage kennen (statt zu raten):

npm install
npm run discover -- <IP> <USER> <PASSWORT>
# Beispiel:
npm run discover -- 192.168.1.50 homebridge geheim
# Nur schreibbare (steuerbare) Punkte:
npm run discover -- 192.168.1.50 homebridge geheim --writable

Das Skript listet alle Datenpunkte und speichert sie in discovered-points.json.

3. Bauen & lokal testen

npm install
npm run build          # TypeScript → dist/
npm link               # Plugin global verfügbar machen

# Im Homebridge-Verzeichnis:
npm link homebridge-nibe-s320
# Homebridge neu starten

Alternativ während der Entwicklung mit Auto-Rebuild:

npm run watch

4. Konfiguration

Über die Homebridge-UI (Plugin-Einstellungen) oder direkt in der config.json:

{
  "platforms": [
    {
      "platform": "NibeVVMS320",
      "name": "NIBE VVM S320",
      "host": "192.168.1.50",
      "username": "homebridge",
      "password": "geheim",
      "pollInterval": 30
    }
  ]
}

Projektstruktur

Siehe PROJECT_STRUCTURE.md.

Lizenz

MIT