/kostal-modbusquery

Python module to query registers from Kostal inverters

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

kostal-modbusquery

Introduction

This library provides a pure Python interface to access Kostal Inverters via the Modbus Protocol and specification provided here:

https://www.kostal-solar-electric.com/de-de/download/-/media/document-library-folder---kse/2018/08/30/08/53/ba_kostal_interface_modbus-tcp_sunspec.pdf

It has been tested with Python version 3.5, 3.6, 3.7 and 3.8.

Features

  • Provide Class that reads documented Registers
  • Provide some sample calculations mimic´ing the Inverter´s home page output

Tested with

  • Kostal Plenticore Plus 10 with connected BYD 6.4
  • Kostal Plenticore Plus 8.5

Installation

Clone / Download repo and use kostal-modbusquery.py

Getting started

To use kostal-modbusquery in a project take a look at the __main__ section in kostal-modbusquery.py how to include it in your environment

Disclaimer

Warning

Please note that any incorrect or careless usage of this module as well as errors in the implementation may harm your Inverter !

Therefore, the author does not provide any guarantee or warranty concerning to correctness, functionality or performance and does not accept any liability for damage caused by this module, examples or mentioned information.

Thus, use it on your own risk!

License

Distributed under the terms of the GNU General Public License v3.