Zum Ende der Metadaten springen
Zum Anfang der Metadaten


AutorMichael Schlenstedt
Logo

icon_64.png

Status

STABLE

Version0.1.0
Kompatibilität

LB 0.2.3 LB 1.4

Download

https://github.com/mschlenstedt/LoxBerry-Plugin-LoxMatic/archive/LoxMatic-0.1.0.zip

Zweck

Mit dem LoxMatic Plugin können mit Hilfe des Funkmoduls "Homematic HM-MOD-RPI-PCB" (Aufsteckmodul) sämtliche Homematic Sensoren und Aktoren in das Loxonesystem integriert werden. Eine separate CCU2/2 ist nicht mehr notwendig. 

 Version History...

Nutze die Beobachten-Funktion rechts oben um über neue Versionen informiert zu werden. 

Inhalt

 


   

Bluetooth am Pi3/ZeroW/3A+

Das Plugin konfiguriert bei der Installation die integrierte Bluetooth-Schnittstelle des Raspberry um. Standardmäßig verwendet Bluetooth auf dem Pi3 die schnelle UART-Schnittstelle. Diese wird jedoch für das HM-MOD-RPI-PCB Modul benötigt. Bluetooth wird auf die MiniUART-Schnittstelle umkonfiguriert. Normalerweise sollte das kein Problem darstellen, wenn entsprechende Software/Plugins die Standard-Device-Bezeichnungen für die seriellen Schnittstellen verwenden.

 

Aufgabe des Plugins

Mit dem Plugin können sämtliche Homematic Sensoren und Aktoren ausgelesen bzw. gesteuert werden. Zur Nutzung des Plugins ist ein Homematic Funkadapter notwendig, den es als Modul für den RaspberryPi in verschiedenen Ausführungen gibt (siehe unter Hardware). Eine separate CCU2/CCU3 ist nicht mehr nötig. Die Sensoren/Aktoren stehem als vollwertige Geräte in Loxone Config zur Verfügung.

Download

Fehlerberichte

Fehlerberichte bitte direkt im Repository auf GitHub melden.

Hardware

Aufsteck-Funkmodul HM-MOD-RPI-PCB (Älteres Modul)  SUPPORTED

(Bild: (c) FHEM Wiki)

Das ältere Funkmodul HM-MOD-RPI-PCB als Aufsteckvariante für die GPIO-Schnittstelle des Raspberry wird vom Plugin voll unterstützt. Das Modul besteht aus zwei Einzel-Platinen, die von eQ-3 über den Internetshop von ELV (als Bausatz ab etwa 20€) zusammen verkauft werden. Der Zusammenbau gelingt leicht.

Aufsteck-Funkmodul  RPI-RF-MOD (Neues Modul)  SUPPORTED

Bild

