ESPurna Firmware
ESPurna ("spark" in Catalan) is a custom firmware for ESP8266 based smart switches.
It was originally developed with the IteadStudio Sonoff in mind but now it supports a growing number of ESP8266-based boards.
It uses the Arduino Core for ESP8266 framework and a number of 3rd party libraries.
Current Release Version is 1.9.7, read the changelog.
NOTICE: Default flash layout changed in 1.8.3, as an unpredicted consequence devices will not be able to persist/retrieve configuration if flashed with 1.8.3 via OTA from PlatformIO. Please check issue #187.
NOTICE: since version 1.9.0 the default MQTT topics for commands have changed. They all now end with "/set". This means you will have to change your controller software (Node-RED or alike) to send messages to -for instance- "/home/living/light/relay/0/set". The device will publish its state in "/home/living/light/relay/0" like before.
Features
- Support for multiple ESP8266-based boards (check list)
- Wifi AP Mode or STA mode
- Up to 5 different networks can be defined
- Supports static IP
- Scans for strongest network if more than one defined
- Defaults to AP mode (also available after double clicking the main button)
- Switch management
- Support for push buttons and toggle switches
- Configurable status on boot (always ON, always OFF, same as before or toggle)
- Support for pulse mode (normally ON or normally OFF) with configurable time
- Support for relay synchronization (all equal, only one ON, one and only on ON)
- Support for delayed ON/OFF
- MQTT enabled
- SSL/TLS support (not on regular builds, see #64)
- Switch on/off and toggle relays
- Report button event notifications
- Enable/disable pulse mode
- Change LED notification mode
- Remote reset the board
- Alexa integration using the FauxmoESP Library
- Google Assistant integration using IFTTT and Webhooks (Google Home, Allo)
- Domoticz integration via MQTT
- Home Assistant integration via MQTT
- Supports MQTT auto-discover feature
- InfluxDB integration via HTTP API
- Support for different sensors
- DHT11 / DHT22 / DHT21 / AM2301 (supports celsius & fahrenheit reporting)
- DS18B20 (supports celsius & fahrenheit reporting)
- HLW8012 using the HLW8012 Library (Sonoff POW)
- Non-invasive current sensor using the EmonLiteESP Library (requires some hacking)
- Raw analog sensor
- Fast asynchronous HTTP Server
- Configurable port
- Basic authentication
- Web-based configuration
- Relay switching and sensor data from the web interface
- Handle color, brightness, and white/warm channels for lights
- Websockets-based communication between the device and the browser
- Backup and restore settings option
- Upgrade firmware from the web interface
- Works great behind a secured reverse proxy
- REST API (enable/disable from web interface)
- GET and PUT relay status
- Change light color (for supported hardware)
- GET sensor data (power, current, voltage, temperature and humidity) depending on the available hardware
- Works great behind a secured reverse proxy
- RPC API (enable/disable from web interface)
- Over-The-Air (OTA) updates even for 1Mb boards
- Manually from PlatformIO or Arduino IDE
- Automatic updates through the NoFUSS Library
- Update from web interface using pre-built images
- Command line configuration
- Change configuration
- Run special commands
- Telnet support
- Available only if connected to the AP interface
- Show debug info and allows to run terminal commands
- Unstable system check
- Detects unstable system (crashes on boot continuously) and defaults to a stable system
- Only WiFi AP, OTA and Telnet available if system is flagged as unstable
- Button interface
- Click to toggle relays
- Double click to enter AP mode (only main button)
- Long click (>1 second) to reboot device (only main button)
- Extra long click (>10 seconds) to go back to factory settings (only main button)
Documentation
For more information please refer to the ESPurna Wiki.
Supported hardware
Here is the list of supported hardware. For more information please refer to the ESPurna Wiki Hardware page.
|
|
|
![Tinkerman Espurna H](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/tinkerman-espurna-h.jpg) |
![IteadStudio Sonoff RF Bridge](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/itead-sonoff-rfbridge.jpg) |
|
Tinkerman ESPurna H |
IteadStudio Sonoff RF Bridge |
|
![IteadStudio Sonoff Basic](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/itead-sonoff-basic.jpg) |
![IteadStudio Sonoff RF](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/itead-sonoff-rf.jpg) |
![Electrodragon WiFi IOT](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/electrodragon-wifi-iot.jpg) |
IteadStudio Sonoff Basic |
IteadStudio Sonoff RF |
Electrodragon WiFi IOT |
![IteadStudio Sonoff Dual](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/itead-sonoff-dual.jpg) |
![IteadStudio Sonoff POW](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/itead-sonoff-pow.jpg) |
![IteadStudio Sonoff TH10/TH16](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/itead-sonoff-th.jpg) |
IteadStudio Sonoff Dual |
IteadStudio Sonoff POW |
IteadStudio Sonoff TH10/TH16 |
![IteadStudio Sonoff 4CH](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/itead-sonoff-4ch.jpg) |
![IteadStudio Sonoff 4CH Pro](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/itead-sonoff-4ch-pro.jpg) |
![OpenEnergyMonitor WiFi MQTT Relay / Thermostat](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/openenergymonitor-mqtt-relay.jpg) |
IteadStudio Sonoff 4CH |
IteadStudio Sonoff 4CH Pro |
OpenEnergyMonitor WiFi MQTT Relay / Thermostat |
![IteadStudio S20](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/itead-s20.jpg) |
![WorkChoice EcoPlug](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/workchoice-ecoplug.jpg) |
![Power meters based on V9261F and ECH1560](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/generic-v9261f.jpg) |
IteadStudio S20 |
WorkChoice EcoPlug |
Power meters based on V9261F and ECH1560 |
![IteadStudio Sonoff Touch](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/itead-sonoff-touch.jpg) |
![IteadStudio Sonoff T1](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/itead-sonoff-t1.jpg) |
|
IteadStudio Sonoff Touch |
IteadStudio Sonoff T1 |
|
![IteadStudio Slampher](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/itead-slampher.jpg) |
![AI-Thinker Wifi Light / Noduino OpenLight](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/aithinker-ai-light.jpg) |
![Itead Sonoff B1](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/itead-sonoff-b1.jpg) |
IteadStudio Slampher |
AI-Thinker Wifi Light / Noduino OpenLight |
IteadStudio Sonoff B1 |
![MagicHome LED Controller](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/magichome-led-controller.jpg) |
![Huacanxing H801](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/huacanxing-h801.jpg) |
![Itead BN-SZ01](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/itead-bn-sz01.jpg) |
MagicHome LED Controller |
Huacanxing H801 |
Itead BN-SZ01 |
![IteadStudio Sonoff SV](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/itead-sonoff-sv.jpg) |
![IteadStudio 1CH Inching](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/itead-1ch-inching.jpg) |
![IteadStudio Motor Clockwise/Anticlockwise](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/itead-motor.jpg) |
IteadStudio Sonoff SV |
IteadStudio 1CH Inching |
IteadStudio Motor Clockwise/Anticlockwise |
![Wemos D1 Mini Relay Shield](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/wemos-d1-mini-relayshield.jpg) |
![Jan Goedeke Wifi Relay (NO/NC)](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/jangoe-wifi-relay.png) |
![Jorge García Wifi + Relays Board Kit](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/jorgegarcia-wifi-relays.jpg) |
Wemos D1 Mini Relay Shield |
Jan Goedeke Wifi Relay (NO/NC) |
Jorge García Wifi + Relays Board Kit |
![EXS Wifi Relay v3.1](/mh/mhsw-espurna/media/commit/c990cc4c11fa334c21c336c63296b65bef5131be/images/devices/exs-wifi-relay-v31.jpg) |
|
|
EXS Wifi Relay v3.1 |
|
|
Other supported boards: Itead Sonoff LED, Huacanxing H802, WiOn 50055, ManCaveMade ESP-Live, InterMitTech QuinLED 2.6, Arilux AL-LC06, Xenon SM-PW702U, Authometion LYT8266.
License
Copyright (C) 2016-2017 by Xose Pérez (@xoseperez)
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see http://www.gnu.org/licenses/.