SIKU / Oxxify Lüftung

Überblick

Dieser Adapter integriert SIKU RV V2- Wohnraumlüftungsgeräte und kompatible Geräte der Oxxify smart- Serie in ioBroker. Dies schließt ausdrücklich Geräte ein, die unter den Bezeichnungen Oxxify.smart 30 , Oxxify.smart 50 und Oxxify.smart 50 K vermarktet werden.

Der aktuelle Stand des Repositorys zielt auf eine funktionsreiche öffentliche Betaversion für den Betrieb im lokalen Netzwerk und den offiziellen ioBroker ab.latest Aufnahme.

Merkmale

• UDP-Kommunikation basierend auf dem dokumentierten Herstellerprotokoll
• Unterstützung mehrerer Geräte in einer Adapterinstanz
• Senderfindung im lokalen Netzwerk
• JSON-Konfigurationsbasierte Admin-Seite für mehrere Geräte
• Standardmäßig erfolgt alle 24 Stunden eine separate RTC-Zeitprüfung.
• Neustart-persistente RTC-Planung basierend auf dem Zeitstempel des letzten Prüfversuchs
• Zeitsynchronisation nur bei Überschreitung des konfigurierten Drift-Schwellenwerts
• Zustandsbasierte Steuerung der wichtigsten Betriebsparameter
• Vollständige wöchentliche Zeitplanabbildung über ioBroker-Zustände mit paketgrößensicheren Lesevorgängen alle 15 Minuten
• Lokalisierte Enumerationsbezeichnungen für Lüftergeschwindigkeit, Lüftermodus und Timermodus
• Lesbare lokale Zeitstempel-Begleitstaaten für Umfrage- und Entdeckungszeitstempel
• Gerätespezifische Passwörter werden in ihrem verschachtelten Konfigurationspfad verschlüsselt und vor normalen Konfigurationszugriffen geschützt.
• Eine Adapterinstanz pro ioBroker-Host, um UDP-Portkonflikte zu vermeiden

Unterstützte Kernfunktionen

• Erkennung von Mastergeräten per Broadcast (0x007C ,0x00B9 )
• Verwaltung mehrerer Geräte über stabile Geräte-IDs
• Abfrage von Status-, Sensor- und Diagnosewerten
• Schreiben zentraler Parameter über Zustände, zum Beispiel:
  • Leistung
  • Lüftergeschwindigkeit
  • manuelle Lüftergeschwindigkeit
  • Lüftermodus
  • Timer-Modus
  • Sollwert für Luftfeuchtigkeit
  • Sensor-Aktivierungsflags
• Einmalige Schreib-Reset-Befehle mit anschließendem Rücklesen anstelle unsicherer Wiederholungsversuche
• Wochenablaufstruktur wie folgt:
  • schedule.monday.p1.speed
  • schedule.monday.p1.endHour
  • schedule.monday.p1.endMinute
  • ... bis zuschedule.sunday.p4.*
• Diagnostische Werte wie zum Beispiel:
  • Filter-Countdown
  • Öffnungszeiten
  • Alarmstufe
  • Anzeige für Filterwechsel
  • letzte Entdeckung / letzte Umfrage / letzte Überprüfung

Gerätereferenzen

Der Adapter ist für die SIKU RV V2-Familie wie z. B. SIKU RV 50 W Pro WiFi V2 , kompatible Geräte der Oxxify Smart- Serie und verwandte Geräte der gleichen Protokollfamilie konzipiert.

Die aktuelle Kompatibilitätsbeschreibung und die Suchbegriffe umfassen explizit Oxxify.smart 30 , Oxxify.smart 50 , Oxxify.smart 50 K , Oxxify smart , Oxxify smart 30 , Oxxify smart 50 , Oxxify smart 50 K und kompatible, per App steuerbare, dezentrale Wärmerückgewinnungs-Lüftungsanlagen.

• Hersteller-Produktseite: SIKU RV 50 W Pro WiFi V2
• Herstellerübersicht: SIKU-Produkte
• Übersicht kompatibler Serien: Oxxify dezentrale Lüftungssysteme
• Beispiele für kompatible Produkte: Oxxify.smart 30 und Oxxify.smart 50
• Offizielle Beschreibung der mobilen App: SIKU RV WIFI im App Store

Entwicklung

Nützliche Skripte:

Der Adapter wurde mit den offiziellen ioBroker-Tools generiert und in TypeScript entwickelt.

CI / CD

