Skip to content

Nall-chan/HomematicExtended

Repository files navigation

SDK Version License
Version Check Style Run Tests
Spenden

Symcon-Modul: HomeMaticExtended

Erweitert IPS um die native Unterstützung von:

  • Systemvariablen der CCU
  • Programmen auf der CCU
  • Summenzähler aller Typen von Verbrauchsmessern
  • Display Status-Anzeige (Dis-WM55)
  • ePaper Status-Anzeige (Dis-EP-WM55)
  • HomeMaticScript
  • Status der Funk-Interfaces
  • Status des Wired-Interface

Dokumentation

Inhaltsverzeichnis

1. Funktionsumfang

Abfragen von System- und Alarmvariablen inkl. Profilen und Werten von der CCU.
Schreiben von Werten der Systemvariablen zur CCU.
Standard Actionhandler für die Bedienung der System- und Alarmvariablen aus dem IPS-Webfront.

Abfragen des Summenzählers der Geräte mit Leistungsmessung aus der CCU.

Abfragen der auf der CCU vorhandenen HM-Programme.
Ausführen der HM-Programme auf der CCU.
Standard Actionhandler für die Bedienung der HM-Programme aus dem IPS-Webfront.

Native Schnittstelle zur CCU, um HomeMatic-Scripte durch die CCU ausführen zu lassen.
Direkte Rückmeldung der Ausführung durch einen Antwortstring im JSON-Format.

Dynamische Textanzeige auf dem Display-Wandtaster mit Statusdisplay.
Unterstützt mehrseite Anzeigen und das durchblättern per Tastendruck.
Ausführen von benutzerspezifischen Aktionen, auch in Abhängigkeit der angezeigten Seite.

Hier handelt es sich um eine Instanz, welche die Verwendung des ePaper Statusdisplays im 55er-Rahmen vereinfachen soll.
Über spezielle PHP-Befehle ist es möglich das Display anzusteuern.

Auslesen der Informationen zu jedem Funk-Interface der CCU.

Konfigurator zum erstellen der 'Homematic RF-Interface'-Instanzen.

Bereitstellen der Informationen zu den Funk-Interfaces innerhalb von IPS.

Bereitstellen der Informationen zu dem Wired-Interface innerhalb von IPS.

2. Voraussetzungen

Funktionsfähige CCU1, CCU2 oder CCU3, welche schon mit einem HomeMatic Socket in IPS eingerichtet ist.
In der CCU muß die Firewall entsprechend eingerichtet sein, das IPS auf die 'Remote HomeMatic-Script API' der CCU zugreifen kann.

Einstellungen -> Systemsteuerung -> Firewall konfigurieren

