Metadata-Version: 2.3
Name: hoymiles_modbus
Version: 0.10.0
Summary: Gather data from Hoymiles microinverters.
License: MIT
Author: Mariusz Wasiluk
Requires-Python: >=3.10,<3.14
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Provides-Extra: dev
Provides-Extra: doc
Provides-Extra: test
Requires-Dist: black (>=24.8.0,<25.0.0) ; extra == "test"
Requires-Dist: bump2version (>=1.0.1,<2.0.0) ; extra == "dev"
Requires-Dist: flake8 (>=7.1.1,<8.0.0) ; extra == "test"
Requires-Dist: flake8-docstrings (>=1.6.0,<2.0.0) ; extra == "test"
Requires-Dist: isort (>=5.8.0,<6.0.0) ; extra == "test"
Requires-Dist: mkdocs (>=1.6.0,<2.0.0) ; extra == "doc"
Requires-Dist: mkdocs-autorefs (>=0.3.1) ; extra == "doc"
Requires-Dist: mkdocs-include-markdown-plugin (>=7.1.7,<8.0.0) ; extra == "doc"
Requires-Dist: mkdocs-material (>=9.6.18,<10.0.0) ; extra == "doc"
Requires-Dist: mkdocstrings[python] (>=0.27.0,<0.28.0) ; extra == "doc"
Requires-Dist: mypy (>=1,<2) ; extra == "test"
Requires-Dist: plum-py (>=0.8.0,<0.9.0)
Requires-Dist: pre-commit (>=3.8.0,<4.0.0) ; extra == "dev"
Requires-Dist: pymodbus (>=3.11.0,<4.0.0)
Requires-Dist: pytest (>=8.3.2,<9.0.0) ; extra == "test"
Requires-Dist: pytest-cov (>=5.0.0,<6.0.0) ; extra == "test"
Requires-Dist: toml (>=0.10.2,<0.11.0) ; extra == "dev"
Requires-Dist: tox (>=4.17.1,<5.0.0) ; extra == "dev"
Requires-Dist: twine (>=5.1.1,<6.0.0) ; extra == "dev"
Requires-Dist: virtualenv (>=20.2.2,<21.0.0) ; extra == "dev"
Project-URL: Homepage, https://github.com/wasilukm/hoymiles_modbus
Description-Content-Type: text/markdown

# hoymiles_modbus


[![pypi](https://img.shields.io/pypi/v/hoymiles_modbus.svg)](https://pypi.org/project/hoymiles_modbus/)
[![python](https://img.shields.io/pypi/pyversions/hoymiles_modbus.svg)](https://pypi.org/project/hoymiles_modbus/)
[![Build Status](https://github.com/wasilukm/hoymiles_modbus/actions/workflows/dev.yml/badge.svg)](https://github.com/wasilukm/hoymiles_modbus/actions/workflows/dev.yml)
[![codecov](https://codecov.io/gh/wasilukm/hoymiles_modbus/branch/main/graphs/badge.svg)](https://codecov.io/github/wasilukm/hoymiles_modbus)



Python library for gathering data from Hoymiles inverters.

The library communicates with Hoymiles DTU (Pro and Pro-S are supported) which is
a proxy/monitoring device for inverters.
DTU should be connected via its `Ethernet` port and should have IP address assigned by DHCP server.

Disclaimer: This is an independent project, not affiliated with Hoymiles. Any trademarks or product names mentioned are the property of their respective owners.


* Documentation: <https://wasilukm.github.io/hoymiles_modbus>
* GitHub: <https://github.com/wasilukm/hoymiles_modbus>
* PyPI: <https://pypi.org/project/hoymiles_modbus/>
* Free software: MIT


## Features

* Communication via Modbus TCP
* Decode all inverter status registers, which include information such as:
  * current production
  * total production
  * today production
  * temperature
  * alarms
  * status
  * grid voltage and frequency

## Applications
This library is for creating higher-level applications such as [Home Assistant integration](https://github.com/wasilukm/hoymiles-mqtt)

## Credits

This package was created with [Cookiecutter](https://github.com/audreyr/cookiecutter) and the [waynerv/cookiecutter-pypackage](https://github.com/waynerv/cookiecutter-pypackage) project template.

