Was ist der CUx-Daemon

Die HomeMatic Zusatzsoftware CUx-Daemon (kurz CUxD) ist eine universelle Schnittstelle zwischen der HomeMatic Zentrale (CCU2 & RaspberryMatic) und den Komponenten anderer Haussteuerungs- bzw. Smart Home-Systeme. Hierzu zählen unter anderem die Systeme ELV FS20, FHT, HMS und EM/ESA, aber auch Komponenten des EnOcean-Systems und vieles mehr. Durch Einbindung dieser eigentlich inkompatiblen Produkte lässt sich der Umfang des HomeMatic Systems über die Grenzen hinweg erweitern.

Sowohl die HomeMatic Zentrale auf der CCU2 wie auch RaspberryMatic sind beide Linux-basiert, so dass es hier recht einfach ist, zusätzliche Programmmodule einzubinden. In die Systemsoftware für das HomeMatic System wurden zudem vorausschauend systemoffene Schnittstellen implementiert, die den Zugriff auf die verschiedenen Systemschichten der CCU-Software durch Zusatzbausteine erlauben. Dies ermöglicht u. a. die Anbindung von Cloud-Diensten, Apps und diverser Zusatzsoftware, so auch der Software CUx-Daemon.

Aufgrund des großen Funktionsumfangs und der Komplexität kann ich hier nicht alle Möglichkeiten aufzeigen. Ich möchte hier beschreiben, wie man das „SYSTEM.EXEC“ mit Hilfe von CUxD ablösen kann.

Auch ELV kann aufgrund des großen Funktionsumfangs und der Komplexität zu dieser Zusatzsoftware leider keinerlei Support übernehmen. Bei allen Fragen zu CUxD steht euch allerdings das HomeMatic-Forum zur Verfügung, welches durch viele erfahrene User und auch den Entwickler selbst betreut wird und somit als Support-Plattform dient.


Warum den CUx-Daemon einsetzen

Wie oben bereits kurz erwähnt, verwende ich in all meinen HomeMatic-Scripten, wo ich eine Systemfunktion aufrufe den Befehl „SYSTEM.EXEC“. Nachfolgend ein Screenshot eine Scripts zur Versendung einer PUSH Nachricht per TELEGRAM App.

Nachteile des Befehls „SYSTEM.EXEC“

  • Der Befehl ist weder dokumentiert noch offiziell unterstützt
  • Die CCU-Logikschicht bleibt während der gesamten Ausführungszeit des aufgerufenen Programmes stehen
  • Längere Programm Ausführungszeiten oder wiederholte Aufrufe eines Programmes oder parallele Ausführung führen zu einer Instabilität der CCU
  • Konsequenzen dieser Probleme können sein, dass Programme nicht mehr ausgeführt werden, die WebUI Oberfläche nicht mehr reagiert und letztlich, das die CCU stehen bleibt und neu gestartet werden muss.

Der CUx-Daemon bietet eine alternative Möglichkeit um Systembefehle auszuführen. Dafür muss CUxD installiert, sowie ein entsprechendes CUxD-Gerät definiert werden. Wie das funktioniert, beschreibe ich im weiteren Verlauf dieses  Artikels. Wenn das alles erledigt ist, kann die „SYSTEM.EXEC“ Funktion ersetzt werden.

Ein weiterer Grund mich mehr mit CUxD zu beschäftigen ist mein aktuelles Projekt, die Einbindung meiner SONOS Lautsprecher in HomeMatic. Dazu werden auch eine Vielzahl von Systemfunktionen über „SYSTEM.EXEC“ aufgerufen, welche ich von Beginn an auf CUxD umstellen möchte.

Installation CUx-Daemon (CUxD)

AddOn herunterladen – Achtung, es existieren hier verschiedene Versionen für die unterschiedlichen Plattformen CCU1/CCU2 und RaspberryMatic.

Downloadlink für CUxD Software und Handbuch

Die Installation auf der CCU/RASPBERRYMATIC erfolgt über das WebUI-Menü „Systemsteuerung > Zusatzsoftware“.

Bei der Installation werden alle CUxD-Dateien auf der CCU/RASPBERRYMATIC im Verzeichnis „/usr/local/addons/cuxd/“ installiert.

Um den CUxD RPC-Server automatisch beim Hochfahren der CCU/RASPBERRYMATIC zu starten, wird zusätzlich die Startdatei cuxdaemon in dem Verzeichnis „/usr/local/etc/config/rc.d/“ abgelegt. Zusätzlich trägt sich der CUxD bei jedem Start als eigener RPC-Server in die Datei /etc/config/InterfacesList.xml ein. Diese Datei wird bei jedem CCU-Start neu geschrieben. Die CCU/RASPBERRYMATIC überprüft beim Neustart zuerst alle bereits vorhandenen Schnittstellen (Wired, Funk). Das dauert je nach Anzahl der installierten HomeMatic-Geräte mehrere Minuten.


