Metainformationen zur Seite

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Nächste Überarbeitung		Vorhergehende Überarbeitung
plugins:poolex:start [2023/05/15 21:49] – angelegt Michael Schlenstedtplugins:poolex:start [2023/07/11 05:59] (aktuell) – [Poolex Heatpumps] Michael Schlenstedt
Zeile 3: Zeile 3:
 ++++ Version History... | ++++ Version History... |
  
-https://github.com/mschlenstedt/LoxBerry-Plugin-Poolex/releases+[[https://github.com/mschlenstedt/LoxBerry-Plugin-Poolex/releases]]
  
 ++++ ++++
  
 ---- ----
 +
 +<WRAP center round alert 100%>
 +== Weiterentwicklung gestoppt ==
 +
 +Dieses Plugin wurde gestoppt und wird nicht mehr weiterentwickelt. Nutze bitte das bessere und flexiblere [[plugins:tinytuya:start|LoxBerry TinyTuya Plugin]], um Deine Wärmepumpe in Loxone einbzubinden!
 +</WRAP>
  
 ===== Funktion des Plugins ===== ===== Funktion des Plugins =====
Zeile 17: Zeile 23:
 ===== Installation ===== ===== Installation =====
  
-%%Das Plugin wird ganz normal über die Pluginschnittstelle installiert.%%+%%Das Plugin wird ganz normal über die Pluginschnittstelle installiert. **Auf LoxBerry V2.x ist zwingend das MQTT Gateway Plugin notwendig**. LoxBerry 3.x hat dieses bereits an Bord.%% 
 + 
 +===== Vorbereitungen ===== 
 + 
 +Um die Wärmepumpe später mit dem Plugin nutzen zu können, muss sie zunächst mit Deinem Tuya Cloud Account verbunden und eingerichtet werden. Anschließend benötigst Du einen Developer-Zugang bei Tuya (kostenlos), damit Du Zugriff auf die Tuya API bekommst. Erst dann kannst Du die Wärmepumpe über das Plugin abrufen und steuern. Die Kommunikation zwischen Plugin und Wärmepumpe erfolgt dabei rein lokal - lediglich für die Ersteinrichtung ist die Einrichtung in der Tuya-Cloud notwendig. 
 + 
 +=== Pairing der Wärmepumpe === 
 + 
 +Zum Pairing mit Deinem Cloudaccount gehe bitte nach der Anleitung von Poolex / Poolstar vor. Je nach Wärmepumpe ist der Vorgang etwas anders. Du benötigt die "Amart Life" App von Tuya auf dem Handy. Anschließend bringst Du die Wärmepumpe in den Pairing Modus. Das geht üblicherweise, in dem Du auf dem Display "Uhr" + "Pfeil Hoch" oder "Uhr" + "Plus" zeitgleich für 3 Sekunden drückst. Wenn "Set" im Display schnell blinkt, befindet sich die Wärmepumpe im Pairing Modus. Rest dann wie in der Anleitung. [[https://www.manualslib.de/manual/746961/Poolstar-Poolex-Platinium-Mini-Serie.html?page=57#manual]] 
 + 
 +=== API Zugang einrichten === 
 + 
 +Nachdem Du die Wärmepumpe mit Deinem Cloudzugang und Handy verbunden hast, kannst Du Dir Deinen API-Zugang einrichten. Original-Anleitung findest Du hier: [[https://github.com/jasonacox/tinytuya]] 
 + 
 +TUYA ACCOUNT - Set up a Tuya Account (see%% %%[[https://github.com/jasonacox/tinytuya/files/8145832/Tuya.IoT.API.Setup.pdf|PDF Instructions]]): 
 + 
 +  * //NOTE: Tuya often changes their portal and services. Please open an%% %%[[https://github.com/jasonacox/tinytuya/issues|issue]]%% %%with screenshots if we need to update these instructions.// 
 +  * Create a Tuya Developer account on%% %%[[https://iot.tuya.com|iot.tuya.com]]. When it asks for the "Account Type", select "Skip this step..." (see%% %%[[https://user-images.githubusercontent.com/836718/213877860-34c39851-5671-4c9f-b4d5-251873f18c77.png|screenshot]]). 
 +  * Click on "Cloud" icon -> "Create Cloud Project" 
 +    - Remember the "Data Center" you select. This will be used by TinyTuya Wizard ([[https://user-images.githubusercontent.com/836718/138598647-c9657e49-1a89-4ed6-8105-ceee95d9513f.png|screenshot]]). 
 +    - Skip the configuration wizard but remember the Authorization Key:%% %%//API ID//%% %%and%% %%//Secret//%% %%for below ([[https://user-images.githubusercontent.com/836718/138598788-f74d2fe8-57fa-439c-8003-18735a44e7e5.png|screenshot]]). 
 +  * Click on "Cloud" icon -> Select your project ->%% %%**Devices**%% %%->%% %%**Link Tuya App Account**%% %%(see [[https://user-images.githubusercontent.com/836718/155827671-44d5fce4-0119-4d0e-a224-ef3715fafc24.png|screenshot]]) 
 +  * Click%% %%**Add App Account**%% %%([[https://user-images.githubusercontent.com/836718/155827671-44d5fce4-0119-4d0e-a224-ef3715fafc24.png|screenshot]]) and it will display a QR code. Scan the QR code with the%% %%//Smart Life app//%% %%on your Phone (see step 1 above) by going to the "Me" tab in the%% %%//Smart Life app//%% %%and clicking on the QR code button%% %%''[-]''%% %%in the upper right hand corner of the app. When you scan the QR code, it will link all of the devices registered in your%% %%//Smart Life app//%% %%into your Tuya IoT project. 
 +  * **NO DEVICES?**%% %%If no devices show up after scanning the QR code, you will need to select a different data center and edit your project (or create a new one) until you see your paired devices from the%% %%//Smart Life App//%% %%show up. ([[https://user-images.githubusercontent.com/35581194/148679597-391adecb-a271-453b-90c0-c64cdfad42e4.png|screenshot]]). The data center may not be the most logical. As an example, some in the UK have reported needing to select "Central Europe" instead of "Western Europe". 
 +  * **SERVICE API:**%% %%Under "Service API" ensure these APIs are listed:%% %%''IoT Core'',%% %%''Authorization''%% %%and%% %%''Smart Home Scene Linkage''. To be sure, click subscribe again on every service. Very important:%% %%**disable popup blockers**%% %%otherwise subscribing won't work without providing any indication of a failure. Make sure you authorize your Project to use those APIs: 
 +    * Click "Service API" tab 
 +    * Click "**Go to Authorize**" button 
 +    * Select the API Groups from the dropdown and click%% %%''Subscribe''%% %%([[https://user-images.githubusercontent.com/38729644/128742724-9ed42673-7765-4e21-94c8-76022de8937a.png|screenshot]])
  
 ===== Konfigurationsoptionen ===== ===== Konfigurationsoptionen =====
  
-Under construction+Auf der Plugin Hauptseite musst Du die API Daten aus Deinem Tuya Developer Account eingeben und zusätzlich noch die DeviceID, die Du auslesen möchtest (also Deine Wärmepumpe). Alle Angaben müssen denen aus dem Account entsprechen. Gebe zusätzlich noch den Typ Deiner Wärmepumpe ein. Damit werden die Datenpunkte,d ei aus der Wärmepumpe ausgelesen werden, korrekt benannt. Im Reiter "MQTT" kannst Du das MQTT Topic anpassen, wenn Du möchtest. 
 + 
 +{{plugins:poolex:pasted:20230516-052148.png?600}} 
 + 
 +Wenn Du keine Daten bekommst, schaue als erstes in das "Wizard"-Logfile, es enthält den Scan nach Devices in Deinem Netzwerk und alle Logeinträge zum Versuch mit Deinem Gerät zu kommunizieren. 
 + 
 +<WRAP center round important 100%> 
 + 
 +== Achtung! == 
 + 
 +Das Plugin stellt permanent eine Verbindung zu Deiner Wärmepumpe her, solange die Bridge läuft. Die Wärmepumpe kann nur mit einem Gerät zeitgleich eine Verbindung eingehen. Daher ist dann ein Zugriff mit der Tuya App nicht mehr möglich! 
 + 
 +</WRAP>
  
 ===== Einrichtung in der Loxone Config Software ===== ===== Einrichtung in der Loxone Config Software =====
  
-Under construction+=== Messwerte auslesen/verwenden === 
 + 
 +Das Plugin sendet alle ausgelesenen Messwerte per MQTT an den MQTT Broker bzw. das [[konfiguration:widget_help:widget_mqtt:|MQTT Gateway]]. Im Gateway muss das Topic des Plugins abonniert werden (standardmäßig lautet das Topic "poolex/#") - das wird aber automatisch vom Plugin gemacht. Bitte lest in der Dokumentation des [[konfiguration:widget_help:widget_mqtt:|MQTT Widget]] nach, wie genau die Werte in der Loxone Config verwendet werden: [[konfiguration:widget_help:widget_mqtt:mqtt_gateway:mqtt_schritt_fur_schritt_mqtt_loxone|MQTT - Schritt für Schritt: MQTT -> Loxone]] 
 + 
 +Ich behandele das Thema "Anlegen eines Virtuellen Eingangs" hier nur in Kürze: 
 + 
 +  * Virtuellen Eingang anlegen 
 +  * Bezeichnung aus der Incoming Overview des Gateway kopieren und im Virtuellen Eingang exakt so einfügen.  
 +  * Als Digitaleingang verwenden: NEIN 
 +  *  Validierung korrekt setzen. 
 + 
 +=== Wärmepumpe steuern === 
 + 
 +Befehle können an die Wärmepumpe über das Topic**''%%poolex/set/command%%''** gesendet werden. Dazu muss für das [[konfiguration:widget_help:widget_mqtt:|MQTT Gateway]] ein Virtueller Ausgang angelegt werden. Bitte lest in der Dokumentation des  [[[konfiguration:widget_help:widget_mqtt:|MQTT Gateway]] nach, wie genau die Werte in der Loxone Config verwendet werden: [[konfiguration:widget_help:widget_mqtt:mqtt_gateway:mqtt_schritt_fur_schritt_loxone_mqtt|MQTT - Schritt für Schritt: Loxone -> MQTT]] 
 + 
 +Ich behandele das Thema "Anlegen eines Virtuellen Ausgangs" hier nur in Kürze: 
 + 
 +  * Virtuellen Ausgang anlegen, Adresse: /dev/udp/192.168.3.212/11884 (IP und ggf. Port müsst ihr anpassen) 
 +  * Darunter einen "Virtuellen Ausgang Befehl" anlegen 
 +  * Befehl bei EIN: **''%%publish poolex/set/command <EUER BEFEHL>%%''** 
 +  * **//Optional: //**Befehl bei AUS: **''%%publish poolex/set/command <EUER BEFEHL>%%''** 
 +  * Als Digitalausgang verwenden: je nach Bedarf, meist hier NEIN (um Werte über <v> an das Plugin zu übertragen 
 + 
 +Ein Befehl besteht immer aus dem Datenpunkt (DPS), den ihr ändern wollt, gefolgt von einem Komma und dem Wert, den ihr setzen wollt. Beispiel: Ihr wollt den DPS 2 ändern auf 21°C. Der Befehl lautet dann: **''%%2,21%%''** Anstelle des festen Wertes "21" könnt ihr natürlich auch den Wert variable durch die LoxoneConfig setzen, dann lautet der Befehl **''%%2,<v>%%''**. Das <v> wird von Loxone dann wie üblich durch den Analogwert des Befehlseingangs ersetzt. Anstelle des DPS als numerischen Wert könnt ihr auch den Namen verwenden, den ihr im Status aus der Incoming Overview auslesen könnt. Bei der Poolex Silverline ist z. B. DPS 2 gleich der Soll-Temperatur. Der Name ist "temperature". Damit sieht der Befehl wie folgt aus: **''%%temperature,21%%''**
  
 ===== Roadmap ===== ===== Roadmap =====
  
-Under construction+<do Prof.Mobilux>Deutsche Übersetzung</do>
  
 ===== Fragen stellen und Fehler melden ===== ===== Fragen stellen und Fehler melden =====
  
-→ Wo kann ich Fragen stellen und Fehler melden?+[[https://www.loxforum.com/forum/projektforen/loxberry/plugins/391345-plugin-loxberry-poolex-poolstar-w%C3%A4rmepumpenhttps://www.loxforum.com/forum/projektforen/loxberry/plugins/391345-plugin-loxberry-poolex-poolstar-w%C3%A4rmepumpen|https://www.loxforum.com/forum/projektforen/loxberry/plugins/391345-plugin-loxberry-poolex-poolstar-w%C3%A4rmepumpen]]
  
  
Zeile 39: Zeile 107:
 pluginuebersicht.author : prof.mobilux pluginuebersicht.author : prof.mobilux
 pluginuebersicht.logo : :plugins:poolex:icon_64.png pluginuebersicht.logo : :plugins:poolex:icon_64.png
-pluginuebersicht.status : UNSTABLE +pluginuebersicht.status : STOPPED 
-pluginuebersicht.version : 0.1.0 +pluginuebersicht.version : 0.2.1 
-pluginuebersicht.min_lb_version : 3.0.0 +pluginuebersicht.min_lb_version : 2.2.2 
-pluginuebersicht.url_release : https://github.com/mschlenstedt/LoxBerry-Plugin-Poolex/archive/refs/tags/LoxBerry-Plugin-Poolex-0.1.0.zip+pluginuebersicht.url_release : https://github.com/mschlenstedt/LoxBerry-Plugin-Poolex/archive/refs/tags/LoxBerry-Plugin-Poolex-0.2.1.zip
 pluginuebersicht.url_prerelease :  pluginuebersicht.url_prerelease : 
-pluginuebersicht.description : as Plugin bindet Pool Wärmepumpen des Herstellers Poolex (Poolstar) an Loxone an.+pluginuebersicht.description : Das Plugin bindet Pool Wärmepumpen des Herstellers Poolex (Poolstar) an Loxone an.
 pluginuebersicht.languages : EN pluginuebersicht.languages : EN
-pluginuebersicht.discussion : +pluginuebersicht.discussion : https://www.loxforum.com/forum/projektforen/loxberry/plugins/391345-plugin-loxberry-poolex-poolstar-w%C3%A4rmepumpen
 ---- ----