Fork of the espurna firmware for `mhsw` switches
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

80 lines
4.5 KiB

8 years ago
7 years ago
8 years ago
7 years ago
7 years ago
8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
  1. # ESPurna Firmware
  2. ESPurna ("spark" in Catalan) is a custom firmware for ESP8266 based smart switches.
  3. It was originally developed with the **[IteadStudio Sonoff](https://www.itead.cc/sonoff-wifi-wireless-switch.html)** in mind but now it supports a growing number of ESP8266-based boards.
  4. It uses the Arduino Core for ESP8266 framework and a number of 3rd party libraries.
  5. **Current Release Version is 1.5.3**, read the [changelog](CHANGELOG.md).
  6. ## Features
  7. * Support for **multiple ESP8266-based boards**
  8. * Wifi **AP Mode** or **STA mode** with **multiple network definitions** and static IP support
  9. * Switch management
  10. * Configurable **status on boot** (always ON, always OFF, same as before or toggle)
  11. * Support for **pulse mode** (normally ON or normally OFF) with configurable time
  12. * Support for **relay synchronization** (all equal, only one ON, one and only on ON)
  13. * **MQTT** enabled
  14. * Switch on/off and toggle relays
  15. * Enable/disable pulse mode
  16. * LED notifications
  17. * **Alexa** integration using the [FauxmoESP Library](https://bitbucket.org/xoseperez/fauxmoesp)
  18. * [**Domoticz**](https://domoticz.com/) integration via MQTT
  19. * [**Home Assistant**](https://home-assistant.io/) integration via MQTT
  20. * Support for different **sensors**
  21. * DHT11 / DHT22 / DHT21 / AM2301
  22. * DS18B20
  23. * HLW8012 using the [HLW8012 Library](https://bitbucket.org/xoseperez/hlw8012) (Sonoff POW)
  24. * Non-invasive current sensor using the [EmonLiteESP Library](https://bitbucket.org/xoseperez/emonliteesp) (requires some hacking)
  25. * Fast asynchronous **HTTP Server**
  26. * Basic authentication
  27. * Web-based configuration
  28. * Relay switching and sensor data from the web interface
  29. * Websockets-based communication between the device and the browser
  30. * **REST API** (enable/disable from web interface)
  31. * GET and PUT relay status
  32. * GET sensor data (power, current, voltage, temperature and humidity) depending on the available hardware
  33. * **Over-The-Air** (OTA) updates even for 1Mb boards
  34. * Manually from PlatformIO or Arduino IDE
  35. * Automatic updates through the [NoFUSS Library](https://bitbucket.org/xoseperez/nofuss)
  36. * **Command line configuration**
  37. ## Documentation
  38. For more information please refer to the [ESPurna Wiki](https://bitbucket.org/xoseperez/espurna/wiki/Home).
  39. ## Supported hardware
  40. ||||
  41. |-|-|-|
  42. |![IteadStudio S20](images/devices/s20.jpg)|![IteadStudio Slampher](images/devices/slampher.jpg)|![IteadStudio Sonoff 4CH](images/devices/sonoff-4ch.jpg)|
  43. |**IteadStudio S20**|**IteadStudio Slampher**|**IteadStudio Sonoff 4CH**|
  44. |![IteadStudio Sonoff Basic](images/devices/sonoff-basic.jpg)|![IteadStudio Motor Switch](images/devices/motor-switch.jpg)|![IteadStudio 1CH Inching](images/devices/1ch-inching.jpg)|
  45. |**IteadStudio Sonoff Basic**|**IteadStudio Motor Switch**|**IteadStudio 1CH Inching**|
  46. |![IteadStudio Sonoff Dual](images/devices/sonoff-dual.jpg)|![IteadStudio Sonoff POW](images/devices/sonoff-pow.jpg)|![IteadStudio Sonoff TH10/TH16](images/devices/sonoff-th10-th16.jpg)|
  47. |**IteadStudio Sonoff Dual**|**IteadStudio Sonoff POW**|**IteadStudio Sonoff TH10/TH16**|
  48. |![IteadStudio Sonoff RF](images/devices/sonoff-rf.jpg)|![IteadStudio Sonoff SV](images/devices/sonoff-sv.jpg)|![IteadStudio Sonoff Touch](images/devices/sonoff-touch.jpg)|
  49. |**IteadStudio Sonoff RF**|**IteadStudio Sonoff SV**|**IteadStudio Sonoff Touch**|
  50. |![Wemos D1 Mini Relay Shield](images/devices/d1mini.jpg)|![Electrodragon Relay Board](images/devices/electrodragon-relay-board.jpg)|![WorkChoice EcoPlug](images/devices/workchoice-ecoplug.jpg)|
  51. |**Wemos D1 Mini Relay Shield**|**Electrodragon Relay Board**|**WorkChoice EcoPlug**|
  52. |![JanGoe Wifi Relay (NO/NC)](images/devices/jangoe-wifi-relay.png)|![OpenEnergyMonitor WiFi MQTT Relay / Thermostat](images/devices/mqtt-relay.jpg)||
  53. |**JanGoe Wifi Relay (NO/NC)**|**OpenEnergyMonitor WiFi MQTT Relay / Thermostat**||
  54. ## License
  55. Copyright (C) 2016-2017 by Xose Pérez (@xoseperez)
  56. This program is free software: you can redistribute it and/or modify
  57. it under the terms of the GNU General Public License as published by
  58. the Free Software Foundation, either version 3 of the License, or
  59. (at your option) any later version.
  60. This program is distributed in the hope that it will be useful,
  61. but WITHOUT ANY WARRANTY; without even the implied warranty of
  62. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  63. GNU General Public License for more details.
  64. You should have received a copy of the GNU General Public License
  65. along with this program. If not, see <http://www.gnu.org/licenses/>.