Nach erfolgreicher Installation und einem Neustart der CCU/RASPBERRYMATIC ist im WebUI Menü „Zusatzsoftware“ jetzt „CUx-Daemon“ zu finden. Um im nächsten Schritt das erste CUxD-Gerät anzulegen, bitte auf den Button „CUx-Daemon“ klicken.

Gerät im CUx-Daemon anlegen

Im Primary Menü von CUx-Daemon auf den Button „Geräte“ klicken, um ein neues Gerät anzulegen. 

Dann erscheint das Menü in dem ihr die Eingaben im folgenden Screenshot eintragen solltet.

Das Feld Name bitte leer lassen, wird dann automatisch generiert!

Nach der Auswahl der gezeigten Parameter bitte auf den Button „Gerät auf CCU erzeugen !“ drücken.

Das neue Gerät taucht dann automatisch in der WebUI unter „Einstellungen > Geräte – Posteingang“ auf und kann dort ohne weitere Konfiguration mit „FERTIG“ bestätigt werden.

Anschließend findet ihr das neue CUxD-Gerät unter „Einstellungen > Geräte“ wie jedes andere Gerät/Aktor auch. Aber auch hier ist keine weitere Anpassung erforderlich. Wir nutzen dieses virtuelle Gerät um Systemfunktionen innerhalb eines Scriptes aufzurufen.

Nach erfolgreicher Erstinstallation des CUxD muss die CCU/RASPBERRYMATIC nach dem Anlegen des ersten CUxD-Gerätes ein zweites Mal durchgestartet werden. Erst danach ist das CUxD-Interface vollständig betriebsbereit und kann auch Befehle von der CCU/RASPBERRYMATIC empfangen.

Erstinstallation:

  1. CUxD installieren (automatischer Neustart der CCU/RASPBERRYMATIC)
  2. CUxD Gerät(e) anlegen und im Posteingang der CCU/RASPBERRYMATIC bestätigen
  3. CCU/RASPBERRYMATIC ein weiteres Mal durchstarten!
  4. das CUxD-Interface ist jetzt funktionsbereit.

SYSTEM.EXEC ersetzen durch CUxD

Nachfolgend zeige ich beispielhaft für zwei Funktionen anhand von Vorher/Nachher auf, wie die Umstellung von „SYSTEM.EXEC“ auf CUxD realisiert werden kann. Weitere Beispiele werden folgen.

VORHER – PUSH Nachricht an  TELEGRAM versenden mit SYSTEM.EXEC

NACHHER – PUSH Nachricht an TELEGRAM versenden mit CUx-DAEMON

VORHER – MAIL über CloudMatic versenden mit SYSTEM.EXEC

NACHHER – MAIL über CloudMatic versenden mit CUx-DAEMON

Interessante Links zum CUx-Daemon

Wie bereits erwähnt ist dieses AddOn Paket sehr umfangreich und die hier beschrieben Funktion ist nur ein kleiner Teil der Möglichkeiten. Von der Firma ELV existiert eine sehr interessante vierteilige Dokumentationsreihe zum CUx-Daemon. Hier stelle ich für Interessenten die entsprechenden Links zur Verfügung:

CUxD – das Leatherman für die HomeMatic CCU – Teil 1

CUxD – das Leatherman für die HomeMatic CCU – Teil 2

CUxD – das Leatherman für die HomeMatic CCU – Teil 3

CUxD – das Leatherman für die HomeMatic CCU – Teil 4

HomeMatic/Raspberry Komponenten

Bezeichnung Amazon ELV-Shop ELV-Bausatz
16 GB SD-Karte Link nicht verfügbar nicht verfügbar
16 GB USB Stick Link nicht verfügbar nicht verfügbar
CCU2 Link Link Bausatz
Raspberry Pi 2 Link Link nicht verfügbar
Raspberry Pi3 Link Link nicht verfügbar
Raspberry Pi Zero W Link nicht verfügbar nicht verfügbar
H-Tronic Funk-Antenne 868 MHz Link nicht verfügbar nicht verfügbar
HM Raspberry Funkmodul nicht verfügbar nicht verfügbar Link

Das könnte Dich auch interessieren

