Buchungen in den Resourcen steuert unsere Heizung (API/KNX/EIB)

Achim Fuchs

Hallo,
in unserer Gemeinde wird die gesamte Haussteuerung auf KNX/EIB umgestellt bzw. eingerichtet. Von Licht, Rollo und Heizung können wir sogar die Eingangstüren (automatische Antriebe) steuern.
Ich selbst bin Softwareentwickler und habe ein Programm erstellt, dass sich bei CT einloggt, über die API-Schnittstelle die Buchungen für den Raum holt und entsprechend die Heizung schaltet.
Auch wenn für die Räume eine Veranstaltung gebucht ist, wird die Eingangstüre aufgesperrt bzw. am Ende zugesperrt.
Für die KNX-Steuerung wird lediglich ein Framework installiert und ein KNX/IP-Router muss vorhanden sein.
Das Programm muss ständig laufen und versendet Status-Emails. In unserem Fall läuft das Programm auf einem virtuellen Windows-Server, der per OpenVPN-Verbindung sich ins interne Netz einwählt und alles steuert.

Wer also mehr wissen möchte kann mich hier anschreiben.
Gesegnete Grüße
Achim

hbuerger

Das ist ja cool. Ich weiß von einem anderem Kunden, der die Heizung mit ChurchTools steuert, aber dass ihr das noch mit dem Schließsystem verknüpft habt finde ich richtig stark.

Mich freut das immer sehr, wenn ihr eure Ideen hier im Forum vorstellt. Wir arbeiten ja gerade an der neuen API und umso mehr Endpoints wir haben um so mehr coole Dinge kann man damit machen. Ich bin so gespannt, was euch noch so einfällt.

philipptrenz

Hi @Achim-Fuchs, danke für deinen Bericht!

Sobald die REST API ausreichend Funktionalität hat werde ich das Thema wohl auch angehen. Zumindest die Kosten für unsere Parkplatzbeleuchtung könnten so relativ unkompliziert reduziert werden. Und für das Heizungssystem ist mittelfristig auch eine Umrüstung auf eine intelligente Steuerung geplant. Ich hoffe also die Arbeiten an der neuen API gehe zügig voran.

aschild

@Achim-Fuchs Hallo Achim, ich versuche gerade via "altem" API alle Buchungen für einen bestimmten Zeitraum zu ermitteln.

Im Calender Modul geht das mit getCalendarEvents(from/to in Anzahl Tagen relativ zu heute).
https://api.church.tools/class-CTChurchCalModule.html#_getCalendarEvents

Im Resourcenmodul helfen die from/to Parameter nicht, es kommen immer alle Buchungen zurück...
https://api.church.tools/class-CTChurchResourceModule.html#_getBookings

Im Code sehe ich, dass allfällige Parameter nicht an die Methode weitergegeben werden...

class CTChurchResourceModule extends CTAbstractModule {

  public function getBookings($params) {
    return getBookings();
  }
  .....
}

https://api.church.tools/function-getBookings.html hätte die Parameter, aber eben...
Hast du mir da einen Tipp?

Achim Fuchs

