Sonoff

Robert Klep

Control Sonoff devices using Homey

Control ITEAD Sonoff WiFi devices using Homey. Introduction This driver works with unmodified Sonoff WiFi devices, using the original firmware (however, see below). However, it does require an initial device setup. The procedure for this is documented in README.md, and you can also read it during the device pairing phase on Homey. It does not require the Sonoff/eWeLink app on your mobile. Once the device has been set up, it will also not use the Sonoff/eWeLink Chinese cloud (instead, it will use Homey as its cloud server). Be aware that as long as the device is associated with Homey, you can’t use it with the eWeLink app anymore. To revert back to using the eWeLink app, re-pair the device with the app. New Sonoff Firmware may break this app’s functionality! Recently, new Sonoff firmware updates have been released that prevent this app from working. This means two things: - Newer, or recently purchased, devices may not work with this app at all. - If you have an older device, but update its firmware through the eWeLink app, it may not be possible to get the device working with Homey anymore. As of yet, there is no solution to this problem. Other projects that work in a similar way, like SonOTA, are also faced with this problem. As an alternative, this app supports Sonoff devices running the (unofficial) Sonoff-Tasmota firmware. However, installing an alternative firmware requires you to open up the device (voiding its warranty), soldering connectors to it, and flashing the firmware using a USB-to-serial dongle. It also requires an MQTT broker to be running; you can use the Homey MQTT Broker app for this. Because the original firmware is limiting the “hackiness” of the Sonoff devices, most of my development efforts will focus on the Tasmota firmware, which provides a much more open, and documented, platform. If you don’t mind a bit of hardware tinkering, you should consider using it instead of the original firmware (also because most features besides just turning on and off the device are implemented for the Tasmota firmware only). Tested devices This driver has been tested with the following devices: - Sonoff Basic WiFi Wireless Switch (original firmware and Tasmota) - Sonoff S20 Smart Socket (original firmware and Tasmota) - Sonoff RF WiFi Wireless Smart Switch With RF Receiver (original firmware) - Sonoff Slampher (original firmware) - Sonoff RF Bridge (Tasmota) - Sonoff TH10/TH16 (Tasmota) - Sonoff Dual (Tasmota) - Sonoff POW (Tasmota, R2 as well, but untested) - Sonoff RF (untested but should work) - Sonoff 4CH (untested but should work) - Sonoff T1 (untested but should work) Issues Please report issues here: https://github.com/robertklep/name.klep.sonoff/issues Icon Attribution The “Heartbeat” icon was created by Creative Stall from the Noun Project. Changelog - 4.0.8 (2018-06-12): - Fixed issue with actions for multiswitch devices - 4.0.7 (2018-05-27) - 4.0.6 (2018-05-10): - Added setting for TH10/TH16 sensor update interval - 4.0.5 (2018-04-30): - Added Tasmota device overview to Settings page - 4.0.4 (2018-04-23): - New devices supported (Tasmota only): - Sonoff T1 (1-, 2- and 3-channel) - Sonoff POW (power/voltage/current) - 4.0.3 (2018-04-08): - Support for 4CH devices - 4.0.2 (2018-04-05): - Fixed issue with pairing templates - 4.0.1 (2018-04-05): - Bugfix - 4.0.0 (2018-04-03): - Rewritten Tasmota driver/device - New devices supported (Tasmota only): - Sonoff Dual - Sonoff TH10/TH16 (temperature/humidity) - Sonoff RF (untested but should work) - Previously supported but now pairable as a separate device (Tasmota only): - Sonoff Basic - Sonoff S20 - Sonoff RF Bridge - 3.0.0 (2018-03-05): - Rewritten Tasmota MQTT client - Try to automatically identify newly paired device (to provide correct icon) - 2.1.0 (2018-02-19): - Support for receiving/transmitting RF codes (with the Sonoff RF Bridge running the Tasmota firmware) - 2.0.1 (2018-02-09): - Better MQTT broker offline handling - 2.0.0 (2018-02-05): - Support for Sonoff-Tasmota firmware - 1.3.0 (2018-01-23): - Ability to set up a fresh Sonoff device through the Homey desktop app, instead of having to use curl - 1.2.0 (2017-12-16): - Improved pairing - Using icon set kindly provided by Ivo Derksen - 1.1.0 (2017-12-09): - Rewritten device manager - Added device watchdog to faster catch devices that went offline - Added syslog support as development aid - Faster pairing in certain situations - 1.0.0 (2017-12-01): - Initial beta release

