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/29 12:06] – 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 23: 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.
Zeile 51: Zeile 43:
 ==== Input / Outputs ==== ==== 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 eingeschlossen. 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.+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. Anschließend können die am GPIO Modul zur Verfügung stehenden einzelnen Ein-/Ausgänge (PINs) konfiguriert werden.
Zeile 57: Zeile 49:
 === GPIO Module === === 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:+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}}
  
 {{plugins:multi_io:pasted:20230729-120540.png?300}}  {{plugins:multi_io:pasted:20230729-120614.png?600}} {{plugins:multi_io:pasted:20230729-120540.png?300}}  {{plugins:multi_io:pasted:20230729-120614.png?600}}
 +
 +=== Ein- / Ausgänge ===
 +
 +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:
 +
 +{{indexmenu>plugins:multi_io:gpio_module#1}}
 +
 +{{: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 angelegt, welches die angeschlossene Hardware beschreibt und konfiguriert. Anschließend werden pro Sensormodul entsprechende Eingänge angelegt, die die Sensordaten beschreiben. Je 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 Modul, wo 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 wurde, kö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 84: 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.1+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.1.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
 ---- ----