• Bei normalen Pull-Requests wird nach Linting, Typüberprüfung und Unit-Coverage ein schlanker Ubuntu-Smoke-Test durchgeführt.
• Dependabot Pull Requests führen vor dem automatischen Zusammenführen die vollständige Matrix der unterstützten Betriebssysteme/Node.js durch.
• main Führt die für die Aufnahme in das ioBroker-Repository erforderliche, releaserelevante Linux/macOS/Windows-Matrix aus.
• Für zusätzliche Prüfungen steht weiterhin ein separater, geplanter/manueller Windows-Regressionsworkflow zur Verfügung, da der Bootstrap des ioBroker-Controllers dort deutlich langsamer ist.
• Änderungen zur Laufzeit können nach erfolgreicher Installation automatisch eine Patch-Version erhalten.main run; docs, tests, workflows und nur für die Entwicklung vorgesehene Abhängigkeitsaktualisierungen erzeugen keine leeren Releases.
• Getaggte Releases werden über Trusted Publishing direkt von GitHub Actions auf npm veröffentlicht.
• GitHub-Releases werden automatisch mit generierten Versionshinweisen durch die Standard-Bereitstellungsaktion von ioBroker erstellt.

Veröffentlichungsbereitschaft

Eine kurze Checkliste für Releases und Repositories finden Sie in der Datei RELEASING.md .

Beta-Notizen

• Erkennung, Abfrage, Zeitprüfungen und Zeitplanabrufe wurden bereits anhand mehrerer realer Geräte validiert.
• Die Live-Schreibtests wurden bewusst konservativ gehalten.
• Netzwerk-/Dienstfunktionen wie Wi-Fi-Neukonfiguration, Passwortänderungen oder Werksreset werden absichtlich nicht als normale beschreibbare Zustände angezeigt.

Erweiterte Messagebox-API

Der Adapter legt diese freisendTo Befehle für Skripte und Integrationen:

• discover Führt die UDP-Broadcast-Erkennung durch. Ohne explizites Passwort versucht der Adapter innerhalb eines Empfangsfensters von maximal 10 Sekunden das Standardpasswort und alle konfigurierten Gerätepasswörter (maximal 16). Konfigurationsaktualisierungen werden nur für Anrufe zurückgegeben und angewendet, die von einer ioBroker-Admin-Instanz geleitet werden; andere Anrufer erhaltendiscoveryFoundNotSaved Die
• syncTimeAll : Führe eine manuelle RTC-Prüfung/Synchronisierung für alle konfigurierten Geräte durch.
• syncTimeDevice : Führen Sie eine manuelle RTC-Prüfung/Synchronisierung für ein konfiguriertes Gerät durchdeviceId Die
• readDevice : Ausgewählte Rohprotokollparameter von einem explizit angegebenen IPv4/Geräte-ID-Ziel für Diagnosezwecke lesen.

Die DiagnosereadDevice Die Antwort serialisiert Paketmetadaten und zurückgegebene Parameterwerte als Hexadezimalzeichenketten. Gerätepasswörter werden niemals zurückgegeben; die Antwort enthält lediglichpasswordLength Die

Das herstellereigene UDP-Protokoll überträgt sein kurzes Gerätepasswort unverschlüsselt, auch während der Erkennung. Betreiben Sie den Adapter nur in einem vertrauenswürdigen, isolierten lokalen Netzwerk. Die oben genannte Admin-Ursprungsprüfung dient der Nachrichtenweiterleitung für die Konfigurationsverarbeitung und stellt keine Sicherheitsbarriere gegen bereits in ioBroker ausgeführten Schadcode dar.

Changelog

WORK IN PROGRESS

0.2.3 (2026-07-26)

• Harden RTC scheduling, UDP shutdown/error handling, malformed response isolation, schedule write recovery and password/object lifecycle behavior.

0.2.2 (2026-07-11)

• Harden repository-checker compatibility for nested password protection, compact-mode CI scripts and release recovery.

0.2.1 (2026-07-10)

• Create the localized fan-speed text state object before writing its value.

0.2.0 (2026-07-10)

• Correct nested encryption and migration of per-device passwords from earlier beta versions.
• Harden UDP response correlation and write-only reset handling to prevent stale or repeated commands.
• Restrict fan-speed writes to protocol-defined values and expose localized enum labels.
• Persist the 24-hour RTC schedule across restarts and keep clock reads outside normal polling.
• Split weekly schedule reads into protocol-size-safe chunks and refresh them every 15 minutes.
• Extract the object factory and operation scheduler, expand tests and enforce coverage in CI.
• Modernize ioBroker dependencies, release actions and automatic patch-release classification.

0.1.8 (2026-06-09)

• Cleaned up unused Admin translations found during the adapter checklist review.
• Documented the advanced messagebox commands for script/integration use.
• Added a code-side upper bound for the RTC time sync drift threshold.

Older changelog entries are available in CHANGELOG_OLD.md.

License

MIT License

Copyright (c) 2026 Christian Maaß christian@maass.it

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.