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/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
- 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"
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 😄
Just grap 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/tonythesticks/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
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 |
- 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: