[APP][PRO] Homematic IP Local (OpenCCU)

[patsche]

Hallo zusammen,

da ich viele Homematic-Geräte einschließlich Homematic IP Wired im Haus installiert habe, habe ich die bisherige Homey-App als Grundlage genommen und unter OpenCCU Local weiterentwickelt und funktionen wie Heizgruppen hinzugefügt. Ihr könnt mit der App die Heizgruppen aus der OpenCCU direkt in Homey importieren.

Das Projekt basiert auf homey-matic, ursprünglich entwickelt von Timo Wendt, mit Beiträgen von Bjoern Welker und weiteren Mitwirkenden. Vielen Dank für diese Vorarbeit! Die ursprüngliche Projekthistorie und MIT-Lizenz bleiben erhalten.

Die App wurde für das aktuelle Homey überarbeitet. Dazu gehören:

• Lokale Kommunikation mit OpenCCU und direkte Aktualisierung von Gerätezuständen.
• Erweiterte Geräteunterstützung, unter anderem für Wired-Aktoren, Eingänge und Sensoren.
• Gemeinsamer Geräteeintrag für die SWDO-Fensterkontakte einschließlich HmIP-SWDO-A.
• Flow-Karten, Status-Widgets und ein bereinigter Diagnoseexport.

Aktuell werden Homematic IP und Homematic IP Wired unterstützt. Falls ihr klassische Homematic-Geräte benötigt, meldet euch bitte mit der genauen Modellbezeichnung.

Bei mir läuft die App stabil, bisher ohne beobachtete Verbindungsabbrüche. Da ich nicht alle Geräte selbst testen kann, freue ich mich über weitere Tester und Rückmeldungen. Geräte aus der bisherigen App müssen in Homey neu hinzugefügt werden.

OpenCCU Local – Testversion installieren

Für Fehler oder fehlende Geräte bitte hier im Thread die Modellbezeichnung, Firmware, App-/Homey-/OpenCCU-Version und eine kurze Beschreibung posten: Was wurde gemacht, was wurde erwartet und was ist passiert?

Den Diagnosebericht findet ihr unter OpenCCU Local → Einstellungen → Diagnosebericht erstellen. Anschließend speichern und hier anhängen; falls JSON-Anhänge nicht möglich sind, den Inhalt als formatierten Code einfügen. Damit können auch bislang unbekannte Geräte untersucht werden.

Der Bericht lässt Zugangsdaten, Geräteadressen, Namen und aktuelle Messwerte aus. Bitte trotzdem vor dem Posten prüfen und keine unbearbeiteten Rohlogs oder CCU-Backups öffentlich hochladen.

[DirkG]

Hallo Christian,
das sind ja mal großartige Neuigkeiten!
Vielen Dank für Deinen Einsatz!

Ich habe Deine App natürlich direkt mal installiert und das s.g. Homematic IP Smart Home Modul für Hörmann-Antriebe, HmIP-MOD-HO hinzugefügt.
Das Modul wurde sofort erkannt und auch ohne Probleme hinzugefügt, allerdings fehlen Funktionen, die sonst in der App von Timo Wendt vorhanden waren. Außerdem wird eine Fehlermeldung gezeigt, wenn ich das Garagentor öffnen, oder das Licht einschalten möchte:

Modellbezeichnung: HmIP-MOD-HO
Firmware: 1.0.16
Open-CCU Version: 0.1.3
Homey Pro 2026
Firmware: v13.5.1

Diagnosebericht

Siehe Github → [Device]: HmIP-MOD-HO doesn't work · Issue #1 · branselbytes/homey-openccu · GitHub

Hier im Forum können kein JSON- oder Textdateien angefügt werden. Außerdem war der Diagnosebericht zu lang, bzw. hatte zu viele Zeichen, um diesen hier über Copy/Paste hier einfügen zu können. Selbst in GitHub war das nicht möglich!

Hier mal Screenshots von den Bedienungsmöglichkeiten im Vergleich:

Homematic

OpenCCU Local

Ich bin kein App Programmierer und habe auch keine Programmierkenntnisse. Aber damals stand ich mit Timo in Kontakt, als er dieses Modul und andere Homematic Geräte für mich hinzugefügt hat. Soweit ich das damals verstanden habe, hat Timo sehr viele “User-Capabilities”, also eigene Capabilities erstellt und genutzt. Vielleicht kannst Du mit dieser kleinen Info etwas anfangen.
Ich hoffe ich habe alle notwendigen Infos zur Verfügung gestellt. Falls nicht, bitte kurze Info.

Vielen Dank im Voraus!

[patsche]

Hi Dirk, danke für deinen ausführlichen Fehlerbericht, ich habe probiert den Fehler zu beheben und ein neues Update heraus gebracht, bitte teste noch einmal.

[patsche]

Version 0.1.4

Kurzer Changelog:

• Hörmann: Stopp, Lüftung, detaillierter Torstatus und neue Flow-Karten; Fehler bei unbekannter Torposition behoben.
• Diagnoseberichte vereinfacht und um CCU-Fehlercodes ergänzt.
• Geräteicons und beide Widgets überarbeitet.
• Store-Beschreibungen auf Deutsch/Englisch und Flow-Katalog aktualisiert.

[DirkG]

Hallo Christian,
vielen Dank für die schnelle Fehlerbehebung! Funktioniert jetzt alles wie erwartet!

Eine Sache ist allerdings etwas unglücklich. Und zwar muss man um das Licht des Hörmann Garagentorantriebs ein- bzw. ausschalten zu können, erst über das Drop-Down-Menü…

…die Ansicht für die Beleuchtung aufrufen…

…bevor man das Licht über den Button ein- bzw. Ausschalten kann:

Von der Bedienung wäre es deutlich einfacher, wenn der Button für das Licht ohne Drop-Down-Menü direkt erreichbar wäre.
Des Weiteren sind die Bezeichnungen für den Antrieb und das Licht auch etwas unglücklich.
Hier Screenshots aller aktuellen Ansichten inkl. Vorschläge für alternative Bezeichnungen:

---

Ich werde jetzt nach und nach meine anderen Homematic Geräte migrieren und Dich informieren, falls es Probleme gibt.

Nochmals vielen Dank für Dein Engagement!!!

---

EDIT
Ich werde zukünftig mögliche Probleme auf GitHub melden, da dies dort strukturierter möglich ist und hier im Topic rel. viel Platz einnehmen.

[patsche]

Kurzer Changelog für 0.1.6:

• Eigene Lichttaste im vorhandenen Garagentor-Gerät; doppelten Dropdown-Eintrag entfernt.
• Eindeutige Bezeichnungen und Flowkarten für Garagenlicht und Torfunktionen.
• Lichtzustände zuverlässig synchronisiert; verspätete Rücklesewerte überholter Befehle werden ignoriert.
• Bestehende Geräte und Flows bleiben erhalten.
• Wochenprofile unterstützter OpenCCU-Heizgruppen und Thermostate direkt in Homey bearbeiten.
• Kompakter Wocheneditor mit Kopierfunktion für Tage und Profile sowie bestätigtem Speichern.
• Reduzierter Speicherverbrauch und optimierte Heizprofilabfragen.

Technische Hintergrundinfos zu dieser App, also seit der ersten Beta Version

Zur RPC-Schnittstelle gegenüber der ursprünglichen App: Früher wurden RPC-Anfragen direkt abgeschickt. Heute koordiniert eine Warteschlange die Aufrufe mit standardmäßig zwei parallelen Anfragen je Schnittstelle. Schreibbefehle und Registrierung erhalten Vorrang vor wartenden Leseabfragen. Dazu kommen Zeitlimits, Wiederverbindung mit zunehmenden Pausen und Zustandsprüfung durch CCU-Rückmeldungen oder gezieltes Nachlesen. Motorbefehle werden dabei nicht automatisch erneut gesendet. Begrenzte Zwischenspeicher und zusammengefasste Heizprofilabfragen reduzieren zusätzliche Last.

[DirkG]

Vielen Dank! Funktioniert einwandfrei…

[chrb]

Hallo, good News und vielen Dank!

Ich hätte für’s erste folgenden Wunsch für die Integration weiterer Geräte:

• HmIP-BROLL-2
• HmIP-SWDO-2
• HmIP-FALMOT-C12
• HmIP-MIOB
• HM-PB-2-FM

Wäre das möglich? Danke und VG

[patsche]

Beta 0.1.8

• Unterstützung für HmIP-BROLL-2, HmIP-FALMOT-C12, HmIP-MIOB und HM-PB-2-FM ergänzt.
• FALMOT: zwölf Ventilanzeigen mit Alarmmeldungen; Temperaturregelung weiterhin über Thermostat/Heizgruppe.
• MIOB: zwei Schaltausgänge, zwei Eingänge und Analogausgang.
• Klassischer Wandtaster: Kurz-/Langdruck-Flows und Batteriewarnung über die neue optionale BidCos-RF-Anbindung.
• Diagnose und Wiederverbindung nach Einstellungsänderungen verbessert.
• SWDO-2 war bereits unterstützt.

Beta 0.1.7

• Neue Fenstergriff-Flow-Bedingungen: geschlossen, gekippt und offen, jeweils auch umkehrbar.
• Unbekannte Griffzustände werden nicht mehr als gültige Position gewertet.

Die neuen Geräteprofile wurden mit simulierten CCU-Daten getestet. Rückmeldungen von echten Geräten sind gerne erwünscht

[DirkG]

Hallo Christian,
habe den Fenstergriffsensor HmIP-SRH getestet und festgestellt, dass weitere Flow Karten fehlen. Und zwar in der Kategorie Wenn…
Es existieren keine Flow Karten die auf die Zustandsänderungen Offen/Geschlossen/Gekippt reagieren:

Entweder müsste 1 Flow Karte hinzugefügt werden, die generell auf eine Zustandsänderung reagiert:

• Der Öffnungszustand hat sich geändert

Mit den vorhandenen Und… Flow Karten könnte dann der gewünschte Zustand abgefragt werden. Beispiel:
Wenn…
– Der Öffnungszustand hat sich geändert
Und…
– Griff ist geschlossen
Dann…
…

