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
GUI-V2 Source: https://github.com/Telekatz/gui-v2
The following script installs the latest version of GUI-V2:
/data/dbus-shellyPlug/installGuiV2.sh
After installing a new version of GUI-V2, you should restart Venus OS to update the GUI in the VRM portal. A backup of the original GUI-V2 is available at https://venus/gui-v2-backup/.
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 |
The following settings are available in the device settings menu inside Venus OS:
| Config value | Explanation |
|---|---|
| Role | Valid values Grid meter, PV inverter, Generator, AC load or EV charger: 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 |
| Polling interval | Polling interval for meter data |
| 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. |
| Config value | Explanation | | Position | Valid values AC input 1, AC input 2 or AC output: Position where the Shelly device is connected.
| Config value | Explanation |
|---|---|
| Position | Valid values AC input or AC output: Position where the Shelly device is connected. |
| Charging threshold | Threshold power for detecting the charging process |
| Disconnect threshold | Threshold power to detect when the charger is unplugged |
| Auto mode minimum SOC | The minimum charge level at which the automatic charging mode is activated. |
| Auto mode start on minimum excess | Charging in automatic charging mode is enabled at this level of feed in excess. |
| Auto mode start with MPPT throttling | Charging in automatic charging mode is enabled when the power of the MPPT charger is throttled. |
| Auto mode minimum charging time | Minimum time during which the charging process is active even though the charging enabled conditions are no longer met. |
| Auto mode On timeout | Time period in which the charging enabled condition must be met before charging begins in automatic charging mode. |
| Auto mode Off timeout | Time period after which charging is stopped in automatic charging mode if the charging enabled conditions are no longer met. |
- 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