Home

Welcome to the ESPSense wiki!

Known Supported Energy Monitoring Plugs

ESPSense supports a number of energy-monitoring commercial plugs, once they've been flashed with ESPHome. The following pages provide the known working ESPHome configurations.

• EFUN SH331W Smart Plug - 10A, low-profile, OTA flashable (as of 8/24/20)
• TOPGREENER TGWF115APM - 15A, UL Listed, OTA flashable (as of 8/24/20)
• TOPGREENER TGWF115PQM - 10A, UL Listed, low-profile, OTA flashable (as of 8/24/20)
• BN-Link Power Monitoring Plug (BNC-60/U133TJ) - 15A, low-profile, OTA flashable (as of 8/24/20)

⚠️ The platform company for these plugs, Tuya, is starting to ship them with a new firmware that is (not yet) OTA flashable due to a new PSK. There is a risk that plugs may arrive and not work with Tuya-Convert. Progress is being tracked here.

Flashing ESPHome via OTA

See the detailed guide here, but a high-level overview is:

1. Compile an ESPHome binary. I've found it easier to start with a basic, minimal functionality ESPHome configuration, and then subsequently do the more advanced configuration with the ESPHome tools (or Home Assistant).
2. Use Tuya Convert (or another like process) to override the stock firmware with Tasmota, ESPurna, or the ESPHome binary you built (see guide). Via-ESPurna and direct-ESPHome flashing have both been used with success.
3. (If you didn't flash ESPHome directly) Flash your ESPHome binary via the web interface of your intermediate firmware.
4. Develop/finalize the full functionality ESPHome configuration you want, and flash that via ESPHome tools/Home Assistant.

Flashing ESPHome directly

This takes a little more work, but some devices (non-Tuya based) have to be flashed directly the first time. You would need a USB-to-UART bridge (Arduino boards can fill this role!) soldered directly to the UART interface on your device. This guide on ESPHome covers the basic approach.