Integrate Shelly EM into Victron Energies Venus OS
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.
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:
- https://github.com/matib12/dbus-shelly-em-smartmeter
- https://github.com/vincegod/dbus-shelly-em-smartmeter
- https://github.com/fabian-lauer/dbus-shelly-3em-smartmeter
- https://github.com/vikt0rm/dbus-shelly-1pm-pvinverter
- https://shelly-api-docs.shelly.cloud/gen1/#shelly-em
- https://github.com/victronenergy/venus/wiki/dbus#grid-and-genset-meter
------------------------------------ Update below needed ----------------------------------------------------
- Motorhome with 1-Phase Shorepower
- Shelly EM
- Measuring AC output of ShorePower on phase L1
- Connected to Wifi netowrk "A" with a known IP
- Venus OS on Raspberry PI 4 4GB
- Connected to Wifi netowrk "A"
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 EM 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 EM data every 750ms from the REST-API and updates the values in the DBus
Thats it 😄
Just grap a copy of the master branche and copy them to a folder under /data/ e.g. /data/dbus-shelly-em-smartmeter.
After that call the install.sh script.
The following script should do everything for you:
wget https://github.com/mcfrojd/dbus-shelly-em-smartmeter/archive/refs/heads/master.zip
unzip master.zip "dbus-shelly-em-smartmeter-master/*" -d /data
mv /data/dbus-shelly-em-smartmeter-master /data/dbus-shelly-em-smartmeter
chmod a+x /data/dbus-shelly-em-smartmeter/install.sh
/data/dbus-shelly-em-smartmeter/install.sh
rm master.zip
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 value | 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 1pm 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 | LogLevel | CRITICAL, ERROR, WARNING, INFO, DEBUG, NOTSET |
| DEFAULT | Position | 0 = input, 1 = output1, 2 = output 2, normaly only needed for pvinverter |
| DEFAULT | Role | grid, pvinverter, genset, acload |
| ONPREMISE | Host | IP or hostname of on-premise Shelly 3EM 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 |
- https://github.com/victronenergy/venus/wiki/dbus#pv-inverters DBus paths for Victron namespace
- https://github.com/victronenergy/venus/wiki/dbus-api DBus API from Victron
- https://www.victronenergy.com/live/ccgx:root_access How to get root access on GX device/Venus OS
- https://shelly-api-docs.shelly.cloud/gen1/#shelly1-shelly1pm Shelly API documentation
This module/repository has been posted on the following threads: