sonoff-danimtb
This is an alternative firmware for some sonoff devices to use them over Wifi with MQTT communication protocol. The main purpose of this firmware is to perform as best with Home Assistant.
It is designed with these features in mind:
- Simple low coupled clases with all functionality (esp8266-utils -Relay, LED, Button, WifiManager, MqttManager, DataManager (EEPROM)...).
- Easy to use and reusable to create firmware for other devices.
- C++ code and Arduino interface approach (
setup(),loop()).
It's capabilities are:
- Support for devices with similar pins and configuration -custom esp8266 or esp8285 based boards-. Currently suporting sonoff, sonoff touch, sonoff S20 and sonoff POW.
- Fast connection to Wifi network and MQTT broker.
- Working button toggling relay even when disconnected from Wifi and MQTT.
- Publish device information and state topics to MQTT at connection start and periodically.
- ArduinoOTA to target devices flashing a new firmware over Wifi.
- Automatic Updates from devices calling an Update Server with new releases.
- Support for external switch or button using the additional GPIO (Only for sonoff).
Supported devices
Sonoff Basic
- Device information: Sonoff Basic: iTead WiFi Wireless Smart Switch
Firmware types:
sonoff: Without external peripherals.sonoff-button: With external button connected to GPIO 14 and GND.sonoff-switch: With external switch connected to GPIO 14 and GND.
Sonoff Touch
- Device information: [Sonoff Touch: WiFi Remote Smart Wall Switch Light Switch](https://www.itead.cc/sonoff-touch.html)ç
#### Firmware types:
- `sonoff-touch`
### Sonoff Pow
- Device information: [Sonoff Pow: Electricity/Consumption Monitor Switch](https://www.itead.cc/sonoff-pow.html)
#### Firmware types:
- `sonoff-pow`
### Sonoff S20
- Device information: [Sonoff S20 Socket: iTead WiFi Smart Power Outlet with Timer Function](http://sonoff.itead.cc/en/products/residential/s20-socket)
#### Firmware types:
- `sonoff-s20`
### Sonoff Touch Custom
- Device information: Custom device with esp01 chip and push button. It uses the original Sonoff Touch enclosure and power supply.
#### Firmware types:
- `sonoff-touch-esp01`
### Ewelink Touch Single
- Device information: [Aliexpress](https://es.aliexpress.com/item/EU-Standard-SESOO-Remote-Control-Switch-2-Gang-1-Way-Crystal-Glass-Switch-Panel-Remote-Wall/32773302151.html?spm=a2g0s.9042311.0.0.kBKMfI), [EWelink touch hack](http://evertdekker.com/?p=1015)
#### Firmware types:
- `ewelink-touch-single`
### Ewelink Touch Double
- Device information: [Aliexpress](https://es.aliexpress.com/item/EU-Standard-SESOO-Remote-Control-Switch-2-Gang-1-Way-Crystal-Glass-Switch-Panel-Remote-Wall/32773302151.html?spm=a2g0s.9042311.0.0.kBKMfI), [EWelink touch hack](http://evertdekker.com/?p=1015)
#### Firmware types:
- `ewelink-touch-double`
# How to flash it
Power your device in **flash mode**:
1. Press the button or pull the GPIO 0 down to GND.
2. Connect the device to the USB port.
**WARNING:** Do NOT connect any device to the USB port of your computer while connected to mains.
Clone this repo and its submodule:
```
$ git clone --recursive https://github.com/danimtb/sonoff-danimtb.git
```
This project is built with [platformio](https://platformio.org) to manage third party libraries such as AsyncMqtt, Embedis, ArduinoJson... so you will need to install it. The best way to install it is using pip (only compatible with Python 2.7):
```
$ pip install platformio
```
Firmware types for supported devices are: `sonoff`, `sonoff-button`, `sonoff-switch`, `sonoff-touch`, `sonoff-s20`, `sonoff-touch-esp01`.
- First flash the file system (SPIFFS) where the HTML web is stored (contents of *data* folder in this repo):
`$ platformio run -e