Energy2Shelly_ESP

Getting started

This is a Shelly Pro 3EM Emulator running on ESP8266 or ESP32 using various input sources for power data.
This can be used for zero feed-in with Hoymiles MS-A2, Growatt NOAH/NEXA and Marstek Venus (testers needed!).

Kudos to @sdeigms excellent work at https://github.com/sdeigm/uni-meter which made this port easily possible.
SMA Multicast code is based on https://www.mikrocontroller.net/topic/559607

Installation

Option 1: Compile yourself

1. compile and flash for your microcontroller using PlatformIO

Option 2: Flash pre-compiled binary via browser

1. connect your ESP to your PC using USB and follow the instructions on the webflasher

Configuration

1. Power device and wait for a hotspot named "Energy2Shelly"
2. Connect to that hotspot
3. Enter wifi and configuration data using the captive portal or by opening http://192.168.4.1/

On the captive portal you can currently set a data source for power data. The following options are available:

• MQTT

  • Server IP, port, username, password and topic

  • Power values on the MQTT topic are expected in JSON format. The are multiple fields to define available values using a JSON Path-style syntax. You can also select between monophase and triphase power data.
    

    example (monophase profile):

    • Total power JSON path -> ENERGY.Power for {"ENERGY":{"Power":9.99}}
      
    • Phase 1 power JSON path -> "no definition"
      
    • Phase 2 power JSON path -> "no definition"
      
    • Phase 3 power JSON path -> "no definition"
      
    • Energy from grid JSON path -> ENERGY.Consumption for {"ENERGY":{"Consumption":77}}
      
    • Energy to grid JSON path -> ENERGY.Production for {"ENERGY":{"Production":33}}
      -> Energy2Shelly_ESP responds to
      {"ENERGY":{"Power": 9.99,"Consumption":77,"Production":33}}
      

    example (triphase profile):

    • Total power JSON path -> ENERGY.Power for {"ENERGY":{"Power":7.3}}
      
    • Phase 1 power JSON path -> ENERGY.Pow1 for {"ENERGY":{"Pow1":98}}
      
    • Phase 2 power JSON path -> ENERGY.Pow2 for {"ENERGY":{"Pow2":196}}
      
    • Phase 3 power JSON path -> ENERGY.Pow3 for {"ENERGY":{"Pow3":294}}
      
    • Energy from grid JSON path -> ENERGY.Consumption for {"ENERGY":{"Consumption":98}}
    • Energy to grid JSON path -> ENERGY.Production for {"ENERGY":{"Production":131}}
      -> Energy2Shelly_ESP responds to
      {"ENERGY":{"Power":7.3,"Pow1":98,"Pow2":196,"Pow3":294,"Consumption":98,"Production":131}}
      

• SMA

  • SMA Energy Meter or Home Manager UDP multicast data
  • if you have multiple SMA energy meters you can optionally provide the serial number of the source you want to use in the configuration options

• SHRDZM

  • SHRDZM smart meter interface (common in Austria) with UDP unicast data
  • please enable UDP broadcasts to the IP of the ESP and port 9522 within SHRDZM

• HTTP

  • a generic HTTP input
  • enter a query URL in the second parameter field which delivers JSON data and define at least the JSON Path for total power.
  • for full details on JSONPath configuration, check the section on MQTT above.
    

• SUNSPEC

  • generic SUNSPEC register data polling via Modbus TCP
  • you can setup host ip of Modbus device (e.g. Kostal Smart energy meter)
  • Modbus TCP port (usually 502)
  • Modbus Device ID of the unit ID (71 for KSEM)

Here are some sample generic HTTP query paths for common devices:

• Fronius: http://IP-address/solar_api/v1/GetMeterRealtimeData.cgi?Scope=System
• Tasmota devices: http://IP-address/cm?cmnd=status%2010
• ioBroker datapoints: http://IP-address:8082/getBulk/smartmeter.0.1-0:1_8_0__255.value,smartmeter.0.1-0:2_8_0__255.value,smartmeter.0.1-0:16_7_0__255.value/?json

The Shelly ID defaults to the ESP's MAC address, you may change this if you want to substitute an existing uni-meter configuration without reconnecting the battery to a new shelly device.

4. Check if your device is visible in the WLAN. http://IP-address
   
5. Check the current power data at http://IP-address/status
   

• (Optional) If you want to reset you Wifi-Configuration and/or reconfigure other settings go to http://IP-address/reset and reconnect to the Energy2Shelly hotspot.

Tested microcontrollers

• ESP32 (ESP32-WROOM-32)
• ESP8266

You found a bug

First, sorry. This software is not perfect.

1. Open an issue

• With helpful title - use descriptive keywords in the title and body so others can find your bug (avoiding duplicates).
• Which branch, what microcontroller, what setup
• Steps to reproduce the problem, with actual vs. expected results
• If you find a bug in our code, post the files and the lines.

2. Open a PR 😻

• Explain in detail your changes
• Ask for a review

some screenshots from project

Settings

main page http://IP-address

status page http://IP-address/status

Note

Images may vary depending on the version. We always try to be up to date.