Skip to content

PVStats is a tool used to connect to your inverter using Modbus TCP, scan for various power figures, and then upload the data to various report services.

License

Notifications You must be signed in to change notification settings

ptarcher/pvstats

Repository files navigation

PVStats

Photovoltaic Inverter Statistics Scanner and Uploader

PVStats is a tool used to connect to your inverter using Modbus TCP, scan for various power figures, and then upload the data to various report services.

Currently supported inverters include:

  • Sungrow SG5KTL (TCP and RS485)
  • Fronius (WiFi)
  • SolaX X1-5.0-T (WiFi)
  • TODO: Sungrow SH5K
  • TODO: SMA Sunny Boy

Currently supported reporting methods include:

  • PVOutput.org
  • MQTT
  • InfluxDB
  • TODO: dweet.io

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Installing

To install the PVStats via pip (Python Package Index)

pip install pvstats

Running

First modify pvstats.conf with your inverter settings, and also pvoutput.org, MQTT or InfluxDB settings

/usr/bin/pvstats -f pvstats.conf

Running the tests

Currently this is a TODO, if you would like to assit with adding tests to the project, please do.

Break down into end to end tests

Explain what these tests test and why

Give an example

And coding style tests

Explain what these tests test and why

Give an example

Deployment

To deploy this on a live system

  • Modify /etc/pvstats.conf with your inverter and reporting settings
  • Start the service via systemd

Enable the service to start on reboot

sudo systemctl enable pvstats.service

Immediately start the service via systemd

sudo systemctl start pvstats.service

Built with help from the following projects

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors of README.md

  • Paul Archer - Modified for pvstats - PVStats
  • Billie Thompson - Initial work - PurpleBooth

See also the list of contributors who participated in this project.

License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details

Acknowledgments

About

PVStats is a tool used to connect to your inverter using Modbus TCP, scan for various power figures, and then upload the data to various report services.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages