Zur Vorgeschichte:
Meinen ersten Shelly nutze ich dazu, mein Garagentor über SmartVISU zu öffnen; es gibt zwar eine eigene App, wie zu allen Smart Home Devices, aber wozu sollte ich für jedes Device eine andere App benutzen. 

Zunächst musste ich natürlich den Shelly elektrisch anschließen; hierzu gibt es auch schon reichlich Diskussionen in diversen Foren. Ich habe mich für folgende einfache Lösung entschieden und meinen Shelly, wie den Tastschalter oder den Schlüsselschalter angeschlossen.

Da Shelly keine spezielle Taster Funktion kennt, habe ich den Schalter über die App wie ein Treppenlicht konfiguriert; Nach der Betätigung des Schalters wird nach einer Sekunde wieder ausgeschaltet. Das funktioniert dann zunächst schon mal über die App ganz prima.

In SmarthomeNG habe ich dann mein Item wie folgt konfiguriert:

Tor:
name: Tor
enforce_updates: true
type: bool
visu: ‚yes‘
sv_widget: „{{ basic.stateswitch(‚item‘, ‚item‘, ‚midi‘, 1, “, “, “, ‚blink‘) }}“

Ohne MQTT habe ich dann einfach eine Logik implementiert, die bei jedem Klick getriggert wird:

/etc/logic.yaml

Garagentor:
filename: Garage.py
watch_item: Aussen.Garage.Tor

/logics/Garage.py

# Shelly1
# Garagentor

import urllib.request

myurl = „http://192.168.178.28/relay/0?turn=on“

req = urllib.request.urlopen(myurl)
logger.info(„Garagentor“)

Damit funktioniert das ganze „zu Fuß“ und ohne MQTT und Shelly Plugin in SmarthomeNG 1.5

Vorbereitungen in SmarthomeNG 1.7

Zunächst mal muss MQTT aufgesetzt werden; dies habe ich natürlich, dank „Onkelandy“ über das setup_all script gemacht.

Wer nicht das Image benutz muss dann anhand der Komplettanleitung den mosquitto Broker installieren und konfigurieren.

Danach muss MQTT als Modul aktiviert werden; mit 1.7 ist MQTT in den Core gewandert und wird wie folgt aktiviert:

/etc/module.yaml

mqtt:
module_name: mqtt
broker_monitoring: true

Als einzigen Parameter habe ich das Monitoring eingeschaltet, damit man über das Web GUI die Aktivitäten verfolgen kann.

Dann wir das Shelly Plugin aktiviert:

/etc/plugin.yaml

Shelly:
plugin_name: shelly

Hier gibt es keinerlei Parameter.

Das Shelly Plugin wird über Item-Parameter getriggert, deshalb habe ich Folgendes in meinem Garagentor Item ergänzt:

Tor:
name: Tor
shelly_id: 8CAAB505559E
shelly_type: shelly1
shelly_attr: relay
shelly_relay: 0
enforce_updates: true
type: bool
sv_widget: „{{ basic.stateswitch(‚item‘, ‚item‘, ‚midi‘, 1, “, “, “, ‚blink‘) }}“

(Hier hatte ich den Fehler gemacht und shelly_ID definiert, was mich zwei Stunden gekostet hat)

Danach erscheint dann (fast) alles im Web-GUI.

Zunächst die Definitionen im Item:

Ob der Broker läuft findet Ihr dann unter dem Tab: Broker Information:

wenn nicht, schaut bitte in Eure Konfiguration, ob MQTT enabled ist:

In der GUI des Shelly Plugin findet Ihr aber zunächst nichts, oder nur den Namen des Devices.

Jetzt geht’s wieder zur Shelly App um die Broker Verbindung zu konfigurieren. In der SmarthomeNG Konfiguration seht Ihr im letzten Screenshot, dass der MQTT Broker auf dem SmarthomeNG Rechner läuft und auf den Port 1883 hört. Das müsst Ihr jetzt noch dem Shelly Device beibringen. (In der Shelly App):

Zunächst müsst Ihr den haken bei „Enable action execution via MQTT“ und dann noch unter Server: wo und wie er zu erreichen ist. (IP-Adresse des Raspi und Port 1883).

Selbstverständlich kann ich weiterhin mein Garagentor über die HTTP Logik im 1.5er System öffnen und auch über die Shelly App (hier aber nicht mehr über die Cloud, wie Ihr es in der WARNING findet)

Danach ist dann Eure Konfiguration komplett und das Shelly Device auch im Shelly Plugin zu finden:

Diese ganzen Zusammenhänge müssen erst mal verstanden werden, ehe man eine solche Konfiguration aufsetzen kann. Deshalb habe ich das hier mal zusammengestellt, weil das so nicht aus der Dokumentation hervor geht.

Viel Spaß mit Euren Shelly Devices. Wie Ihr andere Devices mit mehr Funktionen konfiguriert und wie ich sie über SmartVISU administriere, beschreibe ich (vielleicht) in weiteren Blogs.

Bisher war in SmartHomeNG das eigentliche MQTT Protokoll im mqtt Plugin implementiert.

In SmartHomeNG v1.7 wurde die Unterstützung des eigentlichen MQTT Protokolls in den Core verlagert. Die Implementierung erfolgte als ein ladbares Modul. Es gibt nun ein neues mqtt Plugin, welches die Protokoll Unterstützung des Core nutzt.

Diese Änderung bringt neue Funktionalitäten mit sich:

• Logiken können das MQTT Protokoll nutzen. Wie das genau geht, ist in der Anwender Dokumentation zu SmartHomeNG beschrieben.
• Weitere Plugins können das MQTT Protokoll nutzen und darauf aufbauend Payload-Protokolle zu verschiedenen Devices implementieren, ohne das eigentliche MQTT Protokoll selbst implementieren zu müssen. Ein Beispiel hierfür ist das shelly Plugin, welches mit SmartHomeNG v1.7 hinzugekommen ist und die einfache Ansteuerung verschiedener Shelly Devices über MQTT ermöglicht. Details zu diesem Plugin sind in der Anwender Dokumentation zu SmartHomeNG beschrieben.

Konfiguration des MQTT Moduls

Durch die Verlagerung in den Core, ist auch die Konfiguration des MQTT Protokolls an eine andere Stelle gewandert. Die Konfiguration kann über die graphische Oberfläche oder direkt in der entsprechenden Konfigurationsdatei erfolgen:

In der GUI finden sich die Einstellungen unter System/Konfiguration im Tab MQTT Modul:

Damit die Konfiguration wirksam wird und das MQTT Modul beim Restart von SmartHomeNG geladen wird, muss der Parameter enabled auf true gesetzt werden.

Alternativ kann die Konfiguration direkt in der Datei ../etc/module.yaml erfolgen. In der Datei muss ein Abschnitt mqtt: angelegt werden, der einen Eintrag module_name: mqtt enthält. In diesem Abschnitt können dann die Parameter konfiguriert werden.

Beispiel:

mqtt:
    module_name: mqtt
    # broker_host: smarthomeng.local
    broker_monitoring: true
    # qos: 1
    # acl: ''
    last_will_topic: devices/shng-module/$online
    last_will_payload: 'False'
    birth_topic: devices/shng-module/$online
    birth_payload: 'True'
    # bool_values: ['Falsch', 'Wahr']
    # user: user
    # password: geheim

Konfiguration des MQTT Plugins

Die Funktionalität, die das MQTT Plugin zur Verfügung stellte, gibt es weiterhin. Das MQTT Plugin ist entsprechend angepasst worden und nutzt zur Kommunikation jetzt die MQTT Unterstützung des Core. Das Plugin hat jedoch keine Parameter mehr, die konfiguriert werden müssten. Die Item Attribute (mqtt_topic, mqtt_topic_in, mqtt_topic_out, etc.) sind unverändert erhalten geblieben.

Eine Konfiguration des mqtt Plugins in der Plugin Konfigurationsdatei ../etc/plugin.yaml sieht folgendermaßen aus:

mqtt:
    plugin_name: mqtt