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

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

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.