Home Assistant Kostal Piko

A custom Home Assistant integration for certain Kostal Piko solar inverters.

Note: The DCS series Piko inverters all seem to use a different API and will most likely not work with this integration.

---

This integration provides Home Assistant with the data that can be obtained from the inverters built-in web portal. It was tested with the following inverters:

• Piko 15 running FW v06.17 / UI v06.53
• Piko 12 running FW v05.61
• Piko 10 BA running FW v2.32
• Piko 8.0 BA running FW v2.30 / UI v6.41
• Piko 6.0 running FW v2.22
• Piko 5.5 NG running FW v05.50
• Piko 5.5 running FW v05.61
• Piko 4.2 running FW v05.60 / UI v6.41

There are a number of sensors provided by this integration to Home Assistant. Due to limitations of the api of the inverter it is recommended to disable sensor entities that are not required.

Click to see the sensors provided by the integration

• Analog inputs
  • Analog Input 1
  • Analog Input 2
  • Analog Input 3
  • Analog Input 4
• Battery
  • Voltage
  • Charge
  • Current
  • Charging State
  • Charge Cycles
  • Temperature
• Grid
  • Output Power
  • Frequency
  • Power Factor
  • Limitation
  • Voltage L1, L2, L3
  • Current L1, L2, L3
  • Power L1, L2, L3
• House
  • Consumption from solar
  • Consumption from battery
  • Consumption from grid
  • Consumption on L1, L2, L3
• Home
  • Total DC input power
  • Self consumption
  • Operating state
• Generator
  • Current, Voltage and Power of DC inputs 1, 2 and 3
• S0 input
  • Pulse count
  • Log interval
• Statistics
  • Todays yield
  • Todays home consumption, self consumption and self consumption rate
  • Todays degree of autonomy
  • Total yield
  • Total home consumption, total self consumption and total self consumption rate
  • Total degree of autonomy
  • Total operating time

The integration is known to not work with the following inverters and firmwares. For these it is recommended to try other custom integrations like kostalpiko-homeassistant by rcasula, which uses a different api to talk to the inverter.

• Piko 5.5 DCS running FW v5.44

Installation

HACS

The recommended way is through HACS. Add this repository as a custom repository by going to HACS > Integrations, click the three dots in the top right corner and select custom repositories. Insert the link to this repository and choose integration as the category. Once added, search for "Kostal Piko" and install the integration.

After installing the integration, simply add it to your Home Assistant as you would any other integration using the UI.

Contributing

Any help is appreciated. Please leave feedback if you tested the integration with an inverter (or firmware) that hasn't been tested yet.

Versioning

This integration uses CalVer for versioning. The scheme is YY.0M.MICRO.

Acknowledgements

Many thanks to Giel Janssens for creating a Kostal component and inspiring me to create my own for this different version of the api. Also thanks to Andreas Rehn for creating pykostal on top of which this component builds.