Skip to content

Latest commit

 

History

History
97 lines (77 loc) · 5.14 KB

README.md

File metadata and controls

97 lines (77 loc) · 5.14 KB
Raw

dbus-shelly-em-smartmeter

Integrate Shelly EM into Victron Energies Venus OS.

Purpose

With the scripts in this repo it should be easy possible to install, uninstall, restart a service that connects the Shelly EM to the VenusOS and GX devices from Victron. Idea is inspired on @fabian-lauer & @vikt0rm projects linked below.

Inspiration

This is my first project with the Victron Venus OS on GitHub, so I took some ideas and approaches from the following projects - many thanks for sharing the knowledge:

How it works

My setup

  • 1-Phase installation
  • Shelly EM with latest firmware
    • Power Input 0 (CT) Measuring Grid input to house
    • Power Input 1 (CT) Measuring PV Generation
    • Connected to Wifi netowrk "A" with a known IP
  • Venus OS on Raspberry PI 4 4GB version 1.1 - Firmware v2.84
    • No other devices from Victron connected
    • Connected to Wifi netowrk "A"

Details / Process

As mentioned above the script is inspired by @fabian-lauer dbus-shelly-3em-smartmeter implementation. So what is the script doing:

  • Running as a service
  • connecting to DBus of the Venus OS com.victronenergy.pvinverter.http_{DeviceInstanceID_from_config}
  • After successful DBus connection Shelly 1PM is accessed via REST-API - simply the /status is called and a JSON is returned with all details A sample JSON file from Shelly 1PM can be found here
  • Serial/MAC is taken from the response as device serial
  • Paths are added to the DBus with default value 0 - including some settings like name, etc
  • After that a "loop" is started which pulls Shelly 1PM data every 750ms from the REST-API and updates the values in the DBus

Thats it 😄

Pictures

Tile Overview Remote Console - Overview SmartMeter - Values SmartMeter - Device Details

Install & Configuration

Get the code

Just grab a copy of the main branch and copy them to a folder under /data/ e.g. /data/dbus-shelly-em-pvinverter-grid. After that call the install.sh script. Create a separate copy for each instance (eg for both inputs of Shelly EM).

The following script should do everything for you:

wget https://github.com/jjdejong/dbus-shelly-em-smartmeter/archive/refs/heads/main.zip
unzip main.zip "dbus-shelly-em-smartmeter-main/*" -d /data
mv /data/dbus-shelly-em-smartmeter-main /data/dbus-shelly-em-smartmeter-grid
chmod a+x /data/dbus-shelly-em-smartmeter-grid/install.sh
cp /data/dbus-shelly-em-smartmeter-grid /data/dbus-shelly-em-smartmeter-pv -r
rm /data/dbus-shelly-em-smartmeter-pv/config.ini
cp /data/dbus-shelly-em-smartmeter-pv/configpv.ini /data/dbus-shelly-em-smartmeter-pv/config.ini
/data/dbus-shelly-em-smartmeter-grid/install.sh
/data/dbus-shelly-em-smartmeter-pv/install.sh
rm main.zip

⚠️ Check configuration after that - because service is already installed and running and with wrong connection data (host, username, pwd) you will spam the log-file

Change config.ini

Within the project there is a file /data/dbus-shelly-em-smartmeter/config.ini - just change the values - most important is the deviceinstance, custom name and phase under "DEFAULT" and host, username and password in section "ONPREMISE". More details below:

Section Config vlaue Explanation
DEFAULT AccessType Fixed value 'OnPremise'
DEFAULT SignOfLifeLog Time in minutes how often a status is added to the log-file current.log with log-level INFO
DEFAULT Deviceinstance Unique ID identifying the shelly EM in Venus OS
DEFAULT CustomName Name shown in Remote Console (e.g. name of pv inverter)
DEFAULT Phase Valid values L1, L2 or L3: represents the phase where pv inverter is feeding in
DEFAULT GridOrPV Valid values are grid or pvinverter: represents the dbus service to send data to
DEFAULT MeterNo Valid values 0 or 1: represents the meter reading of the two inputs to use from the EM device
ONPREMISE Host IP or hostname of on-premise Shelly EM web-interface
ONPREMISE Username Username for htaccess login - leave blank if no username/password required
ONPREMISE Password Password for htaccess login - leave blank if no username/password required

Used documentation

Discussions on the web

This module/repository has been posted on the following threads: