Skip to content
Jens Maus edited this page Oct 5, 2026 · 28 revisions

Nachfolgend findest du praxisnahe Hinweise rund um OpenCCU – von Gateway-Besonderheiten über Programm-Kniffe bis zu Systemoptionen.


homematicIP AccessPoint (HmIP-HAP) als HmIP-Gateway

Der HmIP-HAP kann an OpenCCU als Gateway zur Reichweitenerweiterung von Homematic IP-Geräten genutzt werden (ausschließlich Homematic IP; für klassisches HomeMatic sind weiterhin BidCos-RF-LAN-Gateways nötig). Der HAP wird dazu wie jedes andere Homematic IP-Gerät direkt an OpenCCU angelernt. Danach lassen sich weitere Homematic IP-Geräte hinzufügen, die über den HAP kommunizieren.

Wichtig: Für den Betrieb eines HmIP-HAP an OpenCCU ist ein RPI-RF-MOD oder HmIP-RFUSB erforderlich. Ein HM-MOD-RPI-PCB oder andere ältere Funkmodule sind nicht kompatibel.

Dasselbe gilt für den Homematic IP Wired Access Point HmIPW-DRAP. Wird OpenCCU als Home Assistant App betrieben, ist für HmIP-HAP bzw. HmIPW-DRAP zusätzlich die App OpenCCU HAP/DRAP-Helper erforderlich.

Fehlerbehebung (Anlernen / Firmware-Update)

  • Bei aktiver OpenCCU-Firewall den Port 9293 freigeben.
  • Direkt nach dem Start eines Firmware-Updates testweise dem HAP im Router den Internetzugang sperren, damit kein Cloud-Update dazwischenfunkt (verhindert u. U. eine rot blinkende LED).
  • Dem HAP eine feste IP-Adresse zuweisen (Router-DHCP-Reservierung oder eQ-3 NetFinder).
  • IGMP Snooping in Switches kann den Multicast-Datenverkehr stören; bei Problemen Snooping deaktivieren. DLAN/Powerline möglichst nicht verwenden.
  • Taucht der HAP nicht im Posteingang auf: OpenCCU 1–2× neu starten.

Negierte Bedingungen in Programmen

Seit Version 3.53.x lassen sich Bedingungen in Programmen negieren. Ein Programm löst dann nur aus, wenn die angegebene Bedingung nicht wahr ist.

Zwischen Systemvariable/Gerät und Zustand gibt es dafür ein zusätzliches Dropdown-Feld:

rm_negation1

Standard ist leer; wähle „nicht“, um die Bedingung zu negieren:

rm_negation2

Beispiel – Fenster nicht geschlossen (Drehgriffkontakt):

Herkömmlich:

Wenn:
  Gerät "Mein Drehgriffkontakt" bei "Gekippt"  "Bei Änderung auslösen"
ODER
  Gerät "Mein Drehgriffkontakt" bei "Offen"    "Bei Änderung auslösen"
Dann:
  ...

Mit Negation:

Wenn:
  Gerät "Mein Drehgriffkontakt" "Nicht" bei "Geschlossen"  "Bei Änderung auslösen"
Dann:
  ...

So lässt sich auch bei Wertelisten-Systemvariablen elegant „alles außer …“ abbilden – ebenso bei String-Systemvariablen.

Siehe auch: HomeMatic-Forum.


Zeitmodul mit erweiterter Astro-Funktion (Offset und Limit)

Seit Version 3.51.x unterstützt die Astro-Funktion Offsets und Limits. Damit kann ein Programm z. B. 30 Minuten vor Sonnenaufgang auslösen und die Bedingung 30 Minuten nach Sonnenaufgang wieder unwahr werden lassen.

Beispiel:

tipps_astro_offset

Lässt du den Wert hinter „oder für“ leer, bleibt die Bedingung wie bisher bis zum nächsten Wechsel von Sonnenauf-/-untergang gültig.


Überwachung der Internet-Verbindung deaktivieren

Standardmäßig prüft OpenCCU regelmäßig die Internetverbindung und meldet mit der Alarmmeldung WatchDog: no-internet, wenn die Internetverbindung längere Zeit ausfällt (siehe auch FAQ). Wird OpenCCU bewusst ohne Internetzugang betrieben, lässt sich diese Überwachung bequem in der WebUI unter Einstellungen → Systemsteuerung → Erweiterte Einstellungen → Internet Überwachung deaktivieren. Alternativ ist dies auch per Kommandozeile oder ReGa-Skript möglich.

Hinweis: Für das Anlernen von Homematic IP-Geräten ist eine funktionierende Internetverbindung erforderlich (Schlüsselaustausch mit eQ-3-Servern). Auch beim Wechsel des Funkmoduls werden Schlüssel online erneuert.

Variante 1 – per SSH

# Überwachung deaktivieren
touch /etc/config/internetCheckDisabled

# Überwachung wieder aktivieren
rm -f /etc/config/internetCheckDisabled
monit monitor internetCheck

Variante 2 – per ReGa-Skript (WebUI → Skript testen)

! Deaktivieren
system.Exec("touch /etc/config/internetCheckDisabled");
! Aktivieren
system.Exec("rm -f /etc/config/internetCheckDisabled; monit monitor internetCheck");

Clone this wiki locally