Klingel mit Homematic IP: Push, Gong im Haus und Kamera-Alarm

01Ziel und Idee

Eine klassische Klingel ist nur dort zu hören, wo der Gong hängt. Im Keller, im Garten oder mit Kopfhörern im Arbeitszimmer geht ein Klingeln schnell unter – und der Paketbote ist wieder weg. Mit Homematic IP lässt sich das Klingeln an mehreren Stellen gleichzeitig melden:

• Gong im Haus: Der Kombisignalgeber HmIP-MP3P spielt einen Klingelton von seiner microSD-Karte und lässt seinen LED-Ring aufleuchten.
• Push aufs Handy: Die Zentrale schickt eine Nachricht, auch wenn niemand zu Hause ist.
• Kamera: Eine INSTAR-Kamera bekommt per CGI-Befehl einen Alarm und speichert bzw. verschickt Bilder nach ihren eigenen Alarmeinstellungen.
• Zweitgong (optional): Eine Bose SoundTouch spielt zusätzlich eine MP3-Ansage im Wohnzimmer.

Damit ein ungeduldiger Besucher nicht zehn Push-Nachrichten in Folge auslöst, sperrt eine Systemvariable das Programm nach dem ersten Klingeln für 30 Sekunden.

02Geräte anlernen und einrichten

Klingeltaster HmIP-DBB: Der Taster läuft mit einer Batterie LR03/Micro/AAA, ist nach IP43 geschützt und wird mit Schrauben und Dübeln neben der Haustür montiert. Eine Klingelleitung ist nicht nötig. Laut Bedienungsanleitung lässt er sich an den Access Point oder an die Zentrale CCU3 anlernen. In der WebUI startet man unter „Geräte anlernen“ den Anlernmodus für Homematic IP und zieht dann den Isolierstreifen aus dem Batteriefach – der Taster ist danach drei Minuten anlernbereit. Ein kurzer Druck auf die Systemtaste verlängert das um weitere drei Minuten. Das Gerät erscheint anschließend im Posteingang und bekommt dort einen sprechenden Namen, z. B. „Klingel Haustür“.

Kombisignalgeber HmIP-MP3P: Er wird mit drei Batterien LR14/Baby/C oder mit einem Steckernetzteil (5 V) betrieben. Für einen Gong, der oft spielt, ist das Netzteil die bequemere Wahl. Eigene Klingeltöne kommen als MP3 auf eine FAT32-formatierte microSD-Karte, und zwar direkt ins Hauptverzeichnis. Die Dateinamen müssen mit drei Ziffern beginnen und dürfen keine Leerzeichen enthalten, z. B. 001_Tuergong.mp3. Die Karte nur bei ausgeschaltetem Gerät einstecken oder entnehmen. Angelernt wird wie beim Taster über „Geräte anlernen“ → „HmIP Gerät anlernen“.

Direktverknüpfung prüfen: Unter „Programme und Verknüpfungen → Direkte Verknüpfungen“ lässt sich prüfen, ob die eigene Firmware eine Verknüpfung zwischen dem Tasterkanal des Klingeltasters und dem Kombisignalgeber anbietet. Ist das der Fall, klingelt der Gong auch dann, wenn die Zentrale gerade neu startet. Andernfalls übernimmt das Programm unten auch den Gong.

03Systemvariablen anlegen

Unter „Einstellungen → Systemvariable“ zwei Variablen anlegen:

Damit die Sperre zuverlässig wieder frei wird, gibt ein kleines zweites Programm sie nach 30 Sekunden frei:

• Wenn: Systemvariable „Klingel_Sperre“ bei „gesperrt“ – bei Änderung auslösen
• Dann: Systemvariable „Klingel_Sperre“ verzögert um 30 Sekunden „frei“

Die Freigabe steht bewusst nicht im Klingel-Programm selbst. Wird ein Programm erneut ausgelöst und läuft dabei in den Sonst-Zweig, können noch wartende verzögerte Aktivitäten des Dann-Zweigs verworfen werden – die Sperre bliebe dann dauerhaft auf „gesperrt“.

Für Kamera und Push wird außerdem der CUx-Daemon mit einem Gerät vom Typ „System“ (Exec) benötigt. In den Beispielen heißt es CUX2801001 – so wie in den bestehenden INSTAR- und Bose-Anleitungen auf dieser Seite.

04Programm erstellen

Unter „Programme und Verknüpfungen → Programme & Zentralenverknüpfung“ ein neues Programm „Klingel Haustür“ anlegen. Die Bedingung auf den Tastendruck steht auf „bei Aktualisierung auslösen“, damit auch ein zweites Klingeln nach Ablauf der Sperre zuverlässig erkannt wird. Die Sperre wird nur geprüft; freigegeben wird sie vom zweiten Programm „Klingel Sperre lösen“.

Für den Kombisignalgeber empfiehlt eQ-3 in einem Hinweisblatt, die Parameter möglichst vollständig zu übertragen, also MP3-Datei, Lautstärke sowie „Einheit Zeitdauer“ und „Wert Zeitdauer“ in einer Aktivität zu setzen. Die Zeitdauer wird laut Hinweisblatt nur zusammen mit einem Lautstärke- oder Dimmwert übertragen – beim Lichtsignal deshalb immer auch eine Helligkeit setzen. Werden nur einzelne Werte gesendet, nutzt das Gerät für die übrigen die zuletzt gesetzten.

Das folgende Skript steht als letzte Aktivität im Dann-Teil („Skript“). Es löst bei einer INSTAR-Kamera der Full-HD-Serie den Alarm aus und sendet eine Push-Nachricht über Pushover. Wer Telegram nutzt, ersetzt nur die letzte Zeile.

! Klingel: Kamera-Alarm auslösen, Zeitstempel merken, Push senden
! Voraussetzung: CUx-Daemon mit Gerät CUX2801001 (System/Exec)
! XXX-Werte (IP, Benutzer, Passwort, Token) durch eigene ersetzen

var oExec = dom.GetObject("CUxD.CUX2801001:1.CMD_EXEC");
string sZeit = system.Date("%H:%M");

! 1) Zeitpunkt in der Systemvariable "Klingel_Letzte" (Zeichenkette) ablegen
var oLetzte = dom.GetObject("Klingel_Letzte");
if (oLetzte) {
  oLetzte.State(system.Date("%d.%m.%Y %H:%M:%S"));
}

! 2) INSTAR Full-HD-Kamera: Alarm auslösen (Kamera speichert/versendet
!    Bilder gemäß ihren eigenen Alarmeinstellungen)
oExec.State("wget -q -O - 'http://XXX/param.cgi?cmd=pushhostalarm&-usr=XXX&-pwd=XXX'");

