FHEMWiki - Benutzerbeiträge [de]

Sonoff

2017-01-15T23:02:07Z

ThomasRamm: /* MQTT testen */

'''sonoff, dieser Artikel beschreibt die Ankopplung der kostengünstigen sonoff Module an FHEM mit ESPEasy oder MQTT.'''
{{Randnotiz|RNTyp=Fehl|RNText=Achtung: Arbeiten mit Netzspannung kann lebensgefährlich sein und darf nur von autorisiertem Fachpersonal durchgeführt werden!}}

Seit einiger Zeit werden von der [https://www.itead.cc/sonoff-wifi-wireless-switch.html Fa. Itead] kostengünstige "sonoff" Produkte angeboten die glücklicherweise den [http://dl.itead.cc/IM151116002/0A-ESP8266_Specifications_v4.1.pdf ESP8266 Chip] On Board haben und somit die ideale Grundlage für [http://www.esp8266.nu/index.php/Main_Page ESPEasy] und für [https://forum.fhem.de/index.php/board,46.0.html Fhem] darstellen.

'''Nützliche Links zum Hersteller:'''

[https://www.itead.cc/blog/user-guide-for-sonoff-slampher User Manual von Itead]

[https://www.itead.cc/wiki/images/6/6b/Sonoff_schmatic.pdf Sonoff Schaltplan]
<div style="clear:both;"></div>

=Hardware=
'''Bitte unbedingt die elektrotechnischen Sicherheitsrichtlinien beachten und einhalten!'''
<div style="clear:both;"></div>
[[Datei:sonoff_sw_15.jpg|thumb|left|alt=Warnung Netzspannung]]
<div style="clear:both;"></div>
'''Achtung: An dem Modul liegt Netzspannung an die lebensgefährlich ist. Es dürfen nur entsprechend ausgebildete Personen dieses Modul in Betrieb nehmen. Zum Umbau und zur Softwareaktualisierung darf keine Netzspannung angeschlossen sein'''

Wie gefährlich das hantieren mit Netzspannung sein kann, wird hier am Beispiel eines [http://mysku.ru/blog/china-stores/45762.html russischen Anwenders] gezeigt, der hat beim Flashen die Netzspannung am Modul gelassen und somit über die Verbindung mit dem Netzteil des Laptop lebensgefährliche Spannung auf die FTDI Schnittstelle gebracht. Das Modul ist dabei abgeraucht!

==Modelle==

===Produktübersichtsliste sonoff===

{| class="wikitable" style="text-align:right"
! Produkt Name !! Beschreibung !! Spannungsversorgung !! Imax !! Pmax !! Frequenz !! Schaltplan !! Link
|-
| Sonoff || Wireless control switch || 90~250V AC || 10A || 2200W || 2.4Ghz || [http://wiki.iteadstudio.com/Sonoff Plan] || [https://www.itead.cc/smart-home/sonoff-wifi-wireless-switch.html Link]
|-
| Sonoff RF || 433 RF remote || 90~250V AC || 10A || 2200W || 2.4Ghz || [http://wiki.iteadstudio.com/Sonoff_RF Plan] || [https://www.itead.cc/smart-home/im151116003.html Link]
|-
| Sonoff SV || Low voltage Input || 5~24V DC || 10A || 240W DC || 2.4Ghz || [http://wiki.iteadstudio.com/Sonoff_SV Plan] || [https://www.itead.cc/smart-home/sonoff-sv.html Link]
|-
| Sonoff TH10/TH16 || Monitor and set Temp.&Hum. || 90~250V AC || 10A/16A || 2200W(10A)/3500W(16A) || 2.4Ghz || [http://wiki.iteadstudio.com/Sonoff_TH_10/16 Plan] || [https://www.itead.cc/smart-home/sonoff-th.html Link]
|-
| Sonoff Dual || Remote control 2 devices || 90~250V AC || 16A || 3500W || 2.4Ghz || [https://www.itead.cc/wiki/Sonoff_Dual Plan] || [https://www.itead.cc/sonoff-dual.html Link]
|-
| Sonoff Pow || Report power &power usage || 90~250V AC || 16A || 3500W || 2.4Ghz || [https://www.itead.cc/wiki/Sonoff_Pow Plan] || [https://www.itead.cc/sonoff-pow.html Link]
|-
| Sonoff LED || WiFi Control Dimming LED || 180~265V AC || 0.3-0.6A || 42W || 2.4Ghz || kein || [https://www.itead.cc/sonoff-led.html Link]
|-
| Sonoff Touch || WiFi wall touch switch || 90~250V AC || 2A || 400W || 2.4Ghz || kein || [https://www.itead.cc/sonoff-touch.html Link]
|-
| Slampher || Wireless control light holder || 90~250V AC || 2A || 200W || 2.4Ghz || [http://wiki.iteadstudio.com/Slampher Plan] || [https://www.itead.cc/smart-home/slampher-wifi-wireless-light-holder.html Link]
|-
| S20 Smart Socket || Smart socket || 90~250V AC || 10A || 2000W || 2.4Ghz || kein || [https://www.itead.cc/smart-home/smart-socket-eu.html EU-Stecker]
|-
| iFan || Smart fan || 185~264V AC ||﹤1A || 60W || 2.4Ghz || kein || [https://www.itead.cc/smart-home/smart-socket-eu.html EU-Stecker]
|-
| Motor/Pump Control Switch || clockwise/anticlockwise running || 5V/7~32V DC || 10A || 50~320W || 2.4Ghz || kein || [https://www.itead.cc/smart-home/motor-reversing-wifi-wireless-switch.html Link]
|-
| 1 Chnl Inching/self-locking Switch || Access control || 5V/12V DC || 10A || 50/120W || 2.4Ghz || kein || [https://www.itead.cc/smart-home/inching-self-locking-wifi-wireless-switch.html Link]
|-
| 4 Chnl Inching/self-locking/inter-locking Switch || Access control, rolling door control || 5V/5~32V DC/90~250V AC || 10A || 50~320W/2500W || 2.4Ghz || kein || [https://www.itead.cc/ifan.html Link]
|-
|   || || || || || || ||
|-
|}

Eine Übersichtliste der verschiedenen Produkte mit technischen Kurzangaben.
<div style="clear:both;"></div>''

===Model: IM151116002: Erstes Modell===
[https://www.itead.cc/sonoff-wifi-wireless-switch.html Sonoff WiFi Wireless Smart Switch for MQTT COAP Smart Home]
[[Datei:sonoff_sw_0.jpg|thumb|left|alt=sonoff Switch]]
<div style="clear:both;"></div>
Das sonoff Modul ist in einem zweckmäßigen und gefälligem Gehäuse verbaut!

====Platine====
[[Datei:sonoff_sw_1.jpg|thumb|left|alt=sonoff Switch von vorne]]

Die Platine ist sehr übersichtlich aufgebaut und der Hersteller hat auch alle Vorbereitungen zum Flashen einer alternativen Software vorgesehen (über serielle Schnittstelle via FTDI-Modul). Mit einer alternativen Software wie ESPEasy ist eine direkte Ankopplung des '''sonoff''' an FHEM somit ein leicht durchführbarer Vorgang.
<div style="clear:both;"></div>

[[Datei:sonoff_sw_3.jpg|thumb|left|alt=sonoff Switch von hinten]]
Die stromführenden Leitungen wurden mit Lötzinn vom Hersteller verstärkt um die angegebenen Stromstärken mit geringer Hitzeentwicklung zu transportieren.

'''Achtung: Bitte vor den Arbeiten kontrollieren, das an der Platine keine Netzspannung angeschlossen ist, LEBENSGEFAHR!'''
<div style="clear:both;"></div>''

<div style="clear:both;"></div>''

===Model: IM160712005: TH 10A/16A ===
[https://www.itead.cc/sonoff-th.html Sonoff TH 10A/16A WiFi Smart Switch]

====TH10 / TH16 weitere GPIO zugänglich machen====
[[Datei:Sonoff_TH_10A-16A_kleiner.jpg|thumb|left|alt=TH10 / TH16 weitere GPIO zugänglich machen]]
Der Hersteller hat zwar schon Platine für eine weitere Stiftleiste vorbereitet, jedoch muss diese noch bestückt werden. Die nicht beschalteten Stifte können dann genutzt werden um die "verdeckten" GPIO zugänglich zu machen. Die Verdrahtung kann dem Bild entnommen werden.<br>
'''Achtung: Bitte vor den Arbeiten kontrollieren, das an der Platine keine Netzspannung angeschlossen ist, LEBENSGEFAHR!'''
<div style="clear:both;"></div>''

<div style="clear:both;"></div>''

===Model: IM160811001: Sonoff Dual ===
[https://www.itead.cc/sonoff-dual.html Sonoff Dual WiFi Wireless Smart Swtich]

<div style="clear:both;"></div>''

<div style="clear:both;"></div>''

===Model: IM160810001: Sonoff Pow ===
[https://www.itead.cc/sonoff-pow.html Sonoff POW WiFi Switch with Power Consumption Measurement]
[[Datei:sonoff_sw_30.jpg|thumb|left|alt=SONOFF POW]]Ein sehr interessantes und kostengünstiges Modul zur Messung der aktuellen Leistung. Das Modul kann via MQTT in Fhem angebunden werden.

Ein Beispiel zur Einbindung ist [http://www.fhemwiki.de/wiki/Sonoff#Sonoff_POW_einrichten hier unten] im Wiki beschrieben.

<div style="clear:both;"></div>
===Model: weitere Modelle===
[https://www.itead.cc/search/result/?cat=&q=sonoff Sonoff Weitere Modelle finden sich auf der Homepage des Hersstellers]

==Vorbereitungen zum Flashen==
[[Datei:sonoff_sw_2.jpg|thumb|left|alt=serielle Schnittstelle]]

Hier auf der Platine sind die benötigten Signale für ein FTDI Modul schon vorhanden. Der quadratische Pin gleich über dem Taster ist die Spannungsversorgung zum Flashen vom FDTI von 3.3V Es muss daher unbedingt ein FTDI Modul genommen werden, dass nicht nur einen Jumper für 3.3V besitzt sondern auch die Spannung auf 3.3V herab setzt. Ist dies nicht der Fall, läuft man Gefahr das Modul unbrauchbar zu machen. Es ist daher zu empfehlen einen Spannungsteiler mit 2 Widerständen oder einen Pegelwandler zwischenschalten.
<div style="clear:both;"></div>

==Signale der Schnittstelle==
von oben nach unten auf der Steckerleiste des sonoff U4 (Model: IM151116002).

Pin5 = vorbereitet für GPIO
Pin4 = Masse
Pin3 = TxD
Pin2 = RxD
Pin1 = 3.3V

Siehe dazu auch den [https://forum.fhem.de/index.php/topic,55036.0.html Link aus dem Forum]:
<div style="clear:both;"></div>

==Platine mit Stiftleiste bestücken==
[[Datei:sonoff_sw_4.jpg|thumb|left|alt=Platine mit Stiftleiste bestücken]]
Der Hersteller hat zwar schon die Platine vorbereitet, jedoch muss sie noch mit einer Stiftleiste bestückt werden um das FTDI Modul bequem verbinden zu können. Nachdem einmal ESPEasy geflasht worden ist, kann es in Zukunft via WEB (OTA) geflasht werden und die Stiftleiste ist dann nicht mehr erforderlich. Aufgrund der geringen Kosten fällt dies jedoch nicht ins Gewicht.<br>
Für die Module TH10/TH16 sind die Lötpunkte für die Stiftleiste schon beschriftet. Die Stiftleiste selber muss allerdings auch nachgerüstet werden.
<div style="clear:both;"></div>''
'''''Achtung''': Bitte vor den Arbeiten kontrollieren, das an der Platine keine Netzspannung angeschlossen ist, LEBENSGEFAHR!
<div style="clear:both;"></div>''

=Software=
==ESPEasy flashen==
[[Datei:sonoff_sw_6.jpg|thumb|left|alt=sonoff mit angestecktem FDTI Adapter]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier geht es ausschließlich um die Software ESPEasy an den sonoff Modulen! }}
Die Spannungsversorgung des sonoff Moduls wird hier vom FTDI Konverter mit 3.3V über die Verbindungskabel zum Pfostenstecker durchgeführt.

Der FTDI Adapter wird dann mit der USB Schnittstelle mit dem Computer verbunden.

Zum compilieren wird in der Arduino Umgebung auch die ArduinoJson library 5.6.4+ benötigt. Eine genaue Anleitung kann [https://forum.fhem.de/index.php/topic,55728.msg473220.html#msg473220 hier] nachgelesen werden. Im Gegensatz zu Arends Sketch für die MQTT Umgebung genügt hier die Arduino IDE 1.6.9. Für die Sketches von Arends empfiehlt sich Arduino IDE >=1.6.12

<div style="clear:both;"></div>

===mit Arduino compilieren===
[[Datei:sonoff_sw_10.jpg|thumb|left|alt=Einstellung Arduino IDE]]
Wer selber mit der Arduino IDE compilieren will bitte folgende Einstellungen beachten. Die anschließenden Arbeiten sind dann gleich wie bei Abschnitt '''fertige Binary'''.

Unbedingt die neueste [https://github.com/bblanchon/ArduinoJson Arduino Json Library] benutzen (siehe oben)! Es gibt zwar keine Compilerfehler, aber es kommt anschließend zu Fehlfunktionen in der ESP Bridge!

<div style="clear:both;"></div>
Generic ESP8266 Module
Flash Mode: QIO
Flash Frequency: 40 MHz
CPU Frequency: 80 MHz
Flash Size: 1M (64K SPIFFS)
Debug Port: disabled
Debug Level: none
Reset Mode: ck
Upload Speed: 115200
<div style="clear:both;"></div>
===fertige Binary flashen===
[[Datei:sonoff_sw_7.jpg|thumb|left|alt=NodeMCU Firmware Flasher]]
Es empfiehlt sich eine fertige Binary von ESPEasy aufzuspielen. In diesem Wiki wurde R140 verwendet.

Siehe dazu auch den [http://www.esp8266.nu/index.php/Main_Page Link von ESPEasy] und das [https://learn.adafruit.com/building-and-running-micropython-on-the-esp8266/flash-firmware Handbuch] für den Flasher.

In manchen Versionen von ESPEasy (zB.R120) ist auch ein Flasher beigelegt, welcher zwar keine grafische Oberfläche hat aber hervorragend funktioniert. Wenn andere versagen, geht es mit diesem Flasher immer noch, einfach probieren!

<div style="clear:both;"></div>
Netzspannung darf 'NICHT' angeschlossen sein!!!
Taster am Sonoff gedrückt halten
FTDI Adapter verbinden
Taster am Sonoff los lassen
Sketch übertragen
Sonoff vom FTDI trennen
<div style="clear:both;"></div>
Wenn einmal die Firmware auf das sonoff Modul geflasht worden ist, kann in Zukunft ESPEasy direkt unter Tools via HTTP dies durchführen. Es muss dazu kein FTDI Konverter mehr verwendet werden.

==ESPEasy==
[[Datei:sonoff_sw_11.jpg|thumb|left|alt=ESPEasy Devices]]
Wenn das Modul fertig geflasht ist und die Verbindung zum Modul hergestellt ist, können die Einstellungen in ESPEasy durchgeführt werden.
Dazu am Webinterface anmelden und zunächst die zwei Devices definieren.

Der Hersteller hat für das '''Relaise GPIO 12''' und für die '''grüne Led GPIO 13''' vorgesehen. Der '''Taster ist an GPIO 0''' angeschlossen.
<div style="clear:both;"></div>

===Device Schalter===
[[Datei:sonoff_sw_12.jpg|thumb|left|alt=Device Relais]]
Bei den Devices sollten die hier dargestellte Einstellungen beachtet werden. Der Switch (PUMP) sollte auf Input gestellt werden, sodass die anschließenden und benötigten Rules aktiviert werden können.

Da beide Devicenamen gleich benannt wurden (PUMP) wird in Fhem nur ein Device angelegt! Die dazugehörenden Valuenames sind unterschiedlich (Relay, Key).

<div style="clear:both;"></div>

===Device Taster===
[[Datei:sonoff_sw_13.jpg|thumb|left|alt=Device Key]]
Der Taste muss natürlich nur konfiguriert werden, wenn auch händisch am Modul geschaltet werden soll. Wird dies nicht benötigt, können auch die Rules geändert bzw. angepasst werden. Doch alleine zu Testzwecken ist es eine nützliche Sache.
<div style="clear:both;"></div>

===Rules===
[[Datei:sonoff_sw_14.jpg|thumb|left|alt=Rules]]
Da das sonoff Modul auch einen eingebauten Taster hat und somit auch lokal bedient werden kann, sollte man zunächst unter '''Tools / Advanced das Häckchen Rules''' aktivieren, erst dann wird der Tab sichtbar und es können Rules erstellt werden.
<div style="clear:both;"></div>

on PUMP#Key do
if [PUMP#Relay]=1
gpio,12,0
else
gpio,12,1
endif
endon
on PUMP#Relay do
if [PUMP#Relay]=1
gpio,13,0
else
gpio,13,1
endif
endon
Diese Rules ermöglichen, das bei lokaler Bedienung durch den Taster auch die '''Led''' richtig geschaltet wird.
Mit 'on PUMP#Key do' wird geprüft ob die Taste gedrückt ist und schaltet dann entsprechend die Led. Mit den Rules können auch Timer oder sonstige Spielereien realisiert werden. Siehe dazu das [http://www.esp8266.nu/index.php/Tutorial_Rules Tutorial] von ESPeasy.
<div style="clear:both;"></div>

==ESPEasy in Fhem einrichten==
[[Datei:sonoff_sw_9.jpg|thumb|left|alt=Fhem Konfiguration]]
Dies ist eine einfache Darstellung wie Fhem automatisch den Device erstellt.

Damit Fhem mit ESPEasy und dem sonoff Modul kommunizieren kann, muss in der fhem.cfg vorerst nur die espBridge mit dem hier dargestellten Eintrag aktiviert werden.
<div style="clear:both;"></div>
define espBridge ESPEasy bridge 8383
Dies ist eigentlich die einzige Zeile die in fhem.cfg angelegt werden muss. Die restliche Konfiguration wird von Fhem automatisch generiert.

##########################################
### ESPEASY ####
##########################################

define ESPEasy_sonoff_1_PUMP ESPEasy 10.0.0.37 80 espBridge sonoff_1_PUMP
attr ESPEasy_sonoff_1_PUMP IODev espBridge
attr ESPEasy_sonoff_1_PUMP devStateIcon on:rc_GREEN:off off:rc_RED:on absent:rc_BLUE:off gpio:rc_YELLOW:off
attr ESPEasy_sonoff_1_PUMP eventMap /gpio 12 on:on/gpio 12 off:off/gpio 12 gpio:off/gpio 12 output:off/
attr ESPEasy_sonoff_1_PUMP group ESPEasy Device
attr ESPEasy_sonoff_1_PUMP icon hue_filled_outlet
attr ESPEasy_sonoff_1_PUMP room ESPEasy
attr ESPEasy_sonoff_1_PUMP setState 0
attr ESPEasy_sonoff_1_PUMP stateFormat {ReadingsVal($name,"presence","") eq "absent" ? "absent" : ReadingsVal($name,"Relay","")}
attr ESPEasy_sonoff_1_PUMP webCmd :

hier ein Beispiel wie es auch manuell leicht modifiziert werden kann.

[[Datei:sonoff_sw_8.jpg|thumb|left|alt=sonoff Readings]]

Die Readings werden durch die Bridge (Modul ESPEasy) automatisch angelegt.

Es besteht hier noch genug Spielraum um zB. auch noch Temperatursensoren an das Modul anzuschließen und ebenfalls in Fhem darzustellen.
<div style="clear:both;"></div>

==MQTT Server einrichten==
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier geht es ausschließlich um den Sketch von Arends und MQTT an den sonoff Modulen! }}
Es bleibt jedem Anwender die freie Wahl ob die Kommunikation über die ESPEasy-Bridge oder MQTT erfolgen soll. MQTT ist bei der Einrichtung etwas komplexer, da hier auch auf dem Server der Broker installiert werden muss.

Im wesentlichen beschränkt sich die Installation eines MQTT Servers aber auf wenige Arbeitsschritte und ist wie folgt beschrieben durchzuführen. Wer schon einen '''mosquitto''' auf dem Server installiert hat, kann diesen Schritt überspringen.

Dieses Kapitel ist insofern interessant, da mit dem Sketch von Theo Arends auch die Einbindung der neuen sonoff Pow Module bereits möglich ist.

# aus dem mosquitto Repo installieren:
wget http://repo.mosquitto.org/debian/mosquitto-repo.gpg.key
sudo apt-key add mosquitto-repo.gpg.key
cd /etc/apt/sources.list.d/
sudo wget http://repo.mosquitto.org/debian/mosquitto-wheezy.list
# oder für jessie
sudo wget http://repo.mosquitto.org/debian/mosquitto-jessie.list
sudo apt-get update
# mosquitto installieren, sowie client Befehl mosquito_sub (gehört nicht zum Server, wird aber weiter unten benötigt)
sudo apt-get install mosquitto mosquitto-clients

# MQTT Server Test
sudo service mosquitto status

# Start / Stop des Servers
sudo service mosquitto stop
sudo service mosquitto start

# Perl Version ausgeben
perl -v
# Perl MQTT Module nachinstallieren (läuft ein paar Minuten)
sudo cpan install Net::MQTT:Simple
sudo cpan install Net::MQTT:Constants

===Software Arends Sketch===
[[Datei:sonoff_sw_22.jpg|thumb|left|alt=Arends Menü]]

Ebenso bietet sich die Möglichkeit eine andere alternative Software auf den unterschiedlichen Sonoff Modellen aufzuspielen.
Speziell für diese Module zugeschnittene Software stammt vom Autor Theo Arends. Alle hier gezeigten Bildschirmfotos und Beispiele beziehen sich auf Basis der Version 2.0.11 (Stand 11.11.2016).

'''Wichtig:''' erst '''ab Version 2.0.9''' sind die Berechnungsfehler und die Referenzfrequenzen für die Umrechnung der Leistungsdaten gefixt worden! Es wird daher angeraten immer die aktuellste Version zu verwenden.

'''Links zu Theo Arend Github'''

[https://github.com/arendst/Sonoff-MQTT-OTA-Arduino Download MQTT Sketch]

[https://github.com/arendst/Sonoff-MQTT-OTA-Arduino Arend GitHub]

[https://github.com/arendst/Sonoff-MQTT-OTA-Arduino/wiki Wiki]

'''Achtung:''' sollten Probleme mit dem ersten Login im Webinterface auftreten, hat der Autor vorgesorgt und mit speziellem wiederholten Tastendruck können verschiedene Modi aufgerufen werden: zB:

'''3 x Taste kurz drücken''' und eine Smartconfig wird gestartet und die '''SSID''' und das '''Passwort''' kann über diese [https://play.google.com/store/apps/details?id=com.cmmakerclub.iot.esptouch Android App] eingegeben werden.

'''4 x Taste kurz drücken''' und man bringt den Device in den '''Access Point Mode''' mit der IP-Adresse '''192.168.4.1'''.

Bis zu 7 verschiedene Modi sind möglich, mehr dazu in Arends Wiki.

[https://github.com/arendst/Sonoff-MQTT-OTA-Arduino/wiki/Button-usage Link zum Wiki Arends, Button]
<div style="clear:both;"></div>

[[Datei:sonoff_bv_01.jpg|thumb|left|alt=Arduino Boardverwalter]]
In der Arduino IDE unter Datei / Voreinstellungen im Feld "Zusätzliche Boardverwalter-URLs:" den Link: http://arduino.esp8266.com/stable/package_esp8266com_index.json einfügen.

Dann unter '''Werkzeuge / Board / Boardverwalter''' ganz am Ende der Liste die Librarys für "esp8266 by ESP8266 Community" die letzte Version 2.3.0 installieren. [https://forum.fhem.de/index.php/topic,46205.msg534707.html#msg534707 Link zum Board].

Das gesamte sonoff Verzeichnis aus [https://github.com/arendst/Sonoff-MQTT-OTA-Arduino/archive/master.zip Arendts Sketch] entpacken (ist wie hier verlinkt ein Zipfile) und dann aus diesem Verzeichnis die sonoff.ino öffnen. Es können dann alle zu dem Sketch zugehörigen Dateien angesehen/editiert werden.

<div style="clear:both;"></div>
Anschließend muss noch die Datei '''user_config.h''' (im Unterverzeichnis "sonoff") editiert werden. Die Abschnitte

// Wifi
// Syslog
// Ota
// MQTT

müssen mit der eigenen "'''Ip-Adresse-Server'''", "'''SSID'''" und "'''password'''" angepasst werden, das erleichtert den ersten Connect mit dem Modul. Seit der Version 2.1.2 können die WIFI Einstellungen 2-fach angegeben werden, somit wechselt das Device automatisch auf den 2. Wifi Hotspot wenn der erste nicht erreicht wird.

#define STA_SSID "SSID" // Wifi SSID
#define STA_PASS "password" // Wifi password
#define WIFI_HOSTNAME "%s-%04d" // Expands to <MQTT_TOPIC>-<last 4 decimal chars of MAC address>
#define WIFI_CONFIG_TOOL WIFI_WPSCONFIG // Default tool if wifi fails to connect (WIFI_SMARTCONFIG, WIFI_MANAGER or WIFI_WPSCONFIG)

// Syslog
#define SYS_LOG_HOST "Ip-Adresse-Server"
#define SYS_LOG_PORT 514
#define SYS_LOG_LEVEL LOG_LEVEL_NONE
#define SERIAL_LOG_LEVEL LOG_LEVEL_INFO
#define WEB_LOG_LEVEL LOG_LEVEL_INFO

// Ota
#if (ARDUINO >= 168)
#define OTA_URL "http://Ip-Adresse-Server:80/api/arduino/" PROJECT ".ino.bin"
#else
#define OTA_URL "http://Ip-Adresse-Server:80/api/arduino/" PROJECT ".cpp.bin"
#endif

// MQTT
#define MQTT_HOST "Ip-Adresse-Server"
#define MQTT_PORT 1883

'''Wichtig:''' Bei Verwendung des '''sonoff_POW''' muss dies ebenfalls in der user_config.h eingestellt werden, also das "SONOFF" sperren und das "'''SONOFF_POW'''" aktivieren (// setzen/entfernen). Wir dies nicht durchgeführt, werden auch keine Leistungsdaten via MQTT übertragen!!!
Ebenso muss in (%userprofile%\Documents\Arduino\libraries\pubsubclient\src\PubSubClient.h) die Max Packet Size auf 400 erhöht werden!

#define MQTT_MAX_PACKET_SIZE 400
#define MQTT_KEEPALIVE 120
Anpassung der max. Packet Size auf 400 und das Keepalive auf 120

// Enable only one out of three MODULE defines below
//#define MODULE SONOFF // Sonoff, Sonoff SV, Sonoff Dual, Sonoff TH 10A/16A, S20 Smart Socket, 4 Channel
#define MODULE SONOFF_POW // Sonoff Pow

Im Anschluß wird der Sketch mit der Arduino IDE (getestet mit 1.6.12) compiliert und die Binary dann exportiert (Sketch / Kompilierte Binärdatei exportieren). Die erzeugte .bin Datei dann mit dem Tool "ESP8266Flasher.exe" flashen, so wie auch bei ESPEasy. Wer nicht compilieren will, kann auch im Unterverzeichnis ./api/arduino/ die fertige Binary ( sonoff.ino ) benutzen, aber dann ohne Voreinstellung der lokalen IPs.
<div style="clear:both;"></div>

===MQTT testen===
[[Datei:sonoff_sw_20.jpg|thumb|left|alt=Arends Menü]]

Nach erfolgtem Flash des Modules kann das Webinterface des Moduls zum ersten Mal aufgerufen werden (im Router nach der IP des Moduls suchen).

Es bieten sich hier mehrere Möglichkeiten die die weitere Einrichtung des Moduls unterstützen. Einfach die Menüpunkte durchprobieren, sie erklären sich von selbst. Für erste Tests empfiehlt sich die lokale Konsole um die Ereignisse aus Sicht des Modules mit verfolgen zu können. Alles was hier gesendet wird, sollte ebenfalls am Server mitgeloggt werden können. Wenn bis hierher alles funktioniert, kann dann mir der Konfiguration in Fhem beginnen.

Der Name des Moduls kann unter "Configuration" -> "Configure MQTT" -> "Topic (sonoff)" nachgeschaut und geändert werden. In FHEM wird beim definieren des Moduls dieser Name in den subscribeReadings bzw. publishSets eingegeben um die Verbindung zum Modul herzustellen.
<div style="clear:both;"></div>

Am Server jetzt eine Konsole öffnen und folgende Topic (alle) einstellen.

mosquitto_sub -d -v -t \#
Mit dieser Einstellung werden alle Topics geloggt!

pi@raspberry ~ $ mosquitto_sub -d -v -t \#
Received CONNACK
Received SUBACK
Subscribed (mid: 1): 0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/36/temperature', ... (5 bytes))
/sonoff/36/temperature 14.06
Received PUBLISH (d0, q0, r1, m0, '/sonoff/35/Count', ... (3 bytes))
/sonoff/35/Count 0.0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/35/Total', ... (3 bytes))
/sonoff/35/Total 0.0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/35/Time', ... (1 bytes))
/sonoff/35/Time 0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/temperature', ... (5 bytes))
/sonoff/temperature 14.00
Received PUBLISH (d0, q0, r1, m0, '/sonoff/Count', ... (3 bytes))
/sonoff/Count 0.0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/Total', ... (3 bytes))
/sonoff/Total 0.0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/Time', ... (1 bytes))
/sonoff/Time 0
Received PUBLISH (d0, q0, r0, m0, 'stat/sonoff/1/POWER', ... (2 bytes))
stat/sonoff/1/POWER ON
Received PUBLISH (d0, q0, r0, m0, 'stat/sonoff/1/POWER', ... (3 bytes))
stat/sonoff/1/POWER OFF

Interessant sind für uns nun diese Einträge "stat/sonoff/1/POWER ON" , dazu am Taster des sonoff manuell umschalten. Dies entspricht genau der Syntax wie sie im Anschluss in Fhem dann zu verwenden ist.

Mit diesen Einstellungen können dann entweder nach Telemetriedaten oder nach Statusmeldungen gefiltert werden. Dies ist jedoch nur notwendig wenn bereits andere MQTT Devices am Broker hängen und es sonst zu unübersichtlich wird.
mosquitto_sub -h localhost -t tele/sonoff/# = Telemetriedaten
mosquitto_sub -h localhost -t stat/sonoff/# = Statusmeldungen
<div style="clear:both;"></div>

[[Datei:sonoff_sw_21.jpg|thumb|left|alt=Arends Log]]
Sehr nützlich das lokale Log zur Fehlersuche und Inbetriebnahme.

<div style="clear:both;"></div>
Als Besonderheit benutzt der Autor zum Senden und Empfangen unterschiedliche Syntax und unterscheidet dies durch vorangestellte Prefixe vor der eigentlichen Topic.
#define SUB_PREFIX "cmnd" Sonoff devices subscribe to:- cmnd/MQTT_TOPIC and cmnd/MQTT_GRPTOPIC
#define PUB_PREFIX "stat" Sonoff devices publish to:- stat/MQTT_TOPIC
#define PUB_PREFIX2 "tele" Sonoff devices publish telemetry data to:- tele/MQTT_TOPIC/UPTIME, POWER/LIGHT and TIME
Bitte dies unbedingt in der Fhem Konfiguration dann beachten!
<div style="clear:both;"></div>

==MQTT in Fhem einrichten==
[[Datei:sonoff_sw_24.jpg|thumb|left|alt=Fhem sonoff Schalter]]
Dieser einfache Schalter kommuniziert bidirektional mit dem sonoff Device.
<div style="clear:both;"></div>

[[Datei:sonoff_sw_25.jpg|thumb|left|alt=Fhem sonoff Schalter]]
Die Readings in diesem verwendeten Beispiel zeigen sich wie in Fhem gewohnt.
<div style="clear:both;"></div>

Die Einrichtung in Fhem wird von den Modulen 00_MQTT.pm, 10_MQTT_BRIDGE und 10_MQTT_DEVICE.pm unterstützt.

[https://forum.fhem.de/index.php?topic=27532.0 Link zum Forum: MQTT Fhem Einrichtung]

### 1. Broker anlegen ###
define myBroker MQTT 10.0.0.5:1883

### 2. Fhem Device mit MQTT verbinden ###
define Sonoff_Switch MQTT_DEVICE
attr Sonoff_Switch IODev myBroker
attr Sonoff_Switch eventMap ON:on OFF:off
attr Sonoff_Switch icon hue_filled_br30
attr Sonoff_Switch publishSet ON OFF cmnd/sonoff/1/POWER/set
attr Sonoff_Switch room MQTT
attr Sonoff_Switch stateFormat Licht
attr Sonoff_Switch subscribeReading_Licht stat/sonoff/POWER
# oder mit tele, je nachdem was in der user_config.h eingestellt wurde!!!
#attr Sonoff_Switch subscribeReading_Licht tele/sonoff/POWER
attr Sonoff_Switch subscribeReading_state cmnd/sonoff/1/POWER/set
attr Sonoff_Switch webCmd ON:OFF
Der hier dargestellte Beispielcode realisiert die Kommunikation zwischen Fhem und dem sonoff Modul via MQTT Broker. Zu beachten ist hier, dass '''subscribeReading_Licht''' und '''subscribeReading_state''' unterschiedliche Syntax des Topic Strings haben!

==Sonoff POW einrichten==
[[Datei:sonoff_sw_31.jpg|thumb|left|alt=Sonoff POW]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier geht es ausschließlich um das Modul Sonoff POW!}}
Das Modul kommt in gewohnter Itead Qualität und eine derart kostengünstige Energiemessung wird bei Smart Home Anwendern gerne eingesetzt. Die Originalsoftware habe ich nicht einmal getestet, da damit eine Anbindung an Fhem leider nicht möglich ist.

Ebenso möchte kaum jemand an eine nicht dokumentierte chinesische Cloud die Steuerbefehle seiner Schalter senden.
<div style="clear:both;"></div>
[[Datei:sonoff_sw_33.jpg|thumb|left|alt=Sonoff POW]]
Bitte auf keinen Fall das Modul während der Arbeiten an die Netzspannung anschießen. Zum Flashen genügt (und nur diese) die Versorgungspannung des USB-TTL Konverters. Wie auf dem Foto gut erkennbar, wurde dieses Modul ohne einlöten einer Pfostensteckerleiste geflasht. Die Steckverbindung wird einfach in die Lötaugen gesteckt und mit einem Gummiring fixiert, da ja spätere Flashvorgänge im Webif des Models funktionieren und so die Arbeit eingespart werden kann. Es steht jedoch nichts im Wege die Pfostensteckerleiste einzulöten.
<div style="clear:both;"></div>
Die Anschlüsse am Modul sind wie folgt belegt.
o GND
o TxD
o RxD
o VDD

Für den Flashvorgang gelten die selben Regeln wie schon beim sonoff Switch oben erwähnt (3,3V!).
<div style="clear:both;"></div>

===Sonoff POW Software===
[[Datei:sonoff_sw_35.jpg|thumb|left|alt=Sonoff POW FHEM]]
Als Software steht im Augenblick nur der Sketch von Arends zur Verfügung, liefert aber alles was das Herz begehrt und ist ist einfach zu handhaben. Hier eine eine einfache Darstellung mit der aktuellen Leistung und dem Tagesverbrauch. Zusätzlich besteht auch noch die Möglichkeit den angeschlossenen Verbraucher Ein- oder Auszuschalten. Getestet wurde hier mit der Version 2.06, 2.07 und 2.019a von Arends.
<div style="clear:both;"></div>
[[Datei:sonoff_pow_02.jpg|thumb|left|alt=Sonoff POW Webif]]
Seit Version 2.0.19a ist auch die Leistungsanzeige im WEBIF wie im Bild links integriert. Auch der Energieverbrauch des Vortages wird mit angezeigt. Alle hier angezeigten Daten werden auch zyklisch im MQTT String an FHEM übergeben.

Zusätzlich kann im Sketch auch das Feature "'''Power_Limit'''" aktiviert werden ( #define FEATURE_POWER_LIMIT in der sonoff.ino). Wenn dies gewünscht ist, dann vor dem compilieren die beiden // entfernen. Mit dem Power_Limit wird eine zusätzliche Nachricht erzeugt, wenn ein bestimmter einstellbarer Grenzwert über- oder unterschritten wird.

Es lassen sich dadurch Meldungen wie "Waschmaschine fertig" oder ähnliches ohne weitere Schwellwert Überwachungen in FHEM ableiten. Die Meldungen kommen in MQTT mit "'''tele/sonoff/POWER_LOW ON'''" bzw. "'''tele/sonoff/POWER_LOW OFF'''".
<div style="clear:both;"></div>
Bevor der Sketch compiliert wird, müssen neben den IP-Einstellungen noch in der user_config.h auch andere Einstellungen vorgenommen werden.

#define MODULE SONOFF_POW // Hardware module type (SONOFF, SONOFF_POW or ELECTRO_DRAGON)
#define PROJECT "sonoffpow" // PROJECT is used as the default topic delimiter and OTA file name // As an IDE restriction it needs to be the same as the main .ino file

Der Typ des Modules muss von "SONOFF" auf "'''SONOFF_Pow'''" geändert werden,. damit die Software weiß mit welchem Modul es zu tun hat und kann dann die entsprechenden Berechnungen durchführen. Die Leistungsdaten kommen ja in Form einer Frequenz aus dem Baustein und müssen im Sketch (xsns_hlw8102.ino) umgerechnet werden.

#elif MODULE == SONOFF_POW // programming header 1:3.3V 2:rx 3:tx 4:gnd
#define APP_NAME "Sonoff Pow module"
#define USE_POWERMONITOR // Enable Power Monitoring
#define USE_POWERCALIBRATION // Enable setting Calibration parameters by user commands

Bei Einsatz des POW Modules kann die externe Kalibrierung aktiviert werden.

Definition aus der power.ino (2.0.9) für die korrekte Umrechnung der gelieferten Frequenzen für die Leistungsdaten.
#define HLW_PREF 10000 // 1000.0W
#define HLW_UREF 2200 // 220.0V
#define HLW_IREF 4545 // 4.545A

#define HLW_PREF_PULSE 4975 // 4975us = 201Hz = 1000W
#define HLW_UREF_PULSE 1666 // 1666us = 600Hz = 220V
#define HLW_IREF_PULSE 1666 // 1666us = 600Hz = 4.545A

<div style="clear:both;"></div>
[[Datei:sonoff_sw_36.jpg|thumb|left|alt=Sonoff POW Attribute]]
Dieses Bild zeigt die Attribute die vom Modul via MQTT an FHEM geliefert werden.
<div style="clear:both;"></div>
aktuell gelieferte Readings (Mqtt Strings) vom Sketch nach unten dargestellter Definition in Fhem.
tele/sonoffpow/TODAY_ENERGY
tele/sonoffpow/PERIOD_ENERGY
tele/sonoffpow/POWER_FACTOR
tele/sonoffpow/CURRENT_POWER
tele/sonoffpow/VOLTAGE
tele/sonoffpow/CURRENT

Hier ein Mittschnitt des Datenverkehrs zum Broker zwecks Kontrolle der korrekten Funktion der Module und der Software.
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/RSSI', ... (2 bytes))
tele/sonoff/RSSI 82
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/TEMPERATURE', ... (3 bytes))
tele/sonoff/TEMPERATURE 1.9
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/HUMIDITY', ... (4 bytes))
tele/sonoff/HUMIDITY 97.9
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/POWER', ... (3 bytes))
tele/sonoff/POWER OFF
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/TIME', ... (19 bytes))
tele/sonoff/TIME 2016-11-12T10:36:13
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/UPTIME', ... (1 bytes))
tele/sonoffpow/UPTIME 1
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/RSSI', ... (2 bytes))
tele/sonoffpow/RSSI 34
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/TODAY_ENERGY', ... (5 bytes))
tele/sonoffpow/TODAY_ENERGY 0.083
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/PERIOD_ENERGY', ... (1 bytes))
tele/sonoffpow/PERIOD_ENERGY 8
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/CURRENT_POWER', ... (2 bytes))
tele/sonoffpow/CURRENT_POWER 97
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/POWER_FACTOR', ... (4 bytes))
tele/sonoffpow/POWER_FACTOR 1.00
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/VOLTAGE', ... (3 bytes))
tele/sonoffpow/VOLTAGE 225
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/CURRENT', ... (5 bytes))
tele/sonoffpow/CURRENT 0.426
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/POWER', ... (2 bytes))
tele/sonoffpow/POWER ON
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/TIME', ... (19 bytes))
tele/sonoffpow/TIME 2016-11-12T10:36:28
Sending PINGREQ
Received PINGRESP

Die Einstellungen können mit folgender Syntax angefordert werden (zwei Terminalfenster öffnen, eines zum protokollieren und eines zum Seden der Befehle).
mosquitto_sub -d -v -t \# MQTT Datenverkehr protokolieren
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/status/set -m "8" = SonoffPOW Status jetzt auslesen
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/TelePeriod/set -m "60" = Timer setzen, alle 60 Sekunden Daten senden
Die Kommandos können direkt am Broker (Terminalfenster Putty etc.) abgesetzt werden.

<div style="clear:both;"></div>

=== Sonoff POW Kalibrieren ===
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier wird beschrieben, wie der ''Sonoff POW kalibriert'' werden kann. }}
Ab Version 2.0.11 kann nun auch der POW kalibriert werden.
Dazu kann man 2 Konsolenfenster öffnen, im ersten aktiviert man das Protokoll für den Datenverkehr
mosquitto_sub -d -v -t \# MQTT Datenverkehr protokollieren

Dann kann mit folgenden Befehlen die HLW Referenz Pulsfrequenz gesetzt werden.
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/HLWUCAL/set -m "2100" default = 1950
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/HLWICAL/set -m "2450" default = 3500
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/HLWPCAL/set -m "13500" default = 12345
Entweder man hat eine definierte Last zur Verfügung oder besser man misst mit einem Leistungsmesser nach. Die Spannung kann man mit einem Multimeter nachmessen (sollte 230 V sein) und der Strom wird errechnet (bei 100 Watt I = P / U ) = 100/230 = 0,4347.
Die Referenzwerte solange geringfügig ändern bis die Ausgabe passt. Für die Ausgabe wird einfach eine Statusabfrage durchgeführt.

mosquitto_pub -q 2 -t cmnd/sonoffpow/1/status/set -m "8"
Befehl für die Statusabfrage

cmnd/sonoffpow/1/status/set 8
Received PUBLISH (d0, q0, r0, m0, 'stat/sonoffpow/1/STATUS', ... (103 bytes))
stat/sonoffpow/1/STATUS PWR: Voltage 225 V, Current 0.427 A, Current Power 98 W, Total Power Today 0.080 kWh, Power Factor 1.00
Ergebnis der Statusabfrage mit Spannung, Strom und Leistung.

<div style="clear:both;"></div>

===Sonoff POW FHEM Anbindung===
Ein Beispiel einer einfachen Anbindung via MQTT an Fhem. MQTT ist insofern notwendig, da in der Software ESPEasy und der Bridge noch keine Implementierung der Frequenzumrechnung enthalten ist.

define Sonoff_Pow MQTT_DEVICE
attr Sonoff_Pow IODev myBroker
attr Sonoff_Pow eventMap ON:on OFF:off
attr Sonoff_Pow icon measure_power
attr Sonoff_Pow publishSet ON OFF cmnd/sonoffpow/1/POWER/set
attr Sonoff_Pow room MQTT
attr Sonoff_Pow subscribeReading_Power tele/sonoffpow/POWER
attr Sonoff_Pow subscribeReading_state cmnd/sonoffpow/1/POWER/set
attr Sonoff_Pow subscribeReading_TODAY_ENERGY tele/sonoffpow/TODAY_ENERGY
attr Sonoff_Pow subscribeReading_PERIOD_ENERGY tele/sonoffpow/PERIOD_ENERGY
attr Sonoff_Pow subscribeReading_CURRENT_POWER tele/sonoffpow/CURRENT_POWER
attr Sonoff_Pow subscribeReading_VOLTAGE tele/sonoffpow/VOLTAGE
attr Sonoff_Pow subscribeReading_CURRENT tele/sonoffpow/CURRENT
attr Sonoff_Pow subscribeReading_AKTUELL stat/sonoffpow/1/STATUS
attr Sonoff_Pow webCmd ON:OFF
attr Sonoff_Pow stateFormat {sprintf("akutelle Leistung: %.1f W Tagesverbrauch: %.2f Kw/h", ReadingsVal($name,"CURRENT_POWER",undef), ReadingsVal($name,"TODAY_ENERGY",undef))}
Zusätzlich kann hier noch das Relais mit "on" und "off" ein- ausgeschaltet werden. Ab Version 2.0.15 wurden hier die ReadingsNamen auf TODAY_ENERGY und PERIOD_ENERGY (anstatt _POWER) geändert.

===Sonoff POW Netz-Anschluß===
[[Datei:sonoff_sw_34.jpg|thumb|left|alt=Sonoff POW Netzanschluß]]
Erst wenn alle Arbeiten an der Hard- und Software abgeschlossen sind, kann man das Modul an die Netzspannung anschließen. Wer es sich einfach machen will, nimmt eine Industriell gefertigte 230 V Verlängerung (zwischen 1,5 - 3 Meter) und schneidet sie in der Mitte durch. Nach dem abisolieren der flexiblen Drähte sollte diese '''verlötet oder mit Aderendhülsen''' versehen werden (müssen aber exakt passen, da hier kaum Platz in den Klemmen ist).
Mit einem kleinen Schraubendreher kann man die Feder der Klemmen niederdrücken und das verzinnte Drahtende tief ich die Öffnung stecken. Es dürfen keine Drahtlitzen aus den Öffnungen sichtbar sein, Kurzschlußgefahr! Ebenso sollte eine Zugprobe durchgeführt werden ob die Klemme auch richtig eingerastet ist.

'''ACHTUNG:''' diese Arbeiten müssen von einem ausgebildeten Fachpersonal (Elektriker) durchgeführt werden, Lebensgefahr!
<div style="clear:both;"></div>

===Sonoff POW Design===

====ReadingsGroup normal====
[[Datei:sonoff_sw_46.jpg|thumb|left|alt=Sonoff POW Design]]
Viele Benutzer wollen schönere und funktionelle Ausgaben am Bildschirm sehen. Die Möglichkeiten nach oben sind hier sehr vielfältig. Anhand von zwei einfachen aber mächtigen Funktionen hier ein kleines Beispiel wie hier im Bild dargestellt.

Was das Design betrifft, sind hier mehrere Möglichkeiten gegeben und nach oben ist für findige Anwender alles offen.

<div style="clear:both;"></div>

Zunächst wird mit dem Hilfsmodul "'''average'''" eine Art Statistik (Durchschnittsberechnung, Min.,Max., etc.) hinzugefügt. Das beschränkt sich auf eine einzige Zeile. Es würde sich auch '''statistic''' dazu eignen.

define Sonoff_Pow_CURRENT_POWER average Sonoff_Pow:CURRENT_POWER.*
Die "average" Funktion wird in das Device "Sonof_Pow" auf das Reading "CURRENT_POWER" hinzugefügt.

Der zweite Schritt wird eine '''readingsGroup''' mit den gewünschten und gefilterten Ausgabedaten. Durch die verschiedenen IF Abfragen der unterschiedlichen VALUE wird bei über- oder unterschreiten eines Wertes eine bestimmte Farbe angewandt. Weitere Beispiele dazu siehe im Wiki unter [http://www.fhemwiki.de/wiki/ReadingsGroup readingsGroup]

define SonoffPows readingsGroup <%measure_power>,<aktuell>,<Tag>,<Strom>,<Durchschnitt>,<max.P>,<Schaltzyklen>,< hr > .*(Sonoff_Pow|Sonoff_Pow2):CURRENT_POWER,TODAY_ENERGY,CURRENT,CURRENT_POWER_avg_day,CURRENT_POWER_max_day,PERIOD_ENERGY
attr SonoffPows mapping %ALIAS
attr SonoffPows nameStyle style="color:yellow"
attr SonoffPows room MQTT
attr SonoffPows valueFormat {'CURRENT_POWER' =>"%.0f W", 'TODAY_ENERGY' =>"%.2f Kw", 'CURRENT' =>"%.2f A",'CURRENT_POWER_max_day' => "%.0f W",'CURRENT_POWER_avg_day' => "%.2f W",'PERIOD_ENERGY'=>"%.0f Zyklen"}
attr SonoffPows valueStyle { if($READING eq "CURRENT_POWER" && $VALUE >= 0 && $VALUE <= 100){ 'style="color:green;;text-align:right"' }elsif( $READING eq "CURRENT_POWER" && $VALUE > 100 && $VALUE < 200){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER" && $VALUE >= 200){ 'style="color:red;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE >= 4.8){ 'style="color:red;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE <= 2.5){ 'style="color:green;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE > 2.5 && $VALUE < 4.8 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT" && $VALUE <= 0.45){'style="color:green;;text-align:right"'}elsif( $READING eq "CURRENT" && $VALUE > 0.45 && $VALUE < 0.87 ){'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT" && $VALUE >= 0.87){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE <= 100){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE > 100 && $VALUE < 200 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE >= 200){ 'style="color:red;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE <= 10){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE > 10 && $VALUE < 15 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE >= 15){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE <= 100){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE > 100 && $VALUE < 200 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE >= 200){ 'style="color:red;;text-align:right"' } }

Die readingsGroup sind etwas komplex zu lesen, aber nach etwas Einarbeitung klappt das schon. Die in diesem Beispiel verwendeten Readingsnamen beziehen sich auf die Beispielkonfigurationen hier im Wiki.
<div style="clear:both;"></div>

<div style="clear:both;"></div>
====ReadingsGroup mit Schaltmöglichkeit====
[[Datei:sonoff_pow_03.jpg|thumb|left|alt=readingsGroup mit Schalter]]
Die vorher erwähnte ReadingsGroup kann auch gleich mit einem Schalter versehen werden um den POW Ein- oder Aus schalten zu können. Dazu ist aber eine andere Einstellung im Sketch erforderlich.
<div style="clear:both;"></div>

In der "'''user_config.h'''" muss an dieser Stelle auch die "'''PUB_PREFIX'''" auf die gleiche Topic wie "PUB_PREFIX2" eingestellt werden. Durch diese Maßnahme wird erreicht, dass sofort nach dem Knopfdruck auch der Status mit der Topic "tele" übertragen wird. Würde der weiterhin mit "stat" übertragen, kann er in der Readingsgroup nur sehr umständlich weiter behandelt werden. Dadurch wird erreicht, dass der Schalter sofort nach dem Schaltvorgang und der Rückmeldung (Status) auch seine Farbe ändert. Wird dieser Eintrag vergessen, ändert der Schalter erst nach Eintreffen der nächsten zyklischen Abfrage seinen Status/Farbe.

#define SUB_PREFIX "cmnd" // Sonoff devices subscribe to:- SUB_PREFIX/MQTT_TOPIC and SUB_PREFIX/MQTT_GRPTOPIC
#define PUB_PREFIX "tele" // Sonoff devices publish to:- PUB_PREFIX/MQTT_TOPIC
#define PUB_PREFIX2 "tele" // Sonoff devices publish telemetry data to:- PUB_PREFIX2/MQTT_TOPIC/UPTIME, POWER/LIGHT and TIME
hier die PUB_PREFIX mit der geänderten Topic "tele" anstatt "stat"

define SonoffPows readingsGroup <%measure_power>,<aktuell>,<Tag>,<Gestern>,<Strom>,<Durchschnitt>,<max.P>,<Zyklus>,<Faktor>,<Status>,< hr > .*(Sonoff_Pow|Sonoff_Pow2|Sonoff_Pow3):CURRENT_POWER,TODAY_ENERGY,YESTERDAY_ENERGY,CURRENT,CURRENT_POWER_avg_day,CURRENT_POWER_max_day,PERIOD_ENERGY,POWER_FACTOR,LIGHT
attr SonoffPows commands {'LIGHT.ON' => 'set $DEVICE OFF','LIGHT.OFF' => 'set $DEVICE ON'}
attr SonoffPows mapping %ALIAS
attr SonoffPows nameStyle style="color:yellow"
attr SonoffPows room Energie,MQTT
attr SonoffPows valueFormat {'CURRENT_POWER' =>"%.0f W", 'TODAY_ENERGY' =>"%.2f Kw",'YESTERDAY_ENERGY' =>"%.2f Kw", 'CURRENT' =>"%.2f A",'CURRENT_POWER_max_day' => "%.0f W",'CURRENT_POWER_avg_day' => "%.2f W",'CURRENT_POWER'=>"%.0f W",'POWER_FACTOR' => "%.2f "}
attr SonoffPows valueIcon {'LIGHT.ON' => 'rc_GREEN@green', 'LIGHT.OFF' => 'rc_RED@red'}
attr SonoffPows valueStyle { if($READING eq "CURRENT_POWER" && $VALUE >= 0 && $VALUE <= 100){ 'style="color:green;;text-align:right"' }elsif( $READING eq "CURRENT_POWER" && $VALUE > 100 && $VALUE < 200){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER" && $VALUE >= 200){ 'style="color:red;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE >= 4.8){ 'style="color:red;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE <= 2.5){ 'style="color:green;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE > 2.5 && $VALUE < 4.8 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "YESTERDAY_ENERGY" && $VALUE <= 2.5){ 'style="color:green;;text-align:right"' }elsif( $READING eq "YESTERDAY_ENERGY" && $VALUE > 2.5 && $VALUE < 4.8 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "YESTERDAY_ENERGY" && $VALUE >= 4.8){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT" && $VALUE <= 0.45){'style="color:green;;text-align:right"'}elsif( $READING eq "CURRENT" && $VALUE > 0.45 && $VALUE < 0.87 ){'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT" && $VALUE >= 0.87){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE <= 100){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE > 100 && $VALUE < 200 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE >= 200){ 'style="color:red;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE <= 10){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE > 10 && $VALUE < 15 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE >= 15){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE <= 100){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE > 100 && $VALUE < 200 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE >= 200){ 'style="color:red;;text-align:right"' } }
hier die erweiterte ReadingsGroup mit dem Schalter. Bei Bedarf sind hier die Devicenamen anzupassen wenn andere Namen verwendet werden (Sonoff_Pow|Sonoff_Pow2|Sonoff_Pow3).

<div style="clear:both;"></div>

====POW mit FTUI anzeigen====
[[Datei:sonoff_pow_energy.JPG|thumb|left|alt=Tablett FTUI]]
Wer möchte kann die Energieanzeigen auch mit der [https://forum.fhem.de/index.php/topic,34233.0.html Tablett UI] für eine Tablet Ansicht gestalten. Mit dieser stehen viele Möglichkeiten zu einer attraktiven Darstellung zur Verfügung.
Hier ein Beispiel welches mit den Widget "[http://www.fhemwiki.de/wiki/FHEM_Tablet_UI#Widget_THERMOSTAT thermostat]" dargestellt ist.
<div style="clear:both;"></div>

==Sonoff Slampher Flashen==
[[Datei:sonoff_sl_53.jpg|thumb|left|alt=Sonoff SLAMPHER]]
Dieses Modul ist eine Besonderheit was das Flashen betrifft, denn mit Hilfe des Tasters kann der ESP8266 NICHT in den Flashmode gebracht werden. Der Taster ist intern anderwärtig verdrahtet und somit für diesen Zweck nicht zu gebrauchen.

Wie hier links im Bild zu sehen ist, muss der rechte Pin des R20 (oben im Bild) während dem Einstecken des USB Steckers auf Masse gelegt werden. Die beste Möglichkeit ist ein Stücken Draht anzulöten und diesen dann beim einstecken auf den Masse Pin des USB-Konverters zu legen.

Pinbelegung des Steckers von oben nach unten:
o - GND
o - TxD
o - RxD
'''o''' - Vdd

<div style="clear:both;"></div>

[[Datei:sonoff_sl_51.jpg|thumb|left|alt=Sonoff SLAMPHER R20]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier ist genau ersichtlich, wo der R20 auf der Platine platziert ist. }}
Hier nocheinmal schön zu sehen wo der R20 (der ist nicht eingelötet sondern leer) exakt auf der Platine liegt, gemeint ist der rechte Pin. Hier kann auch leicht gelötet werden, da keine empfindlichen Bauteile in der Nähe sind und auch genug Platz vorhanden ist.

<div style="clear:both;"></div>
[[Datei:sonoff_sl_50.jpg|thumb|left|alt=Sonoff SLAMPHER R20]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier ist genau ersichtlich, wo der Draht am R20 aufgelötet wurde }}
Hier ist ein kleines Stück Schaltdraht auf den Pin bereist aufgelötet und bereit zum Flashen!

In diesem Beispiel wurde keine Pfostensteckerleiste auf die Platine aufgelötet, sondern nur durchgesteckt und mit einem Gummiring zum Relais fixiert, das erspart den Lötvorgang, weil in Zukunft dann ohnehin OTA geflasht werden kann.

Also Pin20 auf Masse legen und USB-Konverter an den PC einstecken, dann den Draht von der Masse entfernen. Der ESP8266 sollte jetzt im Flashmodus bereit stehen und kann wie bereits oben beschrieben geflasht werden.

<div style="clear:both;"></div>

===Sonoff Slampher Software===
[[Datei:sonoff_sl_54.jpg|thumb|left|alt=Sonoff SLAMPHER FHEM]]

Als Software wird Arends Sketch installiert (Kommunikation über MQTT), da zum derzeitigen Zeitpunkt ESPEasy das Modul noch nicht integriert hat und somit auch nicht ansteuern kann.
<div style="clear:both;"></div>

define Sonoff_SL MQTT_DEVICE
attr Sonoff_SL IODev myBroker
attr Sonoff_SL devStateIcon ON:rc_GREEN:OFF OFF:rc_RED:ON
attr Sonoff_SL icon hue_filled_br30
attr Sonoff_SL publishSet ON OFF cmnd/sonoffsl/1/POWER/set
attr Sonoff_SL room Bewegung,_Sonoff
attr Sonoff_SL stateFormat Licht
attr Sonoff_SL subscribeReading_Licht tele/sonoffsl/POWER
attr Sonoff_SL subscribeReading_state cmnd/sonoffsl/1/POWER/set
attr Sonoff_SL webCmd ON:OFF

Hier ein Beispiel wie in FHEM der Slampher eingebunden werden kann. In diesem Beispiel wird davon ausgegangen, das das Modul "sonoffsl" unter Konfiguration am WEBIF (Configure MQTT bei Topic) so unbenannt wurde. Wer einen anderen Namen haben möchte, muss dies dann auch in FHEM entsprechend anpassen.

<div style="clear:both;"></div>

==Sonoff Th10/16 FHEM==
[[Datei:sonoff_th_01.jpg|thumb|left|alt=Sonoff TH10]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Temperatur Modul TH10 / 16! }}
Das Modul kann durch drücken des Tasters während dem Einstecken des USB-Konverters in den Flashmodus gebracht werden.
Der Th10/16 kann mit zwei unterschiedlichen Typen von Sensoren bestückt werden, hier im Beispiel mit dem externen Temperaturfühler DS18B20.

Wie im Bild klar zu sehen ist, kann das Webif auch zur Darstellung via Mobile verwendet werden. Mit "Toggle" wird Ein- oder Aus geschaltet und darunter ist die aktuelle Temperatur ersichtlich. Für diese Ansicht muss keine MQTT Verbindung eingerichtet werden, da die Kommunikation hier rein über HTTP erfolgt.

Die unten dargestellten Beispiele für FHEM beziehen sich auf Arends Sketch, also über MQTT. Dieses Modul kann aber genauso leicht über ESPEasy und der ESPEasy-Bridge eingebunden werden.

<div style="clear:both;"></div>
Pinbelegung des Steckers von oben nach unten:
o - GND
o - TxD
o - RxD
'''o''' - Vdd

#define DSB_PIN 14 // GPIO 14 = DS18x20 (Sonoff_TH10A(16A), Sonoff SV)
#define DSB_RESOLUTION 2 // Maximum number of decimals (0 - 3) showing Temperature
// *** Option 1 - Single DS18B20 - Select either Option 1 OR Option 2
#define SEND_TELEMETRY_DS18B20 // Enable sending single temperature telemetry
// *** Option 2 - Multiple DS18B20 and/or DS18S20 (needs OneWire library!)
// #define SEND_TELEMETRY_DS18x20 // Enable sending multi temperature telemetry
In der user_config.h (Arends Sketch) muss hier die Option 1 aktiviert werden (entfernen der vorangestellten //) damit die Telemetriedaten auch gesendet werden. Es empfiehlt sich mindestens die Version >= V 2.0.16, weil hier die Sensoren erweitert wurden.

#define DHT_PIN 14 // GPIO 14 = AM2301 (Sonoff_TH10A(16A), Sonoff SV)
#define DHT_TYPE AM2301 // DHT module type (DHT11, DHT21, DHT22, AM2301, AM2302 or AM2321)
#define DHT_RESOLUTION 1 // Maximum number of decimals (0 - 3) showing Temperature
#define SEND_TELEMETRY_DHT // Enable sending temperature and humidity telemetry
Beispiel für den Sensor DHT22, Temperatur und Luftfeuchte. Es dürfen aber nicht beide Sensoren (DS18B20 + DHT22) gleichzeitig aktiviert werden, da ja beide an GPIO14 angehängt werden und es ansonsten zu Fehlfunktionen kommen würde.

<div style="clear:both;"></div>
[[Datei:sonoff_th_02.jpg|thumb|left|alt=Sonoff TH10]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Einbindung in Fhem via MQTT! }}
<div style="clear:both;"></div>

### Temperatur und Luftfeuchte vom Sonoff Switch ###
define Sonoff_Temp MQTT_DEVICE
attr Sonoff_Temp IODev myBroker
attr Sonoff_Temp alias Pool Wasser
attr Sonoff_Temp eventMap ON:on OFF:off
attr Sonoff_Temp icon temperature_humidity
attr Sonoff_Temp publishSet ON OFF cmnd/sonoffth/1/POWER/set
attr Sonoff_Temp room _Sonoff
attr Sonoff_Temp stateFormat {sprintf("Temperatur: %.1f Grad", ReadingsVal($name,"TEMPERATURE",0))}
attr Sonoff_Temp subscribeReading_TEMPERATURE tele/sonoffth/DS18B20/TEMPERATURE
attr Sonoff_Temp subscribeReading_humidity tele/sonoffth/HUMIDITY
attr Sonoff_Temp subscribeReading_state cmnd/sonoffth/1/POWER/set
Beispiel für FHEM mit Temperaturanzeige mit DS18B20

define Sonoff_Switch MQTT_DEVICE
attr Sonoff_Switch IODev myBroker
attr Sonoff_Switch alias Pool Licht
attr Sonoff_Switch devStateIcon on:rc_GREEN:off off:rc_RED:on
attr Sonoff_Switch eventMap ON:on OFF:off
attr Sonoff_Switch icon light_ceiling
attr Sonoff_Switch publishSet ON OFF cmnd/sonoffth/1/POWER/set
attr Sonoff_Switch room _Sonoff
attr Sonoff_Switch stateFormat Licht
attr Sonoff_Switch subscribeReading_Licht tele/sonoffth/POWER
attr Sonoff_Switch subscribeReading_state cmnd/sonoffth/1/POWER/set
attr Sonoff_Switch webCmd ON:OFF
Der Schalter nochmals seperat dargestellt, je nach Geschmack.

<div style="clear:both;"></div>

==Sonoff CH4 4-Kanal Schaltmodul==
[[Datei:sonoff_ch4_1.jpg|thumb|left|alt=Sonoff CH4]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Achtung andere Einstellungen der Arduino IDE: Select Board "Generic ESP8285 Module" (=Flash Mode "DOUT") and Flash Size "1M (64K SPIFFS)"n! }}

Der Sonoff CH4 ist mit seinen 4 Kanälen ein sehr preiswertes Modul im Gehäuse und für Hutschinenmontage. Anstatt des üblichen ESP8266 besitzt dieses Modul schon den moderneren '''ESP8285'''. Es müssen daher in der Arduino IDE andere Einstellungen vorgenommen werden. Unter Board wird hier das "'''Generic 8285 Module'''" mit '''1M und 64K Spiffs''' angewählt. Der Flashmode "'''DOUT'''" wird dann automatisch eingestellt, bzw. ausgeblendet.

Das Modul ist etwas größer als die anderen Sonoff Produkte und besitzt mit 14,5 x 9 cm schon beachtliche Einbau Maße.
<div style="clear:both;"></div>
[[Datei:sonoff_ch4_2.jpg|thumb|left|alt=Sonoff CH4 FDTI]]
Als weitere Besonderheit sei hier erwähnt, das die Signale '''RxD auf RxD und TxD auf TxD''' des FTDI Konverters zu verbinden sind. Wie bei allen Sonoff Modulen darf man '''zum flashen keine Netzspannung anschließen''', sondern nur über die Versorgungsspannung des FDTI Konverters mit 3,3 V versorgen (Jumper richtig setzen). Die Stiftleiste für den FTDI Anschluß ist hier schon eingelötet.

In den Flashmodus gelangt man durch drücken der '''Taste FW/IO0''' während des einstecken des USB Anschlusses.
<div style="clear:both;"></div>
[[Datei:sonoff_ch4_3.jpg|thumb|left|alt=Sonoff CH4 Arends]]
Hier die Ansicht des Webinterface des Arends Sketches!
Bei der Software sei erwähnt, das die getestete Version 3.1.16 nur bei Kanal 1 den Modus "PulseTime" beherrscht. Wer also gepulste Ausgänge (zB: elektrische Garage/Toröffner) benötigt muss diese per Software nachbilden oder mit dem Kanal 1 auskommen. Eine "Pulsetime 10" ist ein guter Wert dafür (etwa 1 Sekunde).

Als Alternative kann mit dieser HTML Seite des Webservers am Modul des CH4 schon mit jedem Browser fähigem Handy (Android, iPhone, Windows) aufgerufen werden und somit alle Funktionen gesteuert werden.
<div style="clear:both;"></div>
[[Datei:sonoff_ch4_4.jpg|thumb|left|alt=Sonoff CH4 Software APP]]
Hier dargestellt die Original Software die Sonoff zum Modul liefert (EWeLink) und über ihre Cloud verbindet. Leider kann hier keine gepulste Ausgabe erfolgen. Mit einem Countdown kann zwar der Ausgang wieder abgeschaltet werden, die kleinste Zeiteinheit ist aber 1 Minute und somit für einen Impuls leider nicht zu gebrauchen. Ebenso kann mit dieser Software keine Einbindung in Fhem erfolgen, obwohl es eine nette anschauliche Darstellung ist.
<div style="clear:both;"></div>

=Erweiterungen=
<div style="clear:both;"></div>

==Sonoff Switch mit Temperatur + Luftfeuchte==
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier geht es um nützliche Hardware Erweiterungen an den Originalmodulen!}}
Wozu überhaupt den Switch erweitern wenn es auch die Modelle TH10 und TH16 gibt?

Manche Personen können dadurch dem Basteltrieb nachkommen, aber das wesentliche ist der Preis, da die Switches doch fast um die Hälfte billiger sind. Die Sensoren kosten ebenfalls kaum nennenswerte Beträge.

Oder es hat schon jemand Switches im Einsatz und möchte jetzt zusätzlich die Temperatur erfassen!

<div style="clear:both;"></div>

=== Hardware erweitern mit DHT22 ===
[[Datei:sonoff_sw_4.PNG|thumb|left|alt=Sonoff Switch Pinleiste mit Temperatur]]
Am Sonoff Switch wurde ja schon eine Stiftleiste zum Flashen eingelötet. Diese Stiftleiste bietet schon alle Anschlüsse welche für die Temperatur- und Luftfeuchtemessung benötigt werden. Am 5. Anschluß der Stifftleiste ist das Signal "SCL" (GPIO14) herausgeführt, welches für den DHT22 zur Erfassung der Messdaten benötigt wird. Der Sonsor wird mit einem einem 3-poligen Kabel (zB: ein Steckkabel für ein Breadboard oder direkt anlöten) verbunden. Damit der DHT22 korrekt funktioniert, wird ein Widerstand mit 4,7 K Ohm zwischen Vdd und Data am DHT22 zusätzlich benötigt.

<div style="clear:both;"></div>

[[Datei:sonoff_sw_45.jpg|thumb|left|alt=AM2302 / DHT22]]

Ansicht des DHT22 (AM2302) mit den aufgesteckten Verbindungskabeln. Von links nach rechts sind das

1 = VCC 3,3 V
2 = Data
3 = nc (nicht belegt)
4 = GND

Pin1 (VCC) des DHT22 muss also auf Pin1 der Stiftleiste, Pin2 (Data) auf Pin5 und Pin4 (GND) auf Pin4.
Pin2 und Pin1 soll hier noch der Widerstand aufgelötet werden.

1 ------- 1 (VDD)
2 ------- 5 (GPIO14)
3
4 ------- 4 (GND)
DHT22 Stiftleiste

<div style="clear:both;"></div>

[[Datei:sonoff_sw_44.jpg|thumb|left|alt=umgebautes Modul]]
Diese Darstellung zeigt das umgebaute und bereits verschlossene Modul. Auf der Seite des Tasters (bitte nur hier, da auf der anderen Seite die 230 V verlaufen und neben der Lebensgefahr auch den Sensor beeinflussen) ist hier einfach mit einer Eisensäge ein Schlitz eingesägt, der dient in diesem Falle als Kabeldurchführung. Ein Schlitz ist besser als ein Loch, da der Oberteil des Gehäuses sich leichter aufsetzen läßt. Wer ein längeres Kabel benötigt, kann natürlich auch ein 3-poliges Telefonkabel (oder Mikrokabel oder sonstiges) verwenden. Der Sensor sollte etwas Abstand zum Gehäuse haben, da dieses auch eine Eigenerwärmung hat. Wer es ganz originalgetreu lösen will, kann auch eine 3-polige Mini Buchse für Klinckenstecker (3,5mm) einbauen so wie sie am TH10/16 vorhanden ist.
<div style="clear:both;"></div>

=== Software anpassen am Beispiel MQTT ===
[[Datei:sonoff_sw_40.jpg|thumb|left|alt=Sonoff MQTT]]

Wer über MQTT kommuniziert und die Software von Theo Arends benutzt, muss folgende Dinge beachten. In der Datei '''user_config.h''' müssen im Abschnitt '''Module = SONOFF''' die Slashes so wie unten dargestellt entfernt werden, damit erstens die Interrupts abgefragt werden und zweitens die Telemetriedaten gesendet werden. Ebenso ist der verwendete Sensor bei "'''define DHT_TYPE'''" eingestellt werden. In dem hier gezeigten Beispiel also "'''DHT22'''".

#if MODULE == SONOFF // programming header 1:3.3V 2:rx 3:tx 4:gnd
#define APP_NAME "Sonoff module"
#define LED_PIN 13 // GPIO 13 = Green/Blue Led (0 = On, 1 = Off) - Sonoff
#define LED_INVERTED 1 // 0 = (1 = On, 0 = Off), 1 = (0 = On, 1 = Off)
#define REL_PIN 12 // GPIO 12 = Red Led and Relay (0 = Off, 1 = On)
#define KEY_PIN 0 // GPIO 00 = Button
/*-------------------------------------------------------------------------------------------*/
#define DSB_PIN 4 // GPIO 14 = DS18B20 (Sonoff_TH10A(16A), Sonoff SV)
#define SEND_TELEMETRY_DS18B20 // Enable sending temperature telemetry
/*-------------------------------------------------------------------------------------------*/
#define DHT_PIN 14 // GPIO 14 = AM2301 (Sonoff_TH10A(16A), Sonoff SV)
#define DHT_TYPE DHT22 // DHT module type (DHT11, DHT21, DHT22, AM2301, AM2302 or AM2321)
#define SEND_TELEMETRY_DHT // Enable sending temperature and humidity telemetry

<div style="clear:both;"></div>

=== Software Anpassung DHT22 in Fhem ===
[[Datei:sonoff_sw_41.jpg|thumb|left|alt=umgebautes Modul]]

Links in der Hardcopy sind die Readings die nach der Anpassung von FHEM (Broker) befüllt werden sollten.

<div style="clear:both;"></div>

### Temperatur und Luftfeuchte vom Sonoff Switch ###
define Sonoff_Temp MQTT_DEVICE
attr Sonoff_Temp IODev myBroker
attr Sonoff_Temp icon temperature_humidity
attr Sonoff_Temp room MQTT
attr Sonoff_Temp stateFormat {sprintf("Temperatur: %.1f Grad Feuchte: %.1f ", ReadingsVal($name,"temperature",0), ReadingsVal($name,"humidity",0))}
attr Sonoff_Temp subscribeReading_humidity tele/sonoff/HUMIDITY
attr Sonoff_Temp subscribeReading_temperature tele/sonoff/TEMPERATURE
Als Beispiel die zusätzliche Erweiterung um die Temperatur und die Luftfeuchte in FHEM. Der in der Topic verwendete Name "sonoff" muss natürlich der Einstellung in der Software am Switch entsprechen. Bei Verwendung mehrerer Switches muss natürlich auch der Name bei jedem geändert werden.

<div style="clear:both;"></div>

=== Logfile für die Temperatur ===
define SVG_FileLog_Sonoff_Temp SVG myDbLog:SVG_FileLog_Sonoff_Temp:HISTORY
attr SVG_FileLog_Sonoff_Temp room MQTT

Und schließlich fehlt noch das Logfile, damit der Temperaturverlauf auch in schönen Plots dargestellt werden kann.
Das hier verwendete Beispiel funktioniert nur mit einer DbLog.

<div style="clear:both;"></div>

==Sonoff Switch als Thermostat verwenden mit MQTT==

[[Datei:sonoff_sw_55.jpg|thumb|left|alt=Thermostat]]
Mit diesem einfachen Beispiel wird ein Pelett Ofen mit einem externen Thermostat (sonoff Switch oder TH10/16) gesteuert. Zum besseren Überblick wird die Steuerung in einzelne Module getrennt, es könnte aber auch einiges zu einer einzigen Definition zusammen gefasst werden. Der Thermostat könnte auch als Frostwächter benutzt werden und ein anderes Heizgerät steuern.
<div style="clear:both;"></div>

###################################
### Sonoff Thermostat Regelung ####
###################################
define Sonoff_dht MQTT_DEVICE
attr Sonoff_dht IODev myBroker
attr Sonoff_dht alias Raumtemperatur
attr Sonoff_dht group Thermostat
attr Sonoff_dht icon temperature_humidity
attr Sonoff_dht publishSet ON OFF cmnd/sonoff_dht/1/POWER/set
attr Sonoff_dht room _Sonoff
attr Sonoff_dht stateFormat {sprintf("Temperatur: %.1f Grad Feuchte: %.1f ", ReadingsVal($name,"TEMPERATURE",0), ReadingsVal($name,"HUMIDITY",0))}
attr Sonoff_dht subscribeReading_HUMIDITY tele/sonoff_dht/DHT/HUMIDITY
attr Sonoff_dht subscribeReading_TEMPERATURE tele/sonoff_dht/DHT/TEMPERATURE
attr Sonoff_dht subscribeReading_state cmnd/sonoff_dht/1/POWER/set
FHEM Definition zur Erfassung der Temperatur und der Luftfeuchte. Damit dieses Beispiel funktioniert, ist am Sonoff Modul die Topic "'''sonoff_dht'''" zu setzen. Dieser Temperaturwert dient dem Thermostat als ISTWert.

define Sonoff_Sw MQTT_DEVICE
attr Sonoff_Sw IODev myBroker
attr Sonoff_Sw alias Pellets Ofen
attr Sonoff_Sw devStateIcon on:rc_GREEN:off off:rc_RED:on
attr Sonoff_Sw eventMap ON:on OFF:off
attr Sonoff_Sw group Thermostat
attr Sonoff_Sw icon sani_boiler_temp
attr Sonoff_Sw publishSet ON OFF cmnd/sonoff_dht/1/POWER/set
attr Sonoff_Sw room _Sonoff
attr Sonoff_Sw stateFormat Licht
attr Sonoff_Sw subscribeReading_Licht tele/sonoff_dht/POWER
attr Sonoff_Sw subscribeReading_state cmnd/sonoff_dht/1/POWER/set
attr Sonoff_Sw webCmd ON:OFF
FHEM Definition zum Absetzen der Befehle für das Relais (Thermostat) Ein- / Aus. Wenn das zu steuernde Geräte einen potentialfreien Thermostatanschluß benötigt (in den meisten Fällen), muss noch ein Relais dazwischen geschaltet werden um die Trennung der Netzspannung zu gewährleisten.

define ThermostatPellets dummy
attr ThermostatPellets alias Pellets Ofen Sollwert
attr ThermostatPellets group Thermostat
attr ThermostatPellets icon temp_control
attr ThermostatPellets room _Sonoff
attr ThermostatPellets setList state:0,5,10,12,13,14,15,16,17,17.5,18,18.5,19,19.5,20,20.5,21,21.5,22,23,24,25,26,27
attr ThermostatPellets webCmd state
Die Sollwertvorgabe für das Thermostat durch einen Dummy, damit können die gewünschten Temperaturen eingestellt werden.

### sofort ausführen wenn neuer Sollwert eingestellt wird ###
define Thermostat_on_notify notify ThermostatPellets IF (ReadingsVal("Sonoff_Sw","state",0) eq "OFF" && (ReadingsVal("Sonoff_dht","TEMPERATURE",0) <= Value("ThermostatPellets"))) (set Sonoff_Sw ON)
define Thermostat_off_notify notify ThermostatPellets IF (ReadingsVal("Sonoff_Sw","state",0) eq "ON" && (ReadingsVal("Sonoff_dht","TEMPERATURE",0) > Value("ThermostatPellets"))) (set Sonoff_Sw OFF)
Mit einem notify wird die manuelle Änderung des Sollwertes überwacht und sofort reagiert.

## zyklisch prüfen ob Sollwert erreicht wurde ###
define Thermostat_on at +*00:15:00 IF (ReadingsVal("Sonoff_Sw","Licht",0) eq "OFF" && (ReadingsVal("Sonoff_dht","TEMPERATURE",0) <= Value("ThermostatPellets"))) (set Sonoff_Sw ON)
define Thermostat_off at +*00:15:00 IF (Value("Sonoff_Sw") eq "ON" && (ReadingsVal("Sonoff_dht","TEMPERATURE",0) > Value("ThermostatPellets"))) (set Sonoff_Sw OFF)
Hier noch die Soll- Ist Wertvergleiche zur Steuerung. Es wird alle 15 Minuten überprüft ob die Temperatur erreicht ist. Bei einer trägen Heizung sollten 15 Minuten ausreichend sein, wer will kann dies aber auch alle 5 oder 10 Minuten prüfen.

<div style="clear:both;"></div>

==Sonoff Switch mit Bewegungsmelder HC-SR501==

[[Datei:sonoff_pir_1.jpg|thumb|left|alt=Bewegungsmelder]]
Basierend auf dem Wall Switch MQTT Sketch von Arends wurde hier ein Sonoff BASIC + PIR HC-SR501 in eine größere Verteilerdose eingebaut, der Sonoff wurde dabei etwas gekürzt. Die Bewegungsmelder sind ab etwa 70 Cent erhältlich.

Der Sketch kann auch den Blink Modus. Damit kann man im Alarmfall z.B. Alle Strahler rings ums Haus blinken lassen.

Mehr dazu kann hier im [https://forum.fhem.de/index.php/topic,63824.0.html Forum]im Diskussionsthread nachgelesen werden.
<div style="clear:both;"></div>

[[Datei:sonoff_pir_2.jpg|thumb|left|alt=Bewegungsmelder]]
Ein Beispiel wir der Bewegungsmelder in der Feuchtraumdose montiert werden kann. Wird der Bewegungsmelder abgesetzt vom Switch montiert, ist darauf zu achten das die Kabel nicht zu lange werden.
<div style="clear:both;"></div>
===Spannungsversorgung des HC-SR501===
[[Datei:sonoff_pir_4.jpg|thumb|left|alt=5V für Bewegungsmelder]]
Der HC-SR501 wird vom Sonoff versorgt, wobei hier die 3,3 V nicht immer ausreichen. Es ist deshalb am HC-SR501 eine Diode zu überbrücken, dann reichen die 3,3V vom Sonoff. Es können aber auch am Sonoff die 5V angezapft werden. Hier im Bild dargestellt wo die 5V angezapft werden können.
<div style="clear:both;"></div>

[[Datei:sonoff_pir_5.jpg|thumb|left|alt=3,3V für Bewegungsmelder]]
Hier eine kleine Übersicht der wichtigsten Teile und deren Platzierung am HC-SR501.
Den PIR kann man auch mit 3,3V betreiben wenn man die Diode am Eingang nach Vcc überbrückt, dann reicht die Spannung für einen reibungslosen Betrieb völlig aus. Dies gilt für den HC-SR501, wird ein anderer PIR verwendet muss man nachschauen ob das auch möglich ist, ansonsten die 5V Variante wählen.

<div style="clear:both;"></div>
===Anpassung des Sketches mit Wall Switch===
Zur Vorbereitung des Sketches sind zunächst einige Einstellungen in der "user_config.h" durchzuführen.

#if MODULE == SONOFF // programming header 1:3.3V 2:rx 3:tx 4:gnd
#define APP_NAME "Sonoff 8266 module"
#define MQTT_GRPTOPIC "sonoffs" // [GroupTopic] MQTT Group topic
/*-------------------------------------------------------------------------------------------*/
#define LED_PIN 13 // GPIO 13 = Green/Blue Led (0 = On, 1 = Off) - Sonoff
#define LED_INVERTED 1 // 0 = (1 = On, 0 = Off), 1 = (0 = On, 1 = Off)
#define REL_PIN 12 // GPIO 12 = Red Led and Relay (0 = Off, 1 = On)
#define KEY_PIN 0 // GPIO 00 = Button
/*-------------------------------------------------------------------------------------------*\
* Wall switch and HC-SR501
\*-------------------------------------------------------------------------------------------*/
#define SWITCH_PIN 14 // GPIO 14 = Standard wall switch to Gnd (Sonoff_TH10A(16A), Sonoff SV)
#define SWITCH_MODE '''PUSHBUTTON_INV''' // [SwitchMode] TOGGLE, FOLLOW, FOLLOW_INV, PUSHBUTTON or PUSHBUTTON_INV (the wall switch state)
'''#define USE_WALL_SWITCH''' // Enable the use of a standard wall switch to control the relay
Wichtig ist dabei die vorangestellten Slahes // bei "#define USE_WALL_SWITCH" zu entfernen auf '''PUSHBUTTON_INV''' zu stellen. Dann kann der Sonoff Switch compiliert und geflasht werden.

===Einbindung des HC-SR501 in Fhem===
# ------------- Sonoff_pir mit Bewegungsmelder ---------------
define Sonoff_pir MQTT_DEVICE
attr Sonoff_pir IODev myBroker
attr Sonoff_pir eventMap ON:on OFF:off
attr Sonoff_pir group Sonoff
attr Sonoff_pir icon hue_filled_br30
attr Sonoff_pir publishSet ON OFF cmnd/sonoff_pir/1/POWER/set
attr Sonoff_pir room MQTT
attr Sonoff_pir stateFormat Licht
attr Sonoff_pir subscribeReading_Licht stat/sonoff_pir/POWER
attr Sonoff_pir subscribeReading_state cmnd/sonoff_pir/1/POWER/set
attr Sonoff_pir webCmd :

Ein Beispiel wie der Sonoff Switch in Fhem eingebunden wird. Wenn im Sketch der Prefix von stat auf tele geändert wurde, ist dies auch hier durchzuführen ( subscribeReading_Licht tele/sonoff_pir/POWER ), ansonsten bleibt es so wie im Beispiel. Getestet wurde dieses Beispiel mit Version 3.1.6. Die Topic sollte auf den Namen "sonoff_pir" eingestellt werden. Bei anderen Namen ist dies entsprechend in Fhem anzupassen.

Mit dem Command '''BUTTONTOPIC = Alarm_SO2''' ( direkt im Webinterface des Sonoff ) wird der Wall Switch GPIO14 vom Sonoff entkoppelt und somit sendet der Bewegungsmelder direkt an FHEM --> Motion_pir MQTT_DEVICE

Es sollte auch unbedingt kontrolliert werden, wie die Ausgabe des Alarmes in der Console erfolgt. Erscheint hier die Meldung "cmnd/Alarm_SO2/POWER = TOGGLE" dann muss mit dem Kommando "'''switchmode 1'''" das Ausgabeformat umgeschaltet werden, erst dann kommt das gewünschte Format "On" und "OFF".

# ------------------ Motion_pir MQTT_DEVICE -----------------
define Motion_pir MQTT_DEVICE
attr Motion_pir IODev myBroker
attr Motion_pir devStateIcon on:on-for-timer off:off
attr Motion_pir eventMap ON:on OFF:off
attr Motion_pir group Sonoff
attr Motion_pir icon people_sensor
attr Motion_pir room MQTT
attr Motion_pir stateFormat Alarm
attr Motion_pir subscribeReading_Alarm cmnd/Alarm_SO2/POWER
Die Motion_pir dient nun zur eigentlichen Einschaltung des Lichtes und sendet das Kommando '''cmnd/Alarm_SO2/POWER''' an den entkopellten GPIO 14 des Switch.

# ------------------ DoIf zur Motion Abfrage -----------------
define di_Sonoff_pir_Alarm DOIF ([Motion_pir:"on"] and [Tag_Nacht:twilight_weather] < 35) (set Sonoff_pir on) DOELSEIF ([Motion_pir:"off"] and [Tag_Nacht:twilight_weather] < 35) (set Sonoff_pir off)
attr di_Sonoff_pir_Alarm comment Abhängig von Helligkeitssensor wird nachts,bei Bewegung das Licht eingeschaltet!
attr di_Sonoff_pir_Alarm group Sonoff
attr di_Sonoff_pir_Alarm room MQTT
Zusätzlich kann nun mit einem '''Doif''' verknüpft werden um das Ganze mit Tag_Nacht:twilight_weather dann in Abhängigkeit der Helligkeit zu schalten. Selbstverständlich kann jede andere Quelle mit einem Helligkeitswert verwendet werden.

===Alarmausgabe über Grouptopic===
# ------------------------ Sonoffs Group ----------------------
define Sonoffs MQTT_DEVICE
attr Sonoffs IODev myBroker
attr Sonoffs eventMap ON:on OFF:off
attr Sonoffs group Sonoff
attr Sonoffs icon hue_filled_br30
attr Sonoffs publishSet ON OFF cmnd/sonoffs/1/POWER/set
attr Sonoffs room MQTT
attr Sonoffs stateFormat state
attr Sonoffs subscribeReading_Licht stat/sonoffs/1/POWER
attr Sonoffs subscribeReading_state cmnd/sonoffs/1/POWER/set
Wer möchte kann auch mit der Group Topic mehrere Switches mit Bewegungsmelder zusammenfassen und alle Lampen im Alarmfall gemeinsam in den Blinkmodus schalten. cmnd/sonoffs ist das Kommando für die Group Topic, sofern diese vom User nicht verändert wurde.
<div style="clear:both;"></div>

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
--[[Benutzer:Reinhart|Reinhart]] ([[Benutzer Diskussion:Reinhart|Diskussion]]) 20:54, 5. Jan. 2017 (CET)

Sonoff

2017-01-15T22:57:40Z

ThomasRamm: /* MQTT testen */

'''sonoff, dieser Artikel beschreibt die Ankopplung der kostengünstigen sonoff Module an FHEM mit ESPEasy oder MQTT.'''
{{Randnotiz|RNTyp=Fehl|RNText=Achtung: Arbeiten mit Netzspannung kann lebensgefährlich sein und darf nur von autorisiertem Fachpersonal durchgeführt werden!}}

Seit einiger Zeit werden von der [https://www.itead.cc/sonoff-wifi-wireless-switch.html Fa. Itead] kostengünstige "sonoff" Produkte angeboten die glücklicherweise den [http://dl.itead.cc/IM151116002/0A-ESP8266_Specifications_v4.1.pdf ESP8266 Chip] On Board haben und somit die ideale Grundlage für [http://www.esp8266.nu/index.php/Main_Page ESPEasy] und für [https://forum.fhem.de/index.php/board,46.0.html Fhem] darstellen.

'''Nützliche Links zum Hersteller:'''

[https://www.itead.cc/blog/user-guide-for-sonoff-slampher User Manual von Itead]

[https://www.itead.cc/wiki/images/6/6b/Sonoff_schmatic.pdf Sonoff Schaltplan]
<div style="clear:both;"></div>

=Hardware=
'''Bitte unbedingt die elektrotechnischen Sicherheitsrichtlinien beachten und einhalten!'''
<div style="clear:both;"></div>
[[Datei:sonoff_sw_15.jpg|thumb|left|alt=Warnung Netzspannung]]
<div style="clear:both;"></div>
'''Achtung: An dem Modul liegt Netzspannung an die lebensgefährlich ist. Es dürfen nur entsprechend ausgebildete Personen dieses Modul in Betrieb nehmen. Zum Umbau und zur Softwareaktualisierung darf keine Netzspannung angeschlossen sein'''

Wie gefährlich das hantieren mit Netzspannung sein kann, wird hier am Beispiel eines [http://mysku.ru/blog/china-stores/45762.html russischen Anwenders] gezeigt, der hat beim Flashen die Netzspannung am Modul gelassen und somit über die Verbindung mit dem Netzteil des Laptop lebensgefährliche Spannung auf die FTDI Schnittstelle gebracht. Das Modul ist dabei abgeraucht!

==Modelle==

===Produktübersichtsliste sonoff===

{| class="wikitable" style="text-align:right"
! Produkt Name !! Beschreibung !! Spannungsversorgung !! Imax !! Pmax !! Frequenz !! Schaltplan !! Link
|-
| Sonoff || Wireless control switch || 90~250V AC || 10A || 2200W || 2.4Ghz || [http://wiki.iteadstudio.com/Sonoff Plan] || [https://www.itead.cc/smart-home/sonoff-wifi-wireless-switch.html Link]
|-
| Sonoff RF || 433 RF remote || 90~250V AC || 10A || 2200W || 2.4Ghz || [http://wiki.iteadstudio.com/Sonoff_RF Plan] || [https://www.itead.cc/smart-home/im151116003.html Link]
|-
| Sonoff SV || Low voltage Input || 5~24V DC || 10A || 240W DC || 2.4Ghz || [http://wiki.iteadstudio.com/Sonoff_SV Plan] || [https://www.itead.cc/smart-home/sonoff-sv.html Link]
|-
| Sonoff TH10/TH16 || Monitor and set Temp.&Hum. || 90~250V AC || 10A/16A || 2200W(10A)/3500W(16A) || 2.4Ghz || [http://wiki.iteadstudio.com/Sonoff_TH_10/16 Plan] || [https://www.itead.cc/smart-home/sonoff-th.html Link]
|-
| Sonoff Dual || Remote control 2 devices || 90~250V AC || 16A || 3500W || 2.4Ghz || [https://www.itead.cc/wiki/Sonoff_Dual Plan] || [https://www.itead.cc/sonoff-dual.html Link]
|-
| Sonoff Pow || Report power &power usage || 90~250V AC || 16A || 3500W || 2.4Ghz || [https://www.itead.cc/wiki/Sonoff_Pow Plan] || [https://www.itead.cc/sonoff-pow.html Link]
|-
| Sonoff LED || WiFi Control Dimming LED || 180~265V AC || 0.3-0.6A || 42W || 2.4Ghz || kein || [https://www.itead.cc/sonoff-led.html Link]
|-
| Sonoff Touch || WiFi wall touch switch || 90~250V AC || 2A || 400W || 2.4Ghz || kein || [https://www.itead.cc/sonoff-touch.html Link]
|-
| Slampher || Wireless control light holder || 90~250V AC || 2A || 200W || 2.4Ghz || [http://wiki.iteadstudio.com/Slampher Plan] || [https://www.itead.cc/smart-home/slampher-wifi-wireless-light-holder.html Link]
|-
| S20 Smart Socket || Smart socket || 90~250V AC || 10A || 2000W || 2.4Ghz || kein || [https://www.itead.cc/smart-home/smart-socket-eu.html EU-Stecker]
|-
| iFan || Smart fan || 185~264V AC ||﹤1A || 60W || 2.4Ghz || kein || [https://www.itead.cc/smart-home/smart-socket-eu.html EU-Stecker]
|-
| Motor/Pump Control Switch || clockwise/anticlockwise running || 5V/7~32V DC || 10A || 50~320W || 2.4Ghz || kein || [https://www.itead.cc/smart-home/motor-reversing-wifi-wireless-switch.html Link]
|-
| 1 Chnl Inching/self-locking Switch || Access control || 5V/12V DC || 10A || 50/120W || 2.4Ghz || kein || [https://www.itead.cc/smart-home/inching-self-locking-wifi-wireless-switch.html Link]
|-
| 4 Chnl Inching/self-locking/inter-locking Switch || Access control, rolling door control || 5V/5~32V DC/90~250V AC || 10A || 50~320W/2500W || 2.4Ghz || kein || [https://www.itead.cc/ifan.html Link]
|-
|   || || || || || || ||
|-
|}

Eine Übersichtliste der verschiedenen Produkte mit technischen Kurzangaben.
<div style="clear:both;"></div>''

===Model: IM151116002: Erstes Modell===
[https://www.itead.cc/sonoff-wifi-wireless-switch.html Sonoff WiFi Wireless Smart Switch for MQTT COAP Smart Home]
[[Datei:sonoff_sw_0.jpg|thumb|left|alt=sonoff Switch]]
<div style="clear:both;"></div>
Das sonoff Modul ist in einem zweckmäßigen und gefälligem Gehäuse verbaut!

====Platine====
[[Datei:sonoff_sw_1.jpg|thumb|left|alt=sonoff Switch von vorne]]

Die Platine ist sehr übersichtlich aufgebaut und der Hersteller hat auch alle Vorbereitungen zum Flashen einer alternativen Software vorgesehen (über serielle Schnittstelle via FTDI-Modul). Mit einer alternativen Software wie ESPEasy ist eine direkte Ankopplung des '''sonoff''' an FHEM somit ein leicht durchführbarer Vorgang.
<div style="clear:both;"></div>

[[Datei:sonoff_sw_3.jpg|thumb|left|alt=sonoff Switch von hinten]]
Die stromführenden Leitungen wurden mit Lötzinn vom Hersteller verstärkt um die angegebenen Stromstärken mit geringer Hitzeentwicklung zu transportieren.

'''Achtung: Bitte vor den Arbeiten kontrollieren, das an der Platine keine Netzspannung angeschlossen ist, LEBENSGEFAHR!'''
<div style="clear:both;"></div>''

<div style="clear:both;"></div>''

===Model: IM160712005: TH 10A/16A ===
[https://www.itead.cc/sonoff-th.html Sonoff TH 10A/16A WiFi Smart Switch]

====TH10 / TH16 weitere GPIO zugänglich machen====
[[Datei:Sonoff_TH_10A-16A_kleiner.jpg|thumb|left|alt=TH10 / TH16 weitere GPIO zugänglich machen]]
Der Hersteller hat zwar schon Platine für eine weitere Stiftleiste vorbereitet, jedoch muss diese noch bestückt werden. Die nicht beschalteten Stifte können dann genutzt werden um die "verdeckten" GPIO zugänglich zu machen. Die Verdrahtung kann dem Bild entnommen werden.<br>
'''Achtung: Bitte vor den Arbeiten kontrollieren, das an der Platine keine Netzspannung angeschlossen ist, LEBENSGEFAHR!'''
<div style="clear:both;"></div>''

<div style="clear:both;"></div>''

===Model: IM160811001: Sonoff Dual ===
[https://www.itead.cc/sonoff-dual.html Sonoff Dual WiFi Wireless Smart Swtich]

<div style="clear:both;"></div>''

<div style="clear:both;"></div>''

===Model: IM160810001: Sonoff Pow ===
[https://www.itead.cc/sonoff-pow.html Sonoff POW WiFi Switch with Power Consumption Measurement]
[[Datei:sonoff_sw_30.jpg|thumb|left|alt=SONOFF POW]]Ein sehr interessantes und kostengünstiges Modul zur Messung der aktuellen Leistung. Das Modul kann via MQTT in Fhem angebunden werden.

Ein Beispiel zur Einbindung ist [http://www.fhemwiki.de/wiki/Sonoff#Sonoff_POW_einrichten hier unten] im Wiki beschrieben.

<div style="clear:both;"></div>
===Model: weitere Modelle===
[https://www.itead.cc/search/result/?cat=&q=sonoff Sonoff Weitere Modelle finden sich auf der Homepage des Hersstellers]

==Vorbereitungen zum Flashen==
[[Datei:sonoff_sw_2.jpg|thumb|left|alt=serielle Schnittstelle]]

Hier auf der Platine sind die benötigten Signale für ein FTDI Modul schon vorhanden. Der quadratische Pin gleich über dem Taster ist die Spannungsversorgung zum Flashen vom FDTI von 3.3V Es muss daher unbedingt ein FTDI Modul genommen werden, dass nicht nur einen Jumper für 3.3V besitzt sondern auch die Spannung auf 3.3V herab setzt. Ist dies nicht der Fall, läuft man Gefahr das Modul unbrauchbar zu machen. Es ist daher zu empfehlen einen Spannungsteiler mit 2 Widerständen oder einen Pegelwandler zwischenschalten.
<div style="clear:both;"></div>

==Signale der Schnittstelle==
von oben nach unten auf der Steckerleiste des sonoff U4 (Model: IM151116002).

Pin5 = vorbereitet für GPIO
Pin4 = Masse
Pin3 = TxD
Pin2 = RxD
Pin1 = 3.3V

Siehe dazu auch den [https://forum.fhem.de/index.php/topic,55036.0.html Link aus dem Forum]:
<div style="clear:both;"></div>

==Platine mit Stiftleiste bestücken==
[[Datei:sonoff_sw_4.jpg|thumb|left|alt=Platine mit Stiftleiste bestücken]]
Der Hersteller hat zwar schon die Platine vorbereitet, jedoch muss sie noch mit einer Stiftleiste bestückt werden um das FTDI Modul bequem verbinden zu können. Nachdem einmal ESPEasy geflasht worden ist, kann es in Zukunft via WEB (OTA) geflasht werden und die Stiftleiste ist dann nicht mehr erforderlich. Aufgrund der geringen Kosten fällt dies jedoch nicht ins Gewicht.<br>
Für die Module TH10/TH16 sind die Lötpunkte für die Stiftleiste schon beschriftet. Die Stiftleiste selber muss allerdings auch nachgerüstet werden.
<div style="clear:both;"></div>''
'''''Achtung''': Bitte vor den Arbeiten kontrollieren, das an der Platine keine Netzspannung angeschlossen ist, LEBENSGEFAHR!
<div style="clear:both;"></div>''

=Software=
==ESPEasy flashen==
[[Datei:sonoff_sw_6.jpg|thumb|left|alt=sonoff mit angestecktem FDTI Adapter]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier geht es ausschließlich um die Software ESPEasy an den sonoff Modulen! }}
Die Spannungsversorgung des sonoff Moduls wird hier vom FTDI Konverter mit 3.3V über die Verbindungskabel zum Pfostenstecker durchgeführt.

Der FTDI Adapter wird dann mit der USB Schnittstelle mit dem Computer verbunden.

Zum compilieren wird in der Arduino Umgebung auch die ArduinoJson library 5.6.4+ benötigt. Eine genaue Anleitung kann [https://forum.fhem.de/index.php/topic,55728.msg473220.html#msg473220 hier] nachgelesen werden. Im Gegensatz zu Arends Sketch für die MQTT Umgebung genügt hier die Arduino IDE 1.6.9. Für die Sketches von Arends empfiehlt sich Arduino IDE >=1.6.12

<div style="clear:both;"></div>

===mit Arduino compilieren===
[[Datei:sonoff_sw_10.jpg|thumb|left|alt=Einstellung Arduino IDE]]
Wer selber mit der Arduino IDE compilieren will bitte folgende Einstellungen beachten. Die anschließenden Arbeiten sind dann gleich wie bei Abschnitt '''fertige Binary'''.

Unbedingt die neueste [https://github.com/bblanchon/ArduinoJson Arduino Json Library] benutzen (siehe oben)! Es gibt zwar keine Compilerfehler, aber es kommt anschließend zu Fehlfunktionen in der ESP Bridge!

<div style="clear:both;"></div>
Generic ESP8266 Module
Flash Mode: QIO
Flash Frequency: 40 MHz
CPU Frequency: 80 MHz
Flash Size: 1M (64K SPIFFS)
Debug Port: disabled
Debug Level: none
Reset Mode: ck
Upload Speed: 115200
<div style="clear:both;"></div>
===fertige Binary flashen===
[[Datei:sonoff_sw_7.jpg|thumb|left|alt=NodeMCU Firmware Flasher]]
Es empfiehlt sich eine fertige Binary von ESPEasy aufzuspielen. In diesem Wiki wurde R140 verwendet.

Siehe dazu auch den [http://www.esp8266.nu/index.php/Main_Page Link von ESPEasy] und das [https://learn.adafruit.com/building-and-running-micropython-on-the-esp8266/flash-firmware Handbuch] für den Flasher.

In manchen Versionen von ESPEasy (zB.R120) ist auch ein Flasher beigelegt, welcher zwar keine grafische Oberfläche hat aber hervorragend funktioniert. Wenn andere versagen, geht es mit diesem Flasher immer noch, einfach probieren!

<div style="clear:both;"></div>
Netzspannung darf 'NICHT' angeschlossen sein!!!
Taster am Sonoff gedrückt halten
FTDI Adapter verbinden
Taster am Sonoff los lassen
Sketch übertragen
Sonoff vom FTDI trennen
<div style="clear:both;"></div>
Wenn einmal die Firmware auf das sonoff Modul geflasht worden ist, kann in Zukunft ESPEasy direkt unter Tools via HTTP dies durchführen. Es muss dazu kein FTDI Konverter mehr verwendet werden.

==ESPEasy==
[[Datei:sonoff_sw_11.jpg|thumb|left|alt=ESPEasy Devices]]
Wenn das Modul fertig geflasht ist und die Verbindung zum Modul hergestellt ist, können die Einstellungen in ESPEasy durchgeführt werden.
Dazu am Webinterface anmelden und zunächst die zwei Devices definieren.

Der Hersteller hat für das '''Relaise GPIO 12''' und für die '''grüne Led GPIO 13''' vorgesehen. Der '''Taster ist an GPIO 0''' angeschlossen.
<div style="clear:both;"></div>

===Device Schalter===
[[Datei:sonoff_sw_12.jpg|thumb|left|alt=Device Relais]]
Bei den Devices sollten die hier dargestellte Einstellungen beachtet werden. Der Switch (PUMP) sollte auf Input gestellt werden, sodass die anschließenden und benötigten Rules aktiviert werden können.

Da beide Devicenamen gleich benannt wurden (PUMP) wird in Fhem nur ein Device angelegt! Die dazugehörenden Valuenames sind unterschiedlich (Relay, Key).

<div style="clear:both;"></div>

===Device Taster===
[[Datei:sonoff_sw_13.jpg|thumb|left|alt=Device Key]]
Der Taste muss natürlich nur konfiguriert werden, wenn auch händisch am Modul geschaltet werden soll. Wird dies nicht benötigt, können auch die Rules geändert bzw. angepasst werden. Doch alleine zu Testzwecken ist es eine nützliche Sache.
<div style="clear:both;"></div>

===Rules===
[[Datei:sonoff_sw_14.jpg|thumb|left|alt=Rules]]
Da das sonoff Modul auch einen eingebauten Taster hat und somit auch lokal bedient werden kann, sollte man zunächst unter '''Tools / Advanced das Häckchen Rules''' aktivieren, erst dann wird der Tab sichtbar und es können Rules erstellt werden.
<div style="clear:both;"></div>

on PUMP#Key do
if [PUMP#Relay]=1
gpio,12,0
else
gpio,12,1
endif
endon
on PUMP#Relay do
if [PUMP#Relay]=1
gpio,13,0
else
gpio,13,1
endif
endon
Diese Rules ermöglichen, das bei lokaler Bedienung durch den Taster auch die '''Led''' richtig geschaltet wird.
Mit 'on PUMP#Key do' wird geprüft ob die Taste gedrückt ist und schaltet dann entsprechend die Led. Mit den Rules können auch Timer oder sonstige Spielereien realisiert werden. Siehe dazu das [http://www.esp8266.nu/index.php/Tutorial_Rules Tutorial] von ESPeasy.
<div style="clear:both;"></div>

==ESPEasy in Fhem einrichten==
[[Datei:sonoff_sw_9.jpg|thumb|left|alt=Fhem Konfiguration]]
Dies ist eine einfache Darstellung wie Fhem automatisch den Device erstellt.

Damit Fhem mit ESPEasy und dem sonoff Modul kommunizieren kann, muss in der fhem.cfg vorerst nur die espBridge mit dem hier dargestellten Eintrag aktiviert werden.
<div style="clear:both;"></div>
define espBridge ESPEasy bridge 8383
Dies ist eigentlich die einzige Zeile die in fhem.cfg angelegt werden muss. Die restliche Konfiguration wird von Fhem automatisch generiert.

##########################################
### ESPEASY ####
##########################################

define ESPEasy_sonoff_1_PUMP ESPEasy 10.0.0.37 80 espBridge sonoff_1_PUMP
attr ESPEasy_sonoff_1_PUMP IODev espBridge
attr ESPEasy_sonoff_1_PUMP devStateIcon on:rc_GREEN:off off:rc_RED:on absent:rc_BLUE:off gpio:rc_YELLOW:off
attr ESPEasy_sonoff_1_PUMP eventMap /gpio 12 on:on/gpio 12 off:off/gpio 12 gpio:off/gpio 12 output:off/
attr ESPEasy_sonoff_1_PUMP group ESPEasy Device
attr ESPEasy_sonoff_1_PUMP icon hue_filled_outlet
attr ESPEasy_sonoff_1_PUMP room ESPEasy
attr ESPEasy_sonoff_1_PUMP setState 0
attr ESPEasy_sonoff_1_PUMP stateFormat {ReadingsVal($name,"presence","") eq "absent" ? "absent" : ReadingsVal($name,"Relay","")}
attr ESPEasy_sonoff_1_PUMP webCmd :

hier ein Beispiel wie es auch manuell leicht modifiziert werden kann.

[[Datei:sonoff_sw_8.jpg|thumb|left|alt=sonoff Readings]]

Die Readings werden durch die Bridge (Modul ESPEasy) automatisch angelegt.

Es besteht hier noch genug Spielraum um zB. auch noch Temperatursensoren an das Modul anzuschließen und ebenfalls in Fhem darzustellen.
<div style="clear:both;"></div>

==MQTT Server einrichten==
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier geht es ausschließlich um den Sketch von Arends und MQTT an den sonoff Modulen! }}
Es bleibt jedem Anwender die freie Wahl ob die Kommunikation über die ESPEasy-Bridge oder MQTT erfolgen soll. MQTT ist bei der Einrichtung etwas komplexer, da hier auch auf dem Server der Broker installiert werden muss.

Im wesentlichen beschränkt sich die Installation eines MQTT Servers aber auf wenige Arbeitsschritte und ist wie folgt beschrieben durchzuführen. Wer schon einen '''mosquitto''' auf dem Server installiert hat, kann diesen Schritt überspringen.

Dieses Kapitel ist insofern interessant, da mit dem Sketch von Theo Arends auch die Einbindung der neuen sonoff Pow Module bereits möglich ist.

# aus dem mosquitto Repo installieren:
wget http://repo.mosquitto.org/debian/mosquitto-repo.gpg.key
sudo apt-key add mosquitto-repo.gpg.key
cd /etc/apt/sources.list.d/
sudo wget http://repo.mosquitto.org/debian/mosquitto-wheezy.list
# oder für jessie
sudo wget http://repo.mosquitto.org/debian/mosquitto-jessie.list
sudo apt-get update
# mosquitto installieren, sowie client Befehl mosquito_sub (gehört nicht zum Server, wird aber weiter unten benötigt)
sudo apt-get install mosquitto mosquitto-clients

# MQTT Server Test
sudo service mosquitto status

# Start / Stop des Servers
sudo service mosquitto stop
sudo service mosquitto start

# Perl Version ausgeben
perl -v
# Perl MQTT Module nachinstallieren (läuft ein paar Minuten)
sudo cpan install Net::MQTT:Simple
sudo cpan install Net::MQTT:Constants

===Software Arends Sketch===
[[Datei:sonoff_sw_22.jpg|thumb|left|alt=Arends Menü]]

Ebenso bietet sich die Möglichkeit eine andere alternative Software auf den unterschiedlichen Sonoff Modellen aufzuspielen.
Speziell für diese Module zugeschnittene Software stammt vom Autor Theo Arends. Alle hier gezeigten Bildschirmfotos und Beispiele beziehen sich auf Basis der Version 2.0.11 (Stand 11.11.2016).

'''Wichtig:''' erst '''ab Version 2.0.9''' sind die Berechnungsfehler und die Referenzfrequenzen für die Umrechnung der Leistungsdaten gefixt worden! Es wird daher angeraten immer die aktuellste Version zu verwenden.

'''Links zu Theo Arend Github'''

[https://github.com/arendst/Sonoff-MQTT-OTA-Arduino Download MQTT Sketch]

[https://github.com/arendst/Sonoff-MQTT-OTA-Arduino Arend GitHub]

[https://github.com/arendst/Sonoff-MQTT-OTA-Arduino/wiki Wiki]

'''Achtung:''' sollten Probleme mit dem ersten Login im Webinterface auftreten, hat der Autor vorgesorgt und mit speziellem wiederholten Tastendruck können verschiedene Modi aufgerufen werden: zB:

'''3 x Taste kurz drücken''' und eine Smartconfig wird gestartet und die '''SSID''' und das '''Passwort''' kann über diese [https://play.google.com/store/apps/details?id=com.cmmakerclub.iot.esptouch Android App] eingegeben werden.

'''4 x Taste kurz drücken''' und man bringt den Device in den '''Access Point Mode''' mit der IP-Adresse '''192.168.4.1'''.

Bis zu 7 verschiedene Modi sind möglich, mehr dazu in Arends Wiki.

[https://github.com/arendst/Sonoff-MQTT-OTA-Arduino/wiki/Button-usage Link zum Wiki Arends, Button]
<div style="clear:both;"></div>

[[Datei:sonoff_bv_01.jpg|thumb|left|alt=Arduino Boardverwalter]]
In der Arduino IDE unter Datei / Voreinstellungen im Feld "Zusätzliche Boardverwalter-URLs:" den Link: http://arduino.esp8266.com/stable/package_esp8266com_index.json einfügen.

Dann unter '''Werkzeuge / Board / Boardverwalter''' ganz am Ende der Liste die Librarys für "esp8266 by ESP8266 Community" die letzte Version 2.3.0 installieren. [https://forum.fhem.de/index.php/topic,46205.msg534707.html#msg534707 Link zum Board].

Das gesamte sonoff Verzeichnis aus [https://github.com/arendst/Sonoff-MQTT-OTA-Arduino/archive/master.zip Arendts Sketch] entpacken (ist wie hier verlinkt ein Zipfile) und dann aus diesem Verzeichnis die sonoff.ino öffnen. Es können dann alle zu dem Sketch zugehörigen Dateien angesehen/editiert werden.

<div style="clear:both;"></div>
Anschließend muss noch die Datei '''user_config.h''' (im Unterverzeichnis "sonoff") editiert werden. Die Abschnitte

// Wifi
// Syslog
// Ota
// MQTT

müssen mit der eigenen "'''Ip-Adresse-Server'''", "'''SSID'''" und "'''password'''" angepasst werden, das erleichtert den ersten Connect mit dem Modul. Seit der Version 2.1.2 können die WIFI Einstellungen 2-fach angegeben werden, somit wechselt das Device automatisch auf den 2. Wifi Hotspot wenn der erste nicht erreicht wird.

#define STA_SSID "SSID" // Wifi SSID
#define STA_PASS "password" // Wifi password
#define WIFI_HOSTNAME "%s-%04d" // Expands to <MQTT_TOPIC>-<last 4 decimal chars of MAC address>
#define WIFI_CONFIG_TOOL WIFI_WPSCONFIG // Default tool if wifi fails to connect (WIFI_SMARTCONFIG, WIFI_MANAGER or WIFI_WPSCONFIG)

// Syslog
#define SYS_LOG_HOST "Ip-Adresse-Server"
#define SYS_LOG_PORT 514
#define SYS_LOG_LEVEL LOG_LEVEL_NONE
#define SERIAL_LOG_LEVEL LOG_LEVEL_INFO
#define WEB_LOG_LEVEL LOG_LEVEL_INFO

// Ota
#if (ARDUINO >= 168)
#define OTA_URL "http://Ip-Adresse-Server:80/api/arduino/" PROJECT ".ino.bin"
#else
#define OTA_URL "http://Ip-Adresse-Server:80/api/arduino/" PROJECT ".cpp.bin"
#endif

// MQTT
#define MQTT_HOST "Ip-Adresse-Server"
#define MQTT_PORT 1883

'''Wichtig:''' Bei Verwendung des '''sonoff_POW''' muss dies ebenfalls in der user_config.h eingestellt werden, also das "SONOFF" sperren und das "'''SONOFF_POW'''" aktivieren (// setzen/entfernen). Wir dies nicht durchgeführt, werden auch keine Leistungsdaten via MQTT übertragen!!!
Ebenso muss in (%userprofile%\Documents\Arduino\libraries\pubsubclient\src\PubSubClient.h) die Max Packet Size auf 400 erhöht werden!

#define MQTT_MAX_PACKET_SIZE 400
#define MQTT_KEEPALIVE 120
Anpassung der max. Packet Size auf 400 und das Keepalive auf 120

// Enable only one out of three MODULE defines below
//#define MODULE SONOFF // Sonoff, Sonoff SV, Sonoff Dual, Sonoff TH 10A/16A, S20 Smart Socket, 4 Channel
#define MODULE SONOFF_POW // Sonoff Pow

Im Anschluß wird der Sketch mit der Arduino IDE (getestet mit 1.6.12) compiliert und die Binary dann exportiert (Sketch / Kompilierte Binärdatei exportieren). Die erzeugte .bin Datei dann mit dem Tool "ESP8266Flasher.exe" flashen, so wie auch bei ESPEasy. Wer nicht compilieren will, kann auch im Unterverzeichnis ./api/arduino/ die fertige Binary ( sonoff.ino ) benutzen, aber dann ohne Voreinstellung der lokalen IPs.
<div style="clear:both;"></div>

===MQTT testen===
[[Datei:sonoff_sw_20.jpg|thumb|left|alt=Arends Menü]]

Nach erfolgtem Flash des Modules kann das Webinterface des Moduls zum ersten Mal aufgerufen werden (im Router nach der IP des Moduls suchen).

Es bieten sich hier mehrere Möglichkeiten die die weitere Einrichtung des Moduls unterstützen. Einfach die Menüpunkte durchprobieren, sie erklären sich von selbst. Für erste Tests empfiehlt sich die lokale Konsole um die Ereignisse aus Sicht des Modules mit verfolgen zu können. Alles was hier gesendet wird, sollte ebenfalls am Server mitgeloggt werden können. Wenn bis hierher alles funktioniert, kann dann mir der Konfiguration in Fhem beginnen.
<div style="clear:both;"></div>

Am Server jetzt eine Konsole öffnen und folgende Topic (alle) einstellen.

mosquitto_sub -d -v -t \#
Mit dieser Einstellung werden alle Topics geloggt!

pi@raspberry ~ $ mosquitto_sub -d -v -t \#
Received CONNACK
Received SUBACK
Subscribed (mid: 1): 0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/36/temperature', ... (5 bytes))
/sonoff/36/temperature 14.06
Received PUBLISH (d0, q0, r1, m0, '/sonoff/35/Count', ... (3 bytes))
/sonoff/35/Count 0.0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/35/Total', ... (3 bytes))
/sonoff/35/Total 0.0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/35/Time', ... (1 bytes))
/sonoff/35/Time 0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/temperature', ... (5 bytes))
/sonoff/temperature 14.00
Received PUBLISH (d0, q0, r1, m0, '/sonoff/Count', ... (3 bytes))
/sonoff/Count 0.0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/Total', ... (3 bytes))
/sonoff/Total 0.0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/Time', ... (1 bytes))
/sonoff/Time 0
Received PUBLISH (d0, q0, r0, m0, 'stat/sonoff/1/POWER', ... (2 bytes))
stat/sonoff/1/POWER ON
Received PUBLISH (d0, q0, r0, m0, 'stat/sonoff/1/POWER', ... (3 bytes))
stat/sonoff/1/POWER OFF

Interessant sind für uns nun diese Einträge "stat/sonoff/1/POWER ON" , dazu am Taster des sonoff manuell umschalten. Dies entspricht genau der Syntax wie sie im Anschluss in Fhem dann zu verwenden ist.

Mit diesen Einstellungen können dann entweder nach Telemetriedaten oder nach Statusmeldungen gefiltert werden. Dies ist jedoch nur notwendig wenn bereits andere MQTT Devices am Broker hängen und es sonst zu unübersichtlich wird.
mosquitto_sub -h localhost -t tele/sonoff/# = Telemetriedaten
mosquitto_sub -h localhost -t stat/sonoff/# = Statusmeldungen
<div style="clear:both;"></div>

[[Datei:sonoff_sw_21.jpg|thumb|left|alt=Arends Log]]
Sehr nützlich das lokale Log zur Fehlersuche und Inbetriebnahme.

<div style="clear:both;"></div>
Als Besonderheit benutzt der Autor zum Senden und Empfangen unterschiedliche Syntax und unterscheidet dies durch vorangestellte Prefixe vor der eigentlichen Topic.
#define SUB_PREFIX "cmnd" Sonoff devices subscribe to:- cmnd/MQTT_TOPIC and cmnd/MQTT_GRPTOPIC
#define PUB_PREFIX "stat" Sonoff devices publish to:- stat/MQTT_TOPIC
#define PUB_PREFIX2 "tele" Sonoff devices publish telemetry data to:- tele/MQTT_TOPIC/UPTIME, POWER/LIGHT and TIME
Bitte dies unbedingt in der Fhem Konfiguration dann beachten!
<div style="clear:both;"></div>

==MQTT in Fhem einrichten==
[[Datei:sonoff_sw_24.jpg|thumb|left|alt=Fhem sonoff Schalter]]
Dieser einfache Schalter kommuniziert bidirektional mit dem sonoff Device.
<div style="clear:both;"></div>

[[Datei:sonoff_sw_25.jpg|thumb|left|alt=Fhem sonoff Schalter]]
Die Readings in diesem verwendeten Beispiel zeigen sich wie in Fhem gewohnt.
<div style="clear:both;"></div>

Die Einrichtung in Fhem wird von den Modulen 00_MQTT.pm, 10_MQTT_BRIDGE und 10_MQTT_DEVICE.pm unterstützt.

[https://forum.fhem.de/index.php?topic=27532.0 Link zum Forum: MQTT Fhem Einrichtung]

### 1. Broker anlegen ###
define myBroker MQTT 10.0.0.5:1883

### 2. Fhem Device mit MQTT verbinden ###
define Sonoff_Switch MQTT_DEVICE
attr Sonoff_Switch IODev myBroker
attr Sonoff_Switch eventMap ON:on OFF:off
attr Sonoff_Switch icon hue_filled_br30
attr Sonoff_Switch publishSet ON OFF cmnd/sonoff/1/POWER/set
attr Sonoff_Switch room MQTT
attr Sonoff_Switch stateFormat Licht
attr Sonoff_Switch subscribeReading_Licht stat/sonoff/POWER
# oder mit tele, je nachdem was in der user_config.h eingestellt wurde!!!
#attr Sonoff_Switch subscribeReading_Licht tele/sonoff/POWER
attr Sonoff_Switch subscribeReading_state cmnd/sonoff/1/POWER/set
attr Sonoff_Switch webCmd ON:OFF
Der hier dargestellte Beispielcode realisiert die Kommunikation zwischen Fhem und dem sonoff Modul via MQTT Broker. Zu beachten ist hier, dass '''subscribeReading_Licht''' und '''subscribeReading_state''' unterschiedliche Syntax des Topic Strings haben!

==Sonoff POW einrichten==
[[Datei:sonoff_sw_31.jpg|thumb|left|alt=Sonoff POW]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier geht es ausschließlich um das Modul Sonoff POW!}}
Das Modul kommt in gewohnter Itead Qualität und eine derart kostengünstige Energiemessung wird bei Smart Home Anwendern gerne eingesetzt. Die Originalsoftware habe ich nicht einmal getestet, da damit eine Anbindung an Fhem leider nicht möglich ist.

Ebenso möchte kaum jemand an eine nicht dokumentierte chinesische Cloud die Steuerbefehle seiner Schalter senden.
<div style="clear:both;"></div>
[[Datei:sonoff_sw_33.jpg|thumb|left|alt=Sonoff POW]]
Bitte auf keinen Fall das Modul während der Arbeiten an die Netzspannung anschießen. Zum Flashen genügt (und nur diese) die Versorgungspannung des USB-TTL Konverters. Wie auf dem Foto gut erkennbar, wurde dieses Modul ohne einlöten einer Pfostensteckerleiste geflasht. Die Steckverbindung wird einfach in die Lötaugen gesteckt und mit einem Gummiring fixiert, da ja spätere Flashvorgänge im Webif des Models funktionieren und so die Arbeit eingespart werden kann. Es steht jedoch nichts im Wege die Pfostensteckerleiste einzulöten.
<div style="clear:both;"></div>
Die Anschlüsse am Modul sind wie folgt belegt.
o GND
o TxD
o RxD
o VDD

Für den Flashvorgang gelten die selben Regeln wie schon beim sonoff Switch oben erwähnt (3,3V!).
<div style="clear:both;"></div>

===Sonoff POW Software===
[[Datei:sonoff_sw_35.jpg|thumb|left|alt=Sonoff POW FHEM]]
Als Software steht im Augenblick nur der Sketch von Arends zur Verfügung, liefert aber alles was das Herz begehrt und ist ist einfach zu handhaben. Hier eine eine einfache Darstellung mit der aktuellen Leistung und dem Tagesverbrauch. Zusätzlich besteht auch noch die Möglichkeit den angeschlossenen Verbraucher Ein- oder Auszuschalten. Getestet wurde hier mit der Version 2.06, 2.07 und 2.019a von Arends.
<div style="clear:both;"></div>
[[Datei:sonoff_pow_02.jpg|thumb|left|alt=Sonoff POW Webif]]
Seit Version 2.0.19a ist auch die Leistungsanzeige im WEBIF wie im Bild links integriert. Auch der Energieverbrauch des Vortages wird mit angezeigt. Alle hier angezeigten Daten werden auch zyklisch im MQTT String an FHEM übergeben.

Zusätzlich kann im Sketch auch das Feature "'''Power_Limit'''" aktiviert werden ( #define FEATURE_POWER_LIMIT in der sonoff.ino). Wenn dies gewünscht ist, dann vor dem compilieren die beiden // entfernen. Mit dem Power_Limit wird eine zusätzliche Nachricht erzeugt, wenn ein bestimmter einstellbarer Grenzwert über- oder unterschritten wird.

Es lassen sich dadurch Meldungen wie "Waschmaschine fertig" oder ähnliches ohne weitere Schwellwert Überwachungen in FHEM ableiten. Die Meldungen kommen in MQTT mit "'''tele/sonoff/POWER_LOW ON'''" bzw. "'''tele/sonoff/POWER_LOW OFF'''".
<div style="clear:both;"></div>
Bevor der Sketch compiliert wird, müssen neben den IP-Einstellungen noch in der user_config.h auch andere Einstellungen vorgenommen werden.

#define MODULE SONOFF_POW // Hardware module type (SONOFF, SONOFF_POW or ELECTRO_DRAGON)
#define PROJECT "sonoffpow" // PROJECT is used as the default topic delimiter and OTA file name // As an IDE restriction it needs to be the same as the main .ino file

Der Typ des Modules muss von "SONOFF" auf "'''SONOFF_Pow'''" geändert werden,. damit die Software weiß mit welchem Modul es zu tun hat und kann dann die entsprechenden Berechnungen durchführen. Die Leistungsdaten kommen ja in Form einer Frequenz aus dem Baustein und müssen im Sketch (xsns_hlw8102.ino) umgerechnet werden.

#elif MODULE == SONOFF_POW // programming header 1:3.3V 2:rx 3:tx 4:gnd
#define APP_NAME "Sonoff Pow module"
#define USE_POWERMONITOR // Enable Power Monitoring
#define USE_POWERCALIBRATION // Enable setting Calibration parameters by user commands

Bei Einsatz des POW Modules kann die externe Kalibrierung aktiviert werden.

Definition aus der power.ino (2.0.9) für die korrekte Umrechnung der gelieferten Frequenzen für die Leistungsdaten.
#define HLW_PREF 10000 // 1000.0W
#define HLW_UREF 2200 // 220.0V
#define HLW_IREF 4545 // 4.545A

#define HLW_PREF_PULSE 4975 // 4975us = 201Hz = 1000W
#define HLW_UREF_PULSE 1666 // 1666us = 600Hz = 220V
#define HLW_IREF_PULSE 1666 // 1666us = 600Hz = 4.545A

<div style="clear:both;"></div>
[[Datei:sonoff_sw_36.jpg|thumb|left|alt=Sonoff POW Attribute]]
Dieses Bild zeigt die Attribute die vom Modul via MQTT an FHEM geliefert werden.
<div style="clear:both;"></div>
aktuell gelieferte Readings (Mqtt Strings) vom Sketch nach unten dargestellter Definition in Fhem.
tele/sonoffpow/TODAY_ENERGY
tele/sonoffpow/PERIOD_ENERGY
tele/sonoffpow/POWER_FACTOR
tele/sonoffpow/CURRENT_POWER
tele/sonoffpow/VOLTAGE
tele/sonoffpow/CURRENT

Hier ein Mittschnitt des Datenverkehrs zum Broker zwecks Kontrolle der korrekten Funktion der Module und der Software.
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/RSSI', ... (2 bytes))
tele/sonoff/RSSI 82
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/TEMPERATURE', ... (3 bytes))
tele/sonoff/TEMPERATURE 1.9
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/HUMIDITY', ... (4 bytes))
tele/sonoff/HUMIDITY 97.9
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/POWER', ... (3 bytes))
tele/sonoff/POWER OFF
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/TIME', ... (19 bytes))
tele/sonoff/TIME 2016-11-12T10:36:13
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/UPTIME', ... (1 bytes))
tele/sonoffpow/UPTIME 1
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/RSSI', ... (2 bytes))
tele/sonoffpow/RSSI 34
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/TODAY_ENERGY', ... (5 bytes))
tele/sonoffpow/TODAY_ENERGY 0.083
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/PERIOD_ENERGY', ... (1 bytes))
tele/sonoffpow/PERIOD_ENERGY 8
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/CURRENT_POWER', ... (2 bytes))
tele/sonoffpow/CURRENT_POWER 97
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/POWER_FACTOR', ... (4 bytes))
tele/sonoffpow/POWER_FACTOR 1.00
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/VOLTAGE', ... (3 bytes))
tele/sonoffpow/VOLTAGE 225
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/CURRENT', ... (5 bytes))
tele/sonoffpow/CURRENT 0.426
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/POWER', ... (2 bytes))
tele/sonoffpow/POWER ON
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/TIME', ... (19 bytes))
tele/sonoffpow/TIME 2016-11-12T10:36:28
Sending PINGREQ
Received PINGRESP

Die Einstellungen können mit folgender Syntax angefordert werden (zwei Terminalfenster öffnen, eines zum protokollieren und eines zum Seden der Befehle).
mosquitto_sub -d -v -t \# MQTT Datenverkehr protokolieren
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/status/set -m "8" = SonoffPOW Status jetzt auslesen
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/TelePeriod/set -m "60" = Timer setzen, alle 60 Sekunden Daten senden
Die Kommandos können direkt am Broker (Terminalfenster Putty etc.) abgesetzt werden.

<div style="clear:both;"></div>

=== Sonoff POW Kalibrieren ===
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier wird beschrieben, wie der ''Sonoff POW kalibriert'' werden kann. }}
Ab Version 2.0.11 kann nun auch der POW kalibriert werden.
Dazu kann man 2 Konsolenfenster öffnen, im ersten aktiviert man das Protokoll für den Datenverkehr
mosquitto_sub -d -v -t \# MQTT Datenverkehr protokollieren

Dann kann mit folgenden Befehlen die HLW Referenz Pulsfrequenz gesetzt werden.
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/HLWUCAL/set -m "2100" default = 1950
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/HLWICAL/set -m "2450" default = 3500
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/HLWPCAL/set -m "13500" default = 12345
Entweder man hat eine definierte Last zur Verfügung oder besser man misst mit einem Leistungsmesser nach. Die Spannung kann man mit einem Multimeter nachmessen (sollte 230 V sein) und der Strom wird errechnet (bei 100 Watt I = P / U ) = 100/230 = 0,4347.
Die Referenzwerte solange geringfügig ändern bis die Ausgabe passt. Für die Ausgabe wird einfach eine Statusabfrage durchgeführt.

mosquitto_pub -q 2 -t cmnd/sonoffpow/1/status/set -m "8"
Befehl für die Statusabfrage

cmnd/sonoffpow/1/status/set 8
Received PUBLISH (d0, q0, r0, m0, 'stat/sonoffpow/1/STATUS', ... (103 bytes))
stat/sonoffpow/1/STATUS PWR: Voltage 225 V, Current 0.427 A, Current Power 98 W, Total Power Today 0.080 kWh, Power Factor 1.00
Ergebnis der Statusabfrage mit Spannung, Strom und Leistung.

<div style="clear:both;"></div>

===Sonoff POW FHEM Anbindung===
Ein Beispiel einer einfachen Anbindung via MQTT an Fhem. MQTT ist insofern notwendig, da in der Software ESPEasy und der Bridge noch keine Implementierung der Frequenzumrechnung enthalten ist.

define Sonoff_Pow MQTT_DEVICE
attr Sonoff_Pow IODev myBroker
attr Sonoff_Pow eventMap ON:on OFF:off
attr Sonoff_Pow icon measure_power
attr Sonoff_Pow publishSet ON OFF cmnd/sonoffpow/1/POWER/set
attr Sonoff_Pow room MQTT
attr Sonoff_Pow subscribeReading_Power tele/sonoffpow/POWER
attr Sonoff_Pow subscribeReading_state cmnd/sonoffpow/1/POWER/set
attr Sonoff_Pow subscribeReading_TODAY_ENERGY tele/sonoffpow/TODAY_ENERGY
attr Sonoff_Pow subscribeReading_PERIOD_ENERGY tele/sonoffpow/PERIOD_ENERGY
attr Sonoff_Pow subscribeReading_CURRENT_POWER tele/sonoffpow/CURRENT_POWER
attr Sonoff_Pow subscribeReading_VOLTAGE tele/sonoffpow/VOLTAGE
attr Sonoff_Pow subscribeReading_CURRENT tele/sonoffpow/CURRENT
attr Sonoff_Pow subscribeReading_AKTUELL stat/sonoffpow/1/STATUS
attr Sonoff_Pow webCmd ON:OFF
attr Sonoff_Pow stateFormat {sprintf("akutelle Leistung: %.1f W Tagesverbrauch: %.2f Kw/h", ReadingsVal($name,"CURRENT_POWER",undef), ReadingsVal($name,"TODAY_ENERGY",undef))}
Zusätzlich kann hier noch das Relais mit "on" und "off" ein- ausgeschaltet werden. Ab Version 2.0.15 wurden hier die ReadingsNamen auf TODAY_ENERGY und PERIOD_ENERGY (anstatt _POWER) geändert.

===Sonoff POW Netz-Anschluß===
[[Datei:sonoff_sw_34.jpg|thumb|left|alt=Sonoff POW Netzanschluß]]
Erst wenn alle Arbeiten an der Hard- und Software abgeschlossen sind, kann man das Modul an die Netzspannung anschließen. Wer es sich einfach machen will, nimmt eine Industriell gefertigte 230 V Verlängerung (zwischen 1,5 - 3 Meter) und schneidet sie in der Mitte durch. Nach dem abisolieren der flexiblen Drähte sollte diese '''verlötet oder mit Aderendhülsen''' versehen werden (müssen aber exakt passen, da hier kaum Platz in den Klemmen ist).
Mit einem kleinen Schraubendreher kann man die Feder der Klemmen niederdrücken und das verzinnte Drahtende tief ich die Öffnung stecken. Es dürfen keine Drahtlitzen aus den Öffnungen sichtbar sein, Kurzschlußgefahr! Ebenso sollte eine Zugprobe durchgeführt werden ob die Klemme auch richtig eingerastet ist.

'''ACHTUNG:''' diese Arbeiten müssen von einem ausgebildeten Fachpersonal (Elektriker) durchgeführt werden, Lebensgefahr!
<div style="clear:both;"></div>

===Sonoff POW Design===

====ReadingsGroup normal====
[[Datei:sonoff_sw_46.jpg|thumb|left|alt=Sonoff POW Design]]
Viele Benutzer wollen schönere und funktionelle Ausgaben am Bildschirm sehen. Die Möglichkeiten nach oben sind hier sehr vielfältig. Anhand von zwei einfachen aber mächtigen Funktionen hier ein kleines Beispiel wie hier im Bild dargestellt.

Was das Design betrifft, sind hier mehrere Möglichkeiten gegeben und nach oben ist für findige Anwender alles offen.

<div style="clear:both;"></div>

Zunächst wird mit dem Hilfsmodul "'''average'''" eine Art Statistik (Durchschnittsberechnung, Min.,Max., etc.) hinzugefügt. Das beschränkt sich auf eine einzige Zeile. Es würde sich auch '''statistic''' dazu eignen.

define Sonoff_Pow_CURRENT_POWER average Sonoff_Pow:CURRENT_POWER.*
Die "average" Funktion wird in das Device "Sonof_Pow" auf das Reading "CURRENT_POWER" hinzugefügt.

Der zweite Schritt wird eine '''readingsGroup''' mit den gewünschten und gefilterten Ausgabedaten. Durch die verschiedenen IF Abfragen der unterschiedlichen VALUE wird bei über- oder unterschreiten eines Wertes eine bestimmte Farbe angewandt. Weitere Beispiele dazu siehe im Wiki unter [http://www.fhemwiki.de/wiki/ReadingsGroup readingsGroup]

define SonoffPows readingsGroup <%measure_power>,<aktuell>,<Tag>,<Strom>,<Durchschnitt>,<max.P>,<Schaltzyklen>,< hr > .*(Sonoff_Pow|Sonoff_Pow2):CURRENT_POWER,TODAY_ENERGY,CURRENT,CURRENT_POWER_avg_day,CURRENT_POWER_max_day,PERIOD_ENERGY
attr SonoffPows mapping %ALIAS
attr SonoffPows nameStyle style="color:yellow"
attr SonoffPows room MQTT
attr SonoffPows valueFormat {'CURRENT_POWER' =>"%.0f W", 'TODAY_ENERGY' =>"%.2f Kw", 'CURRENT' =>"%.2f A",'CURRENT_POWER_max_day' => "%.0f W",'CURRENT_POWER_avg_day' => "%.2f W",'PERIOD_ENERGY'=>"%.0f Zyklen"}
attr SonoffPows valueStyle { if($READING eq "CURRENT_POWER" && $VALUE >= 0 && $VALUE <= 100){ 'style="color:green;;text-align:right"' }elsif( $READING eq "CURRENT_POWER" && $VALUE > 100 && $VALUE < 200){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER" && $VALUE >= 200){ 'style="color:red;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE >= 4.8){ 'style="color:red;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE <= 2.5){ 'style="color:green;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE > 2.5 && $VALUE < 4.8 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT" && $VALUE <= 0.45){'style="color:green;;text-align:right"'}elsif( $READING eq "CURRENT" && $VALUE > 0.45 && $VALUE < 0.87 ){'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT" && $VALUE >= 0.87){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE <= 100){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE > 100 && $VALUE < 200 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE >= 200){ 'style="color:red;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE <= 10){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE > 10 && $VALUE < 15 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE >= 15){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE <= 100){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE > 100 && $VALUE < 200 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE >= 200){ 'style="color:red;;text-align:right"' } }

Die readingsGroup sind etwas komplex zu lesen, aber nach etwas Einarbeitung klappt das schon. Die in diesem Beispiel verwendeten Readingsnamen beziehen sich auf die Beispielkonfigurationen hier im Wiki.
<div style="clear:both;"></div>

<div style="clear:both;"></div>
====ReadingsGroup mit Schaltmöglichkeit====
[[Datei:sonoff_pow_03.jpg|thumb|left|alt=readingsGroup mit Schalter]]
Die vorher erwähnte ReadingsGroup kann auch gleich mit einem Schalter versehen werden um den POW Ein- oder Aus schalten zu können. Dazu ist aber eine andere Einstellung im Sketch erforderlich.
<div style="clear:both;"></div>

In der "'''user_config.h'''" muss an dieser Stelle auch die "'''PUB_PREFIX'''" auf die gleiche Topic wie "PUB_PREFIX2" eingestellt werden. Durch diese Maßnahme wird erreicht, dass sofort nach dem Knopfdruck auch der Status mit der Topic "tele" übertragen wird. Würde der weiterhin mit "stat" übertragen, kann er in der Readingsgroup nur sehr umständlich weiter behandelt werden. Dadurch wird erreicht, dass der Schalter sofort nach dem Schaltvorgang und der Rückmeldung (Status) auch seine Farbe ändert. Wird dieser Eintrag vergessen, ändert der Schalter erst nach Eintreffen der nächsten zyklischen Abfrage seinen Status/Farbe.

#define SUB_PREFIX "cmnd" // Sonoff devices subscribe to:- SUB_PREFIX/MQTT_TOPIC and SUB_PREFIX/MQTT_GRPTOPIC
#define PUB_PREFIX "tele" // Sonoff devices publish to:- PUB_PREFIX/MQTT_TOPIC
#define PUB_PREFIX2 "tele" // Sonoff devices publish telemetry data to:- PUB_PREFIX2/MQTT_TOPIC/UPTIME, POWER/LIGHT and TIME
hier die PUB_PREFIX mit der geänderten Topic "tele" anstatt "stat"

define SonoffPows readingsGroup <%measure_power>,<aktuell>,<Tag>,<Gestern>,<Strom>,<Durchschnitt>,<max.P>,<Zyklus>,<Faktor>,<Status>,< hr > .*(Sonoff_Pow|Sonoff_Pow2|Sonoff_Pow3):CURRENT_POWER,TODAY_ENERGY,YESTERDAY_ENERGY,CURRENT,CURRENT_POWER_avg_day,CURRENT_POWER_max_day,PERIOD_ENERGY,POWER_FACTOR,LIGHT
attr SonoffPows commands {'LIGHT.ON' => 'set $DEVICE OFF','LIGHT.OFF' => 'set $DEVICE ON'}
attr SonoffPows mapping %ALIAS
attr SonoffPows nameStyle style="color:yellow"
attr SonoffPows room Energie,MQTT
attr SonoffPows valueFormat {'CURRENT_POWER' =>"%.0f W", 'TODAY_ENERGY' =>"%.2f Kw",'YESTERDAY_ENERGY' =>"%.2f Kw", 'CURRENT' =>"%.2f A",'CURRENT_POWER_max_day' => "%.0f W",'CURRENT_POWER_avg_day' => "%.2f W",'CURRENT_POWER'=>"%.0f W",'POWER_FACTOR' => "%.2f "}
attr SonoffPows valueIcon {'LIGHT.ON' => 'rc_GREEN@green', 'LIGHT.OFF' => 'rc_RED@red'}
attr SonoffPows valueStyle { if($READING eq "CURRENT_POWER" && $VALUE >= 0 && $VALUE <= 100){ 'style="color:green;;text-align:right"' }elsif( $READING eq "CURRENT_POWER" && $VALUE > 100 && $VALUE < 200){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER" && $VALUE >= 200){ 'style="color:red;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE >= 4.8){ 'style="color:red;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE <= 2.5){ 'style="color:green;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE > 2.5 && $VALUE < 4.8 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "YESTERDAY_ENERGY" && $VALUE <= 2.5){ 'style="color:green;;text-align:right"' }elsif( $READING eq "YESTERDAY_ENERGY" && $VALUE > 2.5 && $VALUE < 4.8 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "YESTERDAY_ENERGY" && $VALUE >= 4.8){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT" && $VALUE <= 0.45){'style="color:green;;text-align:right"'}elsif( $READING eq "CURRENT" && $VALUE > 0.45 && $VALUE < 0.87 ){'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT" && $VALUE >= 0.87){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE <= 100){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE > 100 && $VALUE < 200 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE >= 200){ 'style="color:red;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE <= 10){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE > 10 && $VALUE < 15 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE >= 15){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE <= 100){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE > 100 && $VALUE < 200 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE >= 200){ 'style="color:red;;text-align:right"' } }
hier die erweiterte ReadingsGroup mit dem Schalter. Bei Bedarf sind hier die Devicenamen anzupassen wenn andere Namen verwendet werden (Sonoff_Pow|Sonoff_Pow2|Sonoff_Pow3).

<div style="clear:both;"></div>

====POW mit FTUI anzeigen====
[[Datei:sonoff_pow_energy.JPG|thumb|left|alt=Tablett FTUI]]
Wer möchte kann die Energieanzeigen auch mit der [https://forum.fhem.de/index.php/topic,34233.0.html Tablett UI] für eine Tablet Ansicht gestalten. Mit dieser stehen viele Möglichkeiten zu einer attraktiven Darstellung zur Verfügung.
Hier ein Beispiel welches mit den Widget "[http://www.fhemwiki.de/wiki/FHEM_Tablet_UI#Widget_THERMOSTAT thermostat]" dargestellt ist.
<div style="clear:both;"></div>

==Sonoff Slampher Flashen==
[[Datei:sonoff_sl_53.jpg|thumb|left|alt=Sonoff SLAMPHER]]
Dieses Modul ist eine Besonderheit was das Flashen betrifft, denn mit Hilfe des Tasters kann der ESP8266 NICHT in den Flashmode gebracht werden. Der Taster ist intern anderwärtig verdrahtet und somit für diesen Zweck nicht zu gebrauchen.

Wie hier links im Bild zu sehen ist, muss der rechte Pin des R20 (oben im Bild) während dem Einstecken des USB Steckers auf Masse gelegt werden. Die beste Möglichkeit ist ein Stücken Draht anzulöten und diesen dann beim einstecken auf den Masse Pin des USB-Konverters zu legen.

Pinbelegung des Steckers von oben nach unten:
o - GND
o - TxD
o - RxD
'''o''' - Vdd

<div style="clear:both;"></div>

[[Datei:sonoff_sl_51.jpg|thumb|left|alt=Sonoff SLAMPHER R20]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier ist genau ersichtlich, wo der R20 auf der Platine platziert ist. }}
Hier nocheinmal schön zu sehen wo der R20 (der ist nicht eingelötet sondern leer) exakt auf der Platine liegt, gemeint ist der rechte Pin. Hier kann auch leicht gelötet werden, da keine empfindlichen Bauteile in der Nähe sind und auch genug Platz vorhanden ist.

<div style="clear:both;"></div>
[[Datei:sonoff_sl_50.jpg|thumb|left|alt=Sonoff SLAMPHER R20]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier ist genau ersichtlich, wo der Draht am R20 aufgelötet wurde }}
Hier ist ein kleines Stück Schaltdraht auf den Pin bereist aufgelötet und bereit zum Flashen!

In diesem Beispiel wurde keine Pfostensteckerleiste auf die Platine aufgelötet, sondern nur durchgesteckt und mit einem Gummiring zum Relais fixiert, das erspart den Lötvorgang, weil in Zukunft dann ohnehin OTA geflasht werden kann.

Also Pin20 auf Masse legen und USB-Konverter an den PC einstecken, dann den Draht von der Masse entfernen. Der ESP8266 sollte jetzt im Flashmodus bereit stehen und kann wie bereits oben beschrieben geflasht werden.

<div style="clear:both;"></div>

===Sonoff Slampher Software===
[[Datei:sonoff_sl_54.jpg|thumb|left|alt=Sonoff SLAMPHER FHEM]]

Als Software wird Arends Sketch installiert (Kommunikation über MQTT), da zum derzeitigen Zeitpunkt ESPEasy das Modul noch nicht integriert hat und somit auch nicht ansteuern kann.
<div style="clear:both;"></div>

define Sonoff_SL MQTT_DEVICE
attr Sonoff_SL IODev myBroker
attr Sonoff_SL devStateIcon ON:rc_GREEN:OFF OFF:rc_RED:ON
attr Sonoff_SL icon hue_filled_br30
attr Sonoff_SL publishSet ON OFF cmnd/sonoffsl/1/POWER/set
attr Sonoff_SL room Bewegung,_Sonoff
attr Sonoff_SL stateFormat Licht
attr Sonoff_SL subscribeReading_Licht tele/sonoffsl/POWER
attr Sonoff_SL subscribeReading_state cmnd/sonoffsl/1/POWER/set
attr Sonoff_SL webCmd ON:OFF

Hier ein Beispiel wie in FHEM der Slampher eingebunden werden kann. In diesem Beispiel wird davon ausgegangen, das das Modul "sonoffsl" unter Konfiguration am WEBIF (Configure MQTT bei Topic) so unbenannt wurde. Wer einen anderen Namen haben möchte, muss dies dann auch in FHEM entsprechend anpassen.

<div style="clear:both;"></div>

==Sonoff Th10/16 FHEM==
[[Datei:sonoff_th_01.jpg|thumb|left|alt=Sonoff TH10]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Temperatur Modul TH10 / 16! }}
Das Modul kann durch drücken des Tasters während dem Einstecken des USB-Konverters in den Flashmodus gebracht werden.
Der Th10/16 kann mit zwei unterschiedlichen Typen von Sensoren bestückt werden, hier im Beispiel mit dem externen Temperaturfühler DS18B20.

Wie im Bild klar zu sehen ist, kann das Webif auch zur Darstellung via Mobile verwendet werden. Mit "Toggle" wird Ein- oder Aus geschaltet und darunter ist die aktuelle Temperatur ersichtlich. Für diese Ansicht muss keine MQTT Verbindung eingerichtet werden, da die Kommunikation hier rein über HTTP erfolgt.

Die unten dargestellten Beispiele für FHEM beziehen sich auf Arends Sketch, also über MQTT. Dieses Modul kann aber genauso leicht über ESPEasy und der ESPEasy-Bridge eingebunden werden.

<div style="clear:both;"></div>
Pinbelegung des Steckers von oben nach unten:
o - GND
o - TxD
o - RxD
'''o''' - Vdd

#define DSB_PIN 14 // GPIO 14 = DS18x20 (Sonoff_TH10A(16A), Sonoff SV)
#define DSB_RESOLUTION 2 // Maximum number of decimals (0 - 3) showing Temperature
// *** Option 1 - Single DS18B20 - Select either Option 1 OR Option 2
#define SEND_TELEMETRY_DS18B20 // Enable sending single temperature telemetry
// *** Option 2 - Multiple DS18B20 and/or DS18S20 (needs OneWire library!)
// #define SEND_TELEMETRY_DS18x20 // Enable sending multi temperature telemetry
In der user_config.h (Arends Sketch) muss hier die Option 1 aktiviert werden (entfernen der vorangestellten //) damit die Telemetriedaten auch gesendet werden. Es empfiehlt sich mindestens die Version >= V 2.0.16, weil hier die Sensoren erweitert wurden.

#define DHT_PIN 14 // GPIO 14 = AM2301 (Sonoff_TH10A(16A), Sonoff SV)
#define DHT_TYPE AM2301 // DHT module type (DHT11, DHT21, DHT22, AM2301, AM2302 or AM2321)
#define DHT_RESOLUTION 1 // Maximum number of decimals (0 - 3) showing Temperature
#define SEND_TELEMETRY_DHT // Enable sending temperature and humidity telemetry
Beispiel für den Sensor DHT22, Temperatur und Luftfeuchte. Es dürfen aber nicht beide Sensoren (DS18B20 + DHT22) gleichzeitig aktiviert werden, da ja beide an GPIO14 angehängt werden und es ansonsten zu Fehlfunktionen kommen würde.

<div style="clear:both;"></div>
[[Datei:sonoff_th_02.jpg|thumb|left|alt=Sonoff TH10]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Einbindung in Fhem via MQTT! }}
<div style="clear:both;"></div>

### Temperatur und Luftfeuchte vom Sonoff Switch ###
define Sonoff_Temp MQTT_DEVICE
attr Sonoff_Temp IODev myBroker
attr Sonoff_Temp alias Pool Wasser
attr Sonoff_Temp eventMap ON:on OFF:off
attr Sonoff_Temp icon temperature_humidity
attr Sonoff_Temp publishSet ON OFF cmnd/sonoffth/1/POWER/set
attr Sonoff_Temp room _Sonoff
attr Sonoff_Temp stateFormat {sprintf("Temperatur: %.1f Grad", ReadingsVal($name,"TEMPERATURE",0))}
attr Sonoff_Temp subscribeReading_TEMPERATURE tele/sonoffth/DS18B20/TEMPERATURE
attr Sonoff_Temp subscribeReading_humidity tele/sonoffth/HUMIDITY
attr Sonoff_Temp subscribeReading_state cmnd/sonoffth/1/POWER/set
Beispiel für FHEM mit Temperaturanzeige mit DS18B20

define Sonoff_Switch MQTT_DEVICE
attr Sonoff_Switch IODev myBroker
attr Sonoff_Switch alias Pool Licht
attr Sonoff_Switch devStateIcon on:rc_GREEN:off off:rc_RED:on
attr Sonoff_Switch eventMap ON:on OFF:off
attr Sonoff_Switch icon light_ceiling
attr Sonoff_Switch publishSet ON OFF cmnd/sonoffth/1/POWER/set
attr Sonoff_Switch room _Sonoff
attr Sonoff_Switch stateFormat Licht
attr Sonoff_Switch subscribeReading_Licht tele/sonoffth/POWER
attr Sonoff_Switch subscribeReading_state cmnd/sonoffth/1/POWER/set
attr Sonoff_Switch webCmd ON:OFF
Der Schalter nochmals seperat dargestellt, je nach Geschmack.

<div style="clear:both;"></div>

==Sonoff CH4 4-Kanal Schaltmodul==
[[Datei:sonoff_ch4_1.jpg|thumb|left|alt=Sonoff CH4]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Achtung andere Einstellungen der Arduino IDE: Select Board "Generic ESP8285 Module" (=Flash Mode "DOUT") and Flash Size "1M (64K SPIFFS)"n! }}

Der Sonoff CH4 ist mit seinen 4 Kanälen ein sehr preiswertes Modul im Gehäuse und für Hutschinenmontage. Anstatt des üblichen ESP8266 besitzt dieses Modul schon den moderneren '''ESP8285'''. Es müssen daher in der Arduino IDE andere Einstellungen vorgenommen werden. Unter Board wird hier das "'''Generic 8285 Module'''" mit '''1M und 64K Spiffs''' angewählt. Der Flashmode "'''DOUT'''" wird dann automatisch eingestellt, bzw. ausgeblendet.

Das Modul ist etwas größer als die anderen Sonoff Produkte und besitzt mit 14,5 x 9 cm schon beachtliche Einbau Maße.
<div style="clear:both;"></div>
[[Datei:sonoff_ch4_2.jpg|thumb|left|alt=Sonoff CH4 FDTI]]
Als weitere Besonderheit sei hier erwähnt, das die Signale '''RxD auf RxD und TxD auf TxD''' des FTDI Konverters zu verbinden sind. Wie bei allen Sonoff Modulen darf man '''zum flashen keine Netzspannung anschließen''', sondern nur über die Versorgungsspannung des FDTI Konverters mit 3,3 V versorgen (Jumper richtig setzen). Die Stiftleiste für den FTDI Anschluß ist hier schon eingelötet.

In den Flashmodus gelangt man durch drücken der '''Taste FW/IO0''' während des einstecken des USB Anschlusses.
<div style="clear:both;"></div>
[[Datei:sonoff_ch4_3.jpg|thumb|left|alt=Sonoff CH4 Arends]]
Hier die Ansicht des Webinterface des Arends Sketches!
Bei der Software sei erwähnt, das die getestete Version 3.1.16 nur bei Kanal 1 den Modus "PulseTime" beherrscht. Wer also gepulste Ausgänge (zB: elektrische Garage/Toröffner) benötigt muss diese per Software nachbilden oder mit dem Kanal 1 auskommen. Eine "Pulsetime 10" ist ein guter Wert dafür (etwa 1 Sekunde).

Als Alternative kann mit dieser HTML Seite des Webservers am Modul des CH4 schon mit jedem Browser fähigem Handy (Android, iPhone, Windows) aufgerufen werden und somit alle Funktionen gesteuert werden.
<div style="clear:both;"></div>
[[Datei:sonoff_ch4_4.jpg|thumb|left|alt=Sonoff CH4 Software APP]]
Hier dargestellt die Original Software die Sonoff zum Modul liefert (EWeLink) und über ihre Cloud verbindet. Leider kann hier keine gepulste Ausgabe erfolgen. Mit einem Countdown kann zwar der Ausgang wieder abgeschaltet werden, die kleinste Zeiteinheit ist aber 1 Minute und somit für einen Impuls leider nicht zu gebrauchen. Ebenso kann mit dieser Software keine Einbindung in Fhem erfolgen, obwohl es eine nette anschauliche Darstellung ist.
<div style="clear:both;"></div>

=Erweiterungen=
<div style="clear:both;"></div>

==Sonoff Switch mit Temperatur + Luftfeuchte==
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier geht es um nützliche Hardware Erweiterungen an den Originalmodulen!}}
Wozu überhaupt den Switch erweitern wenn es auch die Modelle TH10 und TH16 gibt?

Manche Personen können dadurch dem Basteltrieb nachkommen, aber das wesentliche ist der Preis, da die Switches doch fast um die Hälfte billiger sind. Die Sensoren kosten ebenfalls kaum nennenswerte Beträge.

Oder es hat schon jemand Switches im Einsatz und möchte jetzt zusätzlich die Temperatur erfassen!

<div style="clear:both;"></div>

=== Hardware erweitern mit DHT22 ===
[[Datei:sonoff_sw_4.PNG|thumb|left|alt=Sonoff Switch Pinleiste mit Temperatur]]
Am Sonoff Switch wurde ja schon eine Stiftleiste zum Flashen eingelötet. Diese Stiftleiste bietet schon alle Anschlüsse welche für die Temperatur- und Luftfeuchtemessung benötigt werden. Am 5. Anschluß der Stifftleiste ist das Signal "SCL" (GPIO14) herausgeführt, welches für den DHT22 zur Erfassung der Messdaten benötigt wird. Der Sonsor wird mit einem einem 3-poligen Kabel (zB: ein Steckkabel für ein Breadboard oder direkt anlöten) verbunden. Damit der DHT22 korrekt funktioniert, wird ein Widerstand mit 4,7 K Ohm zwischen Vdd und Data am DHT22 zusätzlich benötigt.

<div style="clear:both;"></div>

[[Datei:sonoff_sw_45.jpg|thumb|left|alt=AM2302 / DHT22]]

Ansicht des DHT22 (AM2302) mit den aufgesteckten Verbindungskabeln. Von links nach rechts sind das

1 = VCC 3,3 V
2 = Data
3 = nc (nicht belegt)
4 = GND

Pin1 (VCC) des DHT22 muss also auf Pin1 der Stiftleiste, Pin2 (Data) auf Pin5 und Pin4 (GND) auf Pin4.
Pin2 und Pin1 soll hier noch der Widerstand aufgelötet werden.

1 ------- 1 (VDD)
2 ------- 5 (GPIO14)
3
4 ------- 4 (GND)
DHT22 Stiftleiste

<div style="clear:both;"></div>

[[Datei:sonoff_sw_44.jpg|thumb|left|alt=umgebautes Modul]]
Diese Darstellung zeigt das umgebaute und bereits verschlossene Modul. Auf der Seite des Tasters (bitte nur hier, da auf der anderen Seite die 230 V verlaufen und neben der Lebensgefahr auch den Sensor beeinflussen) ist hier einfach mit einer Eisensäge ein Schlitz eingesägt, der dient in diesem Falle als Kabeldurchführung. Ein Schlitz ist besser als ein Loch, da der Oberteil des Gehäuses sich leichter aufsetzen läßt. Wer ein längeres Kabel benötigt, kann natürlich auch ein 3-poliges Telefonkabel (oder Mikrokabel oder sonstiges) verwenden. Der Sensor sollte etwas Abstand zum Gehäuse haben, da dieses auch eine Eigenerwärmung hat. Wer es ganz originalgetreu lösen will, kann auch eine 3-polige Mini Buchse für Klinckenstecker (3,5mm) einbauen so wie sie am TH10/16 vorhanden ist.
<div style="clear:both;"></div>

=== Software anpassen am Beispiel MQTT ===
[[Datei:sonoff_sw_40.jpg|thumb|left|alt=Sonoff MQTT]]

Wer über MQTT kommuniziert und die Software von Theo Arends benutzt, muss folgende Dinge beachten. In der Datei '''user_config.h''' müssen im Abschnitt '''Module = SONOFF''' die Slashes so wie unten dargestellt entfernt werden, damit erstens die Interrupts abgefragt werden und zweitens die Telemetriedaten gesendet werden. Ebenso ist der verwendete Sensor bei "'''define DHT_TYPE'''" eingestellt werden. In dem hier gezeigten Beispiel also "'''DHT22'''".

#if MODULE == SONOFF // programming header 1:3.3V 2:rx 3:tx 4:gnd
#define APP_NAME "Sonoff module"
#define LED_PIN 13 // GPIO 13 = Green/Blue Led (0 = On, 1 = Off) - Sonoff
#define LED_INVERTED 1 // 0 = (1 = On, 0 = Off), 1 = (0 = On, 1 = Off)
#define REL_PIN 12 // GPIO 12 = Red Led and Relay (0 = Off, 1 = On)
#define KEY_PIN 0 // GPIO 00 = Button
/*-------------------------------------------------------------------------------------------*/
#define DSB_PIN 4 // GPIO 14 = DS18B20 (Sonoff_TH10A(16A), Sonoff SV)
#define SEND_TELEMETRY_DS18B20 // Enable sending temperature telemetry
/*-------------------------------------------------------------------------------------------*/
#define DHT_PIN 14 // GPIO 14 = AM2301 (Sonoff_TH10A(16A), Sonoff SV)
#define DHT_TYPE DHT22 // DHT module type (DHT11, DHT21, DHT22, AM2301, AM2302 or AM2321)
#define SEND_TELEMETRY_DHT // Enable sending temperature and humidity telemetry

<div style="clear:both;"></div>

=== Software Anpassung DHT22 in Fhem ===
[[Datei:sonoff_sw_41.jpg|thumb|left|alt=umgebautes Modul]]

Links in der Hardcopy sind die Readings die nach der Anpassung von FHEM (Broker) befüllt werden sollten.

<div style="clear:both;"></div>

### Temperatur und Luftfeuchte vom Sonoff Switch ###
define Sonoff_Temp MQTT_DEVICE
attr Sonoff_Temp IODev myBroker
attr Sonoff_Temp icon temperature_humidity
attr Sonoff_Temp room MQTT
attr Sonoff_Temp stateFormat {sprintf("Temperatur: %.1f Grad Feuchte: %.1f ", ReadingsVal($name,"temperature",0), ReadingsVal($name,"humidity",0))}
attr Sonoff_Temp subscribeReading_humidity tele/sonoff/HUMIDITY
attr Sonoff_Temp subscribeReading_temperature tele/sonoff/TEMPERATURE
Als Beispiel die zusätzliche Erweiterung um die Temperatur und die Luftfeuchte in FHEM. Der in der Topic verwendete Name "sonoff" muss natürlich der Einstellung in der Software am Switch entsprechen. Bei Verwendung mehrerer Switches muss natürlich auch der Name bei jedem geändert werden.

<div style="clear:both;"></div>

=== Logfile für die Temperatur ===
define SVG_FileLog_Sonoff_Temp SVG myDbLog:SVG_FileLog_Sonoff_Temp:HISTORY
attr SVG_FileLog_Sonoff_Temp room MQTT

Und schließlich fehlt noch das Logfile, damit der Temperaturverlauf auch in schönen Plots dargestellt werden kann.
Das hier verwendete Beispiel funktioniert nur mit einer DbLog.

<div style="clear:both;"></div>

==Sonoff Switch als Thermostat verwenden mit MQTT==

[[Datei:sonoff_sw_55.jpg|thumb|left|alt=Thermostat]]
Mit diesem einfachen Beispiel wird ein Pelett Ofen mit einem externen Thermostat (sonoff Switch oder TH10/16) gesteuert. Zum besseren Überblick wird die Steuerung in einzelne Module getrennt, es könnte aber auch einiges zu einer einzigen Definition zusammen gefasst werden. Der Thermostat könnte auch als Frostwächter benutzt werden und ein anderes Heizgerät steuern.
<div style="clear:both;"></div>

###################################
### Sonoff Thermostat Regelung ####
###################################
define Sonoff_dht MQTT_DEVICE
attr Sonoff_dht IODev myBroker
attr Sonoff_dht alias Raumtemperatur
attr Sonoff_dht group Thermostat
attr Sonoff_dht icon temperature_humidity
attr Sonoff_dht publishSet ON OFF cmnd/sonoff_dht/1/POWER/set
attr Sonoff_dht room _Sonoff
attr Sonoff_dht stateFormat {sprintf("Temperatur: %.1f Grad Feuchte: %.1f ", ReadingsVal($name,"TEMPERATURE",0), ReadingsVal($name,"HUMIDITY",0))}
attr Sonoff_dht subscribeReading_HUMIDITY tele/sonoff_dht/DHT/HUMIDITY
attr Sonoff_dht subscribeReading_TEMPERATURE tele/sonoff_dht/DHT/TEMPERATURE
attr Sonoff_dht subscribeReading_state cmnd/sonoff_dht/1/POWER/set
FHEM Definition zur Erfassung der Temperatur und der Luftfeuchte. Damit dieses Beispiel funktioniert, ist am Sonoff Modul die Topic "'''sonoff_dht'''" zu setzen. Dieser Temperaturwert dient dem Thermostat als ISTWert.

define Sonoff_Sw MQTT_DEVICE
attr Sonoff_Sw IODev myBroker
attr Sonoff_Sw alias Pellets Ofen
attr Sonoff_Sw devStateIcon on:rc_GREEN:off off:rc_RED:on
attr Sonoff_Sw eventMap ON:on OFF:off
attr Sonoff_Sw group Thermostat
attr Sonoff_Sw icon sani_boiler_temp
attr Sonoff_Sw publishSet ON OFF cmnd/sonoff_dht/1/POWER/set
attr Sonoff_Sw room _Sonoff
attr Sonoff_Sw stateFormat Licht
attr Sonoff_Sw subscribeReading_Licht tele/sonoff_dht/POWER
attr Sonoff_Sw subscribeReading_state cmnd/sonoff_dht/1/POWER/set
attr Sonoff_Sw webCmd ON:OFF
FHEM Definition zum Absetzen der Befehle für das Relais (Thermostat) Ein- / Aus. Wenn das zu steuernde Geräte einen potentialfreien Thermostatanschluß benötigt (in den meisten Fällen), muss noch ein Relais dazwischen geschaltet werden um die Trennung der Netzspannung zu gewährleisten.

define ThermostatPellets dummy
attr ThermostatPellets alias Pellets Ofen Sollwert
attr ThermostatPellets group Thermostat
attr ThermostatPellets icon temp_control
attr ThermostatPellets room _Sonoff
attr ThermostatPellets setList state:0,5,10,12,13,14,15,16,17,17.5,18,18.5,19,19.5,20,20.5,21,21.5,22,23,24,25,26,27
attr ThermostatPellets webCmd state
Die Sollwertvorgabe für das Thermostat durch einen Dummy, damit können die gewünschten Temperaturen eingestellt werden.

### sofort ausführen wenn neuer Sollwert eingestellt wird ###
define Thermostat_on_notify notify ThermostatPellets IF (ReadingsVal("Sonoff_Sw","state",0) eq "OFF" && (ReadingsVal("Sonoff_dht","TEMPERATURE",0) <= Value("ThermostatPellets"))) (set Sonoff_Sw ON)
define Thermostat_off_notify notify ThermostatPellets IF (ReadingsVal("Sonoff_Sw","state",0) eq "ON" && (ReadingsVal("Sonoff_dht","TEMPERATURE",0) > Value("ThermostatPellets"))) (set Sonoff_Sw OFF)
Mit einem notify wird die manuelle Änderung des Sollwertes überwacht und sofort reagiert.

## zyklisch prüfen ob Sollwert erreicht wurde ###
define Thermostat_on at +*00:15:00 IF (ReadingsVal("Sonoff_Sw","Licht",0) eq "OFF" && (ReadingsVal("Sonoff_dht","TEMPERATURE",0) <= Value("ThermostatPellets"))) (set Sonoff_Sw ON)
define Thermostat_off at +*00:15:00 IF (Value("Sonoff_Sw") eq "ON" && (ReadingsVal("Sonoff_dht","TEMPERATURE",0) > Value("ThermostatPellets"))) (set Sonoff_Sw OFF)
Hier noch die Soll- Ist Wertvergleiche zur Steuerung. Es wird alle 15 Minuten überprüft ob die Temperatur erreicht ist. Bei einer trägen Heizung sollten 15 Minuten ausreichend sein, wer will kann dies aber auch alle 5 oder 10 Minuten prüfen.

<div style="clear:both;"></div>

==Sonoff Switch mit Bewegungsmelder HC-SR501==

[[Datei:sonoff_pir_1.jpg|thumb|left|alt=Bewegungsmelder]]
Basierend auf dem Wall Switch MQTT Sketch von Arends wurde hier ein Sonoff BASIC + PIR HC-SR501 in eine größere Verteilerdose eingebaut, der Sonoff wurde dabei etwas gekürzt. Die Bewegungsmelder sind ab etwa 70 Cent erhältlich.

Der Sketch kann auch den Blink Modus. Damit kann man im Alarmfall z.B. Alle Strahler rings ums Haus blinken lassen.

Mehr dazu kann hier im [https://forum.fhem.de/index.php/topic,63824.0.html Forum]im Diskussionsthread nachgelesen werden.
<div style="clear:both;"></div>

[[Datei:sonoff_pir_2.jpg|thumb|left|alt=Bewegungsmelder]]
Ein Beispiel wir der Bewegungsmelder in der Feuchtraumdose montiert werden kann. Wird der Bewegungsmelder abgesetzt vom Switch montiert, ist darauf zu achten das die Kabel nicht zu lange werden.
<div style="clear:both;"></div>
===Spannungsversorgung des HC-SR501===
[[Datei:sonoff_pir_4.jpg|thumb|left|alt=5V für Bewegungsmelder]]
Der HC-SR501 wird vom Sonoff versorgt, wobei hier die 3,3 V nicht immer ausreichen. Es ist deshalb am HC-SR501 eine Diode zu überbrücken, dann reichen die 3,3V vom Sonoff. Es können aber auch am Sonoff die 5V angezapft werden. Hier im Bild dargestellt wo die 5V angezapft werden können.
<div style="clear:both;"></div>

[[Datei:sonoff_pir_5.jpg|thumb|left|alt=3,3V für Bewegungsmelder]]
Hier eine kleine Übersicht der wichtigsten Teile und deren Platzierung am HC-SR501.
Den PIR kann man auch mit 3,3V betreiben wenn man die Diode am Eingang nach Vcc überbrückt, dann reicht die Spannung für einen reibungslosen Betrieb völlig aus. Dies gilt für den HC-SR501, wird ein anderer PIR verwendet muss man nachschauen ob das auch möglich ist, ansonsten die 5V Variante wählen.

<div style="clear:both;"></div>
===Anpassung des Sketches mit Wall Switch===
Zur Vorbereitung des Sketches sind zunächst einige Einstellungen in der "user_config.h" durchzuführen.

#if MODULE == SONOFF // programming header 1:3.3V 2:rx 3:tx 4:gnd
#define APP_NAME "Sonoff 8266 module"
#define MQTT_GRPTOPIC "sonoffs" // [GroupTopic] MQTT Group topic
/*-------------------------------------------------------------------------------------------*/
#define LED_PIN 13 // GPIO 13 = Green/Blue Led (0 = On, 1 = Off) - Sonoff
#define LED_INVERTED 1 // 0 = (1 = On, 0 = Off), 1 = (0 = On, 1 = Off)
#define REL_PIN 12 // GPIO 12 = Red Led and Relay (0 = Off, 1 = On)
#define KEY_PIN 0 // GPIO 00 = Button
/*-------------------------------------------------------------------------------------------*\
* Wall switch and HC-SR501
\*-------------------------------------------------------------------------------------------*/
#define SWITCH_PIN 14 // GPIO 14 = Standard wall switch to Gnd (Sonoff_TH10A(16A), Sonoff SV)
#define SWITCH_MODE '''PUSHBUTTON_INV''' // [SwitchMode] TOGGLE, FOLLOW, FOLLOW_INV, PUSHBUTTON or PUSHBUTTON_INV (the wall switch state)
'''#define USE_WALL_SWITCH''' // Enable the use of a standard wall switch to control the relay
Wichtig ist dabei die vorangestellten Slahes // bei "#define USE_WALL_SWITCH" zu entfernen auf '''PUSHBUTTON_INV''' zu stellen. Dann kann der Sonoff Switch compiliert und geflasht werden.

===Einbindung des HC-SR501 in Fhem===
# ------------- Sonoff_pir mit Bewegungsmelder ---------------
define Sonoff_pir MQTT_DEVICE
attr Sonoff_pir IODev myBroker
attr Sonoff_pir eventMap ON:on OFF:off
attr Sonoff_pir group Sonoff
attr Sonoff_pir icon hue_filled_br30
attr Sonoff_pir publishSet ON OFF cmnd/sonoff_pir/1/POWER/set
attr Sonoff_pir room MQTT
attr Sonoff_pir stateFormat Licht
attr Sonoff_pir subscribeReading_Licht stat/sonoff_pir/POWER
attr Sonoff_pir subscribeReading_state cmnd/sonoff_pir/1/POWER/set
attr Sonoff_pir webCmd :

Ein Beispiel wie der Sonoff Switch in Fhem eingebunden wird. Wenn im Sketch der Prefix von stat auf tele geändert wurde, ist dies auch hier durchzuführen ( subscribeReading_Licht tele/sonoff_pir/POWER ), ansonsten bleibt es so wie im Beispiel. Getestet wurde dieses Beispiel mit Version 3.1.6. Die Topic sollte auf den Namen "sonoff_pir" eingestellt werden. Bei anderen Namen ist dies entsprechend in Fhem anzupassen.

Mit dem Command '''BUTTONTOPIC = Alarm_SO2''' ( direkt im Webinterface des Sonoff ) wird der Wall Switch GPIO14 vom Sonoff entkoppelt und somit sendet der Bewegungsmelder direkt an FHEM --> Motion_pir MQTT_DEVICE

Es sollte auch unbedingt kontrolliert werden, wie die Ausgabe des Alarmes in der Console erfolgt. Erscheint hier die Meldung "cmnd/Alarm_SO2/POWER = TOGGLE" dann muss mit dem Kommando "'''switchmode 1'''" das Ausgabeformat umgeschaltet werden, erst dann kommt das gewünschte Format "On" und "OFF".

# ------------------ Motion_pir MQTT_DEVICE -----------------
define Motion_pir MQTT_DEVICE
attr Motion_pir IODev myBroker
attr Motion_pir devStateIcon on:on-for-timer off:off
attr Motion_pir eventMap ON:on OFF:off
attr Motion_pir group Sonoff
attr Motion_pir icon people_sensor
attr Motion_pir room MQTT
attr Motion_pir stateFormat Alarm
attr Motion_pir subscribeReading_Alarm cmnd/Alarm_SO2/POWER
Die Motion_pir dient nun zur eigentlichen Einschaltung des Lichtes und sendet das Kommando '''cmnd/Alarm_SO2/POWER''' an den entkopellten GPIO 14 des Switch.

# ------------------ DoIf zur Motion Abfrage -----------------
define di_Sonoff_pir_Alarm DOIF ([Motion_pir:"on"] and [Tag_Nacht:twilight_weather] < 35) (set Sonoff_pir on) DOELSEIF ([Motion_pir:"off"] and [Tag_Nacht:twilight_weather] < 35) (set Sonoff_pir off)
attr di_Sonoff_pir_Alarm comment Abhängig von Helligkeitssensor wird nachts,bei Bewegung das Licht eingeschaltet!
attr di_Sonoff_pir_Alarm group Sonoff
attr di_Sonoff_pir_Alarm room MQTT
Zusätzlich kann nun mit einem '''Doif''' verknüpft werden um das Ganze mit Tag_Nacht:twilight_weather dann in Abhängigkeit der Helligkeit zu schalten. Selbstverständlich kann jede andere Quelle mit einem Helligkeitswert verwendet werden.

===Alarmausgabe über Grouptopic===
# ------------------------ Sonoffs Group ----------------------
define Sonoffs MQTT_DEVICE
attr Sonoffs IODev myBroker
attr Sonoffs eventMap ON:on OFF:off
attr Sonoffs group Sonoff
attr Sonoffs icon hue_filled_br30
attr Sonoffs publishSet ON OFF cmnd/sonoffs/1/POWER/set
attr Sonoffs room MQTT
attr Sonoffs stateFormat state
attr Sonoffs subscribeReading_Licht stat/sonoffs/1/POWER
attr Sonoffs subscribeReading_state cmnd/sonoffs/1/POWER/set
Wer möchte kann auch mit der Group Topic mehrere Switches mit Bewegungsmelder zusammenfassen und alle Lampen im Alarmfall gemeinsam in den Blinkmodus schalten. cmnd/sonoffs ist das Kommando für die Group Topic, sofern diese vom User nicht verändert wurde.
<div style="clear:both;"></div>

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
--[[Benutzer:Reinhart|Reinhart]] ([[Benutzer Diskussion:Reinhart|Diskussion]]) 20:54, 5. Jan. 2017 (CET)

Sonoff

2017-01-15T22:56:24Z

ThomasRamm: /* MQTT Server einrichten, add client package */

'''sonoff, dieser Artikel beschreibt die Ankopplung der kostengünstigen sonoff Module an FHEM mit ESPEasy oder MQTT.'''
{{Randnotiz|RNTyp=Fehl|RNText=Achtung: Arbeiten mit Netzspannung kann lebensgefährlich sein und darf nur von autorisiertem Fachpersonal durchgeführt werden!}}

Seit einiger Zeit werden von der [https://www.itead.cc/sonoff-wifi-wireless-switch.html Fa. Itead] kostengünstige "sonoff" Produkte angeboten die glücklicherweise den [http://dl.itead.cc/IM151116002/0A-ESP8266_Specifications_v4.1.pdf ESP8266 Chip] On Board haben und somit die ideale Grundlage für [http://www.esp8266.nu/index.php/Main_Page ESPEasy] und für [https://forum.fhem.de/index.php/board,46.0.html Fhem] darstellen.

'''Nützliche Links zum Hersteller:'''

[https://www.itead.cc/blog/user-guide-for-sonoff-slampher User Manual von Itead]

[https://www.itead.cc/wiki/images/6/6b/Sonoff_schmatic.pdf Sonoff Schaltplan]
<div style="clear:both;"></div>

=Hardware=
'''Bitte unbedingt die elektrotechnischen Sicherheitsrichtlinien beachten und einhalten!'''
<div style="clear:both;"></div>
[[Datei:sonoff_sw_15.jpg|thumb|left|alt=Warnung Netzspannung]]
<div style="clear:both;"></div>
'''Achtung: An dem Modul liegt Netzspannung an die lebensgefährlich ist. Es dürfen nur entsprechend ausgebildete Personen dieses Modul in Betrieb nehmen. Zum Umbau und zur Softwareaktualisierung darf keine Netzspannung angeschlossen sein'''

Wie gefährlich das hantieren mit Netzspannung sein kann, wird hier am Beispiel eines [http://mysku.ru/blog/china-stores/45762.html russischen Anwenders] gezeigt, der hat beim Flashen die Netzspannung am Modul gelassen und somit über die Verbindung mit dem Netzteil des Laptop lebensgefährliche Spannung auf die FTDI Schnittstelle gebracht. Das Modul ist dabei abgeraucht!

==Modelle==

===Produktübersichtsliste sonoff===

{| class="wikitable" style="text-align:right"
! Produkt Name !! Beschreibung !! Spannungsversorgung !! Imax !! Pmax !! Frequenz !! Schaltplan !! Link
|-
| Sonoff || Wireless control switch || 90~250V AC || 10A || 2200W || 2.4Ghz || [http://wiki.iteadstudio.com/Sonoff Plan] || [https://www.itead.cc/smart-home/sonoff-wifi-wireless-switch.html Link]
|-
| Sonoff RF || 433 RF remote || 90~250V AC || 10A || 2200W || 2.4Ghz || [http://wiki.iteadstudio.com/Sonoff_RF Plan] || [https://www.itead.cc/smart-home/im151116003.html Link]
|-
| Sonoff SV || Low voltage Input || 5~24V DC || 10A || 240W DC || 2.4Ghz || [http://wiki.iteadstudio.com/Sonoff_SV Plan] || [https://www.itead.cc/smart-home/sonoff-sv.html Link]
|-
| Sonoff TH10/TH16 || Monitor and set Temp.&Hum. || 90~250V AC || 10A/16A || 2200W(10A)/3500W(16A) || 2.4Ghz || [http://wiki.iteadstudio.com/Sonoff_TH_10/16 Plan] || [https://www.itead.cc/smart-home/sonoff-th.html Link]
|-
| Sonoff Dual || Remote control 2 devices || 90~250V AC || 16A || 3500W || 2.4Ghz || [https://www.itead.cc/wiki/Sonoff_Dual Plan] || [https://www.itead.cc/sonoff-dual.html Link]
|-
| Sonoff Pow || Report power &power usage || 90~250V AC || 16A || 3500W || 2.4Ghz || [https://www.itead.cc/wiki/Sonoff_Pow Plan] || [https://www.itead.cc/sonoff-pow.html Link]
|-
| Sonoff LED || WiFi Control Dimming LED || 180~265V AC || 0.3-0.6A || 42W || 2.4Ghz || kein || [https://www.itead.cc/sonoff-led.html Link]
|-
| Sonoff Touch || WiFi wall touch switch || 90~250V AC || 2A || 400W || 2.4Ghz || kein || [https://www.itead.cc/sonoff-touch.html Link]
|-
| Slampher || Wireless control light holder || 90~250V AC || 2A || 200W || 2.4Ghz || [http://wiki.iteadstudio.com/Slampher Plan] || [https://www.itead.cc/smart-home/slampher-wifi-wireless-light-holder.html Link]
|-
| S20 Smart Socket || Smart socket || 90~250V AC || 10A || 2000W || 2.4Ghz || kein || [https://www.itead.cc/smart-home/smart-socket-eu.html EU-Stecker]
|-
| iFan || Smart fan || 185~264V AC ||﹤1A || 60W || 2.4Ghz || kein || [https://www.itead.cc/smart-home/smart-socket-eu.html EU-Stecker]
|-
| Motor/Pump Control Switch || clockwise/anticlockwise running || 5V/7~32V DC || 10A || 50~320W || 2.4Ghz || kein || [https://www.itead.cc/smart-home/motor-reversing-wifi-wireless-switch.html Link]
|-
| 1 Chnl Inching/self-locking Switch || Access control || 5V/12V DC || 10A || 50/120W || 2.4Ghz || kein || [https://www.itead.cc/smart-home/inching-self-locking-wifi-wireless-switch.html Link]
|-
| 4 Chnl Inching/self-locking/inter-locking Switch || Access control, rolling door control || 5V/5~32V DC/90~250V AC || 10A || 50~320W/2500W || 2.4Ghz || kein || [https://www.itead.cc/ifan.html Link]
|-
|   || || || || || || ||
|-
|}

Eine Übersichtliste der verschiedenen Produkte mit technischen Kurzangaben.
<div style="clear:both;"></div>''

===Model: IM151116002: Erstes Modell===
[https://www.itead.cc/sonoff-wifi-wireless-switch.html Sonoff WiFi Wireless Smart Switch for MQTT COAP Smart Home]
[[Datei:sonoff_sw_0.jpg|thumb|left|alt=sonoff Switch]]
<div style="clear:both;"></div>
Das sonoff Modul ist in einem zweckmäßigen und gefälligem Gehäuse verbaut!

====Platine====
[[Datei:sonoff_sw_1.jpg|thumb|left|alt=sonoff Switch von vorne]]

Die Platine ist sehr übersichtlich aufgebaut und der Hersteller hat auch alle Vorbereitungen zum Flashen einer alternativen Software vorgesehen (über serielle Schnittstelle via FTDI-Modul). Mit einer alternativen Software wie ESPEasy ist eine direkte Ankopplung des '''sonoff''' an FHEM somit ein leicht durchführbarer Vorgang.
<div style="clear:both;"></div>

[[Datei:sonoff_sw_3.jpg|thumb|left|alt=sonoff Switch von hinten]]
Die stromführenden Leitungen wurden mit Lötzinn vom Hersteller verstärkt um die angegebenen Stromstärken mit geringer Hitzeentwicklung zu transportieren.

'''Achtung: Bitte vor den Arbeiten kontrollieren, das an der Platine keine Netzspannung angeschlossen ist, LEBENSGEFAHR!'''
<div style="clear:both;"></div>''

<div style="clear:both;"></div>''

===Model: IM160712005: TH 10A/16A ===
[https://www.itead.cc/sonoff-th.html Sonoff TH 10A/16A WiFi Smart Switch]

====TH10 / TH16 weitere GPIO zugänglich machen====
[[Datei:Sonoff_TH_10A-16A_kleiner.jpg|thumb|left|alt=TH10 / TH16 weitere GPIO zugänglich machen]]
Der Hersteller hat zwar schon Platine für eine weitere Stiftleiste vorbereitet, jedoch muss diese noch bestückt werden. Die nicht beschalteten Stifte können dann genutzt werden um die "verdeckten" GPIO zugänglich zu machen. Die Verdrahtung kann dem Bild entnommen werden.<br>
'''Achtung: Bitte vor den Arbeiten kontrollieren, das an der Platine keine Netzspannung angeschlossen ist, LEBENSGEFAHR!'''
<div style="clear:both;"></div>''

<div style="clear:both;"></div>''

===Model: IM160811001: Sonoff Dual ===
[https://www.itead.cc/sonoff-dual.html Sonoff Dual WiFi Wireless Smart Swtich]

<div style="clear:both;"></div>''

<div style="clear:both;"></div>''

===Model: IM160810001: Sonoff Pow ===
[https://www.itead.cc/sonoff-pow.html Sonoff POW WiFi Switch with Power Consumption Measurement]
[[Datei:sonoff_sw_30.jpg|thumb|left|alt=SONOFF POW]]Ein sehr interessantes und kostengünstiges Modul zur Messung der aktuellen Leistung. Das Modul kann via MQTT in Fhem angebunden werden.

Ein Beispiel zur Einbindung ist [http://www.fhemwiki.de/wiki/Sonoff#Sonoff_POW_einrichten hier unten] im Wiki beschrieben.

<div style="clear:both;"></div>
===Model: weitere Modelle===
[https://www.itead.cc/search/result/?cat=&q=sonoff Sonoff Weitere Modelle finden sich auf der Homepage des Hersstellers]

==Vorbereitungen zum Flashen==
[[Datei:sonoff_sw_2.jpg|thumb|left|alt=serielle Schnittstelle]]

Hier auf der Platine sind die benötigten Signale für ein FTDI Modul schon vorhanden. Der quadratische Pin gleich über dem Taster ist die Spannungsversorgung zum Flashen vom FDTI von 3.3V Es muss daher unbedingt ein FTDI Modul genommen werden, dass nicht nur einen Jumper für 3.3V besitzt sondern auch die Spannung auf 3.3V herab setzt. Ist dies nicht der Fall, läuft man Gefahr das Modul unbrauchbar zu machen. Es ist daher zu empfehlen einen Spannungsteiler mit 2 Widerständen oder einen Pegelwandler zwischenschalten.
<div style="clear:both;"></div>

==Signale der Schnittstelle==
von oben nach unten auf der Steckerleiste des sonoff U4 (Model: IM151116002).

Pin5 = vorbereitet für GPIO
Pin4 = Masse
Pin3 = TxD
Pin2 = RxD
Pin1 = 3.3V

Siehe dazu auch den [https://forum.fhem.de/index.php/topic,55036.0.html Link aus dem Forum]:
<div style="clear:both;"></div>

==Platine mit Stiftleiste bestücken==
[[Datei:sonoff_sw_4.jpg|thumb|left|alt=Platine mit Stiftleiste bestücken]]
Der Hersteller hat zwar schon die Platine vorbereitet, jedoch muss sie noch mit einer Stiftleiste bestückt werden um das FTDI Modul bequem verbinden zu können. Nachdem einmal ESPEasy geflasht worden ist, kann es in Zukunft via WEB (OTA) geflasht werden und die Stiftleiste ist dann nicht mehr erforderlich. Aufgrund der geringen Kosten fällt dies jedoch nicht ins Gewicht.<br>
Für die Module TH10/TH16 sind die Lötpunkte für die Stiftleiste schon beschriftet. Die Stiftleiste selber muss allerdings auch nachgerüstet werden.
<div style="clear:both;"></div>''
'''''Achtung''': Bitte vor den Arbeiten kontrollieren, das an der Platine keine Netzspannung angeschlossen ist, LEBENSGEFAHR!
<div style="clear:both;"></div>''

=Software=
==ESPEasy flashen==
[[Datei:sonoff_sw_6.jpg|thumb|left|alt=sonoff mit angestecktem FDTI Adapter]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier geht es ausschließlich um die Software ESPEasy an den sonoff Modulen! }}
Die Spannungsversorgung des sonoff Moduls wird hier vom FTDI Konverter mit 3.3V über die Verbindungskabel zum Pfostenstecker durchgeführt.

Der FTDI Adapter wird dann mit der USB Schnittstelle mit dem Computer verbunden.

Zum compilieren wird in der Arduino Umgebung auch die ArduinoJson library 5.6.4+ benötigt. Eine genaue Anleitung kann [https://forum.fhem.de/index.php/topic,55728.msg473220.html#msg473220 hier] nachgelesen werden. Im Gegensatz zu Arends Sketch für die MQTT Umgebung genügt hier die Arduino IDE 1.6.9. Für die Sketches von Arends empfiehlt sich Arduino IDE >=1.6.12

<div style="clear:both;"></div>

===mit Arduino compilieren===
[[Datei:sonoff_sw_10.jpg|thumb|left|alt=Einstellung Arduino IDE]]
Wer selber mit der Arduino IDE compilieren will bitte folgende Einstellungen beachten. Die anschließenden Arbeiten sind dann gleich wie bei Abschnitt '''fertige Binary'''.

Unbedingt die neueste [https://github.com/bblanchon/ArduinoJson Arduino Json Library] benutzen (siehe oben)! Es gibt zwar keine Compilerfehler, aber es kommt anschließend zu Fehlfunktionen in der ESP Bridge!

<div style="clear:both;"></div>
Generic ESP8266 Module
Flash Mode: QIO
Flash Frequency: 40 MHz
CPU Frequency: 80 MHz
Flash Size: 1M (64K SPIFFS)
Debug Port: disabled
Debug Level: none
Reset Mode: ck
Upload Speed: 115200
<div style="clear:both;"></div>
===fertige Binary flashen===
[[Datei:sonoff_sw_7.jpg|thumb|left|alt=NodeMCU Firmware Flasher]]
Es empfiehlt sich eine fertige Binary von ESPEasy aufzuspielen. In diesem Wiki wurde R140 verwendet.

Siehe dazu auch den [http://www.esp8266.nu/index.php/Main_Page Link von ESPEasy] und das [https://learn.adafruit.com/building-and-running-micropython-on-the-esp8266/flash-firmware Handbuch] für den Flasher.

In manchen Versionen von ESPEasy (zB.R120) ist auch ein Flasher beigelegt, welcher zwar keine grafische Oberfläche hat aber hervorragend funktioniert. Wenn andere versagen, geht es mit diesem Flasher immer noch, einfach probieren!

<div style="clear:both;"></div>
Netzspannung darf 'NICHT' angeschlossen sein!!!
Taster am Sonoff gedrückt halten
FTDI Adapter verbinden
Taster am Sonoff los lassen
Sketch übertragen
Sonoff vom FTDI trennen
<div style="clear:both;"></div>
Wenn einmal die Firmware auf das sonoff Modul geflasht worden ist, kann in Zukunft ESPEasy direkt unter Tools via HTTP dies durchführen. Es muss dazu kein FTDI Konverter mehr verwendet werden.

==ESPEasy==
[[Datei:sonoff_sw_11.jpg|thumb|left|alt=ESPEasy Devices]]
Wenn das Modul fertig geflasht ist und die Verbindung zum Modul hergestellt ist, können die Einstellungen in ESPEasy durchgeführt werden.
Dazu am Webinterface anmelden und zunächst die zwei Devices definieren.

Der Hersteller hat für das '''Relaise GPIO 12''' und für die '''grüne Led GPIO 13''' vorgesehen. Der '''Taster ist an GPIO 0''' angeschlossen.
<div style="clear:both;"></div>

===Device Schalter===
[[Datei:sonoff_sw_12.jpg|thumb|left|alt=Device Relais]]
Bei den Devices sollten die hier dargestellte Einstellungen beachtet werden. Der Switch (PUMP) sollte auf Input gestellt werden, sodass die anschließenden und benötigten Rules aktiviert werden können.

Da beide Devicenamen gleich benannt wurden (PUMP) wird in Fhem nur ein Device angelegt! Die dazugehörenden Valuenames sind unterschiedlich (Relay, Key).

<div style="clear:both;"></div>

===Device Taster===
[[Datei:sonoff_sw_13.jpg|thumb|left|alt=Device Key]]
Der Taste muss natürlich nur konfiguriert werden, wenn auch händisch am Modul geschaltet werden soll. Wird dies nicht benötigt, können auch die Rules geändert bzw. angepasst werden. Doch alleine zu Testzwecken ist es eine nützliche Sache.
<div style="clear:both;"></div>

===Rules===
[[Datei:sonoff_sw_14.jpg|thumb|left|alt=Rules]]
Da das sonoff Modul auch einen eingebauten Taster hat und somit auch lokal bedient werden kann, sollte man zunächst unter '''Tools / Advanced das Häckchen Rules''' aktivieren, erst dann wird der Tab sichtbar und es können Rules erstellt werden.
<div style="clear:both;"></div>

on PUMP#Key do
if [PUMP#Relay]=1
gpio,12,0
else
gpio,12,1
endif
endon
on PUMP#Relay do
if [PUMP#Relay]=1
gpio,13,0
else
gpio,13,1
endif
endon
Diese Rules ermöglichen, das bei lokaler Bedienung durch den Taster auch die '''Led''' richtig geschaltet wird.
Mit 'on PUMP#Key do' wird geprüft ob die Taste gedrückt ist und schaltet dann entsprechend die Led. Mit den Rules können auch Timer oder sonstige Spielereien realisiert werden. Siehe dazu das [http://www.esp8266.nu/index.php/Tutorial_Rules Tutorial] von ESPeasy.
<div style="clear:both;"></div>

==ESPEasy in Fhem einrichten==
[[Datei:sonoff_sw_9.jpg|thumb|left|alt=Fhem Konfiguration]]
Dies ist eine einfache Darstellung wie Fhem automatisch den Device erstellt.

Damit Fhem mit ESPEasy und dem sonoff Modul kommunizieren kann, muss in der fhem.cfg vorerst nur die espBridge mit dem hier dargestellten Eintrag aktiviert werden.
<div style="clear:both;"></div>
define espBridge ESPEasy bridge 8383
Dies ist eigentlich die einzige Zeile die in fhem.cfg angelegt werden muss. Die restliche Konfiguration wird von Fhem automatisch generiert.

##########################################
### ESPEASY ####
##########################################

define ESPEasy_sonoff_1_PUMP ESPEasy 10.0.0.37 80 espBridge sonoff_1_PUMP
attr ESPEasy_sonoff_1_PUMP IODev espBridge
attr ESPEasy_sonoff_1_PUMP devStateIcon on:rc_GREEN:off off:rc_RED:on absent:rc_BLUE:off gpio:rc_YELLOW:off
attr ESPEasy_sonoff_1_PUMP eventMap /gpio 12 on:on/gpio 12 off:off/gpio 12 gpio:off/gpio 12 output:off/
attr ESPEasy_sonoff_1_PUMP group ESPEasy Device
attr ESPEasy_sonoff_1_PUMP icon hue_filled_outlet
attr ESPEasy_sonoff_1_PUMP room ESPEasy
attr ESPEasy_sonoff_1_PUMP setState 0
attr ESPEasy_sonoff_1_PUMP stateFormat {ReadingsVal($name,"presence","") eq "absent" ? "absent" : ReadingsVal($name,"Relay","")}
attr ESPEasy_sonoff_1_PUMP webCmd :

hier ein Beispiel wie es auch manuell leicht modifiziert werden kann.

[[Datei:sonoff_sw_8.jpg|thumb|left|alt=sonoff Readings]]

Die Readings werden durch die Bridge (Modul ESPEasy) automatisch angelegt.

Es besteht hier noch genug Spielraum um zB. auch noch Temperatursensoren an das Modul anzuschließen und ebenfalls in Fhem darzustellen.
<div style="clear:both;"></div>

==MQTT Server einrichten==
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier geht es ausschließlich um den Sketch von Arends und MQTT an den sonoff Modulen! }}
Es bleibt jedem Anwender die freie Wahl ob die Kommunikation über die ESPEasy-Bridge oder MQTT erfolgen soll. MQTT ist bei der Einrichtung etwas komplexer, da hier auch auf dem Server der Broker installiert werden muss.

Im wesentlichen beschränkt sich die Installation eines MQTT Servers aber auf wenige Arbeitsschritte und ist wie folgt beschrieben durchzuführen. Wer schon einen '''mosquitto''' auf dem Server installiert hat, kann diesen Schritt überspringen.

Dieses Kapitel ist insofern interessant, da mit dem Sketch von Theo Arends auch die Einbindung der neuen sonoff Pow Module bereits möglich ist.

# aus dem mosquitto Repo installieren:
wget http://repo.mosquitto.org/debian/mosquitto-repo.gpg.key
sudo apt-key add mosquitto-repo.gpg.key
cd /etc/apt/sources.list.d/
sudo wget http://repo.mosquitto.org/debian/mosquitto-wheezy.list
# oder für jessie
sudo wget http://repo.mosquitto.org/debian/mosquitto-jessie.list
sudo apt-get update
# mosquitto installieren, sowie client Befehl mosquito_sub (gehört nicht zum Server, wird aber weiter unten benötigt)
sudo apt-get install mosquitto mosquitto-clients

# MQTT Server Test
sudo service mosquitto status

# Start / Stop des Servers
sudo service mosquitto stop
sudo service mosquitto start

# Perl Version ausgeben
perl -v
# Perl MQTT Module nachinstallieren (läuft ein paar Minuten)
sudo cpan install Net::MQTT:Simple
sudo cpan install Net::MQTT:Constants

===Software Arends Sketch===
[[Datei:sonoff_sw_22.jpg|thumb|left|alt=Arends Menü]]

Ebenso bietet sich die Möglichkeit eine andere alternative Software auf den unterschiedlichen Sonoff Modellen aufzuspielen.
Speziell für diese Module zugeschnittene Software stammt vom Autor Theo Arends. Alle hier gezeigten Bildschirmfotos und Beispiele beziehen sich auf Basis der Version 2.0.11 (Stand 11.11.2016).

'''Wichtig:''' erst '''ab Version 2.0.9''' sind die Berechnungsfehler und die Referenzfrequenzen für die Umrechnung der Leistungsdaten gefixt worden! Es wird daher angeraten immer die aktuellste Version zu verwenden.

'''Links zu Theo Arend Github'''

[https://github.com/arendst/Sonoff-MQTT-OTA-Arduino Download MQTT Sketch]

[https://github.com/arendst/Sonoff-MQTT-OTA-Arduino Arend GitHub]

[https://github.com/arendst/Sonoff-MQTT-OTA-Arduino/wiki Wiki]

'''Achtung:''' sollten Probleme mit dem ersten Login im Webinterface auftreten, hat der Autor vorgesorgt und mit speziellem wiederholten Tastendruck können verschiedene Modi aufgerufen werden: zB:

'''3 x Taste kurz drücken''' und eine Smartconfig wird gestartet und die '''SSID''' und das '''Passwort''' kann über diese [https://play.google.com/store/apps/details?id=com.cmmakerclub.iot.esptouch Android App] eingegeben werden.

'''4 x Taste kurz drücken''' und man bringt den Device in den '''Access Point Mode''' mit der IP-Adresse '''192.168.4.1'''.

Bis zu 7 verschiedene Modi sind möglich, mehr dazu in Arends Wiki.

[https://github.com/arendst/Sonoff-MQTT-OTA-Arduino/wiki/Button-usage Link zum Wiki Arends, Button]
<div style="clear:both;"></div>

[[Datei:sonoff_bv_01.jpg|thumb|left|alt=Arduino Boardverwalter]]
In der Arduino IDE unter Datei / Voreinstellungen im Feld "Zusätzliche Boardverwalter-URLs:" den Link: http://arduino.esp8266.com/stable/package_esp8266com_index.json einfügen.

Dann unter '''Werkzeuge / Board / Boardverwalter''' ganz am Ende der Liste die Librarys für "esp8266 by ESP8266 Community" die letzte Version 2.3.0 installieren. [https://forum.fhem.de/index.php/topic,46205.msg534707.html#msg534707 Link zum Board].

Das gesamte sonoff Verzeichnis aus [https://github.com/arendst/Sonoff-MQTT-OTA-Arduino/archive/master.zip Arendts Sketch] entpacken (ist wie hier verlinkt ein Zipfile) und dann aus diesem Verzeichnis die sonoff.ino öffnen. Es können dann alle zu dem Sketch zugehörigen Dateien angesehen/editiert werden.

<div style="clear:both;"></div>
Anschließend muss noch die Datei '''user_config.h''' (im Unterverzeichnis "sonoff") editiert werden. Die Abschnitte

// Wifi
// Syslog
// Ota
// MQTT

müssen mit der eigenen "'''Ip-Adresse-Server'''", "'''SSID'''" und "'''password'''" angepasst werden, das erleichtert den ersten Connect mit dem Modul. Seit der Version 2.1.2 können die WIFI Einstellungen 2-fach angegeben werden, somit wechselt das Device automatisch auf den 2. Wifi Hotspot wenn der erste nicht erreicht wird.

#define STA_SSID "SSID" // Wifi SSID
#define STA_PASS "password" // Wifi password
#define WIFI_HOSTNAME "%s-%04d" // Expands to <MQTT_TOPIC>-<last 4 decimal chars of MAC address>
#define WIFI_CONFIG_TOOL WIFI_WPSCONFIG // Default tool if wifi fails to connect (WIFI_SMARTCONFIG, WIFI_MANAGER or WIFI_WPSCONFIG)

// Syslog
#define SYS_LOG_HOST "Ip-Adresse-Server"
#define SYS_LOG_PORT 514
#define SYS_LOG_LEVEL LOG_LEVEL_NONE
#define SERIAL_LOG_LEVEL LOG_LEVEL_INFO
#define WEB_LOG_LEVEL LOG_LEVEL_INFO

// Ota
#if (ARDUINO >= 168)
#define OTA_URL "http://Ip-Adresse-Server:80/api/arduino/" PROJECT ".ino.bin"
#else
#define OTA_URL "http://Ip-Adresse-Server:80/api/arduino/" PROJECT ".cpp.bin"
#endif

// MQTT
#define MQTT_HOST "Ip-Adresse-Server"
#define MQTT_PORT 1883

'''Wichtig:''' Bei Verwendung des '''sonoff_POW''' muss dies ebenfalls in der user_config.h eingestellt werden, also das "SONOFF" sperren und das "'''SONOFF_POW'''" aktivieren (// setzen/entfernen). Wir dies nicht durchgeführt, werden auch keine Leistungsdaten via MQTT übertragen!!!
Ebenso muss in (%userprofile%\Documents\Arduino\libraries\pubsubclient\src\PubSubClient.h) die Max Packet Size auf 400 erhöht werden!

#define MQTT_MAX_PACKET_SIZE 400
#define MQTT_KEEPALIVE 120
Anpassung der max. Packet Size auf 400 und das Keepalive auf 120

// Enable only one out of three MODULE defines below
//#define MODULE SONOFF // Sonoff, Sonoff SV, Sonoff Dual, Sonoff TH 10A/16A, S20 Smart Socket, 4 Channel
#define MODULE SONOFF_POW // Sonoff Pow

Im Anschluß wird der Sketch mit der Arduino IDE (getestet mit 1.6.12) compiliert und die Binary dann exportiert (Sketch / Kompilierte Binärdatei exportieren). Die erzeugte .bin Datei dann mit dem Tool "ESP8266Flasher.exe" flashen, so wie auch bei ESPEasy. Wer nicht compilieren will, kann auch im Unterverzeichnis ./api/arduino/ die fertige Binary ( sonoff.ino ) benutzen, aber dann ohne Voreinstellung der lokalen IPs.
<div style="clear:both;"></div>

===MQTT testen===
[[Datei:sonoff_sw_20.jpg|thumb|left|alt=Arends Menü]]

Nach erfolgtem Flash des Modules kann das Webinterface zum ersten Mal aufgerufen werden.

Es bieten sich hier mehrere Möglichkeiten die die weitere Einrichtung des Moduls unterstützen. Einfach die Menüpunkte durchprobieren, sie erklären sich von selbst. Für erste Tests empfiehlt sich die lokale Konsole um die Ereignisse aus Sicht des Modules mit verfolgen zu können. Alles was hier gesendet wird, sollte ebenfalls am Server mitgeloggt werden können. Wenn bis hierher alles funktioniert, kann dann mir der Konfiguration in Fhem beginnen.
<div style="clear:both;"></div>

Am Server jetzt eine Konsole öffnen und folgende Topic (alle) einstellen.

mosquitto_sub -d -v -t \#
Mit dieser Einstellung werden alle Topics geloggt!

pi@raspberry ~ $ mosquitto_sub -d -v -t \#
Received CONNACK
Received SUBACK
Subscribed (mid: 1): 0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/36/temperature', ... (5 bytes))
/sonoff/36/temperature 14.06
Received PUBLISH (d0, q0, r1, m0, '/sonoff/35/Count', ... (3 bytes))
/sonoff/35/Count 0.0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/35/Total', ... (3 bytes))
/sonoff/35/Total 0.0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/35/Time', ... (1 bytes))
/sonoff/35/Time 0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/temperature', ... (5 bytes))
/sonoff/temperature 14.00
Received PUBLISH (d0, q0, r1, m0, '/sonoff/Count', ... (3 bytes))
/sonoff/Count 0.0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/Total', ... (3 bytes))
/sonoff/Total 0.0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/Time', ... (1 bytes))
/sonoff/Time 0
Received PUBLISH (d0, q0, r0, m0, 'stat/sonoff/1/POWER', ... (2 bytes))
stat/sonoff/1/POWER ON
Received PUBLISH (d0, q0, r0, m0, 'stat/sonoff/1/POWER', ... (3 bytes))
stat/sonoff/1/POWER OFF

Interessant sind für uns nun diese Einträge "stat/sonoff/1/POWER ON" , dazu am Taster des sonoff manuell umschalten. Dies entspricht genau der Syntax wie sie im Anschluss in Fhem dann zu verwenden ist.

Mit diesen Einstellungen können dann entweder nach Telemetriedaten oder nach Statusmeldungen gefiltert werden. Dies ist jedoch nur notwendig wenn bereits andere MQTT Devices am Broker hängen und es sonst zu unübersichtlich wird.
mosquitto_sub -h localhost -t tele/sonoff/# = Telemetriedaten
mosquitto_sub -h localhost -t stat/sonoff/# = Statusmeldungen
<div style="clear:both;"></div>

[[Datei:sonoff_sw_21.jpg|thumb|left|alt=Arends Log]]
Sehr nützlich das lokale Log zur Fehlersuche und Inbetriebnahme.

<div style="clear:both;"></div>
Als Besonderheit benutzt der Autor zum Senden und Empfangen unterschiedliche Syntax und unterscheidet dies durch vorangestellte Prefixe vor der eigentlichen Topic.
#define SUB_PREFIX "cmnd" Sonoff devices subscribe to:- cmnd/MQTT_TOPIC and cmnd/MQTT_GRPTOPIC
#define PUB_PREFIX "stat" Sonoff devices publish to:- stat/MQTT_TOPIC
#define PUB_PREFIX2 "tele" Sonoff devices publish telemetry data to:- tele/MQTT_TOPIC/UPTIME, POWER/LIGHT and TIME
Bitte dies unbedingt in der Fhem Konfiguration dann beachten!
<div style="clear:both;"></div>

==MQTT in Fhem einrichten==
[[Datei:sonoff_sw_24.jpg|thumb|left|alt=Fhem sonoff Schalter]]
Dieser einfache Schalter kommuniziert bidirektional mit dem sonoff Device.
<div style="clear:both;"></div>

[[Datei:sonoff_sw_25.jpg|thumb|left|alt=Fhem sonoff Schalter]]
Die Readings in diesem verwendeten Beispiel zeigen sich wie in Fhem gewohnt.
<div style="clear:both;"></div>

Die Einrichtung in Fhem wird von den Modulen 00_MQTT.pm, 10_MQTT_BRIDGE und 10_MQTT_DEVICE.pm unterstützt.

[https://forum.fhem.de/index.php?topic=27532.0 Link zum Forum: MQTT Fhem Einrichtung]

### 1. Broker anlegen ###
define myBroker MQTT 10.0.0.5:1883

### 2. Fhem Device mit MQTT verbinden ###
define Sonoff_Switch MQTT_DEVICE
attr Sonoff_Switch IODev myBroker
attr Sonoff_Switch eventMap ON:on OFF:off
attr Sonoff_Switch icon hue_filled_br30
attr Sonoff_Switch publishSet ON OFF cmnd/sonoff/1/POWER/set
attr Sonoff_Switch room MQTT
attr Sonoff_Switch stateFormat Licht
attr Sonoff_Switch subscribeReading_Licht stat/sonoff/POWER
# oder mit tele, je nachdem was in der user_config.h eingestellt wurde!!!
#attr Sonoff_Switch subscribeReading_Licht tele/sonoff/POWER
attr Sonoff_Switch subscribeReading_state cmnd/sonoff/1/POWER/set
attr Sonoff_Switch webCmd ON:OFF
Der hier dargestellte Beispielcode realisiert die Kommunikation zwischen Fhem und dem sonoff Modul via MQTT Broker. Zu beachten ist hier, dass '''subscribeReading_Licht''' und '''subscribeReading_state''' unterschiedliche Syntax des Topic Strings haben!

==Sonoff POW einrichten==
[[Datei:sonoff_sw_31.jpg|thumb|left|alt=Sonoff POW]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier geht es ausschließlich um das Modul Sonoff POW!}}
Das Modul kommt in gewohnter Itead Qualität und eine derart kostengünstige Energiemessung wird bei Smart Home Anwendern gerne eingesetzt. Die Originalsoftware habe ich nicht einmal getestet, da damit eine Anbindung an Fhem leider nicht möglich ist.

Ebenso möchte kaum jemand an eine nicht dokumentierte chinesische Cloud die Steuerbefehle seiner Schalter senden.
<div style="clear:both;"></div>
[[Datei:sonoff_sw_33.jpg|thumb|left|alt=Sonoff POW]]
Bitte auf keinen Fall das Modul während der Arbeiten an die Netzspannung anschießen. Zum Flashen genügt (und nur diese) die Versorgungspannung des USB-TTL Konverters. Wie auf dem Foto gut erkennbar, wurde dieses Modul ohne einlöten einer Pfostensteckerleiste geflasht. Die Steckverbindung wird einfach in die Lötaugen gesteckt und mit einem Gummiring fixiert, da ja spätere Flashvorgänge im Webif des Models funktionieren und so die Arbeit eingespart werden kann. Es steht jedoch nichts im Wege die Pfostensteckerleiste einzulöten.
<div style="clear:both;"></div>
Die Anschlüsse am Modul sind wie folgt belegt.
o GND
o TxD
o RxD
o VDD

Für den Flashvorgang gelten die selben Regeln wie schon beim sonoff Switch oben erwähnt (3,3V!).
<div style="clear:both;"></div>

===Sonoff POW Software===
[[Datei:sonoff_sw_35.jpg|thumb|left|alt=Sonoff POW FHEM]]
Als Software steht im Augenblick nur der Sketch von Arends zur Verfügung, liefert aber alles was das Herz begehrt und ist ist einfach zu handhaben. Hier eine eine einfache Darstellung mit der aktuellen Leistung und dem Tagesverbrauch. Zusätzlich besteht auch noch die Möglichkeit den angeschlossenen Verbraucher Ein- oder Auszuschalten. Getestet wurde hier mit der Version 2.06, 2.07 und 2.019a von Arends.
<div style="clear:both;"></div>
[[Datei:sonoff_pow_02.jpg|thumb|left|alt=Sonoff POW Webif]]
Seit Version 2.0.19a ist auch die Leistungsanzeige im WEBIF wie im Bild links integriert. Auch der Energieverbrauch des Vortages wird mit angezeigt. Alle hier angezeigten Daten werden auch zyklisch im MQTT String an FHEM übergeben.

Zusätzlich kann im Sketch auch das Feature "'''Power_Limit'''" aktiviert werden ( #define FEATURE_POWER_LIMIT in der sonoff.ino). Wenn dies gewünscht ist, dann vor dem compilieren die beiden // entfernen. Mit dem Power_Limit wird eine zusätzliche Nachricht erzeugt, wenn ein bestimmter einstellbarer Grenzwert über- oder unterschritten wird.

Es lassen sich dadurch Meldungen wie "Waschmaschine fertig" oder ähnliches ohne weitere Schwellwert Überwachungen in FHEM ableiten. Die Meldungen kommen in MQTT mit "'''tele/sonoff/POWER_LOW ON'''" bzw. "'''tele/sonoff/POWER_LOW OFF'''".
<div style="clear:both;"></div>
Bevor der Sketch compiliert wird, müssen neben den IP-Einstellungen noch in der user_config.h auch andere Einstellungen vorgenommen werden.

#define MODULE SONOFF_POW // Hardware module type (SONOFF, SONOFF_POW or ELECTRO_DRAGON)
#define PROJECT "sonoffpow" // PROJECT is used as the default topic delimiter and OTA file name // As an IDE restriction it needs to be the same as the main .ino file

Der Typ des Modules muss von "SONOFF" auf "'''SONOFF_Pow'''" geändert werden,. damit die Software weiß mit welchem Modul es zu tun hat und kann dann die entsprechenden Berechnungen durchführen. Die Leistungsdaten kommen ja in Form einer Frequenz aus dem Baustein und müssen im Sketch (xsns_hlw8102.ino) umgerechnet werden.

#elif MODULE == SONOFF_POW // programming header 1:3.3V 2:rx 3:tx 4:gnd
#define APP_NAME "Sonoff Pow module"
#define USE_POWERMONITOR // Enable Power Monitoring
#define USE_POWERCALIBRATION // Enable setting Calibration parameters by user commands

Bei Einsatz des POW Modules kann die externe Kalibrierung aktiviert werden.

Definition aus der power.ino (2.0.9) für die korrekte Umrechnung der gelieferten Frequenzen für die Leistungsdaten.
#define HLW_PREF 10000 // 1000.0W
#define HLW_UREF 2200 // 220.0V
#define HLW_IREF 4545 // 4.545A

#define HLW_PREF_PULSE 4975 // 4975us = 201Hz = 1000W
#define HLW_UREF_PULSE 1666 // 1666us = 600Hz = 220V
#define HLW_IREF_PULSE 1666 // 1666us = 600Hz = 4.545A

<div style="clear:both;"></div>
[[Datei:sonoff_sw_36.jpg|thumb|left|alt=Sonoff POW Attribute]]
Dieses Bild zeigt die Attribute die vom Modul via MQTT an FHEM geliefert werden.
<div style="clear:both;"></div>
aktuell gelieferte Readings (Mqtt Strings) vom Sketch nach unten dargestellter Definition in Fhem.
tele/sonoffpow/TODAY_ENERGY
tele/sonoffpow/PERIOD_ENERGY
tele/sonoffpow/POWER_FACTOR
tele/sonoffpow/CURRENT_POWER
tele/sonoffpow/VOLTAGE
tele/sonoffpow/CURRENT

Hier ein Mittschnitt des Datenverkehrs zum Broker zwecks Kontrolle der korrekten Funktion der Module und der Software.
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/RSSI', ... (2 bytes))
tele/sonoff/RSSI 82
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/TEMPERATURE', ... (3 bytes))
tele/sonoff/TEMPERATURE 1.9
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/HUMIDITY', ... (4 bytes))
tele/sonoff/HUMIDITY 97.9
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/POWER', ... (3 bytes))
tele/sonoff/POWER OFF
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/TIME', ... (19 bytes))
tele/sonoff/TIME 2016-11-12T10:36:13
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/UPTIME', ... (1 bytes))
tele/sonoffpow/UPTIME 1
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/RSSI', ... (2 bytes))
tele/sonoffpow/RSSI 34
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/TODAY_ENERGY', ... (5 bytes))
tele/sonoffpow/TODAY_ENERGY 0.083
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/PERIOD_ENERGY', ... (1 bytes))
tele/sonoffpow/PERIOD_ENERGY 8
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/CURRENT_POWER', ... (2 bytes))
tele/sonoffpow/CURRENT_POWER 97
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/POWER_FACTOR', ... (4 bytes))
tele/sonoffpow/POWER_FACTOR 1.00
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/VOLTAGE', ... (3 bytes))
tele/sonoffpow/VOLTAGE 225
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/CURRENT', ... (5 bytes))
tele/sonoffpow/CURRENT 0.426
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/POWER', ... (2 bytes))
tele/sonoffpow/POWER ON
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/TIME', ... (19 bytes))
tele/sonoffpow/TIME 2016-11-12T10:36:28
Sending PINGREQ
Received PINGRESP

Die Einstellungen können mit folgender Syntax angefordert werden (zwei Terminalfenster öffnen, eines zum protokollieren und eines zum Seden der Befehle).
mosquitto_sub -d -v -t \# MQTT Datenverkehr protokolieren
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/status/set -m "8" = SonoffPOW Status jetzt auslesen
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/TelePeriod/set -m "60" = Timer setzen, alle 60 Sekunden Daten senden
Die Kommandos können direkt am Broker (Terminalfenster Putty etc.) abgesetzt werden.

<div style="clear:both;"></div>

=== Sonoff POW Kalibrieren ===
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier wird beschrieben, wie der ''Sonoff POW kalibriert'' werden kann. }}
Ab Version 2.0.11 kann nun auch der POW kalibriert werden.
Dazu kann man 2 Konsolenfenster öffnen, im ersten aktiviert man das Protokoll für den Datenverkehr
mosquitto_sub -d -v -t \# MQTT Datenverkehr protokollieren

Dann kann mit folgenden Befehlen die HLW Referenz Pulsfrequenz gesetzt werden.
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/HLWUCAL/set -m "2100" default = 1950
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/HLWICAL/set -m "2450" default = 3500
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/HLWPCAL/set -m "13500" default = 12345
Entweder man hat eine definierte Last zur Verfügung oder besser man misst mit einem Leistungsmesser nach. Die Spannung kann man mit einem Multimeter nachmessen (sollte 230 V sein) und der Strom wird errechnet (bei 100 Watt I = P / U ) = 100/230 = 0,4347.
Die Referenzwerte solange geringfügig ändern bis die Ausgabe passt. Für die Ausgabe wird einfach eine Statusabfrage durchgeführt.

mosquitto_pub -q 2 -t cmnd/sonoffpow/1/status/set -m "8"
Befehl für die Statusabfrage

cmnd/sonoffpow/1/status/set 8
Received PUBLISH (d0, q0, r0, m0, 'stat/sonoffpow/1/STATUS', ... (103 bytes))
stat/sonoffpow/1/STATUS PWR: Voltage 225 V, Current 0.427 A, Current Power 98 W, Total Power Today 0.080 kWh, Power Factor 1.00
Ergebnis der Statusabfrage mit Spannung, Strom und Leistung.

<div style="clear:both;"></div>

===Sonoff POW FHEM Anbindung===
Ein Beispiel einer einfachen Anbindung via MQTT an Fhem. MQTT ist insofern notwendig, da in der Software ESPEasy und der Bridge noch keine Implementierung der Frequenzumrechnung enthalten ist.

define Sonoff_Pow MQTT_DEVICE
attr Sonoff_Pow IODev myBroker
attr Sonoff_Pow eventMap ON:on OFF:off
attr Sonoff_Pow icon measure_power
attr Sonoff_Pow publishSet ON OFF cmnd/sonoffpow/1/POWER/set
attr Sonoff_Pow room MQTT
attr Sonoff_Pow subscribeReading_Power tele/sonoffpow/POWER
attr Sonoff_Pow subscribeReading_state cmnd/sonoffpow/1/POWER/set
attr Sonoff_Pow subscribeReading_TODAY_ENERGY tele/sonoffpow/TODAY_ENERGY
attr Sonoff_Pow subscribeReading_PERIOD_ENERGY tele/sonoffpow/PERIOD_ENERGY
attr Sonoff_Pow subscribeReading_CURRENT_POWER tele/sonoffpow/CURRENT_POWER
attr Sonoff_Pow subscribeReading_VOLTAGE tele/sonoffpow/VOLTAGE
attr Sonoff_Pow subscribeReading_CURRENT tele/sonoffpow/CURRENT
attr Sonoff_Pow subscribeReading_AKTUELL stat/sonoffpow/1/STATUS
attr Sonoff_Pow webCmd ON:OFF
attr Sonoff_Pow stateFormat {sprintf("akutelle Leistung: %.1f W Tagesverbrauch: %.2f Kw/h", ReadingsVal($name,"CURRENT_POWER",undef), ReadingsVal($name,"TODAY_ENERGY",undef))}
Zusätzlich kann hier noch das Relais mit "on" und "off" ein- ausgeschaltet werden. Ab Version 2.0.15 wurden hier die ReadingsNamen auf TODAY_ENERGY und PERIOD_ENERGY (anstatt _POWER) geändert.

===Sonoff POW Netz-Anschluß===
[[Datei:sonoff_sw_34.jpg|thumb|left|alt=Sonoff POW Netzanschluß]]
Erst wenn alle Arbeiten an der Hard- und Software abgeschlossen sind, kann man das Modul an die Netzspannung anschließen. Wer es sich einfach machen will, nimmt eine Industriell gefertigte 230 V Verlängerung (zwischen 1,5 - 3 Meter) und schneidet sie in der Mitte durch. Nach dem abisolieren der flexiblen Drähte sollte diese '''verlötet oder mit Aderendhülsen''' versehen werden (müssen aber exakt passen, da hier kaum Platz in den Klemmen ist).
Mit einem kleinen Schraubendreher kann man die Feder der Klemmen niederdrücken und das verzinnte Drahtende tief ich die Öffnung stecken. Es dürfen keine Drahtlitzen aus den Öffnungen sichtbar sein, Kurzschlußgefahr! Ebenso sollte eine Zugprobe durchgeführt werden ob die Klemme auch richtig eingerastet ist.

'''ACHTUNG:''' diese Arbeiten müssen von einem ausgebildeten Fachpersonal (Elektriker) durchgeführt werden, Lebensgefahr!
<div style="clear:both;"></div>

===Sonoff POW Design===

====ReadingsGroup normal====
[[Datei:sonoff_sw_46.jpg|thumb|left|alt=Sonoff POW Design]]
Viele Benutzer wollen schönere und funktionelle Ausgaben am Bildschirm sehen. Die Möglichkeiten nach oben sind hier sehr vielfältig. Anhand von zwei einfachen aber mächtigen Funktionen hier ein kleines Beispiel wie hier im Bild dargestellt.

Was das Design betrifft, sind hier mehrere Möglichkeiten gegeben und nach oben ist für findige Anwender alles offen.

<div style="clear:both;"></div>

Zunächst wird mit dem Hilfsmodul "'''average'''" eine Art Statistik (Durchschnittsberechnung, Min.,Max., etc.) hinzugefügt. Das beschränkt sich auf eine einzige Zeile. Es würde sich auch '''statistic''' dazu eignen.

define Sonoff_Pow_CURRENT_POWER average Sonoff_Pow:CURRENT_POWER.*
Die "average" Funktion wird in das Device "Sonof_Pow" auf das Reading "CURRENT_POWER" hinzugefügt.

Der zweite Schritt wird eine '''readingsGroup''' mit den gewünschten und gefilterten Ausgabedaten. Durch die verschiedenen IF Abfragen der unterschiedlichen VALUE wird bei über- oder unterschreiten eines Wertes eine bestimmte Farbe angewandt. Weitere Beispiele dazu siehe im Wiki unter [http://www.fhemwiki.de/wiki/ReadingsGroup readingsGroup]

define SonoffPows readingsGroup <%measure_power>,<aktuell>,<Tag>,<Strom>,<Durchschnitt>,<max.P>,<Schaltzyklen>,< hr > .*(Sonoff_Pow|Sonoff_Pow2):CURRENT_POWER,TODAY_ENERGY,CURRENT,CURRENT_POWER_avg_day,CURRENT_POWER_max_day,PERIOD_ENERGY
attr SonoffPows mapping %ALIAS
attr SonoffPows nameStyle style="color:yellow"
attr SonoffPows room MQTT
attr SonoffPows valueFormat {'CURRENT_POWER' =>"%.0f W", 'TODAY_ENERGY' =>"%.2f Kw", 'CURRENT' =>"%.2f A",'CURRENT_POWER_max_day' => "%.0f W",'CURRENT_POWER_avg_day' => "%.2f W",'PERIOD_ENERGY'=>"%.0f Zyklen"}
attr SonoffPows valueStyle { if($READING eq "CURRENT_POWER" && $VALUE >= 0 && $VALUE <= 100){ 'style="color:green;;text-align:right"' }elsif( $READING eq "CURRENT_POWER" && $VALUE > 100 && $VALUE < 200){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER" && $VALUE >= 200){ 'style="color:red;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE >= 4.8){ 'style="color:red;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE <= 2.5){ 'style="color:green;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE > 2.5 && $VALUE < 4.8 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT" && $VALUE <= 0.45){'style="color:green;;text-align:right"'}elsif( $READING eq "CURRENT" && $VALUE > 0.45 && $VALUE < 0.87 ){'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT" && $VALUE >= 0.87){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE <= 100){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE > 100 && $VALUE < 200 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE >= 200){ 'style="color:red;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE <= 10){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE > 10 && $VALUE < 15 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE >= 15){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE <= 100){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE > 100 && $VALUE < 200 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE >= 200){ 'style="color:red;;text-align:right"' } }

Die readingsGroup sind etwas komplex zu lesen, aber nach etwas Einarbeitung klappt das schon. Die in diesem Beispiel verwendeten Readingsnamen beziehen sich auf die Beispielkonfigurationen hier im Wiki.
<div style="clear:both;"></div>

<div style="clear:both;"></div>
====ReadingsGroup mit Schaltmöglichkeit====
[[Datei:sonoff_pow_03.jpg|thumb|left|alt=readingsGroup mit Schalter]]
Die vorher erwähnte ReadingsGroup kann auch gleich mit einem Schalter versehen werden um den POW Ein- oder Aus schalten zu können. Dazu ist aber eine andere Einstellung im Sketch erforderlich.
<div style="clear:both;"></div>

In der "'''user_config.h'''" muss an dieser Stelle auch die "'''PUB_PREFIX'''" auf die gleiche Topic wie "PUB_PREFIX2" eingestellt werden. Durch diese Maßnahme wird erreicht, dass sofort nach dem Knopfdruck auch der Status mit der Topic "tele" übertragen wird. Würde der weiterhin mit "stat" übertragen, kann er in der Readingsgroup nur sehr umständlich weiter behandelt werden. Dadurch wird erreicht, dass der Schalter sofort nach dem Schaltvorgang und der Rückmeldung (Status) auch seine Farbe ändert. Wird dieser Eintrag vergessen, ändert der Schalter erst nach Eintreffen der nächsten zyklischen Abfrage seinen Status/Farbe.

#define SUB_PREFIX "cmnd" // Sonoff devices subscribe to:- SUB_PREFIX/MQTT_TOPIC and SUB_PREFIX/MQTT_GRPTOPIC
#define PUB_PREFIX "tele" // Sonoff devices publish to:- PUB_PREFIX/MQTT_TOPIC
#define PUB_PREFIX2 "tele" // Sonoff devices publish telemetry data to:- PUB_PREFIX2/MQTT_TOPIC/UPTIME, POWER/LIGHT and TIME
hier die PUB_PREFIX mit der geänderten Topic "tele" anstatt "stat"

define SonoffPows readingsGroup <%measure_power>,<aktuell>,<Tag>,<Gestern>,<Strom>,<Durchschnitt>,<max.P>,<Zyklus>,<Faktor>,<Status>,< hr > .*(Sonoff_Pow|Sonoff_Pow2|Sonoff_Pow3):CURRENT_POWER,TODAY_ENERGY,YESTERDAY_ENERGY,CURRENT,CURRENT_POWER_avg_day,CURRENT_POWER_max_day,PERIOD_ENERGY,POWER_FACTOR,LIGHT
attr SonoffPows commands {'LIGHT.ON' => 'set $DEVICE OFF','LIGHT.OFF' => 'set $DEVICE ON'}
attr SonoffPows mapping %ALIAS
attr SonoffPows nameStyle style="color:yellow"
attr SonoffPows room Energie,MQTT
attr SonoffPows valueFormat {'CURRENT_POWER' =>"%.0f W", 'TODAY_ENERGY' =>"%.2f Kw",'YESTERDAY_ENERGY' =>"%.2f Kw", 'CURRENT' =>"%.2f A",'CURRENT_POWER_max_day' => "%.0f W",'CURRENT_POWER_avg_day' => "%.2f W",'CURRENT_POWER'=>"%.0f W",'POWER_FACTOR' => "%.2f "}
attr SonoffPows valueIcon {'LIGHT.ON' => 'rc_GREEN@green', 'LIGHT.OFF' => 'rc_RED@red'}
attr SonoffPows valueStyle { if($READING eq "CURRENT_POWER" && $VALUE >= 0 && $VALUE <= 100){ 'style="color:green;;text-align:right"' }elsif( $READING eq "CURRENT_POWER" && $VALUE > 100 && $VALUE < 200){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER" && $VALUE >= 200){ 'style="color:red;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE >= 4.8){ 'style="color:red;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE <= 2.5){ 'style="color:green;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE > 2.5 && $VALUE < 4.8 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "YESTERDAY_ENERGY" && $VALUE <= 2.5){ 'style="color:green;;text-align:right"' }elsif( $READING eq "YESTERDAY_ENERGY" && $VALUE > 2.5 && $VALUE < 4.8 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "YESTERDAY_ENERGY" && $VALUE >= 4.8){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT" && $VALUE <= 0.45){'style="color:green;;text-align:right"'}elsif( $READING eq "CURRENT" && $VALUE > 0.45 && $VALUE < 0.87 ){'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT" && $VALUE >= 0.87){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE <= 100){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE > 100 && $VALUE < 200 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE >= 200){ 'style="color:red;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE <= 10){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE > 10 && $VALUE < 15 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE >= 15){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE <= 100){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE > 100 && $VALUE < 200 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE >= 200){ 'style="color:red;;text-align:right"' } }
hier die erweiterte ReadingsGroup mit dem Schalter. Bei Bedarf sind hier die Devicenamen anzupassen wenn andere Namen verwendet werden (Sonoff_Pow|Sonoff_Pow2|Sonoff_Pow3).

<div style="clear:both;"></div>

====POW mit FTUI anzeigen====
[[Datei:sonoff_pow_energy.JPG|thumb|left|alt=Tablett FTUI]]
Wer möchte kann die Energieanzeigen auch mit der [https://forum.fhem.de/index.php/topic,34233.0.html Tablett UI] für eine Tablet Ansicht gestalten. Mit dieser stehen viele Möglichkeiten zu einer attraktiven Darstellung zur Verfügung.
Hier ein Beispiel welches mit den Widget "[http://www.fhemwiki.de/wiki/FHEM_Tablet_UI#Widget_THERMOSTAT thermostat]" dargestellt ist.
<div style="clear:both;"></div>

==Sonoff Slampher Flashen==
[[Datei:sonoff_sl_53.jpg|thumb|left|alt=Sonoff SLAMPHER]]
Dieses Modul ist eine Besonderheit was das Flashen betrifft, denn mit Hilfe des Tasters kann der ESP8266 NICHT in den Flashmode gebracht werden. Der Taster ist intern anderwärtig verdrahtet und somit für diesen Zweck nicht zu gebrauchen.

Wie hier links im Bild zu sehen ist, muss der rechte Pin des R20 (oben im Bild) während dem Einstecken des USB Steckers auf Masse gelegt werden. Die beste Möglichkeit ist ein Stücken Draht anzulöten und diesen dann beim einstecken auf den Masse Pin des USB-Konverters zu legen.

Pinbelegung des Steckers von oben nach unten:
o - GND
o - TxD
o - RxD
'''o''' - Vdd

<div style="clear:both;"></div>

[[Datei:sonoff_sl_51.jpg|thumb|left|alt=Sonoff SLAMPHER R20]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier ist genau ersichtlich, wo der R20 auf der Platine platziert ist. }}
Hier nocheinmal schön zu sehen wo der R20 (der ist nicht eingelötet sondern leer) exakt auf der Platine liegt, gemeint ist der rechte Pin. Hier kann auch leicht gelötet werden, da keine empfindlichen Bauteile in der Nähe sind und auch genug Platz vorhanden ist.

<div style="clear:both;"></div>
[[Datei:sonoff_sl_50.jpg|thumb|left|alt=Sonoff SLAMPHER R20]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier ist genau ersichtlich, wo der Draht am R20 aufgelötet wurde }}
Hier ist ein kleines Stück Schaltdraht auf den Pin bereist aufgelötet und bereit zum Flashen!

In diesem Beispiel wurde keine Pfostensteckerleiste auf die Platine aufgelötet, sondern nur durchgesteckt und mit einem Gummiring zum Relais fixiert, das erspart den Lötvorgang, weil in Zukunft dann ohnehin OTA geflasht werden kann.

Also Pin20 auf Masse legen und USB-Konverter an den PC einstecken, dann den Draht von der Masse entfernen. Der ESP8266 sollte jetzt im Flashmodus bereit stehen und kann wie bereits oben beschrieben geflasht werden.

<div style="clear:both;"></div>

===Sonoff Slampher Software===
[[Datei:sonoff_sl_54.jpg|thumb|left|alt=Sonoff SLAMPHER FHEM]]

Als Software wird Arends Sketch installiert (Kommunikation über MQTT), da zum derzeitigen Zeitpunkt ESPEasy das Modul noch nicht integriert hat und somit auch nicht ansteuern kann.
<div style="clear:both;"></div>

define Sonoff_SL MQTT_DEVICE
attr Sonoff_SL IODev myBroker
attr Sonoff_SL devStateIcon ON:rc_GREEN:OFF OFF:rc_RED:ON
attr Sonoff_SL icon hue_filled_br30
attr Sonoff_SL publishSet ON OFF cmnd/sonoffsl/1/POWER/set
attr Sonoff_SL room Bewegung,_Sonoff
attr Sonoff_SL stateFormat Licht
attr Sonoff_SL subscribeReading_Licht tele/sonoffsl/POWER
attr Sonoff_SL subscribeReading_state cmnd/sonoffsl/1/POWER/set
attr Sonoff_SL webCmd ON:OFF

Hier ein Beispiel wie in FHEM der Slampher eingebunden werden kann. In diesem Beispiel wird davon ausgegangen, das das Modul "sonoffsl" unter Konfiguration am WEBIF (Configure MQTT bei Topic) so unbenannt wurde. Wer einen anderen Namen haben möchte, muss dies dann auch in FHEM entsprechend anpassen.

<div style="clear:both;"></div>

==Sonoff Th10/16 FHEM==
[[Datei:sonoff_th_01.jpg|thumb|left|alt=Sonoff TH10]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Temperatur Modul TH10 / 16! }}
Das Modul kann durch drücken des Tasters während dem Einstecken des USB-Konverters in den Flashmodus gebracht werden.
Der Th10/16 kann mit zwei unterschiedlichen Typen von Sensoren bestückt werden, hier im Beispiel mit dem externen Temperaturfühler DS18B20.

Wie im Bild klar zu sehen ist, kann das Webif auch zur Darstellung via Mobile verwendet werden. Mit "Toggle" wird Ein- oder Aus geschaltet und darunter ist die aktuelle Temperatur ersichtlich. Für diese Ansicht muss keine MQTT Verbindung eingerichtet werden, da die Kommunikation hier rein über HTTP erfolgt.

Die unten dargestellten Beispiele für FHEM beziehen sich auf Arends Sketch, also über MQTT. Dieses Modul kann aber genauso leicht über ESPEasy und der ESPEasy-Bridge eingebunden werden.

<div style="clear:both;"></div>
Pinbelegung des Steckers von oben nach unten:
o - GND
o - TxD
o - RxD
'''o''' - Vdd

#define DSB_PIN 14 // GPIO 14 = DS18x20 (Sonoff_TH10A(16A), Sonoff SV)
#define DSB_RESOLUTION 2 // Maximum number of decimals (0 - 3) showing Temperature
// *** Option 1 - Single DS18B20 - Select either Option 1 OR Option 2
#define SEND_TELEMETRY_DS18B20 // Enable sending single temperature telemetry
// *** Option 2 - Multiple DS18B20 and/or DS18S20 (needs OneWire library!)
// #define SEND_TELEMETRY_DS18x20 // Enable sending multi temperature telemetry
In der user_config.h (Arends Sketch) muss hier die Option 1 aktiviert werden (entfernen der vorangestellten //) damit die Telemetriedaten auch gesendet werden. Es empfiehlt sich mindestens die Version >= V 2.0.16, weil hier die Sensoren erweitert wurden.

#define DHT_PIN 14 // GPIO 14 = AM2301 (Sonoff_TH10A(16A), Sonoff SV)
#define DHT_TYPE AM2301 // DHT module type (DHT11, DHT21, DHT22, AM2301, AM2302 or AM2321)
#define DHT_RESOLUTION 1 // Maximum number of decimals (0 - 3) showing Temperature
#define SEND_TELEMETRY_DHT // Enable sending temperature and humidity telemetry
Beispiel für den Sensor DHT22, Temperatur und Luftfeuchte. Es dürfen aber nicht beide Sensoren (DS18B20 + DHT22) gleichzeitig aktiviert werden, da ja beide an GPIO14 angehängt werden und es ansonsten zu Fehlfunktionen kommen würde.

<div style="clear:both;"></div>
[[Datei:sonoff_th_02.jpg|thumb|left|alt=Sonoff TH10]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Einbindung in Fhem via MQTT! }}
<div style="clear:both;"></div>

### Temperatur und Luftfeuchte vom Sonoff Switch ###
define Sonoff_Temp MQTT_DEVICE
attr Sonoff_Temp IODev myBroker
attr Sonoff_Temp alias Pool Wasser
attr Sonoff_Temp eventMap ON:on OFF:off
attr Sonoff_Temp icon temperature_humidity
attr Sonoff_Temp publishSet ON OFF cmnd/sonoffth/1/POWER/set
attr Sonoff_Temp room _Sonoff
attr Sonoff_Temp stateFormat {sprintf("Temperatur: %.1f Grad", ReadingsVal($name,"TEMPERATURE",0))}
attr Sonoff_Temp subscribeReading_TEMPERATURE tele/sonoffth/DS18B20/TEMPERATURE
attr Sonoff_Temp subscribeReading_humidity tele/sonoffth/HUMIDITY
attr Sonoff_Temp subscribeReading_state cmnd/sonoffth/1/POWER/set
Beispiel für FHEM mit Temperaturanzeige mit DS18B20

define Sonoff_Switch MQTT_DEVICE
attr Sonoff_Switch IODev myBroker
attr Sonoff_Switch alias Pool Licht
attr Sonoff_Switch devStateIcon on:rc_GREEN:off off:rc_RED:on
attr Sonoff_Switch eventMap ON:on OFF:off
attr Sonoff_Switch icon light_ceiling
attr Sonoff_Switch publishSet ON OFF cmnd/sonoffth/1/POWER/set
attr Sonoff_Switch room _Sonoff
attr Sonoff_Switch stateFormat Licht
attr Sonoff_Switch subscribeReading_Licht tele/sonoffth/POWER
attr Sonoff_Switch subscribeReading_state cmnd/sonoffth/1/POWER/set
attr Sonoff_Switch webCmd ON:OFF
Der Schalter nochmals seperat dargestellt, je nach Geschmack.

<div style="clear:both;"></div>

==Sonoff CH4 4-Kanal Schaltmodul==
[[Datei:sonoff_ch4_1.jpg|thumb|left|alt=Sonoff CH4]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Achtung andere Einstellungen der Arduino IDE: Select Board "Generic ESP8285 Module" (=Flash Mode "DOUT") and Flash Size "1M (64K SPIFFS)"n! }}

Der Sonoff CH4 ist mit seinen 4 Kanälen ein sehr preiswertes Modul im Gehäuse und für Hutschinenmontage. Anstatt des üblichen ESP8266 besitzt dieses Modul schon den moderneren '''ESP8285'''. Es müssen daher in der Arduino IDE andere Einstellungen vorgenommen werden. Unter Board wird hier das "'''Generic 8285 Module'''" mit '''1M und 64K Spiffs''' angewählt. Der Flashmode "'''DOUT'''" wird dann automatisch eingestellt, bzw. ausgeblendet.

Das Modul ist etwas größer als die anderen Sonoff Produkte und besitzt mit 14,5 x 9 cm schon beachtliche Einbau Maße.
<div style="clear:both;"></div>
[[Datei:sonoff_ch4_2.jpg|thumb|left|alt=Sonoff CH4 FDTI]]
Als weitere Besonderheit sei hier erwähnt, das die Signale '''RxD auf RxD und TxD auf TxD''' des FTDI Konverters zu verbinden sind. Wie bei allen Sonoff Modulen darf man '''zum flashen keine Netzspannung anschließen''', sondern nur über die Versorgungsspannung des FDTI Konverters mit 3,3 V versorgen (Jumper richtig setzen). Die Stiftleiste für den FTDI Anschluß ist hier schon eingelötet.

In den Flashmodus gelangt man durch drücken der '''Taste FW/IO0''' während des einstecken des USB Anschlusses.
<div style="clear:both;"></div>
[[Datei:sonoff_ch4_3.jpg|thumb|left|alt=Sonoff CH4 Arends]]
Hier die Ansicht des Webinterface des Arends Sketches!
Bei der Software sei erwähnt, das die getestete Version 3.1.16 nur bei Kanal 1 den Modus "PulseTime" beherrscht. Wer also gepulste Ausgänge (zB: elektrische Garage/Toröffner) benötigt muss diese per Software nachbilden oder mit dem Kanal 1 auskommen. Eine "Pulsetime 10" ist ein guter Wert dafür (etwa 1 Sekunde).

Als Alternative kann mit dieser HTML Seite des Webservers am Modul des CH4 schon mit jedem Browser fähigem Handy (Android, iPhone, Windows) aufgerufen werden und somit alle Funktionen gesteuert werden.
<div style="clear:both;"></div>
[[Datei:sonoff_ch4_4.jpg|thumb|left|alt=Sonoff CH4 Software APP]]
Hier dargestellt die Original Software die Sonoff zum Modul liefert (EWeLink) und über ihre Cloud verbindet. Leider kann hier keine gepulste Ausgabe erfolgen. Mit einem Countdown kann zwar der Ausgang wieder abgeschaltet werden, die kleinste Zeiteinheit ist aber 1 Minute und somit für einen Impuls leider nicht zu gebrauchen. Ebenso kann mit dieser Software keine Einbindung in Fhem erfolgen, obwohl es eine nette anschauliche Darstellung ist.
<div style="clear:both;"></div>

=Erweiterungen=
<div style="clear:both;"></div>

==Sonoff Switch mit Temperatur + Luftfeuchte==
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier geht es um nützliche Hardware Erweiterungen an den Originalmodulen!}}
Wozu überhaupt den Switch erweitern wenn es auch die Modelle TH10 und TH16 gibt?

Manche Personen können dadurch dem Basteltrieb nachkommen, aber das wesentliche ist der Preis, da die Switches doch fast um die Hälfte billiger sind. Die Sensoren kosten ebenfalls kaum nennenswerte Beträge.

Oder es hat schon jemand Switches im Einsatz und möchte jetzt zusätzlich die Temperatur erfassen!

<div style="clear:both;"></div>

=== Hardware erweitern mit DHT22 ===
[[Datei:sonoff_sw_4.PNG|thumb|left|alt=Sonoff Switch Pinleiste mit Temperatur]]
Am Sonoff Switch wurde ja schon eine Stiftleiste zum Flashen eingelötet. Diese Stiftleiste bietet schon alle Anschlüsse welche für die Temperatur- und Luftfeuchtemessung benötigt werden. Am 5. Anschluß der Stifftleiste ist das Signal "SCL" (GPIO14) herausgeführt, welches für den DHT22 zur Erfassung der Messdaten benötigt wird. Der Sonsor wird mit einem einem 3-poligen Kabel (zB: ein Steckkabel für ein Breadboard oder direkt anlöten) verbunden. Damit der DHT22 korrekt funktioniert, wird ein Widerstand mit 4,7 K Ohm zwischen Vdd und Data am DHT22 zusätzlich benötigt.

<div style="clear:both;"></div>

[[Datei:sonoff_sw_45.jpg|thumb|left|alt=AM2302 / DHT22]]

Ansicht des DHT22 (AM2302) mit den aufgesteckten Verbindungskabeln. Von links nach rechts sind das

1 = VCC 3,3 V
2 = Data
3 = nc (nicht belegt)
4 = GND

Pin1 (VCC) des DHT22 muss also auf Pin1 der Stiftleiste, Pin2 (Data) auf Pin5 und Pin4 (GND) auf Pin4.
Pin2 und Pin1 soll hier noch der Widerstand aufgelötet werden.

1 ------- 1 (VDD)
2 ------- 5 (GPIO14)
3
4 ------- 4 (GND)
DHT22 Stiftleiste

<div style="clear:both;"></div>

[[Datei:sonoff_sw_44.jpg|thumb|left|alt=umgebautes Modul]]
Diese Darstellung zeigt das umgebaute und bereits verschlossene Modul. Auf der Seite des Tasters (bitte nur hier, da auf der anderen Seite die 230 V verlaufen und neben der Lebensgefahr auch den Sensor beeinflussen) ist hier einfach mit einer Eisensäge ein Schlitz eingesägt, der dient in diesem Falle als Kabeldurchführung. Ein Schlitz ist besser als ein Loch, da der Oberteil des Gehäuses sich leichter aufsetzen läßt. Wer ein längeres Kabel benötigt, kann natürlich auch ein 3-poliges Telefonkabel (oder Mikrokabel oder sonstiges) verwenden. Der Sensor sollte etwas Abstand zum Gehäuse haben, da dieses auch eine Eigenerwärmung hat. Wer es ganz originalgetreu lösen will, kann auch eine 3-polige Mini Buchse für Klinckenstecker (3,5mm) einbauen so wie sie am TH10/16 vorhanden ist.
<div style="clear:both;"></div>

=== Software anpassen am Beispiel MQTT ===
[[Datei:sonoff_sw_40.jpg|thumb|left|alt=Sonoff MQTT]]

Wer über MQTT kommuniziert und die Software von Theo Arends benutzt, muss folgende Dinge beachten. In der Datei '''user_config.h''' müssen im Abschnitt '''Module = SONOFF''' die Slashes so wie unten dargestellt entfernt werden, damit erstens die Interrupts abgefragt werden und zweitens die Telemetriedaten gesendet werden. Ebenso ist der verwendete Sensor bei "'''define DHT_TYPE'''" eingestellt werden. In dem hier gezeigten Beispiel also "'''DHT22'''".

#if MODULE == SONOFF // programming header 1:3.3V 2:rx 3:tx 4:gnd
#define APP_NAME "Sonoff module"
#define LED_PIN 13 // GPIO 13 = Green/Blue Led (0 = On, 1 = Off) - Sonoff
#define LED_INVERTED 1 // 0 = (1 = On, 0 = Off), 1 = (0 = On, 1 = Off)
#define REL_PIN 12 // GPIO 12 = Red Led and Relay (0 = Off, 1 = On)
#define KEY_PIN 0 // GPIO 00 = Button
/*-------------------------------------------------------------------------------------------*/
#define DSB_PIN 4 // GPIO 14 = DS18B20 (Sonoff_TH10A(16A), Sonoff SV)
#define SEND_TELEMETRY_DS18B20 // Enable sending temperature telemetry
/*-------------------------------------------------------------------------------------------*/
#define DHT_PIN 14 // GPIO 14 = AM2301 (Sonoff_TH10A(16A), Sonoff SV)
#define DHT_TYPE DHT22 // DHT module type (DHT11, DHT21, DHT22, AM2301, AM2302 or AM2321)
#define SEND_TELEMETRY_DHT // Enable sending temperature and humidity telemetry

<div style="clear:both;"></div>

=== Software Anpassung DHT22 in Fhem ===
[[Datei:sonoff_sw_41.jpg|thumb|left|alt=umgebautes Modul]]

Links in der Hardcopy sind die Readings die nach der Anpassung von FHEM (Broker) befüllt werden sollten.

<div style="clear:both;"></div>

### Temperatur und Luftfeuchte vom Sonoff Switch ###
define Sonoff_Temp MQTT_DEVICE
attr Sonoff_Temp IODev myBroker
attr Sonoff_Temp icon temperature_humidity
attr Sonoff_Temp room MQTT
attr Sonoff_Temp stateFormat {sprintf("Temperatur: %.1f Grad Feuchte: %.1f ", ReadingsVal($name,"temperature",0), ReadingsVal($name,"humidity",0))}
attr Sonoff_Temp subscribeReading_humidity tele/sonoff/HUMIDITY
attr Sonoff_Temp subscribeReading_temperature tele/sonoff/TEMPERATURE
Als Beispiel die zusätzliche Erweiterung um die Temperatur und die Luftfeuchte in FHEM. Der in der Topic verwendete Name "sonoff" muss natürlich der Einstellung in der Software am Switch entsprechen. Bei Verwendung mehrerer Switches muss natürlich auch der Name bei jedem geändert werden.

<div style="clear:both;"></div>

=== Logfile für die Temperatur ===
define SVG_FileLog_Sonoff_Temp SVG myDbLog:SVG_FileLog_Sonoff_Temp:HISTORY
attr SVG_FileLog_Sonoff_Temp room MQTT

Und schließlich fehlt noch das Logfile, damit der Temperaturverlauf auch in schönen Plots dargestellt werden kann.
Das hier verwendete Beispiel funktioniert nur mit einer DbLog.

<div style="clear:both;"></div>

==Sonoff Switch als Thermostat verwenden mit MQTT==

[[Datei:sonoff_sw_55.jpg|thumb|left|alt=Thermostat]]
Mit diesem einfachen Beispiel wird ein Pelett Ofen mit einem externen Thermostat (sonoff Switch oder TH10/16) gesteuert. Zum besseren Überblick wird die Steuerung in einzelne Module getrennt, es könnte aber auch einiges zu einer einzigen Definition zusammen gefasst werden. Der Thermostat könnte auch als Frostwächter benutzt werden und ein anderes Heizgerät steuern.
<div style="clear:both;"></div>

###################################
### Sonoff Thermostat Regelung ####
###################################
define Sonoff_dht MQTT_DEVICE
attr Sonoff_dht IODev myBroker
attr Sonoff_dht alias Raumtemperatur
attr Sonoff_dht group Thermostat
attr Sonoff_dht icon temperature_humidity
attr Sonoff_dht publishSet ON OFF cmnd/sonoff_dht/1/POWER/set
attr Sonoff_dht room _Sonoff
attr Sonoff_dht stateFormat {sprintf("Temperatur: %.1f Grad Feuchte: %.1f ", ReadingsVal($name,"TEMPERATURE",0), ReadingsVal($name,"HUMIDITY",0))}
attr Sonoff_dht subscribeReading_HUMIDITY tele/sonoff_dht/DHT/HUMIDITY
attr Sonoff_dht subscribeReading_TEMPERATURE tele/sonoff_dht/DHT/TEMPERATURE
attr Sonoff_dht subscribeReading_state cmnd/sonoff_dht/1/POWER/set
FHEM Definition zur Erfassung der Temperatur und der Luftfeuchte. Damit dieses Beispiel funktioniert, ist am Sonoff Modul die Topic "'''sonoff_dht'''" zu setzen. Dieser Temperaturwert dient dem Thermostat als ISTWert.

define Sonoff_Sw MQTT_DEVICE
attr Sonoff_Sw IODev myBroker
attr Sonoff_Sw alias Pellets Ofen
attr Sonoff_Sw devStateIcon on:rc_GREEN:off off:rc_RED:on
attr Sonoff_Sw eventMap ON:on OFF:off
attr Sonoff_Sw group Thermostat
attr Sonoff_Sw icon sani_boiler_temp
attr Sonoff_Sw publishSet ON OFF cmnd/sonoff_dht/1/POWER/set
attr Sonoff_Sw room _Sonoff
attr Sonoff_Sw stateFormat Licht
attr Sonoff_Sw subscribeReading_Licht tele/sonoff_dht/POWER
attr Sonoff_Sw subscribeReading_state cmnd/sonoff_dht/1/POWER/set
attr Sonoff_Sw webCmd ON:OFF
FHEM Definition zum Absetzen der Befehle für das Relais (Thermostat) Ein- / Aus. Wenn das zu steuernde Geräte einen potentialfreien Thermostatanschluß benötigt (in den meisten Fällen), muss noch ein Relais dazwischen geschaltet werden um die Trennung der Netzspannung zu gewährleisten.

define ThermostatPellets dummy
attr ThermostatPellets alias Pellets Ofen Sollwert
attr ThermostatPellets group Thermostat
attr ThermostatPellets icon temp_control
attr ThermostatPellets room _Sonoff
attr ThermostatPellets setList state:0,5,10,12,13,14,15,16,17,17.5,18,18.5,19,19.5,20,20.5,21,21.5,22,23,24,25,26,27
attr ThermostatPellets webCmd state
Die Sollwertvorgabe für das Thermostat durch einen Dummy, damit können die gewünschten Temperaturen eingestellt werden.

### sofort ausführen wenn neuer Sollwert eingestellt wird ###
define Thermostat_on_notify notify ThermostatPellets IF (ReadingsVal("Sonoff_Sw","state",0) eq "OFF" && (ReadingsVal("Sonoff_dht","TEMPERATURE",0) <= Value("ThermostatPellets"))) (set Sonoff_Sw ON)
define Thermostat_off_notify notify ThermostatPellets IF (ReadingsVal("Sonoff_Sw","state",0) eq "ON" && (ReadingsVal("Sonoff_dht","TEMPERATURE",0) > Value("ThermostatPellets"))) (set Sonoff_Sw OFF)
Mit einem notify wird die manuelle Änderung des Sollwertes überwacht und sofort reagiert.

## zyklisch prüfen ob Sollwert erreicht wurde ###
define Thermostat_on at +*00:15:00 IF (ReadingsVal("Sonoff_Sw","Licht",0) eq "OFF" && (ReadingsVal("Sonoff_dht","TEMPERATURE",0) <= Value("ThermostatPellets"))) (set Sonoff_Sw ON)
define Thermostat_off at +*00:15:00 IF (Value("Sonoff_Sw") eq "ON" && (ReadingsVal("Sonoff_dht","TEMPERATURE",0) > Value("ThermostatPellets"))) (set Sonoff_Sw OFF)
Hier noch die Soll- Ist Wertvergleiche zur Steuerung. Es wird alle 15 Minuten überprüft ob die Temperatur erreicht ist. Bei einer trägen Heizung sollten 15 Minuten ausreichend sein, wer will kann dies aber auch alle 5 oder 10 Minuten prüfen.

<div style="clear:both;"></div>

==Sonoff Switch mit Bewegungsmelder HC-SR501==

[[Datei:sonoff_pir_1.jpg|thumb|left|alt=Bewegungsmelder]]
Basierend auf dem Wall Switch MQTT Sketch von Arends wurde hier ein Sonoff BASIC + PIR HC-SR501 in eine größere Verteilerdose eingebaut, der Sonoff wurde dabei etwas gekürzt. Die Bewegungsmelder sind ab etwa 70 Cent erhältlich.

Der Sketch kann auch den Blink Modus. Damit kann man im Alarmfall z.B. Alle Strahler rings ums Haus blinken lassen.

Mehr dazu kann hier im [https://forum.fhem.de/index.php/topic,63824.0.html Forum]im Diskussionsthread nachgelesen werden.
<div style="clear:both;"></div>

[[Datei:sonoff_pir_2.jpg|thumb|left|alt=Bewegungsmelder]]
Ein Beispiel wir der Bewegungsmelder in der Feuchtraumdose montiert werden kann. Wird der Bewegungsmelder abgesetzt vom Switch montiert, ist darauf zu achten das die Kabel nicht zu lange werden.
<div style="clear:both;"></div>
===Spannungsversorgung des HC-SR501===
[[Datei:sonoff_pir_4.jpg|thumb|left|alt=5V für Bewegungsmelder]]
Der HC-SR501 wird vom Sonoff versorgt, wobei hier die 3,3 V nicht immer ausreichen. Es ist deshalb am HC-SR501 eine Diode zu überbrücken, dann reichen die 3,3V vom Sonoff. Es können aber auch am Sonoff die 5V angezapft werden. Hier im Bild dargestellt wo die 5V angezapft werden können.
<div style="clear:both;"></div>

[[Datei:sonoff_pir_5.jpg|thumb|left|alt=3,3V für Bewegungsmelder]]
Hier eine kleine Übersicht der wichtigsten Teile und deren Platzierung am HC-SR501.
Den PIR kann man auch mit 3,3V betreiben wenn man die Diode am Eingang nach Vcc überbrückt, dann reicht die Spannung für einen reibungslosen Betrieb völlig aus. Dies gilt für den HC-SR501, wird ein anderer PIR verwendet muss man nachschauen ob das auch möglich ist, ansonsten die 5V Variante wählen.

<div style="clear:both;"></div>
===Anpassung des Sketches mit Wall Switch===
Zur Vorbereitung des Sketches sind zunächst einige Einstellungen in der "user_config.h" durchzuführen.

#if MODULE == SONOFF // programming header 1:3.3V 2:rx 3:tx 4:gnd
#define APP_NAME "Sonoff 8266 module"
#define MQTT_GRPTOPIC "sonoffs" // [GroupTopic] MQTT Group topic
/*-------------------------------------------------------------------------------------------*/
#define LED_PIN 13 // GPIO 13 = Green/Blue Led (0 = On, 1 = Off) - Sonoff
#define LED_INVERTED 1 // 0 = (1 = On, 0 = Off), 1 = (0 = On, 1 = Off)
#define REL_PIN 12 // GPIO 12 = Red Led and Relay (0 = Off, 1 = On)
#define KEY_PIN 0 // GPIO 00 = Button
/*-------------------------------------------------------------------------------------------*\
* Wall switch and HC-SR501
\*-------------------------------------------------------------------------------------------*/
#define SWITCH_PIN 14 // GPIO 14 = Standard wall switch to Gnd (Sonoff_TH10A(16A), Sonoff SV)
#define SWITCH_MODE '''PUSHBUTTON_INV''' // [SwitchMode] TOGGLE, FOLLOW, FOLLOW_INV, PUSHBUTTON or PUSHBUTTON_INV (the wall switch state)
'''#define USE_WALL_SWITCH''' // Enable the use of a standard wall switch to control the relay
Wichtig ist dabei die vorangestellten Slahes // bei "#define USE_WALL_SWITCH" zu entfernen auf '''PUSHBUTTON_INV''' zu stellen. Dann kann der Sonoff Switch compiliert und geflasht werden.

===Einbindung des HC-SR501 in Fhem===
# ------------- Sonoff_pir mit Bewegungsmelder ---------------
define Sonoff_pir MQTT_DEVICE
attr Sonoff_pir IODev myBroker
attr Sonoff_pir eventMap ON:on OFF:off
attr Sonoff_pir group Sonoff
attr Sonoff_pir icon hue_filled_br30
attr Sonoff_pir publishSet ON OFF cmnd/sonoff_pir/1/POWER/set
attr Sonoff_pir room MQTT
attr Sonoff_pir stateFormat Licht
attr Sonoff_pir subscribeReading_Licht stat/sonoff_pir/POWER
attr Sonoff_pir subscribeReading_state cmnd/sonoff_pir/1/POWER/set
attr Sonoff_pir webCmd :

Ein Beispiel wie der Sonoff Switch in Fhem eingebunden wird. Wenn im Sketch der Prefix von stat auf tele geändert wurde, ist dies auch hier durchzuführen ( subscribeReading_Licht tele/sonoff_pir/POWER ), ansonsten bleibt es so wie im Beispiel. Getestet wurde dieses Beispiel mit Version 3.1.6. Die Topic sollte auf den Namen "sonoff_pir" eingestellt werden. Bei anderen Namen ist dies entsprechend in Fhem anzupassen.

Mit dem Command '''BUTTONTOPIC = Alarm_SO2''' ( direkt im Webinterface des Sonoff ) wird der Wall Switch GPIO14 vom Sonoff entkoppelt und somit sendet der Bewegungsmelder direkt an FHEM --> Motion_pir MQTT_DEVICE

Es sollte auch unbedingt kontrolliert werden, wie die Ausgabe des Alarmes in der Console erfolgt. Erscheint hier die Meldung "cmnd/Alarm_SO2/POWER = TOGGLE" dann muss mit dem Kommando "'''switchmode 1'''" das Ausgabeformat umgeschaltet werden, erst dann kommt das gewünschte Format "On" und "OFF".

# ------------------ Motion_pir MQTT_DEVICE -----------------
define Motion_pir MQTT_DEVICE
attr Motion_pir IODev myBroker
attr Motion_pir devStateIcon on:on-for-timer off:off
attr Motion_pir eventMap ON:on OFF:off
attr Motion_pir group Sonoff
attr Motion_pir icon people_sensor
attr Motion_pir room MQTT
attr Motion_pir stateFormat Alarm
attr Motion_pir subscribeReading_Alarm cmnd/Alarm_SO2/POWER
Die Motion_pir dient nun zur eigentlichen Einschaltung des Lichtes und sendet das Kommando '''cmnd/Alarm_SO2/POWER''' an den entkopellten GPIO 14 des Switch.

# ------------------ DoIf zur Motion Abfrage -----------------
define di_Sonoff_pir_Alarm DOIF ([Motion_pir:"on"] and [Tag_Nacht:twilight_weather] < 35) (set Sonoff_pir on) DOELSEIF ([Motion_pir:"off"] and [Tag_Nacht:twilight_weather] < 35) (set Sonoff_pir off)
attr di_Sonoff_pir_Alarm comment Abhängig von Helligkeitssensor wird nachts,bei Bewegung das Licht eingeschaltet!
attr di_Sonoff_pir_Alarm group Sonoff
attr di_Sonoff_pir_Alarm room MQTT
Zusätzlich kann nun mit einem '''Doif''' verknüpft werden um das Ganze mit Tag_Nacht:twilight_weather dann in Abhängigkeit der Helligkeit zu schalten. Selbstverständlich kann jede andere Quelle mit einem Helligkeitswert verwendet werden.

===Alarmausgabe über Grouptopic===
# ------------------------ Sonoffs Group ----------------------
define Sonoffs MQTT_DEVICE
attr Sonoffs IODev myBroker
attr Sonoffs eventMap ON:on OFF:off
attr Sonoffs group Sonoff
attr Sonoffs icon hue_filled_br30
attr Sonoffs publishSet ON OFF cmnd/sonoffs/1/POWER/set
attr Sonoffs room MQTT
attr Sonoffs stateFormat state
attr Sonoffs subscribeReading_Licht stat/sonoffs/1/POWER
attr Sonoffs subscribeReading_state cmnd/sonoffs/1/POWER/set
Wer möchte kann auch mit der Group Topic mehrere Switches mit Bewegungsmelder zusammenfassen und alle Lampen im Alarmfall gemeinsam in den Blinkmodus schalten. cmnd/sonoffs ist das Kommando für die Group Topic, sofern diese vom User nicht verändert wurde.
<div style="clear:both;"></div>

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
--[[Benutzer:Reinhart|Reinhart]] ([[Benutzer Diskussion:Reinhart|Diskussion]]) 20:54, 5. Jan. 2017 (CET)

Sonoff

2017-01-15T12:13:06Z

ThomasRamm: /* kleine Ergänzung, hier hat mich das Tutorial abgehängt */

'''sonoff, dieser Artikel beschreibt die Ankopplung der kostengünstigen sonoff Module an FHEM mit ESPEasy oder MQTT.'''
{{Randnotiz|RNTyp=Fehl|RNText=Achtung: Arbeiten mit Netzspannung kann lebensgefährlich sein und darf nur von autorisiertem Fachpersonal durchgeführt werden!}}

Seit einiger Zeit werden von der [https://www.itead.cc/sonoff-wifi-wireless-switch.html Fa. Itead] kostengünstige "sonoff" Produkte angeboten die glücklicherweise den [http://dl.itead.cc/IM151116002/0A-ESP8266_Specifications_v4.1.pdf ESP8266 Chip] On Board haben und somit die ideale Grundlage für [http://www.esp8266.nu/index.php/Main_Page ESPEasy] und für [https://forum.fhem.de/index.php/board,46.0.html Fhem] darstellen.

'''Nützliche Links zum Hersteller:'''

[https://www.itead.cc/blog/user-guide-for-sonoff-slampher User Manual von Itead]

[https://www.itead.cc/wiki/images/6/6b/Sonoff_schmatic.pdf Sonoff Schaltplan]
<div style="clear:both;"></div>

=Hardware=
'''Bitte unbedingt die elektrotechnischen Sicherheitsrichtlinien beachten und einhalten!'''
<div style="clear:both;"></div>
[[Datei:sonoff_sw_15.jpg|thumb|left|alt=Warnung Netzspannung]]
<div style="clear:both;"></div>
'''Achtung: An dem Modul liegt Netzspannung an die lebensgefährlich ist. Es dürfen nur entsprechend ausgebildete Personen dieses Modul in Betrieb nehmen. Zum Umbau und zur Softwareaktualisierung darf keine Netzspannung angeschlossen sein'''

Wie gefährlich das hantieren mit Netzspannung sein kann, wird hier am Beispiel eines [http://mysku.ru/blog/china-stores/45762.html russischen Anwenders] gezeigt, der hat beim Flashen die Netzspannung am Modul gelassen und somit über die Verbindung mit dem Netzteil des Laptop lebensgefährliche Spannung auf die FTDI Schnittstelle gebracht. Das Modul ist dabei abgeraucht!

==Modelle==

===Produktübersichtsliste sonoff===

{| class="wikitable" style="text-align:right"
! Produkt Name !! Beschreibung !! Spannungsversorgung !! Imax !! Pmax !! Frequenz !! Schaltplan !! Link
|-
| Sonoff || Wireless control switch || 90~250V AC || 10A || 2200W || 2.4Ghz || [http://wiki.iteadstudio.com/Sonoff Plan] || [https://www.itead.cc/smart-home/sonoff-wifi-wireless-switch.html Link]
|-
| Sonoff RF || 433 RF remote || 90~250V AC || 10A || 2200W || 2.4Ghz || [http://wiki.iteadstudio.com/Sonoff_RF Plan] || [https://www.itead.cc/smart-home/im151116003.html Link]
|-
| Sonoff SV || Low voltage Input || 5~24V DC || 10A || 240W DC || 2.4Ghz || [http://wiki.iteadstudio.com/Sonoff_SV Plan] || [https://www.itead.cc/smart-home/sonoff-sv.html Link]
|-
| Sonoff TH10/TH16 || Monitor and set Temp.&Hum. || 90~250V AC || 10A/16A || 2200W(10A)/3500W(16A) || 2.4Ghz || [http://wiki.iteadstudio.com/Sonoff_TH_10/16 Plan] || [https://www.itead.cc/smart-home/sonoff-th.html Link]
|-
| Sonoff Dual || Remote control 2 devices || 90~250V AC || 16A || 3500W || 2.4Ghz || [https://www.itead.cc/wiki/Sonoff_Dual Plan] || [https://www.itead.cc/sonoff-dual.html Link]
|-
| Sonoff Pow || Report power &power usage || 90~250V AC || 16A || 3500W || 2.4Ghz || [https://www.itead.cc/wiki/Sonoff_Pow Plan] || [https://www.itead.cc/sonoff-pow.html Link]
|-
| Sonoff LED || WiFi Control Dimming LED || 180~265V AC || 0.3-0.6A || 42W || 2.4Ghz || kein || [https://www.itead.cc/sonoff-led.html Link]
|-
| Sonoff Touch || WiFi wall touch switch || 90~250V AC || 2A || 400W || 2.4Ghz || kein || [https://www.itead.cc/sonoff-touch.html Link]
|-
| Slampher || Wireless control light holder || 90~250V AC || 2A || 200W || 2.4Ghz || [http://wiki.iteadstudio.com/Slampher Plan] || [https://www.itead.cc/smart-home/slampher-wifi-wireless-light-holder.html Link]
|-
| S20 Smart Socket || Smart socket || 90~250V AC || 10A || 2000W || 2.4Ghz || kein || [https://www.itead.cc/smart-home/smart-socket-eu.html EU-Stecker]
|-
| iFan || Smart fan || 185~264V AC ||﹤1A || 60W || 2.4Ghz || kein || [https://www.itead.cc/smart-home/smart-socket-eu.html EU-Stecker]
|-
| Motor/Pump Control Switch || clockwise/anticlockwise running || 5V/7~32V DC || 10A || 50~320W || 2.4Ghz || kein || [https://www.itead.cc/smart-home/motor-reversing-wifi-wireless-switch.html Link]
|-
| 1 Chnl Inching/self-locking Switch || Access control || 5V/12V DC || 10A || 50/120W || 2.4Ghz || kein || [https://www.itead.cc/smart-home/inching-self-locking-wifi-wireless-switch.html Link]
|-
| 4 Chnl Inching/self-locking/inter-locking Switch || Access control, rolling door control || 5V/5~32V DC/90~250V AC || 10A || 50~320W/2500W || 2.4Ghz || kein || [https://www.itead.cc/ifan.html Link]
|-
|   || || || || || || ||
|-
|}

Eine Übersichtliste der verschiedenen Produkte mit technischen Kurzangaben.
<div style="clear:both;"></div>''

===Model: IM151116002: Erstes Modell===
[https://www.itead.cc/sonoff-wifi-wireless-switch.html Sonoff WiFi Wireless Smart Switch for MQTT COAP Smart Home]
[[Datei:sonoff_sw_0.jpg|thumb|left|alt=sonoff Switch]]
<div style="clear:both;"></div>
Das sonoff Modul ist in einem zweckmäßigen und gefälligem Gehäuse verbaut!

====Platine====
[[Datei:sonoff_sw_1.jpg|thumb|left|alt=sonoff Switch von vorne]]

Die Platine ist sehr übersichtlich aufgebaut und der Hersteller hat auch alle Vorbereitungen zum Flashen einer alternativen Software vorgesehen (über serielle Schnittstelle via FTDI-Modul). Mit einer alternativen Software wie ESPEasy ist eine direkte Ankopplung des '''sonoff''' an FHEM somit ein leicht durchführbarer Vorgang.
<div style="clear:both;"></div>

[[Datei:sonoff_sw_3.jpg|thumb|left|alt=sonoff Switch von hinten]]
Die stromführenden Leitungen wurden mit Lötzinn vom Hersteller verstärkt um die angegebenen Stromstärken mit geringer Hitzeentwicklung zu transportieren.

'''Achtung: Bitte vor den Arbeiten kontrollieren, das an der Platine keine Netzspannung angeschlossen ist, LEBENSGEFAHR!'''
<div style="clear:both;"></div>''

<div style="clear:both;"></div>''

===Model: IM160712005: TH 10A/16A ===
[https://www.itead.cc/sonoff-th.html Sonoff TH 10A/16A WiFi Smart Switch]

====TH10 / TH16 weitere GPIO zugänglich machen====
[[Datei:Sonoff_TH_10A-16A_kleiner.jpg|thumb|left|alt=TH10 / TH16 weitere GPIO zugänglich machen]]
Der Hersteller hat zwar schon Platine für eine weitere Stiftleiste vorbereitet, jedoch muss diese noch bestückt werden. Die nicht beschalteten Stifte können dann genutzt werden um die "verdeckten" GPIO zugänglich zu machen. Die Verdrahtung kann dem Bild entnommen werden.<br>
'''Achtung: Bitte vor den Arbeiten kontrollieren, das an der Platine keine Netzspannung angeschlossen ist, LEBENSGEFAHR!'''
<div style="clear:both;"></div>''

<div style="clear:both;"></div>''

===Model: IM160811001: Sonoff Dual ===
[https://www.itead.cc/sonoff-dual.html Sonoff Dual WiFi Wireless Smart Swtich]

<div style="clear:both;"></div>''

<div style="clear:both;"></div>''

===Model: IM160810001: Sonoff Pow ===
[https://www.itead.cc/sonoff-pow.html Sonoff POW WiFi Switch with Power Consumption Measurement]
[[Datei:sonoff_sw_30.jpg|thumb|left|alt=SONOFF POW]]Ein sehr interessantes und kostengünstiges Modul zur Messung der aktuellen Leistung. Das Modul kann via MQTT in Fhem angebunden werden.

Ein Beispiel zur Einbindung ist [http://www.fhemwiki.de/wiki/Sonoff#Sonoff_POW_einrichten hier unten] im Wiki beschrieben.

<div style="clear:both;"></div>
===Model: weitere Modelle===
[https://www.itead.cc/search/result/?cat=&q=sonoff Sonoff Weitere Modelle finden sich auf der Homepage des Hersstellers]

==Vorbereitungen zum Flashen==
[[Datei:sonoff_sw_2.jpg|thumb|left|alt=serielle Schnittstelle]]

Hier auf der Platine sind die benötigten Signale für ein FTDI Modul schon vorhanden. Der quadratische Pin gleich über dem Taster ist die Spannungsversorgung zum Flashen vom FDTI von 3.3V Es muss daher unbedingt ein FTDI Modul genommen werden, dass nicht nur einen Jumper für 3.3V besitzt sondern auch die Spannung auf 3.3V herab setzt. Ist dies nicht der Fall, läuft man Gefahr das Modul unbrauchbar zu machen. Es ist daher zu empfehlen einen Spannungsteiler mit 2 Widerständen oder einen Pegelwandler zwischenschalten.
<div style="clear:both;"></div>

==Signale der Schnittstelle==
von oben nach unten auf der Steckerleiste des sonoff U4 (Model: IM151116002).

Pin5 = vorbereitet für GPIO
Pin4 = Masse
Pin3 = TxD
Pin2 = RxD
Pin1 = 3.3V

Siehe dazu auch den [https://forum.fhem.de/index.php/topic,55036.0.html Link aus dem Forum]:
<div style="clear:both;"></div>

==Platine mit Stiftleiste bestücken==
[[Datei:sonoff_sw_4.jpg|thumb|left|alt=Platine mit Stiftleiste bestücken]]
Der Hersteller hat zwar schon die Platine vorbereitet, jedoch muss sie noch mit einer Stiftleiste bestückt werden um das FTDI Modul bequem verbinden zu können. Nachdem einmal ESPEasy geflasht worden ist, kann es in Zukunft via WEB (OTA) geflasht werden und die Stiftleiste ist dann nicht mehr erforderlich. Aufgrund der geringen Kosten fällt dies jedoch nicht ins Gewicht.<br>
Für die Module TH10/TH16 sind die Lötpunkte für die Stiftleiste schon beschriftet. Die Stiftleiste selber muss allerdings auch nachgerüstet werden.
<div style="clear:both;"></div>''
'''''Achtung''': Bitte vor den Arbeiten kontrollieren, das an der Platine keine Netzspannung angeschlossen ist, LEBENSGEFAHR!
<div style="clear:both;"></div>''

=Software=
==ESPEasy flashen==
[[Datei:sonoff_sw_6.jpg|thumb|left|alt=sonoff mit angestecktem FDTI Adapter]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier geht es ausschließlich um die Software ESPEasy an den sonoff Modulen! }}
Die Spannungsversorgung des sonoff Moduls wird hier vom FTDI Konverter mit 3.3V über die Verbindungskabel zum Pfostenstecker durchgeführt.

Der FTDI Adapter wird dann mit der USB Schnittstelle mit dem Computer verbunden.

Zum compilieren wird in der Arduino Umgebung auch die ArduinoJson library 5.6.4+ benötigt. Eine genaue Anleitung kann [https://forum.fhem.de/index.php/topic,55728.msg473220.html#msg473220 hier] nachgelesen werden. Im Gegensatz zu Arends Sketch für die MQTT Umgebung genügt hier die Arduino IDE 1.6.9. Für die Sketches von Arends empfiehlt sich Arduino IDE >=1.6.12

<div style="clear:both;"></div>

===mit Arduino compilieren===
[[Datei:sonoff_sw_10.jpg|thumb|left|alt=Einstellung Arduino IDE]]
Wer selber mit der Arduino IDE compilieren will bitte folgende Einstellungen beachten. Die anschließenden Arbeiten sind dann gleich wie bei Abschnitt '''fertige Binary'''.

Unbedingt die neueste [https://github.com/bblanchon/ArduinoJson Arduino Json Library] benutzen (siehe oben)! Es gibt zwar keine Compilerfehler, aber es kommt anschließend zu Fehlfunktionen in der ESP Bridge!

<div style="clear:both;"></div>
Generic ESP8266 Module
Flash Mode: QIO
Flash Frequency: 40 MHz
CPU Frequency: 80 MHz
Flash Size: 1M (64K SPIFFS)
Debug Port: disabled
Debug Level: none
Reset Mode: ck
Upload Speed: 115200
<div style="clear:both;"></div>
===fertige Binary flashen===
[[Datei:sonoff_sw_7.jpg|thumb|left|alt=NodeMCU Firmware Flasher]]
Es empfiehlt sich eine fertige Binary von ESPEasy aufzuspielen. In diesem Wiki wurde R140 verwendet.

Siehe dazu auch den [http://www.esp8266.nu/index.php/Main_Page Link von ESPEasy] und das [https://learn.adafruit.com/building-and-running-micropython-on-the-esp8266/flash-firmware Handbuch] für den Flasher.

In manchen Versionen von ESPEasy (zB.R120) ist auch ein Flasher beigelegt, welcher zwar keine grafische Oberfläche hat aber hervorragend funktioniert. Wenn andere versagen, geht es mit diesem Flasher immer noch, einfach probieren!

<div style="clear:both;"></div>
Netzspannung darf 'NICHT' angeschlossen sein!!!
Taster am Sonoff gedrückt halten
FTDI Adapter verbinden
Taster am Sonoff los lassen
Sketch übertragen
Sonoff vom FTDI trennen
<div style="clear:both;"></div>
Wenn einmal die Firmware auf das sonoff Modul geflasht worden ist, kann in Zukunft ESPEasy direkt unter Tools via HTTP dies durchführen. Es muss dazu kein FTDI Konverter mehr verwendet werden.

==ESPEasy==
[[Datei:sonoff_sw_11.jpg|thumb|left|alt=ESPEasy Devices]]
Wenn das Modul fertig geflasht ist und die Verbindung zum Modul hergestellt ist, können die Einstellungen in ESPEasy durchgeführt werden.
Dazu am Webinterface anmelden und zunächst die zwei Devices definieren.

Der Hersteller hat für das '''Relaise GPIO 12''' und für die '''grüne Led GPIO 13''' vorgesehen. Der '''Taster ist an GPIO 0''' angeschlossen.
<div style="clear:both;"></div>

===Device Schalter===
[[Datei:sonoff_sw_12.jpg|thumb|left|alt=Device Relais]]
Bei den Devices sollten die hier dargestellte Einstellungen beachtet werden. Der Switch (PUMP) sollte auf Input gestellt werden, sodass die anschließenden und benötigten Rules aktiviert werden können.

Da beide Devicenamen gleich benannt wurden (PUMP) wird in Fhem nur ein Device angelegt! Die dazugehörenden Valuenames sind unterschiedlich (Relay, Key).

<div style="clear:both;"></div>

===Device Taster===
[[Datei:sonoff_sw_13.jpg|thumb|left|alt=Device Key]]
Der Taste muss natürlich nur konfiguriert werden, wenn auch händisch am Modul geschaltet werden soll. Wird dies nicht benötigt, können auch die Rules geändert bzw. angepasst werden. Doch alleine zu Testzwecken ist es eine nützliche Sache.
<div style="clear:both;"></div>

===Rules===
[[Datei:sonoff_sw_14.jpg|thumb|left|alt=Rules]]
Da das sonoff Modul auch einen eingebauten Taster hat und somit auch lokal bedient werden kann, sollte man zunächst unter '''Tools / Advanced das Häckchen Rules''' aktivieren, erst dann wird der Tab sichtbar und es können Rules erstellt werden.
<div style="clear:both;"></div>

on PUMP#Key do
if [PUMP#Relay]=1
gpio,12,0
else
gpio,12,1
endif
endon
on PUMP#Relay do
if [PUMP#Relay]=1
gpio,13,0
else
gpio,13,1
endif
endon
Diese Rules ermöglichen, das bei lokaler Bedienung durch den Taster auch die '''Led''' richtig geschaltet wird.
Mit 'on PUMP#Key do' wird geprüft ob die Taste gedrückt ist und schaltet dann entsprechend die Led. Mit den Rules können auch Timer oder sonstige Spielereien realisiert werden. Siehe dazu das [http://www.esp8266.nu/index.php/Tutorial_Rules Tutorial] von ESPeasy.
<div style="clear:both;"></div>

==ESPEasy in Fhem einrichten==
[[Datei:sonoff_sw_9.jpg|thumb|left|alt=Fhem Konfiguration]]
Dies ist eine einfache Darstellung wie Fhem automatisch den Device erstellt.

Damit Fhem mit ESPEasy und dem sonoff Modul kommunizieren kann, muss in der fhem.cfg vorerst nur die espBridge mit dem hier dargestellten Eintrag aktiviert werden.
<div style="clear:both;"></div>
define espBridge ESPEasy bridge 8383
Dies ist eigentlich die einzige Zeile die in fhem.cfg angelegt werden muss. Die restliche Konfiguration wird von Fhem automatisch generiert.

##########################################
### ESPEASY ####
##########################################

define ESPEasy_sonoff_1_PUMP ESPEasy 10.0.0.37 80 espBridge sonoff_1_PUMP
attr ESPEasy_sonoff_1_PUMP IODev espBridge
attr ESPEasy_sonoff_1_PUMP devStateIcon on:rc_GREEN:off off:rc_RED:on absent:rc_BLUE:off gpio:rc_YELLOW:off
attr ESPEasy_sonoff_1_PUMP eventMap /gpio 12 on:on/gpio 12 off:off/gpio 12 gpio:off/gpio 12 output:off/
attr ESPEasy_sonoff_1_PUMP group ESPEasy Device
attr ESPEasy_sonoff_1_PUMP icon hue_filled_outlet
attr ESPEasy_sonoff_1_PUMP room ESPEasy
attr ESPEasy_sonoff_1_PUMP setState 0
attr ESPEasy_sonoff_1_PUMP stateFormat {ReadingsVal($name,"presence","") eq "absent" ? "absent" : ReadingsVal($name,"Relay","")}
attr ESPEasy_sonoff_1_PUMP webCmd :

hier ein Beispiel wie es auch manuell leicht modifiziert werden kann.

[[Datei:sonoff_sw_8.jpg|thumb|left|alt=sonoff Readings]]

Die Readings werden durch die Bridge (Modul ESPEasy) automatisch angelegt.

Es besteht hier noch genug Spielraum um zB. auch noch Temperatursensoren an das Modul anzuschließen und ebenfalls in Fhem darzustellen.
<div style="clear:both;"></div>

==MQTT Server einrichten==
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier geht es ausschließlich um den Sketch von Arends und MQTT an den sonoff Modulen! }}
Es bleibt jedem Anwender die freie Wahl ob die Kommunikation über die ESPEasy-Bridge oder MQTT erfolgen soll. MQTT ist bei der Einrichtung etwas komplexer, da hier auch auf dem Server der Broker installiert werden muss.

Im wesentlichen beschränkt sich die Installation eines MQTT Servers aber auf wenige Arbeitsschritte und ist wie folgt beschrieben durchzuführen. Wer schon einen '''mosquitto''' auf dem Server installiert hat, kann diesen Schritt überspringen.

Dieses Kapitel ist insofern interessant, da mit dem Sketch von Theo Arends auch die Einbindung der neuen sonoff Pow Module bereits möglich ist.

# aus dem mosquitto Repo installieren:
wget http://repo.mosquitto.org/debian/mosquitto-repo.gpg.key
sudo apt-key add mosquitto-repo.gpg.key
cd /etc/apt/sources.list.d/
sudo wget http://repo.mosquitto.org/debian/mosquitto-wheezy.list
# oder für jessie
sudo wget http://repo.mosquitto.org/debian/mosquitto-jessie.list
sudo apt-get update
# mosquitto installieren
sudo apt-get install mosquitto

# MQTT Server Test
sudo service mosquitto status

# Start / Stop des Servers
sudo service mosquitto stop
sudo service mosquitto start

# Perl Version ausgeben
perl -v
# Perl MQTT Module nachinstallieren (läuft ein paar Minuten)
sudo cpan install Net::MQTT:Simple
sudo cpan install Net::MQTT:Constants

===Software Arends Sketch===
[[Datei:sonoff_sw_22.jpg|thumb|left|alt=Arends Menü]]

Ebenso bietet sich die Möglichkeit eine andere alternative Software auf den unterschiedlichen Sonoff Modellen aufzuspielen.
Speziell für diese Module zugeschnittene Software stammt vom Autor Theo Arends. Alle hier gezeigten Bildschirmfotos und Beispiele beziehen sich auf Basis der Version 2.0.11 (Stand 11.11.2016).

'''Wichtig:''' erst '''ab Version 2.0.9''' sind die Berechnungsfehler und die Referenzfrequenzen für die Umrechnung der Leistungsdaten gefixt worden! Es wird daher angeraten immer die aktuellste Version zu verwenden.

'''Links zu Theo Arend Github'''

[https://github.com/arendst/Sonoff-MQTT-OTA-Arduino Download MQTT Sketch]

[https://github.com/arendst/Sonoff-MQTT-OTA-Arduino Arend GitHub]

[https://github.com/arendst/Sonoff-MQTT-OTA-Arduino/wiki Wiki]

'''Achtung:''' sollten Probleme mit dem ersten Login im Webinterface auftreten, hat der Autor vorgesorgt und mit speziellem wiederholten Tastendruck können verschiedene Modi aufgerufen werden: zB:

'''3 x Taste kurz drücken''' und eine Smartconfig wird gestartet und die '''SSID''' und das '''Passwort''' kann über diese [https://play.google.com/store/apps/details?id=com.cmmakerclub.iot.esptouch Android App] eingegeben werden.

'''4 x Taste kurz drücken''' und man bringt den Device in den '''Access Point Mode''' mit der IP-Adresse '''192.168.4.1'''.

Bis zu 7 verschiedene Modi sind möglich, mehr dazu in Arends Wiki.

[https://github.com/arendst/Sonoff-MQTT-OTA-Arduino/wiki/Button-usage Link zum Wiki Arends, Button]
<div style="clear:both;"></div>

[[Datei:sonoff_bv_01.jpg|thumb|left|alt=Arduino Boardverwalter]]
In der Arduino IDE unter Datei / Voreinstellungen im Feld "Zusätzliche Boardverwalter-URLs:" den Link: http://arduino.esp8266.com/stable/package_esp8266com_index.json einfügen.

Dann unter '''Werkzeuge / Board / Boardverwalter''' ganz am Ende der Liste die Librarys für "esp8266 by ESP8266 Community" die letzte Version 2.3.0 installieren. [https://forum.fhem.de/index.php/topic,46205.msg534707.html#msg534707 Link zum Board].

Das gesamte sonoff Verzeichnis aus [https://github.com/arendst/Sonoff-MQTT-OTA-Arduino/archive/master.zip Arendts Sketch] entpacken (ist wie hier verlinkt ein Zipfile) und dann aus diesem Verzeichnis die sonoff.ino öffnen. Es können dann alle zu dem Sketch zugehörigen Dateien angesehen/editiert werden.

<div style="clear:both;"></div>
Anschließend muss noch die Datei '''user_config.h''' (im Unterverzeichnis "sonoff") editiert werden. Die Abschnitte

// Wifi
// Syslog
// Ota
// MQTT

müssen mit der eigenen "'''Ip-Adresse-Server'''", "'''SSID'''" und "'''password'''" angepasst werden, das erleichtert den ersten Connect mit dem Modul. Seit der Version 2.1.2 können die WIFI Einstellungen 2-fach angegeben werden, somit wechselt das Device automatisch auf den 2. Wifi Hotspot wenn der erste nicht erreicht wird.

#define STA_SSID "SSID" // Wifi SSID
#define STA_PASS "password" // Wifi password
#define WIFI_HOSTNAME "%s-%04d" // Expands to <MQTT_TOPIC>-<last 4 decimal chars of MAC address>
#define WIFI_CONFIG_TOOL WIFI_WPSCONFIG // Default tool if wifi fails to connect (WIFI_SMARTCONFIG, WIFI_MANAGER or WIFI_WPSCONFIG)

// Syslog
#define SYS_LOG_HOST "Ip-Adresse-Server"
#define SYS_LOG_PORT 514
#define SYS_LOG_LEVEL LOG_LEVEL_NONE
#define SERIAL_LOG_LEVEL LOG_LEVEL_INFO
#define WEB_LOG_LEVEL LOG_LEVEL_INFO

// Ota
#if (ARDUINO >= 168)
#define OTA_URL "http://Ip-Adresse-Server:80/api/arduino/" PROJECT ".ino.bin"
#else
#define OTA_URL "http://Ip-Adresse-Server:80/api/arduino/" PROJECT ".cpp.bin"
#endif

// MQTT
#define MQTT_HOST "Ip-Adresse-Server"
#define MQTT_PORT 1883

'''Wichtig:''' Bei Verwendung des '''sonoff_POW''' muss dies ebenfalls in der user_config.h eingestellt werden, also das "SONOFF" sperren und das "'''SONOFF_POW'''" aktivieren (// setzen/entfernen). Wir dies nicht durchgeführt, werden auch keine Leistungsdaten via MQTT übertragen!!!
Ebenso muss in (%userprofile%\Documents\Arduino\libraries\pubsubclient\src\PubSubClient.h) die Max Packet Size auf 400 erhöht werden!

#define MQTT_MAX_PACKET_SIZE 400
#define MQTT_KEEPALIVE 120
Anpassung der max. Packet Size auf 400 und das Keepalive auf 120

// Enable only one out of three MODULE defines below
//#define MODULE SONOFF // Sonoff, Sonoff SV, Sonoff Dual, Sonoff TH 10A/16A, S20 Smart Socket, 4 Channel
#define MODULE SONOFF_POW // Sonoff Pow

Im Anschluß wird der Sketch mit der Arduino IDE (getestet mit 1.6.12) compiliert und die Binary dann exportiert (Sketch / Kompilierte Binärdatei exportieren). Die erzeugte .bin Datei dann mit dem Tool "ESP8266Flasher.exe" flashen, so wie auch bei ESPEasy. Wer nicht compilieren will, kann auch im Unterverzeichnis ./api/arduino/ die fertige Binary ( sonoff.ino ) benutzen, aber dann ohne Voreinstellung der lokalen IPs.
<div style="clear:both;"></div>

===MQTT testen===
[[Datei:sonoff_sw_20.jpg|thumb|left|alt=Arends Menü]]

Nach erfolgtem Flash des Modules kann das Webinterface zum ersten Mal aufgerufen werden.

Es bieten sich hier mehrere Möglichkeiten die die weitere Einrichtung des Moduls unterstützen. Einfach die Menüpunkte durchprobieren, sie erklären sich von selbst. Für erste Tests empfiehlt sich die lokale Konsole um die Ereignisse aus Sicht des Modules mit verfolgen zu können. Alles was hier gesendet wird, sollte ebenfalls am Server mitgeloggt werden können. Wenn bis hierher alles funktioniert, kann dann mir der Konfiguration in Fhem beginnen.
<div style="clear:both;"></div>

Am Server jetzt eine Konsole öffnen und folgende Topic (alle) einstellen.

mosquitto_sub -d -v -t \#
Mit dieser Einstellung werden alle Topics geloggt!

pi@raspberry ~ $ mosquitto_sub -d -v -t \#
Received CONNACK
Received SUBACK
Subscribed (mid: 1): 0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/36/temperature', ... (5 bytes))
/sonoff/36/temperature 14.06
Received PUBLISH (d0, q0, r1, m0, '/sonoff/35/Count', ... (3 bytes))
/sonoff/35/Count 0.0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/35/Total', ... (3 bytes))
/sonoff/35/Total 0.0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/35/Time', ... (1 bytes))
/sonoff/35/Time 0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/temperature', ... (5 bytes))
/sonoff/temperature 14.00
Received PUBLISH (d0, q0, r1, m0, '/sonoff/Count', ... (3 bytes))
/sonoff/Count 0.0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/Total', ... (3 bytes))
/sonoff/Total 0.0
Received PUBLISH (d0, q0, r1, m0, '/sonoff/Time', ... (1 bytes))
/sonoff/Time 0
Received PUBLISH (d0, q0, r0, m0, 'stat/sonoff/1/POWER', ... (2 bytes))
stat/sonoff/1/POWER ON
Received PUBLISH (d0, q0, r0, m0, 'stat/sonoff/1/POWER', ... (3 bytes))
stat/sonoff/1/POWER OFF

Interessant sind für uns nun diese Einträge "stat/sonoff/1/POWER ON" , dazu am Taster des sonoff manuell umschalten. Dies entspricht genau der Syntax wie sie im Anschluss in Fhem dann zu verwenden ist.

Mit diesen Einstellungen können dann entweder nach Telemetriedaten oder nach Statusmeldungen gefiltert werden. Dies ist jedoch nur notwendig wenn bereits andere MQTT Devices am Broker hängen und es sonst zu unübersichtlich wird.
mosquitto_sub -h localhost -t tele/sonoff/# = Telemetriedaten
mosquitto_sub -h localhost -t stat/sonoff/# = Statusmeldungen
<div style="clear:both;"></div>

[[Datei:sonoff_sw_21.jpg|thumb|left|alt=Arends Log]]
Sehr nützlich das lokale Log zur Fehlersuche und Inbetriebnahme.

<div style="clear:both;"></div>
Als Besonderheit benutzt der Autor zum Senden und Empfangen unterschiedliche Syntax und unterscheidet dies durch vorangestellte Prefixe vor der eigentlichen Topic.
#define SUB_PREFIX "cmnd" Sonoff devices subscribe to:- cmnd/MQTT_TOPIC and cmnd/MQTT_GRPTOPIC
#define PUB_PREFIX "stat" Sonoff devices publish to:- stat/MQTT_TOPIC
#define PUB_PREFIX2 "tele" Sonoff devices publish telemetry data to:- tele/MQTT_TOPIC/UPTIME, POWER/LIGHT and TIME
Bitte dies unbedingt in der Fhem Konfiguration dann beachten!
<div style="clear:both;"></div>

==MQTT in Fhem einrichten==
[[Datei:sonoff_sw_24.jpg|thumb|left|alt=Fhem sonoff Schalter]]
Dieser einfache Schalter kommuniziert bidirektional mit dem sonoff Device.
<div style="clear:both;"></div>

[[Datei:sonoff_sw_25.jpg|thumb|left|alt=Fhem sonoff Schalter]]
Die Readings in diesem verwendeten Beispiel zeigen sich wie in Fhem gewohnt.
<div style="clear:both;"></div>

Die Einrichtung in Fhem wird von den Modulen 00_MQTT.pm, 10_MQTT_BRIDGE und 10_MQTT_DEVICE.pm unterstützt.

[https://forum.fhem.de/index.php?topic=27532.0 Link zum Forum: MQTT Fhem Einrichtung]

### 1. Broker anlegen ###
define myBroker MQTT 10.0.0.5:1883

### 2. Fhem Device mit MQTT verbinden ###
define Sonoff_Switch MQTT_DEVICE
attr Sonoff_Switch IODev myBroker
attr Sonoff_Switch eventMap ON:on OFF:off
attr Sonoff_Switch icon hue_filled_br30
attr Sonoff_Switch publishSet ON OFF cmnd/sonoff/1/POWER/set
attr Sonoff_Switch room MQTT
attr Sonoff_Switch stateFormat Licht
attr Sonoff_Switch subscribeReading_Licht stat/sonoff/POWER
# oder mit tele, je nachdem was in der user_config.h eingestellt wurde!!!
#attr Sonoff_Switch subscribeReading_Licht tele/sonoff/POWER
attr Sonoff_Switch subscribeReading_state cmnd/sonoff/1/POWER/set
attr Sonoff_Switch webCmd ON:OFF
Der hier dargestellte Beispielcode realisiert die Kommunikation zwischen Fhem und dem sonoff Modul via MQTT Broker. Zu beachten ist hier, dass '''subscribeReading_Licht''' und '''subscribeReading_state''' unterschiedliche Syntax des Topic Strings haben!

==Sonoff POW einrichten==
[[Datei:sonoff_sw_31.jpg|thumb|left|alt=Sonoff POW]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier geht es ausschließlich um das Modul Sonoff POW!}}
Das Modul kommt in gewohnter Itead Qualität und eine derart kostengünstige Energiemessung wird bei Smart Home Anwendern gerne eingesetzt. Die Originalsoftware habe ich nicht einmal getestet, da damit eine Anbindung an Fhem leider nicht möglich ist.

Ebenso möchte kaum jemand an eine nicht dokumentierte chinesische Cloud die Steuerbefehle seiner Schalter senden.
<div style="clear:both;"></div>
[[Datei:sonoff_sw_33.jpg|thumb|left|alt=Sonoff POW]]
Bitte auf keinen Fall das Modul während der Arbeiten an die Netzspannung anschießen. Zum Flashen genügt (und nur diese) die Versorgungspannung des USB-TTL Konverters. Wie auf dem Foto gut erkennbar, wurde dieses Modul ohne einlöten einer Pfostensteckerleiste geflasht. Die Steckverbindung wird einfach in die Lötaugen gesteckt und mit einem Gummiring fixiert, da ja spätere Flashvorgänge im Webif des Models funktionieren und so die Arbeit eingespart werden kann. Es steht jedoch nichts im Wege die Pfostensteckerleiste einzulöten.
<div style="clear:both;"></div>
Die Anschlüsse am Modul sind wie folgt belegt.
o GND
o TxD
o RxD
o VDD

Für den Flashvorgang gelten die selben Regeln wie schon beim sonoff Switch oben erwähnt (3,3V!).
<div style="clear:both;"></div>

===Sonoff POW Software===
[[Datei:sonoff_sw_35.jpg|thumb|left|alt=Sonoff POW FHEM]]
Als Software steht im Augenblick nur der Sketch von Arends zur Verfügung, liefert aber alles was das Herz begehrt und ist ist einfach zu handhaben. Hier eine eine einfache Darstellung mit der aktuellen Leistung und dem Tagesverbrauch. Zusätzlich besteht auch noch die Möglichkeit den angeschlossenen Verbraucher Ein- oder Auszuschalten. Getestet wurde hier mit der Version 2.06, 2.07 und 2.019a von Arends.
<div style="clear:both;"></div>
[[Datei:sonoff_pow_02.jpg|thumb|left|alt=Sonoff POW Webif]]
Seit Version 2.0.19a ist auch die Leistungsanzeige im WEBIF wie im Bild links integriert. Auch der Energieverbrauch des Vortages wird mit angezeigt. Alle hier angezeigten Daten werden auch zyklisch im MQTT String an FHEM übergeben.

Zusätzlich kann im Sketch auch das Feature "'''Power_Limit'''" aktiviert werden ( #define FEATURE_POWER_LIMIT in der sonoff.ino). Wenn dies gewünscht ist, dann vor dem compilieren die beiden // entfernen. Mit dem Power_Limit wird eine zusätzliche Nachricht erzeugt, wenn ein bestimmter einstellbarer Grenzwert über- oder unterschritten wird.

Es lassen sich dadurch Meldungen wie "Waschmaschine fertig" oder ähnliches ohne weitere Schwellwert Überwachungen in FHEM ableiten. Die Meldungen kommen in MQTT mit "'''tele/sonoff/POWER_LOW ON'''" bzw. "'''tele/sonoff/POWER_LOW OFF'''".
<div style="clear:both;"></div>
Bevor der Sketch compiliert wird, müssen neben den IP-Einstellungen noch in der user_config.h auch andere Einstellungen vorgenommen werden.

#define MODULE SONOFF_POW // Hardware module type (SONOFF, SONOFF_POW or ELECTRO_DRAGON)
#define PROJECT "sonoffpow" // PROJECT is used as the default topic delimiter and OTA file name // As an IDE restriction it needs to be the same as the main .ino file

Der Typ des Modules muss von "SONOFF" auf "'''SONOFF_Pow'''" geändert werden,. damit die Software weiß mit welchem Modul es zu tun hat und kann dann die entsprechenden Berechnungen durchführen. Die Leistungsdaten kommen ja in Form einer Frequenz aus dem Baustein und müssen im Sketch (xsns_hlw8102.ino) umgerechnet werden.

#elif MODULE == SONOFF_POW // programming header 1:3.3V 2:rx 3:tx 4:gnd
#define APP_NAME "Sonoff Pow module"
#define USE_POWERMONITOR // Enable Power Monitoring
#define USE_POWERCALIBRATION // Enable setting Calibration parameters by user commands

Bei Einsatz des POW Modules kann die externe Kalibrierung aktiviert werden.

Definition aus der power.ino (2.0.9) für die korrekte Umrechnung der gelieferten Frequenzen für die Leistungsdaten.
#define HLW_PREF 10000 // 1000.0W
#define HLW_UREF 2200 // 220.0V
#define HLW_IREF 4545 // 4.545A

#define HLW_PREF_PULSE 4975 // 4975us = 201Hz = 1000W
#define HLW_UREF_PULSE 1666 // 1666us = 600Hz = 220V
#define HLW_IREF_PULSE 1666 // 1666us = 600Hz = 4.545A

<div style="clear:both;"></div>
[[Datei:sonoff_sw_36.jpg|thumb|left|alt=Sonoff POW Attribute]]
Dieses Bild zeigt die Attribute die vom Modul via MQTT an FHEM geliefert werden.
<div style="clear:both;"></div>
aktuell gelieferte Readings (Mqtt Strings) vom Sketch nach unten dargestellter Definition in Fhem.
tele/sonoffpow/TODAY_ENERGY
tele/sonoffpow/PERIOD_ENERGY
tele/sonoffpow/POWER_FACTOR
tele/sonoffpow/CURRENT_POWER
tele/sonoffpow/VOLTAGE
tele/sonoffpow/CURRENT

Hier ein Mittschnitt des Datenverkehrs zum Broker zwecks Kontrolle der korrekten Funktion der Module und der Software.
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/RSSI', ... (2 bytes))
tele/sonoff/RSSI 82
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/TEMPERATURE', ... (3 bytes))
tele/sonoff/TEMPERATURE 1.9
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/HUMIDITY', ... (4 bytes))
tele/sonoff/HUMIDITY 97.9
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/POWER', ... (3 bytes))
tele/sonoff/POWER OFF
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoff/TIME', ... (19 bytes))
tele/sonoff/TIME 2016-11-12T10:36:13
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/UPTIME', ... (1 bytes))
tele/sonoffpow/UPTIME 1
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/RSSI', ... (2 bytes))
tele/sonoffpow/RSSI 34
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/TODAY_ENERGY', ... (5 bytes))
tele/sonoffpow/TODAY_ENERGY 0.083
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/PERIOD_ENERGY', ... (1 bytes))
tele/sonoffpow/PERIOD_ENERGY 8
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/CURRENT_POWER', ... (2 bytes))
tele/sonoffpow/CURRENT_POWER 97
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/POWER_FACTOR', ... (4 bytes))
tele/sonoffpow/POWER_FACTOR 1.00
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/VOLTAGE', ... (3 bytes))
tele/sonoffpow/VOLTAGE 225
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/CURRENT', ... (5 bytes))
tele/sonoffpow/CURRENT 0.426
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/POWER', ... (2 bytes))
tele/sonoffpow/POWER ON
Received PUBLISH (d0, q0, r0, m0, 'tele/sonoffpow/TIME', ... (19 bytes))
tele/sonoffpow/TIME 2016-11-12T10:36:28
Sending PINGREQ
Received PINGRESP

Die Einstellungen können mit folgender Syntax angefordert werden (zwei Terminalfenster öffnen, eines zum protokollieren und eines zum Seden der Befehle).
mosquitto_sub -d -v -t \# MQTT Datenverkehr protokolieren
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/status/set -m "8" = SonoffPOW Status jetzt auslesen
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/TelePeriod/set -m "60" = Timer setzen, alle 60 Sekunden Daten senden
Die Kommandos können direkt am Broker (Terminalfenster Putty etc.) abgesetzt werden.

<div style="clear:both;"></div>

=== Sonoff POW Kalibrieren ===
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier wird beschrieben, wie der ''Sonoff POW kalibriert'' werden kann. }}
Ab Version 2.0.11 kann nun auch der POW kalibriert werden.
Dazu kann man 2 Konsolenfenster öffnen, im ersten aktiviert man das Protokoll für den Datenverkehr
mosquitto_sub -d -v -t \# MQTT Datenverkehr protokollieren

Dann kann mit folgenden Befehlen die HLW Referenz Pulsfrequenz gesetzt werden.
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/HLWUCAL/set -m "2100" default = 1950
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/HLWICAL/set -m "2450" default = 3500
mosquitto_pub -q 2 -t cmnd/sonoffpow/1/HLWPCAL/set -m "13500" default = 12345
Entweder man hat eine definierte Last zur Verfügung oder besser man misst mit einem Leistungsmesser nach. Die Spannung kann man mit einem Multimeter nachmessen (sollte 230 V sein) und der Strom wird errechnet (bei 100 Watt I = P / U ) = 100/230 = 0,4347.
Die Referenzwerte solange geringfügig ändern bis die Ausgabe passt. Für die Ausgabe wird einfach eine Statusabfrage durchgeführt.

mosquitto_pub -q 2 -t cmnd/sonoffpow/1/status/set -m "8"
Befehl für die Statusabfrage

cmnd/sonoffpow/1/status/set 8
Received PUBLISH (d0, q0, r0, m0, 'stat/sonoffpow/1/STATUS', ... (103 bytes))
stat/sonoffpow/1/STATUS PWR: Voltage 225 V, Current 0.427 A, Current Power 98 W, Total Power Today 0.080 kWh, Power Factor 1.00
Ergebnis der Statusabfrage mit Spannung, Strom und Leistung.

<div style="clear:both;"></div>

===Sonoff POW FHEM Anbindung===
Ein Beispiel einer einfachen Anbindung via MQTT an Fhem. MQTT ist insofern notwendig, da in der Software ESPEasy und der Bridge noch keine Implementierung der Frequenzumrechnung enthalten ist.

define Sonoff_Pow MQTT_DEVICE
attr Sonoff_Pow IODev myBroker
attr Sonoff_Pow eventMap ON:on OFF:off
attr Sonoff_Pow icon measure_power
attr Sonoff_Pow publishSet ON OFF cmnd/sonoffpow/1/POWER/set
attr Sonoff_Pow room MQTT
attr Sonoff_Pow subscribeReading_Power tele/sonoffpow/POWER
attr Sonoff_Pow subscribeReading_state cmnd/sonoffpow/1/POWER/set
attr Sonoff_Pow subscribeReading_TODAY_ENERGY tele/sonoffpow/TODAY_ENERGY
attr Sonoff_Pow subscribeReading_PERIOD_ENERGY tele/sonoffpow/PERIOD_ENERGY
attr Sonoff_Pow subscribeReading_CURRENT_POWER tele/sonoffpow/CURRENT_POWER
attr Sonoff_Pow subscribeReading_VOLTAGE tele/sonoffpow/VOLTAGE
attr Sonoff_Pow subscribeReading_CURRENT tele/sonoffpow/CURRENT
attr Sonoff_Pow subscribeReading_AKTUELL stat/sonoffpow/1/STATUS
attr Sonoff_Pow webCmd ON:OFF
attr Sonoff_Pow stateFormat {sprintf("akutelle Leistung: %.1f W Tagesverbrauch: %.2f Kw/h", ReadingsVal($name,"CURRENT_POWER",undef), ReadingsVal($name,"TODAY_ENERGY",undef))}
Zusätzlich kann hier noch das Relais mit "on" und "off" ein- ausgeschaltet werden. Ab Version 2.0.15 wurden hier die ReadingsNamen auf TODAY_ENERGY und PERIOD_ENERGY (anstatt _POWER) geändert.

===Sonoff POW Netz-Anschluß===
[[Datei:sonoff_sw_34.jpg|thumb|left|alt=Sonoff POW Netzanschluß]]
Erst wenn alle Arbeiten an der Hard- und Software abgeschlossen sind, kann man das Modul an die Netzspannung anschließen. Wer es sich einfach machen will, nimmt eine Industriell gefertigte 230 V Verlängerung (zwischen 1,5 - 3 Meter) und schneidet sie in der Mitte durch. Nach dem abisolieren der flexiblen Drähte sollte diese '''verlötet oder mit Aderendhülsen''' versehen werden (müssen aber exakt passen, da hier kaum Platz in den Klemmen ist).
Mit einem kleinen Schraubendreher kann man die Feder der Klemmen niederdrücken und das verzinnte Drahtende tief ich die Öffnung stecken. Es dürfen keine Drahtlitzen aus den Öffnungen sichtbar sein, Kurzschlußgefahr! Ebenso sollte eine Zugprobe durchgeführt werden ob die Klemme auch richtig eingerastet ist.

'''ACHTUNG:''' diese Arbeiten müssen von einem ausgebildeten Fachpersonal (Elektriker) durchgeführt werden, Lebensgefahr!
<div style="clear:both;"></div>

===Sonoff POW Design===

====ReadingsGroup normal====
[[Datei:sonoff_sw_46.jpg|thumb|left|alt=Sonoff POW Design]]
Viele Benutzer wollen schönere und funktionelle Ausgaben am Bildschirm sehen. Die Möglichkeiten nach oben sind hier sehr vielfältig. Anhand von zwei einfachen aber mächtigen Funktionen hier ein kleines Beispiel wie hier im Bild dargestellt.

Was das Design betrifft, sind hier mehrere Möglichkeiten gegeben und nach oben ist für findige Anwender alles offen.

<div style="clear:both;"></div>

Zunächst wird mit dem Hilfsmodul "'''average'''" eine Art Statistik (Durchschnittsberechnung, Min.,Max., etc.) hinzugefügt. Das beschränkt sich auf eine einzige Zeile. Es würde sich auch '''statistic''' dazu eignen.

define Sonoff_Pow_CURRENT_POWER average Sonoff_Pow:CURRENT_POWER.*
Die "average" Funktion wird in das Device "Sonof_Pow" auf das Reading "CURRENT_POWER" hinzugefügt.

Der zweite Schritt wird eine '''readingsGroup''' mit den gewünschten und gefilterten Ausgabedaten. Durch die verschiedenen IF Abfragen der unterschiedlichen VALUE wird bei über- oder unterschreiten eines Wertes eine bestimmte Farbe angewandt. Weitere Beispiele dazu siehe im Wiki unter [http://www.fhemwiki.de/wiki/ReadingsGroup readingsGroup]

define SonoffPows readingsGroup <%measure_power>,<aktuell>,<Tag>,<Strom>,<Durchschnitt>,<max.P>,<Schaltzyklen>,< hr > .*(Sonoff_Pow|Sonoff_Pow2):CURRENT_POWER,TODAY_ENERGY,CURRENT,CURRENT_POWER_avg_day,CURRENT_POWER_max_day,PERIOD_ENERGY
attr SonoffPows mapping %ALIAS
attr SonoffPows nameStyle style="color:yellow"
attr SonoffPows room MQTT
attr SonoffPows valueFormat {'CURRENT_POWER' =>"%.0f W", 'TODAY_ENERGY' =>"%.2f Kw", 'CURRENT' =>"%.2f A",'CURRENT_POWER_max_day' => "%.0f W",'CURRENT_POWER_avg_day' => "%.2f W",'PERIOD_ENERGY'=>"%.0f Zyklen"}
attr SonoffPows valueStyle { if($READING eq "CURRENT_POWER" && $VALUE >= 0 && $VALUE <= 100){ 'style="color:green;;text-align:right"' }elsif( $READING eq "CURRENT_POWER" && $VALUE > 100 && $VALUE < 200){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER" && $VALUE >= 200){ 'style="color:red;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE >= 4.8){ 'style="color:red;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE <= 2.5){ 'style="color:green;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE > 2.5 && $VALUE < 4.8 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT" && $VALUE <= 0.45){'style="color:green;;text-align:right"'}elsif( $READING eq "CURRENT" && $VALUE > 0.45 && $VALUE < 0.87 ){'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT" && $VALUE >= 0.87){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE <= 100){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE > 100 && $VALUE < 200 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE >= 200){ 'style="color:red;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE <= 10){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE > 10 && $VALUE < 15 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE >= 15){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE <= 100){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE > 100 && $VALUE < 200 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE >= 200){ 'style="color:red;;text-align:right"' } }

Die readingsGroup sind etwas komplex zu lesen, aber nach etwas Einarbeitung klappt das schon. Die in diesem Beispiel verwendeten Readingsnamen beziehen sich auf die Beispielkonfigurationen hier im Wiki.
<div style="clear:both;"></div>

<div style="clear:both;"></div>
====ReadingsGroup mit Schaltmöglichkeit====
[[Datei:sonoff_pow_03.jpg|thumb|left|alt=readingsGroup mit Schalter]]
Die vorher erwähnte ReadingsGroup kann auch gleich mit einem Schalter versehen werden um den POW Ein- oder Aus schalten zu können. Dazu ist aber eine andere Einstellung im Sketch erforderlich.
<div style="clear:both;"></div>

In der "'''user_config.h'''" muss an dieser Stelle auch die "'''PUB_PREFIX'''" auf die gleiche Topic wie "PUB_PREFIX2" eingestellt werden. Durch diese Maßnahme wird erreicht, dass sofort nach dem Knopfdruck auch der Status mit der Topic "tele" übertragen wird. Würde der weiterhin mit "stat" übertragen, kann er in der Readingsgroup nur sehr umständlich weiter behandelt werden. Dadurch wird erreicht, dass der Schalter sofort nach dem Schaltvorgang und der Rückmeldung (Status) auch seine Farbe ändert. Wird dieser Eintrag vergessen, ändert der Schalter erst nach Eintreffen der nächsten zyklischen Abfrage seinen Status/Farbe.

#define SUB_PREFIX "cmnd" // Sonoff devices subscribe to:- SUB_PREFIX/MQTT_TOPIC and SUB_PREFIX/MQTT_GRPTOPIC
#define PUB_PREFIX "tele" // Sonoff devices publish to:- PUB_PREFIX/MQTT_TOPIC
#define PUB_PREFIX2 "tele" // Sonoff devices publish telemetry data to:- PUB_PREFIX2/MQTT_TOPIC/UPTIME, POWER/LIGHT and TIME
hier die PUB_PREFIX mit der geänderten Topic "tele" anstatt "stat"

define SonoffPows readingsGroup <%measure_power>,<aktuell>,<Tag>,<Gestern>,<Strom>,<Durchschnitt>,<max.P>,<Zyklus>,<Faktor>,<Status>,< hr > .*(Sonoff_Pow|Sonoff_Pow2|Sonoff_Pow3):CURRENT_POWER,TODAY_ENERGY,YESTERDAY_ENERGY,CURRENT,CURRENT_POWER_avg_day,CURRENT_POWER_max_day,PERIOD_ENERGY,POWER_FACTOR,LIGHT
attr SonoffPows commands {'LIGHT.ON' => 'set $DEVICE OFF','LIGHT.OFF' => 'set $DEVICE ON'}
attr SonoffPows mapping %ALIAS
attr SonoffPows nameStyle style="color:yellow"
attr SonoffPows room Energie,MQTT
attr SonoffPows valueFormat {'CURRENT_POWER' =>"%.0f W", 'TODAY_ENERGY' =>"%.2f Kw",'YESTERDAY_ENERGY' =>"%.2f Kw", 'CURRENT' =>"%.2f A",'CURRENT_POWER_max_day' => "%.0f W",'CURRENT_POWER_avg_day' => "%.2f W",'CURRENT_POWER'=>"%.0f W",'POWER_FACTOR' => "%.2f "}
attr SonoffPows valueIcon {'LIGHT.ON' => 'rc_GREEN@green', 'LIGHT.OFF' => 'rc_RED@red'}
attr SonoffPows valueStyle { if($READING eq "CURRENT_POWER" && $VALUE >= 0 && $VALUE <= 100){ 'style="color:green;;text-align:right"' }elsif( $READING eq "CURRENT_POWER" && $VALUE > 100 && $VALUE < 200){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER" && $VALUE >= 200){ 'style="color:red;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE >= 4.8){ 'style="color:red;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE <= 2.5){ 'style="color:green;;text-align:right"' }elsif( $READING eq "TODAY_ENERGY" && $VALUE > 2.5 && $VALUE < 4.8 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "YESTERDAY_ENERGY" && $VALUE <= 2.5){ 'style="color:green;;text-align:right"' }elsif( $READING eq "YESTERDAY_ENERGY" && $VALUE > 2.5 && $VALUE < 4.8 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "YESTERDAY_ENERGY" && $VALUE >= 4.8){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT" && $VALUE <= 0.45){'style="color:green;;text-align:right"'}elsif( $READING eq "CURRENT" && $VALUE > 0.45 && $VALUE < 0.87 ){'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT" && $VALUE >= 0.87){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE <= 100){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE > 100 && $VALUE < 200 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_avg_day" && $VALUE >= 200){ 'style="color:red;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE <= 10){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE > 10 && $VALUE < 15 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "PERIOD_ENERGY" && $VALUE >= 15){ 'style="color:red;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE <= 100){ 'style="color:lightgreen;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE > 100 && $VALUE < 200 ){ 'style="color:orange;;text-align:right"' }elsif( $READING eq "CURRENT_POWER_max_day" && $VALUE >= 200){ 'style="color:red;;text-align:right"' } }
hier die erweiterte ReadingsGroup mit dem Schalter. Bei Bedarf sind hier die Devicenamen anzupassen wenn andere Namen verwendet werden (Sonoff_Pow|Sonoff_Pow2|Sonoff_Pow3).

<div style="clear:both;"></div>

====POW mit FTUI anzeigen====
[[Datei:sonoff_pow_energy.JPG|thumb|left|alt=Tablett FTUI]]
Wer möchte kann die Energieanzeigen auch mit der [https://forum.fhem.de/index.php/topic,34233.0.html Tablett UI] für eine Tablet Ansicht gestalten. Mit dieser stehen viele Möglichkeiten zu einer attraktiven Darstellung zur Verfügung.
Hier ein Beispiel welches mit den Widget "[http://www.fhemwiki.de/wiki/FHEM_Tablet_UI#Widget_THERMOSTAT thermostat]" dargestellt ist.
<div style="clear:both;"></div>

==Sonoff Slampher Flashen==
[[Datei:sonoff_sl_53.jpg|thumb|left|alt=Sonoff SLAMPHER]]
Dieses Modul ist eine Besonderheit was das Flashen betrifft, denn mit Hilfe des Tasters kann der ESP8266 NICHT in den Flashmode gebracht werden. Der Taster ist intern anderwärtig verdrahtet und somit für diesen Zweck nicht zu gebrauchen.

Wie hier links im Bild zu sehen ist, muss der rechte Pin des R20 (oben im Bild) während dem Einstecken des USB Steckers auf Masse gelegt werden. Die beste Möglichkeit ist ein Stücken Draht anzulöten und diesen dann beim einstecken auf den Masse Pin des USB-Konverters zu legen.

Pinbelegung des Steckers von oben nach unten:
o - GND
o - TxD
o - RxD
'''o''' - Vdd

<div style="clear:both;"></div>

[[Datei:sonoff_sl_51.jpg|thumb|left|alt=Sonoff SLAMPHER R20]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier ist genau ersichtlich, wo der R20 auf der Platine platziert ist. }}
Hier nocheinmal schön zu sehen wo der R20 (der ist nicht eingelötet sondern leer) exakt auf der Platine liegt, gemeint ist der rechte Pin. Hier kann auch leicht gelötet werden, da keine empfindlichen Bauteile in der Nähe sind und auch genug Platz vorhanden ist.

<div style="clear:both;"></div>
[[Datei:sonoff_sl_50.jpg|thumb|left|alt=Sonoff SLAMPHER R20]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier ist genau ersichtlich, wo der Draht am R20 aufgelötet wurde }}
Hier ist ein kleines Stück Schaltdraht auf den Pin bereist aufgelötet und bereit zum Flashen!

In diesem Beispiel wurde keine Pfostensteckerleiste auf die Platine aufgelötet, sondern nur durchgesteckt und mit einem Gummiring zum Relais fixiert, das erspart den Lötvorgang, weil in Zukunft dann ohnehin OTA geflasht werden kann.

Also Pin20 auf Masse legen und USB-Konverter an den PC einstecken, dann den Draht von der Masse entfernen. Der ESP8266 sollte jetzt im Flashmodus bereit stehen und kann wie bereits oben beschrieben geflasht werden.

<div style="clear:both;"></div>

===Sonoff Slampher Software===
[[Datei:sonoff_sl_54.jpg|thumb|left|alt=Sonoff SLAMPHER FHEM]]

Als Software wird Arends Sketch installiert (Kommunikation über MQTT), da zum derzeitigen Zeitpunkt ESPEasy das Modul noch nicht integriert hat und somit auch nicht ansteuern kann.
<div style="clear:both;"></div>

define Sonoff_SL MQTT_DEVICE
attr Sonoff_SL IODev myBroker
attr Sonoff_SL devStateIcon ON:rc_GREEN:OFF OFF:rc_RED:ON
attr Sonoff_SL icon hue_filled_br30
attr Sonoff_SL publishSet ON OFF cmnd/sonoffsl/1/POWER/set
attr Sonoff_SL room Bewegung,_Sonoff
attr Sonoff_SL stateFormat Licht
attr Sonoff_SL subscribeReading_Licht tele/sonoffsl/POWER
attr Sonoff_SL subscribeReading_state cmnd/sonoffsl/1/POWER/set
attr Sonoff_SL webCmd ON:OFF

Hier ein Beispiel wie in FHEM der Slampher eingebunden werden kann. In diesem Beispiel wird davon ausgegangen, das das Modul "sonoffsl" unter Konfiguration am WEBIF (Configure MQTT bei Topic) so unbenannt wurde. Wer einen anderen Namen haben möchte, muss dies dann auch in FHEM entsprechend anpassen.

<div style="clear:both;"></div>

==Sonoff Th10/16 FHEM==
[[Datei:sonoff_th_01.jpg|thumb|left|alt=Sonoff TH10]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Temperatur Modul TH10 / 16! }}
Das Modul kann durch drücken des Tasters während dem Einstecken des USB-Konverters in den Flashmodus gebracht werden.
Der Th10/16 kann mit zwei unterschiedlichen Typen von Sensoren bestückt werden, hier im Beispiel mit dem externen Temperaturfühler DS18B20.

Wie im Bild klar zu sehen ist, kann das Webif auch zur Darstellung via Mobile verwendet werden. Mit "Toggle" wird Ein- oder Aus geschaltet und darunter ist die aktuelle Temperatur ersichtlich. Für diese Ansicht muss keine MQTT Verbindung eingerichtet werden, da die Kommunikation hier rein über HTTP erfolgt.

Die unten dargestellten Beispiele für FHEM beziehen sich auf Arends Sketch, also über MQTT. Dieses Modul kann aber genauso leicht über ESPEasy und der ESPEasy-Bridge eingebunden werden.

<div style="clear:both;"></div>
Pinbelegung des Steckers von oben nach unten:
o - GND
o - TxD
o - RxD
'''o''' - Vdd

#define DSB_PIN 14 // GPIO 14 = DS18x20 (Sonoff_TH10A(16A), Sonoff SV)
#define DSB_RESOLUTION 2 // Maximum number of decimals (0 - 3) showing Temperature
// *** Option 1 - Single DS18B20 - Select either Option 1 OR Option 2
#define SEND_TELEMETRY_DS18B20 // Enable sending single temperature telemetry
// *** Option 2 - Multiple DS18B20 and/or DS18S20 (needs OneWire library!)
// #define SEND_TELEMETRY_DS18x20 // Enable sending multi temperature telemetry
In der user_config.h (Arends Sketch) muss hier die Option 1 aktiviert werden (entfernen der vorangestellten //) damit die Telemetriedaten auch gesendet werden. Es empfiehlt sich mindestens die Version >= V 2.0.16, weil hier die Sensoren erweitert wurden.

#define DHT_PIN 14 // GPIO 14 = AM2301 (Sonoff_TH10A(16A), Sonoff SV)
#define DHT_TYPE AM2301 // DHT module type (DHT11, DHT21, DHT22, AM2301, AM2302 or AM2321)
#define DHT_RESOLUTION 1 // Maximum number of decimals (0 - 3) showing Temperature
#define SEND_TELEMETRY_DHT // Enable sending temperature and humidity telemetry
Beispiel für den Sensor DHT22, Temperatur und Luftfeuchte. Es dürfen aber nicht beide Sensoren (DS18B20 + DHT22) gleichzeitig aktiviert werden, da ja beide an GPIO14 angehängt werden und es ansonsten zu Fehlfunktionen kommen würde.

<div style="clear:both;"></div>
[[Datei:sonoff_th_02.jpg|thumb|left|alt=Sonoff TH10]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Einbindung in Fhem via MQTT! }}
<div style="clear:both;"></div>

### Temperatur und Luftfeuchte vom Sonoff Switch ###
define Sonoff_Temp MQTT_DEVICE
attr Sonoff_Temp IODev myBroker
attr Sonoff_Temp alias Pool Wasser
attr Sonoff_Temp eventMap ON:on OFF:off
attr Sonoff_Temp icon temperature_humidity
attr Sonoff_Temp publishSet ON OFF cmnd/sonoffth/1/POWER/set
attr Sonoff_Temp room _Sonoff
attr Sonoff_Temp stateFormat {sprintf("Temperatur: %.1f Grad", ReadingsVal($name,"TEMPERATURE",0))}
attr Sonoff_Temp subscribeReading_TEMPERATURE tele/sonoffth/DS18B20/TEMPERATURE
attr Sonoff_Temp subscribeReading_humidity tele/sonoffth/HUMIDITY
attr Sonoff_Temp subscribeReading_state cmnd/sonoffth/1/POWER/set
Beispiel für FHEM mit Temperaturanzeige mit DS18B20

define Sonoff_Switch MQTT_DEVICE
attr Sonoff_Switch IODev myBroker
attr Sonoff_Switch alias Pool Licht
attr Sonoff_Switch devStateIcon on:rc_GREEN:off off:rc_RED:on
attr Sonoff_Switch eventMap ON:on OFF:off
attr Sonoff_Switch icon light_ceiling
attr Sonoff_Switch publishSet ON OFF cmnd/sonoffth/1/POWER/set
attr Sonoff_Switch room _Sonoff
attr Sonoff_Switch stateFormat Licht
attr Sonoff_Switch subscribeReading_Licht tele/sonoffth/POWER
attr Sonoff_Switch subscribeReading_state cmnd/sonoffth/1/POWER/set
attr Sonoff_Switch webCmd ON:OFF
Der Schalter nochmals seperat dargestellt, je nach Geschmack.

<div style="clear:both;"></div>

==Sonoff CH4 4-Kanal Schaltmodul==
[[Datei:sonoff_ch4_1.jpg|thumb|left|alt=Sonoff CH4]]
{{Randnotiz|RNTyp=[g|Info]|RNText=Achtung andere Einstellungen der Arduino IDE: Select Board "Generic ESP8285 Module" (=Flash Mode "DOUT") and Flash Size "1M (64K SPIFFS)"n! }}

Der Sonoff CH4 ist mit seinen 4 Kanälen ein sehr preiswertes Modul im Gehäuse und für Hutschinenmontage. Anstatt des üblichen ESP8266 besitzt dieses Modul schon den moderneren '''ESP8285'''. Es müssen daher in der Arduino IDE andere Einstellungen vorgenommen werden. Unter Board wird hier das "'''Generic 8285 Module'''" mit '''1M und 64K Spiffs''' angewählt. Der Flashmode "'''DOUT'''" wird dann automatisch eingestellt, bzw. ausgeblendet.

Das Modul ist etwas größer als die anderen Sonoff Produkte und besitzt mit 14,5 x 9 cm schon beachtliche Einbau Maße.
<div style="clear:both;"></div>
[[Datei:sonoff_ch4_2.jpg|thumb|left|alt=Sonoff CH4 FDTI]]
Als weitere Besonderheit sei hier erwähnt, das die Signale '''RxD auf RxD und TxD auf TxD''' des FTDI Konverters zu verbinden sind. Wie bei allen Sonoff Modulen darf man '''zum flashen keine Netzspannung anschließen''', sondern nur über die Versorgungsspannung des FDTI Konverters mit 3,3 V versorgen (Jumper richtig setzen). Die Stiftleiste für den FTDI Anschluß ist hier schon eingelötet.

In den Flashmodus gelangt man durch drücken der '''Taste FW/IO0''' während des einstecken des USB Anschlusses.
<div style="clear:both;"></div>
[[Datei:sonoff_ch4_3.jpg|thumb|left|alt=Sonoff CH4 Arends]]
Hier die Ansicht des Webinterface des Arends Sketches!
Bei der Software sei erwähnt, das die getestete Version 3.1.16 nur bei Kanal 1 den Modus "PulseTime" beherrscht. Wer also gepulste Ausgänge (zB: elektrische Garage/Toröffner) benötigt muss diese per Software nachbilden oder mit dem Kanal 1 auskommen. Eine "Pulsetime 10" ist ein guter Wert dafür (etwa 1 Sekunde).

Als Alternative kann mit dieser HTML Seite des Webservers am Modul des CH4 schon mit jedem Browser fähigem Handy (Android, iPhone, Windows) aufgerufen werden und somit alle Funktionen gesteuert werden.
<div style="clear:both;"></div>
[[Datei:sonoff_ch4_4.jpg|thumb|left|alt=Sonoff CH4 Software APP]]
Hier dargestellt die Original Software die Sonoff zum Modul liefert (EWeLink) und über ihre Cloud verbindet. Leider kann hier keine gepulste Ausgabe erfolgen. Mit einem Countdown kann zwar der Ausgang wieder abgeschaltet werden, die kleinste Zeiteinheit ist aber 1 Minute und somit für einen Impuls leider nicht zu gebrauchen. Ebenso kann mit dieser Software keine Einbindung in Fhem erfolgen, obwohl es eine nette anschauliche Darstellung ist.
<div style="clear:both;"></div>

=Erweiterungen=
<div style="clear:both;"></div>

==Sonoff Switch mit Temperatur + Luftfeuchte==
{{Randnotiz|RNTyp=[g|Info]|RNText=Hier geht es um nützliche Hardware Erweiterungen an den Originalmodulen!}}
Wozu überhaupt den Switch erweitern wenn es auch die Modelle TH10 und TH16 gibt?

Manche Personen können dadurch dem Basteltrieb nachkommen, aber das wesentliche ist der Preis, da die Switches doch fast um die Hälfte billiger sind. Die Sensoren kosten ebenfalls kaum nennenswerte Beträge.

Oder es hat schon jemand Switches im Einsatz und möchte jetzt zusätzlich die Temperatur erfassen!

<div style="clear:both;"></div>

=== Hardware erweitern mit DHT22 ===
[[Datei:sonoff_sw_4.PNG|thumb|left|alt=Sonoff Switch Pinleiste mit Temperatur]]
Am Sonoff Switch wurde ja schon eine Stiftleiste zum Flashen eingelötet. Diese Stiftleiste bietet schon alle Anschlüsse welche für die Temperatur- und Luftfeuchtemessung benötigt werden. Am 5. Anschluß der Stifftleiste ist das Signal "SCL" (GPIO14) herausgeführt, welches für den DHT22 zur Erfassung der Messdaten benötigt wird. Der Sonsor wird mit einem einem 3-poligen Kabel (zB: ein Steckkabel für ein Breadboard oder direkt anlöten) verbunden. Damit der DHT22 korrekt funktioniert, wird ein Widerstand mit 4,7 K Ohm zwischen Vdd und Data am DHT22 zusätzlich benötigt.

<div style="clear:both;"></div>

[[Datei:sonoff_sw_45.jpg|thumb|left|alt=AM2302 / DHT22]]

Ansicht des DHT22 (AM2302) mit den aufgesteckten Verbindungskabeln. Von links nach rechts sind das

1 = VCC 3,3 V
2 = Data
3 = nc (nicht belegt)
4 = GND

Pin1 (VCC) des DHT22 muss also auf Pin1 der Stiftleiste, Pin2 (Data) auf Pin5 und Pin4 (GND) auf Pin4.
Pin2 und Pin1 soll hier noch der Widerstand aufgelötet werden.

1 ------- 1 (VDD)
2 ------- 5 (GPIO14)
3
4 ------- 4 (GND)
DHT22 Stiftleiste

<div style="clear:both;"></div>

[[Datei:sonoff_sw_44.jpg|thumb|left|alt=umgebautes Modul]]
Diese Darstellung zeigt das umgebaute und bereits verschlossene Modul. Auf der Seite des Tasters (bitte nur hier, da auf der anderen Seite die 230 V verlaufen und neben der Lebensgefahr auch den Sensor beeinflussen) ist hier einfach mit einer Eisensäge ein Schlitz eingesägt, der dient in diesem Falle als Kabeldurchführung. Ein Schlitz ist besser als ein Loch, da der Oberteil des Gehäuses sich leichter aufsetzen läßt. Wer ein längeres Kabel benötigt, kann natürlich auch ein 3-poliges Telefonkabel (oder Mikrokabel oder sonstiges) verwenden. Der Sensor sollte etwas Abstand zum Gehäuse haben, da dieses auch eine Eigenerwärmung hat. Wer es ganz originalgetreu lösen will, kann auch eine 3-polige Mini Buchse für Klinckenstecker (3,5mm) einbauen so wie sie am TH10/16 vorhanden ist.
<div style="clear:both;"></div>

=== Software anpassen am Beispiel MQTT ===
[[Datei:sonoff_sw_40.jpg|thumb|left|alt=Sonoff MQTT]]

Wer über MQTT kommuniziert und die Software von Theo Arends benutzt, muss folgende Dinge beachten. In der Datei '''user_config.h''' müssen im Abschnitt '''Module = SONOFF''' die Slashes so wie unten dargestellt entfernt werden, damit erstens die Interrupts abgefragt werden und zweitens die Telemetriedaten gesendet werden. Ebenso ist der verwendete Sensor bei "'''define DHT_TYPE'''" eingestellt werden. In dem hier gezeigten Beispiel also "'''DHT22'''".

#if MODULE == SONOFF // programming header 1:3.3V 2:rx 3:tx 4:gnd
#define APP_NAME "Sonoff module"
#define LED_PIN 13 // GPIO 13 = Green/Blue Led (0 = On, 1 = Off) - Sonoff
#define LED_INVERTED 1 // 0 = (1 = On, 0 = Off), 1 = (0 = On, 1 = Off)
#define REL_PIN 12 // GPIO 12 = Red Led and Relay (0 = Off, 1 = On)
#define KEY_PIN 0 // GPIO 00 = Button
/*-------------------------------------------------------------------------------------------*/
#define DSB_PIN 4 // GPIO 14 = DS18B20 (Sonoff_TH10A(16A), Sonoff SV)
#define SEND_TELEMETRY_DS18B20 // Enable sending temperature telemetry
/*-------------------------------------------------------------------------------------------*/
#define DHT_PIN 14 // GPIO 14 = AM2301 (Sonoff_TH10A(16A), Sonoff SV)
#define DHT_TYPE DHT22 // DHT module type (DHT11, DHT21, DHT22, AM2301, AM2302 or AM2321)
#define SEND_TELEMETRY_DHT // Enable sending temperature and humidity telemetry

<div style="clear:both;"></div>

=== Software Anpassung DHT22 in Fhem ===
[[Datei:sonoff_sw_41.jpg|thumb|left|alt=umgebautes Modul]]

Links in der Hardcopy sind die Readings die nach der Anpassung von FHEM (Broker) befüllt werden sollten.

<div style="clear:both;"></div>

### Temperatur und Luftfeuchte vom Sonoff Switch ###
define Sonoff_Temp MQTT_DEVICE
attr Sonoff_Temp IODev myBroker
attr Sonoff_Temp icon temperature_humidity
attr Sonoff_Temp room MQTT
attr Sonoff_Temp stateFormat {sprintf("Temperatur: %.1f Grad Feuchte: %.1f ", ReadingsVal($name,"temperature",0), ReadingsVal($name,"humidity",0))}
attr Sonoff_Temp subscribeReading_humidity tele/sonoff/HUMIDITY
attr Sonoff_Temp subscribeReading_temperature tele/sonoff/TEMPERATURE
Als Beispiel die zusätzliche Erweiterung um die Temperatur und die Luftfeuchte in FHEM. Der in der Topic verwendete Name "sonoff" muss natürlich der Einstellung in der Software am Switch entsprechen. Bei Verwendung mehrerer Switches muss natürlich auch der Name bei jedem geändert werden.

<div style="clear:both;"></div>

=== Logfile für die Temperatur ===
define SVG_FileLog_Sonoff_Temp SVG myDbLog:SVG_FileLog_Sonoff_Temp:HISTORY
attr SVG_FileLog_Sonoff_Temp room MQTT

Und schließlich fehlt noch das Logfile, damit der Temperaturverlauf auch in schönen Plots dargestellt werden kann.
Das hier verwendete Beispiel funktioniert nur mit einer DbLog.

<div style="clear:both;"></div>

==Sonoff Switch als Thermostat verwenden mit MQTT==

[[Datei:sonoff_sw_55.jpg|thumb|left|alt=Thermostat]]
Mit diesem einfachen Beispiel wird ein Pelett Ofen mit einem externen Thermostat (sonoff Switch oder TH10/16) gesteuert. Zum besseren Überblick wird die Steuerung in einzelne Module getrennt, es könnte aber auch einiges zu einer einzigen Definition zusammen gefasst werden. Der Thermostat könnte auch als Frostwächter benutzt werden und ein anderes Heizgerät steuern.
<div style="clear:both;"></div>

###################################
### Sonoff Thermostat Regelung ####
###################################
define Sonoff_dht MQTT_DEVICE
attr Sonoff_dht IODev myBroker
attr Sonoff_dht alias Raumtemperatur
attr Sonoff_dht group Thermostat
attr Sonoff_dht icon temperature_humidity
attr Sonoff_dht publishSet ON OFF cmnd/sonoff_dht/1/POWER/set
attr Sonoff_dht room _Sonoff
attr Sonoff_dht stateFormat {sprintf("Temperatur: %.1f Grad Feuchte: %.1f ", ReadingsVal($name,"TEMPERATURE",0), ReadingsVal($name,"HUMIDITY",0))}
attr Sonoff_dht subscribeReading_HUMIDITY tele/sonoff_dht/DHT/HUMIDITY
attr Sonoff_dht subscribeReading_TEMPERATURE tele/sonoff_dht/DHT/TEMPERATURE
attr Sonoff_dht subscribeReading_state cmnd/sonoff_dht/1/POWER/set
FHEM Definition zur Erfassung der Temperatur und der Luftfeuchte. Damit dieses Beispiel funktioniert, ist am Sonoff Modul die Topic "'''sonoff_dht'''" zu setzen. Dieser Temperaturwert dient dem Thermostat als ISTWert.

define Sonoff_Sw MQTT_DEVICE
attr Sonoff_Sw IODev myBroker
attr Sonoff_Sw alias Pellets Ofen
attr Sonoff_Sw devStateIcon on:rc_GREEN:off off:rc_RED:on
attr Sonoff_Sw eventMap ON:on OFF:off
attr Sonoff_Sw group Thermostat
attr Sonoff_Sw icon sani_boiler_temp
attr Sonoff_Sw publishSet ON OFF cmnd/sonoff_dht/1/POWER/set
attr Sonoff_Sw room _Sonoff
attr Sonoff_Sw stateFormat Licht
attr Sonoff_Sw subscribeReading_Licht tele/sonoff_dht/POWER
attr Sonoff_Sw subscribeReading_state cmnd/sonoff_dht/1/POWER/set
attr Sonoff_Sw webCmd ON:OFF
FHEM Definition zum Absetzen der Befehle für das Relais (Thermostat) Ein- / Aus. Wenn das zu steuernde Geräte einen potentialfreien Thermostatanschluß benötigt (in den meisten Fällen), muss noch ein Relais dazwischen geschaltet werden um die Trennung der Netzspannung zu gewährleisten.

define ThermostatPellets dummy
attr ThermostatPellets alias Pellets Ofen Sollwert
attr ThermostatPellets group Thermostat
attr ThermostatPellets icon temp_control
attr ThermostatPellets room _Sonoff
attr ThermostatPellets setList state:0,5,10,12,13,14,15,16,17,17.5,18,18.5,19,19.5,20,20.5,21,21.5,22,23,24,25,26,27
attr ThermostatPellets webCmd state
Die Sollwertvorgabe für das Thermostat durch einen Dummy, damit können die gewünschten Temperaturen eingestellt werden.

### sofort ausführen wenn neuer Sollwert eingestellt wird ###
define Thermostat_on_notify notify ThermostatPellets IF (ReadingsVal("Sonoff_Sw","state",0) eq "OFF" && (ReadingsVal("Sonoff_dht","TEMPERATURE",0) <= Value("ThermostatPellets"))) (set Sonoff_Sw ON)
define Thermostat_off_notify notify ThermostatPellets IF (ReadingsVal("Sonoff_Sw","state",0) eq "ON" && (ReadingsVal("Sonoff_dht","TEMPERATURE",0) > Value("ThermostatPellets"))) (set Sonoff_Sw OFF)
Mit einem notify wird die manuelle Änderung des Sollwertes überwacht und sofort reagiert.

## zyklisch prüfen ob Sollwert erreicht wurde ###
define Thermostat_on at +*00:15:00 IF (ReadingsVal("Sonoff_Sw","Licht",0) eq "OFF" && (ReadingsVal("Sonoff_dht","TEMPERATURE",0) <= Value("ThermostatPellets"))) (set Sonoff_Sw ON)
define Thermostat_off at +*00:15:00 IF (Value("Sonoff_Sw") eq "ON" && (ReadingsVal("Sonoff_dht","TEMPERATURE",0) > Value("ThermostatPellets"))) (set Sonoff_Sw OFF)
Hier noch die Soll- Ist Wertvergleiche zur Steuerung. Es wird alle 15 Minuten überprüft ob die Temperatur erreicht ist. Bei einer trägen Heizung sollten 15 Minuten ausreichend sein, wer will kann dies aber auch alle 5 oder 10 Minuten prüfen.

<div style="clear:both;"></div>

==Sonoff Switch mit Bewegungsmelder HC-SR501==

[[Datei:sonoff_pir_1.jpg|thumb|left|alt=Bewegungsmelder]]
Basierend auf dem Wall Switch MQTT Sketch von Arends wurde hier ein Sonoff BASIC + PIR HC-SR501 in eine größere Verteilerdose eingebaut, der Sonoff wurde dabei etwas gekürzt. Die Bewegungsmelder sind ab etwa 70 Cent erhältlich.

Der Sketch kann auch den Blink Modus. Damit kann man im Alarmfall z.B. Alle Strahler rings ums Haus blinken lassen.

Mehr dazu kann hier im [https://forum.fhem.de/index.php/topic,63824.0.html Forum]im Diskussionsthread nachgelesen werden.
<div style="clear:both;"></div>

[[Datei:sonoff_pir_2.jpg|thumb|left|alt=Bewegungsmelder]]
Ein Beispiel wir der Bewegungsmelder in der Feuchtraumdose montiert werden kann. Wird der Bewegungsmelder abgesetzt vom Switch montiert, ist darauf zu achten das die Kabel nicht zu lange werden.
<div style="clear:both;"></div>
===Spannungsversorgung des HC-SR501===
[[Datei:sonoff_pir_4.jpg|thumb|left|alt=5V für Bewegungsmelder]]
Der HC-SR501 wird vom Sonoff versorgt, wobei hier die 3,3 V nicht immer ausreichen. Es ist deshalb am HC-SR501 eine Diode zu überbrücken, dann reichen die 3,3V vom Sonoff. Es können aber auch am Sonoff die 5V angezapft werden. Hier im Bild dargestellt wo die 5V angezapft werden können.
<div style="clear:both;"></div>

[[Datei:sonoff_pir_5.jpg|thumb|left|alt=3,3V für Bewegungsmelder]]
Hier eine kleine Übersicht der wichtigsten Teile und deren Platzierung am HC-SR501.
Den PIR kann man auch mit 3,3V betreiben wenn man die Diode am Eingang nach Vcc überbrückt, dann reicht die Spannung für einen reibungslosen Betrieb völlig aus. Dies gilt für den HC-SR501, wird ein anderer PIR verwendet muss man nachschauen ob das auch möglich ist, ansonsten die 5V Variante wählen.

<div style="clear:both;"></div>
===Anpassung des Sketches mit Wall Switch===
Zur Vorbereitung des Sketches sind zunächst einige Einstellungen in der "user_config.h" durchzuführen.

#if MODULE == SONOFF // programming header 1:3.3V 2:rx 3:tx 4:gnd
#define APP_NAME "Sonoff 8266 module"
#define MQTT_GRPTOPIC "sonoffs" // [GroupTopic] MQTT Group topic
/*-------------------------------------------------------------------------------------------*/
#define LED_PIN 13 // GPIO 13 = Green/Blue Led (0 = On, 1 = Off) - Sonoff
#define LED_INVERTED 1 // 0 = (1 = On, 0 = Off), 1 = (0 = On, 1 = Off)
#define REL_PIN 12 // GPIO 12 = Red Led and Relay (0 = Off, 1 = On)
#define KEY_PIN 0 // GPIO 00 = Button
/*-------------------------------------------------------------------------------------------*\
* Wall switch and HC-SR501
\*-------------------------------------------------------------------------------------------*/
#define SWITCH_PIN 14 // GPIO 14 = Standard wall switch to Gnd (Sonoff_TH10A(16A), Sonoff SV)
#define SWITCH_MODE '''PUSHBUTTON_INV''' // [SwitchMode] TOGGLE, FOLLOW, FOLLOW_INV, PUSHBUTTON or PUSHBUTTON_INV (the wall switch state)
'''#define USE_WALL_SWITCH''' // Enable the use of a standard wall switch to control the relay
Wichtig ist dabei die vorangestellten Slahes // bei "#define USE_WALL_SWITCH" zu entfernen auf '''PUSHBUTTON_INV''' zu stellen. Dann kann der Sonoff Switch compiliert und geflasht werden.

===Einbindung des HC-SR501 in Fhem===
# ------------- Sonoff_pir mit Bewegungsmelder ---------------
define Sonoff_pir MQTT_DEVICE
attr Sonoff_pir IODev myBroker
attr Sonoff_pir eventMap ON:on OFF:off
attr Sonoff_pir group Sonoff
attr Sonoff_pir icon hue_filled_br30
attr Sonoff_pir publishSet ON OFF cmnd/sonoff_pir/1/POWER/set
attr Sonoff_pir room MQTT
attr Sonoff_pir stateFormat Licht
attr Sonoff_pir subscribeReading_Licht stat/sonoff_pir/POWER
attr Sonoff_pir subscribeReading_state cmnd/sonoff_pir/1/POWER/set
attr Sonoff_pir webCmd :

Ein Beispiel wie der Sonoff Switch in Fhem eingebunden wird. Wenn im Sketch der Prefix von stat auf tele geändert wurde, ist dies auch hier durchzuführen ( subscribeReading_Licht tele/sonoff_pir/POWER ), ansonsten bleibt es so wie im Beispiel. Getestet wurde dieses Beispiel mit Version 3.1.6. Die Topic sollte auf den Namen "sonoff_pir" eingestellt werden. Bei anderen Namen ist dies entsprechend in Fhem anzupassen.

Mit dem Command '''BUTTONTOPIC = Alarm_SO2''' ( direkt im Webinterface des Sonoff ) wird der Wall Switch GPIO14 vom Sonoff entkoppelt und somit sendet der Bewegungsmelder direkt an FHEM --> Motion_pir MQTT_DEVICE

Es sollte auch unbedingt kontrolliert werden, wie die Ausgabe des Alarmes in der Console erfolgt. Erscheint hier die Meldung "cmnd/Alarm_SO2/POWER = TOGGLE" dann muss mit dem Kommando "'''switchmode 1'''" das Ausgabeformat umgeschaltet werden, erst dann kommt das gewünschte Format "On" und "OFF".

# ------------------ Motion_pir MQTT_DEVICE -----------------
define Motion_pir MQTT_DEVICE
attr Motion_pir IODev myBroker
attr Motion_pir devStateIcon on:on-for-timer off:off
attr Motion_pir eventMap ON:on OFF:off
attr Motion_pir group Sonoff
attr Motion_pir icon people_sensor
attr Motion_pir room MQTT
attr Motion_pir stateFormat Alarm
attr Motion_pir subscribeReading_Alarm cmnd/Alarm_SO2/POWER
Die Motion_pir dient nun zur eigentlichen Einschaltung des Lichtes und sendet das Kommando '''cmnd/Alarm_SO2/POWER''' an den entkopellten GPIO 14 des Switch.

# ------------------ DoIf zur Motion Abfrage -----------------
define di_Sonoff_pir_Alarm DOIF ([Motion_pir:"on"] and [Tag_Nacht:twilight_weather] < 35) (set Sonoff_pir on) DOELSEIF ([Motion_pir:"off"] and [Tag_Nacht:twilight_weather] < 35) (set Sonoff_pir off)
attr di_Sonoff_pir_Alarm comment Abhängig von Helligkeitssensor wird nachts,bei Bewegung das Licht eingeschaltet!
attr di_Sonoff_pir_Alarm group Sonoff
attr di_Sonoff_pir_Alarm room MQTT
Zusätzlich kann nun mit einem '''Doif''' verknüpft werden um das Ganze mit Tag_Nacht:twilight_weather dann in Abhängigkeit der Helligkeit zu schalten. Selbstverständlich kann jede andere Quelle mit einem Helligkeitswert verwendet werden.

===Alarmausgabe über Grouptopic===
# ------------------------ Sonoffs Group ----------------------
define Sonoffs MQTT_DEVICE
attr Sonoffs IODev myBroker
attr Sonoffs eventMap ON:on OFF:off
attr Sonoffs group Sonoff
attr Sonoffs icon hue_filled_br30
attr Sonoffs publishSet ON OFF cmnd/sonoffs/1/POWER/set
attr Sonoffs room MQTT
attr Sonoffs stateFormat state
attr Sonoffs subscribeReading_Licht stat/sonoffs/1/POWER
attr Sonoffs subscribeReading_state cmnd/sonoffs/1/POWER/set
Wer möchte kann auch mit der Group Topic mehrere Switches mit Bewegungsmelder zusammenfassen und alle Lampen im Alarmfall gemeinsam in den Blinkmodus schalten. cmnd/sonoffs ist das Kommando für die Group Topic, sofern diese vom User nicht verändert wurde.
<div style="clear:both;"></div>

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
--[[Benutzer:Reinhart|Reinhart]] ([[Benutzer Diskussion:Reinhart|Diskussion]]) 20:54, 5. Jan. 2017 (CET)

ROLLO

2017-01-06T10:39:44Z

ThomasRamm: /* Attribute default-werte nachgetragen */

{{SEITENTITEL:ROLLO}}
{{Infobox Modul
|ModPurpose=Rollo-Steuerung zur einfachen Anzeige/Programmierung
|ModType=x
|ModFTopic=47202


|ModForumArea=Codeschnipsel
|ModTechName=44_ROLLO.pm
|ModOwner=ThomasRamm}}
Das Modul [[ROLLO]] bietet eine einfache Möglichkeit, mit ein bis zwei Relais den Hoch-/Runterlauf eines Rolladen zu steuern und punktgenau anzuhalten. Außerdem wird die aktuelle Position in fhem abgebildet.
Über welche Hardware/Module die Ausgänge angesprochen werden ist dabei egal.
__TOC__
Das Modul unterstützt beliebige Konfigurationen welche Befehle ausgeführt werden müssen um die Hardware des Rollos zu steuern.

* Die Rollo-Position wird in 10%-Schritten von 0% (offen) bis 100% (geschlossen) zwischengespeichert um auf der Oberfläche für jede Position ein Icon festlegen zu können.

[[Datei:Rolladen Eintrag.PNG|right|thumb|400px|Verschiedene Ansichten des Rollo:offen, fährt gerade herunter, position 50, fährt gerade hoch, geschlossen]]
Vorteil dieses Moduls:

Ist ein Rollo mit diesem Modul definiert kann man auf der Oberfläche per Klick das Rollo hoch/runter oder auf eine bestimmte Position fahren. Der aktuelle Status des Rollo (fährt hoch/runter,offen,geschlossen,etc.) wird angezeigt.
Die Oberflächenicons werden per devStateIcon gesteuert, Icons und Farben können für jeden Status individuell formatiert werden, die Standard Kommandos auf der Oberfläche (hier: offen, geschlossen, schlitz, Position) können ebenfalls per Attribut angepasst werden. Das Status-Icon ist anklickbar.
Beim Anlegen des Moduls werden die Attribute zur Darstellung in fhem mit Standardwerten angelegt, so dass man sich einiges an Tipparbeit sparen kann, aber trotzdem die Möglichkeit hat die Darstellung individuell anzupassen.

== Voraussetzungen ==
Das eigentliche ansteuern des Rollo muss mit FHEM Befehlen ausführbar sein, diese Modul ist "nur" eine Oberfläche/Bedienmodul, kein Hardwaremodul.

== Anwendung ==
=== Define ===
define <name> ROLLO

=== Attribute ===
{|class="wikitable"
|-
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung
|-
|type|| normal,HomeKit || normal ||Typunterscheidung zur unterstützung verschiedener Hardware. Abhängig vom gewählten Typ wird die Richtung von der die Position gerechnet wird festgelegt:<BR/>
normal = Position 0 ist offen, Position 100 ist geschlossen<BR/>
HomeKit = Position 100 ist offen, Position 0 ist geschlossen
|-
|secondsDown|| Ganzzahl || 30 || Sekunden die das Rollo benötigt um einmal komplett hoch zu fahren
|-
|secondsUp|| Ganzzahl || 30 || Sekunden die das Rollo benötigt um einmal komplett runter zu fahren
|-
|excessTop|| Ganzzahl || 4 || Zeit die dein Rollo nach dem Hochfahren noch weiter fahren muss ohne das sich die Rollo-Position ändert (bei mir fährt der Rollo noch in die Wand, ohne das man es am Fenster sieht, die Position ist also schon bei 0%)
|-
|excessBottom|| Ganzzahl || 2 || Zeit die dein Rollo nach dem Runterfahren noch weiter fahren muss ohne das sich die Rollo-Position ändert (Nachlaufzeit)
|-
|switchTime|| Ganzzahl || 1 || Zeit die zwischen 2 gegensätzlichen Laufbefehlen pausiert werden soll, also wenn der Rollo z.B. gerade runter fährt und ich den Befehl gebe hoch zu fahren, dann soll 1 sekunde gewartet werden bis der Motor wirklich zum stillstand kommt, bevor es wieder in die andere Richtung weiter geht. Diese Zeitangabe hat nichts mit der eigentlichen Laufzeit des Motors zu tun.
|-
|resetTime|| Ganzzahl || 0 ||Zeit die beim Anfahren von Endpositionen (offen,geschlossen) der Motor zusätzlich an bleiben soll um sicherzustellen das die Endposition wirklich angefahren wurde. Dadurch können Differenzen in der Positionsberechnung korrigiert werden.
|-
|reactionTime|| Ganzzahl || ||Zeit für den Motor zum reagieren. bei jedem Fahrbefehl wird diese Zeit zusätzlich eingeplannt ohne das die Position geändert wird, für "träge" Motoren.
|-
|autoStop|| 0,1 || 0 || Bei autoStop=1 wird kein Stop-Befehl gesendet
|-
|commandUp|| Text || || fhem Befehl der ausgeführt werden muss um das Rollo hoch zu fahren.
|-
|commandUp2|| Text || || Platz für einen zweiten fhem Befehl
|-
|commandUp3|| Text || || Platz für einen dritten fhem Befehl
|-
|commandDown|| Text || || fhem Befehl der ausgeführt werden muss um das Rollo runter zu fahren.
|-
|commandDown2|| Text || || Platz für einen zweiten fhem Befehl
|-
|commandDown3|| Text || || Platz für einen dritten fhem Befehl
|-
|commandStopUp|| Text || || Befehl der zum Stoppen ausgeführt wird,wenn der Rollo gerade hochfährt. Wenn nicht definiert wird commandStop ausgeführt
|-
|commandStopDown|| Text || || Befehl der zum stoppen ausgeführt wird, wenn der Rollo gerade herunterfährt. Wenn nicht definiert wird commandStop ausgeführt
|-
|commandStop|| Text || || Befehl der zum Stoppen ausgeführt wird, sofern nicht commandStopDown bzw. commandStopUp definiert sind
|-
|blockMode||blocked,force-open,force-closed,only-up,only-down,half-up,half-down,none|| none || durch dieses Attribut können andere Befehle in FHEM festlegen was mein Rollo machen darf (z.B. bei gekipptem Fenster darf es nicht heruntergefahren wreden):<BR/>
blocked = Rollo lässt sich nicht mehr bewegen<BR/>
force-open = bei einem beliebigen Fahrbefehl wird Rollo hochgefahren<BR/>
force-closed = bei einem beliebigen Fahrbefehl wird Rollo runtergefahren<BR/>
only-up = Befehle zum runterfahren werden ignoriert<BR/>
only-down = Befehle zum hochfahren werden ignoriert<BR/>
half-up = es werden nur die Positionen 50-100 angefahren, bei Position <50 wird Position 50% angefahren,<BR/>
half-down = es werden nur die Positionen 0-50 angefahren, bei Position >50 wird Position 50 angefahren<BR/>
none = block-Modus ist deaktiviert<BR/>
|-
|automatic-enabled
| on,off
| on
|Dieses Attribut wird nur für die Modulerweiterung 44_ROLLADEN_Automatic benötigt.
Hiermit kann die automatische Szenariensteuerung für diesen Rolladen deaktiviert werden.
|-
|automatic-delay
|0,5,10,15,<BR/>20,30,45,60
|0
|Dieses Attribut wird nur für die Modulerweiterung 44_ROLLADEN_Automatic benötigt.
Hiermit kann eine Zeitverzögerung für den Rolladen eingestellt werden, werden die Rolladen per Automatic heruntergefahren, so wird dieser um die angegebenen Minuten später heruntergefahren.
|}

=== Settings ===

<code>set <name> closed</code> Fährt das Rollo komplett herunter

<code>set <name> open</code> Fährt das Rollo komplett nach oben

<code>set <name> half</code> Fährt das Rollo auf Position 50

<code>set <name> position <value></code> Fährt das Rollo auf die angegebene Position

<code>set <name> stop</code> Stoppt ein fahrendes Rollo.

<code>set <name> <toggle></code> Fährt das Rollo in die entgegengesetzte Richtung wie beim letzten mal bis zur jeweiligen Endposition.
Fährt das Rollo gerade, wird es zuerst gestoppt und danach ebenfalls in die entgegengesetzte Richtung gefahren.

<code>set <name> extern [open|closed|stop]</code> Startet alle Berechnungen und internen Timer im Modul, aktiviert aber nicht die konfigurierte Hardware (nützlich wenn diese bereits aktiviert wurde, um den Status der Oberfläche mit dem Ist-Zustand synchron zu halten. siehe auch [[#Zusammenspiel mit externem Taster]])

<code>set <name> reset [open|closed] </code> Setzt den internen Status des Rollo auf offen bzw. geschlossen ohne irgendwelche weiteren Aktionen durchzuführen.

<code>set <name> blocked<value></code> Aktiviert die Blockiert-Sperre abhänging vom Attribut blockMode kann das Rollo danach nur noch eingeschränkt gefahren werden

<code>set <name> unblocked</code> Deaktiviert die Blockiert-Sperre wieder, das Rollo kann wieder komplett in alle Positionen gefahren werden.

=== Readings ===
{|class="wikitable"
|-
!Name !!Wert !!Beschreibung
|-
|command||open,stop,closed||
|-
|desired_position||0-100||Zielposition die angefahren werden soll (nur sinnvoll während das Rollo fährt)
|-
|drive-type||modul,extern||bei dem Befehl "set rollo extern .." wird dieses attribut auf "extern" gestellt, sonst immer "modul"
|-
|last_drive||drive-up,drive-down||die zuletzt benutzte Fahrtrichtung
|-
|position||0-100||exakte Position des Rollo
|-
|state||open,closed,position-[0-100]||die Position gerundet auf ganze 10% Schritte, identisch mit dem Internal STATE
|}

== Anwendungsbeispiele ==
===Set===
set RolladenWohnzimmer position 50
set RolladenWohnzimmer geschlossen
set RolladenWohnzimmer offen
Drei Beispiele das Rollo-Modul anzuweisen verschiedene Positionen anzufahren.

set RolladenWohnzimmer extern stop
Das Rollo-Modul wird angewiesen den status auf "nicht fahren" zu setzen, die aktuelle Rollo-Position zu berechnen und als neue Position abzuspeichern. Der eigentliche Rollo-Stop-Befehl wird dabei aber nicht gesendet.

set RolladenWohnzimmer reset closed
In der Oberfläche von fhem wird für das Rollo die Position "geschlossen" gespeichert, ohne Berechnungen durchzuführen oder Hardware zu steuern. Wird evtl. benötigt wenn der Ist-Status von den Soll-Werten aus fhem abweicht.

===Zusammenspiel mit externem Taster===
In einem Anwendungszenario hat ein Nutzer zusätzliche Taster an seinem Rollo-Motor über die er ihn ebenfalls steuern kann.
Die Taster selber senden keine Events an fhem, nur der Rollo-Motor.
Hier ein Beispiel wie das ganze für aussehen könnte und diese Taster in das ROLLO-Modul integriert werden:

define rollo_manuell_auf DOIF ([meinRollo_Kanal1] eq "on" and [meinRolloModul] ne "drive-up") (set meinRolloModul extern open) DOELSEIF ([meinRollo_Kanal1] eq "off" and [meinRolloModul] eq "drive-up") (set meinRolloModul extern stop)
define rollo_manuell_ab DOIF ([meinRollo_Kanal2] eq "on" and [meinRolloModul] ne "drive-down") (set meinRolloModul extern closed) DOELSEIF ([meinRollo_Kanal2] eq "off" and [meinRolloModul] eq "drive-down") (set meinRolloModul extern stop)

meinRollo_Kanal1 und meinRollo_Kanal2 sind die Hardwarekanäle die in dem Rollo-Modul zum hochfahren/runterfahren benutzt werden.
Das erste DOIF prüft ob das Rollo hoch fährt, ohne das das Rollo-Modul davon etwas weis. Ist dem so wird dem Rollo Modul mithilfe des set <extern> mitgeteilt das das Rollo bereits gestartet wurde. Das Modul fängt an die Zeit zu zählen und aktualisiert den Status der Oberfläche auf "fahre hoch".
IM DOELSEIF wird abgefragt ob das Rollo steht, obwohl das Modul denkt das Rollo würde noch fahren. Ist dem so wird wieder mithilfe des set <extern> dem Modul mitgeteilt das das Rollo gestoppt wurde. Das Modul berechnet nun aufgrund der gefahrenen Zeit die aktuelle Position und aktualisiert den Status der Oberfläche auf die Position.

Das gleiche wird dann im zweiten DOIF nochmal für das herunterfahren gemacht.

Man kann nun das Rollo sowohl über die Oberfläche als auch per Taster bedienen und fhem und der reale Ist-Status sind synchron. Ach eine gleichzeitige Bedienung ist möglich, Das Rollo startet z.B. aufgrund einer Automatisierung morgens zum hochfahren und man klickt schnell auf den Taster neben dem Bett und stoppt das ganze wieder.

== Links ==
Thread im {{Link2Forum|Topic=47202|LinkText=Forum}} mit der jeweils aktuellen Version des Moduls als Anhang im ersten Beitrag.

ROLLO

2017-01-06T10:37:28Z

ThomasRamm: /*Beschreibungen auf aktuelle Version angepasst */

{{SEITENTITEL:ROLLO}}
{{Infobox Modul
|ModPurpose=Rollo-Steuerung zur einfachen Anzeige/Programmierung
|ModType=x
|ModFTopic=47202


|ModForumArea=Codeschnipsel
|ModTechName=44_ROLLO.pm
|ModOwner=ThomasRamm}}
Das Modul [[ROLLO]] bietet eine einfache Möglichkeit, mit ein bis zwei Relais den Hoch-/Runterlauf eines Rolladen zu steuern und punktgenau anzuhalten. Außerdem wird die aktuelle Position in fhem abgebildet.
Über welche Hardware/Module die Ausgänge angesprochen werden ist dabei egal.
__TOC__
Das Modul unterstützt beliebige Konfigurationen welche Befehle ausgeführt werden müssen um die Hardware des Rollos zu steuern.

* Die Rollo-Position wird in 10%-Schritten von 0% (offen) bis 100% (geschlossen) zwischengespeichert um auf der Oberfläche für jede Position ein Icon festlegen zu können.

[[Datei:Rolladen Eintrag.PNG|right|thumb|400px|Verschiedene Ansichten des Rollo:offen, fährt gerade herunter, position 50, fährt gerade hoch, geschlossen]]
Vorteil dieses Moduls:

Ist ein Rollo mit diesem Modul definiert kann man auf der Oberfläche per Klick das Rollo hoch/runter oder auf eine bestimmte Position fahren. Der aktuelle Status des Rollo (fährt hoch/runter,offen,geschlossen,etc.) wird angezeigt.
Die Oberflächenicons werden per devStateIcon gesteuert, Icons und Farben können für jeden Status individuell formatiert werden, die Standard Kommandos auf der Oberfläche (hier: offen, geschlossen, schlitz, Position) können ebenfalls per Attribut angepasst werden. Das Status-Icon ist anklickbar.
Beim Anlegen des Moduls werden die Attribute zur Darstellung in fhem mit Standardwerten angelegt, so dass man sich einiges an Tipparbeit sparen kann, aber trotzdem die Möglichkeit hat die Darstellung individuell anzupassen.

== Voraussetzungen ==
Das eigentliche ansteuern des Rollo muss mit FHEM Befehlen ausführbar sein, diese Modul ist "nur" eine Oberfläche/Bedienmodul, kein Hardwaremodul.

== Anwendung ==
=== Define ===
define <name> ROLLO

=== Attribute ===
{|class="wikitable"
|-
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung
|-
|type|| normal,HomeKit || ||Typunterscheidung zur unterstützung verschiedener Hardware. Abhängig vom gewählten Typ wird die Richtung von der die Position gerechnet wird festgelegt:<BR/>
normal = Position 0 ist offen, Position 100 ist geschlossen<BR/>
HomeKit = Position 100 ist offen, Position 0 ist geschlossen
|-
|secondsDown|| Ganzzahl || || Sekunden die das Rollo benötigt um einmal komplett hoch zu fahren
|-
|secondsUp|| Ganzzahl || || Sekunden die das Rollo benötigt um einmal komplett runter zu fahren
|-
|excessTop|| Ganzzahl || || Zeit die dein Rollo nach dem Hochfahren noch weiter fahren muss ohne das sich die Rollo-Position ändert (bei mir fährt der Rollo noch in die Wand, ohne das man es am Fenster sieht, die Position ist also schon bei 0%)
|-
|excessBottom|| Ganzzahl || || Zeit die dein Rollo nach dem Runterfahren noch weiter fahren muss ohne das sich die Rollo-Position ändert (Nachlaufzeit)
|-
|switchTime|| Ganzzahl || || Zeit die zwischen 2 gegensätzlichen Laufbefehlen pausiert werden soll, also wenn der Rollo z.B. gerade runter fährt und ich den Befehl gebe hoch zu fahren, dann soll 1 sekunde gewartet werden bis der Motor wirklich zum stillstand kommt, bevor es wieder in die andere Richtung weiter geht. Diese Zeitangabe hat nichts mit der eigentlichen Laufzeit des Motors zu tun.
|-
|resetTime|| Ganzzahl || ||Zeit die beim Anfahren von Endpositionen (offen,geschlossen) der Motor zusätzlich an bleiben soll um sicherzustellen das die Endposition wirklich angefahren wurde. Dadurch können Differenzen in der Positionsberechnung korrigiert werden.
|-
|reactionTime|| Ganzzahl || ||Zeit für den Motor zum reagieren. bei jedem Fahrbefehl wird diese Zeit zusätzlich eingeplannt ohne das die Position geändert wird, für "träge" Motoren.
|-
|autoStop|| 0,1 || || Bei autoStop=1 wird kein Stop-Befehl gesendet
|-
|commandUp|| Text || || fhem Befehl der ausgeführt werden muss um das Rollo hoch zu fahren.
|-
|commandUp2|| Text || || Platz für einen zweiten fhem Befehl
|-
|commandUp3|| Text || || Platz für einen dritten fhem Befehl
|-
|commandDown|| Text || || fhem Befehl der ausgeführt werden muss um das Rollo runter zu fahren.
|-
|commandDown2|| Text || || Platz für einen zweiten fhem Befehl
|-
|commandDown3|| Text || || Platz für einen dritten fhem Befehl
|-
|commandStopUp|| Text || || Befehl der zum Stoppen ausgeführt wird,wenn der Rollo gerade hochfährt. Wenn nicht definiert wird commandStop ausgeführt
|-
|commandStopDown|| Text || || Befehl der zum stoppen ausgeführt wird, wenn der Rollo gerade herunterfährt. Wenn nicht definiert wird commandStop ausgeführt
|-
|commandStop|| Text || || Befehl der zum Stoppen ausgeführt wird, sofern nicht commandStopDown bzw. commandStopUp definiert sind
|-
|blockMode||blocked,force-open,force-closed,only-up,only-down,half-up,half-down,none|| none || durch dieses Attribut können andere Befehle in FHEM festlegen was mein Rollo machen darf (z.B. bei gekipptem Fenster darf es nicht heruntergefahren wreden):<BR/>
blocked = Rollo lässt sich nicht mehr bewegen<BR/>
force-open = bei einem beliebigen Fahrbefehl wird Rollo hochgefahren<BR/>
force-closed = bei einem beliebigen Fahrbefehl wird Rollo runtergefahren<BR/>
only-up = Befehle zum runterfahren werden ignoriert<BR/>
only-down = Befehle zum hochfahren werden ignoriert<BR/>
half-up = es werden nur die Positionen 50-100 angefahren, bei Position <50 wird Position 50% angefahren,<BR/>
half-down = es werden nur die Positionen 0-50 angefahren, bei Position >50 wird Position 50 angefahren<BR/>
none = block-Modus ist deaktiviert<BR/>
|-
|automatic-enabled
| on,off
| on
|Dieses Attribut wird nur für die Modulerweiterung 44_ROLLADEN_Automatic benötigt.
Hiermit kann die automatische Szenariensteuerung für diesen Rolladen deaktiviert werden.
|-
|automatic-delay
|0,5,10,15,<BR/>20,30,45,60
|0
|Dieses Attribut wird nur für die Modulerweiterung 44_ROLLADEN_Automatic benötigt.
Hiermit kann eine Zeitverzögerung für den Rolladen eingestellt werden, werden die Rolladen per Automatic heruntergefahren, so wird dieser um die angegebenen Minuten später heruntergefahren.
|}

=== Settings ===

<code>set <name> closed</code> Fährt das Rollo komplett herunter

<code>set <name> open</code> Fährt das Rollo komplett nach oben

<code>set <name> half</code> Fährt das Rollo auf Position 50

<code>set <name> position <value></code> Fährt das Rollo auf die angegebene Position

<code>set <name> stop</code> Stoppt ein fahrendes Rollo.

<code>set <name> <toggle></code> Fährt das Rollo in die entgegengesetzte Richtung wie beim letzten mal bis zur jeweiligen Endposition.
Fährt das Rollo gerade, wird es zuerst gestoppt und danach ebenfalls in die entgegengesetzte Richtung gefahren.

<code>set <name> extern [open|closed|stop]</code> Startet alle Berechnungen und internen Timer im Modul, aktiviert aber nicht die konfigurierte Hardware (nützlich wenn diese bereits aktiviert wurde, um den Status der Oberfläche mit dem Ist-Zustand synchron zu halten. siehe auch [[#Zusammenspiel mit externem Taster]])

<code>set <name> reset [open|closed] </code> Setzt den internen Status des Rollo auf offen bzw. geschlossen ohne irgendwelche weiteren Aktionen durchzuführen.

<code>set <name> blocked<value></code> Aktiviert die Blockiert-Sperre abhänging vom Attribut blockMode kann das Rollo danach nur noch eingeschränkt gefahren werden

<code>set <name> unblocked</code> Deaktiviert die Blockiert-Sperre wieder, das Rollo kann wieder komplett in alle Positionen gefahren werden.

=== Readings ===
{|class="wikitable"
|-
!Name !!Wert !!Beschreibung
|-
|command||open,stop,closed||
|-
|desired_position||0-100||Zielposition die angefahren werden soll (nur sinnvoll während das Rollo fährt)
|-
|drive-type||modul,extern||bei dem Befehl "set rollo extern .." wird dieses attribut auf "extern" gestellt, sonst immer "modul"
|-
|last_drive||drive-up,drive-down||die zuletzt benutzte Fahrtrichtung
|-
|position||0-100||exakte Position des Rollo
|-
|state||open,closed,position-[0-100]||die Position gerundet auf ganze 10% Schritte, identisch mit dem Internal STATE
|}

== Anwendungsbeispiele ==
===Set===
set RolladenWohnzimmer position 50
set RolladenWohnzimmer geschlossen
set RolladenWohnzimmer offen
Drei Beispiele das Rollo-Modul anzuweisen verschiedene Positionen anzufahren.

set RolladenWohnzimmer extern stop
Das Rollo-Modul wird angewiesen den status auf "nicht fahren" zu setzen, die aktuelle Rollo-Position zu berechnen und als neue Position abzuspeichern. Der eigentliche Rollo-Stop-Befehl wird dabei aber nicht gesendet.

set RolladenWohnzimmer reset closed
In der Oberfläche von fhem wird für das Rollo die Position "geschlossen" gespeichert, ohne Berechnungen durchzuführen oder Hardware zu steuern. Wird evtl. benötigt wenn der Ist-Status von den Soll-Werten aus fhem abweicht.

===Zusammenspiel mit externem Taster===
In einem Anwendungszenario hat ein Nutzer zusätzliche Taster an seinem Rollo-Motor über die er ihn ebenfalls steuern kann.
Die Taster selber senden keine Events an fhem, nur der Rollo-Motor.
Hier ein Beispiel wie das ganze für aussehen könnte und diese Taster in das ROLLO-Modul integriert werden:

define rollo_manuell_auf DOIF ([meinRollo_Kanal1] eq "on" and [meinRolloModul] ne "drive-up") (set meinRolloModul extern open) DOELSEIF ([meinRollo_Kanal1] eq "off" and [meinRolloModul] eq "drive-up") (set meinRolloModul extern stop)
define rollo_manuell_ab DOIF ([meinRollo_Kanal2] eq "on" and [meinRolloModul] ne "drive-down") (set meinRolloModul extern closed) DOELSEIF ([meinRollo_Kanal2] eq "off" and [meinRolloModul] eq "drive-down") (set meinRolloModul extern stop)

meinRollo_Kanal1 und meinRollo_Kanal2 sind die Hardwarekanäle die in dem Rollo-Modul zum hochfahren/runterfahren benutzt werden.
Das erste DOIF prüft ob das Rollo hoch fährt, ohne das das Rollo-Modul davon etwas weis. Ist dem so wird dem Rollo Modul mithilfe des set <extern> mitgeteilt das das Rollo bereits gestartet wurde. Das Modul fängt an die Zeit zu zählen und aktualisiert den Status der Oberfläche auf "fahre hoch".
IM DOELSEIF wird abgefragt ob das Rollo steht, obwohl das Modul denkt das Rollo würde noch fahren. Ist dem so wird wieder mithilfe des set <extern> dem Modul mitgeteilt das das Rollo gestoppt wurde. Das Modul berechnet nun aufgrund der gefahrenen Zeit die aktuelle Position und aktualisiert den Status der Oberfläche auf die Position.

Das gleiche wird dann im zweiten DOIF nochmal für das herunterfahren gemacht.

Man kann nun das Rollo sowohl über die Oberfläche als auch per Taster bedienen und fhem und der reale Ist-Status sind synchron. Ach eine gleichzeitige Bedienung ist möglich, Das Rollo startet z.B. aufgrund einer Automatisierung morgens zum hochfahren und man klickt schnell auf den Taster neben dem Bett und stoppt das ganze wieder.

== Links ==
Thread im {{Link2Forum|Topic=47202|LinkText=Forum}} mit der jeweils aktuellen Version des Moduls als Anhang im ersten Beitrag.

Kategorie:Siemens PLC

2016-08-29T16:43:08Z

ThomasRamm: Beschreibung/Definition Siemens PLC

'''Siemens PLC''' ist der Oberbegriff für Speicherprogrammierbare Steuerungen (SPS) der Firma Siemens. Hierbei handelt es sich um komplette Steuerungssysteme die mit einer speziellen Sprache (z.B. Step 7) programmiert werden können. Man kann diese Systeme autark arbeiten lassen und FHEM z.B. für die Visualisierung oder als Verbindungsmodul zu andern Systemen benutzen, oder aber die Logik komplett von FHEM übernehmen lassen und die PLC nur noch als Ein- Ausgangsmodule nutzen.

Hier werden Module aufgelistet die eine Verbindung von FHEM mit einer Siemens PLC Steuerung ermöglichen.<BR/>
Die Module [[Siemens S5]] und [[LOGO - Das Logikmodul|Logo]] werden nicht mehr weiterentwickelt.<BR/>
Das Modul [[S7]] unterstützt aber auch die Siemens S5 sowie die Siemens Logo.
[[Kategorie:Hardware]]

Kategorie:Siemens PLC

2016-08-29T16:35:26Z

ThomasRamm:

Hier werden Module aufgelistet die eine Verbindung von FHEM mit einer Siemens PLC Steuerung ermöglichen.
Die Module [[Siemens S5]] und [[Logo]] werden nicht mehr weiterentwickelt.
Das Modul [[S7]] unterstützt aber inzwischen auch die Siemens S5 sowie die Siemens Logo.
[[Kategorie:Hardware]]

Benutzer Diskussion:Krueuw

2016-08-09T20:27:47Z

ThomasRamm: Neuer Abschnitt /* */ Seitenkategorien */ */

== Willkommen! ==
{| width="100%" cellspacing="0" cellpadding="6" style="line-height: 20px; background: #E0E0E0; border: 2px solid #1874CD;"
|-
| colspan="4" style="background:#1874CD;" |<big><span style="color: #FAFAFA">'''Hallo Krueuw,''' willkommen im FHEM Wiki!</span></big>
|-
| colspan="4" | Danke für dein Interesse an unserem Projekt, ich freue mich schon auf deine weiteren Beiträge. Die folgenden Seiten sollten dir die ersten Schritte erleichtern, bitte nimm dir daher etwas Zeit, sie zu lesen.

----
'''FHEM-spezifische Informationen'''

|-
| width="8%" |  
| width="38%" | '''[[Systemübersicht]]'''<br />''FHEM Systemübersicht''
| width="8%" |  
| width="38%" | '''[[FHEMWiki:Über FHEMWiki]]'''<br />''Informationen über dieses Wiki''

|-
| colspan="4" |
----
'''Generelle Informationen über (Media)Wikis'''
|-
| width="8%" | [[Datei:Crystal Clear app kedit.svg|rechts|30px|link=Hilfe:Bearbeiten]]
| width="38%" | '''[[Hilfe:Bearbeiten]]'''<br />''Zugang zu allen wichtigen Informationen.''
| width="8%" | [[Datei:X-office-presentation.svg|rechts|30px|link=Wikipedia:Tutorial]]
| width="38%" | '''[http://de.wikipedia.org/wiki/Wikipedia:Tutorial Wikipedia:Tutorial]'''<br />''Schritt-für-Schritt-Anleitung für Einsteiger.''
|-
| [[Datei:Applications-system.svg|rechts|30px|link=Wikipedia:Grundprinzipien]]
| '''[http://de.wikipedia.org/wiki/Wikipedia:Grundprinzipien Wikipedia:Grundprinzipien]'''<br />''Die grundlegende Philosophie unseres Projekts.''
| [[Datei:MentorenProgrammLogo-7.svg|rechts|60px|link=Wikipedia:Mentorenprogramm]]
| '''[http://de.wikipedia.org/wiki/Wikipedia:Mentorenprogramm Wikipedia:Mentorenprogramm]'''<br />''Persönliche Einführung in die Beteiligung bei Wikipedia.''
|-
| colspan="4" |
----
Bitte beachte, [http://de.wikipedia.org/wiki/Wikipedia:Was_Wikipedia_nicht_ist was Wikipedia nicht ist], und "unterschreibe" deine Diskussionsbeiträge durch Eingabe von <code>--<nowiki>~~~~</nowiki></code> oder durch Drücken der Schaltfläche [[Datei:button_sig.png|Signaturknopf|20px|link=Hilfe:Signatur]] über dem Bearbeitungsfeld. Artikel werden jedoch nicht unterschrieben, und wofür die Zusammenfassungszeile da ist, erfährst du unter [http://de.wikipedia.org/wiki/Hilfe:Zusammenfassung_und_Quellen Zusammenfassung und Quellen]. <br /><br />
[[Datei:Nuvola apps ksirc.png|25px|link=Benutzer Diskussion:Ph1959de]]    '''Hast du Fragen an mich?''' Schreib mir auf [[Benutzer Diskussion:Ph1959de|<u>meiner</u> Diskussionsseite]]! Viele Grüße, [[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 16:01, 19. Feb. 2016 (CET)
|}

== Aufnahme Deiner Artikel in Kategorien ==

Hallo Krueuw,<BR>
zunaechst vielen Dank für Deine aktive Mitarbeit am Wiki.
Könntest Du Dir bitte einmal Gedanken zur Kategorisierung Deiner Artikel machen. Bisher sind alle Deine Artikel keiner Kategorie zugeordnet [[Spezial:Nicht_kategorisierte_Seiten]] und auch die Namensgebung der Artikel gibt mir keinen Hinweis, wie die Strukturierung im Wiki erfolgen soll. Ansonsten haette ich schon Kategorien hinzugefügt. Ohne Einbindung in die Wiki-Strukturen werden Deine Artikel schlecht gefunden.
Gruß, --[[Benutzer:Krikan|Christian]] ([[Benutzer Diskussion:Krikan|Diskussion]]) 20:27, 4. Aug. 2016 (CEST)

Hallo Christian,

das Problem ist folgendes: Ich habe bisher versucht am S5-Modul von ThomasRamm mitzuarbeiten. Der scheint aber das Interesse als Maintainer verloren zu haben. Auf meine Anregeung hin hat charlie71 die Simatic S5 Unterstützung in sein offizielles S7-Modul integriert. Das Teil funktioniert bei mir, jetzt sollen sich andere Leute beteiligen können. Er hat vorgeschlagen, das im S5-Forum abzuwickeln und ich soll mich um die neuen Funktionen kümmern.

Die S5-Seiten von ThomasRamm und mir sind ja nun mittelfristig obsolet, zumindest wenn es planmäßig weiter geht. Genauso ist klar ist, dass die jetzt für das neue S7-Modul geschriebenen Seiten mittelfristig ins S7-Wiki gehören. Da sollte aber der Maintainer erst zustimmen. Ich vermute das dauert bis zur endgültigen Fertigstellung.

Schreib, was du in dieser Situation von mir erwartest und wie ich das dann machen muss.

Gruß Uwe
<HR>
:Hallo Uwe!

:Entscheiden darfst/musst Du; es ist schließlich Deine Arbeit und Du hast dort den Durchblick. Ich nicht. Habe keine Ahnung von S5 :-)

:Liest sich so, als würdest Du Deine S5-Seiten zum S5-Modul mittelfristig als Löschkandidaten sehen. Dabei sehen die nach viel Arbeit aus, aber wenn es überflüssig ist, brauchen wir uns evtl. keine Gedanken über Kategorien machen!? S5-Modulseite von ThomasRamm würde ich erst mal so lassen. Modul existiert und evtl. kommt spaeter ein neuer Maintainer.

:Ob Du direkt im S7-Wiki schreiben sollst/darfst, was ich persönlich bevorzugen würde (aber ich bin nicht ausschlaggebend), solltest Du bei Bedenken direkt mit charlie71 abklaeren. Mich persönlich stört es nicht, wenn in von mir begonnen Artikeln andere mitarbeiten, sondern es freut mich eher.

:Also Du darfst machen, was Du magst. Ich erwarte nichts und müssen musst Du nichts ;-) . Wir können die S5-Artikel von Dir angesichts der für mich jetzt verstaendlichen Sonderumstaende gerne erst einmal ohne Kategorie lassen, wenn keine gegenteiligen Meinungen von anderen kommen.

:Gruß, --[[Benutzer:Krikan|Christian]] ([[Benutzer Diskussion:Krikan|Diskussion]]) 21:22, 4. Aug. 2016 (CEST)

ok, die Richtung ist klar, kann dann nur noch etwas dauern ;-)

<HR>
::Hallo Uwe!<BR>
::Habe (frecherweise) in die "alten" S5-Seiten Hinweise zum "Wartezustand" eingefügt. Bitte kontrolliere, ob das in Deinem Sinne ist und ich nicht etwas falsch verstanden habe. Kannst Du ggfs. gerne selbst ::berichtigen bzw. rückgängig machen.<BR>
::Danke und Gruß, --[[Benutzer:Krikan|Christian]] ([[Benutzer Diskussion:Krikan|Diskussion]]) 10:09, 5. Aug. 2016 (CEST)

danke, sehr gut! Uwe

<HR>
Hallo Christian,

ich möchte gerne Teile der alten S5-wiki-Seite (die ich geschrieben habe) recyclen und habe vor die entsprechenden Teile per Kopieren/einfügen in den neuen Zusammenhang S7-S5 zu bringen. Ein Verschieben ist m.E. unmöglich, da ja das Meiste von ThomasRamm stammt. Für die separaten Seiten habe ich z.Z. keine Verwendung. Wäre das ok?

Uwe

:Hallo Uwe!
:Wenn Du nur Teile der eigenen Artikel brauchst, würde ich den copy/paste Weg nehmen. Bitte markiere die alten Seiten mit der Vorlage <nowiki>{{Löschkandidat|Grund}}</nowiki>, wenn Du alles Wichtige überführt hast, damit die anschließend weg kommen und nicht verwirren.
:Eigene Seiten, würde ich Verschieben, wenn das Meiste wiederverwendet wird.
:Die Modulseite von ThomasRamm bitte nicht verschieben. Das Modul wird ja (derzeit) nur nicht weiterentwickelt.
:Mir fehlt noch ein wenig der Überblick, wie Du hinterher strukturieren möchtest. Darum bin ich etwas unsicher mit weiteren Vorschlaegen. Sollen alle neuen S5 Artikel in eine (neue) Kategorie? Evtl. waere auch ein gleiches Suffix bei den Artikelnamen zur Strukturierung überlegenswert. Momentan ergibt sich aus den Artikelnamen nicht immer, um welches System es geht.
:Gruß, Christian (der hier auch nichts zu bestimmen hat ;-) )

Hallo Christian,

das mit der Struktur ist mir noch nicht ganz klar. Ich dachte an eine Seitenhierachie mit Hauptartikel zum S5-Teil des S7-Moduls und dann untergeordnete Seiten zu den unterschiedlichen Themen. Wenn ich das richtig verstehe, soll auch jede Seite für sich stehen können? und der Zusammenhang durch Teile des Seitennamens erzeugt werden (Präfix)? Wie und wo werden Kategorien festgelegt, welche gibt es und wozu werden sie verwendet? Was müsste ich da lesen?

Gruß Uwe

:Hallo Uwe!
:Die derzeitige Kategorienstruktur von FHEMwiki mit ein wenig Erlaeuterung findest Du unter [[FHEMWiki:%C3%9Cber_FHEMWiki#Kategoriestruktur_.2F_-konzept]]. Jeder Artikel sollte einer bzw. mehreren vorhanden Kategorien zugeordnet werden. Das ist quasi ein Strukturierungsmittel im Wiki. Wenn es -wie bei Dir- um Hardwaresystem geht, gibt es für jedes System mit mehreren Artikeln eine Kategorie in die die Artikel aufgenommen werden. Beispielsweise unter [[:Kategorie:EnOcean_Components]] sind alle Artikel zu EnOcean zusammengefasst. Es gibt einen "übergeordneten" Artikel "EnOcean Starter Guide", der in der Kategorienübersicht als Einstiegsartikel deklariert ist. Die anderen sind untergeordnet, was man aber nicht in der Kategorienzuordnung erkennt. Ein Hardwaresystem mit nur einem Artikel landet in der Kategorie "Other Components".
:Kategorie NAME wird bspw. durch Aufnahme des Tags in einen Artikel angelegt <nowiki>[[Kategorie:NAME]]</nowiki> und alle anderen Artikel durch Aufnahme des Tags der Kategorie zugeordnet. Kategorien-Neuanlage bitte vorher kurz abstimmen.
:Bei Deinem bisherigen Seiten bin ich mir nicht im Klaren, ob es im Fazit nicht nur 1 Einstiegsartikel ist, der in mehrere Seiten untergliedert wurde. Wenn das zutrifft, wird es meiner Meinung nach durch die Aufteilung in mehrere Seiten unübersichtlich. Aber das ist nur meine persönliche Meinung. Letztlich sollte mMn jede Seite irgendwie schon für sich stehen. Wobei ich auch Deinen Weg nachvollziehen kann.
:Gruß, --[[Benutzer:Krikan|Christian]] ([[Benutzer Diskussion:Krikan|Diskussion]]) 15:20, 7. Aug. 2016 (CEST)

Hallo Christian,

ok werde ich mir durchlesen. Inzwischen habe ich offenbar ThomasRamm mit einer PN geweckt und er hat als Abschiedsvorstellung die Formatierungen und Strukturen in seinem und wahrscheinlich im Sinne von FHEM geändert. Auf jeden Fall stimmt er zu, die alten Seiten von ihm mit dem Erscheinen der offiziellen Variante des neuen Treibers zu löschen.

Gruß uwe

:Hallo Uwe!
:Ja, ich war/bin ein wenig verwundert über die vielen strukturellen Veraenderungen. Zudem passt das nicht zu dem, was ich bisher von Deinen Ausführungen verstanden hatte: Jetzt sind doch alte mit neuen Inhalten ohne Überarbeitung einfach nur zusammengeführt!? Ob es im Sinne von FHEM ist, kann ich nicht beurteilen. Letztlich bist Du derjenige, der die Seiten erstellt hat und pflegt. Füge am Besten auf Seiten, die Du gerade bearbeitest, die Vorlage <nowiki>{{Baustelle}}</nowiki> ein. Dann sollte jeder sofort erkennen, dass Du gerade daran arbeitest und so etwas wird verhindert. Mir fehlt nach den Aenderungen und Verschiebungen leider endgueltig der Überblick. Mir ist nur klar, dass ich die S5, S7 - Seiten, wenn Du mehrere behalten möchtest, derzeit am liebesten in eine Kategorie unter Hardware packen würde; nur der Name ist mir noch unklar.
:Gruß, Christian
War auch nicht mit mir abgesprochen - ich hab ihm danach geschrieben, einen Zuordnungsfehler zu beseitigen und Kategorien in Absprache mit dir einzusetzen. Ich lass das jetzt auf jeden Fall so, sonst wird man ja irre ;-)

:Hallo Uwe!
:Braucht er nicht mit mir abzustimmen, sondern eher mit Dir ;-). Du bist doch derjenige, der (hoffentlich) an den Artikeln weiterarbeitet.
:Mein Vorschlag für alle S5, S7 und Logo-Artikel ist die Einrichtung einer Unterkategorie zu Hardware mit dem Titel Simatic_Components, wenn die Aufteilung auf mehrere separate Artikel auch zukünftig erhalten bleiben soll. Contra ist aber auch willkommen.
:Gruß, --[[Benutzer:Krikan|Christian]] ([[Benutzer Diskussion:Krikan|Diskussion]]) 13:14, 8. Aug. 2016 (CEST)

== */ Seitenkategorien */ ==

Hallo, will zu dem Thema auch nochmal kurz meine Sichtweise schreiben.
Bisher waren die einzelnen Seiten sehr verwirrend, man konnte nicht immer erkennen worauf sich einzelne Seiten beziehen und was am schlimmsten war: man hat sie teilweise nicht gefunden.
Deshalb habe ich als ersten Schritt die Seiten untereinander besser verlinkt und die Seitennamen angepasst so das immer hervorgeht um welches Modul es sich handelt. Die Seiten sind jetzt schon mal viel übersichtlicher.

Aktuell gibt es jetzt nur noch folgende Seiten:
*Siemens S5 (Original Modul-Seite)
*Siemens S5 Beispielkonfiguration einer S5-95U (Beispiele zu meinem Modul, verfasst von Uwe)
*Siemens S5 Vorbemerkungen für Einsteiger

*S7 (Original Modul-Seite)
*S7 Beispielkonfiguration (Beispiel zum Modul, verfasst von Uwe)
*S7 S5-Support (Beschreibt die Erweiterung des S7 Moduls, verfasst von Uwe)

*LOGO - Das Logikmodul (weiteres Modul für Siemens PLC von John)

Wenn das S7 Modul zukünftig auch für die S5 (Vorgänger der S7) nutzbar ist, gibt es zwei Module die das gleiche können, dadurch wird mein Modul obsolet und die Seiten Siemens S5... können gelöscht werden, bzw wenigstens die Seite Siemens S5 sollte besser umgeschrieben werden (auf Benutzung des S7 Moduls).

Inhalte habe ich keine gelöscht, nur eben besser zusammengefasst.

Offen ist noch die Kategorisierung der Seiten. Deinen Vorschlag finde ich schon ganz gut aber noch nicht komplett passend.
Wir haben hier eigentlich aktuell 3 Module die teilweise das gleiche tun, aber doch eigenständige Entwicklungen sind die nichts miteinander zu tun haben.
z.B. bei EnOcean_Components gehören alle Seiten zusammen da sie alle mehr oder weniger das gleiche Modul bzw. Komponenten zu diesem Modul beschreiben.
Hier haben wir 3 komplett voneinander getrennte Systeme. Da alle vom gleichen Hersteller sind würde ich sie am ehesten als "Siemens Simatic Systems" beschreiben (sind ja keine Komponenten die man zu einem großen System zusammensteckt sondern jeweils komplette Systeme).

Mit dem Modul S7 lässt sich aber auch eine Logo steuern, und (neu) auch eine S5 deshalb gehören sie dann doch wieder zusammen.
Aktuell ist das Modul S7 und das Modul LOGO in der Kategorie "Other Components" zu finden.

Mein Vorschag: Alle oben aufgeführten Seiten in folgende Kategorien einordnen:
* Siemens Simatic Systems oder Siemens Plc
* Gerätemodul (hier jeweils nur die Modul Hauptseite? ohne Beispielkonfigurationen etc.)

PS: Der oben in der Diskussion immer wieder vorkommende Gedanke "Die Seite gehört dir, die hast du geschrieben, das musst du entscheiden..." kann ich nicht ganz so teilen, bin beruflich selber Admin eines Firmenwiki und predige allen die Philosophie das jeder alles ändern soll wenn er meint das etwas verbessert werden kann. Wurde etwas nicht bedacht lässt es sich einfach wieder Rückgängig machen. Das ist wesentlich effektiver als bei dem ursprünglichen Autor nachzufragen. Die Fälle in denen etwas verschlimmbessert wurde und ich aktiv eingegriffen habe lassen sich an beiden Händen abzählen und das bei ca. 200 aktiven Benutzern pro Tag. Meine Empfehlung: [https://de.wikipedia.org/wiki/Wikipedia:Sei_mutig Sei mutig (Wikipedia Bearbeitungsregeln)]

--[[Benutzer:ThomasRamm|ThomasRamm]] ([[Benutzer Diskussion:ThomasRamm|Diskussion]]) 22:27, 9. Aug. 2016 (CEST)

Siemens S5 Beispielkonfiguration

2016-08-09T19:35:09Z

ThomasRamm: ThomasRamm verschob die Seite Siemens S5 Beispielkonfiguration nach S7 Beispielkonfiguration: versehentlich falsches Prefix vergeben

#WEITERLEITUNG [[S7 Beispielkonfiguration]]

S7 Beispielkonfiguration

2016-08-09T19:35:09Z

ThomasRamm: ThomasRamm verschob die Seite Siemens S5 Beispielkonfiguration nach S7 Beispielkonfiguration: versehentlich falsches Prefix vergeben

Dieser Artikel beschreibt eine Beispielkonfiguration für die Hardware [[S7 S5-Support|Siemens S5]].
Ausgangspunkt ist eine in 20 Jahren gewachsene S5 95U-Haussteuerung. Inzwischen wurde begonnen diese an unkritischen Stellen um eine FHEM-Anbindung zu ergänzen. Ich demonstriere die vorhandenen Möglichkeiten, indem ich meinen Arbeitsfortschritt hier dokumentiere.
__TOC__

==Status von S5-Ausgängen in FHEM anzeigen==
Bei mir wird die biologische Nachklärung des Abwassers mit einem Launhardt-Reaktor erledigt. Drei Pumpen werden durch die S5 zeitgesteuert geschaltet (A13.0 .. A13.2). In FHEM soll der Status der Ausgänge angezeigt werden. Dazu müssen nur die betreffenden Ausgänge in FHEM bekannt gemacht werden. Änderungen am S5-Programm sind nicht notwendig.

define s5test S7 S5 /dev/ttyAMA0

define Abpumpen S7_DRead outputs 0 13.0
attr Abpumpen IODev s5test
attr Abpumpen icon icoBaum
attr Abpumpen room Abwasser
attr Abpumpen sortby 03

define Umpumpen S7_DRead outputs 0 13.1
attr Umpumpen IODev s5test
attr Umpumpen icon audio_repeat
attr Umpumpen room Abwasser
attr Umpumpen sortby 02

define Zupumpen S7_DRead outputs 0 13.2
attr Zupumpen IODev s5test
attr Zupumpen icon scene_toilet_alternat
attr Zupumpen room Abwasser
attr Zupumpen sortby 01

[[File:Launhardt-web.png]]

==vorhandene S5-Lampensteuerung um FHEM ergänzen==
Das S5-Programm für das Schalten der Beleuchtung mittels Taster soll auch bei ausgefallenem FHEM funktionieren wie bisher. Dazu schaltet FHEM spezielle Merker, die dann per ODER mit den anderen Eingängen verknüpft werden, hier Merker M 65.0 (vier ergänzte Zeilen):

NETZWERK 12 Arbeitszimmer
00AC :U(
00AD :U(
00AE :O E 64.7 Taster im Arbeitszimmer
00AF :O M 65.0 Merker für FHEM
00B0 :)
00B1 :UN M 61.4 Flankenmerker
00B2 :S A 65.7 Lampe Arbeiten Giebel
00B3 :U(
00B4 :O E 64.7 Taster im Arbeitszimmer
00B5 :O M 65.0 Merker für FHEM
00B6 :)
00B7 :U M 61.4 Flankenmerker
00B8 :R A 65.7 Lampe Arbeiten Giebel
00B9 :U A 65.7 Lampe Arbeiten Giebel
00BA :)
00BB :UN E 64.7 Taster im Arbeitszimmer
00BC :UN M 65.0 Merker für FHEM
00BD :S M 61.4 Flankenmerker
00BE :UN E 64.7 Taster im Arbeitszimmer
00BF :UN M 65.0 Merker für FHEM
00C0 :UN A 65.7 Lampe Arbeiten Giebel
00C1 :R M 61.4 Flankenmerker
00C2 :NOP 0
:***
'''zugehörige FHEM-Konfiguration:'''
define s5test S7 S5 /dev/ttyAMA0 #FHEM Hardwarezugriff konfigurieren

define M65.0 S7_DWrite flags 0 65.0 #S5-Merker M65.0 für FHEM-Schreibzugriff
attr M65.0 IODev s5test #M65.0 an /dev/ttyAMA0 ist gemeint
attr M65.0 eventMap /on-for-timer 1 /trigger:tasten #1-s-Impuls außerdem Web: trigger -> tasten
attr M65.0 icon light_pendant_light #Standard-Icon ersetzen
attr M65.0 room Arbeitszimmer #Raumzuordnung zur optischen Gruppierung
attr M65.0 webCmd tasten #Button auf Weboberfläche gelabelt als "tasten"

Das Merkerbyte 65 muss für den FHEM-Schreibzugriff reserviert sein. Die Lampe kann nun zusätzlich über das Webinterface oder die Smartphone-App geschaltet werden.

==Namenskonvention für S5-FHEM-Projekt==
Um ein gewachsenes Projekt mit erträglichem Aufwand in die neue Zeit zu retten, ist es erforderlich nur systematische Änderungen vorzunehmen. Erst Änderungen exemplarisch testen und dann für alle gleichartigen Fälle übernehmen. Um dabei die Übersicht nicht zu verlieren, habe ich mich entschlossen in Anlehnung an [https://www.fischer-net.de/hausautomation/fhem/22-fhem-devicenamen.html FISCHER-NET.DE] ein Namensschema einzuführen. Die langen FHEM-Namen passen nur als Symbolik-Kommentar in die S5.

==FHEM-S5-Lampensteuerung tastbar um ein/aus ergänzen==

Bei einem Wandtaster kann entschieden werden, welchen Zustand die Lampe hat, weil man sie sieht. Anders beim Webinterface, hier wäre ein gezieltes ein- bzw. ausschalten besser, weil man eventuell entfernt handelt. Damit läßt sich auch eine zentrales Licht-AUS bzw. eine Alarmbeleuchtung mit ALLES-AN realisieren. Je ein 16-Bit-Word wird für das Tasten, das Einschalten bzw. das Ausschalten vorgesehen. Das reicht für maximal 16 Lampen. Hier also das MW164 für Tasten, MW166 für Ein und MW168 für AUS. M164.7 für das Tasten, M166.7 für EIN und M168.7 für AUS der Giebellampe. Die notwendigen Konfigurationen für weitere Lampen können so kopiert und brauchen nur minimal angepasst werden.

'''S5-Programm nochmals ergänzt'''

NETZWERK 12 Arbeitszimmer
00AC :O(
00AD :U(
00AE :U(
00AF :O -AzLiGt E64.7 Lichttaster
00B0 :O -M 164.7 M164.7 OG.Az.M1647.LaGiTast FHEM
00B1 :)
00B2 :UN -AzLaGf M61.4 Flankenmerker
00B3 :)
00B4 :O -M 166.7 M166.7 OG.Az.M1667.LaGiEin FHEM
00B5 :S -AzLaG A65.7 Lampe Arbeiten Giebel
00B6 :O(
00B7 :U(
00B8 :O -AzLiGt E64.7 Lichttaster
00B9 :O -M 164.7 M164.7 OG.Az.M1647.LaGiTast FHEM
00BA :)
00BB :U -AzLaGf M61.4 Flankenmerker
00BC :)
00BD :O -M 168.7 M168.7 OG.Az.M1667.LaGiAus FHEM
00BE :R -AzLaG A65.7 Lampe Arbeiten Giebel
00BF :U -AzLaG A65.7 Lampe Arbeiten Giebel
00C0 :)
00C1 :UN -AzLiGt E64.7 Lichttaster
00C2 :UN -M 164.7 M164.7 OG.Az.M1647.LaGiTast FHEM
00C3 :S -AzLaGf M61.4 Flankenmerker
00C4 :UN -AzLiGt E64.7 Lichttaster
00C5 :UN -M 164.7 M164.7 OG.Az.M1647.LaGiTast FHEM
00C6 :UN -AzLaG A65.7 Lampe Arbeiten Giebel
00C7 :R -AzLaGf M61.4 Flankenmerker
00C8 :NOP 0
[[File:FUP-Giebellampe.png]]

'''zugehöriger Abschnitt aus der fhem.cfg'''
define s5test S7 S5 /dev/ttyAMA0

define OG.az.M1647.LichtGtast S7_DWrite flags 0 164.7
attr OG.az.M1647.LichtGtast IODev s5test
attr OG.az.M1647.LichtGtast alias Giebellampe
attr OG.az.M1647.LichtGtast eventMap /on-for-timer 1 /trigger:tasten
attr OG.az.M1647.LichtGtast icon light_pendant_light
attr OG.az.M1647.LichtGtast room Arbeitszimmer
attr OG.az.M1647.LichtGtast webCmd tasten

define OG.az.M1667.LichtGaus S7_DWrite flags 0 166.7
attr OG.az.M1667.LichtGaus IODev s5test
attr OG.az.M1667.LichtGaus alias Giebellampe.aus
attr OG.az.M1667.LichtGaus eventMap /on-for-timer 1 /trigger:tasten
attr OG.az.M1667.LichtGaus icon light_light
attr OG.az.M1667.LichtGaus room Arbeitszimmer
attr OG.az.M1667.LichtGaus webCmd tasten

define OG.az.M1687.LichtGein S7_DWrite flags 0 168.7
attr OG.az.M1687.LichtGein IODev s5test
attr OG.az.M1687.LichtGein alias Giebellampe.an
attr OG.az.M1687.LichtGein eventMap /on-for-timer 1 /trigger:tasten
attr OG.az.M1687.LichtGein icon light_light_dim_100
attr OG.az.M1687.LichtGein room Arbeitszimmer
attr OG.az.M1687.LichtGein webCmd tasten

Das FHEM-Gerät trägt nun einen strukturierten Namen, um es leicht zuordnen zu können. Auf der grafischen Oberfläche ist dies durch die Raumzuordung überflüssig. Hier wird der Alias Giebellampe verwendet. Außerdem kann man es gezielt aus- bzw. eintasten.

'''Ergebnis'''
[[File:Giebellampe2.png]]

==FHEM-S5-Rolladensteuerung ergänzen==

In meiner S5 existiert bisher ein Programm welches nur einen Taster mit hoch - stop - runter - stop verwendet. Bei der Rolladensteuerung über das Webinterface ist es sinnvoller je einen Button für das Hochfahren, einen für das Runterfahren und einen für STOP zu konfigurieren. Wie bei der Lampenschaltung soll sich auch hier ein zentrales HOCH bzw. RUNTER für alle vorhandenen Rolläden realisieren lassen. Dazu werden in der S5 das Merkerbyte MB176 bzw. M176.3 für HOCH und MB178 bzw. M178.3 für RUNTER und MB177 bzw. M177.3 für STOP für den FHEM-Zugriff konfiguriert. Damit sind maximal acht Rollläden .0 bis .7 möglich.

'''S5-Programm'''

NETZWERK 2 RL Schlafen hoch
0012 :O(
0013 :O -XRUPS M19.2 Tasterauswertung RL Schlafen hoc
0014 :O -M 176.3 M176.3 OG.Sz.M1763.RlHo FHEM
0015 :)
0016 :UN -RDNS A10.5 Ausgang RLaden runter Schlafen
0017 :L KT 030.2
0019 :SA T 5 Timer Schlafen hoch
001A :O -RDNS A10.5 Ausgang RLaden runter Schlafen
001B :O -XRDNS M19.3 Tasterauswertung RL Schlafen run
001C :O -RStopS M19.4 RL Stop
001D :O -M 177.3 M177.3 OG.Sz.M1763.RlStop FHEM
001E :O -M 178.3 M178.3 OG.Sz.M1763.RlRu FHEM
001F :R T 5 Timer Schlafen hoch
0020 :NOP 0
0021 :NOP 0
0022 :U T 5 Timer Schlafen hoch
0023 := -RUPS A10.4 Ausgang RLaden hoch Schlafem
0024 :***

NETZWERK 3 RL Schlafen runter
0025 :O(
0026 :O -XRDNS M19.3 Tasterauswertung RL Schlafen run
0027 :O -M 178.3 M178.3 OG.Sz.M1763.RlRu FHEM
0028 :)
0029 :UN -RUPS A10.4 Ausgang RLaden hoch Schlafen
002A :L KT 030.2
002C :SA T 6 Timer Schlafen runter
002D :O -RUPS A10.4 Ausgang RLaden hoch Schlafen
002E :O -XRUPS M19.2 Tasterauswertung RL Schlafen hoc
002F :O -RStopS M19.4 RL Stop
0030 :O -M 177.3 M177.3 OG.Sz.M1763.RlStop FHEM
0031 :O -M 176.3 M176.3 OG.Sz.M1763.RlHo FHEM
0032 :R T 6 Timer Schlafen runter
0033 :NOP 0
0034 :NOP 0
0035 :U T 6 Timer Schlafen runter
0036 := -RDNS A10.5 Ausgang RLaden runter Schlafen
0037 :***

[[File:FUP-RL.png]]

Der Motorschutz-Timer sorgt dafür, dass die Stromversorgung nach der maximalen Laufzeit abgeschaltet wird.

'''zugehöriger Abschnitt aus der fhem.cfg'''
define OG.sz.M1763.RlHo S7_DWrite flags 0 176.3
attr OG.sz.M1763.RlHo IODev s5test
attr OG.sz.M1763.RlHo alias Rollladen.hoch
attr OG.sz.M1763.RlHo eventMap /on-for-timer 1 /trigger:tasten
attr OG.sz.M1763.RlHo icon rc_UP
attr OG.sz.M1763.RlHo room Schlafen
attr OG.sz.M1763.RlHo sortby 01
attr OG.sz.M1763.RlHo webCmd tasten

define OG.sz.M1773.RlStop S7_DWrite flags 0 177.3
attr OG.sz.M1773.RlStop IODev s5test
attr OG.sz.M1773.RlStop alias Rollladen.stop
attr OG.sz.M1773.RlStop eventMap /on-for-timer 1 /trigger:tasten
attr OG.sz.M1773.RlStop icon rc_REC
attr OG.sz.M1773.RlStop room Schlafen
attr OG.sz.M1773.RlStop sortby 02
attr OG.sz.M1773.RlStop webCmd tasten

define OG.sz.M1783.RlRu S7_DWrite flags 0 178.3
attr OG.sz.M1783.RlRu IODev s5test
attr OG.sz.M1783.RlRu alias Rollladen.runter
attr OG.sz.M1783.RlRu eventMap /on-for-timer 1 /trigger:tasten
attr OG.sz.M1783.RlRu icon rc_DOWN
attr OG.sz.M1783.RlRu room Schlafen
attr OG.sz.M1783.RlRu sortby 03
attr OG.sz.M1783.RlRu webCmd tasten

'''Ergebnis'''

[[File:rl-web.png]]

Der Rolladen kann nun über das Webinterface auf beliebigen Geräten gezielt geschlossen bzw. geöffnet werden.

==FHEM-S5-Bewässerungssteuerung ergänzen==

Bisher können vier Gartenschläuche mit Perlschläuchen über Magnetventile per Taster bzw. Zeitschaltung betrieben werden. Zusätzlich soll warmes Wasser zugemischt werden können, um eine Überhitzung der Dachkollektoren zu verhindern. Die Zeitschaltung ist nur äußerst unkomfortabel über einen Datenbaustein zu konfigurieren und wurde daher kaum benutzt. Im Ergebnis lief das Wasser im Garten oft unkontrolliert über viele Stunden. Ziel mit FHEM ist eine deutliche Verbesserung. Zunächst wird die Einschaltzeit per FHEM auf 90 min begrenzt.
[[File:Qe-bewaesserung.png|mini|ohne|Schaltplan der Bewässerung]]
wird fortgesetzt ..
zurück zum [[S7 S5-Support#Erfahrungen|Ausgangs-Artikel]]

S7 Beispielkonfiguration

2016-08-07T14:34:38Z

ThomasRamm: Zusammenfassung von stubs zu einem Artikel

S7 Beispielkonfiguration

2016-08-07T14:32:07Z

ThomasRamm: Zusammenfassung von stubs zu einem Artikel

Dieser Artikel beschreibt eine Beispielkonfiguration für die Hardware [[S7 S5-Support|Siemens S5]].
Beschrieben werden hier die einzelnen Schritte die zur Integration von fhem in die vorhandene S5 Programmierung unternommen wurden.

__TOC__

==vorhandene S5-Lampensteuerung um FHEM ergänzen==
Das S5-Programm für das Schalten der Beleuchtung mittels Taster und zusätzlich über FHEM:

NETZWERK 12 Arbeitszimmer
00AC :U(
00AD :U(
00AE :O E 64.7 Taster im Arbeitszimmer
00AF :O M 65.0 Merker für FHEM
00B0 :)
00B1 :UN M 61.4 Flankenmerker
00B2 :S A 65.7 Lampe Arbeiten Giebel
00B3 :U(
00B4 :O E 64.7 Taster im Arbeitszimmer
00B5 :O M 65.0 Merker für FHEM
00B6 :)
00B7 :U M 61.4 Flankenmerker
00B8 :R A 65.7 Lampe Arbeiten Giebel
00B9 :U A 65.7 Lampe Arbeiten Giebel
00BA :)
00BB :UN E 64.7 Taster im Arbeitszimmer
00BC :UN M 65.0 Merker für FHEM
00BD :S M 61.4 Flankenmerker
00BE :UN E 64.7 Taster im Arbeitszimmer
00BF :UN M 65.0 Merker für FHEM
00C0 :UN A 65.7 Lampe Arbeiten Giebel
00C1 :R M 61.4 Flankenmerker
00C2 :NOP 0
:***
zugehörige FHEM-Konfiguration:
define s5test S7 S5 /dev/ttyAMA0 #FHEM Hardwarezugriff konfigurieren
define M65.0 S7_DWrite flags 0 65.0 #S5-Merker M65.0 für FHEM-Schreibzugriff
attr M65.0 IODev s5test #M65.0 an /dev/ttyAMA0 ist gemeint
attr M65.0 eventMap /on-for-timer 1 /trigger:tasten #1-s-Impuls außerdem Web: trigger -> tasten
attr M65.0 icon light_pendant_light #Standard-Icon ersetzen
attr M65.0 room Arbeitszimmer #Raumzuordnung zur optischen Gruppierung
attr M65.0 webCmd tasten #Button auf Weboberfläche gelabelt als "tasten"

Das Merkerbyte 65 muss für den FHEM-Schreibzugriff reserviert sein. Die Lampe kann nun zusätzlich über das Webinterface oder die Smartphone-App geschaltet werden.

'''Hinweis:''' Bisher funktionieren von jedem Merkerbyte nur die ersten 4 Bit, hier also M 65.0 bis M 65.3. Die restlichen können bisher nicht benutzt werden.

==Namenskonvention für S5-FHEM-Projekt==
Um ein gewachsenes Projekt mit erträglichem Aufwand in die neue Zeit zu retten, ist es erforderlich nur systematische Änderungen vorzunehmen. Erst Änderungen exemplarisch testen und dann für alle gleichartigen Fälle übernehmen. Um dabei die Übersicht nicht zu verlieren, habe ich mich entschlossen in Anlehnung an [https://www.fischer-net.de/hausautomation/fhem/22-fhem-devicenamen.html FISCHER-NET.DE] ein Namensschema einzuführen. Allerdings unterstützt die S5 nur sieben Zeichen lange Namen. Diese werden durch sinnvolle Kürzung aus dem FHEM-Namen abgeleitet und zusätzlich im Kommentar gespeichert.

'''S5-Programm'''
NETZWERK 12 Arbeitszimmer
00AC :U(
00AD :U(
00AE :O -AzLiGt E64.7 Lichttaster
00AF :O -AzLaG M165.3 OG.Az.M653.LampeG FHEM-Merker
00B0 :)
00B1 :UN -AzLaGf M61.4 Flankenmerker
00B2 :S -AzLaG M165.3 OG.Az.M653.LampeG FHEM-Merker
00B3 :U(
00B4 :O -AzLiGt E64.7 Lichttaster
00B5 :O -AzLaG M165.3 OG.Az.M653.LampeG FHEM-Merker
00B6 :)
00B7 :U -AzLaGf M61.4 Flankenmerker
00B8 :R -AzLaG M165.3 OG.Az.M653.LampeG FHEM-Merker
00B9 :U -AzLaG M165.3 OG.Az.M653.LampeG FHEM-Merker
00BA :)
00BB :UN -AzLiGt E64.7 Lichttaster
00BC :UN -AzLaG M165.3 OG.Az.M653.LampeG FHEM-Merker
00BD :S -AzLaGf M61.4 Flankenmerker
00BE :UN -AzLiGt E64.7 Lichttaster
00BF :UN -AzLaG M165.3 OG.Az.M653.LampeG FHEM-Merker
00C0 :UN -AzLaG M165.3 OG.Az.M653.LampeG FHEM-Merker
00C1 :R -AzLaGf M61.4 Flankenmerker
00C2 :NOP 0
:***
'''zugehöriger Abschnitt aus der fhem.cfg'''
define s5test S7 S5 /dev/ttyAMA0
define OG.az.M653.LichtG S7_DWrite flags 0 165.3
attr OG.az.M653.LichtG IODev s5test
attr OG.az.M653.LichtG eventMap /on-for-timer 1 /trigger:tasten
attr OG.az.M653.LichtG icon light_pendant_light
attr OG.az.M653.LichtG room Arbeitszimmer
attr alisa Giebellampe
attr OG.az.M653.LichtG webCmd tasten

Das FHEM-Gerät trägt nun einen strukturierten Namen, um es leicht zuordnen zu können. Auf der grafischen Oberfläche ist dies durch die Raumzuordung überflüssig. Hier wird der Alias Giebellampe verwendet.

'''Ergebnis'''

[[File:Giebellampe.png]]

==FHEM-S5-Lampensteuerung tastbar um ein/aus ergänzen==
ToDo...

zurück zum [[S7 S5-Support#Erfahrungen|Ausgangs-Artikel]]

Projektvorschlag: S5 als Ein- bzw. Ausgangsklemmen für FHEM einsetzen

2016-08-07T14:26:32Z

ThomasRamm: Zusammenfassung von stubs zu einem Artikel

#redirect [[Siemens_S5_Vorbemerkungen_für_Einsteiger#Projektvorschlag: S5 als Ein- bzw. Ausgangsklemmen für FHEM einsetzen]]

Siemens S5 Vorbemerkungen für Einsteiger

2016-08-07T14:25:31Z

ThomasRamm: Zusammenfassung von stubs zu einem Artikel

==Simatic S5 - die preiswerte Alternative==
Für weniger als den Preis einer LOGO mit acht Ein- bzw. Ausgängen kann man bei der von Siemens bis 2014 mit Ersatzteilen versorgten SPS z.b. bei ebay Angebote wie [http://www.ebay.de/itm/Siemens-Simatic-S5-95U-/201621853238?hash=item2ef1995436:g:o00AAOSwAPlXhMZB dieses]mit 64 digitalen Ein- bzw. Ausgängen, acht analogen Eingängen und einem analogen Ausgang finden. Für alle Komponenten in Industriequalität gibt es ausgefeilte deutschsprachige [http://www.es.fh-mannheim.de/sp/simatic/s5.htm kostenlose Dokumentation im PDF-Format] von Siemens.

Das Problem ist eher die notwendige Programmiersoftware:
#es gibt ein preiswertes Handprogrammiergerät PG 605 mit einzeiliger Eingabe für Puristen,
#das originale DOS Programm Step5 läuft in der DOS-Box von 32-Bit-Windows oder in einer virtuellen Maschine mit DOS oder Windows für alte Hasen,
#[https://www.mhj-online.de/de-WinSPS-S5-V2-x-Profiversion WinSPS S5] von MHJ läuft unter Windows und kostet immer noch über 400 €,
#[https://www.ibhsoftec.com/epages/63444704.sf/de_DE/?ObjectPath=/Shops/63444704/Products/10018 S5 für Windows] von IBHsoftec ist die modernste Version, die unter aktuellen Windows-Versionen läuft und über 800 € kostet.
Insbesondere gibt es keine Möglichkeit freie Software oder ein Linux-Programm einzusetzen. Eventuell kann man sich einen Programmier-PC (mit Programmierer ;-) borgen und dann ein sehr minimales universelles Programm schreiben und spätere Modifikationen auf FHEM-Basis abwickeln.

==Konfiguration==
Die komplette Raspi- und S5-Konfiguration kann so benutzt werden wie im [http://www.fhemwiki.de/wiki/Siemens_S5 (veralteten) S5-Wiki] beschrieben. Punkt 5 Libnodave ist nicht mehr erforderlich und muss ausgelassen werden. Vor dem Abschnitt "Siemens S5" muss dann im S7-Wiki weitergelesen werden.

==Projektvorschlag: S5 als Ein- bzw. Ausgangsklemmen für FHEM einsetzen==

Die meisten FHEM-Installationen setzen wegen der Flexibilität eine Funklösung wie FS20 oder HomeMatic beim Schalten von Aktoren bzw. Einlesen von Sensoren ein. Eine deutlich höhere Zuverlässigkeit erreicht man mit leitungsgebundenen Geräten in Industriequalität. Die Simatic S5 könnte die Rolle einer kostengünstigen schaltbaren Klemme für FHEM ohne spezielles S5-Programm übernehmen, indem man einfach direkt mit FHEM auf den Ausgang schreibt. Hier A 4.0 als exemplarisches Beispiel:

define s5test S7 S5 /dev/ttyAMA0
define S5A4.0 S7_DWrite outputs 0 4.0
attr S5A4.0 IODev s5test
attr S5A4.0 room Arbeitszimmer

Damit kann man direkt mit:

set S5A4.0 ON bzw. set S5A4.0 OFF

den Ausgang schalten, ohne den Ausgang innerhalb der SPS dafür zu konfigurieren.

Das gleiche Verfahren ist prinzipiell für das Lesen der Eingänge möglich. Hier E 3.0 als exemplarisches Beispiel:

define S5E3.0 S7_DRead inputs 0 3.0
attr S5E3.0 IODev s5test
attr SE34.0 room Arbeitszimmer

Der Haken an dieser Art der Nutzung ist das beschränkte Zeitverhalten. Impulse von weniger als ca. 1 s Länge können nicht direkt verwendet werden, da die Verbindung zwischen FHEM und S5 im 1-s-Takt gepollt wird. Dann ist eine einfache Programmierung notwendig. Ausgangsimpulse müssen so mit Timern auf der S5 auf das gewünschte Maß gekürzt und Eingangsimpule zur sicheren Erkennung entsprechend verlängert werden. Dies gilt insbesondere für Handtaster.

Da FHEM auch mehrere SPS unterstützt, könnten diese im Haus verteilt werden und im Falle der 95U z.B. je 16 Ein- und Ausgänge zur Verfügung stellen und sind modular erweiterbar. Der Einbau ist auf Hutschiene möglich. Die Leistungsaufnahme von ein paar Watt kann durch die Verwendung von 19 Volt Laptop-Netzteilen reduziert werden.

[[File:s595u.png]]

zurück zum [[S7 S5-Support#Erfahrungen|Ausgangs-Artikel]]

S7 Beispielkonfiguration

2016-08-07T14:17:56Z

ThomasRamm: ThomasRamm verschob die Seite Vorhandene Lampensteuerung ergänzen nach Siemens S5 Beispielkonfiguration: nicht eindeutiger Seitentitel

==vorhandene S5-Lampensteuerung um FHEM ergänzen==
Das S5-Programm für das Schalten der Beleuchtung mittels Taster und zusätzlich über FHEM:

NETZWERK 12 Arbeitszimmer
00AC :U(
00AD :U(
00AE :O E 64.7 Taster im Arbeitszimmer
00AF :O M 65.0 Merker für FHEM
00B0 :)
00B1 :UN M 61.4 Flankenmerker
00B2 :S A 65.7 Lampe Arbeiten Giebel
00B3 :U(
00B4 :O E 64.7 Taster im Arbeitszimmer
00B5 :O M 65.0 Merker für FHEM
00B6 :)
00B7 :U M 61.4 Flankenmerker
00B8 :R A 65.7 Lampe Arbeiten Giebel
00B9 :U A 65.7 Lampe Arbeiten Giebel
00BA :)
00BB :UN E 64.7 Taster im Arbeitszimmer
00BC :UN M 65.0 Merker für FHEM
00BD :S M 61.4 Flankenmerker
00BE :UN E 64.7 Taster im Arbeitszimmer
00BF :UN M 65.0 Merker für FHEM
00C0 :UN A 65.7 Lampe Arbeiten Giebel
00C1 :R M 61.4 Flankenmerker
00C2 :NOP 0
:***
zugehörige FHEM-Konfiguration:
define s5test S7 S5 /dev/ttyAMA0 #FHEM Hardwarezugriff konfigurieren
define M65.0 S7_DWrite flags 0 65.0 #S5-Merker M65.0 für FHEM-Schreibzugriff
attr M65.0 IODev s5test #M65.0 an /dev/ttyAMA0 ist gemeint
attr M65.0 eventMap /on-for-timer 1 /trigger:tasten #1-s-Impuls außerdem Web: trigger -> tasten
attr M65.0 icon light_pendant_light #Standard-Icon ersetzen
attr M65.0 room Arbeitszimmer #Raumzuordnung zur optischen Gruppierung
attr M65.0 webCmd tasten #Button auf Weboberfläche gelabelt als "tasten"

Das Merkerbyte 65 muss für den FHEM-Schreibzugriff reserviert sein. Die Lampe kann nun zusätzlich über das Webinterface oder die Smartphone-App geschaltet werden.

'''Hinweis:''' Bisher funktionieren von jedem Merkerbyte nur die ersten 4 Bit, hier also M 65.0 bis M 65.3. Die restlichen können bisher nicht benutzt werden.

zurück zum [http://www.fhemwiki.de/wiki/Alternative:_Aktuelle_Entwicklerversion_der_offiziellen_FHEM-S7-Module_mit_S5-Support#Erfahrungen Ausgangs-Artikel]

Vorbemerkungen für Einsteiger

2016-08-07T14:10:45Z

ThomasRamm: ThomasRamm verschob die Seite Vorbemerkungen für Einsteiger nach Siemens S5 Vorbemerkungen für Einsteiger: Titel irreführend

#WEITERLEITUNG [[Siemens S5 Vorbemerkungen für Einsteiger]]

Siemens S5 Vorbemerkungen für Einsteiger

2016-08-07T14:10:45Z

ThomasRamm: ThomasRamm verschob die Seite Vorbemerkungen für Einsteiger nach Siemens S5 Vorbemerkungen für Einsteiger: Titel irreführend

Siemens S5 Vorbemerkungen für Einsteiger

2016-08-07T14:07:41Z

ThomasRamm: link korrigiert

ROLLO

2016-02-20T14:24:01Z

ThomasRamm: /* Define entfernt */

{{SEITENTITEL:ROLLO}}
{{Infobox Modul
|ModPurpose=Rollo-Steuerung zur einfachen Anzeige/Programmierung
|ModType=x
|ModFTopic=47202


|ModForumArea=Codeschnipsel
|ModTechName=44_ROLLO.pm
|ModOwner=ThomasRamm}}
Das Modul [[ROLLO]] bietet eine einfache Möglichkeit, mit ein bis zwei Relais den Hoch-/Runterlauf eines Rolladen zu steuern und punktgenau anzuhalten. Außerdem wird die aktuelle Position in fhem abgebildet.
Über welche Hardware/Module die Ausgänge angesprochen werden ist dabei egal.
__TOC__
Das Modul unterstützt verschiedenste Konfigurationen welche Befehle ausgeführt werden müssen um die Hardware des Rollos zu steuern.
Weitere Konfigurationen können im Forum angefragt werden.

Besonderheiten:
* Wird in einer Konfiguration ein Kanal für die Richtung, der zweite für das Aktivieren des Rollos genutzt (z.B. Typ1), wird immer vor einem Rollo-Start die Richtung gesetzt. Bei einem Richtungswechsel während der Fahrt wird der Rollo für 1 sekunde gestoppt und dann in der Gegenrichtung gestartet um den Motor zu schonen.

* Fährt das Rollo zur Position offen oder geschlossen, wird der Motor noch 5 sec. länger auf on gelassen, um Positionsverschiebungen aufgrund ungenauer Parameter auszugleichen. Bei jedem vollständigen schließen/öffnen ist die Position damit wieder korrekt.

* Die Rollo-Position wird in 10%-Schritten von 0% (offen) bis 100% (geschlossen) zwischengespeichert um auf der Oberfläche für jede Position ein Icon festlegen zu können. Die Ungenauigkeiten die dadurch zwischen echter Position und gespeicherter Position entstehen, werden durch oben angeführte Korrektur ausgeglichen.

[[Datei:Rolladen Eintrag.PNG|right|thumb|400px|Verschiedene Ansichten des Rollo:offen, fährt gerade herunter, position 50, fährt gerade hoch, geschlossen]]
Vorteil dieses Moduls:

Ist ein Rollo mit diesem Modul definiert kann man auf der Oberfläche per Klick das Rollo hoch/runter oder auf eine bestimmte Position fahren. Der aktuelle Status des Rollo (fährt hoch/runter,offen,geschlossen,etc.) wird angezeigt.
Die Oberflächenicons werden per devStateIcon gesteuert, Icons und Farben können für jeden Status individuell formatiert werden, die Standard Kommandos auf der Oberfläche (hier: offen, geschlossen, schlitz, Position) können ebenfalls per Attribut angepasst werden. Das Status-Icon ist anklickbar.
Beim Anlegen des Moduls werden die Attribute zur Darstellung in fhem mit Standardwerten angelegt, so dass man sich einiges an Tipparbeit sparen kann, aber trotzdem die Möglichkeit hat die Darstellung individuell anzupassen.

== Voraussetzungen ==
Es müssen in fhem 2 Kanäle konfiguriert sein die mit on/off gesteuert werden können. Diese Kanäle können als Readings eines device oder als eigenständige definitionen in fhem existieren.

== Anwendung ==
=== Define ===
define <name> ROLLO

=== Attribute ===
{|class="wikitable"
|-
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung
|-
|kanal1|| Text || ||Name des fhem Geräts von Steuerungskanal1
|-
|kanal2|| Text (optional)|| ||Name des zweiten fhem Geräts für Kanal 2, sofern für die eigene Konfiguration notwendig
|-
|kanal3|| Text (optional)|| ||Name des dritten Kanals, sofern für die eigene Konfiguration notwendig
|-
|funktionsweise||Typ1,Typ2,Typ3,Typ4,Typ5,FS20ru|| Typ1 ||Art der Kanalsteuerung. Eine Auflistung der Funktionsweise enthält der nächste Bereich.
|-
|device||Text|| ||wird dieses Attribut angelegt, werden die Kanäle 1-3 als Reading dieses angegebenen devices interpretiert, nicht als eigenständige devices.
|-
|drive-down-time-to-100
|Ganzzahl
|20
|Zeit in Sekunden die das Rollo vom offenen zum geschlossenen Zustand benötigt.
|-
|drive-up-time-to-100
|Ganzzahl
|20
|Zeit in Sekunden, die das Rollo vom geschlossenen zum offenen Zustand benötigt (meist geringfügig höher als drive-down-time-to-100).
|-
|automatic-enabled
| on,off
| on
|Dieses Attribut wird nur für die Modulerweiterung 44_ROLLADEN_Automatic benötigt.
Hiermit kann die automatische Szenariensteuerung für den Rolladen deaktiviert werden.
|-
|automatic-delay
|0,5,10,15,<BR/>20,30,45,60
|0
|Dieses Attribut wird nur für die Modulerweiterung ROLLADEN_Automatic benötigt.
Hiermit kann einge Zeitverzögerund für den Rolladen eingestellt werden, werden die Rolladen per Automatic heruntergefahren, so wird dieser um die angegebenen minuten später heruntergefahren.
|}

'''Typen'''

folgende Hardwarekonstellationen werden z.Zt. von dem Modul unterstützt, weitere können bei Nachfrage hinzugefügt werden.
{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ1
|-
!Kanal 1!!Kanal 2!!Status
|-
|On||Off||hoch
|-
|On||On||runter
|-
|Off||Off||stop
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ2
|-
!Kanal 1!!Kanal 2!!Status
|-
|On||-||hoch
|-
| -||On||runter
|-
|Off|| - ||stop hoch
|-
| - ||Off||stop runter
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ3
|-
!Kanal 1!!Kanal 2!!Status
|-
|Off||-||hoch
|-
|On||-||runter
|-
| -||On||stop
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|FS20rsu
|-
!Kanal 1!!Status
|-
|On||hoch
|-
|Off||runter
|-
|On||stoppt das hochfahren
|-
|Off||stoppt das herunterfahren
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=4|Typ4
|-
!Kanal 1!!Kanal 2!!Kanal 3!!Status
|-
|on-for-timer 1|| - || - ||hoch
|-
| - ||on-for-timer 1|| - ||runter
|-
| - || - ||on-for-timer 1||stop
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ5
|-
!Kanal 1!!Kanal 2!!Status
|-
|on|| off ||hoch
|-
| off ||on ||runter
|-
| off || - ||stop hoch
|-
| - || off ||stop runter

|}

<div style="clear:both;"></div>

=== Settings ===
Es gibt mehrere Settings die das Rollo in eine bestimmte Position fahren:

<code>set <name> <geschlossen></code> Fährt das Rollo komplett herunter (Position 100)

<code>set <name> <offen></code> Fährt das Rollo komplett nach oben (Position 0)

<code>set <name> <schlitz></code> Fährt das Rollo soweit herunter das nur die Rolloschlitze offen sind (Position 90)

<code>set <name> <position> <value></code> Fährt das Rollo auf eine beliebige Position zwischen 0 (offen) - 100 (geschlossen)

Weitere Fahrbefehle für das Rollo:

<code>set <name> <stop></code> Stopt ein fahrendes Rollo unabhängig davon ob die vorher angegebene Zielposition erreicht wurde.

<code>set <name> <toggle></code> Fährt das Rollo in die entgegengesetzte Richtung wie beim letzten mal bis zur jeweiligen Endposition.
Fährt das Rollo gerade, wird es zuerst gestoppt und danach ebenfalls in die entgegengesetzte Richtung gefahren.

Sonstige Set-Befehle

<code>set <name> extern <position:offen,geschlossen,schlitz,stop></code> Startet alle Berechnungen und internen Timer im Modul, aktiviert aber nicht die konfigurierte Hardware (nützlich wenn diese bereits aktiviert wurde, um den Status der Oberfläche mit dem Ist-Zustand synchron zu halten. siehe auch [[#Zusammenspiel mit externem Taster]])

<code>set <name> reset <position:offen,geschlossen> </code> Setzt den internen Status des Rollo auf offen bzw. geschlossen ohne irgendwelche weiteren Aktionen durchzuführen.

=== Readings ===
{|class="wikitable"
|-
!Name !!Wert !!Beschreibung
|-
|extern ||extern,no||Dieser Wert steht per default auf "no", nur bei [code]set extern ...[/code] wird er für die dauer der Befehlsausführung auf "extern" gesetzt.
|-
|letzte_fahrt ||drive-up,drive-down||Zeigt die zuletzt gefahrene Richtung an, wird für den Befehl "toggle" benutzt.
|-
|position ||0-100 ||Die aktuelle Rollo-Position als %-Wert, 0=offen, 100=zu
|-
|state||offen,geschlossen,schlitz,drive-up,drive-down,position-[nn]||aktueller Rollo Status. Beim fahren: drive-[richtung], im stillstand die Position als klartext (offen,geschlossen,schlitz) oder als Position (position-[nn])
|-
|stop||Zeitwert||interner Zeitwert wann das Rollo beim fahren seine Zielposition erreicht hat. im stillstand ohne Bedeutung
|-
|ziel_state||offen,geschlossen,schlitz,position-[nn]||Bei fahrendem Rollo die anzufahrende Zielposition
|}

== Anwendungsbeispiele ==
===Set===
set RolladenWohnzimmer position 50
set RolladenWohnzimmer geschlossen
set RolladenWohnzimmer offen
Drei Beispiele das Rollo-Modul anzuweisen verschiedene Positionen anzufahren.

set RolladenWohnzimmer extern stop
Das Rollo-Modul wird angewiesen den status auf "nicht fahren" zu setzen, die aktuelle Rollo-Position zu berechnen und als neue Position abzuspeichern. Der eigentliche Rollo-Stop-Befehl wird dabei aber nicht gesendet.

set RolladenWohnzimmer reset geschlossen
In der Oberfläche von fhem wird für das Rollo die Position "geschlossen" gespeichert, ohne Berechnungen durchzuführen oder Hardware zu steuern. Wird eevtl. benötigt wenn der Ist-Status von den Soll-Werten aus fhem abweicht.

===Zusammenspiel mit externem Taster===
In einem Anwendungszenario hat ein Nutzer zusätzliche Taster an seinem Rollo-Motor über die er ihn ebenfalls steuern kann.
Die Taster selber senden keine Events an fhem, nur der Rollo-Motor.
Hier ein Beispiel wie das ganze für Typ2-Rollos aussehen könnte und diese Taster in das ROLLO-Modul integriert werden:

define rollo_manuell_auf DOIF ([meinRollo_Kanal1] eq "on" and [meinRolloModul] ne "drive-up") (set meinRolloModul extern offen) DOELSEIF ([meinRollo_Kanal1] eq "off" and [meinRolloModul] eq "drive-up") (set meinRolloModul extern stop)
define rollo_manuell_ab DOIF ([meinRollo_Kanal2] eq "on" and [meinRolloModul] ne "drive-down") (set meinRolloModul extern geschlossen) DOELSEIF ([meinRollo_Kanal2] eq "off" and [meinRolloModul] eq "drive-down") (set meinRolloModul extern stop)

meinRollo_Kanal1 und meinRollo_Kanal2 sind die Hardwarekanäle die in dem Rollo-Modul zum hochfahren/runterfahren benutzt werden. In diesem Beispiel ist das Rollo als Typ2 (ein Kanal hoch, zweiter Kanal runter) definiert.
Das erste DOIF prüft ob das Rollo hoch fährt, ohne das das Rollo-Modul davon etwas weis. Ist dem so wird dem Rollo Modul mithilfe des set <extern> mitgeteilt das das Rollo bereits gestartet wurde. Das Modul fängt an die Zeit zu zählen und aktualisiert den Status der Oberfläche auf "fahre hoch".
IM DOELSEIF wird abgefragt ob das Rollo steht, obwohl das Modul denkt das Rollo würde noch fahren. Ist dem so wird wieder mithilfe des set <extern> dem Modul mitgeteilt das das Rollo gestoppt wurde. Das Modul berechnet nun aufgrund der gefahrenen Zeit die aktuelle Position und aktualisiert den Status der Oberfläche auf die Position.

Das gleiche wird dann im zweiten DOIF nochmal für das herunterfahren gemacht.

Man kann nun das Rollo sowohl über die Oberfläche als auch per Taster bedienen und fhem und der reale Ist-Status sind synchron. Ach eine gleichzeitige Bedienung ist möglich, Das Rollo startet z.B. aufgrund einer Automatisierung morgens zum hochfahren und man klickt schnell auf den Taster neben dem Bett und stoppt das ganze wieder.

== Links ==
Thread im {{Link2Forum|Topic=47202|LinkText=Forum}} mit der jeweils aktuellen Version des Moduls als Anhang im ersten Beitrag.

ROLLO

2016-02-20T13:33:04Z

ThomasRamm: /* neuer Typ 5 */

{{SEITENTITEL:ROLLO}}
{{Infobox Modul
|ModPurpose=Rollo-Steuerung zur einfachen Anzeige/Programmierung
|ModType=x
|ModFTopic=47202


|ModForumArea=Codeschnipsel
|ModTechName=44_ROLLO.pm
|ModOwner=ThomasRamm}}
Das Modul [[ROLLO]] bietet eine einfache Möglichkeit, mit ein bis zwei Relais den Hoch-/Runterlauf eines Rolladen zu steuern und punktgenau anzuhalten. Außerdem wird die aktuelle Position in fhem abgebildet.
Über welche Hardware/Module die Ausgänge angesprochen werden ist dabei egal.
__TOC__
Das Modul unterstützt verschiedenste Konfigurationen welche Befehle ausgeführt werden müssen um die Hardware des Rollos zu steuern.
Weitere Konfigurationen können im Forum angefragt werden.

Besonderheiten:
* Wird in einer Konfiguration ein Kanal für die Richtung, der zweite für das Aktivieren des Rollos genutzt (z.B. Typ1), wird immer vor einem Rollo-Start die Richtung gesetzt. Bei einem Richtungswechsel während der Fahrt wird der Rollo für 1 sekunde gestoppt und dann in der Gegenrichtung gestartet um den Motor zu schonen.

* Fährt das Rollo zur Position offen oder geschlossen, wird der Motor noch 5 sec. länger auf on gelassen, um Positionsverschiebungen aufgrund ungenauer Parameter auszugleichen. Bei jedem vollständigen schließen/öffnen ist die Position damit wieder korrekt.

* Die Rollo-Position wird in 10%-Schritten von 0% (offen) bis 100% (geschlossen) zwischengespeichert um auf der Oberfläche für jede Position ein Icon festlegen zu können. Die Ungenauigkeiten die dadurch zwischen echter Position und gespeicherter Position entstehen, werden durch oben angeführte Korrektur ausgeglichen.

[[Datei:Rolladen Eintrag.PNG|right|thumb|400px|Verschiedene Ansichten des Rollo:offen, fährt gerade herunter, position 50, fährt gerade hoch, geschlossen]]
Vorteil dieses Moduls:

Ist ein Rollo mit diesem Modul definiert kann man auf der Oberfläche per Klick das Rollo hoch/runter oder auf eine bestimmte Position fahren. Der aktuelle Status des Rollo (fährt hoch/runter,offen,geschlossen,etc.) wird angezeigt.
Die Oberflächenicons werden per devStateIcon gesteuert, Icons und Farben können für jeden Status individuell formatiert werden, die Standard Kommandos auf der Oberfläche (hier: offen, geschlossen, schlitz, Position) können ebenfalls per Attribut angepasst werden. Das Status-Icon ist anklickbar.
Beim Anlegen des Moduls werden die Attribute zur Darstellung in fhem mit Standardwerten angelegt, so dass man sich einiges an Tipparbeit sparen kann, aber trotzdem die Möglichkeit hat die Darstellung individuell anzupassen.

== Voraussetzungen ==
Es müssen in fhem 2 Kanäle konfiguriert sein die mit on/off gesteuert werden können. Diese Kanäle können als Readings eines device oder als eigenständige definitionen in fhem existieren.

== Anwendung ==
=== Define ===
define <name> ROLLO

=== Attribute ===
{|class="wikitable"
|-
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung
|-
|kanal1|| Text || ||Name des fhem Geräts von Steuerungskanal1
|-
|kanal2|| Text (optional)|| ||Name des zweiten fhem Geräts für Kanal 2, sofern für die eigene Konfiguration notwendig
|-
|kanal3|| Text (optional)|| ||Name des dritten Kanals, sofern für die eigene Konfiguration notwendig
|-
|funktionsweise||Typ1,Typ2,Typ3,Typ4,Typ5,FS20ru|| Typ1 ||Art der Kanalsteuerung. Eine Auflistung der Funktionsweise enthält der nächste Bereich.
|-
|device||Text|| ||wird dieses Attribut angelegt, werden die Kanäle 1-3 als Reading dieses angegebenen devices interpretiert, nicht als eigenständige devices.
|-
|drive-down-time-to-100
|Ganzzahl
|20
|Zeit in Sekunden die das Rollo vom offenen zum geschlossenen Zustand benötigt.
|-
|drive-up-time-to-100
|Ganzzahl
|20
|Zeit in Sekunden, die das Rollo vom geschlossenen zum offenen Zustand benötigt (meist geringfügig höher als drive-down-time-to-100).
|-
|automatic-enabled
| on,off
| on
|Dieses Attribut wird nur für die Modulerweiterung 44_ROLLADEN_Automatic benötigt.
Hiermit kann die automatische Szenariensteuerung für den Rolladen deaktiviert werden.
|-
|automatic-delay
|0,5,10,15,<BR/>20,30,45,60
|0
|Dieses Attribut wird nur für die Modulerweiterung ROLLADEN_Automatic benötigt.
Hiermit kann einge Zeitverzögerund für den Rolladen eingestellt werden, werden die Rolladen per Automatic heruntergefahren, so wird dieser um die angegebenen minuten später heruntergefahren.
|}

'''Typen'''

folgende Hardwarekonstellationen werden z.Zt. von dem Modul unterstützt, weitere können bei Nachfrage hinzugefügt werden.
{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ1
|-
!Kanal 1!!Kanal 2!!Status
|-
|On||Off||hoch
|-
|On||On||runter
|-
|Off||Off||stop
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ2
|-
!Kanal 1!!Kanal 2!!Status
|-
|On||-||hoch
|-
| -||On||runter
|-
|Off|| - ||stop hoch
|-
| - ||Off||stop runter
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ3
|-
!Kanal 1!!Kanal 2!!Status
|-
|Off||-||hoch
|-
|On||-||runter
|-
| -||On||stop
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|FS20rsu
|-
!Kanal 1!!Status
|-
|On||hoch
|-
|Off||runter
|-
|On||stoppt das hochfahren
|-
|Off||stoppt das herunterfahren
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=4|Typ4
|-
!Kanal 1!!Kanal 2!!Kanal 3!!Status
|-
|on-for-timer 1|| - || - ||hoch
|-
| - ||on-for-timer 1|| - ||runter
|-
| - || - ||on-for-timer 1||stop
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ5
|-
!Kanal 1!!Kanal 2!!Status
|-
|on|| off ||hoch
|-
| off ||on ||runter
|-
| off || - ||stop hoch
|-
| - || off ||stop runter

|}

<div style="clear:both;"></div>

=== Settings ===
Es gibt mehrere Settings die das Rollo in eine bestimmte Position fahren:

<code>set <name> <geschlossen></code> Fährt das Rollo komplett herunter (Position 100)

<code>set <name> <offen></code> Fährt das Rollo komplett nach oben (Position 0)

<code>set <name> <schlitz></code> Fährt das Rollo soweit herunter das nur die Rolloschlitze offen sind (Position 90)

<code>set <name> <position> <value></code> Fährt das Rollo auf eine beliebige Position zwischen 0 (offen) - 100 (geschlossen)

Weitere Fahrbefehle für das Rollo:

<code>set <name> <stop></code> Stopt ein fahrendes Rollo unabhängig davon ob die vorher angegebene Zielposition erreicht wurde.

<code>set <name> <toggle></code> Fährt das Rollo in die entgegengesetzte Richtung wie beim letzten mal bis zur jeweiligen Endposition.
Fährt das Rollo gerade, wird es zuerst gestoppt und danach ebenfalls in die entgegengesetzte Richtung gefahren.

Sonstige Set-Befehle

<code>set <name> extern <position:offen,geschlossen,schlitz,stop></code> Startet alle Berechnungen und internen Timer im Modul, aktiviert aber nicht die konfigurierte Hardware (nützlich wenn diese bereits aktiviert wurde, um den Status der Oberfläche mit dem Ist-Zustand synchron zu halten. siehe auch [[#Zusammenspiel mit externem Taster]])

<code>set <name> reset <position:offen,geschlossen> </code> Setzt den internen Status des Rollo auf offen bzw. geschlossen ohne irgendwelche weiteren Aktionen durchzuführen.

=== Readings ===
{|class="wikitable"
|-
!Name !!Wert !!Beschreibung
|-
|extern ||extern,no||Dieser Wert steht per default auf "no", nur bei [code]set extern ...[/code] wird er für die dauer der Befehlsausführung auf "extern" gesetzt.
|-
|letzte_fahrt ||drive-up,drive-down||Zeigt die zuletzt gefahrene Richtung an, wird für den Befehl "toggle" benutzt.
|-
|position ||0-100 ||Die aktuelle Rollo-Position als %-Wert, 0=offen, 100=zu
|-
|state||offen,geschlossen,schlitz,drive-up,drive-down,position-[nn]||aktueller Rollo Status. Beim fahren: drive-[richtung], im stillstand die Position als klartext (offen,geschlossen,schlitz) oder als Position (position-[nn])
|-
|stop||Zeitwert||interner Zeitwert wann das Rollo beim fahren seine Zielposition erreicht hat. im stillstand ohne Bedeutung
|-
|ziel_state||offen,geschlossen,schlitz,position-[nn]||Bei fahrendem Rollo die anzufahrende Zielposition
|}

== Anwendungsbeispiele ==
===Define===
define meinRollo ROLLO myMcp23017 PortA0 PortA1 Typ1
Die Rollo-Kanäle sind Readings des Mcp23017-Device

define meinRollo ROLLO - Rollo_KanalA Rollo_KanalB
Die Rollo-Kanäle sind in fhem Eigenständige Devices, der Parameter <device> wurde deshalb mit einem "-" deaktiviert

===Set===
set RolladenWohnzimmer position 50
set RolladenWohnzimmer geschlossen
set RolladenWohnzimmer offen
Drei Beispiele das Rollo-Modul anzuweisen verschiedene Positionen anzufahren.

set RolladenWohnzimmer extern stop
Das Rollo-Modul wird angewiesen den status auf "nicht fahren" zu setzen, die aktuelle Rollo-Position zu berechnen und als neue Position abzuspeichern. Der eigentliche Rollo-Stop-Befehl wird dabei aber nicht gesendet.

set RolladenWohnzimmer reset geschlossen
In der Oberfläche von fhem wird für das Rollo die Position "geschlossen" gespeichert, ohne Berechnungen durchzuführen oder Hardware zu steuern. Wird eevtl. benötigt wenn der Ist-Status von den Soll-Werten aus fhem abweicht.

===Zusammenspiel mit externem Taster===
In einem Anwendungszenario hat ein Nutzer zusätzliche Taster an seinem Rollo-Motor über die er ihn ebenfalls steuern kann.
Die Taster selber senden keine Events an fhem, nur der Rollo-Motor.
Hier ein Beispiel wie das ganze für Typ2-Rollos aussehen könnte und diese Taster in das ROLLO-Modul integriert werden:

define rollo_manuell_auf DOIF ([meinRollo_Kanal1] eq "on" and [meinRolloModul] ne "drive-up") (set meinRolloModul extern offen) DOELSEIF ([meinRollo_Kanal1] eq "off" and [meinRolloModul] eq "drive-up") (set meinRolloModul extern stop)
define rollo_manuell_ab DOIF ([meinRollo_Kanal2] eq "on" and [meinRolloModul] ne "drive-down") (set meinRolloModul extern geschlossen) DOELSEIF ([meinRollo_Kanal2] eq "off" and [meinRolloModul] eq "drive-down") (set meinRolloModul extern stop)

meinRollo_Kanal1 und meinRollo_Kanal2 sind die Hardwarekanäle die in dem Rollo-Modul zum hochfahren/runterfahren benutzt werden. In diesem Beispiel ist das Rollo als Typ2 (ein Kanal hoch, zweiter Kanal runter) definiert.
Das erste DOIF prüft ob das Rollo hoch fährt, ohne das das Rollo-Modul davon etwas weis. Ist dem so wird dem Rollo Modul mithilfe des set <extern> mitgeteilt das das Rollo bereits gestartet wurde. Das Modul fängt an die Zeit zu zählen und aktualisiert den Status der Oberfläche auf "fahre hoch".
IM DOELSEIF wird abgefragt ob das Rollo steht, obwohl das Modul denkt das Rollo würde noch fahren. Ist dem so wird wieder mithilfe des set <extern> dem Modul mitgeteilt das das Rollo gestoppt wurde. Das Modul berechnet nun aufgrund der gefahrenen Zeit die aktuelle Position und aktualisiert den Status der Oberfläche auf die Position.

Das gleiche wird dann im zweiten DOIF nochmal für das herunterfahren gemacht.

Man kann nun das Rollo sowohl über die Oberfläche als auch per Taster bedienen und fhem und der reale Ist-Status sind synchron. Ach eine gleichzeitige Bedienung ist möglich, Das Rollo startet z.B. aufgrund einer Automatisierung morgens zum hochfahren und man klickt schnell auf den Taster neben dem Bett und stoppt das ganze wieder.

== Links ==
Thread im {{Link2Forum|Topic=47202|LinkText=Forum}} mit der jeweils aktuellen Version des Moduls als Anhang im ersten Beitrag.

ROLLO

2016-01-16T13:16:31Z

ThomasRamm: Neue und geänderte Modulfunktionen

{{SEITENTITEL:ROLLO}}
{{Infobox Modul
|ModPurpose=Rollo-Steuerung zur einfachen Anzeige/Programmierung
|ModType=x
|ModFTopic=47202


|ModForumArea=Codeschnipsel
|ModTechName=44_ROLLO.pm
|ModOwner=ThomasRamm}}
Das Modul [[ROLLO]] bietet eine einfache Möglichkeit, mit ein bis zwei Relais den Hoch-/Runterlauf eines Rolladen zu steuern und punktgenau anzuhalten. Außerdem wird die aktuelle Position in fhem abgebildet.
Über welche Hardware/Module die Ausgänge angesprochen werden ist dabei egal.
__TOC__
Das Modul unterstützt verschiedenste Konfigurationen welche Befehle ausgeführt werden müssen um die Hardware des Rollos zu steuern.
Weitere Konfigurationen können im Forum angefragt werden.

Besonderheiten:
* Wird in einer Konfiguration ein Kanal für die Richtung, der zweite für das Aktivieren des Rollos genutzt (z.B. Typ1), wird immer vor einem Rollo-Start die Richtung gesetzt. Bei einem Richtungswechsel während der Fahrt wird der Rollo für 1 sekunde gestoppt und dann in der Gegenrichtung gestartet um den Motor zu schonen.

* Fährt das Rollo zur Position offen oder geschlossen, wird der Motor noch 5 sec. länger auf on gelassen, um Positionsverschiebungen aufgrund ungenauer Parameter auszugleichen. Bei jedem vollständigen schließen/öffnen ist die Position damit wieder korrekt.

* Die Rollo-Position wird in 10%-Schritten von 0% (offen) bis 100% (geschlossen) zwischengespeichert um auf der Oberfläche für jede Position ein Icon festlegen zu können. Die Ungenauigkeiten die dadurch zwischen echter Position und gespeicherter Position entstehen, werden durch oben angeführte Korrektur ausgeglichen.

[[Datei:Rolladen Eintrag.PNG|right|thumb|400px|Verschiedene Ansichten des Rollo:offen, fährt gerade herunter, position 50, fährt gerade hoch, geschlossen]]
Vorteil dieses Moduls:

Ist ein Rollo mit diesem Modul definiert kann man auf der Oberfläche per Klick das Rollo hoch/runter oder auf eine bestimmte Position fahren. Der aktuelle Status des Rollo (fährt hoch/runter,offen,geschlossen,etc.) wird angezeigt.
Die Oberflächenicons werden per devStateIcon gesteuert, Icons und Farben können für jeden Status individuell formatiert werden, die Standard Kommandos auf der Oberfläche (hier: offen, geschlossen, schlitz, Position) können ebenfalls per Attribut angepasst werden. Das Status-Icon ist anklickbar.
Beim Anlegen des Moduls werden die Attribute zur Darstellung in fhem mit Standardwerten angelegt, so dass man sich einiges an Tipparbeit sparen kann, aber trotzdem die Möglichkeit hat die Darstellung individuell anzupassen.

== Voraussetzungen ==
Es müssen in fhem 2 Kanäle konfiguriert sein die mit on/off gesteuert werden können. Diese Kanäle können als Readings eines device oder als eigenständige definitionen in fhem existieren.

== Anwendung ==
=== Define ===
define <name> ROLLO

=== Attribute ===
{|class="wikitable"
|-
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung
|-
|kanal1|| Text || ||Name des fhem Geräts von Steuerungskanal1
|-
|kanal2|| Text (optional)|| ||Name des zweiten fhem Geräts für Kanal 2, sofern für die eigene Konfiguration notwendig
|-
|kanal3|| Text (optional)|| ||Name des dritten Kanals, sofern für die eigene Konfiguration notwendig
|-
|funktionsweise||Typ1,Typ2,Typ3,Typ4,FS20ru|| Typ1 ||Art der Kanalsteuerung. Eine Auflistung der Funktionsweise enthält der nächste Bereich.
|-
|device||Text|| ||wird dieses Attribut angelegt, werden die Kanäle 1-3 als Reading dieses angegebenen devices interpretiert, nicht als eigenständige devices.
|-
|drive-down-time-to-100
|Ganzzahl
|20
|Zeit in Sekunden die das Rollo vom offenen zum geschlossenen Zustand benötigt.
|-
|drive-up-time-to-100
|Ganzzahl
|20
|Zeit in Sekunden, die das Rollo vom geschlossenen zum offenen Zustand benötigt (meist geringfügig höher als drive-down-time-to-100).
|-
|automatic-enabled
| on,off
| on
|Dieses Attribut wird nur für die Modulerweiterung 44_ROLLADEN_Automatic benötigt.
Hiermit kann die automatische Szenariensteuerung für den Rolladen deaktiviert werden.
|-
|automatic-delay
|0,5,10,15,<BR/>20,30,45,60
|0
|Dieses Attribut wird nur für die Modulerweiterung ROLLADEN_Automatic benötigt.
Hiermit kann einge Zeitverzögerund für den Rolladen eingestellt werden, werden die Rolladen per Automatic heruntergefahren, so wird dieser um die angegebenen minuten später heruntergefahren.
|}

'''Typen'''

folgende Hardwarekonstellationen werden z.Zt. von dem Modul unterstützt, weitere können bei Nachfrage hinzugefügt werden.
{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ1
|-
!Kanal 1!!Kanal 2!!Status
|-
|On||Off||hoch
|-
|On||On||runter
|-
|Off||Off||stop
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ2
|-
!Kanal 1!!Kanal 2!!Status
|-
|On||-||hoch
|-
| -||On||runter
|-
|Off||Off||stop
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ3
|-
!Kanal 1!!Kanal 2!!Status
|-
|Off||-||hoch
|-
|On||-||runter
|-
| -||On||stop
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|FS20rsu
|-
!Kanal 1!!Status
|-
|On||hoch
|-
|Off||runter
|-
|On||stoppt das hochfahren
|-
|Off||stoppt das herunterfahren
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=4|Typ4
|-
!Kanal 1!!Kanal 2!!Kanal 3!!Status
|-
|on-for-timer 1|| - || - ||hoch
|-
| - ||on-for-timer 1|| - ||runter
|-
| - || - ||on-for-timer 1||stop
|}

<div style="clear:both;"></div>

=== Settings ===
Es gibt mehrere Settings die das Rollo in eine bestimmte Position fahren:

<code>set <name> <geschlossen></code> Fährt das Rollo komplett herunter (Position 100)

<code>set <name> <offen></code> Fährt das Rollo komplett nach oben (Position 0)

<code>set <name> <schlitz></code> Fährt das Rollo soweit herunter das nur die Rolloschlitze offen sind (Position 90)

<code>set <name> <position> <value></code> Fährt das Rollo auf eine beliebige Position zwischen 0 (offen) - 100 (geschlossen)

Weitere Fahrbefehle für das Rollo:

<code>set <name> <stop></code> Stopt ein fahrendes Rollo unabhängig davon ob die vorher angegebene Zielposition erreicht wurde.

<code>set <name> <toggle></code> Fährt das Rollo in die entgegengesetzte Richtung wie beim letzten mal bis zur jeweiligen Endposition.
Fährt das Rollo gerade, wird es zuerst gestoppt und danach ebenfalls in die entgegengesetzte Richtung gefahren.

Sonstige Set-Befehle

<code>set <name> extern <position:offen,geschlossen,schlitz,stop></code> Startet alle Berechnungen und internen Timer im Modul, aktiviert aber nicht die konfigurierte Hardware (nützlich wenn diese bereits aktiviert wurde, um den Status der Oberfläche mit dem Ist-Zustand synchron zu halten. siehe auch [[#Zusammenspiel mit externem Taster]])

<code>set <name> reset <position:offen,geschlossen> </code> Setzt den internen Status des Rollo auf offen bzw. geschlossen ohne irgendwelche weiteren Aktionen durchzuführen.

=== Readings ===
{|class="wikitable"
|-
!Name !!Wert !!Beschreibung
|-
|extern ||extern,no||Dieser Wert steht per default auf "no", nur bei [code]set extern ...[/code] wird er für die dauer der Befehlsausführung auf "extern" gesetzt.
|-
|letzte_fahrt ||drive-up,drive-down||Zeigt die zuletzt gefahrene Richtung an, wird für den Befehl "toggle" benutzt.
|-
|position ||0-100 ||Die aktuelle Rollo-Position als %-Wert, 0=offen, 100=zu
|-
|state||offen,geschlossen,schlitz,drive-up,drive-down,position-[nn]||aktueller Rollo Status. Beim fahren: drive-[richtung], im stillstand die Position als klartext (offen,geschlossen,schlitz) oder als Position (position-[nn])
|-
|stop||Zeitwert||interner Zeitwert wann das Rollo beim fahren seine Zielposition erreicht hat. im stillstand ohne Bedeutung
|-
|ziel_state||offen,geschlossen,schlitz,position-[nn]||Bei fahrendem Rollo die anzufahrende Zielposition
|}

== Anwendungsbeispiele ==
===Define===
define meinRollo ROLLO myMcp23017 PortA0 PortA1 Typ1
Die Rollo-Kanäle sind Readings des Mcp23017-Device

define meinRollo ROLLO - Rollo_KanalA Rollo_KanalB
Die Rollo-Kanäle sind in fhem Eigenständige Devices, der Parameter <device> wurde deshalb mit einem "-" deaktiviert

===Set===
set RolladenWohnzimmer position 50
set RolladenWohnzimmer geschlossen
set RolladenWohnzimmer offen
Drei Beispiele das Rollo-Modul anzuweisen verschiedene Positionen anzufahren.

set RolladenWohnzimmer extern stop
Das Rollo-Modul wird angewiesen den status auf "nicht fahren" zu setzen, die aktuelle Rollo-Position zu berechnen und als neue Position abzuspeichern. Der eigentliche Rollo-Stop-Befehl wird dabei aber nicht gesendet.

set RolladenWohnzimmer reset geschlossen
In der Oberfläche von fhem wird für das Rollo die Position "geschlossen" gespeichert, ohne Berechnungen durchzuführen oder Hardware zu steuern. Wird eevtl. benötigt wenn der Ist-Status von den Soll-Werten aus fhem abweicht.

===Zusammenspiel mit externem Taster===
In einem Anwendungszenario hat ein Nutzer zusätzliche Taster an seinem Rollo-Motor über die er ihn ebenfalls steuern kann.
Die Taster selber senden keine Events an fhem, nur der Rollo-Motor.
Hier ein Beispiel wie das ganze für Typ2-Rollos aussehen könnte und diese Taster in das ROLLO-Modul integriert werden:

define rollo_manuell_auf DOIF ([meinRollo_Kanal1] eq "on" and [meinRolloModul] ne "drive-up") (set meinRolloModul extern offen) DOELSEIF ([meinRollo_Kanal1] eq "off" and [meinRolloModul] eq "drive-up") (set meinRolloModul extern stop)
define rollo_manuell_ab DOIF ([meinRollo_Kanal2] eq "on" and [meinRolloModul] ne "drive-down") (set meinRolloModul extern geschlossen) DOELSEIF ([meinRollo_Kanal2] eq "off" and [meinRolloModul] eq "drive-down") (set meinRolloModul extern stop)

meinRollo_Kanal1 und meinRollo_Kanal2 sind die Hardwarekanäle die in dem Rollo-Modul zum hochfahren/runterfahren benutzt werden. In diesem Beispiel ist das Rollo als Typ2 (ein Kanal hoch, zweiter Kanal runter) definiert.
Das erste DOIF prüft ob das Rollo hoch fährt, ohne das das Rollo-Modul davon etwas weis. Ist dem so wird dem Rollo Modul mithilfe des set <extern> mitgeteilt das das Rollo bereits gestartet wurde. Das Modul fängt an die Zeit zu zählen und aktualisiert den Status der Oberfläche auf "fahre hoch".
IM DOELSEIF wird abgefragt ob das Rollo steht, obwohl das Modul denkt das Rollo würde noch fahren. Ist dem so wird wieder mithilfe des set <extern> dem Modul mitgeteilt das das Rollo gestoppt wurde. Das Modul berechnet nun aufgrund der gefahrenen Zeit die aktuelle Position und aktualisiert den Status der Oberfläche auf die Position.

Das gleiche wird dann im zweiten DOIF nochmal für das herunterfahren gemacht.

Man kann nun das Rollo sowohl über die Oberfläche als auch per Taster bedienen und fhem und der reale Ist-Status sind synchron. Ach eine gleichzeitige Bedienung ist möglich, Das Rollo startet z.B. aufgrund einer Automatisierung morgens zum hochfahren und man klickt schnell auf den Taster neben dem Bett und stoppt das ganze wieder.

== Links ==
Thread im {{Link2Forum|Topic=47202|LinkText=Forum}} mit der jeweils aktuellen Version des Moduls als Anhang im ersten Beitrag.

ROLLO

2016-01-16T10:57:45Z

ThomasRamm: /* Define */

{{SEITENTITEL:ROLLO}}
{{Infobox Modul
|ModPurpose=Rollo-Steuerung zur einfachen Anzeige/Programmierung
|ModType=x
|ModFTopic=47202


|ModForumArea=Codeschnipsel
|ModTechName=44_ROLLO.pm
|ModOwner=ThomasRamm}}
Das Modul [[ROLLO]] bietet eine einfache Möglichkeit, mit ein bis zwei Relais den Hoch-/Runterlauf eines Rolladen zu steuern und punktgenau anzuhalten. Außerdem wird die aktuelle Position in fhem abgebildet.
Über welche Hardware/Module die Ausgänge angesprochen werden ist dabei egal.
__TOC__
Das Modul unterstützt verschiedenste Konfigurationen welche Befehle ausgeführt werden müssen um die Hardware des Rollos zu steuern.
Weitere Konfigurationen können im Forum angefragt werden.

Besonderheiten:
* Wird in einer Konfiguration ein Kanal für die Richtung, der zweite für das Aktivieren des Rollos genutzt (z.B. Typ1), wird immer vor einem Rollo-Start die Richtung gesetzt. Bei einem Richtungswechsel während der Fahrt wird der Rollo für 1 sekunde gestoppt und dann in der Gegenrichtung gestartet.

* Fährt das Rollo zur Position offen oder geschlossen, wird der Motor noch 5 sec. länger auf on gelassen, um Positionsverschiebungen aufgrund ungenauer Parameter auszugleichen. Bei jedem vollständigen schließen/öffnen ist die Position damit wieder korrekt.

* Die Rollo-Position wird in 10%-Schritten von 0% (offen) bis 100% (geschlossen) zwischengespeichert um auf der Oberfläche für jede Position ein Icon festlegen zu können. Die Ungenauigkeiten die dadurch zwischen echter Position und gespeicherter Position entstehen, werden durch oben angeführte Korrektur ausgeglichen.

[[Datei:Rolladen Eintrag.PNG|right|thumb|400px|Verschiedene Ansichten des Rollo:offen, fährt gerade herunter, position 50, fährt gerade hoch, geschlossen]]
Vorteil dieses Moduls:

Ist ein Rollo mit diesem Modul definiert kann man auf der Oberfläche per Klick das Rollo hoch/runter oder auf eine bestimmte Position fahren. Der aktuelle Status des Rollo (fährt hoch/runter,offen,geschlossen,etc.) wird angezeigt.
Die Oberflächenicons werden per devStateIcon gesteuert, Icons und Farben können für jeden Status individuell formatiert werden, die Standard Kommandos auf der Oberfläche (hier: offen, geschlossen, schlitz, Position) können ebenfalls per Attribut angepasst werden.
Beim Anlegen des Moduls werden die Attribute zur Darstellung in fhem mit Standardwerten angelegt, so dass man sich einiges an Tipparbeit sparen kann, aber trotzdem die Möglichkeit hat die Darstellung individuell anzupassen.

== Voraussetzungen ==
Es müssen in fhem 2 Kanäle konfiguriert sein die mit on/off gesteuert werden können. Diese Kanäle können als Readings eines device oder als eigenständige definitionen in fhem existieren.

== Anwendung ==
=== Define ===
define <name> ROLLO <device> <ausgang1> <ausgang2> <Typ>

'''Parameter:'''
{|class="wikitable sortable"
|-
!Parameter !! class="unsortable"|Beschreibung
|-
|<name>||Name des Modul
|-
|<device>||Name des Hardwaremoduls dessen Readings die Kanäle sind. Sollten die Kanäle eigene definitionen in fhem sein, dann hier ein "-" eingeben.
|-
|<ausgang1>||Name des Device-Reading oder des fhem Geräts von Kanal 1
|-
|<ausgang2>||Name des zweiten Device-Reading bzw. fhem Geräts für Kanal 2
|-
|<typ>||Art der Kanalsteuerung. Mögliche Werte sind:<BR/>
Typ1,Typ2,Typ3,FS20ru. Eine Auflistung der Funktionsweise enthält der nächste Bereich.
|}

'''Typen'''
{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ1
|-
!Kanal 1!!Kanal 2!!Status
|-
|On||Off||hoch
|-
|On||On||runter
|-
|Off||Off||stop
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ2
|-
!Kanal 1!!Kanal 2!!Status
|-
|On||-||hoch
|-
| -||On||runter
|-
|Off||Off||stop
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ3
|-
!Kanal 1!!Kanal 2!!Status
|-
|Off||-||hoch
|-
|On||-||runter
|-
| -||On||stop
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|FS20rsu
|-
!Kanal 1!!Status
|-
|On||hoch
|-
|Off||runter
|-
|On||stoppt das hochfahren
|-
|Off||stoppt das herunterfahren
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=4|Typ4
|-
!Kanal 1!!Kanal 2!!Kanal 3!!Status
|-
|on-for-timer 1|| - || - ||hoch
|-
| - ||on-for-timer 1|| - ||runter
|-
| - || - ||on-for-timer 1||stop
|}

<div style="clear:both;"></div>

=== Attribute ===
{|class="wikitable"
|-
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung
|-
|drive-down-time-to-100
|Ganzzahl
|20
|Zeit in Sekunden die das Rollo vom offenen zum geschlossenen Zustand benötigt.
|-
|drive-up-time-to-100
|Ganzzahl
|20
|Zeit in Sekunden, die das Rollo vom geschlossenen zum offenen Zustand benötigt (meist geringfügig höher als drive-down-time-to-100).
|-
|automatic-enabled
| on,off
| on
|Dieses Attribut wird nur für die Modulerweiterung 44_ROLLADEN_Automatic benötigt.
Hiermit kann die automatische Szenariensteuerung für den Rolladen deaktiviert werden.
|-
|automatic-delay
|0,5,10,15,<BR/>20,30,45,60
|0
|Dieses Attribut wird nur für die Modulerweiterung ROLLADEN_Automatic benötigt.
Hiermit kann einge Zeitverzögerund für den Rolladen eingestellt werden, werden die Rolladen per Automatic heruntergefahren, so wird dieser um die angegebenen minuten später heruntergefahren.
|}

=== Settings ===
Es gibt mehrere Settings die das Rollo in eine bestimmte Position fahren:

<code>set <name> <geschlossen></code> Fährt das Rollo komplett herunter (Position 100)

<code>set <name> <offen></code> Fährt das Rollo komplett nach oben (Position 0)

<code>set <name> <schlitz></code> Fährt das Rollo soweit herunter das nur die Rolloschlitze offen sind (Position 90)

<code>set <name> <position> <value></code> Fährt das Rollo auf eine beliebige Position zwischen 0 (offen) - 100 (geschlossen)

Weitere Fahrbefehle für das Rollo:

<code>set <name> <stop></code> Stopt ein fahrendes Rollo unabhängig davon ob die vorher angegebene Zielposition erreicht wurde.

<code>set <name> <toggle></code> Fährt das Rollo in die entgegengesetzte Richtung wie beim letzten mal bis zur jeweiligen Endposition.
Fährt das Rollo gerade, wird es zuerst gestoppt und danach ebenfalls in die entgegengesetzte Richtung gefahren.

Sonstige Set-Befehle

<code>set <name> extern <position:offen,geschlossen,schlitz,stop></code> Startet alle Berechnungen und internen Timer im Modul, aktiviert aber nicht die konfigurierte Hardware (nützlich wenn diese bereits aktiviert wurde, um den Status der Oberfläche mit dem Ist-Zustand synchron zu halten. siehe auch [[#Zusammenspiel mit externem Taster]])

<code>set <name> reset <position:offen,geschlossen> </code> Setzt den internen Status des Rollo auf offen bzw. geschlossen ohne irgendwelche weiteren Aktionen durchzuführen.

== Anwendungsbeispiele ==
===Define===
define meinRollo ROLLO myMcp23017 PortA0 PortA1 Typ1
Die Rollo-Kanäle sind Readings des Mcp23017-Device

define meinRollo ROLLO - Rollo_KanalA Rollo_KanalB
Die Rollo-Kanäle sind in fhem Eigenständige Devices, der Parameter <device> wurde deshalb mit einem "-" deaktiviert

===Set===
set RolladenWohnzimmer position 50
set RolladenWohnzimmer geschlossen
set RolladenWohnzimmer offen
Drei Beispiele das Rollo-Modul anzuweisen verschiedene Positionen anzufahren.

set RolladenWohnzimmer extern stop
Das Rollo-Modul wird angewiesen den status auf "nicht fahren" zu setzen, die aktuelle Rollo-Position zu berechnen und als neue Position abzuspeichern. Der eigentliche Rollo-Stop-Befehl wird dabei aber nicht gesendet.

set RolladenWohnzimmer reset geschlossen
In der Oberfläche von fhem wird für das Rollo die Position "geschlossen" gespeichert, ohne Berechnungen durchzuführen oder Hardware zu steuern. Wird eevtl. benötigt wenn der Ist-Status von den Soll-Werten aus fhem abweicht.

===Zusammenspiel mit externem Taster===
In einem Anwendungszenario hat ein Nutzer zusätzliche Taster an seinem Rollo-Motor über die er ihn ebenfalls steuern kann.
Die Taster selber senden keine Events an fhem, nur der Rollo-Motor.
Hier ein Beispiel wie das ganze für Typ2-Rollos aussehen könnte und diese Taster in das ROLLO-Modul integriert werden:

define rollo_manuell_auf DOIF ([meinRollo_Kanal1] eq "on" and [meinRolloModul] ne "drive-up") (set meinRolloModul extern offen) DOELSEIF ([meinRollo_Kanal1] eq "off" and [meinRolloModul] eq "drive-up") (set meinRolloModul extern stop)
define rollo_manuell_ab DOIF ([meinRollo_Kanal2] eq "on" and [meinRolloModul] ne "drive-down") (set meinRolloModul extern geschlossen) DOELSEIF ([meinRollo_Kanal2] eq "off" and [meinRolloModul] eq "drive-down") (set meinRolloModul extern stop)

meinRollo_Kanal1 und meinRollo_Kanal2 sind die Hardwarekanäle die in dem Rollo-Modul zum hochfahren/runterfahren benutzt werden. In diesem Beispiel ist das Rollo als Typ2 (ein Kanal hoch, zweiter Kanal runter) definiert.
Das erste DOIF prüft ob das Rollo hoch fährt, ohne das das Rollo-Modul davon etwas weis. Ist dem so wird dem Rollo Modul mithilfe des set <extern> mitgeteilt das das Rollo bereits gestartet wurde. Das Modul fängt an die Zeit zu zählen und aktualisiert den Status der Oberfläche auf "fahre hoch".
IM DOELSEIF wird abgefragt ob das Rollo steht, obwohl das Modul denkt das Rollo würde noch fahren. Ist dem so wird wieder mithilfe des set <extern> dem Modul mitgeteilt das das Rollo gestoppt wurde. Das Modul berechnet nun aufgrund der gefahrenen Zeit die aktuelle Position und aktualisiert den Status der Oberfläche auf die Position.

Das gleiche wird dann im zweiten DOIF nochmal für das herunterfahren gemacht.

Man kann nun das Rollo sowohl über die Oberfläche als auch per Taster bedienen und fhem und der reale Ist-Status sind synchron. Ach eine gleichzeitige Bedienung ist möglich, Das Rollo startet z.B. aufgrund einer Automatisierung morgens zum hochfahren und man klickt schnell auf den Taster neben dem Bett und stoppt das ganze wieder.

== Links ==
Thread im {{Link2Forum|Topic=47202|LinkText=Forum}} mit der jeweils aktuellen Version des Moduls als Anhang im ersten Beitrag.

ROLLO

2016-01-15T12:49:54Z

ThomasRamm:

{{SEITENTITEL:ROLLO}}
{{Infobox Modul
|ModPurpose=Rollo-Steuerung zur einfachen Anzeige/Programmierung
|ModType=x
|ModFTopic=47202


|ModForumArea=Codeschnipsel
|ModTechName=44_ROLLO.pm
|ModOwner=ThomasRamm}}
Das Modul [[ROLLO]] bietet eine einfache Möglichkeit, mit ein bis zwei Relais den Hoch-/Runterlauf eines Rolladen zu steuern und punktgenau anzuhalten. Außerdem wird die aktuelle Position in fhem abgebildet.
Über welche Hardware/Module die Ausgänge angesprochen werden ist dabei egal.
__TOC__
Das Modul unterstützt verschiedenste Konfigurationen welche Befehle ausgeführt werden müssen um die Hardware des Rollos zu steuern.
Weitere Konfigurationen können im Forum angefragt werden.

Besonderheiten:
* Wird in einer Konfiguration ein Kanal für die Richtung, der zweite für das Aktivieren des Rollos genutzt (z.B. Typ1), wird immer vor einem Rollo-Start die Richtung gesetzt. Bei einem Richtungswechsel während der Fahrt wird der Rollo für 1 sekunde gestoppt und dann in der Gegenrichtung gestartet.

* Fährt das Rollo zur Position offen oder geschlossen, wird der Motor noch 5 sec. länger auf on gelassen, um Positionsverschiebungen aufgrund ungenauer Parameter auszugleichen. Bei jedem vollständigen schließen/öffnen ist die Position damit wieder korrekt.

* Die Rollo-Position wird in 10%-Schritten von 0% (offen) bis 100% (geschlossen) zwischengespeichert um auf der Oberfläche für jede Position ein Icon festlegen zu können. Die Ungenauigkeiten die dadurch zwischen echter Position und gespeicherter Position entstehen, werden durch oben angeführte Korrektur ausgeglichen.

[[Datei:Rolladen Eintrag.PNG|right|thumb|400px|Verschiedene Ansichten des Rollo:offen, fährt gerade herunter, position 50, fährt gerade hoch, geschlossen]]
Vorteil dieses Moduls:

Ist ein Rollo mit diesem Modul definiert kann man auf der Oberfläche per Klick das Rollo hoch/runter oder auf eine bestimmte Position fahren. Der aktuelle Status des Rollo (fährt hoch/runter,offen,geschlossen,etc.) wird angezeigt.
Die Oberflächenicons werden per devStateIcon gesteuert, Icons und Farben können für jeden Status individuell formatiert werden, die Standard Kommandos auf der Oberfläche (hier: offen, geschlossen, schlitz, Position) können ebenfalls per Attribut angepasst werden.
Beim Anlegen des Moduls werden die Attribute zur Darstellung in fhem mit Standardwerten angelegt, so dass man sich einiges an Tipparbeit sparen kann, aber trotzdem die Möglichkeit hat die Darstellung individuell anzupassen.

== Voraussetzungen ==
Es müssen in fhem 2 Kanäle konfiguriert sein die mit on/off gesteuert werden können. Diese Kanäle können als Readings eines device oder als eigenständige definitionen in fhem existieren.

== Anwendung ==
=== Define ===
define <name> ROLLO <device> <ausgang1> <ausgang2> <Typ>

'''Parameter:'''
{|class="wikitable sortable"
|-
!Parameter !! class="unsortable"|Beschreibung
|-
|<name>||Name des Modul
|-
|<device>||Name des Hardwaremoduls dessen Readings die Kanäle sind. Sollten die Kanäle eigene definitionen in fhem sein, dann hier ein "-" eingeben.
|-
|<ausgang1>||Name des Device-Reading oder des fhem Geräts von Kanal 1
|-
|<ausgang2>||Name des zweiten Device-Reading bzw. fhem Geräts für Kanal 2
|-
|<typ>||Art der Kanalsteuerung. Mögliche Werte sind:<BR/>
Typ1,Typ2,Typ3,FS20ru. Eine Auflistung der Funktionsweise enthält der nächste Bereich.
|}

'''Typen'''
{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ1
|-
!Kanal 1!!Kanal 2!!Status
|-
|On||Off||hoch
|-
|On||On||runter
|-
|Off||Off||stop
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ2
|-
!Kanal 1!!Kanal 2!!Status
|-
|On||Off||hoch
|-
|Off||On||runter
|-
|Off||Off||stop
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ3
|-
!Kanal 1!!Kanal 2!!Status
|-
|Off||-||hoch
|-
|On||-||runter
|-
| -||On||stoppt das hochfahren
|-
| -||Off||stoppt das herunterfahren
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|FS20rsu
|-
!Kanal 1!!Status
|-
|On||hoch
|-
|Off||runter
|-
|On||stoppt das hochfahren
|-
|Off||stoppt das herunterfahren
|}

<div style="clear:both;"></div>
=== Attribute ===
{|class="wikitable"
|-
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung
|-
|drive-down-time-to-100
|Ganzzahl
|20
|Zeit in Sekunden die das Rollo vom offenen zum geschlossenen Zustand benötigt.
|-
|drive-up-time-to-100
|Ganzzahl
|20
|Zeit in Sekunden, die das Rollo vom geschlossenen zum offenen Zustand benötigt (meist geringfügig höher als drive-down-time-to-100).
|-
|automatic-enabled
| on,off
| on
|Dieses Attribut wird nur für die Modulerweiterung 44_ROLLADEN_Automatic benötigt.
Hiermit kann die automatische Szenariensteuerung für den Rolladen deaktiviert werden.
|-
|automatic-delay
|0,5,10,15,<BR/>20,30,45,60
|0
|Dieses Attribut wird nur für die Modulerweiterung ROLLADEN_Automatic benötigt.
Hiermit kann einge Zeitverzögerund für den Rolladen eingestellt werden, werden die Rolladen per Automatic heruntergefahren, so wird dieser um die angegebenen minuten später heruntergefahren.
|}

=== Settings ===
Es gibt mehrere Settings die das Rollo in eine bestimmte Position fahren:

<code>set <name> <geschlossen></code> Fährt das Rollo komplett herunter (Position 100)

<code>set <name> <offen></code> Fährt das Rollo komplett nach oben (Position 0)

<code>set <name> <schlitz></code> Fährt das Rollo soweit herunter das nur die Rolloschlitze offen sind (Position 90)

<code>set <name> <position> <value></code> Fährt das Rollo auf eine beliebige Position zwischen 0 (offen) - 100 (geschlossen)

Weitere Fahrbefehle für das Rollo:

<code>set <name> <stop></code> Stopt ein fahrendes Rollo unabhängig davon ob die vorher angegebene Zielposition erreicht wurde.

<code>set <name> <toggle></code> Fährt das Rollo in die entgegengesetzte Richtung wie beim letzten mal bis zur jeweiligen Endposition.
Fährt das Rollo gerade, wird es zuerst gestoppt und danach ebenfalls in die entgegengesetzte Richtung gefahren.

Sonstige Set-Befehle

<code>set <name> extern <position:offen,geschlossen,schlitz,stop></code> Startet alle Berechnungen und internen Timer im Modul, aktiviert aber nicht die konfigurierte Hardware (nützlich wenn diese bereits aktiviert wurde, um den Status der Oberfläche mit dem Ist-Zustand synchron zu halten. siehe auch [[#Zusammenspiel mit externem Taster]])

<code>set <name> reset <position:offen,geschlossen> </code> Setzt den internen Status des Rollo auf offen bzw. geschlossen ohne irgendwelche weiteren Aktionen durchzuführen.

== Anwendungsbeispiele ==
===Define===
define meinRollo ROLLO myMcp23017 PortA0 PortA1 Typ1
Die Rollo-Kanäle sind Readings des Mcp23017-Device

define meinRollo ROLLO - Rollo_KanalA Rollo_KanalB
Die Rollo-Kanäle sind in fhem Eigenständige Devices, der Parameter <device> wurde deshalb mit einem "-" deaktiviert

===Set===
set RolladenWohnzimmer position 50
set RolladenWohnzimmer geschlossen
set RolladenWohnzimmer offen
Drei Beispiele das Rollo-Modul anzuweisen verschiedene Positionen anzufahren.

set RolladenWohnzimmer extern stop
Das Rollo-Modul wird angewiesen den status auf "nicht fahren" zu setzen, die aktuelle Rollo-Position zu berechnen und als neue Position abzuspeichern. Der eigentliche Rollo-Stop-Befehl wird dabei aber nicht gesendet.

set RolladenWohnzimmer reset geschlossen
In der Oberfläche von fhem wird für das Rollo die Position "geschlossen" gespeichert, ohne Berechnungen durchzuführen oder Hardware zu steuern. Wird eevtl. benötigt wenn der Ist-Status von den Soll-Werten aus fhem abweicht.

===Zusammenspiel mit externem Taster===
In einem Anwendungszenario hat ein Nutzer zusätzliche Taster an seinem Rollo-Motor über die er ihn ebenfalls steuern kann.
Die Taster selber senden keine Events an fhem, nur der Rollo-Motor.
Hier ein Beispiel wie das ganze für Typ2-Rollos aussehen könnte und diese Taster in das ROLLO-Modul integriert werden:

define rollo_manuell_auf DOIF ([meinRollo_Kanal1] eq "on" and [meinRolloModul] ne "drive-up") (set meinRolloModul extern offen) DOELSEIF ([meinRollo_Kanal1] eq "off" and [meinRolloModul] eq "drive-up") (set meinRolloModul extern stop)
define rollo_manuell_ab DOIF ([meinRollo_Kanal2] eq "on" and [meinRolloModul] ne "drive-down") (set meinRolloModul extern geschlossen) DOELSEIF ([meinRollo_Kanal2] eq "off" and [meinRolloModul] eq "drive-down") (set meinRolloModul extern stop)

meinRollo_Kanal1 und meinRollo_Kanal2 sind die Hardwarekanäle die in dem Rollo-Modul zum hochfahren/runterfahren benutzt werden. In diesem Beispiel ist das Rollo als Typ2 (ein Kanal hoch, zweiter Kanal runter) definiert.
Das erste DOIF prüft ob das Rollo hoch fährt, ohne das das Rollo-Modul davon etwas weis. Ist dem so wird dem Rollo Modul mithilfe des set <extern> mitgeteilt das das Rollo bereits gestartet wurde. Das Modul fängt an die Zeit zu zählen und aktualisiert den Status der Oberfläche auf "fahre hoch".
IM DOELSEIF wird abgefragt ob das Rollo steht, obwohl das Modul denkt das Rollo würde noch fahren. Ist dem so wird wieder mithilfe des set <extern> dem Modul mitgeteilt das das Rollo gestoppt wurde. Das Modul berechnet nun aufgrund der gefahrenen Zeit die aktuelle Position und aktualisiert den Status der Oberfläche auf die Position.

Das gleiche wird dann im zweiten DOIF nochmal für das herunterfahren gemacht.

Man kann nun das Rollo sowohl über die Oberfläche als auch per Taster bedienen und fhem und der reale Ist-Status sind synchron. Ach eine gleichzeitige Bedienung ist möglich, Das Rollo startet z.B. aufgrund einer Automatisierung morgens zum hochfahren und man klickt schnell auf den Taster neben dem Bett und stoppt das ganze wieder.

== Links ==
Thread im {{Link2Forum|Topic=47202|LinkText=Forum}} mit der jeweils aktuellen Version des Moduls als Anhang im ersten Beitrag.

ROLLO

2016-01-14T08:56:56Z

ThomasRamm: /* Zusammenspiel mit externem Taster */

{{SEITENTITEL:ROLLO}}
{{Infobox Modul
|ModPurpose=Rollo-Steuerung zur einfachen Anzeige/Programmierung
|ModType=x
|ModFTopic=47202


|ModForumArea=Codeschnipsel
|ModTechName=44_ROLLO.pm
|ModOwner=ThomasRamm}}
Das Modul [[ROLLO]] bietet eine einfache Möglichkeit, mit ein bis zwei Relais den Hoch-/Runterlauf eines Rolladen zu steuern und punktgenau anzuhalten. Außerdem wird die aktuelle Position in fhem abgebildet.
Über welche Hardware/Module die Ausgänge angesprochen werden ist dabei egal.
__TOC__
Das Modul unterstützt verschiedenste Konfigurationen welche Befehle ausgeführt werden müssen um die Hardware des Rollos zu steuern.
Weitere Konfigurationen können im Forum angefragt werden.

Besonderheiten:
* Wird in einer Konfiguration ein Kanal für die Richtung, der zweite für das Aktivieren des Rollos genutzt (z.B. Typ1), wird immer vor einem Rollo-Start die Richtung gesetzt. Bei einem Richtungswechsel während der Fahrt wird der Rollo für 1 sekunde gestoppt und dann in der Gegenrichtung gestartet.

* Fährt das Rollo zur Position offen oder geschlossen, wird der Motor noch 5 sec. länger auf on gelassen, um Positionsverschiebungen aufgrund ungenauer Parameter auszugleichen. Bei jedem vollständigen schließen/öffnen ist die Position damit wieder korrekt.

* Die Rollo-Position wird in 10%-Schritten von 0% (offen) bis 100% (geschlossen) zwischengespeichert um auf der Oberfläche für jede Position ein Icon festlegen zu können. Die Ungenauigkeiten die dadurch zwischen echter Position und gespeicherter Position entstehen, werden durch oben angeführte Korrektur ausgeglichen.

[[Datei:Rolladen Eintrag.PNG|right|thumb|400px|Verschiedene Ansichten des Rollo:offen, fährt gerade herunter, position 50, fährt gerade hoch, geschlossen]]
Vorteil dieses Moduls:

Ist ein Rollo mit diesem Modul definiert kann man auf der Oberfläche per Klick das Rollo hoch/runter oder auf eine bestimmte Position fahren. Der aktuelle Status des Rollo (fährt hoch/runter,offen,geschlossen,etc.) wird angezeigt.
Die Oberflächenicons werden per devStateIcon gesteuert, Icons und Farben können für jeden Status individuell formatiert werden, die Standard Kommandos auf der Oberfläche (hier: offen, geschlossen, schlitz, Position) können ebenfalls per Attribut angepasst werden.
Beim Anlegen des Moduls werden die Attribute zur Darstellung in fhem mit Standardwerten angelegt, so dass man sich einiges an Tipparbeit sparen kann, aber trotzdem die Möglichkeit hat die Darstellung individuell anzupassen.

== Voraussetzungen ==
Es müssen in fhem 2 Kanäle konfiguriert sein die mit on/off gesteuert werden können. Diese Kanäle können als Readings eines device oder als eigenständige definitionen in fhem existieren.

== Anwendung ==
=== Define ===
define <name> ROLLO <device> <ausgang1> <ausgang2> <Typ>

'''Parameter:'''
{|class="wikitable sortable"
|-
!Parameter !! class="unsortable"|Beschreibung
|-
|<name>||Name des Modul
|-
|<device>||Name des Hardwaremoduls dessen Readings die Kanäle sind. Sollten die Kanäle eigene definitionen in fhem sein, dann hier ein "-" eingeben.
|-
|<ausgang1>||Name des Device-Reading oder des fhem Geräts von Kanal 1
|-
|<ausgang2>||Name des zweiten Device-Reading bzw. fhem Geräts für Kanal 2
|-
|<typ>||Art der Kanalsteuerung. Mögliche Werte sind:<BR/>
Typ1,Typ2,Typ3,FS20ru. Eine Auflistung der Funktionsweise enthält der nächste Bereich.
|}

'''Typen'''
{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ1
|-
!Kanal 1!!Kanal 2!!Status
|-
|On||Off||hoch
|-
|On||On||runter
|-
|Off||Off||stop
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ2
|-
!Kanal 1!!Kanal 2!!Status
|-
|On||Off||hoch
|-
|Off||On||runter
|-
|Off||Off||stop
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ3
|-
!Kanal 1!!Kanal 2!!Status
|-
|Off||-||hoch
|-
|On||-||runter
|-
| -||On||stoppt das hochfahren
|-
| -||Off||stoppt das herunterfahren
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|FS20rsu
|-
!Kanal 1!!Status
|-
|On||hoch
|-
|Off||runter
|-
|On||stoppt das hochfahren
|-
|Off||stoppt das herunterfahren
|}

<div style="clear:both;"></div>
=== Attribute ===
{|class="wikitable"
|-
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung
|-
|drive-down-time-to-100
|Ganzzahl
|20
|Zeit in Sekunden die das Rollo vom offenen zum geschlossenen Zustand benötigt.
|-
|drive-up-time-to-100
|Ganzzahl
|20
|Zeit in Sekunden, die das Rollo vom geschlossenen zum offenen Zustand benötigt (meist geringfügig höher als drive-down-time-to-100).
|-
|automatic-enabled
| on,off
| on
|Dieses Attribut wird nur für die Modulerweiterung 44_ROLLADEN_Automatic benötigt.
Hiermit kann die automatische Szenariensteuerung für den Rolladen deaktiviert werden.
|-
|automatic-delay
|0,5,10,15,<BR/>20,30,45,60
|0
|Dieses Attribut wird nur für die Modulerweiterung ROLLADEN_Automatic benötigt.
Hiermit kann einge Zeitverzögerund für den Rolladen eingestellt werden, werden die Rolladen per Automatic heruntergefahren, so wird dieser um die angegebenen minuten später heruntergefahren.
|}

=== Settings ===
Es gibt mehrere Settings die das Rollo in eine bestimmte Position fahren:

<code>set <name> <geschlossen></code> Fährt das Rollo komplett herunter (Position 100)

<code>set <name> <offen></code> Fährt das Rollo komplett nach oben (Position 0)

<code>set <name> <schlitz></code> Fährt das Rollo soweit herunter das nur die Rolloschlitze offen sind (Position 90)

<code>set <name> <position> <value></code> Fährt das Rollo auf eine beliebige Position zwischen 0 (offen) - 100 (geschlossen)

Weitere Fahrbefehle für das Rollo:

<code>set <name> <stop></code> Stopt ein fahrendes Rollo unabhängig davon ob die vorher angegebene Zielposition erreicht wurde.

<code>set <name> <toggle></code> Fährt das Rollo in die entgegengesetzte Richtung wie beim letzten mal bis zur jeweiligen Endposition.
Fährt das Rollo gerade, wird es zuerst gestoppt und danach ebenfalls in die entgegengesetzte Richtung gefahren.

Sonstige Set-Befehle

<code>set <name> extern <position:offen,geschlossen,schlitz,stop></code> Startet alle Berechnungen und internen Timer im Modul, aktiviert aber nicht die konfigurierte Hardware (nützlich wenn diese bereits aktiviert wurde, um den Status der Oberfläche mit dem Ist-Zustand synchron zu halten. siehe auch [[#Zusammenspiel mit externem Taster]])

<code>set <name> reset <position:offen,geschlossen> </code> Setzt den internen Status des Rollo auf offen bzw. geschlossen ohne irgendwelche weiteren Aktionen durchzuführen.

== Anwendungsbeispiele ==
===Define===
define meinRollo ROLLO myMcp23017 PortA0 PortA1 Typ1
Die Rollo-Kanäle sind Readings des Mcp23017-Device

define meinRollo ROLLO - Rollo_KanalA Rollo_KanalB
Die Rollo-Kanäle sind in fhem Eigenständige Devices, der Parameter <device> wurde deshalb mit einem "-" deaktiviert

===Set===
set RolladenWohnzimmer position 50
set RolladenWohnzimmer geschlossen
set RolladenWohnzimmer offen
Drei Beispiele das Rollo-Modul anzuweisen verschiedene Positionen anzufahren.

set RolladenWohnzimmer extern stop
Das Rollo-Modul wird angewiesen den status auf "nicht fahren" zu setzen, die aktuelle Rollo-Position zu berechnen und als neue Position abzuspeichern. Der eigentliche Rollo-Stop-Befehl wird dabei aber nicht gesendet.

set RolladenWohnzimmer reset geschlossen
In der Oberfläche von fhem wird für das Rollo die Position "geschlossen" gespeichert, ohne Berechnungen durchzuführen oder Hardware zu steuern. Wird eevtl. benötigt wenn der Ist-Status von den Soll-Werten aus fhem abweicht.

===Zusammenspiel mit externem Taster===
In einem Anwendungszenario hat ein Nutzer zusätzliche Taster an seinem Rollo-Motor über die er ihn ebenfalls steuern kann. Die Taster selber senden keine Events an fhem, nur der Rollo-Motor.
Mit folgender Definition können diese Taster in das ROLLO-Modul integriert werden:

define rollo_manuell_auf DOIF ([meinRollo_Kanal1] eq "on" and [meinRolloModul] ne "drive-up") (set meinRolloModul extern offen) DOELSEIF ([meinRollo_Kanal1] eq "off" and [meinRolloModul] eq "drive-up") (set meinRolloModul extern stop)
define rollo_manuell_ab DOIF ([meinRollo_Kanal2] eq "on" and [meinRolloModul] ne "drive-down") (set meinRolloModul extern geschlossen) DOELSEIF ([meinRollo_Kanal2] eq "off" and [meinRolloModul] eq "drive-down") (set meinRolloModul extern stop)

meinRollo_Kanal1 und meinRollo_Kanal2 sind die Hardwarekanäle die in dem Rollo-Modul zum hochfahren/runterfahren benutzt werden. In diesem Beispiel ist das Rollo als Typ2 (ein Kanal hoch, zweiter Kanal runter) definiert.
Das erste DOIF prüft ob das Rollo hoch fährt, ohne das das Rollo-Modul davon etwas weis. Ist dem so wird dem Rollo Modul mithilfe des set <extern> mitgeteilt das das Rollo bereits gestartet wurde. Das Modul fängt an die Zeit zu zählen und aktualisiert den Status der Oberfläche auf "fahre hoch".
IM DOELSEIF wird abgefragt ob das Rollo steht, obwohl das Modul denkt das Rollo würde noch fahren. Ist dem so wird wieder mithilfe des set <extern> dem Modul mitgeteilt das das Rollo gestoppt wurde. Das Modul berechnet nun aufgrund der gefahrenen Zeit die aktuelle Position und aktualisiert den Status der Oberfläche auf die Position.

Das gleiche wird dann im zweiten DOIF nochmal für das herunterfahren gemacht.

Man kann nun das Rollo sowohl über die Oberfläche als auch per Taster bedienen und fhem und der reale Ist-Status sind synchron. Ach eine gleichzeitige Bedienung ist möglich, Das Rollo startet z.B. aufgrund einer Automatisierung morgens zum hochfahren und man klickt schnell auf den Taster neben dem Bett und stoppt das ganze wieder.

== Links ==
Thread im {{Link2Forum|Topic=47202|LinkText=Forum}} mit der jeweils aktuellen Version des Moduls als Anhang im ersten Beitrag.

ROLLO

2016-01-14T08:36:45Z

ThomasRamm: Erweiterungsbeispiel:Zusammenspiel mit externem Taster

{{SEITENTITEL:ROLLO}}
{{Infobox Modul
|ModPurpose=Rollo-Steuerung zur einfachen Anzeige/Programmierung
|ModType=x
|ModFTopic=47202


|ModForumArea=Codeschnipsel
|ModTechName=44_ROLLO.pm
|ModOwner=ThomasRamm}}
Das Modul [[ROLLO]] bietet eine einfache Möglichkeit, mit ein bis zwei Relais den Hoch-/Runterlauf eines Rolladen zu steuern und punktgenau anzuhalten. Außerdem wird die aktuelle Position in fhem abgebildet.
Über welche Hardware/Module die Ausgänge angesprochen werden ist dabei egal.
__TOC__
Das Modul unterstützt verschiedenste Konfigurationen welche Befehle ausgeführt werden müssen um die Hardware des Rollos zu steuern.
Weitere Konfigurationen können im Forum angefragt werden.

Besonderheiten:
* Wird in einer Konfiguration ein Kanal für die Richtung, der zweite für das Aktivieren des Rollos genutzt (z.B. Typ1), wird immer vor einem Rollo-Start die Richtung gesetzt. Bei einem Richtungswechsel während der Fahrt wird der Rollo für 1 sekunde gestoppt und dann in der Gegenrichtung gestartet.

* Fährt das Rollo zur Position offen oder geschlossen, wird der Motor noch 5 sec. länger auf on gelassen, um Positionsverschiebungen aufgrund ungenauer Parameter auszugleichen. Bei jedem vollständigen schließen/öffnen ist die Position damit wieder korrekt.

* Die Rollo-Position wird in 10%-Schritten von 0% (offen) bis 100% (geschlossen) zwischengespeichert um auf der Oberfläche für jede Position ein Icon festlegen zu können. Die Ungenauigkeiten die dadurch zwischen echter Position und gespeicherter Position entstehen, werden durch oben angeführte Korrektur ausgeglichen.

[[Datei:Rolladen Eintrag.PNG|right|thumb|400px|Verschiedene Ansichten des Rollo:offen, fährt gerade herunter, position 50, fährt gerade hoch, geschlossen]]
Vorteil dieses Moduls:

Ist ein Rollo mit diesem Modul definiert kann man auf der Oberfläche per Klick das Rollo hoch/runter oder auf eine bestimmte Position fahren. Der aktuelle Status des Rollo (fährt hoch/runter,offen,geschlossen,etc.) wird angezeigt.
Die Oberflächenicons werden per devStateIcon gesteuert, Icons und Farben können für jeden Status individuell formatiert werden, die Standard Kommandos auf der Oberfläche (hier: offen, geschlossen, schlitz, Position) können ebenfalls per Attribut angepasst werden.
Beim Anlegen des Moduls werden die Attribute zur Darstellung in fhem mit Standardwerten angelegt, so dass man sich einiges an Tipparbeit sparen kann, aber trotzdem die Möglichkeit hat die Darstellung individuell anzupassen.

== Voraussetzungen ==
Es müssen in fhem 2 Kanäle konfiguriert sein die mit on/off gesteuert werden können. Diese Kanäle können als Readings eines device oder als eigenständige definitionen in fhem existieren.

== Anwendung ==
=== Define ===
define <name> ROLLO <device> <ausgang1> <ausgang2> <Typ>

'''Parameter:'''
{|class="wikitable sortable"
|-
!Parameter !! class="unsortable"|Beschreibung
|-
|<name>||Name des Modul
|-
|<device>||Name des Hardwaremoduls dessen Readings die Kanäle sind. Sollten die Kanäle eigene definitionen in fhem sein, dann hier ein "-" eingeben.
|-
|<ausgang1>||Name des Device-Reading oder des fhem Geräts von Kanal 1
|-
|<ausgang2>||Name des zweiten Device-Reading bzw. fhem Geräts für Kanal 2
|-
|<typ>||Art der Kanalsteuerung. Mögliche Werte sind:<BR/>
Typ1,Typ2,Typ3,FS20ru. Eine Auflistung der Funktionsweise enthält der nächste Bereich.
|}

'''Typen'''
{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ1
|-
!Kanal 1!!Kanal 2!!Status
|-
|On||Off||hoch
|-
|On||On||runter
|-
|Off||Off||stop
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ2
|-
!Kanal 1!!Kanal 2!!Status
|-
|On||Off||hoch
|-
|Off||On||runter
|-
|Off||Off||stop
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|Typ3
|-
!Kanal 1!!Kanal 2!!Status
|-
|Off||-||hoch
|-
|On||-||runter
|-
| -||On||stoppt das hochfahren
|-
| -||Off||stoppt das herunterfahren
|}

{|class="wikitable" style="float:left; margin-right:1em"
|-
!colspan=3|FS20rsu
|-
!Kanal 1!!Status
|-
|On||hoch
|-
|Off||runter
|-
|On||stoppt das hochfahren
|-
|Off||stoppt das herunterfahren
|}

<div style="clear:both;"></div>
=== Attribute ===
{|class="wikitable"
|-
! Name !! Datentyp/<BR/>Wertebereich !! Default-Wert !! Beschreibung
|-
|drive-down-time-to-100
|Ganzzahl
|20
|Zeit in Sekunden die das Rollo vom offenen zum geschlossenen Zustand benötigt.
|-
|drive-up-time-to-100
|Ganzzahl
|20
|Zeit in Sekunden, die das Rollo vom geschlossenen zum offenen Zustand benötigt (meist geringfügig höher als drive-down-time-to-100).
|-
|automatic-enabled
| on,off
| on
|Dieses Attribut wird nur für die Modulerweiterung 44_ROLLADEN_Automatic benötigt.
Hiermit kann die automatische Szenariensteuerung für den Rolladen deaktiviert werden.
|-
|automatic-delay
|0,5,10,15,<BR/>20,30,45,60
|0
|Dieses Attribut wird nur für die Modulerweiterung ROLLADEN_Automatic benötigt.
Hiermit kann einge Zeitverzögerund für den Rolladen eingestellt werden, werden die Rolladen per Automatic heruntergefahren, so wird dieser um die angegebenen minuten später heruntergefahren.
|}

=== Settings ===
Es gibt mehrere Settings die das Rollo in eine bestimmte Position fahren:

<code>set <name> <geschlossen></code> Fährt das Rollo komplett herunter (Position 100)

<code>set <name> <offen></code> Fährt das Rollo komplett nach oben (Position 0)

<code>set <name> <schlitz></code> Fährt das Rollo soweit herunter das nur die Rolloschlitze offen sind (Position 90)

<code>set <name> <position> <value></code> Fährt das Rollo auf eine beliebige Position zwischen 0 (offen) - 100 (geschlossen)

Weitere Fahrbefehle für das Rollo:

<code>set <name> <stop></code> Stopt ein fahrendes Rollo unabhängig davon ob die vorher angegebene Zielposition erreicht wurde.

<code>set <name> <toggle></code> Fährt das Rollo in die entgegengesetzte Richtung wie beim letzten mal bis zur jeweiligen Endposition.
Fährt das Rollo gerade, wird es zuerst gestoppt und danach ebenfalls in die entgegengesetzte Richtung gefahren.

Sonstige Set-Befehle

<code>set <name> extern <position:offen,geschlossen,schlitz,stop></code> Startet alle Berechnungen und internen Timer im Modul, aktiviert aber nicht die konfigurierte Hardware (nützlich wenn diese bereits aktiviert wurde, um den Status der Oberfläche mit dem Ist-Zustand synchron zu halten. siehe auch [[#Zusammenspiel mit externem Taster]])

<code>set <name> reset <position:offen,geschlossen> </code> Setzt den internen Status des Rollo auf offen bzw. geschlossen ohne irgendwelche weiteren Aktionen durchzuführen.

== Anwendungsbeispiele ==
===Define===
define meinRollo ROLLO myMcp23017 PortA0 PortA1 Typ1
Die Rollo-Kanäle sind Readings des Mcp23017-Device

define meinRollo ROLLO - Rollo_KanalA Rollo_KanalB
Die Rollo-Kanäle sind in fhem Eigenständige Devices, der Parameter <device> wurde deshalb mit einem "-" deaktiviert

===Set===
set RolladenWohnzimmer position 50
set RolladenWohnzimmer geschlossen
set RolladenWohnzimmer offen
Drei Beispiele das Rollo-Modul anzuweisen verschiedene Positionen anzufahren.

set RolladenWohnzimmer extern stop
Das Rollo-Modul wird angewiesen den status auf "nicht fahren" zu setzen, die aktuelle Rollo-Position zu berechnen und als neue Position abzuspeichern. Der eigentliche Rollo-Stop-Befehl wird dabei aber nicht gesendet.

set RolladenWohnzimmer reset geschlossen
In der Oberfläche von fhem wird für das Rollo die Position "geschlossen" gespeichert, ohne Berechnungen durchzuführen oder Hardware zu steuern. Wird eevtl. benötigt wenn der Ist-Status von den Soll-Werten aus fhem abweicht.

===Zusammenspiel mit externem Taster===
In einem Anwendungszenario hat ein Nutzer zusätzliche Taster an seinem Rollo-Motor über die er ihn ebenfalls steuern kann. Die Taster selber senden keine Events an fhem, nur der Rollo-Motor.
Mit folgender Definition können diese Taster in das ROLLO-Modul integriert werden:

define rollo_manuell_auf DOIF ([EG_wc_RO_mi_SW_01] eq "on" and [Test_Rollo] ne "drive-up") (set Test_Rollo extern offen) DOELSEIF ([EG_wc_RO_mi_SW_01] eq "off" and [Test_Rollo] eq "drive-up") (set Test_Rollo extern stop)
define rollo_manuell_ab DOIF ([EG_wc_RO_mi_SW_02] eq "on" and [Test_Rollo] ne "drive-down") (set Test_Rollo extern geschlossen) DOELSEIF ([EG_wc_RO_mi_SW_02] eq "off" and [Test_Rollo] eq "drive-down") (set Test_Rollo extern stop)

Das erste DOIF prüft ob das Rollo hoch fährt, ohne das das Rollo-Modul davon etwas weis. Ist dem so wird dem Rollo Modul mithilfe des set <extern> mitgeteilt das das Rollo bereits gestartet wurde. Das Modul fängt an die Zeit zu zählen und aktualisiert den Status der Oberfläche auf "fahre hoch".
IM DOELSEIF wird abgefragt ob das Rollo steht, obwohl das Modul denkt das Rollo würde noch fahren. Ist dem so wird wieder mithilfe des set <extern> dem Modul mitgeteilt das das Rollo gestoppt wurde. Das Modul berechnet nun aufgrund der gefahrenen Zeit die aktuelle Position und aktualisiert den Status der Oberfläche auf die Position.

Das gleiche wird dann im zweiten DOIF nochmal für das herunterfahren gemacht.

Man kann nun das Rollo sowohl über die Oberfläche als auch per Taster bedienen und fhem und der reale Ist-Status sind synchron. Ach eine gleichzeitige Bedienung ist möglich, Das Rollo startet z.B. aufgrund einer Automatisierung morgens zum hochfahren und man klickt schnell auf den Taster neben dem Bett und stoppt das ganze wieder.

== Links ==
Thread im {{Link2Forum|Topic=47202|LinkText=Forum}} mit der jeweils aktuellen Version des Moduls als Anhang im ersten Beitrag.

ROLLO

2016-01-13T23:31:48Z

ThomasRamm:

Datei:Rolladen Eintrag.PNG

2016-01-13T23:09:43Z

ThomasRamm:

ROLLO

2016-01-13T23:03:32Z

ThomasRamm: Neue Seite für Modul 44_ROLLO.pm