{"type":"doc","content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"Eine kleine Warnung vorweg:","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Da sich mit Hilfe der hier beschriebenen Informationen jegliche Parameter der Heliotherm Wärmepumpe verändern lassen, besteht die Möglichkeit sich durch unsachgemäßes bzw. unbedachtes Verhalten die Wärmepumpe und/oder zugehörige Komponenten zu beschädigen.","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Der Autor übernimmt daher keinerlei Garantie oder Gewährleistung in Bezug auf Richtigkeit oder Funktionalität und übernimmt keinerlei Haftung für Schäden, die durch diese Informationen hier verursacht werden!","type":"text","marks":[{"type":"em"}]}]}]},{"type":"paragraph","content":[{"text":"Das folgende Dokument beschreibt in einer einfachen Schritt für Schritt Anleitung, wie mit Hilfe der ","type":"text"},{"text":"Open Source Applikation ","type":"text"},{"text":"HtREST","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/dstrigl/HtREST"}}]},{"text":" ","type":"text"},{"text":"eine ","type":"text"},{"text":"Heliotherm","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.heliotherm.com/"}}]},{"text":" Wärmepumpe an eine ","type":"text"},{"text":"Loxone","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.loxone.com/dede/"}}]},{"text":" ","type":"text"},{"text":"Steuerung angebunden werden kann.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Benötigte Hardware & Anbindung","type":"text"}]},{"type":"paragraph","content":[{"text":"Benötigt wird für die Kopplung nur ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ein ","type":"text"},{"text":"Raspberry Pi","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.raspberrypi.org/"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"mit Netzwerkanbindung (kabelgebunden oder per WLAN spielt dabei keine Rolle) und","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"serieller Verbindung zur Heliotherm Wärmepumpe, z.B. mittels USB auf RS232 Adapter.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Für die serielle Verbindung zur Regeleinheit der Wärmepumpe (D-Sub Stecker -X26 \"Modem COM\") wird ein ausgekreuztes 9-poliges RS232-Kabel (","type":"text"},{"text":"Nullmodemkabel","type":"text","marks":[{"type":"link","attrs":{"href":"https://de.wikipedia.org/wiki/Nullmodem-Kabel"}}]},{"text":") benötigt.","type":"text"}]},{"type":"paragraph","content":[{"text":"Einen möglichen Aufbau zeigen z.B. die folgenden beiden Fotos:","type":"text","marks":[{"type":"underline"}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":26.0},"content":[{"type":"media","attrs":{"width":4160,"id":"27cfc739-78e3-40f0-9691-edbeed1f758a","collection":"contentId-1583089663","type":"file","height":3120}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":26.0},"content":[{"type":"media","attrs":{"width":4160,"id":"b91a7b83-cbf6-4365-b8d4-5e5c52c83326","collection":"contentId-1583089663","type":"file","height":3120}}]},{"type":"paragraph","content":[{"text":"Der Aufbau besteht hier aus einem","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Raspberry Pi Zero","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.raspberrypi.org/products/raspberry-pi-zero/"}}]},{"text":" mit","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Zero4U 4-Port USB Hub","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.uugear.com/product/zero4u/"}}]},{"text":" an dem","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ein USB auf RS232 Adapter für die serielle Verbindung zur Wärmepumpe und","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ein USB auf RJ45 Ethernet Netzwerkadapter für die Anbindung ans Heimnetz","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"angeschlossen ist.","type":"text"}]},{"type":"paragraph","content":[{"text":"Das ganze montiert auf dem noch freien Platz auf der Hutschiene in der Wärmepumpe.","type":"text"}]},{"type":"paragraph","content":[{"text":"Natürlich ist es auch möglich den Raspberry Pi außerhalb der Wärmepumpe zu platzieren und nur das serielle RS232-Kabel in die Wärmepumpe zu führen.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Vorbereitung","type":"text"}]},{"type":"paragraph","content":[{"text":"Als Betriebssystem am Raspberry Pi reicht das ","type":"text"},{"text":"Raspbian Buster Lite","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.raspberrypi.org/downloads/raspbian/"}}]},{"text":" (Minimal image based on Debian Buster) ohne Desktop-Unterstützung, rein nur mit Konsole.","type":"text"}]},{"type":"paragraph","content":[{"text":"Für den Zugriff auf den Raspberry Pi wird weiters ein ","type":"text"},{"text":"ssh-Zugang","type":"text","marks":[{"type":"link","attrs":{"href":"https://de.wikipedia.org/wiki/Secure_Shell"}}]},{"text":" benötigt.","type":"text"}]},{"type":"paragraph","content":[{"text":"Wie dieser aktiviert werden kann ist z.B. hier beschrieben:","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"https://www.raspberrypi.org/documentation/remote-access/ssh/","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.raspberrypi.org/documentation/remote-access/ssh/"}}]}]},{"type":"paragraph","content":[{"text":"Zu empfehlen ist es, dem Raspberry Pi auch gleich eine statische IP-Adresse zu spendieren und ihm einen geeigneten Hostnamen zuzuweisen.","type":"text"}]},{"type":"paragraph","content":[{"text":"Anleitungen dazu finden sich zur genüge im Netz:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"https://www.elektronik-kompendium.de/sites/raspberry-pi/1912151.htm","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.elektronik-kompendium.de/sites/raspberry-pi/1912151.htm"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"https://www.elektronik-kompendium.de/sites/raspberry-pi/2007021.htm","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.elektronik-kompendium.de/sites/raspberry-pi/2007021.htm"}}]}]}]}]},{"type":"paragraph","content":[{"text":"Des Weiteren sollte man dann auch gleich kontrollieren, ob Datum und Uhrzeit stimmt oder noch besser die automatische Synchronisierung per NTP einrichten.","type":"text"}]},{"type":"paragraph","content":[{"text":"Zu beachten ist hier, dass man die richtige Zeitzone verwendet.","type":"text"}]},{"type":"paragraph","content":[{"text":"Eine ausführliche Beschreibung dazu findet man z.B. hier:","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"https://raspberrytips.com/time-sync-raspberry-pi/","type":"text","marks":[{"type":"link","attrs":{"href":"https://raspberrytips.com/time-sync-raspberry-pi/"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Installation & Test","type":"text"}]},{"type":"paragraph","content":[{"text":"Sind diese Grundvoraussetzungen erfüllt, kann auch gleich mit der eigentlichen Installation der benötigten Softwarepakete begonnen werden.","type":"text"}]},{"type":"paragraph","content":[{"text":"Zuerst verbinden wir uns mittels ssh mit dem Raspberry Pi und führen eine Aktualisierung aller Paketquellen und der installierten Pakete durch:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"pi@htrest:~ $ sudo apt-get update && sudo apt-get upgrade -y","type":"text"}]},{"type":"paragraph","content":[{"text":"Anschließend installieren wir noch das benötigte Paket zum Erstellen von ","type":"text"},{"text":"virtual environments","type":"text","marks":[{"type":"link","attrs":{"href":"https://realpython.com/python-virtual-environments-a-primer/"}},{"type":"em"}]},{"text":" unter Python:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"pi@htrest:~ $ sudo apt-get install python3-venv -y","type":"text"}]},{"type":"paragraph","content":[{"text":"Somit können wir die benötigte HtREST Applikation in einer eigenen, isolierten Umgebung installieren und bewahren uns somit vor möglichen Versionskonflikten installierter Python Pakete.","type":"text"}]},{"type":"paragraph","content":[{"text":"Python 3.7 oder neuer sollte bereits installiert sein, was ganz einfach mittels folgendem Aufruf überprüft werden kann:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"pi@htrest:~ $ python3 -V\nPython 3.7.3","type":"text"}]},{"type":"paragraph","content":[{"text":"Danach erstellen wir uns die bereits oben erwähnte virtuelle Arbeitsumgebung (virtual environment) für die HtREST Applikation:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"pi@htrest:~ $ mkdir /home/pi/venv\npi@htrest:~ $ python3 -m venv /home/pi/venv/htrest\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Diese virtuelle Arbeitsumgebung muss dann noch mittels","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"pi@htrest:~ $ source /home/pi/venv/htrest/bin/activate","type":"text"}]},{"type":"paragraph","content":[{"text":"aktiviert werden.","type":"text"}]},{"type":"paragraph","content":[{"text":"Ob eine virtuelle Arbeitsumgebung gerade aktiv ist, lässt sich sehr schön daran erkennen, dass der Name der aktiven (virtuellen) Arbeitsumgebung in Klammern dem Kommandozeilen-Prompt vorangestellt wird:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"(htrest) pi@htrest:~ $","type":"text"}]},{"type":"paragraph","content":[{"text":"Verlassen lässt sich die virtuelle Arbeitsumgebung einfach mittels:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"(htrest) pi@htrest:~ $ deactivate","type":"text"}]},{"type":"paragraph","content":[{"text":"Zum Installieren der HtREST Applikation innerhalb der virtuelle Arbeitsumgebung muss diese aber natürlich aktiviert sein.","type":"text"}]},{"type":"paragraph","content":[{"text":"Zur Installation selber reicht dann der folgende Aufruf:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"(htrest) pi@htrest:~ $ pip install htrest","type":"text"}]},{"type":"paragraph","content":[{"text":"Hat das alles ohne Probleme funktioniert, kann die HtREST Applikation auch schon mal testhalber händisch gestartet werden:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"(htrest) pi@htrest:~ $ htrest -d /dev/ttyUSB0 -b 115200 --host 192.168.11.99 --bool-as-int --read-only","type":"text"}]},{"type":"paragraph","content":[{"text":"Hier muss natürlich der richtige Pfad des seriellen Device und die IP-Adresse des Raspberry Pi auf dem die Applikation läuft entsprechend angepasst werden.","type":"text"}]},{"type":"paragraph","content":[{"text":"Die USB auf RS232 Adapter sind dabei meist unter /dev/ttyUSB0, /dev/ttyUSB1, usw. zu finden, einige wenige Typen allerdings auch unter /dev/ttyACM0, /dev/ttyACM1, usw.:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"(htrest) pi@htrest:~ $ ls /dev/\nautofs full loop3 mmcblk0p2 ram13 raw tty10 tty21 tty32 tty43 tty54 tty8 vcs vcsa5 video11\nblock fuse loop4 mqueue ram14 rfkill tty11 tty22 tty33 tty44 tty55 tty9 vcs1 vcsa6 video12\nbtrfs-control gpiochip0 loop5 net ram15 serial tty12 tty23 tty34 tty45 tty56 ttyAMA0 vcs2 vcsm-cma video13\nbus gpiomem loop6 null ram2 serial1 tty13 tty24 tty35 tty46 tty57 ttyprintk vcs3 vcsu video14\ncachefiles hwrng loop7 ppp ram3 shm tty14 tty25 tty36 tty47 tty58 ttyUSB0 vcs4 vcsu1 video15\nchar initctl loop-control ptmx ram4 snd tty15 tty26 tty37 tty48 tty59 uhid vcs5 vcsu2 video16\nconsole input mapper pts ram5 stderr tty16 tty27 tty38 tty49 tty6 uinput vcs6 vcsu3 video18\ncuse kmsg media0 ram0 ram6 stdin tty17 tty28 tty39 tty5 tty60 urandom vcsa vcsu4 watchdog\ndisk log media1 ram1 ram7 stdout tty18 tty29 tty4 tty50 tty61 v4l vcsa1 vcsu5 watchdog0\ndma_heap loop0 mem ram10 ram8 tty tty19 tty3 tty40 tty51 tty62 vchiq vcsa2 vcsu6 zero\nfb0 loop1 mmcblk0 ram11 ram9 tty0 tty2 tty30 tty41 tty52 tty63 vcio vcsa3 vhci\nfd loop2 mmcblk0p1 ram12 random tty1 tty20 tty31 tty42 tty53 tty7 vc-mem vcsa4 video10","type":"text"}]},{"type":"paragraph","content":[{"text":"Sollte ein anderer Port als der standardmäßig verwendete Port 8777 verwendet werden, so muss dieser natürlich auch noch mittels dem Argument \"--port\" angegeben werden.","type":"text"}]},{"type":"paragraph","content":[{"text":"Zu beachten ist auch, dass die verwendete Baudrate der seriellen Verbindung mit der Einstellung auf der Wärmepumpe übereinstimmen muss.","type":"text"}]},{"type":"paragraph","content":[{"text":"Diese lässt sich im Menü der Wärmepumpe unter \"Modem\", \"Baud Rate\" ändern.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Bei einigen der älteren Wärmepumpen scheint es diesen Menüpunkt nicht zu geben.","type":"text"}]},{"type":"paragraph","content":[{"text":"Anscheinend lässt sich hier die Baudrate der seriellen Verbindung nicht verändern, sondern läuft fix mit 19200.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Die Einstellung \"Verbindungsart\" unter \"Modem\" muss dabei auf \"Direkt\" gesetzt sein.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":26.0},"content":[{"type":"media","attrs":{"width":2592,"id":"9f91b99f-6383-4c78-a8ce-7a02c0a9ccd4","collection":"contentId-1583089663","type":"file","height":1944}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":26.0},"content":[{"type":"media","attrs":{"width":2592,"id":"d1834acf-bc73-4637-8cf2-2df84e8d2c24","collection":"contentId-1583089663","type":"file","height":1944}}]},{"type":"paragraph","content":[{"text":"Diese Einstellungen lassen sich allerdings nicht als normaler Benutzer vornehmen, weshalb man sich vorher unter dem Menüpunkt \"Benutzerebene\" als \"Fachmann\" anmelden muss.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":26.0},"content":[{"type":"media","attrs":{"width":2592,"id":"9a13581e-c284-4f11-b5ac-cf5d85ba688c","collection":"contentId-1583089663","type":"file","height":1944}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":26.0},"content":[{"type":"media","attrs":{"width":2592,"id":"ec883f87-1419-4450-ad58-b263953ce04e","collection":"contentId-1583089663","type":"file","height":1944}}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Der Benutzer \"Fachmann\" wird dabei nach einer kurzen Zeit der Inaktivität wieder automatisch ausgeloggt.","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"Auch hier soll nochmals angemerkt werden, dass man als eingeloggter \"Fachmann\" alle möglichen Einstellungen der Wärmepumpe verändern kann und sich somit auch die Wärmepumpe und/oder zugehörige Komponenten beschädigen kann.","type":"text"}]},{"type":"paragraph","content":[{"text":"Deshalb ist hier besondere Vorsicht geboten!","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Die HtREST Applikation besitzt noch weitere Aufrufargumente, welche mit dem folgenden Kommando aufgelistet werden können:","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"(htrest) pi@htrest:~ $ /home/pi/venv/htrest/bin/htrest --help","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Des Weiteren sind diese auch auf der ","type":"text"},{"text":"GitHub-Seite des Projekts","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/dstrigl/HtREST"}}]},{"text":" unter dem Abschnitt \"Usage\" zu finden.","type":"text"}]},{"type":"paragraph","content":[{"text":"Lässt sich die HtREST Applikation wie hier ohne Fehler starten,","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"(htrest) pi@htrest:~ $ htrest -d /dev/ttyUSB0 -b 115200 --host 192.168.11.99 --port 8777 --read-only\nHTHEATPUMP: load parameter definitions from: /home/pi/venv/htrest/lib/python3.7/site-packages/htheatpump-1.2.4-py3.7.egg/htheatpump/htparams.csv\nStart Heliotherm heat pump REST API server v0.1.8.\nNamespace(baudrate=115200, bool_as_int=False, debug=False, device='/dev/ttyUSB0', host='192.168.11.99', logging_config='/home/pi/prog/HtREST/htrest/logging.conf', no_param_verification=False, port=8777, read_only=True, user='')\n2020-04-18 12:36:15,834 INFO [htrest.app] open connection to heat pump ()\n2020-04-18 12:36:15,873 INFO [htrest.app] successfully connected to heat pump #123456\n2020-04-18 12:36:15,904 INFO [htrest.app] software version = 3.0.20 (273)\n2020-04-18 12:36:15,950 INFO [htrest.app] *** created Flask app with config \nMap([ api.faultlist_fault_list_size>,\n api.faultlist_last_fault>,\n api.specs>,\n api.faultlist_fault_list>,\n api.fastquery_fast_query_list>,\n api.datetime_date_time>,\n api.timeprog_time_progs>,\n api.device_device>,\n api.param_param_list>,\n api.doc>,\n api.root>,\n ' (OPTIONS, HEAD, GET) -> api.faultlist_fault_entry>,\n ' (OPTIONS, HEAD, GET) -> api.fastquery_fast_query>,\n //' (PUT, OPTIONS, HEAD, GET) -> api.timeprog_time_prog_entry>,\n ' (PUT, OPTIONS, HEAD, GET) -> api.timeprog_time_prog>,\n ' (PUT, OPTIONS, HEAD, GET) -> api.param_param>,\n ' (OPTIONS, HEAD, GET) -> restx_doc.static>,\n ' (OPTIONS, HEAD, GET) -> static>])\n * Serving Flask app \"htrest.app\" (lazy loading)\n * Environment: production\n WARNING: This is a development server. Do not use it in a production deployment.\n Use a production WSGI server instead.\n * Debug mode: off\n...","type":"text"}]},{"type":"paragraph","content":[{"text":"kann auch schon mittels Webbrowser auf die ","type":"text"},{"text":"Swagger UI","type":"text","marks":[{"type":"link","attrs":{"href":"https://swagger.io/tools/swagger-ui/"}}]},{"text":" Seite der HtREST Applikation unter","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"http://192.168.11.99:8777/api/v1/","type":"text","marks":[{"type":"link","attrs":{"href":"http://192.168.11.99:8777/api/v1/"}}]}]},{"type":"paragraph","content":[{"text":"gewechselt und die einzelnen Funktionalitäten getestet werden.","type":"text"}]},{"type":"paragraph","content":[{"text":"Natürlich ist auch hier die IP-Adresse (und Port-Nummer) wieder entsprechend anzupassen.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":29.0},"content":[{"type":"media","attrs":{"width":1274,"id":"681ae7ef-2b2f-46b7-ad3c-18785a952c61","collection":"contentId-1583089663","type":"file","height":841}}]},{"type":"paragraph","content":[{"text":"Innerhalb dieser Swagger UI Seite lassen sich alle unterstützten Kommandos interaktiv ausprobieren und testen.","type":"text"}]},{"type":"paragraph","content":[{"text":"Eine detaillierte Beschreibung aller Kommandos findet sich wieder auf der ","type":"text"},{"text":"GitHub-Seite ","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/dstrigl/HtREST"}}]},{"text":"des Projekts","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/dstrigl/HtREST"}}]},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Dem ein oder anderen ist vielleicht schon aufgefallen, dass die HtREST Applikation im obigen Statement mit dem Argument \"--read-only\" aufgerufen wurde.","type":"text"}]},{"type":"paragraph","content":[{"text":"Dies dient zum Schutz, damit man sich beim Herumspielen und Testen nicht irgendwelche Parameter auf der Wärmepumpe verstellt.","type":"text"}]},{"type":"paragraph","content":[{"text":"Die HtREST Applikation greift bei Angabe dieses Arguments nur lesend auf die Wärmepumpe zu und ignoriert jegliche schreibenden Kommandos.","type":"text"}]},{"type":"paragraph","content":[{"text":"Ist ein schreibender Zugriff dann allerdings gewünscht, um z.B. die Betriebsart über die Loxone Steuerung zu verändern, muss dieses Argument natürlich entfernt werden.","type":"text"}]},{"type":"paragraph","content":[{"text":"Für die ersten Tests ist es aber auf alle Fälle empfehlenswert!","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Des Weiteren muss für die Zusammenarbeit mit Loxone das Argument \"--bool-as-int\" angegeben werden, damit die HtREST Applikation boolesche Werte (true/false) als numerische Werte (0/1) interpretiert und auch zurückliefert.","type":"text"}]},{"type":"paragraph","content":[{"text":"Die Loxone Steuerung kann nämlich leider keine boolesche Werte verarbeiten.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Zugriff von Loxone aus","type":"text"}]},{"type":"paragraph","content":[{"text":"Als nächstes kann man sich daran machen, die gewünschten Parameter der Heliotherm Wärmepumpe auf der Loxone mittels \"","type":"text"},{"text":"Virtuellen HTTP Ein- bzw. Ausgängen","type":"text","marks":[{"type":"underline"}]},{"text":"\" verfügbar zu machen.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Lesender Zugriff","type":"text"}]},{"type":"paragraph","content":[{"text":"Zuerst erstellen wir uns zum Lesen einer oder mehrerer Parameter von der Wärmepumpe einen \"","type":"text"},{"text":"Virtuellen HTTP Eingang","type":"text","marks":[{"type":"underline"}]},{"text":"\" unter den \"","type":"text"},{"text":"Virtuellen Eingängen","type":"text","marks":[{"type":"underline"}]},{"text":"\" in der Loxone Config.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":20.0},"content":[{"type":"media","attrs":{"width":1104,"id":"e7e0ab47-4697-4834-b8a8-415fd58c2f87","collection":"contentId-1583089663","type":"file","height":1031}}]},{"type":"paragraph","content":[{"text":"Unter den Eigenschaften des \"","type":"text"},{"text":"Virtuellen HTTP Eingang","type":"text","marks":[{"type":"underline"}]},{"text":"\" vergeben wir diesem erst einmal eine ordentliche Bezeichnung, wie z.B. \"HT alle Parameter\" (zum Lesen des gesamten Parametersatz von der Wärmepumpe).","type":"text"}]},{"type":"paragraph","content":[{"text":"Als URL geben wir den Link zur Abfrage aller bekannten Heliotherm Parameter lt. Beschreibung auf der ","type":"text"},{"text":"HtREST GitHub-Seite","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/dstrigl/HtREST"}}]},{"text":" an, wobei IP-Adresse und Portnummer natürlich wieder entsprechend angepasst werden muss:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"http://192.168.0.156:8080/api/v1/param/","type":"text"}]},{"type":"paragraph","content":[{"text":"Abfragezyklus, Timeout und Anzahl erlaubte Timeouts kann entsprechend den eigenen Vorstellungen gewählt werden.","type":"text"}]},{"type":"paragraph","content":[{"text":"Hier wird z.B. alle 60 Sekunden der gesamte bekannte Parametersatz von der Wärmepumpe gelesen, wobei das Timeout bei 4 Sekunden liegt.","type":"text"}]},{"type":"paragraph","content":[{"text":"Was dabei unter \"gesamte bekannte Parametersatz\" zu verstehen ist, wird etwas später genauer erläutert.","type":"text"}]},{"type":"paragraph","content":[{"text":"Anschließend fügen wir einen \"","type":"text"},{"text":"Virtueller HTTP Eingang Befehl","type":"text","marks":[{"type":"underline"}]},{"text":"\" zum Extrahieren der empfangenen Daten von der HtREST Applikation ein.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":22.0},"content":[{"type":"media","attrs":{"width":1218,"id":"c4f8bec2-4107-442d-817d-ea0be85561b3","collection":"contentId-1583089663","type":"file","height":1043}}]},{"type":"paragraph","content":[{"text":"Die angefragten Parameter kommen von der HtREST Applikation im ","type":"text"},{"text":"JSON-Format","type":"text","marks":[{"type":"link","attrs":{"href":"https://de.wikipedia.org/wiki/JavaScript_Object_Notation"}}]},{"text":" zurück, für die obige Anfrage unter ","type":"text"},{"text":"http://192.168.0.156:8080/api/v1/param/","type":"text","marks":[{"type":"link","attrs":{"href":"http://192.168.0.156:8080/api/v1/param/"}}]},{"text":" also z.B.:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"{\n ...\n \"WW Hysterese Minimaltemp.\": 5,\n \"WW Minimaltemp.\": 42,\n \"WW Hysterese Normaltemp.\": 5,\n \"WW Normaltemp.\": 50,\n \"HKR RLT Soll_uHG (Heizkurve)\": 32.5,\n \"HKR RLT Soll_0 (Heizkurve)\": 28,\n \"HKR RLT Soll_oHG (Heizkurve)\": 23,\n \"HKR Heizgrenze\": 18,\n \"HKR Absenktemp. (K)\": -2,\n \"HKR Aufheiztemp. (K)\": 2,\n \"HKR Soll_Raum\": 22.5,\n \"Betriebsart\": 1,\n ...\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Um nun z.B. den Wert für den Parameter \"HKR RLT Soll_0 (Heizkurve)\" aus der JSON-Antwort zu extrahieren, geben wir gemäß der ","type":"text"},{"text":"Loxone Dokumentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.loxone.com/dede/kb/virtueller-http-eingang/"}}]},{"text":" unter \"","type":"text"},{"text":"Befehlserkennung","type":"text","marks":[{"type":"underline"}]},{"text":"\" des \"","type":"text"},{"text":"Virtueller HTTP Eingang Befehl","type":"text","marks":[{"type":"underline"}]},{"text":"\" folgendes ein:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"\\iHKR RLT Soll_0 (Heizkurve)\": \\i\\v","type":"text"}]},{"type":"paragraph","content":[{"text":"Wichtig dabei ist zwischen den beiden \\i Kennungen der Parametername inklusive den doppelten Anführungszeichen oben, dem Doppelpunkt und dem Leerzeichen!","type":"text"}]},{"type":"paragraph","content":[{"text":"Nur so kann die Loxone durch einen passenden Match den zugehörigen Parameterwert ermitteln.","type":"text"}]},{"type":"paragraph","content":[{"text":"Es sei nochmals kurz erwähnt, dass die Loxone hier nur Zahlenwerte verarbeiten kann, weshalb auch die Verwendung des Arguments \"--bool-as-int\" beim Aufruf der HtREST Applikation erforderlich ist.","type":"text"}]},{"type":"paragraph","content":[{"text":"Zusätzlich lassen sich über die Einstellungen unter dem Punkt \"","type":"text"},{"text":"Validierung","type":"text","marks":[{"type":"underline"}]},{"text":"\" des \"","type":"text"},{"text":"Virtueller HTTP Eingang Befeh","type":"text","marks":[{"type":"underline"}]},{"text":"l\" die empfangenen Werte noch auf ihre Gültigkeit hin überprüfen.","type":"text"}]},{"type":"paragraph","content":[{"text":"Minimal und Maximalwert der gängigsten Parameter findet man z.B. hier:","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"https://htheatpump.readthedocs.io/en/latest/htparams.html","type":"text","marks":[{"type":"link","attrs":{"href":"https://htheatpump.readthedocs.io/en/latest/htparams.html"}}]}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"htcomplparams"},"legacyAnchorId":{"value":"Heliotherm(OpenSource)-htcomplparams"}},"macroMetadata":{"macroId":{"value":"8f654ec8-295b-4070-819a-3559bc3b4bd6"},"schemaVersion":{"value":"1"},"title":"Anker"}}}}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Vollständige Liste aller verfügbaren Parameter der eigenen Heliotherm Wärmepumpe:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Eine vollständige Liste aller verfügbaren Parameter der eigenen Heliotherm Wärmepumpe inklusive deren Minimal- und Maximalwert lässt sich auch mit Hilfe des Python Scripts ","type":"text"},{"text":"htcomplparams","type":"text","marks":[{"type":"link","attrs":{"href":"https://htheatpump.readthedocs.io/en/latest/htscripts.html#htcomplparams"}}]},{"text":" erstellen.","type":"text"}]},{"type":"paragraph","content":[{"text":"Dieses Script wird zusammen mit der HtREST Applikation installiert und lässt sich einfach innerhalb der virtuellen Arbeitsumgebung ausführen:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"(htrest) pi@htrest:~ $ htcomplparams --device /dev/ttyUSB1 --csv\nHTHEATPUMP: load parameter definitions from: /home/pi/prog/htheatpump/htheatpump/htparams.csv\nconnected successfully to heat pump with serial number 123456\nsoftware version = 3.0.20 (273)\n'SP,NR=0' [Language]: VAL=0, MIN=0, MAX=4 (dtype=INT)\n'SP,NR=1' [TBF_BIT]: VAL=0, MIN=0, MAX=1 (dtype=BOOL)\n'SP,NR=2' [Rueckruferlaubnis]: VAL=1, MIN=0, MAX=1 (dtype=BOOL)\n...\nwrite data to: /home/pi/prog/htheatpump/htparams-123456-3_0_20-273.csv\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Siehe auch: ","type":"text"},{"text":"https://htheatpump.readthedocs.io/en/latest/htscripts.html#htcomplparams","type":"text","marks":[{"type":"link","attrs":{"href":"https://htheatpump.readthedocs.io/en/latest/htscripts.html#htcomplparams"}}]}]}]},{"type":"paragraph","content":[{"text":"Mit welcher Einheit der ausgelesene Parameterwert dargestellt werden soll, lässt sich über den Punkt \"","type":"text"},{"text":"Einheit","type":"text","marks":[{"type":"underline"}]},{"text":"\" im \"","type":"text"},{"text":"Virtueller HTTP Eingang Befehl","type":"text","marks":[{"type":"underline"}]},{"text":"\" definieren:","type":"text"}]},{"type":"paragraph","content":[{"text":" °C","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"Für alle weiteren Parameter sind einfach die soeben beschriebene Schritte zum Anlegen eines \"","type":"text"},{"text":"Virtueller HTTP Eingang Befehl","type":"text","marks":[{"type":"underline"}]},{"text":"\" zu wiederholen.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Schreibender Zugriff","type":"text"}]},{"type":"paragraph","content":[{"text":"Das Schreiben eines Parameters von der Loxone Steuerung aus läuft recht ähnlich ab.","type":"text"}]},{"type":"paragraph","content":[{"text":"Dazu erstellen wir uns einen \"","type":"text"},{"text":"Virtuellen Ausgang","type":"text","marks":[{"type":"underline"}]},{"text":"\" unter den \"","type":"text"},{"text":"Virtuellen Ausgängen","type":"text","marks":[{"type":"underline"}]},{"text":"\" in der Loxone Config.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":27.0},"content":[{"type":"media","attrs":{"width":1455,"id":"955a3a64-8153-497b-baf2-0473e91c05aa","collection":"contentId-1583089663","type":"file","height":1029}}]},{"type":"paragraph","content":[{"text":"Dann vergeben wir diesem wieder einen ordentlichen Namen und tragen unter der Adresse in den Einstellungen die URL ein, unter der die HtREST Applikation erreichbar ist:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"http://192.168.0.156:8080","type":"text"}]},{"type":"paragraph","content":[{"text":"Anschließend fügen wir für jeden zu schreibenden Parameter einen \"","type":"text"},{"text":"Virtueller Ausgang Befehl","type":"text","marks":[{"type":"underline"}]},{"text":"\" ein.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":24.0},"content":[{"type":"media","attrs":{"width":1298,"id":"84af6667-18ff-4731-8dd9-2e8994d1aa95","collection":"contentId-1583089663","type":"file","height":1045}}]},{"type":"paragraph","content":[{"text":"Unter \"","type":"text"},{"text":"Befehl bei EIN","type":"text","marks":[{"type":"underline"}]},{"text":"\" tragen wir für jeden Parameter die Zeichenfolge ","type":"text"},{"text":"/api/v1/param/","type":"text"},{"text":" gefolgt vom Parameternamen ein, also z.B.:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"/api/v1/param/HKR Soll_Raum","type":"text"}]},{"type":"paragraph","content":[{"text":"Da die Parameterwerte wieder im ","type":"text"},{"text":"JSON-Format","type":"text","marks":[{"type":"link","attrs":{"href":"https://de.wikipedia.org/wiki/JavaScript_Object_Notation"}}]},{"text":" ","type":"text"},{"text":"übertragen werden, geben wir unter \"","type":"text"},{"text":"HTTP-Erweiterung bei EIN","type":"text","marks":[{"type":"underline"}]},{"text":"\" noch","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"accept: application/json\\r\\nContent-Type: application/json","type":"text"}]},{"type":"paragraph","content":[{"text":"an und als \"","type":"text"},{"text":"HTTP-Post-Befehl bei EIN","type":"text","marks":[{"type":"underline"}]},{"text":"\" den folgenden Format-String:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"{ \"value\": }","type":"text"}]},{"type":"paragraph","content":[{"text":"Somit ist gewährleistet, dass der Parameterwert im ","type":"text"},{"text":"JSON-Format","type":"text","marks":[{"type":"link","attrs":{"href":"https://de.wikipedia.org/wiki/JavaScript_Object_Notation"}}]},{"text":" an die HtREST Applikation übertragen wird.","type":"text"}]},{"type":"paragraph","content":[{"text":"Abschließend muss nur noch unter \"","type":"text"},{"text":"HTTP Methode bei EIN","type":"text","marks":[{"type":"underline"}]},{"text":"\" die Methode \"","type":"text"},{"text":"PUT","type":"text","marks":[{"type":"underline"}]},{"text":"\" ausgewählt werden.","type":"text"}]},{"type":"paragraph","content":[{"text":"Unter \"","type":"text"},{"text":"Einheit","type":"text","marks":[{"type":"underline"}]},{"text":"\" beim \"","type":"text"},{"text":"Virtueller Ausgang Befehl","type":"text","marks":[{"type":"underline"}]},{"text":"\" lässt sich dann noch analog zum \"","type":"text"},{"text":"Virtueller HTTP Eingang Befehl","type":"text","marks":[{"type":"underline"}]},{"text":"\" die Einheit des zu schreibenden Parameterwertes definieren:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":" °C","type":"text"}]},{"type":"paragraph","content":[{"text":"Somit wäre das Lesen und Schreiben von Parameterwerten von der Loxone Steuerung aus abgeschossen.","type":"text"}]},{"type":"paragraph","content":[{"text":"Eine Loxone Vorlage mit den soeben beschriebenen \"","type":"text"},{"text":"Virtuellen HTTP Ein- bzw. Ausgängen","type":"text","marks":[{"type":"underline"}]},{"text":"\" für den Zugriff auf die Heliotherm Wärmepumpe findet sich zum Download im Anhang dieses Dokuments.","type":"text"}]},{"type":"paragraph","content":[{"text":"Was jetzt noch fehlt ist die Einrichtung der HtREST Applikation als Service, damit diese bei jedem Neustart des Raspberry Pi automatisch startet.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Automatischer Start","type":"text"}]},{"type":"paragraph","content":[{"text":"Damit die HtREST Applikation mit den von uns gewünschten Argumenten automatisch beim Reboot des Raspberry Pi startet, verpacken wir den Aufruf in einen ","type":"text"},{"text":"systemd","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.raspberrypi.org/documentation/linux/usage/systemd.md"}}]},{"text":" Service.","type":"text"}]},{"type":"paragraph","content":[{"text":"Dazu erstellen wir uns zuerst mittels nano eine passende System Unit-Datei:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"pi@htrest:~ $ sudo nano -w /etc/systemd/system/htrest.service","type":"text"}]},{"type":"paragraph","content":[{"text":"Anschließend fügen wir den Inhalt der ","type":"text"},{"text":"Datei","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/dstrigl/HtREST/blob/master/htrest.service"}}]},{"text":" unter","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"https://github.com/dstrigl/HtREST/blob/master/htrest.service","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/dstrigl/HtREST/blob/master/htrest.service"}}]}]},{"type":"paragraph","content":[{"text":"in die soeben erstellte Datei ein (Copy & Paste) und passen die Aufrufargumente in der Zeile 8","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"ExecStart=/home/pi/venv/htrest/bin/htrest -d ...","type":"text"}]},{"type":"paragraph","content":[{"text":"entsprechend unseren Vorgaben an (Pfad zum seriellen Device, Baudrate, Portnummer, usw.).","type":"text"}]},{"type":"paragraph","content":[{"text":"Dann verlassen wir den nano Editor mittels \"CTRL-X\" und Drücken der Taste \"Y\" zum Speichern des Inhalts.","type":"text"}]},{"type":"paragraph","content":[{"text":"Danach aktivieren wir die gerade erstellte System Unit mittels:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"pi@htrest:~ $ sudo systemctl enable htrest.service","type":"text"}]},{"type":"paragraph","content":[{"text":"Damit ist gewährleistet, dass diese automatisch beim Bootvorgang gestartet wird.","type":"text"}]},{"type":"paragraph","content":[{"text":"Um zum Testen des erstellen Service jetzt nicht zwingend einen Neustart durchführen zu müssen kann dieser gleich in der aktuellen Session mittels","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"pi@htrest:~ $ sudo systemctl start htrest.service","type":"text"}]},{"type":"paragraph","content":[{"text":"gestartet werden.","type":"text"}]},{"type":"paragraph","content":[{"text":"Gestoppt werden kann der Service mittels:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"pi@htrest:~ $ sudo systemctl stop htrest.service","type":"text"}]},{"type":"paragraph","content":[{"text":"Ein Neustart des Service kann mittels","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"pi@htrest:~ $ sudo systemctl restart htrest.service","type":"text"}]},{"type":"paragraph","content":[{"text":"erzwungen werden.","type":"text"}]},{"type":"paragraph","content":[{"text":"Recht hilfreich ist auch noch das ","type":"text"},{"text":"status","type":"text"},{"text":" Kommando, mit dessen Hilfe der aktuelle Status des Service ermittelt werden kann:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"pi@htrest:~ $ sudo systemctl status htrest.service\n● htrest.service - Heliotherm heat pump REST API server\n Loaded: loaded (/etc/systemd/system/htrest.service; enabled; vendor preset: enabled)\n Active: active (running) since Mon 2022-01-10 15:41:55 CET; 2 days ago\n Main PID: 474 (htrest)\n Tasks: 1 (limit: 877)\n CGroup: /system.slice/htrest.service\n └─474 /home/pi/venv/htrest/bin/python3 /home/pi/venv/htrest/bin/htrest -d /dev/ttyUSB0 -b 115200 --host 192.168.11.99 --port 8777 --bool-as-int\n\nJan 12 17:33:11 rpi-htrest htrest[474]: 2022-01-12 17:33:11,422 INFO [htrest.apis.param|get]: *** [GET] http://192.168.11.99:8777/api/v1/param/\nJan 12 17:33:26 rpi-htrest htrest[474]: 2022-01-12 17:33:26,413 INFO [htrest.apis.param|get]: *** [GET] http://192.168.11.99:8777/api/v1/param/\nJan 12 17:33:41 rpi-htrest htrest[474]: 2022-01-12 17:33:41,421 INFO [htrest.apis.param|get]: *** [GET] http://192.168.11.99:8777/api/v1/param/\n...","type":"text"}]},{"type":"paragraph","content":[{"text":"Weiterführende Dokumentation zu ","type":"text"},{"text":"systemd","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.raspberrypi.org/documentation/linux/usage/systemd.md"}}]},{"text":" und Service Units findet sich z.B. hier:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"https://www.linode.com/docs/quick-answers/linux/start-service-at-boot/","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.linode.com/docs/quick-answers/linux/start-service-at-boot/"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"https://fedoramagazine.org/what-is-an-init-system/","type":"text","marks":[{"type":"link","attrs":{"href":"https://fedoramagazine.org/what-is-an-init-system/"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"https://www.raspberrypi.org/documentation/linux/usage/systemd.md","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.raspberrypi.org/documentation/linux/usage/systemd.md"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"http://man7.org/linux/man-pages/man1/init.1.html","type":"text","marks":[{"type":"link","attrs":{"href":"http://man7.org/linux/man-pages/man1/init.1.html"}}]}]}]}]},{"type":"paragraph","content":[{"text":"Bei Problemen mit dem HtREST ","type":"text"},{"text":"systemd","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.raspberrypi.org/documentation/linux/usage/systemd.md"}}]},{"text":" Service, sollte man sich zuerst einmal immer den aktuellen Status des Service ansehen und dann noch mittels folgendem Kommando den zugehörigen Log:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"pi@htrest:~ $ journalctl -f -u htrest\n\n-- Logs begin at Mon 2022-01-10 15:41:25 CET. --\nJan 12 17:32:56 rpi-htrest htrest[474]: 2022-01-12 17:32:56,409 INFO [htrest.apis.param|get]: *** [GET] http://192.168.11.99:8777/api/v1/param/\nJan 12 17:33:11 rpi-htrest htrest[474]: 2022-01-12 17:33:11,422 INFO [htrest.apis.param|get]: *** [GET] http://192.168.11.99:8777/api/v1/param/\nJan 12 17:33:26 rpi-htrest htrest[474]: 2022-01-12 17:33:26,413 INFO [htrest.apis.param|get]: *** [GET] http://192.168.11.99:8777/api/v1/param/\nJan 12 17:33:41 rpi-htrest htrest[474]: 2022-01-12 17:33:41,421 INFO [htrest.apis.param|get]: *** [GET] http://192.168.11.99:8777/api/v1/param/\n...","type":"text"}]},{"type":"paragraph","content":[{"text":"Hat das alles soweit funktioniert, sollte man vielleicht noch mittels","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"pi@htrest:~ $ sudo reboot","type":"text"}]},{"type":"paragraph","content":[{"text":"einen Neustart des Raspberry Pi durchführen und sich anschließend den Status des erstellten Service ansehen, ","type":"text"},{"text":"um sicherzugehen, dass der Service auch wirklich ohne Fehler startet.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Parametersatz & -definitionen","type":"text"}]},{"type":"paragraph","content":[{"text":"Abschließend soll noch kurz erläutert werden, was sich mit dem oben angesprochenen \"bekannten Parametersatz\" auf sich hat.","type":"text"}]},{"type":"paragraph","content":[{"text":"Der Zugriff auf die einzelnen Parameter der Heliotherm Wärmepumpe läuft über nummerierte SP- und MP-Datenpunkte ab.","type":"text"}]},{"type":"paragraph","content":[{"text":"So ist z.B. die aktuelle Vorlauftemperatur unter dem Datenpunkt \"MP,NR=3\" zu finden.","type":"text"}]},{"type":"paragraph","content":[{"text":"Unter welchem SP- bzw. MP-Datenpunkt nun ein Parameter zu finden ist, ist in der CSV-Datei ","type":"text"},{"text":"htparams.csv","type":"text"},{"text":" festgehalten.","type":"text"}]},{"type":"paragraph","content":[{"text":"Das ","type":"text"},{"text":"htheatpump","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/dstrigl/htheatpump"}}]},{"text":" Paket, auf dem die ","type":"text"},{"text":"HtREST","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/dstrigl/HtREST"}}]},{"text":" Applikation aufbaut, liefert standardmäßig bereits eine ","type":"text"},{"text":"CSV-Datei","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/dstrigl/htheatpump/blob/master/htheatpump/htparams.csv"}}]},{"text":" mit einigen der gängigsten Parametern mit.","type":"text"}]},{"type":"paragraph","content":[{"text":"Zu finden ist diese auch auf der ","type":"text"},{"text":"GitHub-Seite des Projekts","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/dstrigl/htheatpump"}}]},{"text":" unter","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"https://github.com/dstrigl/htheatpump/blob/master/htheatpump/htparams.csv","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/dstrigl/htheatpump/blob/master/htheatpump/htparams.csv"}}]}]},{"type":"paragraph","content":[{"text":"oder der ","type":"text"},{"text":"Projektdokumentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://htheatpump.readthedocs.io/en/latest/htparams.html"}}]},{"text":" unter","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"https://htheatpump.readthedocs.io/en/latest/htparams.html","type":"text","marks":[{"type":"link","attrs":{"href":"https://htheatpump.readthedocs.io/en/latest/htparams.html"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Des Weiteren ist es möglich seine eigene benutzerspezifische CSV-Datei mit den Parameter-Definitionen unter ","type":"text"},{"text":"~/.htheatpump/htparams.csv","type":"text","marks":[{"type":"strong"}]},{"text":" anzulegen.","type":"text"}]},{"type":"paragraph","content":[{"text":"Wenn vorhanden, greift die htheatpump Bibliothek darauf zu, ansonsten wird die mitgelieferte Datei verwendet.","type":"text"}]},{"type":"paragraph","content":[{"text":"Innerhalb dieser CSV-Datei unter ","type":"text"},{"text":"~/.htheatpump/htparams.csv ","type":"text"},{"text":"ist es nun möglich sich seinen eigenen \"bekannten Parametersatz\" zusammenzustellen, wenn einem der mitgelieferte nicht passen sollte.","type":"text"}]},{"type":"paragraph","content":[{"text":"Grund könnte z.B. sein, dass man den einzelnen Parametern andere Namen zuweisen möchte um Leerzeichen in Parameternamen zu vermeiden.","type":"text"}]},{"type":"paragraph","content":[{"text":"Ein anderer Grund könnte sein den Parametersatz um bestimmte Parameter zu erweitern.","type":"text"}]},{"type":"paragraph","content":[{"text":"Wie bereits weiter ","type":"text"},{"text":"oben beschrieben","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/pages/resumedraft.action?draftId=1583089663#Heliotherm(OpenSource)-htcomplparams"}}]},{"text":", ist es auch möglich sich eine vollständige Liste aller verfügbaren Parameter seiner Heliotherm Wärmepumpe (inkl. deren Minimal- und Maximalwert) mit Hilfe des Python Scripts ","type":"text"},{"text":"htcomplparams.py ","type":"text"},{"text":"zu erstellen.","type":"text"}]},{"type":"paragraph","content":[{"text":"Siehe dazu auch die Beschreibung unter:","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"https://htheatpump.readthedocs.io/en/latest/htscripts.html#htcomplparams","type":"text","marks":[{"type":"link","attrs":{"href":"https://htheatpump.readthedocs.io/en/latest/htscripts.html#htcomplparams"}}]}]},{"type":"paragraph","content":[{"text":"Ein kompletter Auszug der verfügbaren Parameter einer Heliotherm HP08S10W-WEB findet sich z.B. hier:","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"Parameterdefinition Heliotherm HP08S10W-WEB, SW 3.0.20 (273)","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/LOX/pages/1587838984"}}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Es ist jedoch aus Performance- und Sicherheitsgründen empfohlen, nur jene Parameter der Parameter-Definitionen in der CSV-Datei hinzuzufügen, welche auch wirklich benötigt werden.","type":"text"}]},{"type":"paragraph","content":[{"text":"Somit läuft man nicht Gefahr sich aus Unachtsamkeit bestimmte Parameter zu verstellen und auch die oben beschrieben Abfrage des gesamten Parametersatz (unter ","type":"text"},{"text":"/api/v1/param/","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.loxwiki.eu/api/v1/param/"}}]},{"text":") läuft wesentlich schneller ab.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Weiterführende Links","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HtREST GitHub","type":"text","marks":[{"type":"underline"}]},{"text":": ","type":"text"},{"text":"https://github.com/dstrigl/HtREST","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/dstrigl/HtREST"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"htheatpump GitHub","type":"text","marks":[{"type":"underline"}]},{"text":": ","type":"text"},{"text":"https://github.com/dstrigl/htheatpump","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/dstrigl/htheatpump"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"htheatpump Dokumentation","type":"text","marks":[{"type":"underline"}]},{"text":": ","type":"text"},{"text":"https://htheatpump.readthedocs.io/en/latest/","type":"text","marks":[{"type":"link","attrs":{"href":"https://htheatpump.readthedocs.io/en/latest/"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"loxforum Diskussion","type":"text","marks":[{"type":"underline"}]},{"text":": ","type":"text"},{"text":"https://www.loxforum.com/forum/hardware-zubeh%C3%B6r-sensorik/10565-heliotherm-rs232-anbindung","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.loxforum.com/forum/hardware-zubeh%C3%B6r-sensorik/10565-heliotherm-rs232-anbindung"}}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Anhang","type":"text"}]},{"type":"mediaGroup","content":[{"type":"media","attrs":{"id":"4ec8a4b4-8e3a-4d1b-ad07-e03c644c7ba5","collection":"contentId-1583089663","type":"file"}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Unterstützung","type":"text"}]},{"type":"paragraph","content":[{"text":"Du möchtest den Autor unterstützen?","type":"text"}]},{"type":"paragraph","content":[{"text":"Über einen Kaffee würde er sich sehr freuen:","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":13.0},"content":[{"type":"media","attrs":{"type":"external","url":"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png"},"marks":[{"type":"link","attrs":{"href":"https://www.buymeacoffee.com/N362PLZ"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser nicht unterstützt