Oder es müssten 3 Flow Karten hinzugefügt werden, die direkt den Öffnungszustand beinhalten:

• Griffposition geschlossen
• Griffposition offen
• Griffposition gekippt

Oder so ähnlich.

[patsche]

Hallo Dirk,

hier der Changelog. Es gibt eine Karte und der Status kann über die Tags gefiltert werden.

Beta 0.1.9

• Neue HmIP-SRH-Flow-Karte: „Die Griffstellung hat sich geändert“.
• Text-Tag „Griffstellung“ mit „Geschlossen“, „Gekippt“ oder „Offen“.
• Mit den vorhandenen „Und …“-Bedingungen kombinierbar.
• Keine Auslösung bei identischen Meldungen, unbekannten Zuständen oder beim Einlesen nach einem Neustart.

[DirkG]

Vielen Dank! Werde ich später testen und Dir eine Rückmeldung geben.

EDIT

@patsche, die Flow Karten für den Fenstergriffsensor HmIP-SRH funktionieren einwandfrei. Sowohl mit den bereits vorhandenen Und… Bedingungen, als auch mit den Text-Tags.
Vielen Dank!

[chrb]

Hi, vielen Dank für die schnelle Umsetzung. Den HM-PB-2-FM kann ich leider nicht hinzufügen:

Könntest Du das nochmal prüfen? VG

[patsche]

Hallo chrb,

hast du die BidCos-RF Einstellungen in den App Einstellungen aktualisiert?

[chrb]

Nein - und dann für den Hinweis - damit klappts!

[DirkG]

Für mein aktuelles Homematic Setup fehlen mir noch:
– HM-SCI-3-FM
– HM-Sec-Sir-WM

Und bei den folgenden Geräten, bin ich auf Probleme gestoßen:

HmIP-STE2-PCB (2-Kanal-Temperatursensor mit externen Fühlern)

– es wird nur die Temperatur des 1. Kanals angezeigt
– Temperatur Kanal 2 fehlt
– Temperaturdifferenz zwischen Kanal 1 und 2 fehlt = Kanal 3

[patsche]

Die neue Beta 0.1.11 ist verfügbar! Zusammen mit 0.1.10 bringt sie folgende Änderungen:

• Unterstützung für weitere Homematic-IP- und Wired-Geräte sowie HM-SCI-3-FM und HM-Sec-Sir-WM.
• HmIP-STE2-PCB: beide Temperaturfühler und die CCU-Temperaturdifferenz im bestehenden Gerät.
• Neue Flow-Aktionen für Displaytexte, MP3-Wiedergabe und Signalfarben.
• 26 neue Status-Auslöser und 26 Bedingungen, unter anderem für Heizung, Ventile, Sensoren, Sirenen und CCU-Systemstatus – mit passenden Wert- und lesbaren Status-Tags.
• Erkennung per Flow aktivieren/deaktivieren und Heizungs-Boost ausschalten.
• Schutz vor doppelten Status-Auslösungen und unerwünschten Auslösungen beim Initialisieren. Bestehende Flows bleiben erhalten.

[DirkG]

@patsche

• HM-SCI-3-FM

Funktioniert!

@patsche

• HM-Sec-Sir-WM

Habe ich noch nicht getestet, habe allerdings einen “netten” Schreibfehler gefunden:

[DirkG]

Damit ich die Innensirene HM-Sec-Sir-WM gestern hinzufügen konnte, musste ich in den OpenCCU Local App Einstellungen “Klassisches Homematic (BidCos-RF)” aktivieren.
Heute Morgen hatte ich dann von der Homey App Flow Checker diverse Timeline Einträge, dass einige der Flows, in denen Geräte über die OpenCCU Local App eingebunden sind, Probleme/Fehler aufweisen. Nachdem ich mir diese Flows näher angeschaut habe, musste ich feststellen, dass alle Und… Flow Karten Griff ist offen des Fenstergriffsensors HmIP-SRH fehlten:

Im Gerät selbst waren weder die aktuelle Griffposition, noch das Icon der Batterie zu sehen.

Als ich in den App Einstellungen BidCos-RF wieder deaktiviert und den Einstellungsbildschirm verlassen hatte, “ploppten” nach und nach die Flow Karten wieder auf. Allerdings war die Gerätekachel der Innensirene mit “ Keine Antwort” gekennzeichnet. Nach dem Löschen der Sirene konnte ich diese bei deaktiviertem BidCos-RF auch nicht wieder hinzufügen.

Wie es scheint, kommen sich die “alten” HM- und die neueren HmIP-Geräte sich in die Quere. Muss ich eventuell irgendetwas in den Einstellungen ändern, oder handelt es sich um einen Bug?

[chrb]

Hi, ich habe gestern Abend mit einem Flow 3 Rollläden (hmIP Broll-2) mit Verzögerung von je 1 Sekunde herunterfahren lassen - ohne Probleme. Heute Morgen sollten sie wieder hochfahren (auch mit 1 Sekunde Verzögerung) - da waren sie nicht mehr erreichbar:

Über die App von Timo sind sie ohne Probleme bedienbar.

Was brauchst du konkret von mir?