dbus-shelly-1pm-pvinverter and shelly pm 1 plus multi-instance

Integrate Shelly 1PM and shelly pm 1 plus into Victron Energies Venus OS

PM1 = https://youtu.be/ki9uB-DL8lA

PM1 PLUS = https://youtu.be/4lI5X2ZwxUE

Purpose

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

Inspiration

This project is my first on GitHub and with the Victron Venus OS, 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://shelly-api-docs.shelly.cloud/gen1/#shelly1-shelly1pm
• https://github.com/victronenergy/venus/wiki/dbus#pv-inverters

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

Install & Configuration

Get the code

Just grap a copy of the main branche and copy them to a folder under /data/ e.g. /data/dbus-shelly-1pm-pvinverter. After that call the install.sh script.

instance1 The following script should do everything for you:

wget https://github.com/Halmand/dbus-shelly-1pm-and-pm1-Plus-pvinverter-multi-instance/archive/refs/heads/main.zip
unzip main.zip "dbus-shelly-1pm-and-pm1-Plus-pvinverter-multi-instance-main/*" -d /data
mv /data/dbus-shelly-1pm-and-pm1-Plus-pvinverter-multi-instance-main /data/dbus-shelly-1pm-pvinverter01
chmod a+x /data/dbus-shelly-1pm-pvinverter01/install.sh
/data/dbus-shelly-1pm-pvinverter01/install.sh
rm main.zip

instance2 The following script should do everything for you:

wget https://github.com/Halmand/dbus-shelly-1pm-and-pm1-Plus-pvinverter-multi-instance/archive/refs/heads/main.zip
unzip main.zip "dbus-shelly-1pm-and-pm1-Plus-pvinverter-multi-instance-main/*" -d /data
mv /data/dbus-shelly-1pm-and-pm1-Plus-pvinverter-multi-instance-main /data/dbus-shelly-1pm-pvinverter02
chmod a+x /data/dbus-shelly-1pm-pvinverter02/install.sh
/data/dbus-shelly-1pm-pvinverter02/install.sh
rm main.zip

instance3 The following script should do everything for you:

wget https://github.com/Halmand/dbus-shelly-1pm-and-pm1-Plus-pvinverter-multi-instance/archive/refs/heads/main.zip
unzip main.zip "dbus-shelly-1pm-and-pm1-Plus-pvinverter-multi-instance-main/*" -d /data
mv /data/dbus-shelly-1pm-and-pm1-Plus-pvinverter-multi-instance-main /data/dbus-shelly-1pm-pvinverter03
chmod a+x /data/dbus-shelly-1pm-pvinverter03/install.sh
/data/dbus-shelly-1pm-pvinverter03/install.sh
rm main.zip

⚠️ Check configuration after that - because service is already installed an 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-1pm-pvinverter01/config.ini or /data/dbus-shelly-1pm-pvinverter02/config.ini or /data/dbus-shelly-1pm-pvinverter03/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 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
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

Uninstall:

instace 1

/data/dbus-shelly-1pm-pvinverter01/uninstall.sh
rm -r /data/dbus-shelly-1pm-pvinverter01

instace 2

/data/dbus-shelly-1pm-pvinverter02/uninstall.sh
rm -r /data/dbus-shelly-1pm-pvinverter02

instace 3

/data/dbus-shelly-1pm-pvinverter03/uninstall.sh
rm -r /data/dbus-shelly-1pm-pvinverter03

Used documentation

• 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

Discussions on the web

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

• https://community.victronenergy.com/questions/127339/shelly-1pm-as-pv-inverter-in-venusos.html