Supported devices

4CH (Tasmota)
Basic (Tasmota)
Dual (Tasmota)
Generic (Tasmota)
Original
POW (Tasmota)
RF (Tasmota)
RF Bridge (Tasmota)
S20 (Tasmota)
T1 1CH (Tasmota)
T1 2CH (Tasmota)
T1 3CH (Tasmota)
TH10/TH16 (Tasmota)

Flow cards

Click on a device above to show related Flow cards only.

When...

4CH (Tasmota)
Switch 1 turned on
4CH (Tasmota)
Switch 2 turned on
4CH (Tasmota)
Switch 3 turned on
4CH (Tasmota)
Switch 4 turned on
4CH (Tasmota)
Switch 1 turned off
4CH (Tasmota)
Switch 2 turned off
4CH (Tasmota)
Switch 3 turned off
4CH (Tasmota)
Switch 4 turned off
Basic (Tasmota)
Turned on
Basic (Tasmota)
Turned off
Dual (Tasmota)
Switch 1 turned on
Dual (Tasmota)
Switch 2 turned on
Dual (Tasmota)
Switch 1 turned off
Dual (Tasmota)
Switch 2 turned off
Generic (Tasmota)
Turned on
Generic (Tasmota)
Turned off
Generic (Tasmota)
The power meter changed
Generic (Tasmota)
Dim-level changed
Generic (Tasmota)
RF code received
Original
Turned on
Original
Turned off
POW (Tasmota)
Turned on
POW (Tasmota)
Turned off
POW (Tasmota)
The power changed
POW (Tasmota)
The voltage changed
POW (Tasmota)
The electric current changed
POW (Tasmota)
The power meter changed
POW (Tasmota)
Current changed
POW (Tasmota)
Power changed
POW (Tasmota)
Voltage changed
RF (Tasmota)
Turned on
RF (Tasmota)
Turned off
RF Bridge (Tasmota)
RF code received
S20 (Tasmota)
Turned on
S20 (Tasmota)
Turned off
T1 1CH (Tasmota)
Turned on
T1 1CH (Tasmota)
Turned off
T1 2CH (Tasmota)
Switch 1 turned on
T1 2CH (Tasmota)
Switch 2 turned on
T1 2CH (Tasmota)
Switch 1 turned off
T1 2CH (Tasmota)
Switch 2 turned off
T1 3CH (Tasmota)
Switch 1 turned on
T1 3CH (Tasmota)
Switch 2 turned on
T1 3CH (Tasmota)
Switch 3 turned on
T1 3CH (Tasmota)
Switch 1 turned off
T1 3CH (Tasmota)
Switch 2 turned off
T1 3CH (Tasmota)
Switch 3 turned off
TH10/TH16 (Tasmota)
Turned on
TH10/TH16 (Tasmota)
Turned off
TH10/TH16 (Tasmota)
The temperature changed
TH10/TH16 (Tasmota)
The humidity changed
TH10/TH16 (Tasmota)
Temperature changed
TH10/TH16 (Tasmota)
Humidity changed

And...

Basic (Tasmota)
Is turned on
Generic (Tasmota)
Is turned on
Original
Is turned on
POW (Tasmota)
Is turned on
RF (Tasmota)
Is turned on
S20 (Tasmota)
Is turned on
T1 1CH (Tasmota)
Is turned on
TH10/TH16 (Tasmota)
Is turned on

