Neues YouTube-Video: Visualisierung im Devices-Adapter

[Meister Mopper]

Hallo liebe ioBroker-Community,

ich freue mich, euch heute meinen ersten Adapter vorstellen zu dürfen:

ioBroker.harvia-fenix.

Dieser Adapter ermöglicht die Integration und Steuerung von Harvia Fenix Saunasteuerungen, die über die MyHarvia 2 Smartphone-App verwaltet werden. Da ich selbst eine solche Steuerung besitze und eine Einbindung in meine Hausautomatisierung suchte, habe ich dieses Projekt ins Leben gerufen.
Mein jetziger Wissensstand ist, dass die bisherigen Harvia Xenio Systeme mit dem seit 2025 existierenden Harvia Fenix nicht kompatibel ist und die App Myharvia App benötigt.

Ein Wort zur Entstehung:
Dies ist mein allererster Versuch, einen ioBroker-Adapter zu entwickeln. Da ich kein hauptberuflicher Entwickler bin, habe ich mich bei der Erstellung intensiv der Unterstützung der KI Gemini plus bedient.
Hierzu habe ich meine Sauna zunächst vermittels Skript zum Leben erweckt und dann zur Entwicklung eines Adapters entschlossen.

Die Zusammenarbeit mit der KI war sehr effizient und für mich lehrreich, dennoch bitte ich um Nachsicht, falls an der einen oder anderen Stelle im Code oder im Verhalten noch Unstimmigkeiten auftreten sollten. Ich lerne stetig dazu!

Funktionsweise

Der Adapter verbindet sich mit der MyHarvia Cloud-Infrastruktur und spiegelt die Zustände der Saunasteuerung in ioBroker-Datenpunkten wider. Er unterstützt die automatische Erkennung (Discovery) der Geräte-ID und bietet sowohl Lese- als auch Schreibzugriff auf die wichtigsten Funktionen der Sauna.

Installation

Der Adapter ist bereits auf NPM veröffentlicht. Eine Installation über GitHub ist daher nicht zwingend erforderlich (und für ein stabiles System auch nicht empfohlen). Ihr könnt ihn einfach wie folgt installieren:

Edit: In der Konsole des ioBroker-Server:

iobroker url iobroker.harvia-fenix

Alternativ über die Admin-Oberfläche -> Adapter -> Expertenmodus (Katzen-Symbol) -> Von NPM -> harvia-fenix eingeben.

Verfügbare Datenpunkte

Der Adapter bildet aktuell folgende Zustände ab:

Verfügbare Datenpunkte

Datenpunkt	Typ	Rolle	Zugriff	Beschreibung
online	boolean	indicator.reachable	Nur Lesen	Verbindungsstatus der Steuereinheit zur Cloud.
doorSafety	boolean	indicator.safety	Nur Lesen	Status der Türsicherung (z. B. true, wenn die Tür sicher geschlossen ist).
errorMsg	string	text	Nur Lesen	Aktuelle Fehlermeldungen oder Statustexte des Ofens.
heatOn	boolean	switch.power	Lesen/Schreiben	Hauptschalter, um den Saunaofen EIN (true) oder AUS (false) zu schalten.
heaterPower	number	value.power	Nur Lesen	Hinweis: Dieses Objekt wird von der API bereitgestellt, liefert aber derzeit oft 0 kW.
lightOn	boolean	switch.light	Lesen/Schreiben	Schalter für die integrierte Saunabeleuchtung.
panelTemp	number	value.temperature	Nur Lesen	Temperaturmesswert direkt an der physischen Steuereinheit (Panel).
remoteControl	boolean	indicator.state	Nur Lesen	Zeigt an, ob die Fernstartfreigabe am Gerät aktuell aktiv ist.
targetTemp	number	level.temperature	Lesen/Schreiben	Zieltemperatur-Sollwert für die Saunakabine (z. B. 90 °C).
temp	number	value.temperature	Nur Lesen	Die aktuelle Umgebungstemperatur in der Saunakabine (z. B. 17 °C).
totalBathingHours	number	value.number	Nur Lesen	Historische kumulierte Betriebsstunden der Saunanutzung (h).
totalOperatingHours	number	value.hours	Nur Lesen	Gesamte Betriebsstunden des Systems (h).
totalSessions	number	value.count	Nur Lesen	Zähler für die Gesamtzahl der durchgeführten Heizvorgänge.

⚠️ Wichtiger Sicherheitshinweis!