@aschild Hallo Aschild, über "https://xyz.church.tools/?q=churchresource/ajax&func=getBookings" bekommst du immer alle Buchungen. In meinem Programm lese ich alle diese ein und fülle und filtere diese dann. Die dokumentierten Parameter stehen noch auf "TODO" (https://api.church.tools/function-getBookings.html).
Aber alleine diese Liste ist nicht aussagekräftig.
Je nach Wiederholungsart (repeat_id), ausgeschlossenen Terminen (exceptions) bzw. eingeschlossene Termine (additions) mit den jeweiligen Wiederholungen bestimmen dann deinen Buchungstermin.
Die repeat_id Zuornung erhälst du über die "....?q=churchresource/ajax&func=getMasterData".

Ich hoffe ich konnte dir weiterhelfen.
Grüße
Achim

aschild

@Achim-Fuchs Danke für die Erklärungen.
Ja, das hatte ich befürchtet.

Hast allenfalls php code den du mir zusenden könntest? (Oder wenn es eine andere Sprache ist, dann wäre der Teil zum Auflösen der Wiederholungen + Ausnahmen interessant)
Ich würde ihn dann in diese Projekte hier integrieren und veröffentlichen.

https://github.com/vineyardkoeln/churchtools-api und https://github.com/a-schild/churchtools-pdfcalendar

uschau

@achim-fuchs
Hallo Achim,
Du schreibst, dass man je nach Wiederholungsart, ausgeschlossenen Terminen etc. die Buchungstermine bestimmen kann.
Gibt es dafür eine Funktion, die man nutzen kann oder muss man sich das selbst herleiten, wie das geht? Ich bin ziemlich irritiert, wie ich die Daten zu interpretieren habe und total verloren, wie ich die Buchungstermine für heute und morgen finde, wenn es von Serienterminen mit Exceptions in unserem Kalender nur so wimmelt.
Kannst Du mir da mit irgendeiner Vorlage helfen, wie man das programmieren kann (idealerweise in Python ;-). Vielen Dank im Voraus,
Viele Grüße
Uwe

davidschilling

@uschau Es gibt mittlerweile eine neue Api für Buchungen die schon alle Serientermine ausgerechnet zurück liefert. (/api/bookings) Details findest du in der Api Dokumentation unter /api.

Damit sollte das deutlich einfacher gehen.

Achim Fuchs

@uschau Von der Grundfunktion basiert meine Programmierung auf die alte API. Hier habe ich die Termine, die ausgeschossen wurden, dann wieder entfernt. Wie genau ich das mache, muss ich erst im Code nachsehen. Wenn du hier diese Info brauchst, dann melde dich nochmal. Andernfalls verwende doch die neue API :-).

uschau

@davidschilling
Hallo David, Danke für Deine schnelle Reaktion. Ich bin leider etwas verwirrt, weil ich dachte, ich nutze schon die neue API.
Mein Aufruf sieht wie folgt aus:
efg-blabla.church.tools/?q=churchresource/ajax&func=getBookings&login_token=Rb1....K5I&from=0&to=1&resource_id=3&status_id_in="0,2"
Bin ich damit noch auf dem alten Strang unterwegs?
Wie komme ich auf die neuen API's? Gibt es da eine andere URL, die man aufrufen kann?
Sorry, wenn die Rückfrage etwas blöd klingt, aber ich starte gerade erst mit dem Thema.
VG
Uwe

jziegeler

@uschau ja, das ist die alte API.

die Dokumentation für die neue REST-API findest du unter https://meineGemeinde.church.tools/api

uschau

@jziegeler Vielen Dank! Der Hinweis hat schon mal geholfen.
Ich bekomme nun die Wiederholungstermine unter "calculated" ausgewiesen.
Allerdings glaube ich, werden Ausnahmen nicht korrekt berücksichtigt.
Auf der Weboberfläche erscheint für den heutigen Tag keine Reservierung, da ich die Serie für den heutigen Abend unterbrochen habe, aber in der API-Antwort tauchen gleich 2 Einträge zum heutigen Datum auf. Ist das ein Fehler oder muss ich da etwas besonderes beachten?
Wenn es hilft, kann ich auch gerne den Effekt direkt in unserer Instanz demonstrieren. Anbei ein paar Screenshots, das JSON-Ergebnis könnte ich noch per email nachsenden, falls gewünscht.
Bildschirmfoto 2022-06-22 um 22.36.26.png

davidschilling

@uschau wenn du denkst hier liegt ein Bug vor, dann melde dich bitte bei support@churchtools.de und wir schauen uns das an. Wenn das wirklich ein Bug ist wird der gefixt. Am besten schreibst du uns gleich dass wir Zugriff auf die DB bekommen, dann können wir uns das gleich bei euch anschauen.

Bernd-Stami

Hallo,
ich habe mit großem Interesse die Beiträge hier durchgelesen.