Bei 'Remote HomeMatic-Script API' muß entweder 'Vollzugriff' oder 'Eingeschränkt' eingestellt sein. Bei 'Eingeschränkt' ist dann unter 'IP-Adressen für eingeschränkten Zugriff' euer LAN / IPS-PC einzugeben.
(z.B. 192.168.178.0/24 => /24 ist die Subnet-Maske für das Netzwerk. Bei 255.255.255.0 ist das 24 bei 255.255.0.0. ist es 16.
Oder es kann direkt eine einzelne Adresse eingetragen werden. z.B. 192.168.0.2

CCUFirewall.png

3. Software-Installation

IPS 5.1:
Bei privater Nutzung: Über den 'Module-Store' in IPS.
Bei kommerzieller Nutzung (z.B. als Errichter oder Integrator) wenden Sie sich bitte an den Autor.

4. Einrichten der Instanzen in IP-Symcon

Ist direkt in der Dokumentation der jeweiligen Module beschrieben.
Die Module der Geräte sind im Dialog 'Instanz hinzufügen' unter dem Hersteller 'HomeMatic' zu finden.

Instanzen

5. Anhang

1. GUID der Module

Modul Typ GUID
HomeMatic Systemvariablen Device {400F9193-FE79-4086-8D76-958BF9C1B357}
HomeMatic Powermeter Device {AF50C42B-7183-4992-B04A-FAFB07BB1B90}
HomeMatic Programme Device {A5010577-C443-4A85-ABF2-3F2D6CDD2465}
HomeMatic RemoteScript Interface Device {246EDB89-70BC-403B-A1FA-3B3B1B540401}
HomeMatic Dis-WM55 Device {271BCAB1-0658-46D9-A164-985AEB641B48}
HomeMatic Dis-EP-WM55 Device {E64ED916-FA6C-45B2-B8E3-EDC3191BC4C0}
HomeMatic RF-Interface Splitter Splitter {6EE35B5B-9DD9-4B23-89F6-37589134852F}
HomeMatic RF-Interface Konfigurator Configurator {91624C6F-E67E-47DA-ADFE-9A5A1A89AAC3}
HomeMatic RF-Interface Device {36549B96-FA11-4651-8662-F310EEEC5C7D}
HomeMatic WR-Interface Device {01C66202-7E94-49C4-8D8F-6A75CE944E87}

2. Changelog

Version 3.12:

  • Fix: Fehlermeldung bei Senden an Dis-EP-WM55.
  • Fix: Dokumentation für Dis-EP-WM55 korrigiert.

Version 3.11:

  • Fix: IntervalBox durch NumberSpinner ersetzt.
  • Fix: Diverse Schreibfehler.

Version 3.10:

  • Neu: Konfigurator für RF-Interfaces
  • Fix: HMScript Fehler im Log der CCU bei Verwendung der Systemvariablen-Instanz.

Version 3.00:

  • Neu: Release für IPS 5.1 und den Module-Store

Version 2.80:

  • Neu: Referenzen werden in Symcon registriert.
  • Fix: IPS_SetProperty und IPS_Applychanges auf sich selbst entfernt.

Version 2.65:

  • Fix: Keine Verbindung mehr bei CCU1 und CCU2.

Version 2.61:

  • Fix: memory exhausted error.
  • Fix: Fehler bei der Verarbeitung von AlarmVariablen bei der CCU3.
  • Neu: SSL und Authentifizierung wird für CCU3 unterstützt (sofern in IPS verfügbar!).

Version 2.60:

  • Neu: Modul intern überarbeitet.
  • Neu: Diverse Anpassungen für IPS 5.0 und neuer.
  • Fix: HmScript Fehler im Log der CCU bei Verwendung der PowerMeter-Instanz.
  • Fix: Fehlermeldung bei AlarmScriptID in der Instanz Systemvariablen.

Version 2.50:

  • Fix: Für PHP 7.3

Version 2.44:

  • Fix: ~String-Profil entfernt

Version 2.43:

  • Fix: Für IPS 5.0

Version 2.42:

  • Fix: RF-Splitter hat beim anlegen von RF-Interface Instanzen der CCU1 Fehler gemeldet.
  • Fix: Icon ON/OFF vertauscht in der Display-Statusanzeige.

Version 2.40:

  • Neu: Übersetzungen für IPS 4.3
  • Neu: Doku überarbeitet
  • Fix: Systemvariablen vom Typ Float konnten falsch übertragen werden.

Version 2.35:

  • Fix: Dis-EP-WM55 hat nur Icons von 0-3 angenommen.

Version 2.31:

  • Fix: Fehlerbehandlung verbessert.

Version 2.30:

  • Fix: Fehlerbehandlung verbessert.
  • Fix: Eventuelle XML-Fehler durch die CCU versucht abzufangen.

Version 2.22:

  • Fix: HomeMatic Remote-Script Instanzen belegten unnötig PHP-Slots.
  • Fix: Fehlermeldung im HomeMatic Systemvariablen durch eine falsche Fehlermeldung wurde ein eigentlicher Fehler überdeckt.

Version 2.20:

  • Neu: Dis-EP-WM55 Ermöglicht es per PHP die Anzeige zu beschreiben.
  • Neu: Doku für HomeMatic WR-Interface ergänzt.

Version 2.10:

  • Neu: HomeMatic WR-Interface zeigt den Status des Wired-Interfaces der CCU an.
  • Neu: Alle 'CONNECTED' Statusvariablen der CCU-Interfaces werden immer aktualisiert um Ausfälle besser detektieren zu können.
  • Fix: Instanzen haben nicht erkannt wenn sich der Parent geändert hat.
  • Fix: Timer erzeugen keine Fehlermeldungen mehr.

Version 2.07:

  • Fix: Summenzähler für Powermeter hat bei GAS falsche Werte geliefert.
  • Fix: Dis-WM55 ohne Funktion.
  • Fix: Dis-WM55 hat immer das Display-Script überschrieben.
  • Neu: Mehr Debug-Ausgaben bei Dis-WM55.

Version 2.06:

  • Fix: Doku geändert (Final).
  • Fix: GUID für Empfang vom RF-Interface Splitter.
  • Fix: Trigger für Powermeter und Systemvariablen waren unter Umständen falsch.
  • Fix: HM-Systemvariablen vom Typ String wurden falsch dargestellt, wenn Umlaute enthalten waren.

Version 2.05:

  • Fix: Unter Umständen konnte die Adresse der CCU nicht aus dem HomeMatic-Socket ermitteln werden.

Version 2.04:

  • Fix: RFInstance-Splitter hat fehler gemeldet beim Anlegen von Instanzen, wenn keine vorhanden waren.

Version 2.03:

  • Fix: Doku geändert (Teil1).

Version 2.02:

  • Fix: Powermeter-Instanz kann jetzt auch mit allen Varianten von HM-ES-TX-WM umgehen.
  • Fix: Powermeter-Instanz unterstützt jetzt auch HMIP-PSM und ähnliche HMIP-'Mess-Steckdosen'

Version 2.01:

  • Neu: RF-Interface-Splitter zum auslesen der RF-Interfaces aus der CCU.
  • Neu: RF-Interface zum darstellen der Werte eines RF-Interfaces der CCU.

Version 2.0:

Version 1.5:

Version 1.3:

Version 1.1:

6. Spenden

Die Library ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:

7. Lizenz

CC BY-NC-SA 4.0