ESPEasy

320px

Introductie

De ESP Easy is een firmware versie voor de ESP module waarmee je snel en eenvoudig een plug and play sensor voor Domoticz kan realiseren.

Na het laden van de firmware kun je op verschillende manieren de configuratie instellen naar eigen behoeftr. Het is ook mogelijk om deze configuratie al direct in de sketch te zetten. Dan is verdere configuratie niet meer nodig. Aanpassen na het uploaden kan via Serial of via de webinterface.

Configuratie

via de sketch

Het is mogelijk om alle benodigde settings al in de sketch op te nemen. Hiervoor pas je onderstaande settings aan. Dit is niet verplicht, je kunt dit ook later via serial uitvoeren.

#define DEFAULT_SSID       "ssid"              // Enter your network SSID
#define DEFAULT_KEY        "wpakey"            // Enter your network WPA key
#define DEFAULT_SERVER     "192.168.0.8"       // Enter your Domoticz Server IP address
#define DEFAULT_PORT       8080                // Enter your Domoticz Server port value
#define DEFAULT_DELAY      60                  // Enter your Send delay in seconds
#define DEFAULT_DALLAS_IDX 0                   // Enter IDX of your virtual temperature device
#define DEFAULT_DHT_IDX    0                   // Enter IDX of your virtual Humidity device
#define DEFAULT_DHT_TYPE   11                  // Enter Type of your virtual Humidity device
#define DEFAULT_BMP_IDX    0                   // Enter IDX of your virtual Barometric Pressure device
#define DEFAULT_LUX_IDX    0                   // Enter IDX of your virtual LUX device
#define DEFAULT_RFID_IDX   0                   // Enter IDX of your virtual RFID device
#define DEFAULT_ANALOG_IDX 0                   // Enter IDX of your virtual Analog device

via serial

Geef na het booten het command "settings". Je krijgt dan onderstaand scherm te zien:

Generic settings

 Version   :1
 Unit      :1
 WifiSSID  :ssid
 WifiKey   :wpakey
 ServerIP  :192.168.0.8
 ServerPort:8080
 Delay     :60

Device settings

 Dallas    :0
 DHT       :0
 DHTType   :11
 BMP       :0
 LUX       :0
 RFID      :0
 Analog    :0

Je moet in elk geval de WifiSSID en WifiKey aanpassen naar jouw eigen Wifi netwerk. Daarna met het commando "save" de settings in eeprom opslaan en de ESP opnieuw opstarten. Dat zou voldoende moeten zijn om de eerste verbinding te leggen.

via de webinterface

Vanaf R003 beschikt de ESP Easy over een webinterface voor de configuratie. Een verse ESP heeft geen SSID en zal nu automatisch opstarten als en Wifi Access Point met de naam ESP_1 en de default WPA key op IP adres 192.168.4.1. Maak dus verbinding met je laptop/tablet/smartphone met dit Access Point en start een webbrowser naar 192.168.4.1.

Je ziet dan als het goed is een eenvoudige webinterface waarop je o.a. de Wifi settings voor je eigen netwerk kunt instellen. Dat is stap 1. Na het instellen click je op connect en de ESP zal verbinding gaan maken met je eigen Wifi netwerk. Krijgt dan automatisch via DHCP een IP adres en dit wordt getoond in de webinterface. Schakel nu over naar het nieuwe IP adres. Vervolgens kun je devices instellen en het geheel op gang brengen richting Domoticz.

Voorbeeld Dallas sensor

In Domoticz maak je eerst virtual hardware aan (dummy) en dan een virtuel device van het type "temperatuur". Kijk welk IDX is toegekend door Domoticz. Dit vullen we in bij de settings van ESP Easy. Stel het IDX is 23 dan geven we het commando:

Dallas 23

Vanaf dat moment zal de ESP Easy de Dallas sensor gaan uitlezen en de informatie versturen naar Domoticz.

Aansturen devices

LCD

Het LCD display kan worden aangestuurd via http, zie het volgende commando voorbeeld:

http://<ip van je ESP module>/?cmd=LCDWrite%201,1,Welcome_ESPUser

Tekst wordt op regel 1, positie 1 getoond

MCP IO expander

Je kunt alle 16 output pinnen bedienen van deze unit via http commando's. Deze kun je in Domoticz opnemen bij een switch device. Voorbeeld het inschakelen van pin 1:

http://<ip van je ESP module>/?cmd=ExtWiredOut%201,1

Logging

Voorbeeld:

DS   : Temperature: 21.12
HTTP : Connecting to 192.168.0.8
HTTP : Requesting URL: /json.htm?type=command&param=udevice&idx=113&svalue=21.12
HTTP : Succes!
HTTP : Closing connection
DHT  : Temperature: 22.00
DHT  : Humidity: 19.00
HTTP : Connecting to 192.168.0.8
HTTP : Requesting URL: /json.htm?type=command&param=udevice&idx=148&svalue=22.0
HTTP : Succes!
HTTP : Closing connection
LUX  : Light intensity: 720.00
HTTP : Connecting to 192.168.0.8
HTTP : Requesting URL: /json.htm?type=command&param=udevice&idx=149&svalue=720.0
HTTP : Succes!
HTTP : Closing connection
ADC  : Analog value: 556
HTTP : Connecting to 192.168.0.8
HTTP : Requesting URL: /json.htm?type=command&param=udevice&idx=150&svalue=556.0
HTTP : Succes!
HTTP : Closing connection
RFID : Tag : 12445313
HTTP : Connecting to 192.168.0.8
HTTP : Requesting URL: /json.htm?type=command&param=udevice&idx=151&svalue=12836313.0
HTTP : Succes!
HTTP : Closing connection

Firmware laden

todo...

bin files op ftp server?

esptool voorzien van gui ?