Then...

4CH (Tasmota)
Switch 1 on
4CH (Tasmota)
Switch 2 on
4CH (Tasmota)
Switch 3 on
4CH (Tasmota)
Switch 4 on
4CH (Tasmota)
Switch 1 off
4CH (Tasmota)
Switch 2 off
4CH (Tasmota)
Switch 3 off
4CH (Tasmota)
Switch 4 off
4CH (Tasmota)
Toggle switch 1
4CH (Tasmota)
Toggle switch 2
4CH (Tasmota)
Toggle switch 3
4CH (Tasmota)
Toggle switch 4
Basic (Tasmota)
Turn on
Basic (Tasmota)
Turn off
Basic (Tasmota)
Toggle on or off
Dual (Tasmota)
Switch 1 on
Dual (Tasmota)
Switch 2 on
Dual (Tasmota)
Switch 1 off
Dual (Tasmota)
Switch 2 off
Dual (Tasmota)
Toggle switch 1
Dual (Tasmota)
Toggle switch 2
Generic (Tasmota)
Turn on
Generic (Tasmota)
Turn off
Generic (Tasmota)
Toggle on or off
Generic (Tasmota)
Set a temperature %
i
Adjusts the temperature of the light. A higher value means a warmer color.
Generic (Tasmota)
Set the hue °
i
Select a color from the hue scale, for example red (0°/360°), yellow (60°), or blue (180°).
Generic (Tasmota)
Set a color ...
Generic (Tasmota)
Set a random color
Generic (Tasmota)
Set the saturation %
Generic (Tasmota)
Dim to %
Generic (Tasmota)
Set relative dim-level %
i
Dim or brighten with respect to the device's current dim-level.
Generic (Tasmota)
Send RF code Sync Low High Code
Original
Turn on
Original
Turn off
Original
Toggle on or off
POW (Tasmota)
Turn on
POW (Tasmota)
Turn off
POW (Tasmota)
Toggle on or off
RF (Tasmota)
Turn on
RF (Tasmota)
Turn off
RF (Tasmota)
Toggle on or off
RF Bridge (Tasmota)
Send RF code Sync Low High Code
S20 (Tasmota)
Turn on
S20 (Tasmota)
Turn off
S20 (Tasmota)
Toggle on or off
T1 1CH (Tasmota)
Turn on
T1 1CH (Tasmota)
Turn off
T1 1CH (Tasmota)
Toggle on or off
T1 2CH (Tasmota)
Switch 1 on
T1 2CH (Tasmota)
Switch 2 on
T1 2CH (Tasmota)
Switch 1 off
T1 2CH (Tasmota)
Switch 2 off
T1 2CH (Tasmota)
Toggle switch 1
T1 2CH (Tasmota)
Toggle switch 2
T1 3CH (Tasmota)
Switch 1 on
T1 3CH (Tasmota)
Switch 2 on
T1 3CH (Tasmota)
Switch 3 on
T1 3CH (Tasmota)
Switch 1 off
T1 3CH (Tasmota)
Switch 2 off
T1 3CH (Tasmota)
Switch 3 off
T1 3CH (Tasmota)
Toggle switch 1
T1 3CH (Tasmota)
Toggle switch 2
T1 3CH (Tasmota)
Toggle switch 3
TH10/TH16 (Tasmota)
Turn on
TH10/TH16 (Tasmota)
Turn off
TH10/TH16 (Tasmota)
Toggle on or off

Reviews

This app has no reviews yet.

You can leave a review once you're using this app.

Thank you for your review.

Submit review

Write a review

This app can manage your entire Homey.

Install Sonoff on

Sonoff will install on Homey shortly.

Install

Be the first to hear about Homey’s latest developments.

Subscribe to our newsletter and be on top-of-mind about new Homey features, exclusive offers and more.