Samil Power inverter tool
Samil Power inverter tool
Get model and status data from Samil Power inverters over the network.
If you just need PVOutput.org uploading, you can also try the old version.
Supported inverter series
- SolarRiver TL
- SolarRiver TL-D
- SolarLake TL
If you have a SolarLake TL-PM series inverter, check out this fork! -> semonet/solar
- View inverter data
- Upload to PVOutput.org
- Publish to MQTT broker
The following features are not implemented but can be easily implemented upon request:
- Filter inverter based on IP or serial number
- Support for multiple PVOutput.org systems
- Python 3
- Inverter needs to be in the same network
$ sudo apt install python3-pip $ pip3 install --user samil
After installing, invoke
samil --help for usage info.
samil command can't be found, first try to relogin.
If that doesn't help you need to change the
with the following command and relogin to apply the change.
$ echo 'PATH="$HOME/.local/bin:$PATH"' >> ~/.profile
$ pip install samil
samil monitor will search for an inverter in the network and print model and status info.
It will connect to the first inverter it finds and print status data every 5 seconds.
samil monitor --help for additional options.
samil mqtt connects to one or more inverters and sends status
messages to an MQTT broker continuously. These messages include inverter data
like input power, output power, energy and temperature.
samil mqtt -h 192.168.1.2 -p 1883 --username user --password pw --inverters 2 --interval 10.
This command connects to the MQTT broker at address
authenticates with the given username
user and password
pw. It will
connect to 2 inverters in the network and send an MQTT message continuously every 10 seconds.
For full usage info, run
samil mqtt --help.
To run this command at startup, see below.
samil pvoutput --help for usage info.
Fetch historical data
Run command at boot
Follow the instructions here to run the MQTT or PVOutput command automatically at startup.
The instructions are based on this post and tested on Raspberry Pi OS Lite version May 2020.
Create a new service:
$ sudo systemctl edit --force --full samil.service
In the empty file that opened, insert the following statements, adjust as necessary, save and close.
[Unit] Description=Samil After=multi-user.target [Service] # Adjust the command to your needs! Keep the path as is unless you installed to somewhere else. ExecStart=/home/pi/.local/bin/samil mqtt --host 192.168.1.2 # Adjust if you have a different user account User=pi Group=pi # Automatically restart on crashes after 30 seconds Restart=on-failure RestartSec=30 Environment="PYTHONUNBUFFERED=1" # Leave as is [Install] WantedBy=multi-user.target
Enable and start the service:
$ sudo systemctl enable --now samil.service
Check if the service has successfully started:
$ sudo systemctl status samil.service
If you want to stop the script, run:
$ sudo systemctl stop samil.service
If you want to disable the script from starting on boot:
$ sudo systemctl disable samil.service
The protocol used by these inverters is described here.
The following units are used for the status values:
- Voltage in volts
- Current in amperes
- Energy in kilowatt hours
- Power in watts
- Temperature in degrees Celcius
- Operating time in hours
This project was originally a fork of zombiekipling/solriv but is now completely rewritten to implement new requirements.
As a library
You can use this project as a library.
For documentation you will need to read through the source code.
To get started I recommend to read the
monitor function in
Development installation (usually in a virtual environment):
pip install -e . pip install -r dev-requirements.txt
python -m unittest
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.