Sobald L/N (~230V) angeschlossen sind und Netzspannung anliegt, die Platine nicht mehr berühren!
A) Beim ersten Start des ESP8266-Wifi-Relay wird ein HOTSPOT (nach ca. 10 Sekunden leuchtet die Blaue LED am ESP8266 3x kurz / das Relais schaltet 3x) mit der SSID: RelaySetup erstellt. Sobald man mit diesem Hotspot verbunden ist, kann man auf http://192.168.4.1/
die Zugangsdaten des eigenen WLAN-Netzes eingeben. Nach dem Speichern der Daten, startet der ESP8266 neu und versucht sich zu verbinden. Im Fehlerfall (WLAN nicht erreichbar, Zugangsdaten falsch) beginnt das ESP8266-Wifi-Relay wieder bei Schritt A)
Sofern alles geklappt hat, startet der TCP-Server auf Port 9274 und es können Befehle ausführt werden (z.b. Dateien auf den ESP8266 übertragen - siehe Befehls-Tabelle weiter unten)
Als ersten Schritt GND, RX, TX mit einem TTL-USB Adapter (Achtung: 3.3 Volt Pegel, bei 5 Volt muss ein Pegelwandler "Levelshifter" verwendet werden) verbinden. RX wird mit TX verbunden und TX mit RX. Dann L, N anschließen (siehe Anschlussplan).
Sobald Netz-Spannung anliegt, sollte der ESP8266 auf der Rückseite der Platine starten und die blaue LED kurz aufblinken. Jetzt habt ihr die Möglichkeit die eigentliche Steuerungs-Software (actuator.lua) auf dem ESP8266 zu übertragen.
Dazu bitte die actuator.lua öffen, die WLAN Daten anpassen und die Datei mit dem ESPlorer auf den ESP8266 kopieren (über Save im ESPlorer). Nach dem erfolgreichen Übertragen, wird automatisch der TCP-Server gestartet und es wird die IP vom ESP8266 angezeigt (rechtes Fenster).
Um aus der "Ferne" die Relais zu steuern, hat man die Möglichkeit in SHC einen Schalterserver einzutragen mit der IP des ESP8266-Wifi-Relay und Port 9274 ( GPIO lesen JA, GPIO schreiben JA - geeignetes Model z.B. Arduino Nano )
Nun kann man unter Schaltfunktionen Ausgänge anlegen ( als Schalterserver den neu erstellten auswählen und als GPIO4/5 )
Damit in SHC auch die Rückmeldung funktioniert, wenn manuell geschaltet wird, muss in der actuator.lua noch folgendes angepasst werden:
send_to_visu
bitte PLATFORM = "SHC" setzen/var/www/shc
geht und dort ein php index.php app=shc -sw –l
eingebt. Nun wird euch eine Liste mit allen schaltbaren Elementen angezeigt. Die SIDs jetzt bitte anpassen.)Das ESP8266-Wifi-Relay lässt sich auch via MQTT steuern/abfragen. Hierfür bitte init.lua und aktor.lua verwenden (Achtung: die Dateien müssen angepasst werden).
Um das ESP8266-Wifi-Relay via Pimatic anzusteuern, ist folgende anpassung erforderlich:
-- pimatic-edition 02.02.2016
ACTUATOR_VERSION = "0.4.0.pimatic"
-- user defined options
RELAY1_SID = "Licht_Arbeitszimmer"
RELAY1_SID = "Schlafzimmer_Lampe1"
-----------------------------------------------
function send_to_visu(sid, cmd)
local PLATFORM = "Pimatic"
local HOST = "192.168.8.200"
local port = 80
local link = ""
local BASE_LOGIN_PIMATIC = "YWRtaW46YzRqc2luOGQ="
if (PLATFORM == "Pimatic") then
local switch
if (cmd == 1) then
switch = "true"
elseif (cmd == 0) then
switch = "false"
end
port = 80
link = "/api/device/"..sid.."/changeStateTo?state="..switch..""
end
if (PLATFORM == "Openhab") then
local switch
if (cmd == 1) then
switch = "ON"
elseif (cmd == 0) then
switch = "OFF"
end
port = 8080
link = "/CMD?" ..sid.."=" ..switch
end
print(link)
local conn = net.createConnection(net.TCP, 0)
conn:send("GET "..link.." HTTP/1.1\r\n")
conn:send("Authorization: Basic "..BASE_LOGIN_PIMATIC.."\r\n")
conn:send("Host: "..HOST.."\r\n")
conn:send("Content-Type:application/json\r\n")
conn:send("Connection: close\r\n")
conn:send("Accept: */*\r\n\r\n")
time_before = tmr.now()
conn:on("receive", function(conn, payload)
print('Retrieved in '..((tmr.now()-time_before)/1000)..' milliseconds.\n')
--print(payload)
conn:close()
end)
conn:connect(port, HOST)
end
-----------------------------------------------
Konfiguriert nun folgede Zeilen und Speichert die actuator.lua auf dem ESP8266:
Kopiert nun die tcp.php auf euer RaspberryPi (hier im Beispiel /home/pi/tcp.php) z.b. mit wget https://raw.githubusercontent.com/JanGoe/esp8266-wifi-relay/master/tcp.php
Stellt sicher dass php5 am RaspberryPi installiert ist (ggf. "sudo apt-get install php5")
Anschließend fügt ihr folgende Device der Pimatic-Konfiguration an:
{
"id": "Licht_Arbeitszimmer",
"name": "Lamp",
"class": "ShellSwitch",
"onCommand": "php /home/pi/tcp.php 192.168.8.3 2x4x1",
"offCommand": "php /home/pi/tcp.php 192.168.8.3 2x4x0",
"getStateCommand": "echo false",
"interval": 0
}
Funktioniert alles Korrekt, sollten sich im ESPlorer nach manueller Betätigung von "Switch1" folgende Debugzeilen abbilden
... und sich der Schalterzustand in Pimatic entsprechend anpassen.
Bei Umlegen des schalters in Pimatic erscheinen fogende Debugzeilen (im ESPlorer sichtbar):
Wollt ihr an der Platine einen Taster/Schalter anschliesen, bitte dafür GND / GPIO12 und GND / GPIO13 nutzen ( schaltet nach GND )
Wer die Platine nicht mit SHC betreiben möchte, kann diese natürlich auch über einfache TCP Befehle steuern.
Wer die Relais gegeneinander verriegeln möchte, bitte in der actuator.lua INTERLOCK_ENABLED = true
setzen, damit kann immer nur 1 Relais geöffnet sein.
Befehl | Beschreibung | Antwort |
---|---|---|
php tcp.php 192.168.0.62 2x4x1 |
Dieses Kommando schaltet Relais 1 auf AN | |
php tcp.php 192.168.0.62 2x4x0 |
Dieses Kommando schaltet Relais 1 auf AUS | |
php tcp.php 192.168.0.62 2x5x1 |
Dieses Kommando schaltet Relais 2 auf AN | |
php tcp.php 192.168.0.62 2x5x0 |
Dieses Kommando schaltet Relais 2 auf AUS | |
php tcp.php 192.168.0.62 3x4 |
Status vom Relais 1 abfragen | 1/0 |
php tcp.php 192.168.0.62 3x5 |
Status vom Relais 2 abfragen | 1/0 |
php tcp.php 192.168.0.62 4x1 |
DHT22 Daten von Pin 1 abfragen | Temp;Luftfeuchte |
php tcp.php 192.168.0.62 9x0 |
Version abfragen | 0.4.0 |
php tcp.php 192.168.0.62 0x0 |
ESP8266 neustarten | |
php tcp.php 192.168.0.62 update datei.lua |
Datei 'datei.lua' hochladen und ESP8266neu starten |
192.168.0.62 ist im obigen Beispiel die IP Adresse des ESP8266
Möchte man Rückmeldungen vom manuellen Schalten auswerten geht dieses via HTTP ( der ESP8266 sendet einen HTTP-GET-REQUEST an eine gewünschte Seite - dazu bitte die Funktion send_to_visu
in der (actuator.lua) anpassen.
Beispiel für OpenHab ( Benötigt PHP auf dem OpenHab Host und das EXEC Binding )
Bitte in der Items Datei (<openhab_installation_dir>/configurations/items
) folgendes eintragen:
Switch Schalter "Lampe1" {exec=">[ON:php /var/www/tcp.php 192.168.0.62 2x3x1] >[OFF:php /var/www/tcp.php 192.168.0.62 2x3x0]"}
192.168.0.62 ist im obigen Beispiel die IP Adresse des ESP8266
Für Rückmeldungen in Openhab bitte in der actuator.lua folgende Zeilen anpassen:
send_to_visu
PLATFORM = "Openhab" setzenWeitere Informationen über OpenHab findet sich in den Ersten Schritten.
GPIO | PIN | IO index | Bemerkung |
---|---|---|---|
GPIO0 | 18 | 3 | Flashmodus (wenn auf GND) (DS18D20 - ungetestet) |
GPIO1 | 22 | 10 | UART TX |
GPIO2 | 17 | 4 | Relais 1 / LED (blau) |
GPIO3 | 21 | 9 | UART RX |
GPIO4 | 19 | 2 | frei |
GPIO5 | 20 | 1 | frei |
GPIO12 | 6 | 6 | Schalter/Taster 1 |
GPIO13 | 7 | 7 | Schalter/Taster 2 |
GPIO14 | 5 | 5 | Relais 2 |
GPIO15 | 16 | 8 | frei |
GPIO16 | 4 | 0 | sollte nicht genutzt werden (wird für Deep Sleep Mode verwendet) |
Programmiermodus: GPIO0 und GND mit einem Jumper verbinden, ESP8266 neu starten. Image mit ESPTOOL flashen:
python ./esptool.py --port=/dev/cu.SLAB_USBtoUART write_flash -fm=dio -fs=32m 0x00000 ../nodemcu-master-8-modules-2015-09-01-02-42-13-float.bin
Connecting...
Erasing flash...
Took 1.62s to erase flash block
Wrote 415744 bytes at 0x00000000 in 44.8 seconds (74.2 kbit/s)...
Leaving...
Obwohl die Relais mit 10A belastet werden könnten, sind die Leiterbahnen zu den Schraubklemmen zu dünn und sind mit maximal 2A belastbar. Um die volle Belastbarkeit erreichen, muss man an der Unterseite der Platine die Leiterbahnen von den Relaisanschlüssen zur Schraubklemme mit tauglichen Drähten überbrücken/verstärken. (siehe raspiprojekt.de)
angepasst mit Version 2
php tcp.php 192.168.0.62 0x0
(siehe oben)