ESPEasy

Easy MultiSensor device based on ESP8266. This is a forked repository from main branch, implementing specific features. It should be backwards compatible as it does not introduce many/any changes to the core.

Follow the websites of the main project here:

Wiki: http://www.esp8266.nu Forum: http://www.esp8266.nu/forum

This fork is optimized for use in community wireless network wlan slovenija and with the platform nodewatcher.

Introduction

ESPEasy is firmware for ESP8266 modules that is pre-programmed with software support for a number of sensors. Simply attach sensors and configure then on the web interface. Supported sensors list and more unofficially supported sensors, however these you need to add manually and recompile the firmware. Firstly you need to register the sensor with the server to which the information will be pushed and secondly configure the sensor itself.

Register the sensor with nodewatcher

1. Register and log on nodewatcher
2. Select Register New Node under your user account
3. Turn Advanced mode to ON on top right
4. Now select Disable defaults
5. Select the sensor name by entering it into Name field
6. Select Platform to be ---------
7. Configure location on the map if you wish
8. Select Telemetry source to be Push from Node
9. Add Identity Mechanisms field and select HMAC Signature
10. Tick the box Trusted
11. Pick your key and enter it in the field. Note that key as you will need to enter it into Controller User Account field on the sensor
12. Change or use the system generated Authentication field, you will need to enter it into Admin password field on the sensor
13. Remove Router Identifier
14. Remove DNS servers

Instructions

1. Get firmware or compile your own. Follow original instructions for flashing for nodewatcher support download firmware from this repository.
2. Upload firmware and wait for the device to boot, may take a few minutes. You will see WiFi network ESP_0 appear and log-in with configesp password.
3. Once connected go to http://192.168.4.1
4. Configure WiFi network, for example choose open.wlan-si.net and enter password, for an open network enter any password.
5. Now the device will connect to the network and let you know the new device IP.
6. Connect you computer to the network the device is connected to and go the its IP.

Configuring for use with nodewatcher

1. Go to config and enter the following:
2. Enter Name to be the same as on nodewatcher
3. Enter an Admin password, the same as on nodewatcher
4. Select Protocol to be Nodewatcher JSON HTTP
5. Set Locate Controller to push.nodes.wlan-si.net or whatever your server is
6. Set Controller User Account to your sensor UUID as determined on nodewatcher. That is the set of numbers and letters following https://nodes.wlan-si.net/node/ in the URL. Note that you do not enter the trailing /
7. Set Controller Password to your sensor HMAC Signature as determined on nodewatcher.
8. Set Sensor Delay to how often do you want the node to wake up if put in Sleep mode. Note you need to connect two pins of ESP together for Sleep mode to work.
9. Click Submit

Configuring sensors

1. Go to Devices tab
2. Click on Edit to add a new device
3. Pick Device, it may be hardware or software feature.
4. Configure WiFi signal reporting by selecting Device to be System Info
5. Pick Name to be rssi, note all devices configured must have different name.
6. Set Delay to show how often a variable will be reported. 300 is a good value.
7. Set IDX / Var to be non-zero, best 1
8. Set Indicator to be WiFi RSSI
9. Set Value Name 1 to what data name on the graph will be, follow by comma and unit, optionally followed by group setting, this case: RSSI,dBm. Note that you do not need to define the group, bike in this case.
10. Click Submit
11. Click on Devices in top menu to see the value
12. Repeat the process for different sensors, for example with DS18B20.
13. Configure Temperature by selecting Device to be Temperature - DS18b20
14. Pick Name to be temp_1, note all devices configured must have a different name.
15. Set Delay to show how often a variable will be reported. 300 is a good value.
16. Set IDX / Var to be non-zero, in this case 1
17. Set 1st GPIO to be pin which you have the sensor connected to
18. Set Value Name 1 to what data name on the graph will be, follow by comma and unit, followed by group setting, this case: YourTempName1,C,group_1. Note that you do not need to define the group, but all measurements that have the same group defined will be put on a single graph.
19. Click Submit
20. Now the Device Nr will show one or more ROM IDs if connection to sensors works. Pick first one.
21. Click Submit
22. Go to Device menu and repeat the process for next sensor
23. Pick different name.
24. Click Submit
25. Now the Device Nr will show one or more ROM IDs if connection to sensors works. Pick second one and enter Value Name 1
26. Click Submit