Metainformationen zur Seite

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
plugins:labcom_poollab:start [2022/09/10 18:14] Michael Schlenstedtplugins:labcom_poollab:start [2023/01/27 12:01] (aktuell) Michael Schlenstedt
Zeile 1: Zeile 1:
 ====== LabCom / PoolLab  ====== ====== LabCom / PoolLab  ======
- 
  
 Version History... Version History...
  
-**Version 0.1.0**+https://github.com/mschlenstedt/LoxBerry-Plugin-LabCom/releases
  
-  * erste öffentliche Version+----
  
- 
- 
-\\ 
- 
- 
- 
----- 
  
 ===== Download ===== ===== Download =====
Zeile 21: Zeile 13:
  
 Letzter Entwicklungsstand im Repo: https://github.com/mschlenstedt/LoxBerry-Plugin-LabCom Letzter Entwicklungsstand im Repo: https://github.com/mschlenstedt/LoxBerry-Plugin-LabCom
 +
  
 ===== Funktion des Plugins ===== ===== Funktion des Plugins =====
Zeile 26: Zeile 19:
 Das Plugin verbindet sich mit Deinem LabCom Account und holt sich von dort alle Messungen ab und sendet jeweils neue Messungen per MQTT an den Miniserver bzw. den MQTT Broker oder das Gateway Plugin. So können die Messungen, die z. B. mit dem PoolLab 1.0 durchgeführt werden. Der Zeitstempel der Messung wird dabei nicht ausgewertet, sobald eine neue Messung in die LabCom Cloud hochgeladen wird, wird diese vom Plugin ausgewertet und übertragen. Das Plugin verbindet sich mit Deinem LabCom Account und holt sich von dort alle Messungen ab und sendet jeweils neue Messungen per MQTT an den Miniserver bzw. den MQTT Broker oder das Gateway Plugin. So können die Messungen, die z. B. mit dem PoolLab 1.0 durchgeführt werden. Der Zeitstempel der Messung wird dabei nicht ausgewertet, sobald eine neue Messung in die LabCom Cloud hochgeladen wird, wird diese vom Plugin ausgewertet und übertragen.
  
-\\ 
- 
- 
-SecurePIN 
  
 +<WRAP center round tip 100%>
 +== SecurePIN ==
  
 Aus Sicherheitsgründen ist das Webinterface des LabCom Plugins mit dem [[haufig_gestellte_fragen_faq:was_ist_der_securepin|SecurePIN]] geschützt. Aus Sicherheitsgründen ist das Webinterface des LabCom Plugins mit dem [[haufig_gestellte_fragen_faq:was_ist_der_securepin|SecurePIN]] geschützt.
- +</WRAP>
- +
- +
-\\+
  
  
Zeile 42: Zeile 30:
  
 In der LabCom Cloud muss ein Access-Token erzeugt werden. Dieser muss im Plugin eingetragen werden. Zudem können in der Cloud auch mehrere einzelne Accounts (z. B. für unterschiedliche Kunden) angelegt werden. Das Plugin kann diese unterschiedlichen Accounts nur anhand des Vor- und Nachnamens erkennen. Es ist also wichtig, hier jeweils unterschiedliche Namen zu verwenden. In der LabCom Cloud muss ein Access-Token erzeugt werden. Dieser muss im Plugin eingetragen werden. Zudem können in der Cloud auch mehrere einzelne Accounts (z. B. für unterschiedliche Kunden) angelegt werden. Das Plugin kann diese unterschiedlichen Accounts nur anhand des Vor- und Nachnamens erkennen. Es ist also wichtig, hier jeweils unterschiedliche Namen zu verwenden.
 +
  
 ===== Konfiguration: Schritt für Schritt ===== ===== Konfiguration: Schritt für Schritt =====
  
-==== OPTIONAL: Installieren des MQTT Gateway Plugins ==== 
  
-Das Plugin sendet die Daten ausschließlich per MQTT an einen entsprechenden MQTT Broker. Es empfiehlt sichauf einem Deiner LoxBerrys dazu das MQTT Gateway Plugin zu installieren. Im MQTT Gateway Plugin muss folgendes konfiguriert werden:+==== MQTT Gateway ==== 
 + 
 +Das Plugin sendet die Daten ausschließlich per MQTT an einen entsprechenden MQTT Broker. Wenn Du noch LoxBerry 2.x verwendestmusst Du das [[plugins:mqtt_gateway:start|MQTT Gateway Plugin]] zusätzlich installieren. In LoxBerry 3.x ist das Gateway bereits eingebaut. Im MQTT Gateway Plugin bzw. MQTT Widget muss folgendes konfiguriert werden:
  
   * "Set virtual inputs via HTTP webservice" aktivieren   * "Set virtual inputs via HTTP webservice" aktivieren
-  * Folgende Subscription erstellen: ''%%labcom/# %%''//(ab Plugin-Version 0.1.0 passiert das automatisch bei Verwendung des MQTT Gateways auf dem selben LoxBerry) - bzw. euer eigenes Topic, falls ihr nicht das Standardtopic verwendet//+
  
 ==== Installieren des LabCom Plugins ==== ==== Installieren des LabCom Plugins ====
  
 Das Plugin wird ganz normal über die Pluginverwaltung installiert. Die Konfiguration ist schnell erledigt: Das Plugin wird ganz normal über die Pluginverwaltung installiert. Die Konfiguration ist schnell erledigt:
 +
  
 === LabCom === === LabCom ===
