Skip to main content

A Python library for interacting with Solarman (IGEN-Tech) v5 based Solar Data Loggers

Project description

pysolarmanv5

This is a Python module to interact with Solarman (IGEN-Tech) v5 based solar inverter data loggers. Modbus RTU frames can be encapsulated in the proprietary Solarman v5 protocol and requests sent to the data logger on port tcp/8899.

This module aims to simplify the Solarman v5 protocol, exposing both sync and async interfaces similar to that of the uModbus library.

Details of the Solarman v5 protocol have been based on the excellent work of Inverter-Data-Logger by XtheOne and others.

Documentation

pysolarmanv5 documentation is available on Read the Docs.

The Solarman V5 protocol is documented here.

Supported Devices

A user contributed list of supported devices is available here.

If you are unsure if your device is supported, please use the solarman_scan utility to find compatible data logging sticks on your local network.

Please note that the Solis S3-WIFI-ST data logging stick is NOT supported.
See GH issue #8 for further information.

Some Ethernet data logging sticks have native support Modbus TCP and therefore do not require pysolarmanv5. See GH issue #5 for further information.

Dependencies

  • pysolarmanv5 requires Python 3.8 or greater.
  • pysolarmanv5 depends on uModbus.

Installation

To install the latest stable version of pysolarmanv5 from PyPi, run:

pip install pysolarmanv5

To install the latest development version from git, run:

pip install git+https://github.com/jmccrohan/pysolarmanv5.git

Projects using pysolarmanv5

Contributions

Contributions welcome. Please raise any Issues / Pull Requests via Github.

License

pysolarmanv5 is licensed under the MIT License. Copyright (c) 2024 Jonathan McCrohan

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pysolarmanv5-3.0.6.tar.gz (14.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pysolarmanv5-3.0.6-py3-none-any.whl (15.0 kB view details)

Uploaded Python 3

File details

Details for the file pysolarmanv5-3.0.6.tar.gz.

File metadata

  • Download URL: pysolarmanv5-3.0.6.tar.gz
  • Upload date:
  • Size: 14.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for pysolarmanv5-3.0.6.tar.gz
Algorithm Hash digest
SHA256 ec3c6c03ec47bd0ee811f32ee4da272a28cc53141ab1113b5dbec55834c8afb5
MD5 0baa035b178c91af480efb935e37dc3d
BLAKE2b-256 84f68140c8e6c3fef744c40039c8ef255ee4ca73c84100abed876e252c4fd5a8

See more details on using hashes here.

File details

Details for the file pysolarmanv5-3.0.6-py3-none-any.whl.

File metadata

  • Download URL: pysolarmanv5-3.0.6-py3-none-any.whl
  • Upload date:
  • Size: 15.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for pysolarmanv5-3.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 9e38e47914c5b8bf44166dd74056040ec041b1d7c44ff2ce94ec192eeae9fc5d
MD5 367a8d647a9e61f0fd128e11bcb1b880
BLAKE2b-256 b4b553474eb876dfe9af0750ad63cf240439d863404e301ae13a52b0afbb3eb4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page