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:multi_io:start [2023/07/01 19:16] – [Hardware] Michael Schlenstedtplugins:multi_io:start [2024/04/22 14:03] (aktuell) – Struct-Daten geändert Michael Schlenstedt
Zeile 1: Zeile 1:
 ====== Multi-IO ====== ====== Multi-IO ======
- 
-<WRAP center round alert 100%> 
-== Under Construction == 
- 
-Die Dokumentation befindet sich noch im Aufbau. 
-</WRAP> 
  
 Version History... Version History...
Zeile 21: Zeile 15:
 ===== Funktion des Plugins ===== ===== Funktion des Plugins =====
  
-Das Plugin kann mit Hilfe der Software MQTT-IO ([[https://github.com/flyte/mqtt-io]]) verschiedene Hardware-Module am LoxBerry als Ein- und Ausgänge nutzen. Natürlich werden dabei die nativen GPIO-Ports des Raspberry unterstützt, aber auch IO-Expension Module wie das PCF8574 bzw. PCF8575 oder das MCP23017. Mit deren Hilfe können am Raspberry bis zu 256 Ein oder Ausgänge bereitgestellt werden. Des weiteren können verschiedene bekannte Sensoren für den Raspberry, z. B. ADS1x15 analog to digital converters, DHT11/DHT22/AM2302 oder der MCP3008 analog to digital converter integriert werden. Eine vollständige Liste der unterstützten Hardware findet sich auf der Projekt-Homepage: [[https://github.com/flyte/mqtt-io]]+Das Plugin kann mit Hilfe der Software MQTT-IO ([[https://github.com/flyte/mqtt-io]]) verschiedene Hardware-Module am LoxBerry als Ein- und Ausgänge oder als Sensoren nutzen. Natürlich werden dabei die nativen GPIO-Ports des Raspberry unterstützt, aber auch IO-Expander Module wie das PCF8574 bzw. PCF8575 oder das MCP23017. Mit deren Hilfe können am Raspberry mehr als 512(!) Ein oder Ausgänge bereitgestellt werden. Des weiteren können verschiedene bekannte Sensoren für den Raspberry, z. B. ADS1x15 analog to digital converters, DHT11/DHT22/AM2302 oder der MCP3008 analog to digital converter integriert werden. Eine vollständige Liste der unterstützten Hardware findet sich auf der Projekt-Homepage: [[https://github.com/flyte/mqtt-io]]
  
 Das Plugin setzt ein installiertes [[plugins:mqtt_gateway:start|MQTT Gateway Plugin]] voraus (bis LoxBerry 2.2.x), im LoxBerry 3.0.x ist dieses bereits integriert und wird benutzt. Das Plugin setzt ein installiertes [[plugins:mqtt_gateway:start|MQTT Gateway Plugin]] voraus (bis LoxBerry 2.2.x), im LoxBerry 3.0.x ist dieses bereits integriert und wird benutzt.
  
 Ü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.
 +
 +===== Hardware =====
 +
 +Für einige Hardware haben wir spezielle Informationen auf einer eigenen Unterseite zusammengefasst. Die Links findet ihr in den Unterkapiteln weiter unten.
 +
 +<WRAP center round important 100%>
 +
 +== Separater I2C Bus ==
 +
 +Nutzt ihr GPIO Module und/oder Sensoren über den I2C-Bus und verwendet ihr parallel noch andere Plugins, die Hardware am I2C Bus nutzen, empfehle ich Euch dieses Plugin auf einem separaten Bus laufen zu lassen. Auch wenn ihr Module mit identischer Adresse mehrfach verwenden wollt, müsst ihr diese auf separaten Bussen betreiben. Wie man mehrere I2C Busse auf dem Raspberry aktiviert, könnt ihr hier nachlesen: [[howtos_knowledge_base:mehrere_i2c_busse]]
 +
 +</WRAP>
  
 ===== Konfiguration ===== ===== Konfiguration =====
  
-===== Input / Outputs =====+Das Plugin bietet zwei Hauptfunktionen: **Inputs / Outputs** und **Sensoren**.
  
-==== GPIO Module ====+Wie der Name schon sagt können über "Inputs / Outputs" beliebig viele Ein- und Ausgänge konfiguriert werden. Diese müssen natürlich über entsprechende Hardwaremodule auch physikalisch vorhanden sein. Der Raspberry bringt schon einige Ein- und Ausgänge mit (GPIOs), weitere können über sogenannte GPIO Expander hinzugefügt werden. 
 + 
 +Im Tab "Sensoren" können verschiedene gängige Sensoren wie z. B. Analog-Digital-Wandler, Ultraschallsensoren oder auch Luftgütesensoren an den Raspberry angebunden werden. 
 + 
 +==== Input / Outputs ==== 
 + 
 +Zunächst muss ein entsprechendes GPIO Modul eingerichtet werden. Es definiert die Hardware, über die die Ein- und Ausgänge zur Verfügung gestellt werden. Ein Beispiel wäre die Raspberry GPIO Leiste und deren PINs. Das Plugin unterstützt aber noch zahlreiche weitere Möglichkeiten zusätzliche Ein- und Ausgänge zur Verfügung zu stellen. Dazu werden sogenannte GPIO Expander Module an den I2C Bus des Raspberry angeschlossen. Diese bieten meist 8 oder 16 weitere GPIOs. Durch Kombination mehrerer dieser Module und Verwendung von mehreren I2C-Bussen am Raspberry können quasi unendlich viele Ein- und Ausgänge am Raspberry angeschlossen werden. 
 + 
 +Anschließend können die am GPIO Modul zur Verfügung stehenden einzelnen Ein-/Ausgänge (PINs) konfiguriert werden. 
 + 
 +=== GPIO Module === 
 + 
 +Ein neues GPIO Modul wird über den ''Add'' Button hinzugefügt. Es öffnet sich die Konfigurationsseite für das Modul, wo meist weitere Einstellungen getroffen werden müssen. Folgende GPIO-Module stehen im Plugin zur Verfügung - die Konfiguration findet ihr auf der jeweiligen Unterseite:
  
 {{indexmenu>plugins:multi_io:gpio_module#1}} {{indexmenu>plugins:multi_io:gpio_module#1}}
  
-===== Hardware =====+{{plugins:multi_io:pasted:20230729-120540.png?300}}  {{plugins:multi_io:pasted:20230729-120614.png?600}}
  
-Für einige Hardware haben wir spezielle Informationen auf einer eigenen Unterseite zusammengefasst. Gerne erweitern oder ergänzen!+=== Ein- / Ausgänge ===
  
-<WRAP center round important 100%> +Nachdem ein GPIO Modul eingerichtet wurde, können für dieses Modul Ein- und Ausgänge konfiguriert werden. Jeder GPIO kann dabei entweder als Eingang oder als Ausgang eingerichtet werden. Die Einrichtung unterscheidet sich je nach GPIO Modul - weitere Details findet ihr auf den Unterseiten der jeweiligen GPIO Module:
-== Separater I2C Bus ==+
  
-Nutzt ihr GPIO Module und/oder Sensoren über den I2C-Bus und verwendet ihr parallel noch andere Plugins, die Hardware am I2C Bus nutzenempfehle ich Euch dieses Plugin auf einem separaten Bus laufen zu lassenAuch wenn ihr Module mit identischer Adresse mehrfach verwenden wolltmüsst ihr diese auf separaten Bussen betreibenWie man mehrere I2C Busse auf dem Raspberry aktiviertkönnt ihr hier nachlesen[[howtos_knowledge_base:mehrere_i2c_busse]] +{{indexmenu>plugins:multi_io:gpio_module#1}} 
-</WRAP>+ 
 +{{:plugins:multi_io:gpio_module:pasted:20230729-122544.png?400}}{{:plugins:multiio:gpio_module:1703280671.png?400}} 
 + 
 +==== Sensors ==== 
 + 
 +Bei den Sensoren folgt dass Plugin der Logik wie bei den Ein-/Ausgängen: Zunächst wird ein Sensor-Modul angelegtwelches die angeschlossene Hardware beschreibt und konfiguriert. Anschließend werden pro Sensormodul entsprechende Eingänge angelegtdie die Sensordaten beschreibenJe nach Modul bzw. Sensor können das mehrere Eingänge (z. B. Luftfeuchtigkeit und Temperatur) sein oder auch nur ein Eingang. 
 + 
 +=== Sensor Module === 
 + 
 +Ein neues Sensor Modul wird über den ''Add'' Button hinzugefügt. Es öffnet sich die Konfigurationsseite für das Modulwo meist weitere Einstellungen getroffen werden müssen. Folgende Sensor-Module stehen im Plugin zur Verfügung - die Konfiguration findet ihr auf der jeweiligen Unterseite: 
 + 
 +{{indexmenu>plugins:multi_io:sensor_module#1}} 
 + 
 +{{plugins:multi_io:pasted:20230730-170703.png?400}} {{plugins:multi_io:pasted:20230730-170802.png?350}} 
 + 
 +=== Sensor Eingänge === 
 + 
 +Nachdem ein Sensor-Modul eingerichtet wurdekönnen für dieses Modul Eingänge konfiguriert werden. Je nach Sensor kann es mehrere Eingänge geben (z. B. Temperatur und Luftfeuchtigkeit). Die Einrichtung unterscheidet sich je nach Sensor Modul - weitere Details findet ihr auf den Unterseiten der jeweiligen Sensor Module
 + 
 +{{indexmenu>plugins:multi_io:sensor_module#1}} 
 + 
 +{{plugins:multi_io:pasted:20230730-175250.png?400}} {{plugins:multi_io:pasted:20230730-175321.png?400}}
  
 ===== Roadmap ===== ===== Roadmap =====
  
-Blah+<do prof.mobilux>MQTT Settings (Topic)</do>
  
-===== Links =====+<do prof.mobilux>Alle Sensormodule integrieren</do>
  
-  * Unterstütze Hardware und Sensoren: [[https://mqtt-io.app/2.2.6/#/?id=supported-hardware]] +<do prof.mobilux>Deutsche Übersetzung</do>
-  * MQTT-IO Anleitung: [[https://mqtt-io.app/2.2.6/#/]]+
  
-===== Fragen stellen und Fehler melden =====+===== Links =====
  
-Im Loxforum in diesem Thread+  * Unterstütze Hardware und Sensoren[[https://mqtt-io.app/#/?id=supported-hardware]] 
 +  * MQTT-IO Anleitung: [[https://mqtt-io.app/#/]]
  
-\\+===== Fragen stellen und Fehler melden =====
  
-\\+Im Loxforum in diesem Thread: [[https://www.loxforum.com/forum/projektforen/loxberry/plugins/395534-plugin-multi-io-plugin-mehr-als-512-ein-ausg%C3%A4nge-sensoren-am-loxberry]]
  
  
Zeile 66: Zeile 104:
 pluginuebersicht.author : prof.mobilux pluginuebersicht.author : prof.mobilux
 pluginuebersicht.logo : :plugins:multi_io:1702985775.png pluginuebersicht.logo : :plugins:multi_io:1702985775.png
-pluginuebersicht.status : ALPHA +pluginuebersicht.status : STABLE 
-pluginuebersicht.version : 0.9.0+pluginuebersicht.version : 1.0.2
 pluginuebersicht.min_lb_version : 2.2.2 pluginuebersicht.min_lb_version : 2.2.2
-pluginuebersicht.url_release :  +pluginuebersicht.url_release : https://github.com/mschlenstedt/LoxBerry-Plugin-MultiIO/archive/refs/tags/LoxBerry-Plugin-MultiIO-1.0.2.zip 
-pluginuebersicht.url_prerelease : https://github.com/mschlenstedt/LoxBerry-Plugin-MultiIO/archive/refs/tags/LoxBerry-Plugin-MultiIO-0.9.0.zip+pluginuebersicht.url_prerelease : 
 pluginuebersicht.description : Das Plugin kann verschiedene Hardware-Module als Ein- und Ausgänge am LoxBerry konfigurieren sowie einige Sensoren einbinden. pluginuebersicht.description : Das Plugin kann verschiedene Hardware-Module als Ein- und Ausgänge am LoxBerry konfigurieren sowie einige Sensoren einbinden.
 pluginuebersicht.languages : EN pluginuebersicht.languages : EN
-pluginuebersicht.discussion : +pluginuebersicht.discussion : https://www.loxforum.com/forum/projektforen/loxberry/plugins/395534-plugin-multi-io-plugin-mehr-als-512-ein-ausg%C3%A4nge-sensoren-am-loxberry
 ---- ----