Home

Awesome

ESP8266-Wifi-Relay

Inhaltsverzeichnis

Spezifikation

Installation

Anschluss

Achtung Sobald L/N (~230V) angeschlossen sind und Netzspannung anliegt, die Platine nicht mehr berühren!

Konfiguration

Quick Setup

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)

HOTSPOT Config-Page

Legacy Setup

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).

ESPlorer

SHC Schaltserver

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:

MQTT

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).

Pimatic

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
-----------------------------------------------

pimatic-switch

Funktioniert alles Korrekt, sollten sich im ESPlorer nach manueller Betätigung von "Switch1" folgende Debugzeilen abbilden

pimatic-switch-debug

... und sich der Schalterzustand in Pimatic entsprechend anpassen.

Bei Umlegen des schalters in Pimatic erscheinen fogende Debugzeilen (im ESPlorer sichtbar):

pimatic-switch-debug2

Manuelle Steuerung

Wollt ihr an der Platine einen Taster/Schalter anschliesen, bitte dafür GND / GPIO12 und GND / GPIO13 nutzen ( schaltet nach GND )

Alternative Steuerungen

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.

PHP Script (tcp.php)

BefehlBeschreibungAntwort
php tcp.php 192.168.0.62 2x4x1Dieses Kommando schaltet Relais 1 auf AN
php tcp.php 192.168.0.62 2x4x0Dieses Kommando schaltet Relais 1 auf AUS
php tcp.php 192.168.0.62 2x5x1Dieses Kommando schaltet Relais 2 auf AN
php tcp.php 192.168.0.62 2x5x0Dieses Kommando schaltet Relais 2 auf AUS
php tcp.php 192.168.0.62 3x4Status vom Relais 1 abfragen1/0
php tcp.php 192.168.0.62 3x5Status vom Relais 2 abfragen1/0
php tcp.php 192.168.0.62 4x1DHT22 Daten von Pin 1 abfragenTemp;Luftfeuchte
php tcp.php 192.168.0.62 9x0Version abfragen0.4.0
php tcp.php 192.168.0.62 0x0ESP8266 neustarten
php tcp.php 192.168.0.62 update datei.luaDatei 'datei.lua' hochladen und ESP8266neu starten

192.168.0.62 ist im obigen Beispiel die IP Adresse des ESP8266

HTTP Rückmeldung

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.

OpenHab

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:

Weitere Informationen über OpenHab findet sich in den Ersten Schritten.

Sonstige Informationen

Stromverbrauch

GPIO Mapping

GPIOPINIO indexBemerkung
GPIO0183Flashmodus (wenn auf GND) (DS18D20 - ungetestet)
GPIO12210UART TX
GPIO2174Relais 1 / LED (blau)
GPIO3219UART RX
GPIO4192frei
GPIO5201frei
GPIO1266Schalter/Taster 1
GPIO1377Schalter/Taster 2
GPIO1455Relais 2
GPIO15168frei
GPIO1640sollte nicht genutzt werden (wird für Deep Sleep Mode verwendet)

Pinout

Schaltplan / Schema

Schema

Platinen Maße

Neue Firmware flashen

Programmiermodus: GPIO0 und GND mit einem Jumper verbinden, ESP8266 neu starten. Image mit ESPTOOL flashen:

MacOSX (im Beispiel wird NodeMCU "installiert")

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...
```

### 10A Erweiterung

~~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](https://raspiprojekt.de/kaufen/shop/bausaetze/wifi-relais-zweifach.html))

![10A Erweiterung](/pics/esp8266-10a.png?raw=true)

![Achtung](/pics/achtung-yellow.png?raw=true) angepasst mit Version 2

## Erweiterungen/Ideen (ungetestet)

### Hardware

- ~~Sicherung (z.B. Reichelt *MINI FLINK 1,0A*) vor dem *HLK-PM01* - [Teardown](http://lygte-info.dk/review/Power%20Mains%20to%205V%200.6A%20Hi-Link%20HLK-PM01%20UK.html)~~ umgesetzt mit Version 2
- dahinter MOV (z.B. Reichelt *VDR-0,6 270*)
- Reedkontakt (z.B. Reichelt *KSK 1A66*) als "unsichtbarer" Resetschalter
- ~~DS18B20 Temperatur Sensor~~  umgesetzt mit Version 2 (GPIO auf PIN Leiste)
- ~~DHT22 (an **GPIO5** - Pin 1 angeschlossen)~~  umgesetzt mit Version 2 (GPIO auf PIN Leiste)
![Config-Page](/pics/dht22.jpg?raw=true)

### Software

- regelmäßiger Restart vom ESP8266
  * Remote Neustart via Skript: `php tcp.php 192.168.0.62 0x0` (siehe oben)