(Bild: (c) https://www.raspifun.de/)

Das neue Funkmodul RPI-RF-MOD als Aufsteckvariante für die GPIO-Schnittstelle des Raspberry wird vom Plugin voll unterstützt. Gegenüber dem älteren Modul soll das neue Modul eine bessere Reichweite besitzen und bringt zudem eine RealTimeClock mit. Zudem hat das Modul eine Status RGB-LED sowie eine Reset-Taste (beides aktuell im Plugin nicht verwendet). Das Modul besteht aus zwei Einzel-Platinen, die von eQ-3 über den Internetshop von ELV (als Bausatz ab etwa 40€) zusammen verkauft werden. Der Zusammenbau gelingt leicht.


USB-Funkmodul HM-CFG-USB2 (nur Homematic, kein HomematicIP)  HARDWARE NEEDED

(Bild: (c) FHEM Wiki)

Aktuell ist hier keine Unterstützung geplant. Wenn ich eine Hardware-Spende erhalte, baue ich die Unterstützung aber gerne mit ein!


USB-Funkmodul HmIP-RFUSB (nur HomematicIP, kein Homematic)  HARDWARE NEEDED

(Bild: (c) ELV)

Aktuell ist hier keine Unterstützung geplant. Wenn ich eine Hardware-Spende erhalte, baue ich die Unterstützung aber gerne mit ein!


USB-Funkmodul HB-RF-USB von Alexander Reinert  PLANNED

HB-RF-USB nackt.jpg

Diese USB-Platine ist eine Eigen-Entwicklung von Alexander Reinert! Sie bietet eine USB-Schnittstelle zu den Original-GPIO-Aufsteckmodulen von eQ-3. Es ist also zusätzlich zur Platine auch noch die Aufsteckplatine RPI-RF-MOD bzw. RPI-RF-MOD notwendig (siehe oben). Der große Vorteil liegt darin, dass damit das LoxMatic Plugin auch auf anderen Hardware-Plattformen (z. B. in einer Virtuellen Maschine) laufen wird! Aktuell versuche ich einen Prototypen zu bekommen und werde dann den entsprechenden Support auch einbauen.

Nähere Infos hier: https://homematic-forum.de/forum/viewtopic.php?f=69&t=47691

Vorbereitung

Das Plugin benutzt das Übertragungsprotokoll MQTT. Daher muss vor der Plugininstallation zunächst das MQTT Gateway Plugin installiert werden. Eine genaue Installationsanleitung findet ihr dort. Bei der Konfiguration des MQTT Gateways setzt bitte die folgenden 2 Optionen, damit die Daten vom LoxMatic Plugin im Gateway korrekt aufbereitet werden:

 

 

Ihr solltet zudem einen Usernamen und ein passwort für dem MQTT Broker vergeben. Die gleichen Zugangsdaten müssen später auch im LoxMatic Plugin eingetragen werden!

 

 

Anschließend ergänzt ihr unter "Subscriptions" den Topic des LoxMatic Plugins (hm/#):

 

Damit ist das MQTT Gateway korrekt konfiguriert. 

Konfiguration

Services

Schaut als erstes, ob alle 3 Services (RFD, HMServer und HM2MQTT) aktviert sind und laufen. RFD wird für klassische Homematic Geräte benötigt (BidCosRF Schnittstelle), HMServer wird für HomematicIP Geräte benötigt. Der Service HM2MQTT überträgt die empfangenen Daten der Homematic Geräte an das MQTT Gateway. Normalerweise solltet ihr alle 3 Services aktiviert lassen.

 

 

Namesfile

Hier kann ein Namesfile vom Homematic Manager hochgeladen werden, damit man einzelne Geräte in LoxConfig per Namen und nicht per Homematic-Seriennummer ansprechen kann. Das ist sinnvoll, falls man später einmal ein defektes Gerät austauschen möchte. Dann muss man unter LoxConfig gar nichts mehr anpassen. Näheres dazu hier:  Homematic Geräte anlernen

 

MQTT Einstellungen

 

Den Port solltet ihr nur ändern, wenn ihr wisst was hier hier tut. Ansonsten bleibt er auf den Defaulteinstellungen. Das Topic kann hier geändert werden, falls das gewünscht ist. Dann müsst ihr selbstverständlich auch die Subscription im MQTT Gateway entsprechend anpassen. Zu guter Letzt müssen hier noch Username und Passwort aus dem MQTT Gateway eingetragen werden.

Homematic Geräte einbinden

Wie an einer Original CCU müssen auch im Plguin die Homematicgeräte angelernt werden. Näheres dazu findet ihr hier: Homematic Geräte anlernen

MQTT Verbindung testen

Bevor ihr anfangt und in LoxConfig die Homematic-Geräte einbindet, solltet ihr testen, ob die entsprechenden MQTT Statusmeldungen eurer Geräte auch am MQTT Broker (dem MQTT Gateway Plugin) ankommen. Näheres dazu hier: MQTT Verbindung testen

Untersützte Homematic Geräte

 

Helfe mit!

Bitte trage hier Deine Homematic-Geräte ein, die Du erfolgreich mit dem Plugin verwendest. Sollte ein Gerät nicht funktionieren, trage bitte auch das hier ein! Wenn Du spezielle Einstellungen für Dein Gerät verwendest oder andere wichtige Dinge herausgefunden hast, so erstell doch bitte eine Unterseite unter Geräte zu Deinem Homematic-Gerät, wo Du das Wissen dokumentierst!

 

Wahrscheinlich gibt es keine Tabelle innerhalb des Tabellenfilter-Makro. Legen Sie bitte die Tabelle oder das Makro, das eine Tabelle erzeugt, innerhalb dieses Makros ab.

Die Tabelle lädt gerade, bitte warten.
TypenbezeichnungBezeichnungProtokollUnterstützt?DokumentationBemerkung
HM-CC-RT-DNHeizkörperthermostatBidCos-RF

JA


-
HM-ES-PMSw1-PlSchaltaktor 1fach mit LeistungsmessungBidCos-RF

JA


Alle Daten werden per MQTT übertragen. Relais ansteuern über UDP: EIN: hm/set/YOURDEVICE:1/STATE =1 AUS: hm/set/YOURDEVICE:1/STATE Über HTTP: http://IP-LOXBERRY/admin/plugins/mqttgateway/mqtt.php?topic=hm/set/YOURDEVICE:1/STATE&value=1 oder 0

HM-MOD-EM-88-Kanal-SendemodulBidCos-RF

JA


Alle Daten werden per MQTT übertragen.
HM-MOD-Re-88-Kanal-EmpfangsmodulBidCos-RF

JA


Alle Daten werden per MQTT übertragen.
HM-PB-2-WM55Wandtaster 2-fachBidCos-RF

TEILWEISE


Config Probleme: Es wird nur "val":true gesendet, kein false. HTML-Eingang als "Digitaleingang" verwenden als Workaround.
HM-RC-8Fernbedienung 8 TastenBidCos-RF

TEILWEISE


Config Probleme: Es wird nur "val":true gesendet, kein false. HTML-Eingang als "Digitaleingang" verwenden als Workaround.
HM-Sec-RHSFunk-Fenster-/DrehgriffkontaktBidCos-RF

JA


-

HM-Sec-SC-2Funk-Tür-/FensterkontaktBidCos-RF

JA


Alle Daten werden per MQTT übertragen.
HM-Sec-SCoTür-/Fensterkontakt optischBidCos-RF

JA

Dokumentation-
HM-Sec-SD-2RauchmelderBidCos-RF

JA


-
HmIP-BSMSchalt-Mess-Aktor für MarkenschalterHmIP

JA

Dokumentation

HmIP-eTRV-2

Heizkörperthermostat HmIP

JA

Dokumentation
HmIP-SMIBewegungsmelderHmIP

JA

DokumentationAlle Daten werden per MQTT übertragen.
HmIP-SWDOFenster- und Türkontakt, optischHmIP

JA


Alle Daten werden per MQTT übertragen.



Kommentar

  1. HarryB sagt:

    der eQ3-Service hat auf meine Anfrage hin folgende Dokumente zum Download bereitgestellt. Sie enthalten viele Infos zu den Parametern der hm- und hmIP-Geräten.

    https://www.eq-3.de/service/downloads.html?id=29

    https://www.eq-3.de/service/downloads.html?id=30 

    https://www.eq-3.de/service/downloads.html?id=33

    https://www.eq-3.de/service/downloads.html?id=90

    https://www.eq-3.de/service/downloads.html?id=183

    https://www.eq-3.de/service/downloads.html?id=182

    Falls schon bekannt, sorry, für mich waren die Infos neu. Sollten die Infos hier falsch sein, bitte ich die Admins, die Links einfach dort hinzuschieben, wo sie ggf. besser platziert sind. Die Nachricht darf dann gelöscht werden.