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.
 
 
 
 
 
 

4.5 KiB

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.5.4, read the changelog.

Features

  • Support for multiple ESP8266-based boards
  • Wifi AP Mode or STA mode with multiple network definitions and static IP support
  • Switch management
    • 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)
  • MQTT enabled
    • Switch on/off and toggle relays
    • Enable/disable pulse mode
    • LED notifications
  • Alexa integration using the FauxmoESP Library
  • Domoticz integration via MQTT
  • Home Assistant integration via MQTT
  • Support for different sensors
  • Fast asynchronous HTTP Server
    • Basic authentication
    • Web-based configuration
    • Relay switching and sensor data from the web interface
    • Websockets-based communication between the device and the browser
  • REST API (enable/disable from web interface)
    • GET and PUT relay status
    • GET sensor data (power, current, voltage, temperature and humidity) depending on the available hardware
  • Over-The-Air (OTA) updates even for 1Mb boards
    • Manually from PlatformIO or Arduino IDE
    • Automatic updates through the NoFUSS Library
  • Command line configuration

Documentation

For more information please refer to the ESPurna Wiki.

Supported hardware

IteadStudio S20 IteadStudio Slampher IteadStudio Sonoff 4CH
IteadStudio S20 IteadStudio Slampher IteadStudio Sonoff 4CH
IteadStudio Sonoff Basic IteadStudio Motor Switch IteadStudio 1CH Inching
IteadStudio Sonoff Basic IteadStudio Motor Switch IteadStudio 1CH Inching
IteadStudio Sonoff Dual IteadStudio Sonoff POW IteadStudio Sonoff TH10/TH16
IteadStudio Sonoff Dual IteadStudio Sonoff POW IteadStudio Sonoff TH10/TH16
IteadStudio Sonoff RF IteadStudio Sonoff SV IteadStudio Sonoff Touch
IteadStudio Sonoff RF IteadStudio Sonoff SV IteadStudio Sonoff Touch
Wemos D1 Mini Relay Shield Electrodragon Relay Board WorkChoice EcoPlug
Wemos D1 Mini Relay Shield Electrodragon Relay Board WorkChoice EcoPlug
JanGoe Wifi Relay (NO/NC) OpenEnergyMonitor WiFi MQTT Relay / Thermostat
JanGoe Wifi Relay (NO/NC) OpenEnergyMonitor WiFi MQTT Relay / Thermostat

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/.