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.5, 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)
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
IteadStudio Sonoff RF Bridge
IteadStudio Sonoff Basic
IteadStudio Sonoff RF
Electrodragon WiFi IOT
IteadStudio Sonoff Dual
IteadStudio Sonoff POW
IteadStudio Sonoff TH10/TH16
IteadStudio Sonoff 4CH
IteadStudio Sonoff 4CH Pro
OpenEnergyMonitor WiFi MQTT Relay / Thermostat
IteadStudio S20
WorkChoice EcoPlug
Power meters based on V9261F and ECH1560
IteadStudio Sonoff Touch
IteadStudio Sonoff T1
IteadStudio Slampher
AI-Thinker Wifi Light / Noduino OpenLight
IteadStudio Sonoff B1
MagicHome LED Controller
Huacanxing H801
Itead BN-SZ01
IteadStudio Sonoff SV
IteadStudio 1CH Inching
IteadStudio Motor Clockwise/Anticlockwise
Wemos D1 Mini Relay Shield
Jan Goedeke Wifi Relay (NO/NC)
Jorge García Wifi + Relays Board Kit
EXS Wifi Relay v3.1
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/.