In unserer Stadtmission hat sich ein Arbeitskreis gebildet, wie Energie gespart werden kann. Ich selbst habe seit Jahren in meiner privaten Wohnung sehr gute Erfahrungen mit der Thermostat-Steuerung der Fritzbox gemacht.

Mir ist klar, daß für die Thermostat-Steuerung in unserer Gemeinde (etwa 20 Heizkörper - verteilt auf 2 Stockwerke und verschiedene Räume - eine "professionellere" Lösung benötigt wird.

Da wir in der Gemeinde noch keine Steuerung haben, könnt ihr hier eine Empfehlung für Homatik-Geräte posten - Zentrale der Homatic und Themostate? Bzw. wo man als "Neuling" anfangen kann zu schauen?

mhuber

@bernd-stami Wir haben gerade ein ChurchTools-Plugin für IP-Symcon (https://www.symcon.de/) in Arbeit.

IP-Symcon kann sehr viele Steuerungen und Netzwerkprotokolle (an-)sprechen und eignet sich daher als "Überbau" über neuen und alten Steuerungen/Bussystemen.

Das ChurchTools-Plugin für IP-Symcon kann Raumbelegungen aus ChurchTools abrufen und direkt oder auch mit einem einstellbaren Heiz-Vorlauf als Variablen in IP-Symcom zur Verfügung stellen. Basierend auf diesen Variablen können dann z.B. Heizungsventile gesteuert werden.

Wenn daran Interesse besteht, kann ich gerne einen Test-Link für das Plugin schicken. Eine offizielle Veröffentlichung des Plugins ist für Ende September geplant.

Disclaimer: IP-Symcon ist eine kostenpflichtige Software, die auf einem PC oder Raspberry PI installiert wird. Wir (ChurchTools) sind weder Partner von IP-Symcon, noch soll das hier Werbung für IP-Symcon sein, wir haben nur einfach mal mit IP-Symcon angefangen. Wir denken auch über weitere Plugins für andere Automations-Systeme wie z.B. OpenHab (https://www.openhab.org/) nach, da ist aber bis jetzt noch nichts umgesetzt.

Scyten

@mhuber openhab-Unterstützung würde ich sehr befürworten! Gerade, wenn Ihr schon kommerzielle Software unterstützt sollte auch weitverbreitete OpenSource Software unterstützt werden.

hbuerger

@scyten Danke für dein Feedback. Nur als kleine Einordnung: Das IP-Symco Plugin wurde von @mhuber programmiert u.A. um zu zeigen was die REST API nun alles kann. Das Plugin ist daher ein erster Showcase für eine Anbindung, die weitverbreitet ist. Der Wunsch nach einer OpenHab Unterstützung ist sicherlich nachvollziehbar, aber von uns aktuell nicht stemmbar.

Die REST API gibt aber alle Informationen her und die Community darf sich daran gerne beteiligen. Vielleicht findet sich jmd hier, der schon Erfahrung mit OpenHab hat und hier ggf. ein Plugin programmieren möchte.

mhuber

Das IP-Symcon-Plugin ist jetzt im IP-Symcon-Store verfügbar. Hier habe ich noch etwas mehr darüber geschrieben: https://forum.church.tools/topic/8870/ip-symcon-plugin-für-heizungssteuerung-via-churchtools

Achim Bloh

Hallo Achim, wir haben seit Mitte des Jahres auch auf CT umgestellt.
Aktuell fahren wir unsere Heizung mit einer FHEM Anwedung.
Ich weiß nicht in wie weit dir das bekannt ist.
In FHEM nutzen wir eine Kalenderfunktion welche aus einem Google Kalender die Infos holt wann Räume genutzt werden.
Diese Basisdaten würde ich gerne direkt aus der CT Ressourcenverewaltung holen.
Können wir hierüber mal ins Gespräch kommen.

Viele Grüße
auch ein Achim

DiedrichsHW

Der www.Heizkalender.de steuert mit ChurchTools die Heizköper.
KNX gut. Da kenne ich mich nicht aus.
Lukas und ich haben eine derartige Anwendung für Homematic entwickelt und geben sie kostenlos weiter. (KNX ist dabei nicht nötig)