RaspberryMatic: FINAL Version 2.27.8.20170501
Aufrufe 2073
Es ist vollbracht: Am 01. Mai hat die RaspberryMatic Community rund um Jens Maus die finale Version zur Verfügung gestellt. Damit ist die Beta-Phase a...
RaspberryMatic: Update auf 2.27.8.20170410-beta6
Aufrufe 3520
Auch dieses Mal hat es nicht  lange  gedauert und kurz nach der neuen CCU2 Firmware Version 2.27.8 von eQ-3 bringt die RaspberryMatic Community auch e...
VORSCHAU – Neuigkeit 01.2019 – Homematic IP 6fach-Kontakt-Interface ...
Aufrufe 1676
Ein weiterer sehr interessanter Aktor ist das Homematic IP 6fach-Kontakt-Interface UP, welches unter dem Namen HmIP-FCIS. Damit ist es möglich auch h...
VORSCHAU – Neuigkeit 01.2019 – Homematic IP Fernbedienung mit Montagegurt –...
Aufrufe 1040
Heute möchte ich euch wieder eQ-3 Neuigkeiten vorstellen, die für Januar 2019 angekündigt sind. In diesem Artikel geht es um eine HomeMatic IP Fernbe...
NEUHEIT – Homematic IP Funk-Klingeltaster HmIP-DBB, ARR-Bausatz
Aufrufe 2842
Bereits am 25.07.2018 habe ich euch in dem Artikel "Vorschau - Neuigkeiten 09.2018" über diesen Aktor informiert. Nun ist er verfügbar und ich möchte...
Raspberrymatic – neue Firmware Version 3.37.8.20180922 verfügbar – C...
Aufrufe 4377
Knapp 2 Wochen nachdem die CCU3 inklusive neuer Firmware Version verfügbar ist, gibt es auch wieder eine neue RaspberryMatic Firmware Version mit der...
5 Kommentare
  1. Fred sagte:

    Hi Werner,
    ich habe heute versucht die Cloudmatic Pushbenachrichtigung auf den CuxD umzustellen. Wie mache ich es denn wenn ich zwei Geräte benachrichtigen will oder wie oben in deinem Beispiel an zwei E-Mailempfänger eine Mail verschicken möchte?

    Einfach eine zweite Variable mit E-Mailempfänger anlegen und Aufruf
    dom.GetObject(„CUxD.CUX2801001:3.CMD_EXEC“).State(„/bin/sh /etc/config/addons/mh/email.sh „# sendbetreff # “ “ # sendmail # “ “ # mailto);

    duplizieren und mailto durch z. B. mailto2 ersetzen?

    Gruß
    Fred

    Antworten
    • Werner
      Werner sagte:

      Hallo Fred,

      wenn ich dich richtig verstehe, versendest du bisher sowohl Push als auch Mail Benachrichtigungen via system.exec? Auch an zwei Empfänger?

      Sei so gut und sende mir deinen aktuellen, funktionierenden Code an die Mail Adresse werner(@)technikkram.net

      Danke und Gruss
      Werner

      Antworten
  2. Bernd sagte:

    Hallo Werner,
    Danke für die obigen sehr gut beschriebenen Ausführungen!

    Ich habe nun von der CCU2 auf den Raspi mit Raspberrymatic gewechselt. Bis auf CUxD hat auch alles wunderbar funktioniert.
    CUxD habe ich auch auf die Rasperrymatic-Variante aktualisiert. Man kann diese auch Öffnen, und sich die Geräte, Log etc. ansehen.
    Es werden allerdings irgendwie keine Befehle versendet, z.B. Telegram-Nachrichten oder Abruf von Wetterdaten aus wunderground.com.
    Woran kann das liegen?
    Hier die Infos aus dem Log:
    Telegram
    Jan 8 12:33:20 homematic-raspi daemon.info cuxd[1614]: system(wget –no-check-certificate –quiet -O /dev/null „https://api.telegram.org/botXXXXXXXXXXXXXXXXXXXXXXXX/sendMessage?chat_id=XXXXXXXXXXX&text=Dies%20ist%20eine%20Push%2DTestnachricht“) exit(4) 0s

    Wunderground
    Jan 8 12:33:27 homematic-raspi daemon.info cuxd[1622]: pclose(wget -q -O – ‚http://api.wunderground.com/api/XXXXXXXXXXXXX/conditions/lang:DL/q/Germany/MUENCHEN.xml‘) exit(4) 0s

    Unter CUxD-Setup sind noch die Infos aus der CCU drinnen, z.B.
    MOUNTCMD=ln -s /media/sd-mmcblk0 /tmp/sd
    UMOUNTCMD=rm -f /tmp/sd
    Kann das so bleiben?

    Wäre prima, wenn Sie einen entscheidenen Hinweis hätten, dass meine Kommunikation in die Außenwelt mit Telegram und Wunderground wieder funktioniert.

    Viele Grüße
    Bernd

    Antworten
  3. Dieter sagte:

    Hallo Werner,
    danke für deine tollen Beiträge, auch zum Thema Smart-Home.
    Aktuell habe ich entsprechend deines Posts einen Cux-Daemon(CuxD) auf meinem
    RaspberryMatic (CCU2 -Alternative) mit Funkmodul installiert.
    Basis ist das aktuelle fertige Image von J.Maus.
    Alles funktioniert prima ,allerdings startet der Cux-Daemon in meinem Browser nicht.
    Kann dies etwas mit meinem Raspberry P1 B+ zu tun haben?

    Gruß,
    Dieter

    Antworten

Dein Kommentar

An Diskussion beteiligen?
Hinterlasse uns Deinen Kommentar!

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert.

Ich akzeptiere die Speicherung der Daten.