Integrate Shelly energy meters into Victron Energies Venus OS
With the scripts in this repo it should be easy possible to install, uninstall, restart a service that connects a Shelly device as power meter to the VenusOS and GX devices from Victron.
Just grab a copy of the main branch and copy them to a folder under /data/ e.g. /dbus-shellyPlug.
After that call the install.sh script.
The following script should do everything for you:
wget https://github.com/telekatz/venus.dbus-shellyPlug/archive/refs/heads/main.zip
unzip main.zip "venus.dbus-shellyPlug-main/*" -d /data
mv /data/venus.dbus-shellyPlug-main /data/dbus-shellyPlug
chmod a+x /data/dbus-shellyPlug/install.sh
/data/dbus-shellyPlug/install.sh
rm main.zip
Before installing a new version, uninstall the installed version:
/data/dbus-shellyPlug/uninstall.sh
Within the project there is a file /data/dbus-shellyPlug/config.ini. Create a new section for each Shelly device to be created.
| Section | Config value | Explanation |
|---|---|---|
| Shelly[n] | Deviceinstance | Unique ID identifying Shelly device in Venus OS |
| Shelly[n] | Interval | Poll interval for meter data |
The following settings are available in the device settings menu inside Venus OS:
| Config value | Explanation |
|---|---|
| Role | Valid values Grid meter, PV inverter, Generator or AC load: mode of operation for the energy meter |
| Position | Only for PV inverter. Valid values AC input 1, AC input 2 or AC output: Position where the Shelly device is connected. |
| Phase | Valid values L1, L2 or L3: represents the phase where the Shelly device is connected |
| Meter Index | Measurement channel on multi-channel power meters. |
| IP Address | IP address of the Shelly device |
| User Name | Username for htaccess login - leave blank if no username/password required |
| Password | Password for htaccess login - leave blank if no username/password required |
| Show Temperature | Add the temperature sensor of the Shelly device as additional device in Venus OS |
| Reverse Flow | Reverses the indicated direction of energy flow. |
- https://github.com/victronenergy/venus/wiki Victron Energies Venus OS
- https://github.com/victronenergy/venus/wiki/dbus DBus paths for Victron namespace
- https://github.com/victronenergy/venus/wiki/dbus-api DBus API from Victron
- https://shelly-api-docs.shelly.cloud/gen1/ Shelly Gen 1 API documentation
- https://shelly-api-docs.shelly.cloud/gen2/ Shelly Gen 2+ API documentation