Dieses Modul erlaubt den Abruf von Raumbelegungs-Daten aus ChurchTools, um darauf basierend die Heizung zu steuern.
Features:
- Individuelle Selektion, welche Räume aus ChurchTools als Geräte angelegt werden sollen
- Automatischer Abruf der Raumbelegungen alle 10 Minuten
- Pro Raum wird die Raumbelegung als Variable bereitgestellt, diese wird alle 10 Sekunden aktualisiert
- Je Raum kann ein individueller Heiz-Vorlauf sowie ein vorzeitiges Heiz-Ende konfiguriert werden, die Variable "Heizen" berücksichtigt diese Einstellungen
- Je Raum kann einstellt werden, ob auch Buchungsanfragen wie feste Buchungen behandelt werden sollen
- IP-Symcon ab Version 6.0
- eine ChurchTools-Installation (siehe https://church.tools)
- einen ChurchTools-User mit Berechtigungen für das Ressourcen-Modul. Von diesem User wird der Login-Token benötigt. In ChurchTools kann der Token unter Personen & Gruppen > Personenliste > "Person A" > Berechtigungen > Login-Token abgerufen werden
Im Modul-Store von IP-Symcon nach "ChurchTools" suchen und das Modul "ChurchTools Raumbelegungen" installieren.
Oder über das Modul-Control folgende URL hinzufügen: https://github.com/churchtools/ip-symcon
Unter "Instanz hinzufügen" zunächst das "ChurchTools Gateway" (Hersteller: ChurchTools Innovations GmbH) hinzufügen. Daraufhin öffnet sich automatisch die Konfiguration des Gateways und die Zugangsdaten (URL der eigenen ChurchTools-Installation und Login-Token) können eingetragen werden.
Ist die Verbindung zu ChurchTools erfolgreich, werden die verfügbaren Räume aus ChurchTools abgerufen und angezeigt. Um die Raumbelegungen nutzen zu können, kann jetzt für jeden Raum eine Raumbelegungs-Instanz in IP-Symcon angelegt werden. Einfach die entsprechenden Räume markieren und auf hinzufügen klicken.
Die somit erstellten Raumbelegungs-Instanzen werden jeweils in Unterordnern unterhalb vom Ordner IP-Symcon angelegt. Die Unterordner tragen den gleichen Namen wie die Ortsangabe in ChurchTools, also z.B. "EG".
Pro Raum stehen in IP-Symcon sechs Variblen zur Verfügung:
Nächste Buchung Titel: Name der aktuellen bzw. nächsten BuchungNächste Buchung Start: Start-Datum und Uhrzeit der aktuellen bzw. nächsten BuchungNächste Buchung Ende: Ende-Datum und -Uhrzeit der aktuellen bzw. nächsten BuchungNächste Buchung Status: Buchungs-Status der aktuellen bzw. nächsten Buchung (bestätigtoderangefragt)Raum ist belegt: Eine Boolean-Variable, dietrueist, wenn der Raum aktuell belegt ist, basierend auf Start- und Ende-Zeitpunkt der Buchung.Heizen: Eine Boolean-Variable, dietrueist, wenn der Raum aktuell belegt ist, unter Berücksichtigung des ggf. eingestellten Heiz-Vorlaufs und des ggf. eingestellten vorzeitigen Heiz-Endes.
Diese Variablen, insbesondere Heizen, können über Ereignisse mit anderen Geräten in IP-Symcon verbunden werden, um z.B. Heizthermostate in den Räumen einzustellen.
Zusätzlich steht die Variable Dynamischer Vorlauf (Minuten) zur Verfügung, die den aktuell verwendeten Heiz-Vorlauf in Minuten anzeigt (bei aktiver intelligenter Rampe berechnet, sonst der feste Wert).
Pro Raum kann ein Heiz-Vorlauf sowie ein vorzeitiges Heiz-Ende konfiguriert werden. Ebenso kann eingestellt werden, ob auch für noch nicht bestätigte Buchungsanfragen der Raum geheizt werden soll.
Statt eines festen Heiz-Vorlaufs kann pro Raum eine intelligente, selbstlernende Rampe aktiviert werden. Der Vorlauf verschiebt sich dann automatisch nach vorn (früherer Heizstart, wenn es kalt ist bzw. der Raum noch kühl ist) oder nach hinten (späterer Heizstart, wenn es mild ist bzw. der Raum schon warm ist), sodass der Raum möglichst genau zum Buchungsstart die Zieltemperatur erreicht.
💡 Interaktiv ausprobieren:
docs/heizrampe.htmlim Browser öffnen – mit Schiebereglern für Innen-/Außen-/Zieltemperatur, die live zeigen, wie sich der Vorlauf und der Heizstart verschieben.
Berechnung:
Vorlauf [min] = (Zieltemperatur − Innentemperatur) / Heizrate(Außentemperatur)
Heizrate(Außentemperatur) = Heizrate_ref − Empfindlichkeit · (Referenz_Außen − Außentemperatur)
Das Ergebnis wird auf einen einstellbaren Bereich (minimaler/maximaler Vorlauf) begrenzt.
Selbstlernend: Bei jeder Buchung misst das Modul die tatsächliche Aufheizzeit (Zeit vom Heizstart bis zum Erreichen der Zieltemperatur) und korrigiert damit die Heizrate über einen gleitenden Mittelwert. So wird die Rampe mit jeder Nutzung genauer. Die letzten Aufheiz-Vorgänge sowie die aktuell gelernte Heizrate werden im Konfigurationsdialog unter „Lernverlauf" angezeigt.
Voraussetzungen: Innen- und Außentemperatur müssen als IP-Symcon-Variablen vorliegen (z.B. angebunden über Modbus / Technische Alternative oder ein Wettermodul) und im Einstellungsdialog ausgewählt werden.
Abwärtskompatibel: Die intelligente Rampe ist standardmäßig deaktiviert (opt-in). Wer keine Rampe benötigt, ändert nichts – der bisherige feste Heiz-Vorlauf funktioniert unverändert weiter. Auch bei aktivierter Rampe fällt das Modul automatisch auf den festen Vorlauf zurück, falls die Temperatur-Variablen fehlen oder keinen gültigen Wert liefern.
In dem Einstellungsdialog des Raumes werden die nächsten Buchungen in einer Liste angezeigt.
Die Buchungen der Räume in ChurchTools werden automatisch vom Gateway alle 10 Minuten abgerufen. Hierbei werden Buchungen für einen Tag im Voraus geladen, so dass auch Netzwerkproblem trotzdem nicht zu kalten Räumen führen.
Die Raumbelegungs-Variablen für die einzelnen Räume werden basierend auf den gespeicherten Buchungsdaten alle 10 Sekunden aktualisiert.
Neue optionale intelligente, selbstlernende Heizrampe: Der Heiz-Vorlauf wird anhand von Innen-/Außentemperatur berechnet und aus den tatsächlichen Aufheizzeiten kalibriert. Der bisherige feste Vorlauf bleibt vollständig erhalten und dient als Fallback.
Gelöschte Buchungen werden nun korrekt in Symcon berücksichtigt und die Buchung zurückgesetzt / aktualisiert.
- Initiale Version