Skip to content

Latest commit

 

History

History
56 lines (36 loc) · 3.41 KB

README.md

File metadata and controls

56 lines (36 loc) · 3.41 KB
Raw

Kostal-Wechselrichter ModbusTCP (14180)

Gira Homeserver 4 Logikmodule to poll power values from the 3rd Generation of Kostal solar energy inverter via Modbus TCP. Compatible with Kostal Plenticore Plus, PIKO IQ and PIKO CI. Not compatible with PIKO MP, PIKO MP Plus or PIKO 12-20!

Important: Please update your inverter firmware before you use this plugin!

Developer Notes

Developed for the GIRA HomeServer 4.10 / 4.11 (Should work >4.7) Licensed under the LGPL to keep all copies & forks free!

❗ If you fork this project and distribute the module by your own CHANGE the Logikbaustein-ID because 14180 is only for this one and registered to @SvenBunge !! ❗

If something doesn't work like expected: Just open an issue. Even better: Fix the issue and fill a pull request.

Installation

Download a release and install the module / Logikbaustein like others in Experte. You find the module in the category "Energiemanagement". Just pic the IP address, port and unit-id of your inverter and wire the output to your communication objects.

The latest version of the module is also available in the KNX-User Forum Download Section

Documentation

This module fetches power information and states from home solar power inverters of the manufacturer "Kostal". It has been tested with the Kostal Plenticore Plus 10 with 2 strings and an BYD battery attached.

More detailed documentation

For further questions use the Promotion Thread of the KNX User Forum (German)

Keep notice

  • All outputs are triggered by a change value (sbc).
  • Yield value fields: If the battery is loaded DC/DC, the amount of energy is not included in those values and unloading the battery will increase the yield. Work around: Add the SOC / 100 * battery capacity to get it approximated. (Output number 12-14)
    • Or update your inverter firmware, set input number 6 = 1 and use the new outputs: 26-34
  • Only voltage(U) and current(I) is fetched from the DC-Strings. If the power(P) in Watts is needed, just calculate them ( P = U * I ). At DC-Level this should be correct.

Build from scratch

  1. Download Schnittstelleninformation from GIRA Homepage
  2. Decompress zip, use HSL SDK/2-0/framework Folder for development.
  3. Checkout this repo to the projects/hs_kostalInverterModbusTCP folder
  4. Run the generator.pyc (python2 ./generator.pyc hs_kostalInverterModbusTCP)
  5. Import the module release/14180_kostalInverterModbusTCP.hsl into the Experte Software
  6. Use the module in your logic editor

You can replace step 4 with the ./buildRelease.sh script. With the help of the markdown2 python module (pip install markdown2) it creates the documentation and packages the .hslz file. This file is also installable in step 5 and adds the module documentation into the Experte-Tool.

Libraries

The shipped libraries may distributed under a different license conditions. Respect those licenses as well!