Metainformationen zur Seite

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
plugins:1_wire_ng:start [2022/09/10 15:26] – Struct-Daten geändert Michael Schlenstedtplugins:1_wire_ng:start [2025/05/26 05:33] (aktuell) – Struct-Daten geändert Michael Schlenstedt
Zeile 1: Zeile 1:
-====== 1-Wire-NG  ======+====== 1-Wire-NG ======
  
 +++++ Version History... |
  
 +[[https://github.com/mschlenstedt/LoxBerry-Plugin-1-Wire-NG/releases|https://github.com/mschlenstedt/LoxBerry-Plugin-1-Wire-NG/releases]]
  
-|Autor          |[[https://loxwiki.atlassian.net/wiki/people/6166f604d9820f00702fdbf7?ref=confluence|Michael Schlenstedt]]                    | +++++
-|Logo           |{{plugins:1_wire_ng:1240959460.png?h=64}}                                                                     | +
-|Status         |STABLE                                                                                                                       | +
-|Version        |2.0.5                                                                                                                        | +
-|Min. LB Version|LB 2.2.1                                                                                                                     | +
-|Download       |Release: -\\ \\ Pre-Release: https://github.com/mschlenstedt/LoxBerry-Plugin-1-Wire-NG/archive/refs/tags/1-Wire-NG-2.0.5.zip | +
-|Zweck          |Das Plugin kann einen an den LoxBerry angeschlossenen 1-Wire-Busmaster auslesen und die Sensorwerte an den Miniserver senden.| +
-|Languages      |EN, DE                                                                                                                       | +
-|Diskussion     |https://www.loxforum.com/forum/projektforen/loxberry/plugins/227489-plugin-1-wire-ng                                         | +
- +
- +
- +
-Version History... +
- +
-https://github.com/mschlenstedt/LoxBerry-Plugin-1-Wire-NG/releases +
- +
- +
- +
-\\ +
- +
- +
- +
-----+
  
 ===== Download ===== ===== Download =====
  
-Direkter Download-Link: Siehe //Tabelle oben//+Direkter Download-Link: Siehe //Tabelle oben//
  
-Letzter Entwicklungsstand im Repo: https://github.com/mschlenstedt/LoxBerry-Plugin-1-Wire-NG+Letzter Entwicklungsstand im Repo: [[https://github.com/mschlenstedt/LoxBerry-Plugin-1-Wire-NG|https://github.com/mschlenstedt/LoxBerry-Plugin-1-Wire-NG]]
  
 ===== Funktion des Plugins ===== ===== Funktion des Plugins =====
  
-Das Plugin liest mit Hilfe der Software OWFS (https://github.com/owfs/owfs oder https://www.owfs.org/) den 1-Wire-Bus aus und gibt die Werte per MQTT-Protokoll an einen MQTT-Broker weiter. Dabei können unterschiedliche 1-Wire-Busmaster an den LoxBerry angeschlossen werden. Es werden USB-, serielle (LinkUSB) und I2C-Busmaster unterstützt. Auch der in den LoxBerry per GPIO integrierte Busmaster wird unterstützt. Die Anzahl an Busmastern ist nur durch die verwendete Hardware begrenzt.+Das Plugin liest mit Hilfe der Software OWFS ([[https://github.com/owfs/owfs|https://github.com/owfs/owfs]] oder [[https://www.owfs.org/|https://www.owfs.org/]]) den 1-Wire-Bus aus und gibt die Werte per MQTT-Protokoll an einen MQTT-Broker weiter. Dabei können unterschiedliche 1-Wire-Busmaster an den LoxBerry angeschlossen werden. Es werden USB-, serielle (LinkUSB) und I2C-Busmaster unterstützt. Auch der in den LoxBerry per GPIO integrierte Busmaster wird unterstützt. Die Anzahl an Busmastern ist nur durch die verwendete Hardware begrenzt.
  
-Als MQTT-Broker empfiehlt sich das [[plugins:mqtt_gateway:start|MQTT Gateway Plugin]], welches die Werte direkt an den Miniserver senden kann.+Als MQTT-Broker empfiehlt sich das [[:plugins:mqtt_gateway:start|MQTT Gateway Plugin]], welches die Werte direkt an den Miniserver senden kann.
  
-Standardmäßig unterstützt das Plugin folgende Sensoren: DS2405, DS18S20, DS1920, DS2406, DS2407, DS2423, DS2450, DS1921, DS1822, DS2438, DS18B20, DS2408, DS2413, DS18B25. Neue (unbekannte) Sensoren können per individueller Konfiguration ganz einfach selbst hinzugefügt werden.+Standardmäßig unterstützt das Plugin folgende Sensoren: DS2405, DS18S20, DS1920, DS2406, DS2407, DS2423, DS2450, DS1921, DS1822, DS2438, DS18B20, DS2408, DS2413, DS18B25. Neue (unbekannte) Sensoren können per individueller Konfiguration ganz einfach selbst hinzugefügt werden.
  
 Über einen Watchdog wird die Funktion des Plugins permanent überwacht. Bei Problemen wird versucht das Plugin neu zu starten. Über einen Watchdog wird die Funktion des Plugins permanent überwacht. Bei Problemen wird versucht das Plugin neu zu starten.
Zeile 49: Zeile 29:
 Hier konfiguriert man die Software OWFS, die für die 1-Wire-Kommunikation zuständig ist. Über den Button "OWFS WebUI" unten auf der Seite gelangt man direkt zum WebUI von OWFS. Hier konfiguriert man die Software OWFS, die für die 1-Wire-Kommunikation zuständig ist. Über den Button "OWFS WebUI" unten auf der Seite gelangt man direkt zum WebUI von OWFS.
  
-Wähle zunächst aus, welche Busmaster Du mit dem Plugin verwenden möchtest. Du kannst so viele Busmaster an den LoxBerry anschließen, wie es die Leistung Deiner Hardware erlaubt. Auch eine gemischte Installation z. B. aus seriellen und USB-Busmastern ist möglich. **Starte danach den LoxBerry neu!**+Wähle zunächst aus, welche Busmaster Du mit dem Plugin verwenden möchtest. Du kannst so viele Busmaster an den LoxBerry anschließen, wie es die Leistung Deiner Hardware erlaubt. Auch eine gemischte Installation z. B. aus seriellen und USB-Busmastern ist möglich. **Speichere die Einstellungen JETZT ab und starte danach den LoxBerry neu!**
  
-\\+{{:plugins:1_wire_ng:1244332949.png?400}}
  
 +Manche Busmaster können mehrere Busse bedienen. Wähle im nächsten Schritt aus, welche Busse Du verwendest. Gibt es nur einen Bus, dann aktiviere diesen! Nur an aktiven Bussen wird nach Sensoren gesucht! Deaktiviere aber Busse, die Du nicht verwendest, um Ressourcen zu sparen. Über den Button "Show" kannst Du Dir alle gefunden Busse und deren Bezeichnung anschauen.
  
-{{plugins:1_wire_ng:1244332949.png?w=700}} +{{plugins:1_wire_ng:pasted:20250108-180426.png?400}}
- +
-\\ +
  
 Im nächsten Schritt werden die verwendeten Ports der OWFS-Software (owserver und owhttpd) festgelegt. Ändere hier nur etwas, wenn Du unbedingt musst! Im nächsten Schritt werden die verwendeten Ports der OWFS-Software (owserver und owhttpd) festgelegt. Ändere hier nur etwas, wenn Du unbedingt musst!
  
-\\ +{{:plugins:1_wire_ng:1244332950.png?700}}
- +
- +
-{{plugins:1_wire_ng:1244332950.png?w=700}} +
- +
-\\ +
  
 Im nächsten Schritt werden einige Default-Werte festgelegt, die für alle angeschlossenen Sensoren gelten. Du kannst dann später für einzelne Sensoren spezielle Werte (z. B. kürzere Abfrageintervalle) festlegen (siehe unten). Im nächsten Schritt werden einige Default-Werte festgelegt, die für alle angeschlossenen Sensoren gelten. Du kannst dann später für einzelne Sensoren spezielle Werte (z. B. kürzere Abfrageintervalle) festlegen (siehe unten).
  
-Zunächst kannst Du auswählen, in welcher Einheit bei Temperatursensoren die gemessenen Werte zurückgemeldet werden (Celsius oder Fahrenheit). +Zunächst kannst Du auswählen, in welcher Einheit bei Temperatursensoren die gemessenen Werte zurückgemeldet werden (Celsius oder Fahrenheit).
  
-//Refresh Interval Devices// legt fest, in welchem Abstand nach neuen Devices auf dem Bus gesucht werden soll und wie häufig die Konfiguration (z. B. Namen von Sensoren, siehe unten) eingelesen werden. Normalerweise brauchst Du hier keine kürzeren Intervalle als 5 Minuten (300 Sekunden). //Default Refresh Interval Values// legt fest, in welchen Abstand die Sensoren auf dem Bus abgefragt werden sollen. Achte darauf, dass Du bei sehr kurzen Intervallen den Bus stark belastest! Auch macht es wenig Sinn, z. B. Temperatursensoren sekündlich abzufragen. So schnell ändert sich die Temperatur in aller Regel nicht! Auch diese Angabe ist in Sekunden. Standard ist ein Abfrageintervall von 60 Sekunden. Laß es am Besten so und konfiguriere später nur einzelne Sensoren, bei denen Du einen kürzeren Intervall benötigst, individuell (siehe unten).+//Refresh Interval Devices// legt fest, in welchem Abstand nach neuen Devices auf dem Bus gesucht werden soll und wie häufig die Konfiguration (z. B. Namen von Sensoren, siehe unten) eingelesen werden. Normalerweise brauchst Du hier keine kürzeren Intervalle als 5 Minuten (300 Sekunden). //Default Refresh Interval Values// legt fest, in welchen Abstand die Sensoren auf dem Bus abgefragt werden sollen. Achte darauf, dass Du bei sehr kurzen Intervallen den Bus stark belastest! Auch macht es wenig Sinn, z. B. Temperatursensoren sekündlich abzufragen. So schnell ändert sich die Temperatur in aller Regel nicht! Auch diese Angabe ist in Sekunden. Standard ist ein Abfrageintervall von 60 Sekunden. Laß es am Besten so und konfiguriere später nur einzelne Sensoren, bei denen Du einen kürzeren Intervall benötigst, individuell (siehe unten).
  
-//Default Cache Setting// legt fest, ob die Software OWFS seinen internen Cache verwenden soll. Auch damit soll der 1-Wire-Bus entlastet werden. Du solltest standardmäßig den Cache **deaktivierten** (also diese Option anhaken). Insbesondere wenn Du iButton schnell auslesen möchtest, muss diese Option aktiviert werden! Nähere Informationen findest Du hier: [[https://owfs.org/index_php_page_what-is-uncached.html|What is Uncached?]]+//Default Cache Setting// legt fest, ob die Software OWFS seinen internen Cache verwenden soll. Auch damit soll der 1-Wire-Bus entlastet werden. Du solltest standardmäßig den Cache **deaktivierten** (also diese Option anhaken). Insbesondere wenn Du iButton schnell auslesen möchtest, muss diese Option aktiviert werden! Nähere Informationen findest Du hier: [[https://owfs.org/index_php_page_what-is-uncached.html|What is Uncached?]]
  
 Bei //Fake 1-Wire-Devices// können Fake-Sensoren aktiviert werden, die von der Software nur simuliert werden. Das ist in aller Regel nur für Entwickler interessant! Gebe einfach die FamilyID der Sensoren ein, die Du simulieren möchtest. Mehrere Sensoren werden durch Kommata getrennt. Die Sensoren erscheinen in der hier angegebenen Anzahl auf dem Bus 0 und ändern ständig ihre Werte, damit man sie auslesen kann. Bei //Fake 1-Wire-Devices// können Fake-Sensoren aktiviert werden, die von der Software nur simuliert werden. Das ist in aller Regel nur für Entwickler interessant! Gebe einfach die FamilyID der Sensoren ein, die Du simulieren möchtest. Mehrere Sensoren werden durch Kommata getrennt. Die Sensoren erscheinen in der hier angegebenen Anzahl auf dem Bus 0 und ändern ständig ihre Werte, damit man sie auslesen kann.
  
-\\+{{:plugins:1_wire_ng:1276706809.png?600}}
  
 +Nach Abschluss der Konfiguration wird mit "Speichern und neu starten" die Konfiguration gespeichert und OWFS neu gestartet. Wenn Du einen seriellen Busmaster oder den GPIO Busmaster verwendest und erstmals aktiviert hast, ist ein Neustart des LoxBerry erforderlich.
  
-{{plugins:1_wire_ng:1276706809.png?h=250}}+==== Sensoren ====
  
-\\+<WRAP center round tip 100%>
  
 +Im Plugin muss einmalig dieser Tab aufgerufen werden, damit nach neuen Sensoren gescannt wird! **Vorher startet der Dienst "OWFS2MQTT nicht!**
  
-Nach Abschluss der Konfiguration wird mit "Speichern und neu starten" die Konfiguration gespeichert und OWFS neu gestartet. Wenn Du einen seriellen Busmaster oder den GPIO Busmaster verwendest und erstmals aktiviert hast, ist ein Neustart des LoxBerry erforderlich. +</WRAP>
- +
-==== Sensoren ====+
  
 Hier kannst Du für jeden angeschlossenen Sensor auf dem Bus eine individuelle Konfiguration (z. B. das Abfrageintervall) festlegen und zudem einen eindeutigen Namen für jeden Sensor vergeben. Der Name wird auch im MQTT-Topic verwendet. So kannst Du später einen Sensor austauschen (der dann eine andere Seriennummer hat), ohne dass Du Deine Konfiguration in LoxoneConfig anpassen musst. Hier kannst Du für jeden angeschlossenen Sensor auf dem Bus eine individuelle Konfiguration (z. B. das Abfrageintervall) festlegen und zudem einen eindeutigen Namen für jeden Sensor vergeben. Der Name wird auch im MQTT-Topic verwendet. So kannst Du später einen Sensor austauschen (der dann eine andere Seriennummer hat), ohne dass Du Deine Konfiguration in LoxoneConfig anpassen musst.
Zeile 97: Zeile 69:
 Über die Button rechts kannst Du einzelne Sensoren löschen und die individuelle Konfiguration aufrufen. Über die Button rechts kannst Du einzelne Sensoren löschen und die individuelle Konfiguration aufrufen.
  
-\\ +{{:plugins:1_wire_ng:1244332956.png?700}}
- +
- +
-{{plugins:1_wire_ng:1244332956.png?w=700}} +
- +
-\\ +
  
 Zunächst solltest Du für jeden Sensor einen eindeutigen Namen eingeben. Damit wird der Name anstelle der Seriennummer im MQTT-Topic verwendet und Du kannst so später einen defekten Sensor ganz einfach austauschen, ohne dass Du die LoxConfig dazu anpassen musst. Zunächst solltest Du für jeden Sensor einen eindeutigen Namen eingeben. Damit wird der Name anstelle der Seriennummer im MQTT-Topic verwendet und Du kannst so später einen defekten Sensor ganz einfach austauschen, ohne dass Du die LoxConfig dazu anpassen musst.
  
-Du kannst auch (beim Austausch eines Sensors) einfach eine neue Seriennummer (Address) bei einem bestehenden Sensor eingeben. Damit wird die Konfiguration direkt für den neuen Sensor übernommen. Die Eingabe erfolgt dabei mit der bei OWFS üblichen Punkt-Schreibweise FAMILYID.ADDRESS, also z. B. 10.5BB221C2C59A.+Du kannst auch (beim Austausch eines Sensors) einfach eine neue Seriennummer (Address) bei einem bestehenden Sensor eingeben. Damit wird die Konfiguration direkt für den neuen Sensor übernommen. Die Eingabe erfolgt dabei mit der bei OWFS üblichen Punkt-Schreibweise FAMILYID.ADDRESS, also z. B. 10.5BB221C2C59A.
  
 Für eine individuelle Konfiguration aktiviere //Custom Settings//. Für eine individuelle Konfiguration aktiviere //Custom Settings//.
Zeile 115: Zeile 81:
 Möchtest Du bei jedem Abfrageintervall überprüfen, ob der Sensor gerade am Bus hängt, aktiviere //Check Presents//. Das ist z. B. bei iButtons sinnvoll (und auch standardmäßig für iButtons schon aktiviert). Möchtest Du bei jedem Abfrageintervall überprüfen, ob der Sensor gerade am Bus hängt, aktiviere //Check Presents//. Das ist z. B. bei iButtons sinnvoll (und auch standardmäßig für iButtons schon aktiviert).
  
-Unter //Values// gibst Du die Werte des Sensors ein, die Du abfragen möchtest. Mehrere Werte werden durch Kommata getrennt. Welche Werte für den Sensor verfügbar sind, kannst Du entweder direkt über die OWFS WebUI herausfinden (siehe 1-Wire / OWFS) oder auf der folgenden Webseite nachlesen: https://github.com/owfs/owfs-doc/wiki/1Wire-Device-List+Unter //Values// gibst Du die Werte des Sensors ein, die Du abfragen möchtest. Mehrere Werte werden durch Kommata getrennt. Welche Werte für den Sensor verfügbar sind, kannst Du entweder direkt über die OWFS WebUI herausfinden (siehe 1-Wire / OWFS) oder auf der folgenden Webseite nachlesen: [[https://github.com/owfs/owfs-doc/wiki/1Wire-Device-List|https://github.com/owfs/owfs-doc/wiki/1Wire-Device-List]]
  
-\\+{{:plugins:1_wire_ng:1244332961.png?250}}
  
 +==== MQTT ====
  
-{{plugins:1_wire_ng:1244332961.png?h=400}}+Hier werden die MQTT-Einstellungen konfiguriert. Das Plugin setzt zwingend ein installiertes [[:plugins:mqtt_gateway:start|MQTT Gateway Plugin]] voraus (nur LoxBerry 2.0) - bei Loxberry 3.0 ist das MQTT Gateway bereits im Core enthalten. Sämtliche MQTT Einstellungen werden dort konfiguriert. Auf der Plugin-Einstellungsseite kann man daher lediglich das zu verwendende MQTT Topic konfigurieren. Der gewählte Topic wird automatisch im [[:plugins:mqtt_gateway:start|MQTT Gateway Plugin]] bzw. ab LoxBerry 3.0 im [[konfiguration:widget_help:widget_mqtt:]] registriert.
  
-\\+==== Weitere Artikel ====
  
 +Hier findest Du weitere detailliertere Beschreibungen zu einigen Themen:
  
-==== MQTT ==== +{{indexmenu>plugins:1_wire_ng#1}}
- +
-Hier werden die MQTT-Einstellungen konfiguriert.+
  
-Ist auf dem selben LoxBerry das [[plugins:mqtt_gateway:start|MQTT Gateway Plugin]] installiert, können die Einstellungen (Benutzername und Password) direkt von dort übernommen werden. Der gewählte Topic wird automatisch im [[plugins:mqtt_gateway:start|MQTT Gateway Plugin]] registriert. Andernfalls müssen diese Angaben zusammen mit der MQTT Broker-Adresse und dem Port manuell eingegeben werden.+===== FAQ =====
  
-\\+**F: **Kann ich die Sensoren überwachen und bei Bedarf vom Miniserver aus die Services neu starten?
  
 +**A: **Ja, das geht. Überwache dazu das Topic ''owfs/keepaliveepoch'' und/oder ''owfs/plugin'' . Wie das geht findest [[https://loxwiki.atlassian.net/wiki/spaces/LOX/pages/1525056058/nderung+eines+Wertes+erkennen|Du im LoxWiki]]. Die Pluginservices kannst Du mit folgendem Befehl im Browser oder einem Virtuellen Ausgangsbefehl neu starten:
  
-{{plugins:1_wire_ng:1244332965.png?w=700}} +<code -> 
 +http://loxberry:password@loxberry/admin/plugins/1-wire-ng/index.cgi?ajax=restartservices 
 +</code>
  
 ===== Roadmap ===== ===== Roadmap =====
Zeile 144: Zeile 113:
 ===== Links ===== ===== Links =====
  
-  * Unterstütze Sensoren: https://github.com/owfs/owfs-doc/wiki/1Wire-Device-List +  * Unterstütze Sensoren: [[https://github.com/owfs/owfs-doc/wiki/1Wire-Device-List|https://github.com/owfs/owfs-doc/wiki/1Wire-Device-List]] 
-  * OWFS Wiki: https://github.com/owfs/owfs-doc/wiki +  * OWFS Wiki: [[https://github.com/owfs/owfs-doc/wiki|https://github.com/owfs/owfs-doc/wiki]] 
-  * OWFS Homepage: [[https://owfs.org/|https:%%//%%owfs.org]] +  * OWFS Homepage: [[https://owfs.org/|https://owfs.org]] 
-  * Erklärung Cache-Funktion von OWFS: https://owfs.org/index_php_page_what-is-uncached.html +  * Erklärung Cache-Funktion von OWFS: [[https://owfs.org/index_php_page_what-is-uncached.html|https://owfs.org/index_php_page_what-is-uncached.html]] 
-  * 1-Wire im LoxWiki: [[https://loxwiki.atlassian.net/wiki/spaces/LOX/pages/1516634394/1-Wire+Melder+und+Sensoren|1-Wire Melder und Sensoren]] +  * 1-Wire im LoxWiki: [[https://loxwiki.atlassian.net/wiki/spaces/LOX/pages/1516634394/1-Wire+Melder+und+Sensoren|1-Wire Melder und Sensoren]] 
-  * Sehr hilfreiche Übersicht zum Aufsetzen und Analysieren von größeren und verlässlichen 1 Wire Netzwerken (pdf): [[http://neutrino.phys.ksu.edu/~gahs/doublechooz/DC_SlowMRS/AN148.pdf|Guidelines for Reliable 1-Wire Networks]]+  * Sehr hilfreiche Übersicht zum Aufsetzen und Analysieren von größeren und verlässlichen 1 Wire Netzwerken (pdf): [[http://neutrino.phys.ksu.edu/~gahs/doublechooz/DC_SlowMRS/AN148.pdf|Guidelines for Reliable 1-Wire Networks]]
  
 ===== Fragen stellen und Fehler melden ===== ===== Fragen stellen und Fehler melden =====
  
-Im Loxforum in diesem Thread: https://www.loxforum.com/forum/projektforen/loxberry/plugins/227489-plugin-1-wire-ng +Im Loxforum in diesem Thread: [[https://www.loxforum.com/forum/projektforen/loxberry/plugins/227489-plugin-1-wire-ng|https://www.loxforum.com/forum/projektforen/loxberry/plugins/227489-plugin-1-wire-ng]]
- +
-\\ +
- +
- +
-\\ +
- +
  
  
Zeile 167: Zeile 129:
 pluginuebersicht.logo : :plugins:1_wire_ng:1240959460.png pluginuebersicht.logo : :plugins:1_wire_ng:1240959460.png
 pluginuebersicht.status : STABLE pluginuebersicht.status : STABLE
-pluginuebersicht.version : 2.0.5+pluginuebersicht.version : 2.5.1
 pluginuebersicht.min_lb_version : 2.2.1 pluginuebersicht.min_lb_version : 2.2.1
-pluginuebersicht.url_release : https://github.com/mschlenstedt/LoxBerry-Plugin-1-Wire-NG/archive/refs/tags/1-Wire-NG-2.0.5.zip+pluginuebersicht.url_release : https://github.com/mschlenstedt/LoxBerry-Plugin-1-Wire-NG/archive/refs/tags/1-Wire-NG-2.5.1.zip
 pluginuebersicht.url_prerelease :  pluginuebersicht.url_prerelease : 
 pluginuebersicht.description : Das Plugin kann einen an den LoxBerry angeschlossenen 1-Wire-Busmaster auslesen und die Sensorwerte an den Miniserver senden. pluginuebersicht.description : Das Plugin kann einen an den LoxBerry angeschlossenen 1-Wire-Busmaster auslesen und die Sensorwerte an den Miniserver senden.