Bitte beachtet unbedingt die Sicherheitshinweise in der Dokumentation. Der Fernbetrieb eines Saunaofens ist kein Spielzeug und unterliegt strengen Brandschutzvorschriften (z.B. funktionierende Türkontakte). Die Nutzung des Adapters erfolgt auf eigene Gefahr.

Feedback ist natürlich immer erwünscht!

Da ich den Adapter bisher nur auf meinem eigenen Testsystem (immer aktueller Stand) testen konnte (js-controller 7.x), bin ich sehr auf eure Rückmeldungen gespannt. Der Adapter setzt js-controller >=6.0.11 voraus.

Falls etwas nicht wie erwartet funktioniert, postet bitte eure Logs (idealerweise im Debug-Modus) und eine kurze Beschreibung des Problems.

Das GitHub-Repository findet ihr hier: https://github.com/meistermopper/ioBroker.harvia-fenix

Vielen Dank fürs Testen und viel Spaß beim Saunieren!

[Meister Mopper]

For further use ...

[mcm1957]

DANKE dass du Zeit verwendets einen neuen Adapter zu erstellen.

Da der Adapter (hoffentlich) auch auf npm publiziert wurde sollte nicht von github installiert werden sondern sauber von npm, z.B. so

iobroker url iobroker.harvia-fenix

Von direkten Installation von GitHub - insbesondere auf produktiven Systemen - wird explizit abgeraten.

GitHub Versionen können sich jederzeit (auch kurzfristig) ändern und durchaus auch in sich inkonsistent und fehlerhaft sein. Versionsangaben von GitHub Installationen sind Schall und Rauch da die Versionsnummer zumindest bei Verwendung der standardmäßigen Umgebung erst im Zuge der Releaseerstellung geändert wird.

Auf explizite Aufforderung durch den Entwickler kann eine GitHub Installation zur Fehlereingrenzung oder zum Test neuer Funktionalität - unter Inkaufnahme des erhöhten Risikos - natürlich erfolgen.

Adapter die nur via GitHub oder npm (also NICHT aus einem der beiden Repositories) installierbar sind sind mit erhöhter Vorsicht zu betrachten. Hier sollte der Entwickler drum ersucht werden eine Aufnahme in die Repositories zu veranlassen indem z.B. ein Issue im Adapterrepository erstellt wird.

[mcm1957]

Bitte fixe in nächster Zeit die beim Check aufgefallenen Fehler:

ERRORS:

❗ [E0029] Node.js 20 is required as minimum, node.js 22 is recommended. The current engines.node clause ">=18" allows Node.js 18.0.0 as minimum. Please update it to require at least ">=20" at package.json.

❗ [E0033] @iobroker/adapter-core 3.2.2 specified. 3.2.3 is required as minimum, 3.3.2 (or newer) is current. Please update dependencies at package.json

❗ [E0036] @alcalzone/release-script 3.1.0 specified. 5.2.1 is required as minimum, 5.2.1 (or newer) is current. Please update devDependencies at package.json

❗ [E0036] @alcalzone/release-script-plugin-iobroker 3.0.0 specified. 5.2.0 is required as minimum, 5.2.0 (or newer) is current. Please update devDependencies at package.json

❗ [E0036] @alcalzone/release-script-plugin-license 3.0.0 specified. 5.2.0 is required as minimum, 5.2.0 (or newer) is current. Please update devDependencies at package.json

❗ [E0036] @alcalzone/release-script-plugin-manual-review 3.0.0 specified. 5.2.0 is required as minimum, 5.2.0 (or newer) is current. Please update devDependencies at package.json

❗ [E0036] @iobroker/testing 5.1.0 specified. 5.2.2 is required as minimum, 5.2.2 (or newer) is current. Please update devDependencies at package.json

❗ [E0058] Attribute "allowScripts" at package.json is not supported. Please remove.

❗ [E0058] Attribute "lint-staged" at package.json is not supported. Please remove.

❗ [E1057] admin 7.0.23 listed as dependency but 7.6.17 is required as minimum, 7.6.20 is recommended. Please update globalDependency at io-package.json.

❗ [E1084] Please remove "$schema" from io-package.json. You may set schema at your IDE to add edit-support.

❗ [E2008] Version 0.0.17 tagged as "latest" at npm is not signed with provenance. Trusted publishing is recommended.

❗ [E3014] Workflow "test-and-release.yml": job "adapter-tests" should declare "needs: check-and-lint" to run after linting.

❗ [E3019] Workflow "test-and-release.yml": job "deploy" step using "ioBroker/testing-action-deploy@v1" has "npm-token" parameter specified. Trusted publishing will not work while "npm-token" is set.

❗ [E3020] Workflow "test-and-release.yml": job "check-and-lint" uses node.js 20 which is below the minimum required version 22. Please update to node.js 24.

❗ [E3022] Workflow "test-and-release.yml": job "deploy" uses node.js 20 which is below the minimum required version 24. Please update to node.js 24.

❗ [E5507] missing size attributes [xs,md,lg,xl] for number at admin/jsonConfig.json/items/main/pollInterval

❗ [E5507] missing size attributes [xs,md,lg,xl] for password at admin/jsonConfig.json/items/main/password

❗ [E5507] missing size attributes [xs,md,lg,xl] for text at admin/jsonConfig.json/items/main/deviceId

❗ [E5507] missing size attributes [xs,md,lg,xl] for text at admin/jsonConfig.json/items/main/username

❗ [E5604] i18n "admin/i18n" language "de" is missing 1 key(s) present in English: Leave this field empty and start the adapter to find the ID automatically in the ioBroker log (Discovery).

❗ [E6033] ## License section in README.md must contain a copyright line like "Copyright (c) 2026 iobroker-community-adapters".

❗ [E8912] Automerge workflow file "/.github/workflows/dependabot-auto-merge.yml" uses deprecated action "ahmadnassri/action-dependabot-auto-merge" which no longer works. Please migrate to "iobroker-bot-orga/action-automerge-dependabot@v1".

❗ [E8915] Dependabot npm entry (directory: "/") has no "cooldown" configured. A cooldown of at least 7 days (e.g. "cooldown: { default: 7 }") is recommended to reduce supply chain risk.

❗ [E8917] At least major versions of @types/node should not be updated by dependabot. Please add ignore block at dependabot.yml.

❗ [E9006] .commitinfo file should be excluded by .gitignore, please add a line with text ".commitinfo" to .gitignore
WARNINGS:

👀 [W0062] Consider adding and using package "@iobroker/adapter-dev".

👀 [W0062] Consider adding and using package "@iobroker/eslint-config".

👀 [W0066] "@types/node":"^20.17.10" at package.json allows major version greater than 18. Downgrade to node.js 18.x.x to avoid wrong typing is recommended.

👀 [W0083] A newer version (10.1.0) for package "cross-env" (devDependencies) exists for 251 days. Please evaluate if upgrading from 7.0.3 to 10.1.0 is possible.

👀 [W0083] A newer version (11.7.6) for package "mocha" (devDependencies) exists for 18 days. Please evaluate if upgrading from 10.7.3 to 11.7.6 is possible.

👀 [W0083] A newer version (17.0.7) for package "lint-staged" (devDependencies) exists for 8 days. Please evaluate if upgrading from 15.2.11 to 17.0.7 is possible.

👀 [W0083] A newer version (20.1.9) for package "@tsconfig/node20" (devDependencies) exists for 124 days. Please evaluate if upgrading from 20.1.4 to 20.1.9 is possible.

👀 [W0083] A newer version (3.3.2) for package "@iobroker/adapter-core" (dependencies) exists for 294 days. Please evaluate if upgrading from 3.2.2 to 3.3.2 is possible.

👀 [W0083] A newer version (5.2.0) for package "@alcalzone/release-script-plugin-git" (devDependencies) exists for 32 days. Please evaluate if upgrading from 3.0.0 to 5.2.0 is possible.

👀 [W0083] A newer version (5.2.0) for package "@alcalzone/release-script-plugin-iobroker" (devDependencies) exists for 32 days. Please evaluate if upgrading from 3.0.0 to 5.2.0 is possible.

👀 [W0083] A newer version (5.2.0) for package "@alcalzone/release-script-plugin-license" (devDependencies) exists for 32 days. Please evaluate if upgrading from 3.0.0 to 5.2.0 is possible.

👀 [W0083] A newer version (5.2.0) for package "@alcalzone/release-script-plugin-manual-review" (devDependencies) exists for 32 days. Please evaluate if upgrading from 3.0.0 to 5.2.0 is possible.

👀 [W0083] A newer version (5.2.0) for package "@alcalzone/release-script-plugin-package" (devDependencies) exists for 32 days. Please evaluate if upgrading from 3.0.0 to 5.2.0 is possible.

👀 [W0083] A newer version (5.2.0) for package "@alcalzone/release-script-plugin-version" (devDependencies) exists for 32 days. Please evaluate if upgrading from 3.0.0 to 5.2.0 is possible.

👀 [W0083] A newer version (5.2.2) for package "@iobroker/testing" (devDependencies) exists for 212 days. Please evaluate if upgrading from 5.1.0 to 5.2.2 is possible.

👀 [W0083] A newer version (5.2.3) for package "@types/chai" (devDependencies) exists for 230 days. Please evaluate if upgrading from 4.3.20 to 5.2.3 is possible.

👀 [W0083] A newer version (6.0.3) for package "typescript" (devDependencies) exists for 52 days. Please evaluate if upgrading from 5.7.3 to 6.0.3 is possible.

👀 [W0083] A newer version (6.2.2) for package "chai" (devDependencies) exists for 167 days. Please evaluate if upgrading from 4.5.0 to 6.2.2 is possible.

👀 [W0086] "@tsconfig/node20" should match the major node.js version from package.json engines.node (>=18). Please update to @tsconfig/node18 at package.json.

👀 [W1132] io-package.json: instanceObject "doorSafety" common.role "indicator.safety" is not a known ioBroker state role

👀 [W1132] io-package.json: instanceObject "remoteControl" common.role "indicator.state" is not a known ioBroker state role

👀 [W1132] io-package.json: instanceObject "totalBathingHours" common.role "value.number" is not a known ioBroker state role

👀 [W1132] io-package.json: instanceObject "totalOperatingHours" common.role "value.hours" is not a known ioBroker state role

👀 [W1132] io-package.json: instanceObject "totalSessions" common.role "value.count" is not a known ioBroker state role

👀 [W4001] Cannot find "harvia-fenix" in latest repository. Please ignore if PR to add adapter to repositories already exists.

👀 [W5022] Why did you decide not to use i18n support?

👀 [W5041] Example configuration (option1, option2) found in i18n translation files (ru, pt, nl, fr, it, es, pl, uk, zh-cn). Please remove example configuration from your code.

👀 [W5047] "admin/index_m.html" is most likely outdated since jsonConfig is used. Please consider removing it.

👀 [W5605] i18n "admin/i18n" language "de" has 1 outdated key(s) not present in English: Leave this field empty and start the adapter to find the ID automatically in the ioBroker log (Discovery). Note: The ID is not visible in the MyHarvia 2 app.

👀 [W5605] i18n "admin/i18n" language "es" has 2 outdated key(s) not present in English: option1, option2

👀 [W5605] i18n "admin/i18n" language "fr" has 2 outdated key(s) not present in English: option1, option2

👀 [W5605] i18n "admin/i18n" language "it" has 2 outdated key(s) not present in English: option1, option2

👀 [W5605] i18n "admin/i18n" language "nl" has 2 outdated key(s) not present in English: option1, option2

👀 [W5605] i18n "admin/i18n" language "pl" has 2 outdated key(s) not present in English: option1, option2

👀 [W5605] i18n "admin/i18n" language "pt" has 2 outdated key(s) not present in English: option1, option2

👀 [W5605] i18n "admin/i18n" language "ru" has 2 outdated key(s) not present in English: option1, option2

👀 [W5605] i18n "admin/i18n" language "uk" has 2 outdated key(s) not present in English: option1, option2

👀 [W5605] i18n "admin/i18n" language "zh-cn" has 2 outdated key(s) not present in English: option1, option2

👀 [W6017] CHANGELOG.md detected. The changelog must be located within README.md.

👀 [W6020] Consider adding a CHANGELOG_OLD.md file to store older changelog entries. This is supported by @alcalzone/releasescript.

👀 [W8909] Dependabot entry for "github-actions" uses "schedule: interval: monthly" with a "day" setting. The "day" setting is not supported for monthly schedules and should be removed.

👀 [W8909] Dependabot entry for "npm" uses "schedule: interval: monthly" with a "day" setting. The "day" setting is not supported for monthly schedules an

[micklafisch]

@Meister-Mopper
Mega Idee mit dem Adapter. Meine Fenix-Steuerung liegt noch in der Garage umher, hoffe ich komme bis zum Herbst zum Einbau. Dann werde ich gerne testen und Feedback geben.

[Meister Mopper]

Hallo @mcm1957 ,

vielen Dank für das ausführliche Review. Ich habe alle gemeldeten Fehler und die (meisten, soweit es mir möglich war) Warnungen behoben.

Die aktualisierte Version 0.0.19, die alle besprochenen Änderungen (Node.js-Version, Abhängigkeiten, Workflow-Anpassungen, i18n-Syntax, Lizenzformat und Trusted Publishing) enthält, wurde erfolgreich auf npmjs.com veröffentlicht.

Das Issue sollte damit als erledigt betrachtet werden können.

Nochmals vielen Dank für die Unterstützung!