Zeile 60: Zeile 51:
 Hier musst Du lediglich Den erzeugten Token eingeben. Optional kannst Du entscheiden, ob Du die Messdaten aller Deiner Accounts oder nur von bestimmten Accounts abholen lassen möchtest. Für alle Accounts, gebe hierzu "0" ein. Möchtest Du nur einen Account abholen, gebe die entsprechende AccountID ein. Mehrere Accounts können dabei mit Komma getrennt eingegeben werden. Hier musst Du lediglich Den erzeugten Token eingeben. Optional kannst Du entscheiden, ob Du die Messdaten aller Deiner Accounts oder nur von bestimmten Accounts abholen lassen möchtest. Für alle Accounts, gebe hierzu "0" ein. Möchtest Du nur einen Account abholen, gebe die entsprechende AccountID ein. Mehrere Accounts können dabei mit Komma getrennt eingegeben werden.
  
-{{plugins:labcom_poollab:1269959409.png?h=250}} +{{plugins:labcom_poollab:1269959409.png?w=450}}
- +
-\\+
  
  
Zeile 71: Zeile 60:
 Ist das MQTT Gateway Plugin auf dem gleichen LoxBerry wie dieses Plugin installiert, kannst Du einfach hier die Daten des Gateway Plugins über das Setzen des entsprechenden Hakens übernehmen und brauchst nichts weiter zu konfigurieren. Möchtest Du einen anderen Broker verwenden oder ist das MQTT Gateway Plugin auf einem anderen LoxBerry installiert, musst Du die entsprechenden Parameter konfigurieren. Möchtest Du eine Authentifizierung am Broker verwenden, musst Du zudem Username und Passwort hier eingeben. Bleibt eines der beiden Felder leer, wird keine Authentifizierung am Broker benutzt (NICHT empfohlen!). Verschlüsselung über ein PSK unterstützt das Plugin aktuell noch nicht. Ist das MQTT Gateway Plugin auf dem gleichen LoxBerry wie dieses Plugin installiert, kannst Du einfach hier die Daten des Gateway Plugins über das Setzen des entsprechenden Hakens übernehmen und brauchst nichts weiter zu konfigurieren. Möchtest Du einen anderen Broker verwenden oder ist das MQTT Gateway Plugin auf einem anderen LoxBerry installiert, musst Du die entsprechenden Parameter konfigurieren. Möchtest Du eine Authentifizierung am Broker verwenden, musst Du zudem Username und Passwort hier eingeben. Bleibt eines der beiden Felder leer, wird keine Authentifizierung am Broker benutzt (NICHT empfohlen!). Verschlüsselung über ein PSK unterstützt das Plugin aktuell noch nicht.
  
-{{plugins:labcom_poollab:1269959410.png?h=250}} +{{plugins:labcom_poollab:1269959410.png?w=450}}
- +
-\\+
  
  
Zeile 80: Zeile 67:
 Die Einbindung erfolgt über Virtuelle HTTP Eingänge oder per UDP Eingang. Details dazu sind im MQTT Gateway Plugin beschrieben: [[plugins:mqtt_gateway:start|MQTT Gateway]] Die Einbindung erfolgt über Virtuelle HTTP Eingänge oder per UDP Eingang. Details dazu sind im MQTT Gateway Plugin beschrieben: [[plugins:mqtt_gateway:start|MQTT Gateway]]
  
-{{plugins:labcom_poollab:1269959412.png?h=250}}+{{plugins:labcom_poollab:1269959412.png?w=450}} 
  
 ===== Roadmap ===== ===== Roadmap =====
  
   * Deutsche Übersetzung   * Deutsche Übersetzung
-  * Timestamps auch im Loxone Format senden+
  
 ===== Fragen stellen und Fehler melden ===== ===== Fragen stellen und Fehler melden =====
  
 Im Loxforum in diesem Thread: https://www.loxforum.com/forum/projektforen/loxberry/plugins/311379-plugin-labcom-poollab Im Loxforum in diesem Thread: https://www.loxforum.com/forum/projektforen/loxberry/plugins/311379-plugin-labcom-poollab
- 
-\\ 
- 
- 
-\\ 
- 
- 
- 
  
 ---- struct data ---- ---- struct data ----
Zeile 103: Zeile 83:
 pluginuebersicht.logo : :plugins:labcom_poollab:1269959406.png pluginuebersicht.logo : :plugins:labcom_poollab:1269959406.png
 pluginuebersicht.status : STABLE pluginuebersicht.status : STABLE
-pluginuebersicht.version : 0.2.1+pluginuebersicht.version : 0.3.0
 pluginuebersicht.min_lb_version : 2.2.0 pluginuebersicht.min_lb_version : 2.2.0
-pluginuebersicht.url_release : https://github.com/mschlenstedt/LoxBerry-Plugin-LabCom/archive/refs/tags/LabCom-V0.2.1.zip+pluginuebersicht.url_release : https://github.com/mschlenstedt/LoxBerry-Plugin-LabCom/archive/refs/tags/LabCom-V0.3.0.zip
 pluginuebersicht.url_prerelease :  pluginuebersicht.url_prerelease : 
 pluginuebersicht.description : Holt die Messdaten Deines Pools aus der LabCom Cloud und sendet sie per MQTT an den Miniserver pluginuebersicht.description : Holt die Messdaten Deines Pools aus der LabCom Cloud und sendet sie per MQTT an den Miniserver