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 17 running FW: v06.15 / UI: v06.53
• 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 8.0 BA running FW v2.32 / 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
• Piko 8.3 running FW v4.02

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.

Troubleshooting

Fetching Fails Indefinitely

The PIKO series' webserver is known to not have the most computing power. Therefore, it may get overwhelmed by the requests sent to it by the integration, especially if other applications also access it. Reducing the update_interval may help in these situations. There are two ways of achieving that:

1. (Recommended) Using an automation
   • Follow the official documentation for changing an integrations polling interval
2. Changing code (fine for quick testing)
   • On your machine running Home Assistant, find the custom_components folder where the integration is installed
   • Open the kostal_piko/__init__.py and change update_interval=timedelta(seconds=15) to your desired value (e.g. seconds=60 which should be mostly safe for everyone)
   • Reload Home Assistant to apply the changes

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.