This project contains three subprojects for different use cases. Please read them below in order to tell which project best fits your use case.

There is now a native ESPHome compontent for the Sonoff D1 Dimmer. It is recommended to use the native compontent rather than this custom implementation.

This project is still heavily a work-in-progress. If you find an problem, please open a new issue and ensure to include the ESPHome logs as well.

Many users both at the Sonoff Forums and Tasmota Project have mentioned issues of ghost switching/dimming. But even on the stock firmware, this is an issue. It is outside of my control to fix this issue, but I believe the ghost dimming is coming from the onboard RF controller so theoretically, if you remove it or Solder the RF directly to the ESP8285, it may fix your issues, but I have not yet verified this.

I have a complete write-up guide for this project on my website. Please check it out if you are confused or looking for more information.

If you do not need RF support, please use d1_dimmer.yaml and d1_dimmer.h.

If you would like default RF support, please use d1_dimmer.yaml and d1_dimmer_rf.h.

If you have soldered RF to GPIO4, please use d1_dimmer_rf.yaml and d1_dimmer.h. To learn how or why to solder your RF to GPIO4, check here.