Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- hardware:channels:heating_control:gastherme_buderus [2025/11/23 18:37] – Link angepasst trabant
+++ hardware:channels:heating_control:gastherme_buderus [2025/11/29 22:03] (aktuell) – trabant
@@ Zeile 1: / Zeile 1: @@
 ===== Gastherme Buderus/Bosch/Junkers mit Heatronic 3=====
-Hier geht es um die Anbindung zu einer Gastherme mit ''Heatronic 3'', diese gibt es sowohl unter dem Namen Buderus als auch Junkers. Die Regelungen sind sehr ähnlich, da ja beide aus dem Hause Bosch kommen.
+Hier geht es um die Anbindung einer Gastherme mit //Heatronic 3//, diese gibt es unter den Namen //Buderus//, //Junkers// sowie seit wenigen Jahren auch //Bosch// selbst. Die Regelungen sind sehr ähnlich, da  alle aus dem Hause Bosch kommen.
-Nicht passend ist diese Lösung für ältere Thermen mit ''Heatronic 2'', die jedoch auch mit einem busfähigen Regler ausgestattet werden können. Siehe hierzu [[gastherme_junkers_can_bus|Junkers Gastherme mit Heatronic 2 und Can-Bus-Regler]].
+Nicht passend ist diese Lösung für ältere Thermen mit //Heatronic 2//, die jedoch auch mit einem busfähigen Regler ausgestattet werden können. Siehe hierzu [[gastherme_junkers_can_bus|Junkers Gastherme mit Heatronic 2 und Can-Bus-Regler]].
-Im Mikrocontroller Forum [[https://www.mikrocontroller.net/topic/317004]] wurden verschiedene Adapter für den Anschluss eines Heatronic 3 Busses an einen Raspberry Pi entwickelt. Mit etwas Glück bekommt man auf Nachfrage ein bereits bestücktes Adapter-Board. Dieses wird über eine zweiadrige Leitung mit der Therme oder auch dem Regler verbunden.
+Bei den Junkers-Geräten wurde der HT3-Bus ab 2010 eingeführt, bei Buderus gibt es ihn schon etwa 10 Jahre länger unter dem Namen EMS.
+Im Mikrocontroller-Forum [[https://www.mikrocontroller.net/topic/317004]] wurden verschiedene Adapter für den Anschluss eines //Heatronic 3// Busses an einen Raspberry Pi entwickelt. Mit etwas Glück bekommt man auf Nachfrage ein bereits bestücktes Adapter-Board. Dieses wird über eine zweiadrige verpolungssichere Leitung mit der Therme oder auch dem Regler verbunden.
 Passend zu diesen Boards gibt es eine eigene Software, die die Dekodierung übernimmt: [[https://github.com/norberts1/hometop_HT3.git]], auch dazu gibt es einen Thread im genannten Forum [[https://mikrocontroller.net/topic/324673]]. Diese Software ist wirklich herstellerspezifisch und würde bei Geräten anderer Hersteller mit EMS-Bus nicht so einfach funktionieren.
-Jetzt geht es an die Anbindung an der Volkszähler: Im Forum findet man auch ein Skript, welches die Daten aus der Sqlite Datenbank der HT3 Software in die Volkszähler-Datenbank überträgt [[https://www.mikrocontroller.net/topic/317004?page=single#4400665]]
+Die //hometop-HT3// Software kann die dekodierten Daten wahlweise als RRD Dateien speichern und damit einen eigenen Webserver füttern, oder aber auch als Sqlite Datenbank. Für das Logging in den [[:volkszaehler|Volkszähler]] wählen wir die zweite Methode. In der Konfigurationsdatei ''HT3/sw/config/HT3_db_cfg.xml'' setzen wir in der Sektion ''<sql-db>'' den Parameter ''<enable>'' auf ''on'' und setzen die automatische Löschung von alten Daten (''<autoerase_olddata>'') auf einen Tag (''1''). Darunter kann unter ''<rrdtool-db>'' die Erstellung der RRD Daten ausgeschaltet werden (''off'', wer die RRD Daten gerne haben möchte kann diese auch parallel erstellen lassen).
-Dieses Perl Skript löscht die vorhandenen Daten aus den betreffenden Volkszähler-Kanälen und überträgt die  Werte aus der obengenannten SQLite DB in einem Rutsch.
+Diese Anpassungen sollten am Besten vor dem ersten Lauf des Programmes ''create_databases.py'' vergenommen werden, Sind die Datenbanken im Rahmen des Installationsprozesses von //hometop-HT3// bereits erstellt worden, und es gibt keine Sqlite Datei unter ''HT3/sw/var/databases/HT3_db.sqlite'', dann lässt man ''create_databases.py'' noch einmal laufen.
-Alternativ kann man das Skript auch ein bisschen anpassen, so dass es im Hintergrund läuft und in einem festgesetzten Abstand die aktuellen Daten abfragt und den VZ auf dem aktuellen Stand hält. Das sieht dann in etwa so aus:
+Für die Anbindung an den Volkszähler ist es wichtig, dass die Dienste ''ht_proxy.py'' und ''ht_collgate.py'' laufen und die Sqlite Datenbank ''HT3_db.sqlite'' auch aktualisiert wird.
+Mit dem folgenden Skript können dann die Daten in einem festgesetzten Abstand (voreingestellt sind 10s) abgefragt und via [[software:middleware:einrichtung|Middleware]] an die [[software:middleware:datenbank|Volkszähler-DB]] übermittelt werden:
+<code python ht3logger.py>
+#!/usr/bin/python3
-<code perl ht3logger.pl>
+import sqlite3
-#!/usr/bin/perl
+from requests import post
+from time import ctime,sleep
-print "Starting up ht3logger on $date";
+print("Starting up ht3logger V1 on "+ctime())
-use DBI;
+channel_list = {
+        'ch_V_spare_1'     : '80089ae0-fa81-11e9-bdc6-b99d5fa0fe8b',
+        'T_vorlauf_soll'   : 'af1863e0-fa81-11e9-8d30-337b7499db8e',
+        'T_vorlauf_ist'    : 'cbf99f10-fa81-11e9-9709-d55e7ad0883e',
+        'T_mischer'        : '521a0ca0-fa8d-11e9-970f-752aababd342',
+        'V_heizungs_pumpe' : 'a5958bf0-fa8f-11e9-bf34-4f7c2163b201',
+        'V_brenner_flamme' : '5ec31d30-fa90-11e9-98b7-3b9f4a33ba29',
+        'V_leistung'       : '81f3ed90-7f7b-11ed-90c6-b747fd43b61f',
+        'C_brenner_gesamt' : '9bbd1c20-a8ee-11e5-82ab-079b3d8ffc8e'
+}
+while True:
+	try:
+		db = sqlite3.connect("/home/pi/HT3/sw/var/databases/HT3_db.sqlite")
+		db.row_factory = sqlite3.Row
+		cursor = db.execute("SELECT * FROM heizgeraet order by utc desc limit 1")
+	except:
+		print("Error accessing Sqlite database.")
+		raise SystemExit(2)
+	for dbvalue in cursor:
+		timestamp = int(dbvalue['UTC'] * 1000)
+		for key,uuid in channel_list.items():
+			try:
+				#print(key, timestamp, uuid, dbvalue[key])
+				post('http://localhost/middleware/data.json', data='uuid':uuid,'ts':timestamp,'value':dbvalue[key]})
+			except:
+				print("Couldn't post to VZ Middleware.")
+	db.close()
+	sleep(10)
+</code>
-$dsn = "DBI:mysql:database=volkszaehler;host=localhost";
+<note important>Die ''channel_list'' im Skript muss manuell angepasst werden. An erster Stelle stehen die Spaltennamen aus der //hometop// Sqlite-DB, an zweiter Stelle die ''UUID'' eines bestehenden VZ-Kanals. Der Name (z.B. //T_vorlauf_ist//, kann, muss aber nicht mit der Benennung des entsprechenden [[software:middleware:einrichtung|Kanals]] im VZ übereinstimmen.</note>
-$dbh2 = DBI->connect($dsn, "vz", "*secure*", { RaiseError => 1, AutoCommit => 1});
+Die genannten Werte sind nur Beispiele, ein Blick in die SQLite DB genügt um herauszufinden, was man selbst gerne hätte. In diesem Beispiel einer Kombitherme findet man unter ''T_mischer'' im übrigen die DL-Warmwassertemperatur.
-while (1) {
+<note tip>In der Sqlite Datenbank gibt es neben der Tabelle ''heizgeraet'' noch weitere, für den Fall dass separate Heizkreise, Solarthermie oder ein Warmwasserspeicher existieren. Möchte man von weiteren Tabellen Daten abrufen, lässt sich das Skript einfach replizieren und entsprechend anpassen.</note>
-        #print `date`
-        $dbh = DBI->connect( "dbi:SQLite:/var/HT3/sw/var/databases/HT3_db.sqlite" ) || die "Cannot connect: $DBI::errstr";
-        my $sth = $dbh->prepare("select * from heizgeraet order by utc desc limit 1;");
+Wenn man das Skript dann auf dem VZ-System abgelegt hat, z.B. unter ''/home/pi/bin/'', kann man es dann auch automatisch mittels //systemd-service// starten, dazu folgende Datei nach ''/etc/systemd/system/'' kopieren:
+<code text ht3logger.service>
+[Unit]
+Description=Logging data from hometop HT3 database to VZ Middleware
+After=ht_proxy.service ht_collgate.service
-        $sth->execute();
+[Service]
+ExecStart=/home/pi/bin/ht3logger.py
+ExecReload=
+StandardOutput=syslog
+Restart=always
-        $ref = $sth->fetchrow_hashref();
+[Install]
-        #print $ref;
+WantedBy=multi-user.target
-        $utc = $ref->{'UTC'}*1000;
-        $sql[$z++] = "(1,  $utc , ". $ref->{'T_ruecklauf'}."),\n";
-        $sql[$z++] = "(2,  $utc , ". $ref->{'T_vorlauf_soll'}."),\n";
-        $sql[$z++] = "(3,  $utc , ". $ref->{'T_vorlauf_ist'}."),\n";
-        $sql[$z++] = "(4,  $utc , ". $ref->{'T_mischer'}."),\n";
-        $sql[$z++] = "(5,  $utc , ". $ref->{'V_heizungs_pumpe'}."),\n";
-        $sql[$z++] = "(6,  $utc , ". $ref->{'V_brenner_flamme'}."),\n";
-        $sql[$z++] = "(11,  $utc , ". $ref->{'V_leistung'}."),\n";
-        $sql[$z++] = "(18,  $utc , ". $ref->{'C_brenner_gesamt'}."),\n";
-        $sql2 = "";
-        $z=0;
-        foreach my $do (@sql)   {
-                $sql2 .= $do;
-                $z++;
-                $sql2 = "INSERT INTO `data` (`channel_id`, `timestamp`, `value`) VALUES ".$sql2;
-                chop($sql2);
-                chop($sql2);
-                #print $sql2;
-                print $dbh2->do($sql2) if ($utc ne $utcold);
-                $sql2 = "";
-                $z=0;
-                }
-        $utcold = $utc;
-        $sth->finish();
-        $dbh->disconnect;
-        sleep 10;
-}
 </code>
+<note tip>Bitte beachten dass der Pfad im ExecStart Statement auch dem tatsächlichen Pfad des Programmes entspricht.
+</note>
+Dann sollte sich der Dienst per ''systemctl enable ht3logger.service'' und ''systemctl start ht3logger.service'' aktivieren lassen.
-Die genannten Werte sind nur Beispiele, ein Blick in die SQLite DB genügt um herauszufinden, was man selbst gerne hätte. In diesem Beispiel einer Kombitherme findet man unter T_mischer im übrigen die DL-Warmwassertemperatur.
+Last not least ein Bild des [[software:frontends:frontend|Frontends]], was den Erfolg und auch die verwendeten [[software:middleware:einrichtung|Kanaltypen]] zeigt:
-<note important>Bitte beachten - das Skript nutzt für die Volkszähler-DB noch nicht die ''UUIDs'', sondern die jeweilige interne ''channel_id''.</note>
-So in etwa sieht dann der Erfolg im Frondend aus:
-{{:hardware:channels:volkszaehler.org.png|}}
+{{ :hardware:channels:heating_control:can-vz.png | Frontend}}
+<note tip>In diesem Fall muss für den Kanaltyp der Brennerstarts nicht der "Allgemeine Impulszähler", sondern "Betriebsstundenzähler (Zählerstand)" verwendet werden. Der Grund hierfür ist, dass vom Skript nicht die einzelnen Starts geloggt werden, sondern die Therme selbst die Starts aufaddiert und auf den Bus schreibt.</note>