Anbindung Shelly
Dafür wird auf die Installationsbeschreibung des CCU-Jacks verweisen.
Im CCU-Jack müssen als erstes die virtuellen Geräte aktiviert werden. Nach der Aktivierung muss ein Neustart der CCU durchgeführt werden:
Für die Shelly-Geräte sollte noch ein separater Benutzer im CCU-Jack angelegt werden.
Auf anzubindenden Shelly-Geräten ist der CCU-Jack als MQTT-Server einzustellen. Falls es sich nicht um ein Shelly Pro oder Plus handelt, wird die Cloud-Funktionalität des Gerätes deaktiviert. Als Adresse muss die IP-Adresse der CCU eingetragen werden.
MQTT-Konfiguration eines Shellies Pro oder Plus:
Generic status update over MQTT muss aktiviert melden. Das MQTT-Präfix kann bei Bedarf angepasst werden.
MQTT-Konfiguration eines Shellies der ersten Generation:
Die Topics eines Shelly-Gerätes beginnen, wenn dies in der Gerätekonfiguration nicht geändert worden ist, wie folgt: shellies/Gerätetyp-Seriennr.
Die Seriennummer kann auf der Web-Oberfläche des Shelly-Gerätes unter Settings → Device Info → Device ID ermittelt werden. Es ist die erste Darstellung (in Hex) der Device ID zu verwenden.
Für die Anbindung muss ein virtuelles Gerät mit einem MQTT Dimmmer-Kanal angelegt werden.
Der virtuelle Kanal ist auf der CCU folgendermaßen einzustellen:
| Parameter | Wert | Bemerkungen |
|---|---|---|
| RANGE_MIN | 0.0 | |
| RANGE_MAX | 100.0 | |
| COMMAND_TOPIC | shellies/shellydimmer2-Seriennr./light/0/set | Seriennr. ist mit der Seriennummer des Gerätes zu ersetzen. |
| RETAIN | Nicht Gesetzt | |
| TEMPLATE | {{if eq . 0.0}}{"turn":"off"}{{else}}{"brightness":{{.}},"turn":"on"}{{end}} | |
| FEEDBACK_TOPIC | shellies/shellydimmer2-Seriennr./light/0/status | Seriennr. ist mit der Seriennummer des Gerätes zu ersetzen. |
| PATTERN | {{with parseJSON .}}{{if .ison}}{{.brightness}}{{else}}0{{end}}{{end}} | |
| EXTRACTOR | TEMPLATE | |
| REGEXP_GROUP | 0 | Nicht relevant |
Die Geräteoberfläche in der CCU entspricht der eines realen HM-Dimmers.
Wichtig: RETAIN sollte bei Geräten, die über WLAN angebunden sind, nicht gesetzt werden. Ansonsten kann es zu geisterhaften Schaltungen bei WLAN-Neuverbindungen kommen.
Für den Shelly Dimmer 1 sind leicht geänderte Topics gegenüber den Shelly Dimmer 2 zu verwenden:
| Parameter | Wert | Bemerkungen |
|---|---|---|
| COMMAND_TOPIC | shellies/shellydimmer-Seriennr./light/0/set | Seriennr. ist mit der Seriennummer des Gerätes zu ersetzen. |
| FEEDBACK_TOPIC | shellies/shellydimmer-Seriennr./light/0/status | Seriennr. ist mit der Seriennummer des Gerätes zu ersetzen. |
Sobald sich der Shelly EM3 mit dem eingebetteten MQTT-Server des CCU-Jacks verbunden hat, sollten Nachrichten auf folgenden MQTT-Topics auftauchen:
(Werkzeug: MQTT Explorer)
Hinweis: Die MQTT-Topics können sich je nach Firmware unterscheiden.
Als nächstes ist im CCU-Jack ein virtuelles Gerät mit 9 MQTT-Analogwertempfängern und einem MQTT-Schaltaktor mit Rückmeldung anzulegen:
Nach dem Erstellen erscheint das Gerät im Posteingang der CCU und nach einer weiteren Bestätigung in der Geräteliste. Dort können das Gerät und die Kanäle benannt werden:
Die Kanäle 1 bis 9 müssen folgendermaßen konfiguriert werden:
Liste der Topics für die Kanäle 1 bis 9:
| Kanal | Topic |
|---|---|
| Wirkleistung Phase 1 | shellies/shellyem3-Seriennr./emeter/0/power |
| Blindleistung Phase 1 | shellies/shellyem3-Seriennr./emeter/0/reactive_power |
| Spannung Phase 1 | shellies/shellyem3-Seriennr./emeter/0/voltage |
| Wirkleistung Phase 2 | shellies/shellyem3-Seriennr./emeter/1/power |
| Blindleistung Phase 2 | shellies/shellyem3-Seriennr./emeter/1/reactive_power |
| Spannung Phase 2 | shellies/shellyem3-Seriennr./emeter/1/voltage |
| Wirkleistung Phase 3 | shellies/shellyem3-Seriennr./emeter/2/power |
| Blindleistung Phase 3 | shellies/shellyem3-Seriennr./emeter/2/reactive_power |
| Spannung Phase 3 | shellies/shellyem3-Seriennr./emeter/2/voltage |
Bei Kanal 10 handelt es sich um einen Schaltaktor. Er ist folgendermaßen zu konfigurieren:
Liste der Topics für den Kanal 10 (Schaltaktor):
| Parameter | Topic |
|---|---|
| COMMAND_TOPIC | shellies/shellyem3-Seriennr./relay/0/command |
| FEEDBACK_TOPIC | shellies/shellyem3-Seriennr./relay/0 |
Die Geräteoberfläche sieht dann in der CCU folgendermaßen aus:
Hinweis: Alle analogen Eingänge werden mit der Bezeichnung Eingangsspannung angezeigt, bzw. der Kanalparameter heißt immer VOLTAGE. Dies ist dadurch bedingt, dass die virtuellen Kanäle von einem realen HmIP-MIO16-PCB abgeleitet wurden. Dadurch wird die höchste Kompatibilität zur CCU-Software erreicht.
Im folgenden Bild sind die Verbindungseinstellungen zu finden:
Sobald sich der Shelly Plus 1PM mit dem eingebetteten MQTT-Server des CCU-Jacks verbunden hat, sollten Nachrichten auf folgenden MQTT-Topics auftauchen:
Als nächstes ist im CCU-Jack ein virtuelles Gerät mit einem MQTT-Schaltaktor mit Rückmeldung und z.B. drei MQTT-Analogwertempfängern anzulegen. Je nach Anforderung können aber mehr oder weniger Messwerte angebunden werden. Das Gerät taucht dann im Posteingang der CCU auf und muss folgendermaßen konfiguriert werden. XXXX ist durch die Seriennummer des Gerätes zu ersetzen:
| Kanal | Parameter | Wert |
|---|---|---|
| 1 | TOPIC | shellies/shellyplus1pm-XXXX/status/switch:0 |
| 1 | PATTERN | {{(parseJSON .).apower}} |
| 1 | EXTRACTOR | TEMPLATE |
| 2 | TOPIC | shellies/shellyplus1pm-XXXX/status/switch:0 |
| 2 | PATTERN | {{(parseJSON .).aenergy.total}} |
| 2 | EXTRACTOR | TEMPLATE |
| 3 | TOPIC | shellies/shellyplus1pm-XXXX/status/switch:0 |
| 3 | PATTERN | {{(parseJSON .).temperature.tC}} |
| 3 | EXTRACTOR | TEMPLATE |
| 4 | COMMAND_TOPIC | shellies/shellyplus1pm-XXXX/command/switch:0 |
| 4 | ON_PAYLOAD | on |
| 4 | OFF_PAYLOAD | off |
| 4 | RETAIN | nicht gesetzt |
| 4 | FEEDBACK_TOPIC | shellies/shellyplus1pm-XXXX/status/switch:0 |
| 4 | ON_PATTERN | "output":true |
| 4 | OFF_PATTERN | "output":false |
| 4 | MATCHER | CONTAINS |
Alternativ kann auch das Gen2+ Protokoll für die Ansteuerung verwendet werden. Die meisten Parameter sind identisch zu den obigen. Folgende sind abzuändern:
| Kanal | Parameter | Wert |
|---|---|---|
| 4 | COMMAND_TOPIC | shellies/shellyplus1pm-XXXX/rpc |
| 4 | ON_PAYLOAD | {"id":0, "src":"shellies/shellyplus1pm-XXXX/rpc-response", "method":"Switch.Set", "params":{"id":0,"on":true}} |
| 4 | OFF_PAYLOAD | {"id":0, "src":"shellies/shellyplus1pm-XXXX/rpc-response", "method":"Switch.Set", "params":{"id":0,"on":false}} |
Autor dieses Handbuchs ist Mathias Dzionsko. Dieses Handbuch steht unter folgender Lizenz:
