Skip to content

Commit

Permalink
Update repo front page
Browse files Browse the repository at this point in the history
  • Loading branch information
xoseperez committed Dec 27, 2016
1 parent a940b97 commit 41f3787
Show file tree
Hide file tree
Showing 32 changed files with 64 additions and 445 deletions.
95 changes: 64 additions & 31 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,37 +1,71 @@
# ESPurna
# ESPurna Firmware

ESPurna ("spark" in Catalan) is a custom C firmware for ESP8266 based smart switches.
It was originally developed with the **[ITead Sonoff][1]** in mind but now it supports a growing number of ESP8266-based boards.
ESPurna ("spark" in Catalan) is a custom firmware for ESP8266 based smart switches.
It was originally developed with the **[IteadStudio Sonoff][1]** 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.2.0**, read the [changelog](CHANGELOG.md).

## Features

* **Asynchronous WebServer for configuration** and simple relay toggle with **basic authentication**
* Communication between webserver and webclient via **websockets** with secure ticket check
* **Flashing firmware Over-The-Air** (OTA)
* Up to **3 configurable WIFI networks**, connects to the strongest signal
* **MQTT support** with configurable host and topic
* **REST API** to query and set relay statuses
* Support for **multi-relay boards** (Sonoff Dual, Electrodragon ESP Relay Board,...)
* Manual switch ON/OFF with button (single click the button)
* AP mode backup (double click the button)
* Manual reset the board (long click the button)
* Visual status of the connection via the LED
* **Alexa** integration (Amazon Echo or Dot) by emulating a Belkin WeMo switch
* Support for **automatic over-the-air updates** through the [NoFUSS Library][2]
* Support for **DHT22** and **DS18B20** sensors
* Support for the **HLW8012** power sensor present in the Sonoff POW
* Support for **current monitoring** through the [EmonLiteESP Library][3] using a non-intrusive current sensor ([requires some hacking][4])
* Command line configuration

## Index

* [Supported hardware](docs/Hardware.md)
* [Build and flash the firmware](docs/Firmware.md)
* [Build and flash the filesystem](docs/Filesystem.md)
* [Configuration](docs/Configuration.md)
* [Over-the-air updates](docs/OTA.md)
* [Sensors](docs/Sensors.md)
* [Troubleshooting](docs/Troubleshooting.md)
* Support for **multiple ESP8266-based boards** ([check list](#supported-hardware))
* Wifi **AP Mode** or **STA mode** with **multiple network definitions**
* **MQTT** enabled
* Switch on/off and toggle relays
* LED notifications
* Support for different **sensors**
* DHT11 / DHT22 / DHT21 / AM2301
* DS18B20
* HLW8012 (Sonoff POW)
* Non-invasive current sensor using the [EmonLiteESP Library][3] (requires some hacking)
* Fast asynchronous **HTTP Server**
* Basic authentication
* Web-based configuration
* Relay switching from the web
* Websockets-based communication between the device and the browser
* **REST API**
* GET and PUT relay status
* **Command line configuration**
* **Over-The-Air** (OTA) updates even for 1Mb boards
* Manually from PlatformIO or Arduino Inside
* Automatic updates through the [NoFUSS Library][2]
* **Alexa** integration (requires staging version of Arduino Core for ESP8266)

## Documentation

For more information please refer to the [ESPurna Wiki](https://bitbucket.org/xoseperez/espurna/wiki/Home).


## Supported hardware

<table style="text-align: center">
<tr>
<td style="border-width: 0px;">![Sonoff](images/devices/s20.jpg)<br /><br />**IteadStudio S20**</td>
<td style="border-width: 0px;">![Sonoff](images/devices/slampher.jpg)<br /><br />**IteadStudio Slampher**</td>
<td style="border-width: 0px;">![Sonoff](images/devices/sonoff-4ch.jpg)<br /><br />**IteadStudio Sonoff 4CH**</td>
</tr>
<tr>
<td style="border-width: 0px;">![Sonoff](images/devices/sonoff-basic.jpg)<br /><br />**IteadStudio Sonoff Basic**</td>
<td style="border-width: 0px;">![Sonoff](images/devices/motor-switch.jpg)<br /><br />**IteadStudio Motor Switch**</td>
<td style="border-width: 0px;">![Sonoff](images/devices/1ch-inching.jpg)<br /><br />**IteadStudio 1CH Inching**</td>
</tr>
<tr>
<td style="border-width: 0px;">![Sonoff](images/devices/sonoff-dual.jpg)<br /><br />**IteadStudio Sonoff Dual**</td>
<td style="border-width: 0px;">![Sonoff](images/devices/sonoff-pow.jpg)<br /><br />**IteadStudio Sonoff POW**</td>
<td style="border-width: 0px;">![Sonoff](images/devices/sonoff-th10-th16.jpg)<br /><br />**IteadStudio Sonoff TH10/TH16**</td>
</tr>
<tr>
<td style="border-width: 0px;">![Sonoff](images/devices/sonoff-rf.jpg)<br /><br />**IteadStudio Sonoff RF**</td>
<td style="border-width: 0px;">![Sonoff](images/devices/sonoff-sv.jpg)<br /><br />**IteadStudio Sonoff SV**</td>
<td style="border-width: 0px;">![Sonoff](images/devices/sonoff-led.jpg)<br /><br />**IteadStudio Sonoff LED**</td>
</tr>
<tr>
<td style="border-width: 0px;">![Sonoff](images/devices/sonoff-touch.jpg)<br /><br />**IteadStudio Sonoff Touch**</td>
<td style="border-width: 0px;">![Sonoff](images/devices/electrodragon-relay-board.jpg)<br /><br />**Electrodragon Relay Board**</td>
<td style="border-width: 0px;">![Sonoff](images/devices/workchoice-ecoplug.jpg)<br /><br />**WorkChoice EcoPlug**</td>
</tr>
</table>


## License

Expand All @@ -54,4 +88,3 @@ along with this program. If not, see <http://www.gnu.org/licenses/>.
[1]: https://www.itead.cc/sonoff-wifi-wireless-switch.html
[2]: https://bitbucket.org/xoseperez/nofuss
[3]: https://bitbucket.org/xoseperez/emonliteesp
[4]: http://tinkerman.cat/your-laundry-is-done/
21 changes: 0 additions & 21 deletions docs/Configuration.md

This file was deleted.

77 changes: 0 additions & 77 deletions docs/Filesystem.md

This file was deleted.

56 changes: 0 additions & 56 deletions docs/Firmware.md

This file was deleted.

Loading

0 comments on commit 41f3787

Please sign in to comment.