! 3) Push-Nachricht per Pushover (Token und User-Key aus dem Pushover-Konto)
string sMsg = "Es hat an der Haustür geklingelt (" # sZeit # " Uhr)";
oExec.State("/usr/bin/curl -s -m 10 --form-string 'token=XXX' --form-string 'user=XXX' --form-string 'message=" # sMsg # "' https://api.pushover.net/1/messages.json");

Das Skript nutzt das CUxD-Exec-Gerät, um zwei HTTP-Aufrufe abzusetzen; curl liegt bei CCU3, RaspberryMatic und OpenCCU unter /usr/bin/curl. Der Befehl pushhostalarm ist im INSTAR-Wiki für die Full-HD-Serie mit den Parametern -usr und -pwd beschrieben; WQHD-Modelle verwenden laut INSTAR user= statt -usr=. Die Kamera reagiert darauf mit den Aktionen, die in ihrem Alarm-Menü eingestellt sind (z. B. Bild per E-Mail oder FTP). Zugangsdaten stehen im Klartext in der URL, das Skript deshalb nur im lokalen Netz verwenden. Wer bereits das Sende-Programm aus der Anleitung zu Push-Nachrichten mit Telegram oder Pushover nutzt, ersetzt die Push-Zeile durch dom.GetObject("PushText").State(sMsg); – dann läuft der Versand über dieses zentrale Programm.

Bose SoundTouch als Zweitgong: Wer bereits eine SoundTouch ab Serie II besitzt, kann das Skript aus der Anleitung „Bose SoundTouch als Homematic MP3-Funkgong“ als weitere Skript-Aktivität anhängen und dort eine Klingel-MP3 eintragen.

05Testen und Feinschliff

1. Zuerst nur den Gong testen: Skript-Aktivität vorübergehend entfernen, klingeln, Lautstärke anpassen.
2. Danach das Skript einzeln über „Skript testen“ in der WebUI ausführen und prüfen, ob die Push-Nachricht ankommt und die Kamera einen Alarm im Systemprotokoll verbucht.
3. Zum Schluss mehrfach kurz hintereinander klingeln: Innerhalb von 30 Sekunden darf nur eine Push-Nachricht kommen, und nach Ablauf muss „Klingel_Sperre“ wieder auf „frei“ stehen.

Bleibt alles stumm, lohnt ein Blick auf die LED des Klingeltasters. Leuchtet sie nach dem Drücken lange rot, wurde der Befehl nicht bestätigt oder das Duty-Cycle-Limit ist erreicht. Dann den Abstand zur Zentrale prüfen.

06Erweiterungen

Das Grundprogramm lässt sich gut ausbauen, ohne den Ablauf zu verändern:

• Licht an der Haustür: Bei Dunkelheit schaltet eine zusätzliche Aktivität das Außen- oder Flurlicht für einige Minuten ein. Als Bedingung eignet sich das Astro-Zeitmodul („Astrofunktion“) mit „nur prüfen“.
• Abwesenheit: Ist niemand zu Hause, kann ein zweites Programm statt des Gongs nur die Push-Nachricht senden. Dafür genügt eine Systemvariable „Anwesenheit“ als zusätzliche Bedingung.
• Klingelprotokoll: Die Systemvariable „Klingel_Letzte“ lässt sich in der WebUI oder in Apps anzeigen. So sieht man nach der Rückkehr, wann zuletzt jemand geklingelt hat.
• Andere Kameras: Statt des INSTAR-Befehls kann jede Kamera eingebunden werden, die per HTTP-Aufruf einen Alarm oder einen Schnappschuss auslöst. In der Skriptzeile ändert sich dann nur die URL.

Wichtig bleibt die Reihenfolge im Dann-Teil: zuerst die Sperre setzen, dann Gong und Skript. Die Freigabe übernimmt immer das separate Programm „Klingel Sperre lösen“.

07Tipps aus der Praxis

• Den Kombisignalgeber mit Steckernetzteil betreiben, wenn er häufig klingelt – ein Klingelgong ist ein Dauerverbraucher.
• Klingel-MP3 vorher normalisieren und Cover-Bilder aus den ID3-Tags entfernen; laut Anleitung führen Pegelspitzen sonst zu Verzerrungen oder Aussetzern, und Bilder im ID3-Tag sind nicht erlaubt.
• Die Bedingung auf den Tastendruck immer mit „bei Aktualisierung auslösen“ anlegen, nicht mit „bei Änderung auslösen“.
• Die akustische Rückmeldung des Klingeltasters (positiv/negativ) ist ab Werk deaktiviert; laut Anleitung wird sie über die Homematic IP App aktiviert. An der CCU in den Geräteeinstellungen der WebUI nachsehen, ob der Parameter dort angeboten wird.
• Für den Nachtbetrieb ein zweites Programm mit Zeitmodul anlegen, das abends nur eine leise Datei abspielt oder ausschließlich eine Push-Nachricht sendet.
• Den Klingeltaster nicht in der prallen Sonne oder an einer Stelle mit Schlagregen montieren; er ist für einen witterungsgeschützten Standort gedacht.
• Startet die Zentrale während der 30-Sekunden-Sperre neu, kann die verzögerte Freigabe verloren gehen. Steht „Klingel_Sperre“ danach noch auf „gesperrt“, die Variable unter „Status und Bedienung → Systemvariable“ von Hand auf „frei“ setzen.

08Häufige Fragen

09Passende Anleitungen

• Bose SoundTouch als Homematic MP3-FunkgongSkript für einen zweiten Gong über eine SoundTouch
• CGI-Befehle für INSTAR HD Kameras mit Homematicweitere Kamera-Befehle wie Snapshot und Nachtsicht
• INSTAR HD Kamera mit Homematic steuernKamera per Homematic scharf schalten
• CUx-Daemon (CUxD) auf der Homematic CCU installierenVoraussetzung für das Exec-Gerät im Skript
• Homematic Push-Nachrichten mit Telegram oder Pushoverzentrales Sende-Programm für alle Push-Meldungen einrichten